docs(planning): adopt portable two-axis planning convention#120
Merged
Conversation
Design for migrating lite-bootstrap's planning/ to the two-axis OpenSpec-shaped convention from faststream-outbox: architecture/ truth home + planning/changes/ bundles, per-arc bundling of audit arcs, fresh README Index. Dogfooded as its own change bundle. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Eight-task migration plan for the portable convention. Also removes the stray `.gitignore` rule that ignored the literal filename `plan.md`, which would block every change bundle's plan under the new convention. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…trappers) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…retros Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Unquoted `outcome: ... #NN` was silently truncated by YAML (treats ` #` as a comment), dropping the PR ranges on four bundle design.md files. Quote them; also fix the examples in this change's plan.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…uild Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The bug-audit findings moved to planning/audits/ and retros to planning/retros/ under the new convention; CLAUDE.md's Key design decisions pointer was still aimed at the removed planning/specs/ glob. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…aths The bug-audit-v2 audit/sequencing/retro moved out of planning/specs/ into audits/, changes/archive/2026-06-05.01-bug-audit-v2/, and retros/ — the release notes' inbound links and pointers followed them. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Completes the dogfooding step in-PR so merged main lands in final state: move 2026-06-13.01-portable-planning-convention to changes/archive/, set status: shipped / pr: "120", and shift its README Index line from Active (now empty) to the top of Archived. No architecture/ promotion — this change defines the convention itself. 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.
Summary
Adopts the portable OpenSpec-shaped planning convention from
faststream-outbox(its #77). Docs/file-moves only — no runtime code, tests, or public API touched (full test suite still 194 passed / 100% coverage).architecture/truth home at the repo root — one file per capability (config-model.md,instruments.md,bootstrappers.md), seeded fromCLAUDE.md+docs/. This is the promotion target on every future ship.planning/changes/{active,archive}/<YYYY-MM-DD.NN-slug>/bundles. Existing artifacts migrated:design.md+plan.md).design.md, PR plans grouped asplan-pr*.md).planning/audits/; retros →planning/retros/.planning/README.md—## Conventionscopied byte-identical fromfaststream-outbox, fresh repo-specific Index.planning/_templates/{design,plan,change}.mdcopied byte-identical; oldlightweight-plan-template.mdremoved;planning/deferred.mdadded.CLAUDE.md## Planning artifacts→## Workflow(namesarchitecture/as the promotion target);Justfilegainsdocs-build; stray.gitignore plan.mdrule removed (it would have swallowed every bundle'splan.md).changes/active/2026-06-13.01-portable-planning-convention/), to be moved toarchive/on merge.Test Plan
just lint-ci— clean (eof-fixer, ruff format/check, ty)just docs-build—mkdocs build --strictexits 0 (architecture/ + planning/ are outsidedocs_dir)just test— 194 passed, 100% coveragedesign.md/plan.md;outcomevalues with#quoted (YAML comment trap)## Conventionsblock +_templates/byte-identical tofaststream-outboxOn merge
Move
changes/active/2026-06-13.01-portable-planning-convention/→archive/, fillstatus: shipped/pr:/outcome:, and shift its README Index line from Active to Archived. (Noarchitecture/promotion — this change defines the convention, not a library capability.)🤖 Generated with Claude Code