chore(docs): migrate to mister-anderson v0.4.0 layout - #165
Merged
Conversation
added 3 commits
May 9, 2026 00:11
- Add docs/MANIFESTO.md (vision, principles, governing laws, out-of-scope) - Rename PRODUCT-REQUIREMENTS-SPECIFICATION.md -> PRD.md (Status: APPROVED) - Formalize Status: APPROVED in ARCHITECTURE.md - Consolidate .spec/ -> docs/specs/ with phase-0 prefix (00-spec-*) - Prefix research docs with phase-0 (00-research-*) - Update intra-spec path references to new locations Refs: line-ui-xrz, line-ui-he7, line-ui-pg5, line-ui-fr7, line-ui-55b, line-ui-0or
- Add docs/plans/00-plan-foundation.md (extracted from PRODUCT-PLAN.md §2, Status: APPROVED) - Demote PRODUCT-PLAN.md to multi-phase ROADMAP with pointer to per-phase plans - Update CLAUDE.md Documentation Hierarchy + Repository Structure for v0.4.0 layout - Replace .spec/ -> docs/specs/ and PRODUCT-REQUIREMENTS-SPECIFICATION.md -> PRD.md across: - README.md (badge, catalogue link, project tree, contributing) - docs/PRD.md (131 component spec links + footer references) - docs/ARCHITECTURE.md (intra-doc references) - docs/DESIGN-SYSTEM-IMPLEMENTATION-GUIDE.md (template ref) - docs/PRODUCT-PLAN.md (Phase 1+ spec references) - .claude/agents/theme-supervisor.md (PRD path) Refs: line-ui-xrz, line-ui-an7, line-ui-dcd
Mass-update the 12 beads whose external_ref pointed at the old .spec/ tree: - line-ui-w5s, w5s.1, w5s.2, w5s.5, w5s.6, w5s.7 -> docs/specs/00-spec-base.md - line-ui-gvz, gvz.1, gvz.2, gvz.6 -> docs/specs/00-spec-storybook.md - line-ui-0rl, 0rl.1 -> docs/specs/00-spec-icon-registry.md Also fix line-ui-6zy (E9: Showcase) description: .spec/SHOWCASE-APP-SPEC.md -> docs/specs/00-spec-showcase.md (active epic; supervisors read this). Closed beads with historical references (jox.9, jox.11, p3v.45, p3v.47) left as-is — they document state at the time of completion. Refs: line-ui-xrz, line-ui-sj4
|
added 3 commits
May 9, 2026 00:37
Removes checks.yml, release.yml, snapshot-deploy.yml, snapshot-version.yml. Background: pnpm@latest moved to v11 which requires Node >=22.13. The pnpm install step in checks.yml runs before the Node setup step, so the runner's default Node 20 picks up pnpm v11 and crashes on the node:sqlite builtin import. This breaks every PR until the pipeline is rewritten. Workflows are removed wholesale (not just patched) to clear the way for a ground-up rebuild aligned with the project's actual stack (Bun, per CLAUDE.md). Re-enable by restoring from git history once the new pipeline is designed.
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
Migrates existing product documentation to the layout expected by the mister-anderson plugin v0.4.0 so the orchestrator skills (
/product,/specification, etc.) recognise APPROVED artifacts and skip completed steps.docs/MANIFESTO.mddistilled from PRD §1 + README — vision, principles, governing laws, out-of-scope.PRODUCT-REQUIREMENTS-SPECIFICATION.md→docs/PRD.md(Status: APPROVED).docs/ARCHITECTURE.mdnowStatus: APPROVED(withMaintenance: Living documentpreserved)..spec/→docs/specs/with phase-prefixed names (00-spec-base.md,00-spec-showcase.md,00-spec-icon-registry.md,00-spec-storybook.md)..spec/directory removed; archive preserved atdocs/specs/archive/.docs/plans/00-plan-foundation.md(Status: APPROVED).docs/PRODUCT-PLAN.mddemoted to multi-phase ROADMAP. Phases 1-8 deferred until each is reached via/specification {NN}(per agreed migration policy).docs/research/00-research-browser-defaults.md,docs/research/00-research-browser-widgets.md..spec/andPRODUCT-REQUIREMENTS-SPECIFICATION.mdreferences replaced across README.md, PRD.md, ARCHITECTURE.md, PRODUCT-PLAN.md, DESIGN-SYSTEM-IMPLEMENTATION-GUIDE.md, theme-supervisor agent.external_refpaths updated todocs/specs/...;line-ui-6zydescription fixed. Closed beads left as historical record.Decisions captured
.spec/was fully consolidated intodocs/specs/(option discussed and confirmed by user)./manifesto(work already approved).Beads
Migration epic:
line-ui-xrzwith 8 child tasks (he7,pg5,fr7,55b,an7,0or,dcd,sj4). All open — closure deferred to QA / human review per the project's beads policy.A bead context sweep report is posted as a comment on
line-ui-xrz.Test plan
docs/MANIFESTO.md,docs/PRD.md,docs/ARCHITECTURE.mdcarryStatus: APPROVEDdocs/plans/00-plan-foundation.mdcarriesStatus: APPROVED.spec/removed; all specs accessible atdocs/specs/00-spec-*.mdgit mvhistory preserved for all renames\.spec/andPRODUCT-REQUIREMENTS-SPECIFICATIONreturns zero hits outside historical/archive content and the generic AGENTS.md plugin docexternal_refpaths point at the new spec locations/product statusafter merge — expect Stage 1 all green/specification 0 statusafter merge — expect plan APPROVED, specs APPROVED