You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 2897cd8
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: CLAUDE.md
+5-6Lines changed: 5 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,12 +8,11 @@ Guidance for AI agents (Claude Code, etc.) working in this repository.
8
8
9
9
**Where to find what:**
10
10
11
-
-[`docs/engineering.md`](docs/engineering.md) — the distilled design reference: invariants and *why*, the five protocol seams, exception contract, module layout, testing patterns, optional-extras pattern, remaining roadmap. Read this before adding any new module or extension point.
12
-
-[`docs/deferred-work.md`](docs/deferred-work.md) — review-surfaced items that are real but not actionable now.
13
-
-[`docs/superpowers/specs/`](docs/superpowers/specs/) and [`docs/superpowers/plans/`](docs/superpowers/plans/) — per-feature design specs and implementation plans (active work).
14
-
-[`docs/archive/`](docs/archive/) — historical bmad-era planning bundle (PRD, architecture, epics, product briefs, per-story specs for 1-1 through 1-5). Consult only for original rationale or specific FR/NFR citations.
11
+
-[`docs/dev/engineering.md`](docs/dev/engineering.md) — the distilled design reference: invariants and *why*, the five protocol seams, exception contract, module layout, testing patterns, optional-extras pattern, remaining roadmap. Read this before adding any new module or extension point.
12
+
-[`planning/deferred-work.md`](planning/deferred-work.md) — review-surfaced items that are real but not actionable now.
13
+
-[`planning/specs/`](planning/specs/) and [`planning/plans/`](planning/plans/) — per-feature design specs and implementation plans (active work).
15
14
16
-
**Per-feature workflow:** brainstorming → spec in `docs/superpowers/specs/` → writing-plans → plan in `docs/superpowers/plans/` → executing-plans (or subagent-driven-development) → requesting-code-review → finishing-a-development-branch. Topic slugs are kebab-case descriptions (`msgspec-decoder-adapter`), not story IDs.
15
+
**Per-feature workflow:** brainstorming → spec in `planning/specs/` → writing-plans → plan in `planning/plans/` → executing-plans (or subagent-driven-development) → requesting-code-review → finishing-a-development-branch. Topic slugs are kebab-case descriptions (`msgspec-decoder-adapter`), not story IDs.
17
16
18
17
## Commands
19
18
@@ -99,5 +98,5 @@ Five documented internal boundaries. AI agents must respect them — never cross
99
98
100
99
## When in doubt
101
100
102
-
- Check [`docs/engineering.md`](docs/engineering.md) before adding a new module or extension point; `docs/archive/architecture.md` has the deeper historical rationale if needed.
101
+
- Check [`docs/dev/engineering.md`](docs/dev/engineering.md) before adding a new module or extension point.
103
102
- Surface ambiguity as a documentation gap rather than improvising.
Copy file name to clipboardExpand all lines: docs/dev/engineering.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -131,7 +131,7 @@ Caller-facing pattern: consumers select the implementation by passing it explici
131
131
132
132
## 8. Remaining roadmap
133
133
134
-
Twenty-seven stories remain. Topic slugs in `docs/superpowers/specs/` and `docs/superpowers/plans/` use kebab-case descriptions, not the story IDs — these IDs are retained as a stable identifier convention from the original epic structure.
134
+
Twenty-seven stories remain. Topic slugs in `planning/specs/` and `planning/plans/` use kebab-case descriptions, not the story IDs — these IDs are retained as a stable identifier convention from the original epic structure.
135
135
136
136
### Epic 1 — Make typed HTTP requests with sensible defaults
137
137
@@ -178,7 +178,7 @@ Twenty-seven stories remain. Topic slugs in `docs/superpowers/specs/` and `docs/
178
178
-**6-4** CI enforcement gates (codify the invariants in Section 2 as CI jobs).
179
179
-**6-5** Release flow with Trusted Publishers + Sigstore.
180
180
181
-
When work starts on a roadmap item, it gets a spec at `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md` and a plan at `docs/superpowers/plans/YYYY-MM-DD-<topic>-plan.md`.
181
+
When work starts on a roadmap item, it gets a spec at `planning/specs/YYYY-MM-DD-<topic>-design.md` and a plan at `planning/plans/YYYY-MM-DD-<topic>-plan.md`.
git commit -m "docs(story-1.7): implementation plan for AsyncClient
1823
1823
1824
1824
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>"
@@ -1845,7 +1845,7 @@ gh pr create --title "feat(story-1.7): AsyncClient — the v0.1.0 public surface
1845
1845
1846
1846
**Out of scope and deferred:** `auth=` (Story 2-4), `data=`/`files=` body params, transport reference-counting, streaming (Epic 4), observability (Epic 5).
0 commit comments