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
docs(station): update status, memory, and logs after Plan 10 completion
Plan 10 (docs site) fully shipped — Phase D merged as PR #19.
Updated work state for next session: PR #20 merge review, then Plan 08 Phase C.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
-`design-guide`: wrong description and missing agents (tech-lead, backend)
21
+
-`review-checklist`: missing agent (reviewer)
22
+
-`test-strategy`: missing agent (qa)
23
+
24
+
### Key Decisions
25
+
26
+
-**Plan simplification:** Replaced planned custom scripts (C3 `generate-llm-bundles.mjs` + C4 post-processing) with native `starlight-llms-txt` plugin `customSets` config. Zero custom code, same result.
27
+
-**Marker approach for catalog pages:** Used `{/* CATALOG-TABLE-START/END */}` markers to auto-generate only data tables, preserving hand-written prose sections.
28
+
-**Option A for workflow:**`generate:catalog` is a dev tool, not a CI step. Run manually before committing when catalog changes. Catalog data tables are committed to git for PR visibility.
29
+
-**MDX comments:** Used `{/* */}` style markers instead of HTML `<!-- -->` since `.mdx` files don't support HTML comments reliably.
30
+
31
+
### Findings
32
+
33
+
- Site was already live at https://laststep.github.io/Bonsai/ from Phase B deployment
34
+
-`docs.yml` CI workflow already exists and auto-deploys — Phase D is mostly complete
35
+
- Remaining Phase D items: README docs link update (may be done), `bonsai guide` URL reference, HANDBOOK redirect note
## 2026-04-17 — Plan 10 Phase D: Deploy & CI (Plan 10 Complete)
2
+
3
+
**Plan:** 10-docs-site.md, Phase D
4
+
**PR:**#19 (merged)
5
+
**Duration:** Single session
6
+
7
+
### What Was Done
8
+
9
+
1.**Verified Phases A-C** — Full audit of all 45 pages, build output, catalog generation, LLM bundles. All clean.
10
+
11
+
2.**Phase D implementation** (dispatched to code agent, worktree isolation):
12
+
-**D1** — Updated `.github/workflows/docs.yml`: added `docs/**`, `README.md`, `HANDBOOK.md` to path triggers; added `npm run generate:catalog` step before build. Skipped `generate:llm-bundles` (plugin handles it automatically).
13
+
-**D2** — Skipped (README already had docs badge and links from prior phases).
14
+
-**D3** — Created `docs/README.md` redirect notice pointing to live docs site.
15
+
-**D4** — Appended docs site URL footer to `docs/custom-files.md` (shown by `bonsai guide`).
16
+
-**D5** — Added redirect note to top of `HANDBOOK.md`.
17
+
18
+
3.**Post-merge verification** — `make build` and `go test ./...` pass on main.
19
+
20
+
### Key Decisions
21
+
22
+
-**Deploy-on-push-to-main kept** (not release-tag-only). Rationale: pre-1.0 project, main is the latest, `starlight-versions` plugin is immature. Revisit at 1.0 when multi-version support matters.
23
+
-**`generate:catalog` added to CI** — despite Phase C decision to keep it as a dev tool, it's also run in CI as a safety net to ensure catalog pages are current.
Copy file name to clipboardExpand all lines: station/Playbook/Backlog.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -73,6 +73,7 @@ Items that should be worked together are tagged with a group letter. See the gro
73
73
-**[debt] Break up `generate.go` — 1,357 lines, highest churn file** — `internal/generate/generate.go` is both the largest Go file and the most frequently modified. It handles file writing, template rendering, conflict resolution, lock management, sensor/routine wiring, and scaffolding — too many responsibilities in one file. Split along natural seams: (1) template rendering, (2) file writing + conflict resolution, (3) lock management, (4) sensor/routine wiring. Would improve testability and reduce merge friction for agent dispatches. *(added 2026-04-16, source: repo-analytics)*
74
74
-**[debt]`internal/catalog/` test coverage — 496 lines, 0%** — Catalog loading (`LoadCatalog()`, `DisplayNameFrom()`, meta.yaml parsing) is the bridge between embedded YAML and the rest of the system. A malformed `meta.yaml` in the catalog would break at runtime with no test to catch it. Basic tests for catalog loading, display name derivation, and agent compatibility filtering would catch regressions cheaply. *(added 2026-04-16, source: repo-analytics)*
75
75
-**[debt] CLI command test coverage — `cmd/` package at 0%** — The `cmd/` package contains all user-facing CLI logic (init, add, remove, update, list, catalog, guide) — 1,691 lines across 8 files, zero tests. Priority targets: (1) `cmd/init.go` — happy path e2e test (temp dir, verify output structure), (2) `cmd/add.go` — test that abilities land correctly, (3) `cmd/remove.go` — test clean removal (472 lines, 4th largest file). Table-driven tests with temp dir setup would cover the most ground. *(added 2026-04-16, source: repo-analytics)*
76
+
-**[debt] Plan 12 follow-up — `ActionUnchanged` test coverage gaps**`[Group B]` — Two small test gaps from Plan 12 review (PR #20): (1) `TestWriteResultSummary` (`internal/generate/generate_test.go:360`) destructures the new `unchanged` return into `_` — should add an `{Action: ActionUnchanged}` fixture and assert `unchanged == 1`, (2) no dedicated test exists for the `WorkspaceClaudeMD` short-circuit in `internal/generate/generate.go:829-833` (only `writeFile` is covered end-to-end via `TestAgentWorkspaceUnmodifiedUpdate`). Quick fix (~10 lines total). *(added 2026-04-17, source: PR #20 independent review)*
Copy file name to clipboardExpand all lines: station/Playbook/Status.md
+5-3Lines changed: 5 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,9 +14,9 @@ description: Live task tracker. Update this file at the start and end of every w
14
14
15
15
| Task | Plan | Agent | Notes |
16
16
|------|------|-------|-------|
17
-
| Documentation site (Starlight) — Phase C complete, Phase D next | 10 | tech-lead | Phase A (PR #13), Phase B (PRs #15-17), Phase C (PR #18) — catalog gen + LLM layer |
17
+
<!-- Documentation site (Starlight) — Plan 10 complete, all phases shipped (PRs #13-19) -->
18
18
| Better trigger sections — Phase C (new sensors) | 08 | tech-lead | Phase A (PR #10) + Phase B (PR #11) merged, Phase C next |
Copy file name to clipboardExpand all lines: station/agent/Core/memory.md
+5-2Lines changed: 5 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,14 +13,17 @@ description: Tech Lead Agent working memory — flags, work state, notes.
13
13
14
14
## Work State
15
15
16
-
**Current task:**Multiple in progress — Plan 10 Phase C next (catalog generation & LLM layer), Plan 08 Phase C (new sensors), Plan 11 Phase 2 (UI polish)
16
+
**Current task:**Plan 12 Phase 2 PR #20 awaiting merge (draft, both reviews APPROVE, CI green); Plan 08 Phase C (new sensors) next
17
17
**Blocked on:** —
18
-
**Last completed:** Plan 10 Phase B shipped (PRs #15-17 merged) — 30 pages of content across concepts, commands, guides, catalog, reference, FAQ, troubleshooting (2026-04-17)
18
+
**Last completed:** Plan 10 complete — all 4 phases shipped (PRs #13-19) (2026-04-17)
19
19
20
20
## Notes
21
21
22
22
<!-- Session-to-session notes. Keep concise. -->
23
23
24
+
-**Next session — first action:** Re-review PR #20 (8 files, +125/-29) and merge if still approved. Branch: `worktree-agent-a2c20c09`. Two non-blocking test nits filed in Backlog.md Group B for follow-up.
25
+
-**Pre-flight learning:** Worktrees inherit only committed HEAD — uncommitted plans/docs in main tree are invisible to dispatched agents. Commit station/ planning artifacts before dispatch (done 2026-04-17 in `1a5b5d1`).
26
+
24
27
## Feedback
25
28
26
29
<!-- User corrections and confirmed approaches that persist across sessions. Only record what isn't already in CLAUDE.md, workflows, or protocols. -->
0 commit comments