Adopt the portable planning convention#210
Merged
Merged
Conversation
Two-axis convention from faststream-outbox: architecture/ truth home +
planning/changes/{active,archive}/ bundles. Spec written into the new
location to dogfood it.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
16-task plan: scaffold, git-mv 17 files into 11 archive bundles, normalize frontmatter, back-author architecture/ (README + 6 capabilities), repoint release links, add CLAUDE.md Workflow, verify. Scope the bare plan.md gitignore rule to /plan.md so bundle plans are tracked. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
17 files relocated via git mv into 11 dated bundles; specs/ and plans/ removed. 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>
README index + 6 capability docs (scopes, containers, providers, resolution, validation, testing-and-overrides), sourced from and verified against the code. No frontmatter — living prose, dated by git. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Fix reversed finalizer/eviction ordering in providers.md (finalizer runs before _clear()); drop unsupported "3.0" removal claims (code says "a future release"); fix typo; rewrap three files to <=120 chars. 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>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Fixes drift surfaced while back-authoring architecture/: find_container is an O(1) scope_map lookup (not a parent-chain walk); validate() does transitive scope checks via effective_scope (not just cycle detection); list exceptions.py (the exception classes) alongside errors.py (message templates); add a forward pointer to architecture/ as the authoritative account. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
3 tasks
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 two-axis planning convention from
faststream-outbox: a livingarchitecture/truth home at the repo root plusplanning/changes/{active,archive}/folder bundles.modern-dihad no truth home before this.architecture/— README index + 6 capability docs (scopes, containers, providers, resolution, validation, testing-and-overrides), back-authored from and verified against the code. Sits outside the mkdocs build. This is the promotion target on every ship.planning/specs/+planning/plans/→ 11 datedchanges/archive/<YYYY-MM-DD.NN-slug>/bundles viagit mv(history preserved), renamed todesign.md/plan.md, frontmatter normalized tostatus: shippedwithpr:/outcome:/spec:filled. Design-only and plan-only orphans handled (plan-only bundles pointspec:at the audit report)..NNbreaks same-date ties by merge order.planning/README.md— "Conventions" section byte-identical to faststream-outbox; repo-specific "Index" (Active = this change; Archived = the 11).planning/_templates/— design/plan/change templates copied verbatim.CLAUDE.md— new## Workflowsection namingarchitecture/as the truth home / promotion target.planning/releases/*.mdand the two audit-report breadcrumbs to the new bundle paths..gitignore— scoped the bareplan.mdrule to/plan.mdso bundle plans are tracked (it was silently ignoring everyplan.md).planning/changes/active/2026-06-13.03-portable-planning-convention/.audits/,releases/,deferred.md, andscripts/workflow.mjsare unchanged (the.mjskeeps its historicalspecs//plans/strings as frozen runtime content, like other intra-bundle history).Notably, back-authoring
architecture/surfaced several places whereCLAUDE.mdhad drifted from the code (e.g.close_sync()/close_async()notclose();find_containeris an O(1)scope_map, not a parent-chain walk; theAlias(scope=)deprecation says "a future release", not "3.0"). The new docs follow the code.Test Plan
just lint-ciclean (eof-fixer + ruff format + ruff check + ty)just test— 199 passedmkdocs build --strictsucceeds (planning/ and architecture/ are outsidedocs_dir, so the published site is unaffected)planning/specs//planning/plans/references outside frozen historydiff🤖 Generated with Claude Code