chore: refine planning conventions (architecture/ move + tiny-change lane)#55
Merged
Conversation
…lane) Two small CLAUDE.md-adjacent changes bundled per the just-codified tiny-change lane itself: - Move planning/architecture/ to architecture/ at the repo root. planning/ now holds only in-flight + just-shipped artifacts; architecture/ documents shipped invariants and is a different shape (post-ship reference, not pending work). All references in CLAUDE.md and planning/README.md updated. Six file renames. - Add a "Tiny-change lane" paragraph after the spec/plan/architecture boundary in CLAUDE.md, codifying the lane that #51, #52, and #54 (and this PR) already use informally: typo / dep bump / linter tweak / convention-driven rename / single-line config = no spec/plan, just commit. No runtime code, test code, or public API touched. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Belongs with the previous commit — the git add in that commit aborted when the (now empty) planning/architecture/ pathspec failed, so these two file edits missed the staging. Adding them here completes the intended diff: CLAUDE.md references now point at architecture/ (not planning/architecture/), the tiny-change-lane paragraph is added, and planning/README.md's Other section links to ../architecture/. Co-Authored-By: Claude Opus 4.7 (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.
Two small CLAUDE.md-adjacent refinements bundled per the just-codified tiny-change lane itself.
Summary
planning/architecture/→architecture/at the repo root.planning/now holds only in-flight + just-shipped artifacts (specs, plans, templates, index);architecture/documents shipped invariants and is a different shape — post-ship reference, not pending work. Six file renames (dlq,drain,metrics,relay,test-broker,timers). All references inCLAUDE.md(8 occurrences) andplanning/README.md(1 link) updated.CLAUDE.mdafter the spec/plan/architecture boundary. Codifies the lane that PRs chore: add just docs-serve and docs-build targets #51 (just docs targets), chore: archive shipped planning pairs from #49 and #50 #52 (archive), chore: archive shipped planning pair from #53 #54 (archive), and this PR already use informally: typo / dep bump / linter tweak / convention-driven rename / single-line config = skip the spec/plan pipeline, commit directly with a descriptive subject. Explicitly not a lane for small features or small bug fixes that have a design — those still get specs.Stale references in archived/shipped spec bodies (operator-pages, planning-conventions) are left untouched — frozen history per the convention itself.
Test plan
git mvpreserved history at 100% similarity (six files)just lintpasses (eof-fixer, ruff format, ruff check, ty check)grep -rn planning/architectureis empty for canonical guidance files (CLAUDE.md, planning/README.md); only archived specs retain the old path, deliberatelyarchitecture/(notplanning/architecture/)architecture/at repo root contains the six deep-dive files🤖 Generated with Claude Code