@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,90 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: wiki-rotate-log
|
|
3
|
+
description: Rotate wiki/log.md into a timestamped archive file when it grows past ~500 lines; create a fresh log.md with an archive-pointer header
|
|
4
|
+
category: wiki
|
|
5
|
+
model: claude-sonnet-4-6
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Wiki Rotate Log
|
|
9
|
+
|
|
10
|
+
Rotate `wiki/log.md` into a timestamped archive file (`log-YYYY_MM_DD_HHMMSS.md`) when it exceeds ~500 lines. Create a fresh `log.md` with an archive-pointer header. **Never truncate** — all content moves to the timestamped file.
|
|
11
|
+
|
|
12
|
+
The timestamp (to the second) makes every archive filename unique by construction, so repeated rotations never collide — no half-year or sequence-suffix logic needed.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## Step 1: Check current log size
|
|
17
|
+
|
|
18
|
+
Read `wiki/log.md`. Count the total number of lines.
|
|
19
|
+
|
|
20
|
+
- If line count is **under 500**: report the count and warn the user: "The log has N lines — rotation is recommended at ~500. Proceed anyway? (yes / no)"
|
|
21
|
+
- If line count is **500 or more**: proceed directly.
|
|
22
|
+
|
|
23
|
+
## Step 2: Determine the archive filename
|
|
24
|
+
|
|
25
|
+
Generate a timestamp to the second using Bash: `date +%Y_%m_%d_%H%M%S`.
|
|
26
|
+
|
|
27
|
+
The archive filename is `log-<timestamp>.md` — e.g. `log-2026_06_14_153012.md`. Because the timestamp is unique to the second, no collision check or suffix logic is needed.
|
|
28
|
+
|
|
29
|
+
## Step 3: Confirm with the user
|
|
30
|
+
|
|
31
|
+
Show the plan:
|
|
32
|
+
```
|
|
33
|
+
Log rotation plan:
|
|
34
|
+
Current: wiki/log.md (N lines)
|
|
35
|
+
Archive: wiki/log-2026_06_14_153012.md
|
|
36
|
+
New log: wiki/log.md (empty, with archive pointer)
|
|
37
|
+
|
|
38
|
+
The existing log.md will be renamed — no content is deleted.
|
|
39
|
+
Proceed? (yes / no)
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Wait for confirmation.
|
|
43
|
+
|
|
44
|
+
## Step 4: Rotate
|
|
45
|
+
|
|
46
|
+
1. **Rename** `wiki/log.md` → `wiki/log-<timestamp>.md` using Bash `mv`.
|
|
47
|
+
2. **Check** for any existing archive pointers in the old log (lines starting with `> Archives:`). If present, carry them forward into the new log.
|
|
48
|
+
3. **Create** a new `wiki/log.md` with:
|
|
49
|
+
|
|
50
|
+
```markdown
|
|
51
|
+
# Wiki Log
|
|
52
|
+
|
|
53
|
+
Append-only record of wiki operations — ingests, queries filed back, lint passes, scaffolding. **Never edit existing entries**; only append new ones at the bottom.
|
|
54
|
+
|
|
55
|
+
Entry format (consistent prefix keeps the log greppable — `grep "^## \[" log.md | tail -5`):
|
|
56
|
+
|
|
57
|
+
```
|
|
58
|
+
## [YYYY-MM-DD] <op> | <subject>
|
|
59
|
+
1–3 sentences on what happened.
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
Operations: `scaffold`, `ingest`, `query`, `lint`, `decision`, `task`, `bug`, `requirement`, `roadmap`, `archive`, `rotate`.
|
|
63
|
+
|
|
64
|
+
> Archives: [2026_06_14_153012](log-2026_06_14_153012.md)
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## [YYYY-MM-DD] rotate | log.md rotated — N lines archived to log-<timestamp>.md
|
|
69
|
+
Previous log archived to log-<timestamp>.md. Fresh log started.
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
Replace `<timestamp>` with the actual timestamp and `N` with the entry count. The `[YYYY-MM-DD]` date prefix on the rotation entry stays date-only (matching all other log entries) — only the archive filename carries the full timestamp. If there were prior archive pointers, add them to the `> Archives:` line separated by ` · `.
|
|
73
|
+
|
|
74
|
+
## Step 5: Report
|
|
75
|
+
|
|
76
|
+
Confirm rotation is complete:
|
|
77
|
+
```
|
|
78
|
+
Done. wiki/log.md rotated:
|
|
79
|
+
- N lines moved to wiki/log-2026_06_14_153012.md
|
|
80
|
+
- New wiki/log.md created with archive pointer
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## CRITICAL rules
|
|
86
|
+
|
|
87
|
+
- **Never delete** any log content — rotation is renaming + creating a new file.
|
|
88
|
+
- **Never edit** the archived file after renaming.
|
|
89
|
+
- The `> Archives:` header line in the new `log.md` must link to ALL prior archive files, not just the most recent one.
|
|
90
|
+
- The first entry in the new `log.md` must be the rotation event itself.
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: wiki-tidy
|
|
3
|
+
description: One-shot wiki cleanup — runs lint, archives terminal items across all families, and rotates the log if overgrown, in sequence with user confirmation at each phase
|
|
4
|
+
category: wiki
|
|
5
|
+
model: claude-sonnet-4-6
|
|
6
|
+
user-invocable: true
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Wiki Tidy
|
|
10
|
+
|
|
11
|
+
Three-phase cleanup for a neglected wiki. Runs in order: **lint → archive → rotate-log**. Each phase summarises its findings and asks for confirmation before making changes. You can stop after any phase.
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## Phase 1: Lint
|
|
16
|
+
|
|
17
|
+
Run the full wiki-lint audit by following every step in `/wiki-lint` exactly as written:
|
|
18
|
+
|
|
19
|
+
1. Inventory the wiki tree.
|
|
20
|
+
2. Run all 10 checks (stranded terminal files, family-index drift, two-domain violations, ID/filename mismatch, UAT↔task cross-links, typed-link vocabulary, orphan pages, never-ingested raw sources, contradictions, stale frontmatter).
|
|
21
|
+
3. Report findings grouped by severity (HIGH / MEDIUM / LOW).
|
|
22
|
+
4. For each HIGH finding, propose the exact fix.
|
|
23
|
+
5. Ask: **"Which findings should I fix? Reply with 'all', specific IDs, or 'none' to skip. Type 'stop' to end wiki-tidy here."**
|
|
24
|
+
6. Apply approved fixes. Append one `lint` entry to `wiki/log.md`.
|
|
25
|
+
|
|
26
|
+
If the user types `stop`, end the skill here. Otherwise continue to Phase 2.
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Phase 2: Archive
|
|
31
|
+
|
|
32
|
+
Run `/wiki-archive` as a cleanup sweep — it scans for any work items with terminal status that were not automatically moved to `archive/` by their originating skill (`uat-auto`, `bug-close`, `task-trash`, etc.). In a healthy wiki this phase finds nothing; it exists as a safety net.
|
|
33
|
+
|
|
34
|
+
Scan all 6 families in sequence: `tasks`, `uat`, `bugs`, `requirements`, `decisions`, `roadmaps`.
|
|
35
|
+
|
|
36
|
+
For each family:
|
|
37
|
+
1. Read its `lifecycle.md` to confirm the terminal statuses (do NOT hardcode).
|
|
38
|
+
2. Use `mcp__serena__list_dir` on the family directory.
|
|
39
|
+
3. Identify files whose `status:` frontmatter is terminal (exclude `lifecycle.md`, `index.md`, `.gitkeep`, and anything already under `archive/`).
|
|
40
|
+
|
|
41
|
+
After scanning all 6 families, show a combined summary:
|
|
42
|
+
|
|
43
|
+
```
|
|
44
|
+
Archive candidates:
|
|
45
|
+
tasks — N items (TASK-012 done, TASK-019 trashed, …)
|
|
46
|
+
uat — N items (UAT-012 passed, …)
|
|
47
|
+
bugs — N items
|
|
48
|
+
requirements— N items
|
|
49
|
+
decisions — N items
|
|
50
|
+
roadmaps — N items
|
|
51
|
+
|
|
52
|
+
Total: N items across N families.
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Ask: **"Archive all, specific families (e.g. 'tasks uat'), or 'none' to skip? Type 'stop' to end wiki-tidy here."**
|
|
56
|
+
|
|
57
|
+
For each confirmed family:
|
|
58
|
+
1. Move each terminal file: `mv wiki/work/<family>/<file> wiki/work/<family>/archive/<file>`
|
|
59
|
+
2. Read the file's `id`, `title`, `status`, and `updated` frontmatter.
|
|
60
|
+
3. Append a row to `wiki/work/<family>/archive/index.md`:
|
|
61
|
+
```
|
|
62
|
+
| [[ID]] | Title | final-status | YYYY-MM-DD |
|
|
63
|
+
```
|
|
64
|
+
4. Remove the item's row from the family's active `index.md` if it is still listed there.
|
|
65
|
+
|
|
66
|
+
After all moves, append one `archive` entry to `wiki/log.md`:
|
|
67
|
+
```
|
|
68
|
+
## [YYYY-MM-DD] archive | wiki-tidy — N items archived across K families
|
|
69
|
+
Moved N terminal items: <comma-separated IDs>.
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
If the user types `stop`, end the skill here. Otherwise continue to Phase 3.
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## Phase 3: Rotate log
|
|
77
|
+
|
|
78
|
+
Run `/wiki-rotate-log`:
|
|
79
|
+
|
|
80
|
+
1. Read `wiki/log.md` and count the total number of lines.
|
|
81
|
+
2. If under 500: report the count and ask **"Log has N lines (threshold: 500). Rotate anyway? (yes / no / stop)"**. If `no`, skip this phase; if `stop`, end the skill.
|
|
82
|
+
3. If 500 or more: proceed directly.
|
|
83
|
+
4. Determine the archive filename: generate a timestamp with `date +%Y_%m_%d_%H%M%S` and use `log-<timestamp>.md` (unique to the second — no collision handling needed).
|
|
84
|
+
5. Show the rotation plan and ask **"Proceed with rotation? (yes / no)"**.
|
|
85
|
+
6. On confirmation: rename `wiki/log.md` → `wiki/log-<timestamp>.md`, create a fresh `wiki/log.md` with an archive-pointer header and a `rotate` entry as its first log line.
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## Final report
|
|
90
|
+
|
|
91
|
+
After all three phases, print a one-paragraph summary:
|
|
92
|
+
|
|
93
|
+
```
|
|
94
|
+
Wiki tidy complete.
|
|
95
|
+
Lint: N issues found, M fixed.
|
|
96
|
+
Archive sweep: N stranded items moved (0 is healthy).
|
|
97
|
+
Log: rotated / not rotated (N entries).
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## CRITICAL rules
|
|
103
|
+
|
|
104
|
+
- Follow each sub-skill's CRITICAL rules exactly — they take precedence over brevity.
|
|
105
|
+
- Never move an active item. Never edit archived file content. Never delete anything.
|
|
106
|
+
- Always confirm with the user before applying changes in each phase.
|
|
107
|
+
- `stop` at any phase prompt ends the skill immediately without proceeding further.
|
package/package.json
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@codewizard-dt/bootstrap",
|
|
3
|
+
"version": "2.10.0",
|
|
4
|
+
"description": "Bootstrap Claude Code projects with an LLM Wiki, reusable skills, hooks, and MCP setup",
|
|
5
|
+
"homepage": "https://github.com/codewizard-dt/bootstrap-wiki#readme",
|
|
6
|
+
"bugs": {
|
|
7
|
+
"url": "https://github.com/codewizard-dt/bootstrap-wiki/issues"
|
|
8
|
+
},
|
|
9
|
+
"repository": {
|
|
10
|
+
"type": "git",
|
|
11
|
+
"url": "git+https://github.com/codewizard-dt/bootstrap-wiki.git"
|
|
12
|
+
},
|
|
13
|
+
"license": "ISC",
|
|
14
|
+
"author": "",
|
|
15
|
+
"type": "commonjs",
|
|
16
|
+
"bin": {
|
|
17
|
+
"bootstrap": "./bin/cli.js"
|
|
18
|
+
},
|
|
19
|
+
"publishConfig": {
|
|
20
|
+
"access": "public"
|
|
21
|
+
},
|
|
22
|
+
"files": [
|
|
23
|
+
"bin/",
|
|
24
|
+
"lib/",
|
|
25
|
+
"raw/",
|
|
26
|
+
".github/",
|
|
27
|
+
".gitleaks.toml"
|
|
28
|
+
],
|
|
29
|
+
"scripts": {
|
|
30
|
+
"test": "echo \"Error: no test specified\" && exit 1"
|
|
31
|
+
}
|
|
32
|
+
}
|
package/raw/.gitkeep
ADDED
|
File without changes
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# Design Principles
|
|
2
|
+
|
|
3
|
+
## Frontend Taste — House Style
|
|
4
|
+
|
|
5
|
+
Calm, technical, light-mode editorial — a *tool*, not a consumer app. Clarity over decoration.
|
|
6
|
+
|
|
7
|
+
The canonical source is `~/code/house-style`; a snapshot lives in `raw/house-style/` here. Wire it into any new frontend project:
|
|
8
|
+
|
|
9
|
+
1. **Tailwind preset** — `presets: [houseStyle]` in `tailwind.config`, importing `raw/house-style/tokens/tailwind.preset.ts`.
|
|
10
|
+
2. **Base layer** — apply `raw/house-style/preview/src/index.css`: `bg-canvas text-ink antialiased`, body `letter-spacing:-0.011em`, `font-feature-settings:"ss01","cv11","cv02"`, plus the `dot-grid` / `text-balance` / `scrollbar-none` utilities and `::selection` tint.
|
|
11
|
+
3. **Font** — load **Inter Tight** (fallback: Inter, then system-ui).
|
|
12
|
+
4. **Components** — copy `raw/house-style/components/*.tsx` as starting patterns; each is props-driven and content-agnostic with all hover/press/focus/selected states preserved.
|
|
13
|
+
5. **Visual reference** — `~/code/house-style/preview/` (`cd preview && npm i && npm run dev`).
|
|
14
|
+
|
|
15
|
+
### Aesthetic rules
|
|
16
|
+
|
|
17
|
+
- **Neutral ground, ink on off-white.** Canvas `#f6f7f9`, white cards, near-black ink (`#0b0b0d`). Color is reserved for meaning (interactive affordances, semantic state), never decoration.
|
|
18
|
+
- **Soft depth, no gloss.** 14 px radii, 1 px hairline borders (`#e7e8ea`), whisper-soft shadows. Gradients and dark surfaces appear only where a feature demands them.
|
|
19
|
+
- **Technical type.** Inter Tight, globally tight tracking (`-0.011em`), stylistic sets on. Uppercase micro-labels get *expanded* tracking (`~0.08em`); monospace for codes and IDs. Type scale: display ~15 px/600; uppercase labels 10–12 px/600; body 13–13.5 px leading-relaxed; button 13 px/500; caption/mono 11 px.
|
|
20
|
+
- **Motion that clarifies, not entertains.** Snappy entrances (`popIn` 220 ms), gentle rises (`riseIn` 500 ms), all on `cubic-bezier(.22,1,.36,1)`. Press-scale on interactive elements (`active:scale-[.985]`). No long delays.
|
|
21
|
+
- **Restraint.** The default accent is muted blue-gray (`#4f5a78`) — focus rings and subtle affordances, not loud primaries.
|
|
22
|
+
|
|
23
|
+
### Token quick-reference
|
|
24
|
+
|
|
25
|
+
| Group | Values |
|
|
26
|
+
|---|---|
|
|
27
|
+
| Surfaces | `canvas #f6f7f9` · `surface #f1f2f4` · `paper/card #fff` |
|
|
28
|
+
| Ink | `ink #0b0b0d` · `ink-2 #33353b` · `muted #6b6e76` · `muted-2 #9a9da5` |
|
|
29
|
+
| Lines | `line #e7e8ea` · `line-2 #f0f1f3` |
|
|
30
|
+
| Accent | `#4f5a78` (neutral) · `red #e5484d` · `green #30a46c` · `blue #3b6ef6` |
|
|
31
|
+
| Radius | `card 14 px` · `pill 999 px` |
|
|
32
|
+
| Motion | `fadeIn` `riseIn` `popIn` `revealIn` `travel` `shimmer` `breathe` `spinSlow` `drawIn` `bounceSoft` |
|
|
33
|
+
|
|
34
|
+
### Component inventory
|
|
35
|
+
|
|
36
|
+
- **`Button`** — primary dark CTA; optional leading icon gets a hover tilt-and-grow.
|
|
37
|
+
- **`IconButton`** — icon + label, `variant` (primary/secondary), `iconMotion` (tilt | spin3d), `loading` spinner swap.
|
|
38
|
+
- **`Chip`** — pill that lifts on hover; `tone` (neutral/highlight) + optional status dot.
|
|
39
|
+
- **`Stepper`** — horizontal progress indicator with orbiting spinner, self-drawing checkmark, and a travelling dot on the in-flight connector rail.
|
|
40
|
+
- **`Card` · `Badge` · `Modal`** — surfaces, pill labels, blurred pop-in overlay.
|
|
41
|
+
- **`icons.tsx`** — inline-SVG icon set (no icon dependency): spark, image, cube, bolt, diamond, expand, chevron, draw-in check, spinner, x.
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## DRY — Don't Repeat Yourself
|
|
46
|
+
|
|
47
|
+
Every piece of knowledge should have a single, authoritative representation in the system. When logic, data, or behavior appears in more than one place, changes require updates everywhere — and they rarely stay in sync.
|
|
48
|
+
|
|
49
|
+
In practice: extract shared logic into a function or module; avoid copy-pasting code blocks; centralise configuration rather than scattering literals. The goal is one source of truth, not necessarily the fewest lines.
|
|
50
|
+
|
|
51
|
+
## SOLID
|
|
52
|
+
|
|
53
|
+
Five principles for writing object-oriented (and more broadly, modular) code that stays maintainable as it grows:
|
|
54
|
+
|
|
55
|
+
- **Single Responsibility** — a class or module should have one reason to change. If it handles both business logic and persistence, those two concerns will pull it in different directions over time.
|
|
56
|
+
- **Open/Closed** — code should be open for extension but closed for modification. Add new behaviour by adding new code, not by editing existing, tested paths.
|
|
57
|
+
- **Liskov Substitution** — subtypes must be substitutable for their base types without breaking callers. A subclass that weakens guarantees or surprises callers violates this.
|
|
58
|
+
- **Interface Segregation** — prefer narrow, focused interfaces over broad ones. Callers shouldn't depend on methods they don't use.
|
|
59
|
+
- **Dependency Inversion** — depend on abstractions, not concretions. High-level modules shouldn't be coupled to low-level implementation details; both should depend on interfaces.
|
|
60
|
+
|
|
61
|
+
## YAGNI — You Aren't Gonna Need It
|
|
62
|
+
|
|
63
|
+
Don't build something until you actually need it. Speculative features add complexity, require maintenance, and often turn out to be wrong by the time a real requirement arrives.
|
|
64
|
+
|
|
65
|
+
In practice: implement the simplest thing that solves the current problem. Resist the urge to add extension points, configuration flags, or abstractions "just in case." If the need materialises later, add it then — with full context.
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
# command-anti-patterns.md
|
|
2
|
+
|
|
3
|
+
**Purpose**: Shell-command and file-operation hygiene rules for AI agents running verification, setup, and one-off tasks.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## TOP RULE — One command, one job
|
|
8
|
+
|
|
9
|
+
Every shell invocation should do exactly one thing.
|
|
10
|
+
|
|
11
|
+
Do NOT chain `A && B && C && D` just because all must succeed — run them as separate invocations so (a) each is independently re-runnable, (b) approval prompts aren't ganged, (c) failures pinpoint the offending step.
|
|
12
|
+
|
|
13
|
+
**Bad** (real incident that triggered this guide):
|
|
14
|
+
```bash
|
|
15
|
+
SCRATCH=$(mktemp -d) && echo "SCRATCH=$SCRATCH" && mkdir -p "$SCRATCH" && /path/sync-docs-scaffold.sh "$SCRATCH" && echo "---SCRATCH_PATH---" && echo "$SCRATCH" > /tmp/scratch_path.txt && cat /tmp/scratch_path.txt
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
**Good**: one `mkdir -p ./tmp/scratch`, then one `./sync-docs-scaffold.sh ./tmp/scratch`, then one `mcp__serena__list_dir relative_path="tmp/scratch/.docs" recursive=true`
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Prefer project-local scratch (`./tmp/`) over `/tmp/` or `$(mktemp -d)`
|
|
23
|
+
|
|
24
|
+
Rule: when a script needs a scratch directory, create `./tmp/<purpose>/` inside the project root and add `tmp/` to `.gitignore` if not already present.
|
|
25
|
+
|
|
26
|
+
Why: project-local paths are (a) visible to MCP Serena (which is project-scoped), (b) inspectable without leaving the project tree, (c) deleted by a single `rm -rf ./tmp/<purpose>` that is obviously safe.
|
|
27
|
+
|
|
28
|
+
`/tmp/` and `mktemp -d` paths live outside Serena's project scope, force shell-based inspection, and accumulate if not cleaned.
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
mkdir -p ./tmp/scratch
|
|
32
|
+
./sync-docs-scaffold.sh ./tmp/scratch
|
|
33
|
+
```
|
|
34
|
+
(two invocations, both single-purpose)
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
## No intermediate `echo` progress banners
|
|
39
|
+
|
|
40
|
+
Banners like `echo "---SCRATCH_PATH---"` or `echo "===== API-2 DONE ====="` add no information the tool result doesn't already convey and clutter the transcript.
|
|
41
|
+
|
|
42
|
+
Read the command's actual output; do not wrap it in decorative banners.
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## No temp-file round-trips
|
|
47
|
+
|
|
48
|
+
Anti-pattern: `echo "$X" > /tmp/foo && cat /tmp/foo` just to surface a value.
|
|
49
|
+
|
|
50
|
+
Rule: if you need the value, print it directly (`echo "$X"`); if it's already known to the agent, don't surface it at all.
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## Classic shell footguns
|
|
55
|
+
|
|
56
|
+
- `cat file | grep pattern` — use `grep pattern file` (or the `Grep` tool, or `mcp__serena__search_for_pattern`)
|
|
57
|
+
- `ls | grep foo` — parse-ls is broken on filenames with spaces/newlines; use a glob or `mcp__serena__find_file`
|
|
58
|
+
- `rm -rf $var` — always quote: `rm -rf "$var"`, and guard against empty: `[ -n "$var" ] && rm -rf "$var"`
|
|
59
|
+
- Unquoted `$var` in paths/arguments — always double-quote unless you specifically want word-splitting
|
|
60
|
+
- Missing `set -euo pipefail` at the top of any `bash` script — every new helper script must include it (`sync-docs-scaffold.sh`, `bootstrap-serena.sh` are precedent)
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## Verification belongs to the right phase
|
|
65
|
+
|
|
66
|
+
`/tackle` verification = **static gates only**: `bash -n <script>`, `pnpm typecheck`, `mypy`, lint, unit tests. Any command that produces deterministic pass/fail text without executing runtime behavior or touching the live filesystem beyond reading it.
|
|
67
|
+
|
|
68
|
+
**NOT** allowed in `/tackle` verification: running the script against a scratch dir, creating temp dirs, rsync dry-runs, curl calls, spawning servers, seeding fixtures, asserting on output contents.
|
|
69
|
+
|
|
70
|
+
Everything above belongs in **UAT** (`/uat-generate` → `/uat-walk` / `/uat-auto`). UAT is the phase designed for end-to-end runtime verification.
|
|
71
|
+
|
|
72
|
+
Rule of thumb: if the verification step needs more than one command, or creates any file, or reads any file's contents — move it to UAT.
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## See also
|
|
77
|
+
|
|
78
|
+
- [`mcp-tools.md`](./mcp-tools.md) — Common anti-patterns: the MCP-tool side (no `sed`/`cat`/`ls`/`grep` on files)
|
|
79
|
+
- [`task-lifecycle.md`](./task-lifecycle.md) — The `/tackle` vs UAT flow
|