Agent-facing architecture/ promotion reminder (Finding 3)#237
Merged
Conversation
Resolves evaluation Finding 3 with an agent-facing note in CLAUDE.md's ## Architecture intro, not a CI gate. A behavior change must promote to the matching architecture/<capability>.md in the same PR. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.
Resolves Finding 3 from the agent-convenience evaluation (the last unenforced step of the planning convention: promoting a behavior change to
architecture/).What & why
The convention hinges on hand-editing the affected
architecture/<capability>.mdin the implementing PR — the easiest step to forget. Instead of a git-diff CI heuristic (fuzzy: most code changes touch no capability contract, so it would false-positive constantly and breed cargo-cult acknowledgments), this adds an agent-facing reminder where an agent already reads —CLAUDE.md's## Architectureintro, right beside the capability orientation an agent consults before changing behavior.One line added:
architecture/README.md's "Promotion rule" remains the canonical statement; this is a deliberate one-line echo aimed at agents (who reliably loadCLAUDE.md, rarely openarchitecture/README.md).Recorded as a Lightweight
change.mdbundle so the "note over enforcement" decision is on the record. Dogfoods the new lean frontmatter (date/slug/summary/outcome) from #236.Verification
just check-planning→planning: OKjust lint-ci→ cleanjust docs-build→ OK🤖 Generated with Claude Code