@codewizard-dt/bootstrap 2.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/workflows/build.yml +88 -0
- package/.github/workflows/security.yml +24 -0
- package/.gitleaks.toml +15 -0
- package/README.md +472 -0
- package/bin/cli.js +47 -0
- package/lib/README.md +27 -0
- package/lib/hooks/README.md +316 -0
- package/lib/hooks/env-file-guard.js +45 -0
- package/lib/hooks/git-protected-ops-block.js +77 -0
- package/lib/hooks/lib/serena-languages.js +158 -0
- package/lib/hooks/lib/serena.js +787 -0
- package/lib/hooks/mv-absolute-path-block.js +53 -0
- package/lib/hooks/serena-bash-grep-block.js +501 -0
- package/lib/hooks/serena-edit-guard.js +74 -0
- package/lib/hooks/serena-first-glob-guard.js +94 -0
- package/lib/hooks/serena-first-guard.js +74 -0
- package/lib/hooks/serena-first-read-guard.js +167 -0
- package/lib/hooks/serena-pre-delegation.js +117 -0
- package/lib/hooks/serena-session-reset.js +45 -0
- package/lib/hooks/serena-usage-tracker.js +186 -0
- package/lib/hooks/serena-write-guard.js +58 -0
- package/lib/prompts/README.md +16 -0
- package/lib/prompts/migrate-wiki.md +111 -0
- package/lib/prompts/setup-deployment.md +322 -0
- package/lib/prompts/setup-design-system.md +162 -0
- package/lib/prompts/setup-strict-typechecks.md +139 -0
- package/lib/scripts/README.md +49 -0
- package/lib/scripts/bootstrap-serena.sh +145 -0
- package/lib/scripts/build-mcp-guide.sh +108 -0
- package/lib/scripts/install-global.sh +78 -0
- package/lib/scripts/install-mcps.sh +131 -0
- package/lib/scripts/lib.sh +154 -0
- package/lib/scripts/merge-gitignore.sh +65 -0
- package/lib/scripts/migrate-project.sh +273 -0
- package/lib/scripts/setup-deployment.sh +104 -0
- package/lib/scripts/setup-project.sh +55 -0
- package/lib/scripts/setup-runner.sh +99 -0
- package/lib/scripts/setup-strict-typechecks.sh +29 -0
- package/lib/scripts/startup.sh +42 -0
- package/lib/scripts/sync-wiki-scaffold.sh +104 -0
- package/lib/scripts/templates/CLAUDE-env-safety.md +3 -0
- package/lib/scripts/templates/CLAUDE-wiki.md +60 -0
- package/lib/scripts/templates/gitignore +136 -0
- package/lib/scripts/templates/guides/stubs/00-header.md +15 -0
- package/lib/scripts/templates/guides/stubs/brave-search.md +20 -0
- package/lib/scripts/templates/guides/stubs/context7.md +26 -0
- package/lib/scripts/templates/guides/stubs/playwright.md +26 -0
- package/lib/scripts/templates/guides/stubs/serena.md +219 -0
- package/lib/scripts/templates/wiki/conventions.md +100 -0
- package/lib/scripts/templates/wiki/dashboard.html +1733 -0
- package/lib/scripts/templates/wiki/hot.md +21 -0
- package/lib/scripts/templates/wiki/index.md +46 -0
- package/lib/scripts/templates/wiki/knowledge/concepts/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/knowledge/entities/components/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/knowledge/entities/organisations/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/knowledge/entities/people/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/knowledge/entities/tools/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/knowledge/sources/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/log.md +14 -0
- package/lib/scripts/templates/wiki/work/bugs/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/bugs/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/bugs/index.md +12 -0
- package/lib/scripts/templates/wiki/work/bugs/lifecycle.md +39 -0
- package/lib/scripts/templates/wiki/work/decisions/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/decisions/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/decisions/index.md +12 -0
- package/lib/scripts/templates/wiki/work/decisions/lifecycle.md +42 -0
- package/lib/scripts/templates/wiki/work/requirements/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/requirements/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/requirements/index.md +12 -0
- package/lib/scripts/templates/wiki/work/requirements/lifecycle.md +34 -0
- package/lib/scripts/templates/wiki/work/roadmaps/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/roadmaps/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/roadmaps/index.md +12 -0
- package/lib/scripts/templates/wiki/work/roadmaps/lifecycle.md +32 -0
- package/lib/scripts/templates/wiki/work/tasks/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/tasks/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/tasks/index.md +12 -0
- package/lib/scripts/templates/wiki/work/tasks/lifecycle.md +39 -0
- package/lib/scripts/templates/wiki/work/uat/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/uat/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/uat/index.md +12 -0
- package/lib/scripts/templates/wiki/work/uat/lifecycle.md +48 -0
- package/lib/scripts/templates/wiki/work/uat/screenshots/.gitkeep +0 -0
- package/lib/scripts/update-project.sh +75 -0
- package/lib/scripts/wiki-dashboard-server.js +146 -0
- package/lib/skills/README.md +146 -0
- package/lib/skills/anti-slop/SKILL.md +183 -0
- package/lib/skills/bug-close/SKILL.md +136 -0
- package/lib/skills/bug-file/SKILL.md +114 -0
- package/lib/skills/bug-triage/SKILL.md +140 -0
- package/lib/skills/company-align/SKILL.md +203 -0
- package/lib/skills/debug-logs/SKILL.md +129 -0
- package/lib/skills/decision-create/SKILL.md +220 -0
- package/lib/skills/decision-finalize/SKILL.md +181 -0
- package/lib/skills/decision-next/SKILL.md +129 -0
- package/lib/skills/decision-walkthrough/SKILL.md +169 -0
- package/lib/skills/demo/SKILL.md +183 -0
- package/lib/skills/elevator-pitch/SKILL.md +125 -0
- package/lib/skills/eval-create/SKILL.md +344 -0
- package/lib/skills/eval-gap/SKILL.md +150 -0
- package/lib/skills/eval-run/SKILL.md +214 -0
- package/lib/skills/extract-feature/SKILL.md +344 -0
- package/lib/skills/flashcard/SKILL.md +513 -0
- package/lib/skills/frontend-taste/SKILL.md +184 -0
- package/lib/skills/gap-assess/SKILL.md +97 -0
- package/lib/skills/git-commit/SKILL.md +164 -0
- package/lib/skills/lint/SKILL.md +99 -0
- package/lib/skills/marp-slideshow/SKILL.md +212 -0
- package/lib/skills/mermaid-flowchart/SKILL.md +194 -0
- package/lib/skills/now/SKILL.md +36 -0
- package/lib/skills/port-feature/SKILL.md +315 -0
- package/lib/skills/power-mode/SKILL.md +184 -0
- package/lib/skills/primer/SKILL.md +84 -0
- package/lib/skills/project-readme/SKILL.md +166 -0
- package/lib/skills/req-compile/SKILL.md +131 -0
- package/lib/skills/req-create/SKILL.md +124 -0
- package/lib/skills/req-extract-decisions/SKILL.md +241 -0
- package/lib/skills/req-finalize/SKILL.md +251 -0
- package/lib/skills/req-retire/SKILL.md +185 -0
- package/lib/skills/req-update/SKILL.md +265 -0
- package/lib/skills/research/SKILL.md +250 -0
- package/lib/skills/research-company/SKILL.md +345 -0
- package/lib/skills/roadmap-add/SKILL.md +238 -0
- package/lib/skills/roadmap-create/SKILL.md +223 -0
- package/lib/skills/roadmap-next/SKILL.md +132 -0
- package/lib/skills/security-audit/SKILL.md +246 -0
- package/lib/skills/serena-config/SKILL.md +92 -0
- package/lib/skills/simplify/SKILL.md +227 -0
- package/lib/skills/tackle/SKILL.md +156 -0
- package/lib/skills/task-add/SKILL.md +208 -0
- package/lib/skills/task-audit/SKILL.md +294 -0
- package/lib/skills/task-trash/SKILL.md +115 -0
- package/lib/skills/task-update/SKILL.md +136 -0
- package/lib/skills/uat-auto/SKILL.md +69 -0
- package/lib/skills/uat-auto-plus/SKILL.md +115 -0
- package/lib/skills/uat-generate/SKILL.md +289 -0
- package/lib/skills/uat-skip/SKILL.md +169 -0
- package/lib/skills/uat-walk/SKILL.md +164 -0
- package/lib/skills/uat-walk/UAT-CORE.md +140 -0
- package/lib/skills/update-docs/SKILL.md +75 -0
- package/lib/skills/wiki-archive/SKILL.md +96 -0
- package/lib/skills/wiki-ingest/SKILL.md +139 -0
- package/lib/skills/wiki-lint/SKILL.md +131 -0
- package/lib/skills/wiki-query/SKILL.md +71 -0
- package/lib/skills/wiki-rotate-log/SKILL.md +90 -0
- package/lib/skills/wiki-tidy/SKILL.md +107 -0
- package/package.json +32 -0
- package/raw/.gitkeep +0 -0
- package/raw/design-principles.md +65 -0
- package/raw/guides/command-anti-patterns.md +79 -0
- package/raw/guides/deployment-strategy.md +448 -0
- package/raw/guides/evals-framework.md +452 -0
- package/raw/guides/mcp-tools.md +335 -0
- package/raw/guides/task-spec.md +79 -0
- package/raw/guides/type-checking-templates/README.md +112 -0
- package/raw/guides/type-checking-templates/eslint/eslint.config.ts +105 -0
- package/raw/guides/type-checking-templates/python/mypy.ini +69 -0
- package/raw/guides/type-checking-templates/python/pyproject.toml +164 -0
- package/raw/guides/type-checking-templates/python/pyrightconfig.json +67 -0
- package/raw/guides/type-checking-templates/tsconfig/tsconfig.app.jsonc +45 -0
- package/raw/guides/type-checking-templates/tsconfig/tsconfig.lib.jsonc +44 -0
- package/raw/guides/type-checking-templates/tsconfig/tsconfig.node-esm.jsonc +40 -0
- package/raw/guides/type-checking-templates/tsconfig/tsconfig.node.jsonc +34 -0
- package/raw/guides/type-checking-templates/tsconfig/tsconfig.vite-root.json +8 -0
- package/raw/harness-notes.md +20 -0
- package/raw/house-style/components/Badge.tsx +16 -0
- package/raw/house-style/components/Button.tsx +32 -0
- package/raw/house-style/components/Card.tsx +26 -0
- package/raw/house-style/components/Chip.tsx +57 -0
- package/raw/house-style/components/IconButton.tsx +67 -0
- package/raw/house-style/components/Modal.tsx +18 -0
- package/raw/house-style/components/Stepper.tsx +141 -0
- package/raw/house-style/components/icons.tsx +128 -0
- package/raw/house-style/preview/src/index.css +46 -0
- package/raw/house-style/tokens/tailwind.preset.ts +49 -0
- package/raw/house-style/tokens/tokens.json +62 -0
- package/raw/llm-wiki-2.md +162 -0
- package/raw/llm-wiki.md +75 -0
- package/raw/research/dark-mode-theme/index.md +85 -0
- package/raw/research/dark-mode-theme/sources.md +49 -0
- package/raw/research/serena-mcp-disconnect/index.md +81 -0
- package/raw/research/serena-mcp-disconnect/sources.md +87 -0
- package/raw/research/wiki-tooling-improvements/index.md +126 -0
- package/raw/research/wiki-tooling-improvements/sources.md +73 -0
- package/raw/software-factory-case-study.pdf +0 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Hot Cache
|
|
3
|
+
updated: YYYY-MM-DD
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Hot Cache
|
|
7
|
+
|
|
8
|
+
Session-handoff summary of what changed most recently — the small file an agent reads first to get oriented fast. **Fully regenerated at the end of every wiki-writing session, never appended to.** Keep it under ~500 words; if a fact stops being "recent", it drops off (its durable form lives in a knowledge or work page).
|
|
9
|
+
|
|
10
|
+
_Last updated: YYYY-MM-DD_
|
|
11
|
+
|
|
12
|
+
## Key Recent Facts
|
|
13
|
+
- _(the handful of things a fresh session most needs to know right now)_
|
|
14
|
+
|
|
15
|
+
## Recent Changes
|
|
16
|
+
- Created: _(new pages/files from the last session)_
|
|
17
|
+
- Updated: _(pages/files revised in the last session)_
|
|
18
|
+
- Flagged: _(contradictions, stale claims, or open questions raised)_
|
|
19
|
+
|
|
20
|
+
## Active Threads
|
|
21
|
+
- _(in-flight work — roadmaps mid-execution, tasks in progress, waves pending)_
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Wiki Index
|
|
3
|
+
updated: 2026-06-11
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Wiki Index — Home Map
|
|
7
|
+
|
|
8
|
+
The page catalog and home Map of Content for this wiki. **Read this first on every query**, then drill into the linked pages. Updated on every ingest and every filed answer.
|
|
9
|
+
|
|
10
|
+
Conventions that govern every page (atomic pages, stable IDs, typed links, frontmatter namespace): see [conventions](conventions.md). Operation history: see [log](log.md).
|
|
11
|
+
|
|
12
|
+
Entry format: `- [Title](path) — one-line summary`.
|
|
13
|
+
|
|
14
|
+
The wiki is split into two domains with opposite organizing laws:
|
|
15
|
+
- **Knowledge** — timeless, link-navigated synthesis (sources, concepts, entities). Pages are listed individually below.
|
|
16
|
+
- **Work** — stateful, status-navigated lifecycle artifacts (requirements, decisions, roadmaps, tasks, uat, bugs). Items are **not** listed here — each family keeps its own `index.md` of active items; this page links to those.
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## Knowledge
|
|
21
|
+
|
|
22
|
+
### Sources
|
|
23
|
+
_(none yet)_ — one summary page per ingested `raw/` source. See [knowledge/sources/](knowledge/sources/).
|
|
24
|
+
|
|
25
|
+
### Concepts
|
|
26
|
+
_(none yet)_ — patterns, ideas, conventions, recurring themes. See [knowledge/concepts/](knowledge/concepts/).
|
|
27
|
+
|
|
28
|
+
### Entities
|
|
29
|
+
_(none yet)_ — one page per entity, filed by sub-type:
|
|
30
|
+
- People — [knowledge/entities/people/](knowledge/entities/people/)
|
|
31
|
+
- Organisations — [knowledge/entities/organisations/](knowledge/entities/organisations/)
|
|
32
|
+
- Tools — [knowledge/entities/tools/](knowledge/entities/tools/)
|
|
33
|
+
- Components — [knowledge/entities/components/](knowledge/entities/components/) (this project's own modules, services, scripts)
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Work
|
|
38
|
+
|
|
39
|
+
Each family's `index.md` lists its **active items only** (completed/terminal items drop off the list; files never move — status lives in frontmatter).
|
|
40
|
+
|
|
41
|
+
- **Requirements** — REQ-NNN. [Active index](work/requirements/index.md) · [lifecycle](work/requirements/lifecycle.md)
|
|
42
|
+
- **Decisions** — DEC-NNNN (per-decision `#DM`). [Active index](work/decisions/index.md) · [lifecycle](work/decisions/lifecycle.md)
|
|
43
|
+
- **Roadmaps** — ROADMAP-NNN. [Active index](work/roadmaps/index.md) · [lifecycle](work/roadmaps/lifecycle.md)
|
|
44
|
+
- **Tasks** — TASK-NNN. [Active index](work/tasks/index.md) · [lifecycle](work/tasks/lifecycle.md)
|
|
45
|
+
- **UAT** — UAT-NNN, one per task. [Active index](work/uat/index.md) · [lifecycle](work/uat/lifecycle.md)
|
|
46
|
+
- **Bugs** — BUG-NNNN. [Active index](work/bugs/index.md) · [lifecycle](work/bugs/lifecycle.md)
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# Wiki Log
|
|
2
|
+
|
|
3
|
+
Append-only record of wiki operations — ingests, queries filed back, lint passes, scaffolding. **Never edit existing entries**; only append new ones at the bottom.
|
|
4
|
+
|
|
5
|
+
Entry format (consistent prefix keeps the log greppable — `grep "^## \[" log.md | tail -5`):
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
## [YYYY-MM-DD] <op> | <subject>
|
|
9
|
+
1–3 sentences on what happened.
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
Operations: `scaffold`, `ingest`, `query`, `lint`, `decision`, `task`, `bug`, `requirement`, `roadmap`.
|
|
13
|
+
|
|
14
|
+
---
|
|
File without changes
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
# Bugs Archive
|
|
2
|
+
|
|
3
|
+
Terminal bug files (`closed`, `wontfix`, `duplicate`, or `cannot-reproduce`) moved here by `/wiki-archive` to reduce directory clutter. **Append-only** — archived items never move again.
|
|
4
|
+
|
|
5
|
+
| ID | Title | Final Status | Archived |
|
|
6
|
+
|----|-------|--------------|----------|
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Bugs Index
|
|
3
|
+
updated: 2026-06-11
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Bugs — Active Items
|
|
7
|
+
|
|
8
|
+
Lists **only active** bugs (`open`, `triaged`, `in-progress`). When a bug leaves the active set (`closed`, `wontfix`, `duplicate`, `cannot-reproduce`), delete its line here — the file itself never moves; status lives in its frontmatter. See the [lifecycle](lifecycle.md).
|
|
9
|
+
|
|
10
|
+
Entry format: `- [BUG-NNNN — Title](BUG-NNNN-slug.md) — one-line summary · status · P0–P3`
|
|
11
|
+
|
|
12
|
+
_(none yet)_
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Bugs Lifecycle
|
|
3
|
+
updated: 2026-06-11
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Bugs Lifecycle
|
|
7
|
+
|
|
8
|
+
Bug reports with reproduction, impact, root-cause, and resolution. ID scheme: **BUG-NNNN** (4-digit, zero-padded, globally unique). Filename: `BUG-NNNN-slug.md`.
|
|
9
|
+
|
|
10
|
+
Active files are **never moved** after creation; state lives in the `status:` frontmatter field. Terminal items (`closed`, `wontfix`, `duplicate`, `cannot-reproduce`) may be moved to [`archive/`](archive/) by `/wiki-archive`. The active set is tracked in [`index.md`](index.md).
|
|
11
|
+
|
|
12
|
+
## Frontmatter schema
|
|
13
|
+
|
|
14
|
+
| Key | Required | Notes |
|
|
15
|
+
|-----|----------|-------|
|
|
16
|
+
| `id` | yes | `BUG-NNNN` |
|
|
17
|
+
| `title` | yes | short slug/summary |
|
|
18
|
+
| `status` | yes | `open \| triaged \| in-progress \| closed \| wontfix \| duplicate \| cannot-reproduce` |
|
|
19
|
+
| `severity` | yes | `critical \| high \| medium \| low` |
|
|
20
|
+
| `priority` | yes | `P0 \| P1 \| P2 \| P3` |
|
|
21
|
+
| `created` / `updated` | yes | `YYYY-MM-DD` |
|
|
22
|
+
| `reporter` | yes | who filed it |
|
|
23
|
+
| `assignee` | no | `unassigned` until triage |
|
|
24
|
+
| `tags` | no | discovery only |
|
|
25
|
+
|
|
26
|
+
Closing requires a Root Cause Analysis, a fix commit, and a regression test (`/bug-close` gate).
|
|
27
|
+
|
|
28
|
+
## Status transitions
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
open ──▶ triaged ──▶ in-progress ──▶ closed
|
|
32
|
+
└──▶ wontfix | duplicate | cannot-reproduce
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
- **open** — filed (`/bug-file`); required-on-report fields present.
|
|
36
|
+
- **triaged** — priority/severity/assignee set (`/bug-triage`); decision to fix, defer, or reject.
|
|
37
|
+
- **in-progress** — actively being fixed.
|
|
38
|
+
- **closed** — fixed and verified (`/bug-close`): root cause + fix commit + regression test recorded.
|
|
39
|
+
- **wontfix / duplicate / cannot-reproduce** — terminal rejections; reason recorded in the body.
|
|
File without changes
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
# Decisions Archive
|
|
2
|
+
|
|
3
|
+
Decision group files where all decisions are `accepted` or `superseded`, moved here by `/wiki-archive` to reduce directory clutter. **Append-only** — archived items never move again.
|
|
4
|
+
|
|
5
|
+
| ID | Title | Final Status | Archived |
|
|
6
|
+
|----|-------|--------------|----------|
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Decisions Index
|
|
3
|
+
updated: 2026-06-11
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Decisions — Active Items
|
|
7
|
+
|
|
8
|
+
Lists **only active** Decision Groups — a group stays listed while at least one of its decisions is `proposed`. When every block is `accepted` or `superseded`, delete the group's line here — the file itself never moves; per-decision status lives in each block. See the [lifecycle](lifecycle.md).
|
|
9
|
+
|
|
10
|
+
Entry format: `- [DEC-NNNN — Title](DEC-NNNN-slug.md) — one-line summary · D1 proposed, D2 accepted, …`
|
|
11
|
+
|
|
12
|
+
_(none yet)_
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Decisions Lifecycle
|
|
3
|
+
updated: 2026-06-11
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Decisions Lifecycle
|
|
7
|
+
|
|
8
|
+
Architecture Decision Records. Each file is a **Decision Group** containing one or more `## DM. <title>` decision blocks. ID scheme: **DEC-NNNN** (4-digit, zero-padded) for the group; **DEC-NNNN#DM** for an individual decision (e.g. `DEC-0001#D2`). Filename: `DEC-NNNN-slug.md`.
|
|
9
|
+
|
|
10
|
+
Active files are **never moved** after creation; per-decision state lives in each block's `status` field. When all decisions in a group are `accepted` or `superseded`, the group may be moved to [`archive/`](archive/) by `/wiki-archive`. The active set is tracked in [`index.md`](index.md) — a group stays listed while at least one of its decisions is `proposed`.
|
|
11
|
+
|
|
12
|
+
## Frontmatter / per-decision schema
|
|
13
|
+
|
|
14
|
+
Group frontmatter:
|
|
15
|
+
|
|
16
|
+
| Key | Required | Notes |
|
|
17
|
+
|-----|----------|-------|
|
|
18
|
+
| `id` | yes | `DEC-NNNN` |
|
|
19
|
+
| `title` | yes | decision-group title |
|
|
20
|
+
| `created` / `updated` | yes | `YYYY-MM-DD` |
|
|
21
|
+
| `tags` | yes | umbrella tags for the group |
|
|
22
|
+
|
|
23
|
+
Per-decision block (`## D1.`, `## D2.` …) metadata:
|
|
24
|
+
|
|
25
|
+
| Field | Required | Notes |
|
|
26
|
+
|-------|----------|-------|
|
|
27
|
+
| Status | yes | `proposed \| accepted \| superseded` |
|
|
28
|
+
| Date | yes | `YYYY-MM-DD` |
|
|
29
|
+
| Deciders | yes | who decided |
|
|
30
|
+
| Consulted / Informed | no | E-C-A-D-R inputs |
|
|
31
|
+
| Supersedes | no | `DEC-NNNN#DM \| none` |
|
|
32
|
+
| Tags | yes | decision-area tags |
|
|
33
|
+
|
|
34
|
+
## Status transitions
|
|
35
|
+
|
|
36
|
+
```
|
|
37
|
+
proposed ──▶ accepted ──▶ superseded
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
- **proposed** — drafted in a Decision Group (`/decision-create`); comparison tables + mermaid flowchart, no commitment.
|
|
41
|
+
- **accepted** — finalized per-decision via `/decision-finalize` after an E-C-A-D-R audit. Siblings in the same group are untouched.
|
|
42
|
+
- **superseded** — replaced by a later accepted decision; the new block sets `Supersedes:` and the old block is marked `superseded by DEC-NNNN#DM`. Both blocks updated atomically; old block preserved.
|
|
File without changes
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Requirements Index
|
|
3
|
+
updated: 2026-06-11
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Requirements — Active Items
|
|
7
|
+
|
|
8
|
+
Lists **only active** requirements (`draft`, `approved`). When an item leaves the active set (`retired`), delete its line here — the file itself never moves; status lives in its frontmatter. See the [lifecycle](lifecycle.md).
|
|
9
|
+
|
|
10
|
+
Entry format: `- [REQ-NNN — Title](REQ-NNN-slug.md) — one-line summary · status`
|
|
11
|
+
|
|
12
|
+
_(none yet)_
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Requirements Lifecycle
|
|
3
|
+
updated: 2026-06-11
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Requirements Lifecycle
|
|
7
|
+
|
|
8
|
+
Requirements (PRDs) capture the problem, personas, user stories, success metrics, and non-goals for a body of work. ID scheme: **REQ-NNN** (3-digit, zero-padded, globally unique). Filename: `REQ-NNN-slug.md`.
|
|
9
|
+
|
|
10
|
+
Active files are **never moved** after creation; state lives in the `status:` frontmatter field. Terminal items (`retired`) may be moved to [`archive/`](archive/) by `/wiki-archive`. The active set is tracked in [`index.md`](index.md).
|
|
11
|
+
|
|
12
|
+
## Frontmatter schema
|
|
13
|
+
|
|
14
|
+
| Key | Required | Notes |
|
|
15
|
+
|-----|----------|-------|
|
|
16
|
+
| `id` | yes | `REQ-NNN` |
|
|
17
|
+
| `title` | yes | short requirement name |
|
|
18
|
+
| `status` | yes | `draft \| approved \| retired` |
|
|
19
|
+
| `created` / `updated` | yes | `YYYY-MM-DD` |
|
|
20
|
+
| `owner` | yes | accountable person/role |
|
|
21
|
+
| `stakeholders` | no | consulted/informed list |
|
|
22
|
+
| `tags` | no | discovery only |
|
|
23
|
+
|
|
24
|
+
Approved requirements are amended via append-only `## Amendment N` blocks, never edited in place.
|
|
25
|
+
|
|
26
|
+
## Status transitions
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
draft ──▶ approved ──▶ retired
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
- **draft** — under construction (`/req-create`); edited freely.
|
|
33
|
+
- **approved** — completeness-audited and locked (`/req-finalize`); changes are append-only amendments (`/req-update`).
|
|
34
|
+
- **retired** — superseded or no longer in force; preserved for history.
|
|
File without changes
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Roadmaps Index
|
|
3
|
+
updated: 2026-06-11
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Roadmaps — Active Items
|
|
7
|
+
|
|
8
|
+
Lists **only active** roadmaps (`active`). When a roadmap completes (`done`), delete its line here — the file itself never moves; status lives in its frontmatter. See the [lifecycle](lifecycle.md).
|
|
9
|
+
|
|
10
|
+
Entry format: `- [ROADMAP-NNN — Title](ROADMAP-NNN-slug.md) — one-line summary · N/M items checked`
|
|
11
|
+
|
|
12
|
+
_(none yet)_
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Roadmaps Lifecycle
|
|
3
|
+
updated: 2026-06-11
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Roadmaps Lifecycle
|
|
7
|
+
|
|
8
|
+
Execution-plan roadmaps: a goal, phases, and a hybrid checklist where each item is either a **task link** (`[TASK-NNN](../tasks/TASK-NNN-slug.md)`) or an **inline** checkbox item. ID scheme: **ROADMAP-NNN** (3-digit, zero-padded). Filename: `ROADMAP-NNN-slug.md`.
|
|
9
|
+
|
|
10
|
+
Active files are **never moved** after creation; state lives in the `status:` frontmatter field. Terminal items (`done`) may be moved to [`archive/`](archive/) by `/wiki-archive`. The active set is tracked in [`index.md`](index.md).
|
|
11
|
+
|
|
12
|
+
## Frontmatter schema
|
|
13
|
+
|
|
14
|
+
| Key | Required | Notes |
|
|
15
|
+
|-----|----------|-------|
|
|
16
|
+
| `id` | yes | `ROADMAP-NNN` |
|
|
17
|
+
| `title` | yes | roadmap goal |
|
|
18
|
+
| `status` | yes | `active \| done` |
|
|
19
|
+
| `created` / `updated` | yes | `YYYY-MM-DD` |
|
|
20
|
+
| `owner` | no | accountable person/role |
|
|
21
|
+
| `linked_requirements` | no | `REQ-NNN` back-links |
|
|
22
|
+
| `linked_decisions` | no | `DEC-NNNN` back-links |
|
|
23
|
+
| `tags` | no | discovery only |
|
|
24
|
+
|
|
25
|
+
## Status transitions
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
active ──▶ done
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
- **active** — at least one unchecked item remains. Items are added with `/roadmap-add`; task-linked items auto-check when their task completes.
|
|
32
|
+
- **done** — every checklist item is checked. Completion is implicit; flip `status` to `done` when the last box is ticked.
|
|
File without changes
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Tasks Index
|
|
3
|
+
updated: 2026-06-11
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Tasks — Active Items
|
|
7
|
+
|
|
8
|
+
Lists **only active** tasks (`todo`, `in-progress`). When a task leaves the active set (`done`, `trashed`), delete its line here — the file itself never moves; status lives in its frontmatter. See the [lifecycle](lifecycle.md).
|
|
9
|
+
|
|
10
|
+
Entry format: `- [TASK-NNN — Title](TASK-NNN-slug.md) — one-line summary · status`
|
|
11
|
+
|
|
12
|
+
_(none yet)_
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Tasks Lifecycle
|
|
3
|
+
updated: 2026-06-11
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Tasks Lifecycle
|
|
7
|
+
|
|
8
|
+
Execution-ready task files with `## Steps` checklists. ID scheme: **TASK-NNN** (3-digit, zero-padded). Filename: `TASK-NNN-slug.md`. UAT test files mirror task naming (**UAT-NNN**) and live in the sibling [`../uat/`](../uat/) family.
|
|
9
|
+
|
|
10
|
+
Active files are **never moved** after creation; state lives in the `status:` frontmatter field. Terminal items (`done`, `trashed`) may be moved to [`archive/`](archive/) by `/wiki-archive`. The active set is tracked in [`index.md`](index.md).
|
|
11
|
+
|
|
12
|
+
## Frontmatter schema
|
|
13
|
+
|
|
14
|
+
| Key | Required | Notes |
|
|
15
|
+
|-----|----------|-------|
|
|
16
|
+
| `id` | yes | `TASK-NNN` |
|
|
17
|
+
| `title` | yes | task title |
|
|
18
|
+
| `status` | yes | `todo \| in-progress \| done \| trashed` |
|
|
19
|
+
| `created` / `updated` | yes | `YYYY-MM-DD` |
|
|
20
|
+
| `depends_on` | no | `TASK-NNN` IDs that must finish first |
|
|
21
|
+
| `blocks` | no | `TASK-NNN` IDs this one gates |
|
|
22
|
+
| `parallel_safe_with` | no | `TASK-NNN` IDs safe to run concurrently |
|
|
23
|
+
| `uat` | no | link to the matching `../uat/UAT-NNN-slug.md` |
|
|
24
|
+
| `tags` | no | discovery only |
|
|
25
|
+
|
|
26
|
+
## Status transitions
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
todo ──▶ in-progress ──▶ done
|
|
30
|
+
│ │
|
|
31
|
+
└────────────┴──▶ trashed
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
- **todo** — created by `/task-add`; not yet started.
|
|
35
|
+
- **in-progress** — being executed (`/tackle`). `/tackle` runs **static gates only** (typecheck, `bash -n`, lint, unit tests); runtime/E2E verification is the UAT phase.
|
|
36
|
+
- **done** — implementation complete and its UAT passed (`/uat-walk` / `/uat-auto`) or was explicitly skipped (`/uat-skip`).
|
|
37
|
+
- **trashed** — terminal; abandoned via `/task-trash` with the reason recorded in the file. The matching UAT is trashed alongside.
|
|
38
|
+
|
|
39
|
+
A task reaches **done** only when its UAT is all-pass or skipped — see the [UAT lifecycle](../uat/lifecycle.md).
|
|
File without changes
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
# UAT Archive
|
|
2
|
+
|
|
3
|
+
Terminal UAT files (`passed`, `skipped`, or `trashed`) moved here by `/wiki-archive` to reduce directory clutter. **Append-only** — archived items never move again.
|
|
4
|
+
|
|
5
|
+
| ID | Title | Final Status | Archived |
|
|
6
|
+
|----|-------|--------------|----------|
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: UAT Index
|
|
3
|
+
updated: 2026-06-11
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# UAT — Active Items
|
|
7
|
+
|
|
8
|
+
Lists **only active** UAT files (`pending`, `in-progress`, `failed`). When a UAT leaves the active set (`passed`, `skipped`, `trashed`), delete its line here — the file itself never moves; status lives in its frontmatter. See the [lifecycle](lifecycle.md).
|
|
9
|
+
|
|
10
|
+
Entry format: `- [UAT-NNN — Title](UAT-NNN-slug.md) — verifies TASK-NNN · status`
|
|
11
|
+
|
|
12
|
+
_(none yet)_
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: UAT Lifecycle
|
|
3
|
+
updated: 2026-06-11
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# UAT Lifecycle
|
|
7
|
+
|
|
8
|
+
User-acceptance test files, one per task. ID scheme: **UAT-NNN** (3-digit, zero-padded) — the number **mirrors the task it verifies** (`UAT-014` ↔ `TASK-014`). Filename: `UAT-NNN-slug.md`.
|
|
9
|
+
|
|
10
|
+
Active files are **never moved** after creation; state lives in the `status:` frontmatter field. Terminal items (`passed`, `skipped`, `trashed`) may be moved to [`archive/`](archive/) by `/wiki-archive`. The active set is tracked in [`index.md`](index.md).
|
|
11
|
+
|
|
12
|
+
## Frontmatter schema
|
|
13
|
+
|
|
14
|
+
| Key | Required | Notes |
|
|
15
|
+
|-----|----------|-------|
|
|
16
|
+
| `id` | yes | `UAT-NNN` |
|
|
17
|
+
| `title` | yes | UAT title |
|
|
18
|
+
| `status` | yes | `pending \| in-progress \| passed \| failed \| skipped \| trashed` |
|
|
19
|
+
| `task` | yes | `TASK-NNN` back-link to the task under test |
|
|
20
|
+
| `created` / `updated` | yes | `YYYY-MM-DD` |
|
|
21
|
+
| `tags` | no | discovery only |
|
|
22
|
+
|
|
23
|
+
The body carries an `implements::[[TASK-NNN]]` typed link; the task carries a `uat:` frontmatter link back (`../uat/UAT-NNN-slug.md`).
|
|
24
|
+
|
|
25
|
+
## Per-test markers
|
|
26
|
+
|
|
27
|
+
Each test in the file carries a status marker: `[ ]` (not run), `[x]` (pass), `[FAIL: …]`, `[SKIP: …]`.
|
|
28
|
+
|
|
29
|
+
## Status transitions
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
pending ──▶ in-progress ──▶ passed
|
|
33
|
+
│ ▲
|
|
34
|
+
├──▶ failed ───┘ (rerun after fixes)
|
|
35
|
+
pending ──▶ skipped (/uat-skip — intentional skip, skeleton documents why)
|
|
36
|
+
any ──▶ trashed (/task-trash — task abandoned; reason recorded)
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
- **pending** — created by `/uat-generate`; not yet executed.
|
|
40
|
+
- **in-progress** — being walked (`/uat-walk`) or run headlessly (`/uat-auto`).
|
|
41
|
+
- **passed** — every test `[x]`; the matching task flips to `done`.
|
|
42
|
+
- **failed** — one or more `[FAIL: …]` markers after a full run; flips back to `in-progress` on rerun.
|
|
43
|
+
- **skipped** — UAT deliberately not run (`/uat-skip`); the file records why.
|
|
44
|
+
- **trashed** — terminal; the task was trashed (`/task-trash`); reason recorded in the file.
|
|
45
|
+
|
|
46
|
+
A task reaches **done** only when its UAT is `passed` or `skipped`. See the [tasks lifecycle](../tasks/lifecycle.md).
|
|
47
|
+
|
|
48
|
+
Screenshots and other binary evidence live in [`screenshots/`](screenshots/) (exempt from page conventions).
|
|
File without changes
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
set -euo pipefail
|
|
3
|
+
|
|
4
|
+
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
5
|
+
. "$SCRIPT_DIR/lib.sh"
|
|
6
|
+
|
|
7
|
+
if [ $# -ne 1 ]; then
|
|
8
|
+
echo "Usage: $0 <path-to-project>"
|
|
9
|
+
exit 1
|
|
10
|
+
fi
|
|
11
|
+
|
|
12
|
+
PROJECT_DIR="$(resolve_project_dir "$1")" || exit 1
|
|
13
|
+
|
|
14
|
+
echo "Updating project: $PROJECT_DIR"
|
|
15
|
+
echo ""
|
|
16
|
+
|
|
17
|
+
# 0. Detect legacy .docs/ artifact content (pre-wiki layout) and warn.
|
|
18
|
+
# update never touches these files — migration is a separate, explicit step.
|
|
19
|
+
LEGACY_FAMILIES=(tasks uat adr prd bugs roadmaps)
|
|
20
|
+
LEGACY_FOUND=()
|
|
21
|
+
for fam in "${LEGACY_FAMILIES[@]}"; do
|
|
22
|
+
dir="$PROJECT_DIR/.docs/$fam"
|
|
23
|
+
if [ -d "$dir" ]; then
|
|
24
|
+
count=$(find "$dir" -name '*.md' -type f | wc -l | tr -d ' ')
|
|
25
|
+
if [ "$count" -gt 0 ]; then
|
|
26
|
+
LEGACY_FOUND+=(".docs/$fam ($count file(s))")
|
|
27
|
+
fi
|
|
28
|
+
fi
|
|
29
|
+
done
|
|
30
|
+
|
|
31
|
+
if [ ${#LEGACY_FOUND[@]} -gt 0 ]; then
|
|
32
|
+
echo "=================================================================="
|
|
33
|
+
echo " WARNING: legacy .docs/ artifact content detected"
|
|
34
|
+
echo "=================================================================="
|
|
35
|
+
for entry in "${LEGACY_FOUND[@]}"; do
|
|
36
|
+
echo " - $entry"
|
|
37
|
+
done
|
|
38
|
+
echo ""
|
|
39
|
+
echo " This project was bootstrapped with the old .docs/ layout."
|
|
40
|
+
echo " 'update' will scaffold the new wiki/ structure but will NOT"
|
|
41
|
+
echo " touch these files. To migrate them into wiki/work/, run:"
|
|
42
|
+
echo ""
|
|
43
|
+
echo " npx @codewizard-dt/bootstrap migrate"
|
|
44
|
+
echo ""
|
|
45
|
+
if [ -t 0 ]; then
|
|
46
|
+
read -r -p "Continue with update anyway? [y/N]: " REPLY
|
|
47
|
+
case "$REPLY" in
|
|
48
|
+
[yY]) ;;
|
|
49
|
+
*) echo "Aborted."; exit 0 ;;
|
|
50
|
+
esac
|
|
51
|
+
else
|
|
52
|
+
echo " Non-interactive mode: continuing with update."
|
|
53
|
+
fi
|
|
54
|
+
echo ""
|
|
55
|
+
fi
|
|
56
|
+
|
|
57
|
+
# 0b. Detect other legacy detritus (informational only — no auto-delete)
|
|
58
|
+
if [ -d "$PROJECT_DIR/.claude/commands" ]; then
|
|
59
|
+
echo "Note: legacy .claude/commands/ directory found — slash commands are now"
|
|
60
|
+
echo " global skills. Remove manually when ready: rm -rf .claude/commands/"
|
|
61
|
+
echo ""
|
|
62
|
+
fi
|
|
63
|
+
if [ -d "$PROJECT_DIR/.claude/skills" ]; then
|
|
64
|
+
echo "Note: project-local .claude/skills/ found — skills are installed globally"
|
|
65
|
+
echo " to ~/.claude/skills/ now. Remove manually when ready: rm -rf .claude/skills/"
|
|
66
|
+
echo ""
|
|
67
|
+
fi
|
|
68
|
+
|
|
69
|
+
# Shared setup/update sequence: MCPs, skills+hooks, wiki scaffold, MCP guide, Serena.
|
|
70
|
+
run_project_sync "$PROJECT_DIR" "$SCRIPT_DIR"
|
|
71
|
+
|
|
72
|
+
# Done
|
|
73
|
+
echo "============================="
|
|
74
|
+
echo " Update complete!"
|
|
75
|
+
echo "============================="
|