Files
stack/docs/scratchpads/p6-docs-compliance-alpha.md
Jason Woltje 244290d64d feat(framework): P6 docs + compliance matrix + resident-budget CI (#606)
R9 + R10 of the Constitution alpha (in-repo deliverables):

- framework/CONTRIBUTING.md: layer model, operator-hygiene/PII prohibition,
  dedup rule, resident budget, dual-installer parity rule, adding-a-harness,
  re-contamination rule, harness x gate compliance matrix (hook-parity gap
  marked as tracked-v2), known-limitations (DESIGN §9 residuals), PR checklist.
- check-resident-budget.sh: line-count ceiling over framework-owned resident
  files (CONSTITUTION + AGENTS + each runtime/*/RUNTIME.md), with --self-test;
  replaces the crude inline ci.yml loop. Wired blocking in .woodpecker/ci.yml.

Composer unit test (R9) already runs via pnpm test; verify-sanitized.sh (P1)
already wired. Sanitization + budget + prettier all green.

Remaining for the mission close: aiguide reconcile (separate repo) + the alpha
tag (Lead cuts after full DoD §8 green + all phases merged; P5 #605 pending).

Refs #606, #542

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EsgTQzV5YUGk1JtCLP4B83
2026-06-21 21:18:40 -05:00

1.6 KiB
Raw Permalink Blame History

P6 — Docs, compliance matrix, alpha tag (constitution capstone)

  • Issue: #606 · Branch: feat/p6-docs-compliance-alpha · Lineage: #542
  • Requirements: R9 (resident line-count ceiling) + R10 (CONTRIBUTING + compliance matrix + aiguide) + alpha tag

Delivered (in-repo)

  • framework/CONTRIBUTING.md — layer model, operator-hygiene/PII prohibition, dedup rule, resident budget, dual-installer parity rule, adding-a-harness, re-contamination rule, harness×gate compliance matrix (hook-parity gap marked ⚠️ tracked-v2), known-limitations (§9 residuals), PR checklist.
  • framework/tools/quality/scripts/check-resident-budget.sh — line-count ceiling over framework-owned resident files (CONSTITUTION + AGENTS + each runtime/*/RUNTIME.md); --self-test; replaces the crude inline ci.yml loop. Wired blocking in .woodpecker/ci.yml.
  • Composer unit test (R9) already runs via pnpm test; verify-sanitized.sh (P1) already wired.

Verification

  • Sanitization gate green (CONTRIBUTING is operator-neutral). Resident-budget self-test + real run green.
  • prettier clean. Current resident counts: CONSTITUTION 96, AGENTS 83, RUNTIME max 75 — all < ceiling.

Remaining

  • aiguide reconcile (separate repo ~/src/aiguide / mosaicstack/aiguide) — consistency pass vs Constitution.
  • Alpha tag mosaic-vX.Y.Z-alpha — propose version; Lead cuts after full DoD §8 green + all phases merged.

Notes

  • Alpha DoD (DESIGN §8): all phases P0P6 merged + CI green. P5 (#605) pending merge after 0.0.38 publish.
  • Hook parity (codex/opencode/pi) = tracked v2 gap, documented in the matrix, not closed here.