Upgrade planning convention 1.1.1 -> 2.0.0#39
Merged
Conversation
Full-lane change file capturing the APPLY.md flow: flat-file validator and template swap, flatten the 18 change folders, drop 15 plan.md, and rewrite README/CLAUDE prose to the ephemeral-plan model. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Overwrite index.py and the five templates verbatim from the canonical convention; drop the plan.md template (plans are ephemeral in 1.2.0). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2.0.0 migration: git mv each changes/<slug>/{design,change}.md to
changes/<slug>.md and remove the folders; git rm the 15 committed
plan.md (git history preserves them). check-planning: OK.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Replace the Quick-path and Conventions blocks with the canonical convention.md body (flat change files, ephemeral plans, lean specs); preserve the repo intro, Index, and Other sections. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Makes the convention-prose section of planning/README.md a verbatim copy of canonical convention.md (Quick path through Frontmatter), fixing the prior merge that dropped the Quick path/Conventions headings and demoted subsections. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Flat single change files; ephemeral git-ignored plans; keep Quick-path pointer. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Corrects the plan.md count (13, not 15) and finalizes the summary frontmatter to the realized result. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Records the completed upgrade from 1.1.1 to 2.0.0. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Update architecture documentation and conventions to reflect folder-to-file migration. 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.
Applies the
lesnik512/planning-conventionAPPLY.mdupdate flow, moving this repo from the recorded 1.1.1 to 2.0.0. Absorbs three deltas at once (1.1.2 ruff directive, 1.2.0 ephemeral plans, breaking 2.0.0 flat change files). The newindex.pyrejects folder bundles, so the tooling swap and the historical migration land together.What changed
planning/index.py+ the five templates to the canonical 2.0.0 set; drop theplan.mdtemplate (1.2.0).changes/<slug>/folders to flatchanges/<slug>.mdfiles (puregit mv, content preserved);git rmthe 13 committedplan.md(history preserved).planning/README.mdverbatim (Quick path + Conventions + subsections), preserving the repo intro and Index/Other; align theCLAUDE.mdWorkflow paragraph and retire "change bundle" wording in the living-truth prose.planning/.convention-version=2.0.0.Rationale and per-surface detail:
planning/changes/2026-07-07.02-upgrade-planning-convention-2.0.md.Verification
just check-planning->planning: OK; 0 directories underchanges/;uvx ruff check planning/index.pyclean;just lint-cipass;just test-> 101 passed. Vendoredindex.py/templates and the merged README block confirmed byte-exact against canonical.🤖 Generated with Claude Code