Skip to content

feat(standards): add doctrine-quartet law#2

Open
rogu3bear wants to merge 1 commit into
mainfrom
standards/doctrine-quartet-law
Open

feat(standards): add doctrine-quartet law#2
rogu3bear wants to merge 1 commit into
mainfrom
standards/doctrine-quartet-law

Conversation

@rogu3bear

Copy link
Copy Markdown
Owner

What

Adds a sixth V0 law, doctrine-quartet, so the workspace contract quartet — NORTH_STAR.md, ANCHOR.md, AGENTS.md, CLAUDE.md — is enforced by the standards plane instead of living only as prose in the workspace contract. Missing quartet files become P2 findings anchored at the repo doc, with file:line evidence and a repair recommendation. This is what lets workspace standards "sprinkle down" per repo and stops silent drift.

Changes

  • catalog/laws.toml: register doctrine-quartet (pilot); added to V0_LAWS.
  • DocsInfo + scan_docs: track NORTH_STAR.md and ANCHOR.md alongside the existing AGENTS/CLAUDE/README/SECURITY scan.
  • audit_doctrine_quartet: new scanner wired into audit_repos, skipping Template/Unknown repos; scanner_requirement_id/scanner_expected mappings added.
  • repo explain: surface NORTH_STAR/ANCHOR presence.
  • tests: scanner fires on missing files; stays clean on a full quartet.

Verification

  • cargo fmt --check
  • cargo clippy --workspace --all-targets -- -D warnings
  • cargo test --workspace — 26 passed ✓
  • Live standards audit ~/dev --all over 26 repos: zero doctrine-quartet findings (forest is fully quartet-covered).

Read-only over target repos; report-first, consistent with devctl V0.

Add a sixth V0 law, doctrine-quartet, so the workspace contract quartet
(NORTH_STAR.md, ANCHOR.md, AGENTS.md, CLAUDE.md) is enforced by the
standards plane instead of living only as prose. Missing quartet files
become P2 findings anchored at the repo doc, with file:line evidence and
a repair recommendation, so standards sprinkle down per repo and cannot
drift silently.

- catalog/laws.toml: register doctrine-quartet (pilot).
- DocsInfo + scan_docs: track NORTH_STAR.md and ANCHOR.md alongside the
  existing AGENTS/CLAUDE/README/SECURITY scan.
- audit_doctrine_quartet: new scanner wired into audit_repos, skipping
  Template/Unknown repos; requirement/expected mappings added.
- repo explain: surface NORTH_STAR/ANCHOR presence.
- tests: scanner fires on missing files, stays clean on a full quartet.

Verified: cargo fmt --check, clippy -D warnings, 26 tests pass; live
'standards audit ~/dev --all' over 26 repos reports zero doctrine-quartet
findings (forest is fully quartet-covered).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant