Skip to content

docs(claude): record owner norms — selector questions, stacked PRs, KYAML / I-JSON+JCS / UUID v8 #179

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hyperpolymath merged 9 commits into from
Oct 14, 2026
Merged

docs(claude): record owner norms — selector questions, stacked PRs, KYAML / I-JSON+JCS / UUID v8 #179

Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
5813069
docs(claude): record owner norms — selector questions, stacked PRs, K…
claude Oct 14, 2026
de3703c
docs(claude): the exemption ratchet admits declared ledger growth
claude Oct 14, 2026
9b24220
docs(claude): scope the UUID v8 rule until the ids.rs migration lands
claude Oct 14, 2026
c3ff211
docs(claude): clarify ledger growth allowance with declared Ratchet-e…
coderabbitai[bot] Oct 14, 2026
1ad700c
fix(ci): restore the echidna-core import in live_echidna; bump quinn-…
claude Oct 14, 2026
119397e
Merge the CodeRabbit ratchet wording into the norms branch
claude Oct 14, 2026
a381c8d
Merge remote-tracking branch 'origin/claude/new-session-th4e9w-ci' in…
claude Oct 14, 2026
a1eb4bf
Merge branch 'main' into claude/new-session-th4e9w
hyperpolymath Oct 14, 2026
0c7f846
Merge branch 'main' into claude/new-session-th4e9w
hyperpolymath Oct 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions .claude/CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -198,3 +198,32 @@ truth and update stragglers when you touch them.
- PR strategy: open with `gh pr create`, then immediately
`gh pr merge <N> --auto --squash --delete-branch`.


## Owner norms (2026-10-14)

These come from the owner. The format rules point at their normative
source in `hyperpolymath/standards`; read that, not a paraphrase.

### Asking the owner

- Ask decisions with the selector tool (structured options, the
recommended one first, with what each option implies). Use prose only
for reports and explanations.
- Work lands as **stacked PRs**: small, each independently reviewable.
- Fix a finding at its source before reaching for a baseline or ledger.
The governance exemption ratchet rejects ledger growth unless a commit
or the PR body carries a `Ratchet-exception:` line naming that ledger.

### Formats (standard, estate-wide)

| Kind | Standard | Source |
|------|----------|--------|
| YAML | KYAML, formatted with standards `scripts/kyaml-format.sh` (mikefarah yq v4 with the KYAML encoder). Estate-owned config uses `.kyaml` unless a tool fixes the name. No Python YAML parser. | `3-practice/YAML-POLICY.adoc` §3.4 (D280, D307, D293) |
| Workflows | KYAML too, but only through the step 6 gate in `standards#1025` (Dependabot / `gh actions-lock` drift accepted in writing, lock coverage, `actionlint`, a run proof per workflow). Lockfiles such as `actions.lock` are tool-owned: never hand-edit or reformat them. | `YAML-POLICY.adoc` §5–§6 |
| JSON | I-JSON (RFC 7493) serialised as JCS (RFC 8785), plus exactly one final LF. Extensions do not change. JSONL is one JCS object per line. JSONC files (`devcontainer.json`, `.vscode/`) are exempt. | `3-practice/JSON-POLICY.adoc` (D306) |
| UUID | Current policy: UUIDv7 for records and events, and UUIDv8 over JCS content bytes for content IDs. Keep this split until the corresponding `ids.rs` migration lands. Apply the Profile T/C rule and prohibit new v4/v7 minting after that migration. This repo mints only through `src/ids.rs`. | `docs/decisions/ADR-008-uuid-v8-estate-standard.adoc` (D305, D305b, D320) |

Keep another format only where a consumer the owner does not control
would break (for example a tool that rewrites the file). Record why
beside the file. Tools the owner controls are changed to handle the
standard instead of being exempted.
Loading