Skip to content

chore: adopt canonical planning convention + compact CLAUDE.md#82

Merged
lesnik512 merged 3 commits into
mainfrom
chore/adopt-canonical-convention
Jun 25, 2026
Merged

chore: adopt canonical planning convention + compact CLAUDE.md#82
lesnik512 merged 3 commits into
mainfrom
chore/adopt-canonical-convention

Conversation

@lesnik512

Copy link
Copy Markdown
Member

Adopts the canonical two-axis planning convention (lesnik512/planning-convention v1.0.0) and compacts CLAUDE.md so the per-capability deep-dives live in architecture/ (the truth home).

Convention adoption

  • Vendored `planning/index.py` and `planning/_templates/*` verbatim from canon (now a flat newest-first index + a `--check` validator).
  • Slimmed every existing bundle's frontmatter to the lean form: specs (`design.md`/`change.md`) carry `summary` only, `plan.md` carries none, `date`/`slug` are derived from the directory name.
  • Rewrote `planning/README.md` to the canonical Quick-path + Conventions prose (kept the repo-local Index/Other sections).
  • Wired `uv run python planning/index.py --check` into `just lint-ci`; added a `check-planning` recipe.
  • Recorded the applied version in `planning/.convention-version` (1.0.0).
  • Added `architecture/README.md` as the capability index + promotion rule.
  • D212 flip: not needed (D212 is not ignored in pyproject; D213 is).

CLAUDE.md compaction (113 → 60 lines)

  • Collapsed the Architecture-invariants / Module-layout / Protocol-seams / Testing deep-dives (which duplicated `architecture/*.md`) into terse invariant summaries + a capability→file index table, with the promotion reminder.
  • Promoted the orphan Code-conventions section into a new `architecture/conventions.md`.

Verification

`just lint-ci` green (ruff format + ruff check + ty + planning validator); `just check-planning` prints `planning: OK`.

lesnik512 and others added 3 commits June 25, 2026 19:42
Vendor index.py + _templates/ verbatim from lesnik512/planning-convention
(v1.0.0), slim every bundle's frontmatter to the lean form (summary-only
specs; plans carry none; date/slug derived from the dir/file name), rewrite
planning/README.md to the canonical Quick-path + Conventions prose, wire the
planning validator into just lint-ci, add a check-planning recipe, record the
applied version in planning/.convention-version.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Collapse the Architecture-invariants / Module-layout / Protocol-seams /
Testing deep-dives that duplicated architecture/*.md into terse invariant
summaries plus a capability-to-file index table, and add the promotion
reminder. Promote the orphan Code-conventions section into a new
architecture/conventions.md, and add architecture/README.md as the capability
index with the promotion rule. CLAUDE.md 113 to 60 lines.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@lesnik512 lesnik512 merged commit f1a3f8e into main Jun 25, 2026
5 checks passed
@lesnik512 lesnik512 deleted the chore/adopt-canonical-convention branch June 25, 2026 16:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant