feat: Compass's own architecture/ — six founding ADRs, narrative docs#5
Merged
Conversation
…tests Compass adopts its own architecture/ tree using the mechanism shipped by the prior task (cross-task-architectural-integrity). This is the Q15 meta-bootstrap: the framework practises what it preaches. New files: - architecture/system-context.md — five logical surfaces (pipeline, router, guardrails, strategies, role pipeline) with purpose, boundary conditions, external dependencies - architecture/relations.md — call/read graph between framework components; enumerates all required relations (cli/compass ↔ governance/, architecture/, .compass/work/; hooks reading .red and signals.yml; architect-lens scope) - architecture/ownership.md — Must own + Must not do per component; cites B-Risk 1..6 from the prior task's architecture-notes.md - architecture/decisions/ADR-001..ADR-006-*.md — six founding ADRs covering Inv-1..Inv-8: judgement/mechanism separation, grow by artifacts not rules, flow advises never gates, one spec many lenses, state on disk, backward compat - architecture/decisions/README.md — index with principle → ADR mapping Production code change: - cli/compass: _scan_adrs now raises ValueError on malformed ADR YAML (TRC-X1 — fail loudly and name the file, per the error-handling contract) CLAUDE.md amendment (atomic with architecture/ per TRC-D1): - The architecture/ paragraph updated to note Compass itself ships one, and that it doubles as a worked example for adopters. No mention of unbuilt features (TRC-D2). Tests (18 new, all green; 179 total — 161 prior + 18 new): - tests/test_self_architecture.py — covers all 18 TRC-* scenarios - tests/fixtures/self-architecture/hypothetical-framework-task/ — fixture for TRC-C3 - tests/fixtures/self-architecture/proposed-adr/ — fixture for TRC-X2 compass check: PASS — 10/10. All 18 scenarios have red→green evidence. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…RDING) Removed the implicit reference to a governance/invariants.yml artifact that doesn't ship — the architecture/ tree contains ADRs and narrative files, not a separate invariants enumeration. Pays the BF-OWNERSHIP-WORDING backfill from compass-self-architecture's Verify phase. BF-CALIBRATION-NOTE was paid as a recorded follow-on candidate (tdd-strategy-covers-existing-marker) in the local task spine, not as a code change to this branch.
4 tasks
jed72
added a commit
that referenced
this pull request
May 24, 2026
Cuts the 1.0.0 stable release. Three substantial PRs have shipped since 1.0.0-rc.1: PR #4 (architectural integrity suite), PR #5 (Compass self-architecture), PR #6 (swarm.sh parser fix). Remaining follow-ons are enhancements, not gaps. Bumps the four locations carrying the version string and adds a regression test guarding against partial bumps. Merged via --admin override per the established CODEOWNERS-blocks-self-approval pattern (solo-maintainer repo). 🤖 Generated with [Claude Code](https://claude.com/claude-code)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Compass adopts its own `architecture/` directory using the mechanism shipped
in PR #4 — the Q15 meta-bootstrap. The framework now documents its own design,
serves as a worked example for adopters, and gives every future framework-touching
task substance for the architect-lens to consult.
New under `architecture/`:
guardrails, strategies, role pipeline)
registry from the prior task's architecture-notes, now lifted into Compass's
own architecture/)
Other changes:
Compass itself ships one as a worked example (atomic per TRC-D1)
(latent silent-swallow bug surfaced by TRC-X1 via TDD)
Test plan
Follow-on tasks (not in this PR)
Recorded in the prior task's open-follow-on list. The list now has seven items:
`architecture-invariants-schema`, `compass-self-architecture` ← this one, closes here),
`brief-mandatory-on-user-visible-tasks`, `project-ci-health-gate`, `backfill-area-matching`,
`swarm-script-strips-markdown`, `tdd-strategy-covers-existing-marker`.
🤖 Generated with Claude Code