chore: adopt canonical planning convention + compact CLAUDE.md#36
Merged
Conversation
Adopt the canonical planning convention (lesnik512/planning-convention v1.0.0): vendor index.py + templates verbatim, slim every bundle/decision to lean frontmatter (date/slug derived from names; specs carry summary only; plans carry none), rewrite planning/README.md to the Quick-path + lean Conventions form, add check-planning recipe + wire the validator into lint-ci, add architecture/README.md, and record .convention-version. Flip the ruff D212/D213 ignore to the org standard (enforce D212, ignore D213) and auto-apply the docstring summary-line moves. Compact CLAUDE.md: Architecture orientation with invariant summaries + capability index table, Workflow/Commands compacted to pointers at planning/README.md Quick path and the Justfile. just lint-ci green; 457 tests pass at 100% coverage.
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.
Adopts the canonical planning convention (
lesnik512/planning-conventionv1.0.0) and compactsCLAUDE.mdto mirror the pilot pattern.Convention adoption (mechanical)
planning/index.py+planning/_templates/{change,decision,design,plan}.mdverbatim from canon.date/slugare now derived from the directory/file name;design.md/change.mdcarrysummaryonly;plan.mdcarries no frontmatter; decisions carrystatus+summary(+ optional supersedes links). Stripped inline# accepted | supersededcomments that the parser had been treating as part of the value.planning/README.mdto the Quick-path + lean Conventions form.Justfile: addedcheck-planningrecipe and wireduv run python planning/index.py --checkintolint-ci.architecture/README.md(truth-home intro, capability list, promotion rule) andplanning/.convention-version(1.0.0).D212 alignment
D212toD213(enforce D212, ignore D213, matching the org standard) and ranruff check --fix, which auto-applied 8 docstring summary-line moves across 7 source/test files.CLAUDE.md compaction
## Architectureorientation: invariant summaries ("what must not break") + a capability→file index table covering all threearchitecture/*.mdpages, with the promotion reminder. No orphan deep-dive subsections existed to promote.## Workflowto a pointer at theplanning/README.mdQuick path and## Commandsto a pointer at theJustfile(keeping only non-obvious which-to-use-when notes). Preserved the release runbook, tag-naming lore, commit-message rules, and reference-directory notes.Verification
just lint-cigreen (eof-fixer, ruff format, ruff check, ty, planning validator).just check-planningprintsplanning: OK.just test: 457 passed, 100% coverage.🤖 Generated with Claude Code