@sienklogic/plan-build-run 2.0.0 → 2.0.1

package/plugins/pbr/skills/milestone/templates/audit-report.md.tmpl

@@ -1,48 +1,48 @@
-# Template: Milestone Audit Report
-# Used by: milestone/SKILL.md (audit subcommand, Step 5)
-# Variables: {version}, {status}, {date}, {phase entries}, {integration results}, {requirements}, {tech debt}
-
----
-milestone: "{version}"
-status: "{passed | gaps_found | tech_debt}"
-date: "{ISO date}"
----
-
-# Milestone Audit: {version}
-
-## Overall Status: {PASSED / GAPS FOUND / TECH DEBT}
-
-## Phase Verification Summary
-
-| Phase | Verified | Gaps | Integration |
-|-------|----------|------|-------------|
-| {N}. {name} | {yes/no} | {count} | {ok/issues} |
-
-## Integration Check Results
-
-### Dependency Graph
-{Mermaid or ASCII representation of phase dependencies}
-
-### Integration Issues
-{List of integration problems found, or "None"}
-
-- **{Issue}**: {description}
-  - Affected phases: {list}
-  - Severity: {critical/high/medium/low}
-  - Suggested fix: {brief suggestion}
-
-## Requirements Coverage
-
-| Requirement | Status | Verified By |
-|-------------|--------|-------------|
-| {req} | {covered/uncovered} | {phase/plan or "N/A"} |
-
-## Tech Debt Identified
-
-{Issues that don't block the milestone but should be addressed}
-
-- {debt item}: {description}
-
-## Recommendations
-
-{Summary of what needs to be done, if anything}
+# Template: Milestone Audit Report
+# Used by: milestone/SKILL.md (audit subcommand, Step 5)
+# Variables: {version}, {status}, {date}, {phase entries}, {integration results}, {requirements}, {tech debt}
+
+---
+milestone: "{version}"
+status: "{passed | gaps_found | tech_debt}"
+date: "{ISO date}"
+---
+
+# Milestone Audit: {version}
+
+## Overall Status: {PASSED / GAPS FOUND / TECH DEBT}
+
+## Phase Verification Summary
+
+| Phase | Verified | Gaps | Integration |
+|-------|----------|------|-------------|
+| {N}. {name} | {yes/no} | {count} | {ok/issues} |
+
+## Integration Check Results
+
+### Dependency Graph
+{Mermaid or ASCII representation of phase dependencies}
+
+### Integration Issues
+{List of integration problems found, or "None"}
+
+- **{Issue}**: {description}
+  - Affected phases: {list}
+  - Severity: {critical/high/medium/low}
+  - Suggested fix: {brief suggestion}
+
+## Requirements Coverage
+
+| Requirement | Status | Verified By |
+|-------------|--------|-------------|
+| {req} | {covered/uncovered} | {phase/plan or "N/A"} |
+
+## Tech Debt Identified
+
+{Issues that don't block the milestone but should be addressed}
+
+- {debt item}: {description}
+
+## Recommendations
+
+{Summary of what needs to be done, if anything}

package/plugins/pbr/skills/milestone/templates/stats-file.md.tmpl

@@ -1,30 +1,30 @@
-# Template: Milestone Stats File
-# Used by: milestone/SKILL.md (complete subcommand, Step 5)
-# Variables: {version}, {name}, {date}, {days}, {counts}, {accomplishments}, {decisions}, {tech stack}, {patterns}
-
-# Milestone {version} Stats
-
-**Name:** {milestone name}
-**Completed:** {ISO date}
-**Duration:** {days}
-
-## Metrics
-- Phases: {count}
-- Plans executed: {count}
-- Quick tasks: {count}
-- Total commits: {count}
-- Files changed: {count}
-- Lines added: {count}
-- Lines removed: {count}
-
-## Accomplishments
-{bulleted list of key features/capabilities built}
-
-## Key Decisions
-{bulleted list of important decisions made}
-
-## Technology Stack
-{list of technologies used}
-
-## Patterns Established
-{list of patterns applied}
+# Template: Milestone Stats File
+# Used by: milestone/SKILL.md (complete subcommand, Step 5)
+# Variables: {version}, {name}, {date}, {days}, {counts}, {accomplishments}, {decisions}, {tech stack}, {patterns}
+
+# Milestone {version} Stats
+
+**Name:** {milestone name}
+**Completed:** {ISO date}
+**Duration:** {days}
+
+## Metrics
+- Phases: {count}
+- Plans executed: {count}
+- Quick tasks: {count}
+- Total commits: {count}
+- Files changed: {count}
+- Lines added: {count}
+- Lines removed: {count}
+
+## Accomplishments
+{bulleted list of key features/capabilities built}
+
+## Key Decisions
+{bulleted list of important decisions made}
+
+## Technology Stack
+{list of technologies used}
+
+## Patterns Established
+{list of patterns applied}

package/plugins/pbr/skills/note/SKILL.md

@@ -1,212 +1,231 @@
----
-name: note
-description: "Zero-friction idea capture. Append, list, or promote notes to todos."
-allowed-tools: Read, Write, Glob, Grep
-argument-hint: "<text> | list | promote <index> [--global]"
----
-
-# /pbr:note — Quick Note Capture
-
-You are running the **note** skill. Your job is zero-friction idea capture. One Write call, one confirmation line. No questions, no prompts.
-
-This skill runs **inline** — no Task, no AskUserQuestion, no Bash.
-
----
-
-## Scope Detection
-
-Two scopes exist. Auto-detect which to use:
-
-1. **Project scope**: `.planning/NOTES.md` — used when `.planning/` directory exists in cwd
-2. **Global scope**: `~/.claude/notes.md` — used as fallback when no `.planning/`, or when `--global` flag is present
-
-**`--global` flag**: Strip `--global` from anywhere in `$ARGUMENTS` before parsing. When present, force global scope regardless of whether `.planning/` exists.
-
-**Important**: Do NOT create `.planning/` if it doesn't exist. If there's no `.planning/` directory, fall back to global scope silently.
-
----
-
-## Subcommand Parsing
-
-Parse `$ARGUMENTS` after stripping `--global`:
-
-| Condition | Subcommand |
-|-----------|------------|
-| Arguments are exactly `list` (case-insensitive) | **list** |
-| Arguments are exactly `promote <N>` where N is a number | **promote** |
-| Arguments are empty (no text at all) | **list** |
-| Anything else | **append** (the text IS the note) |
-
-**Critical**: `list` is only a subcommand when it's the ENTIRE argument. `/pbr:note list of groceries` saves a note with text "list of groceries". Same for `promote` — only a subcommand when followed by exactly one number.
-
----
-
-## Subcommand: append
-
-Append a timestamped note to the target file.
-
-### Steps
-
-1. Determine scope (project or global) per Scope Detection above
-2. Read the target file if it exists
-3. If the file doesn't exist, create it with this header:
-
-```markdown
-# Notes
-
-Quick captures from `/pbr:note`. Ideas worth remembering.
-
----
-
-```
-
-4. Ensure the file content ends with a newline before appending
-5. Append: `- [YYYY-MM-DD HH:mm] {note text verbatim}`
-6. Write the file
-7. Confirm with exactly one line: `Noted ({scope}): {note text}`
-   - Where `{scope}` is "project" or "global"
-
-### Constraints
-
-- **Never modify the note text** — capture verbatim, including typos
-- **Never ask questions** — just write and confirm
-- **Timestamp format**: Use local time, `YYYY-MM-DD HH:mm` (24-hour, no seconds)
-
----
-
-## Subcommand: list
-
-Show notes from both project and global scopes.
-
-### Steps
-
-1. Read `.planning/NOTES.md` (if exists) — these are "project" notes
-2. Read `~/.claude/notes.md` (if exists) — these are "global" notes
-3. Parse entries: lines matching `^- \[` are notes
-4. Exclude lines containing `[promoted]` from active counts (but still show them, dimmed)
-5. Number all active entries sequentially starting at 1 (across both scopes)
-6. If total active entries > 20, show only the last 10 with a note about how many were omitted
-
-### Display Format
-
-```
-Notes:
-
-Project (.planning/NOTES.md):
-  1. [2026-02-08 14:32] refactor the hook system to support async validators
-  2. [promoted] [2026-02-08 14:40] add rate limiting to the API endpoints
-  3. [2026-02-08 15:10] consider adding a --dry-run flag to build
-
-Global (~/.claude/notes.md):
-  4. [2026-02-08 10:00] cross-project idea about shared config
-
-{count} active note(s). Use `/pbr:note promote <N>` to convert to a todo.
-```
-
-If a scope has no file or no entries, show: `(no notes)`
-
----
-
-## Subcommand: promote
-
-Convert a note into a todo file.
-
-### Steps
-
-1. Run the **list** logic to build the numbered index (both scopes)
-2. Find entry N from the numbered list
-3. If N is invalid or refers to an already-promoted note, tell the user and stop
-4. **Requires `.planning/` directory** — if it doesn't exist, warn: "Todos require a Plan-Build-Run project. Run `/pbr:begin` to initialize one, or use `/pbr:todo add` in an existing project."
-5. Ensure `.planning/todos/pending/` directory exists
-6. Generate todo ID: `{YYYYMMDD}-{NNN}` where NNN is sequential within the day (check existing files)
-7. Extract the note text (everything after the timestamp)
-8. Create `.planning/todos/pending/{id}.md`:
-
-```yaml
----
-id: {id}
-area: general
-priority: normal
-created: {ISO-timestamp}
-source: "promoted from /pbr:note"
----
-
-# {note text}
-
-## Context
-Promoted from quick note captured on {original date}.
-
-## Notes
-(empty)
-```
-
-9. Mark the original note as promoted: replace `- [` with `- [promoted] [` on that line
-10. Confirm: `Promoted note {N} to todo {id}: {note text}`
-
----
-
-## NOTES.md Format Reference
-
-```markdown
-# Notes
-
-Quick captures from `/pbr:note`. Ideas worth remembering.
-
----
-
-- [2026-02-08 14:32] refactor the hook system to support async validators
-- [promoted] [2026-02-08 14:40] add rate limiting to the API endpoints
-- [2026-02-08 15:10] consider adding a --dry-run flag to build
-```
-
----
-
-## Edge Cases
-
-1. **"list" as note text**: `/pbr:note list of things` → saves note "list of things" (subcommand only when `list` is the entire arg)
-2. **No `.planning/`**: Falls back to global `~/.claude/notes.md` — works in any directory
-3. **Promote without project**: Warns that todos require `.planning/`, suggests `/pbr:begin`
-4. **Large files**: `list` shows last 10 when >20 active entries
-5. **Missing newline**: Always ensure trailing newline before appending
-6. **`--global` position**: Stripped from anywhere — `--global my idea` and `my idea --global` both save "my idea" globally
-7. **Promote already-promoted**: Tell user "Note {N} is already promoted" and stop
-8. **Empty note text after stripping flags**: Treat as `list` subcommand
-
----
-
-## Error Handling
-
-### Write failure
-If the Write tool fails (permissions, disk full, etc.), display:
-```
-╔══════════════════════════════════════════════════════════════╗
-║  ERROR                                                       ║
-╚══════════════════════════════════════════════════════════════╝
-
-Failed to write note to {target_file}.
-
-**To fix:** Check file permissions or disk space.
-```
-
-### Promote target not found
-If the specified note index is invalid, display:
-```
-╔══════════════════════════════════════════════════════════════╗
-║  ERROR                                                       ║
-╚══════════════════════════════════════════════════════════════╝
-
-Note {N} not found. Valid range: 1-{max}.
-
-**To fix:** Run `/pbr:note list` to see available notes.
-```
-
----
-
-## Anti-Patterns
-
-1. **DO NOT** ask questions on append — just write and confirm
-2. **DO NOT** modify note text — capture verbatim
-3. **DO NOT** use Task, AskUserQuestion, or Bash
-4. **DO NOT** create `.planning/` if it doesn't exist — fall back to global
-5. **DO NOT** number promoted notes in the active count (but still display them)
-6. **DO NOT** over-format the confirmation — one line is enough
+---
+name: note
+description: "Zero-friction idea capture. Append, list, or promote notes to todos."
+allowed-tools: Read, Write, Glob, Grep
+argument-hint: "<text> | list | promote <index> [--global]"
+---
+
+**STOP — DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Using the Read tool on this SKILL.md file wastes ~7,600 tokens. Begin executing Step 1 immediately.**
+
+## Step 0 — Immediate Output
+
+**Before ANY tool calls**, display this banner:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ PLAN-BUILD-RUN ► NOTE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Then proceed to Step 1.
+
+# /pbr:note — Quick Note Capture
+
+You are running the **note** skill. Your job is zero-friction idea capture. One Write call, one confirmation line. No questions, no prompts.
+
+This skill runs **inline** — no Task, no AskUserQuestion, no Bash.
+
+---
+
+## Scope Detection
+
+Two scopes exist. Auto-detect which to use:
+
+1. **Project scope**: `.planning/NOTES.md` — used when `.planning/` directory exists in cwd
+2. **Global scope**: `~/.claude/notes.md` — used as fallback when no `.planning/`, or when `--global` flag is present
+
+**`--global` flag**: Strip `--global` from anywhere in `$ARGUMENTS` before parsing. When present, force global scope regardless of whether `.planning/` exists.
+
+**Important**: Do NOT create `.planning/` if it doesn't exist. If there's no `.planning/` directory, fall back to global scope silently.
+
+---
+
+## Subcommand Parsing
+
+Parse `$ARGUMENTS` after stripping `--global`:
+
+| Condition | Subcommand |
+|-----------|------------|
+| Arguments are exactly `list` (case-insensitive) | **list** |
+| Arguments are exactly `promote <N>` where N is a number | **promote** |
+| Arguments are empty (no text at all) | **list** |
+| Anything else | **append** (the text IS the note) |
+
+**Critical**: `list` is only a subcommand when it's the ENTIRE argument. `/pbr:note list of groceries` saves a note with text "list of groceries". Same for `promote` — only a subcommand when followed by exactly one number.
+
+---
+
+## Subcommand: append
+
+Append a timestamped note to the target file.
+
+### Steps
+
+1. Determine scope (project or global) per Scope Detection above
+2. Read the target file if it exists
+3. If the file doesn't exist, create it with this header:
+
+```markdown
+# Notes
+
+Quick captures from `/pbr:note`. Ideas worth remembering.
+
+---
+
+```
+
+4. Ensure the file content ends with a newline before appending
+5. Append: `- [YYYY-MM-DD HH:mm] {note text verbatim}`
+6. Write the file
+7. Confirm with exactly one line: `Noted ({scope}): {note text}`
+   - Where `{scope}` is "project" or "global"
+
+### Constraints
+
+- **Never modify the note text** — capture verbatim, including typos
+- **Never ask questions** — just write and confirm
+- **Timestamp format**: Use local time, `YYYY-MM-DD HH:mm` (24-hour, no seconds)
+
+---
+
+## Subcommand: list
+
+Show notes from both project and global scopes.
+
+### Steps
+
+1. Read `.planning/NOTES.md` (if exists) — these are "project" notes
+2. Read `~/.claude/notes.md` (if exists) — these are "global" notes
+3. Parse entries: lines matching `^- \[` are notes
+4. Exclude lines containing `[promoted]` from active counts (but still show them, dimmed)
+5. Number all active entries sequentially starting at 1, using plain integers (1, 2, 3...) for display (across both scopes)
+6. If total active entries > 20, show only the last 10 with a note about how many were omitted
+
+### Display Format
+
+```
+Notes:
+
+Project (.planning/NOTES.md):
+  1. [2026-02-08 14:32] refactor the hook system to support async validators
+  2. [promoted] [2026-02-08 14:40] add rate limiting to the API endpoints
+  3. [2026-02-08 15:10] consider adding a --dry-run flag to build
+
+Global (~/.claude/notes.md):
+  4. [2026-02-08 10:00] cross-project idea about shared config
+
+{count} active note(s). Use `/pbr:note promote <N>` to convert to a todo.
+```
+
+If a scope has no file or no entries, show: `(no notes)`
+
+---
+
+## Subcommand: promote
+
+Convert a note into a todo file.
+
+### Steps
+
+1. Run the **list** logic to build the numbered index (both scopes)
+2. Find entry N from the numbered list
+3. If N is invalid or refers to an already-promoted note, tell the user and stop
+4. **Requires `.planning/` directory** — if it doesn't exist, warn: "Todos require a Plan-Build-Run project. Run `/pbr:begin` to initialize one, or use `/pbr:todo add` in an existing project."
+5. Ensure `.planning/todos/pending/` directory exists
+6. Generate todo ID: `{NNN}-{slug}` where NNN is the next sequential number (scan both `.planning/todos/pending/` and `.planning/todos/done/` for the highest existing number, increment by 1, zero-pad to 3 digits) and slug is the first ~4 meaningful words of the note text, lowercase, hyphen-separated
+7. Extract the note text (everything after the timestamp)
+8. Create `.planning/todos/pending/{id}.md`:
+
+```yaml
+---
+title: "{note text}"
+status: pending
+priority: P2
+source: "promoted from /pbr:note"
+created: {YYYY-MM-DD}
+theme: general
+---
+
+## Goal
+
+{note text}
+
+## Context
+
+Promoted from quick note captured on {original date}.
+
+## Acceptance Criteria
+
+- [ ] {primary criterion derived from note text}
+```
+
+9. Mark the original note as promoted: replace `- [` with `- [promoted] [` on that line
+10. Confirm: `Promoted note {N} to todo {id}: {note text}`
+
+---
+
+## NOTES.md Format Reference
+
+```markdown
+# Notes
+
+Quick captures from `/pbr:note`. Ideas worth remembering.
+
+---
+
+- [2026-02-08 14:32] refactor the hook system to support async validators
+- [promoted] [2026-02-08 14:40] add rate limiting to the API endpoints
+- [2026-02-08 15:10] consider adding a --dry-run flag to build
+```
+
+---
+
+## Edge Cases
+
+1. **"list" as note text**: `/pbr:note list of things` → saves note "list of things" (subcommand only when `list` is the entire arg)
+2. **No `.planning/`**: Falls back to global `~/.claude/notes.md` — works in any directory
+3. **Promote without project**: Warns that todos require `.planning/`, suggests `/pbr:begin`
+4. **Large files**: `list` shows last 10 when >20 active entries
+5. **Missing newline**: Always ensure trailing newline before appending
+6. **`--global` position**: Stripped from anywhere — `--global my idea` and `my idea --global` both save "my idea" globally
+7. **Promote already-promoted**: Tell user "Note {N} is already promoted" and stop
+8. **Empty note text after stripping flags**: Treat as `list` subcommand
+
+---
+
+## Error Handling
+
+### Write failure
+If the Write tool fails (permissions, disk full, etc.), display:
+```
+╔══════════════════════════════════════════════════════════════╗
+║  ERROR                                                       ║
+╚══════════════════════════════════════════════════════════════╝
+
+Failed to write note to {target_file}.
+
+**To fix:** Check file permissions or disk space.
+```
+
+### Promote target not found
+If the specified note index is invalid, display:
+```
+╔══════════════════════════════════════════════════════════════╗
+║  ERROR                                                       ║
+╚══════════════════════════════════════════════════════════════╝
+
+Note {N} not found. Valid range: 1-{max}.
+
+**To fix:** Run `/pbr:note list` to see available notes.
+```
+
+---
+
+## Anti-Patterns
+
+1. **DO NOT** ask questions on append — just write and confirm
+2. **DO NOT** modify note text — capture verbatim
+3. **DO NOT** use Task, AskUserQuestion, or Bash
+4. **DO NOT** create `.planning/` if it doesn't exist — fall back to global
+5. **DO NOT** number promoted notes in the active count (but still display them)
+6. **DO NOT** over-format the confirmation — one line is enough