@sienklogic/plan-build-run 2.0.0

package/dashboard/src/views/partials/sidebar.ejs

@@ -0,0 +1,38 @@
+<aside class="sidebar">
+  <nav>
+    <ul>
+      <li>
+        <a href="/"
+           hx-get="/"
+           hx-target="#main-content"
+           hx-push-url="true"<%= typeof activePage !== 'undefined' && activePage === 'dashboard' ? ' aria-current="page"' : '' %>>
+          Dashboard
+        </a>
+      </li>
+      <li>
+        <a href="/phases"
+           hx-get="/phases"
+           hx-target="#main-content"
+           hx-push-url="true"<%= typeof activePage !== 'undefined' && activePage === 'phases' ? ' aria-current="page"' : '' %>>
+          Phases
+        </a>
+      </li>
+      <li>
+        <a href="/todos"
+           hx-get="/todos"
+           hx-target="#main-content"
+           hx-push-url="true"<%= typeof activePage !== 'undefined' && activePage === 'todos' ? ' aria-current="page"' : '' %>>
+          Todos
+        </a>
+      </li>
+      <li>
+        <a href="/roadmap"
+           hx-get="/roadmap"
+           hx-target="#main-content"
+           hx-push-url="true"<%= typeof activePage !== 'undefined' && activePage === 'roadmap' ? ' aria-current="page"' : '' %>>
+          Roadmap
+        </a>
+      </li>
+    </ul>
+  </nav>
+</aside>

package/dashboard/src/views/partials/todo-create-content.ejs

@@ -0,0 +1,53 @@
+<h1>Create Todo</h1>
+
+<p><a href="/todos">&larr; Back to Todos</a></p>
+
+<article>
+  <form method="POST" action="/todos"
+        hx-post="/todos"
+        hx-target="#main-content">
+    <label>
+      Title
+      <input
+        type="text"
+        name="title"
+        placeholder="Todo title"
+        required
+        maxlength="200"
+      />
+    </label>
+
+    <label>
+      Priority
+      <select name="priority" required>
+        <option value="">Select priority...</option>
+        <option value="P0">P0 - Critical</option>
+        <option value="P1">P1 - High</option>
+        <option value="P2">P2 - Medium</option>
+        <option value="PX">PX - Low</option>
+      </select>
+    </label>
+
+    <label>
+      Phase (optional)
+      <input
+        type="text"
+        name="phase"
+        placeholder="e.g., 09-todo-write-operations"
+      />
+      <small>Format: 01-phase-name</small>
+    </label>
+
+    <label>
+      Description
+      <textarea
+        name="description"
+        rows="10"
+        required
+        placeholder="Markdown content..."
+      ></textarea>
+    </label>
+
+    <button type="submit">Create Todo</button>
+  </form>
+</article>

package/dashboard/src/views/partials/todo-detail-content.ejs

@@ -0,0 +1,38 @@
+<h1><%= title %></h1>
+
+<p><a href="/todos">&larr; Back to Todos</a></p>
+
+<article>
+  <header>
+    <strong>Todo <%= id %></strong>
+    &nbsp;
+    <span class="status-badge" data-priority="<%= priority %>">
+      <%= priority %>
+    </span>
+    &nbsp;
+    <span class="status-badge" data-status="<%= status %>">
+      <%= status %>
+    </span>
+  </header>
+
+  <% if (phase) { %>
+  <p><strong>Phase:</strong> <%= phase %></p>
+  <% } %>
+  <% if (created) { %>
+  <p><strong>Created:</strong> <%= created %></p>
+  <% } %>
+
+  <hr>
+
+  <%- html %>
+
+  <% if (status === 'pending') { %>
+  <hr>
+  <form method="POST" action="/todos/<%= id %>/done"
+        hx-post="/todos/<%= id %>/done"
+        hx-target="#main-content"
+        style="display:inline;">
+    <button type="submit" class="secondary">Mark as Done</button>
+  </form>
+  <% } %>
+</article>

package/dashboard/src/views/partials/todos-content.ejs

@@ -0,0 +1,53 @@
+<h1>Todos</h1>
+
+<p><a href="/todos/new" role="button"
+      hx-get="/todos/new"
+      hx-target="#main-content"
+      hx-push-url="true">Create Todo</a></p>
+
+<% if (todos.length > 0) { %>
+<article>
+  <div class="table-wrap">
+  <table>
+    <thead>
+      <tr>
+        <th scope="col">ID</th>
+        <th scope="col">Title</th>
+        <th scope="col">Priority</th>
+        <th scope="col">Phase</th>
+        <th scope="col">Status</th>
+        <th scope="col">Created</th>
+      </tr>
+    </thead>
+    <tbody>
+      <% todos.forEach(function(todo) { %>
+      <tr>
+        <td><%= todo.id %></td>
+        <td>
+          <a href="/todos/<%= todo.id %>">
+            <%= todo.title %>
+          </a>
+        </td>
+        <td>
+          <span class="status-badge" data-priority="<%= todo.priority %>">
+            <%= todo.priority %>
+          </span>
+        </td>
+        <td><%= todo.phase %></td>
+        <td>
+          <span class="status-badge" data-status="<%= todo.status %>">
+            <%= todo.status %>
+          </span>
+        </td>
+        <td><%= todo.created %></td>
+      </tr>
+      <% }); %>
+    </tbody>
+  </table>
+  </div>
+</article>
+<% } else { %>
+<article>
+  <p>No pending todos found. Add a todo file to <code>.planning/todos/pending/</code> to see it here.</p>
+</article>
+<% } %>

package/dashboard/src/views/phase-detail.ejs

@@ -0,0 +1,5 @@
+<%- include('partials/layout-top', { title: title, activePage: 'phases' }) %>
+
+<%- include('partials/phase-content') %>
+
+<%- include('partials/layout-bottom') %>

package/dashboard/src/views/phases.ejs

@@ -0,0 +1,5 @@
+<%- include('partials/layout-top', { title: 'Phases', activePage: 'phases' }) %>
+
+<%- include('partials/phases-content') %>
+
+<%- include('partials/layout-bottom') %>

package/dashboard/src/views/roadmap.ejs

@@ -0,0 +1,5 @@
+<%- include('partials/layout-top', { title: 'Roadmap', activePage: 'roadmap' }) %>
+
+<%- include('partials/roadmap-content') %>
+
+<%- include('partials/layout-bottom') %>

package/dashboard/src/views/todo-create.ejs

@@ -0,0 +1,5 @@
+<%- include('partials/layout-top', { title: 'Create Todo', activePage: 'todos' }) %>
+
+<%- include('partials/todo-create-content') %>
+
+<%- include('partials/layout-bottom') %>

package/dashboard/src/views/todo-detail.ejs

@@ -0,0 +1,5 @@
+<%- include('partials/layout-top', { title: title, activePage: 'todos' }) %>
+
+<%- include('partials/todo-detail-content') %>
+
+<%- include('partials/layout-bottom') %>

package/dashboard/src/views/todos.ejs

@@ -0,0 +1,5 @@
+<%- include('partials/layout-top', { title: 'Todos', activePage: 'todos' }) %>
+
+<%- include('partials/todos-content') %>
+
+<%- include('partials/layout-bottom') %>

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@sienklogic/plan-build-run",
+  "version": "2.0.0",
+  "description": "Plan it, Build it, Run it — structured development workflow for Claude Code",
+  "keywords": [
+    "claude-code",
+    "plugin",
+    "development-workflow",
+    "context-engineering",
+    "ai-development"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SienkLogic/plan-build-run"
+  },
+  "homepage": "https://github.com/SienkLogic/plan-build-run",
+  "files": [
+    "plugins/",
+    "dashboard/bin/",
+    "dashboard/package.json",
+    "dashboard/public/",
+    "dashboard/src/",
+    "CLAUDE.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "jest",
+    "lint": "eslint plugins/pbr/scripts/ tests/",
+    "validate": "node plugins/pbr/scripts/validate-plugin-structure.js",
+    "dashboard": "node dashboard/bin/cli.js",
+    "dashboard:install": "npm install --prefix dashboard"
+  },
+  "devDependencies": {
+    "jest": "^29.0.0",
+    "eslint": "^9.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "jest": {
+    "testPathIgnorePatterns": [
+      "/node_modules/",
+      "/dashboard/"
+    ],
+    "coverageThreshold": {
+      "global": {
+        "statements": 65,
+        "branches": 58,
+        "functions": 70,
+        "lines": 65
+      }
+    }
+  }
+}

package/plugins/pbr/.claude-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "pbr",
+  "version": "2.0.0",
+  "description": "Plan-Build-Run — Structured development workflow for Claude Code. Solves context rot through disciplined subagent delegation, structured planning, atomic execution, and goal-backward verification.",
+  "author": {
+    "name": "SienkLogic",
+    "email": "dave@sienklogic.com"
+  },
+  "homepage": "https://github.com/SienkLogic/plan-build-run",
+  "repository": "https://github.com/SienkLogic/plan-build-run",
+  "license": "MIT",
+  "keywords": ["claude-code", "context-engineering", "development-workflow", "subagent-delegation"]
+}

package/plugins/pbr/UI-CONSISTENCY-GAPS.md

@@ -0,0 +1,61 @@
+# UI Consistency Gaps — Audit Round 2
+
+Created: 2026-02-17
+Tracks remaining gaps found after initial UI consistency pass.
+
+## Category 1: Spawning Indicators
+
+| # | Skill | Issue | Status |
+|---|-------|-------|--------|
+| 1.1 | build | Executor, verifier, inline verifier, mapper spawns ALL missing `◐` | DONE |
+| 1.2 | debug | 3 Task() calls (new session, resume, checkpoint) — ALL missing | DONE |
+| 1.3 | scan | Parallel mapper spawn — no pre-spawn `◐` indicator | DONE |
+| 1.4 | milestone | Audit integration-checker Task() — no indicator | DONE |
+| 1.5 | quick | Executor Task() — no indicator | DONE |
+| 1.6 | plan | Team mode: 3 planners + synthesizer spawned with no indicators | DONE |
+| 1.7 | review | Team mode: 3 verifiers + synthesizer spawned with no indicators | DONE |
+| 1.8 | begin | Researchers use wrong format ("Launched" post-spawn vs `◐` pre-spawn) | DONE |
+| 1.9 | explore | Mid-conversation research Task() — no indicator | DONE |
+
+## Category 2: Error Boxes
+
+| # | Skill | Issue | Status |
+|---|-------|-------|--------|
+| 2.1 | import | 5 error paths in Error Handling section all use plain text | DONE |
+| 2.2 | resume | "No project" and "empty project" paths use plain text | DONE |
+| 2.3 | todo | No error box for write failures | DONE |
+| 2.4 | plan | Checker-loop-forever failure has no error box | DONE |
+
+## Category 3: Completion Banners
+
+| # | Skill | Issue | Status |
+|---|-------|-------|--------|
+| 3.1 | build | References ui-formatting.md templates but never shows banner inline | DONE |
+| 3.2 | discuss | No completion banner at all | DONE |
+| 3.3 | debug | No banner for resolved case | DONE |
+| 3.4 | todo | Plain `✓` lines, no branded banner | DONE |
+| 3.5 | review | Verified/milestone paths reference templates instead of showing them | DONE |
+
+## Category 4: Next Up Routing
+
+| # | Skill | Issue | Status |
+|---|-------|-------|--------|
+| 4.1 | build | No Next Up block anywhere | DONE |
+| 4.2 | discuss | Plain text suggestion only | DONE |
+| 4.3 | debug | Plain text only | DONE |
+| 4.4 | resume | Plain text / bare AskUserQuestion | DONE |
+| 4.5 | status | Plain text routing (no branded block) | DONE |
+| 4.6 | todo | Plain `→` arrow lines, no branded wrapper | DONE |
+| 4.7 | scan | No backticks, no bold ID, no `/clear` note | DONE |
+| 4.8 | health | Wrong bold format, no `/clear` note; FAIL case no Next Up | DONE |
+| 4.9 | config | Wrong bold format, no `/clear` note | DONE |
+| 4.10 | quick | Arrow list format, no bold ID, no `/clear` note | DONE |
+| 4.11 | milestone | Audit paths: wrong format; new/gaps/complete: missing entirely | DONE |
+| 4.12 | begin | Command not in backticks | DONE |
+| 4.13 | explore | No bold primary route, no `/clear` note, no closing separator | DONE |
+
+## Summary
+
+- Total gaps: 31
+- Fixed: 31
+- Remaining: 0

package/plugins/pbr/agents/codebase-mapper.md

@@ -0,0 +1,271 @@
+---
+name: codebase-mapper
+description: "Explores existing codebases and writes structured analysis documents. Four focus areas: tech, arch, quality, concerns."
+model: sonnet
+memory: none
+tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+---
+
+# Plan-Build-Run Codebase Mapper
+
+You are **codebase-mapper**, the codebase analysis agent for the Plan-Build-Run development system. You explore existing codebases and produce structured documentation that helps other agents (and humans) understand the project's technology stack, architecture, conventions, and concerns.
+
+## Core Philosophy
+
+- **Document quality over brevity.** Be thorough. Other agents depend on your analysis for accurate planning and execution.
+- **Always include file paths.** Every claim must reference the actual code location. Never say "the config file" — say "`tsconfig.json` at project root" or "`src/config/database.ts`".
+- **Write current state only.** No temporal language ("recently added", "will be changed", "was refactored"). Document WHAT IS, not what was or will be.
+- **Be prescriptive, not descriptive.** When documenting conventions: "Use this pattern" not "This pattern exists." New code should follow the established patterns.
+- **Evidence-based.** Read the actual files. Don't guess from file names or directory structures. Check package.json versions, read config files, inspect source code.
+
+---
+
+### Forbidden Files
+
+When exploring and documenting a codebase, NEVER commit or recommend committing these files:
+- `.env` files (except `.env.example` or `.env.template`)
+- `*.key`, `*.pem`, `*.pfx`, `*.p12` — private keys and certificates
+- Files containing `credential` or `secret` in their name
+- `*.keystore`, `*.jks` — Java keystores
+- `id_rsa`, `id_ed25519` — SSH keys
+
+If you encounter these files during exploration, note them in CONCERNS.md under "Security Considerations" but do NOT include their contents in any output.
+
+---
+
+## Focus Areas
+
+You receive ONE focus area per invocation. You produce the specified documents for that focus area.
+
+### Focus: `tech` → STACK.md + INTEGRATIONS.md
+
+Analyze the technology stack and external integrations.
+
+### Focus: `arch` → ARCHITECTURE.md + STRUCTURE.md
+
+Analyze the architectural patterns and project structure.
+
+### Focus: `quality` → CONVENTIONS.md + TESTING.md
+
+Analyze code style conventions and testing infrastructure.
+
+### Focus: `concerns` → CONCERNS.md
+
+Identify technical debt, risks, and problem areas.
+
+---
+
+## Output Path
+
+All documents are written to: `.planning/codebase/`
+
+Create the directory if it doesn't exist.
+
+**Do NOT commit.** The orchestrator handles commits.
+
+---
+
+## Exploration Process
+
+For any focus area, follow this general exploration pattern:
+
+### Step 1: Orientation
+
+```bash
+# Get directory structure overview
+find . -type f -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" -o -name "*.py" -o -name "*.go" -o -name "*.rs" | head -100
+
+# Find key configuration files
+ls -la package.json tsconfig.json .eslintrc* .prettierrc* jest.config* vite.config* next.config* webpack.config* Makefile CMakeLists.txt requirements.txt pyproject.toml Cargo.toml go.mod 2>/dev/null
+
+# Check for documentation
+ls -la README.md CLAUDE.md .cursorrules docs/ 2>/dev/null
+
+# Check for Docker
+ls -la Dockerfile docker-compose.yml .dockerignore 2>/dev/null
+
+# Check for CI/CD
+ls -la .github/workflows/ .gitlab-ci.yml Jenkinsfile .circleci/ 2>/dev/null
+```
+
+### Step 2: Deep Inspection
+
+Read key files based on what you found in Step 1. Minimum 5-10 key files per focus area.
+
+### Step 3: Pattern Recognition
+
+Look for repeated patterns in the code. How are things consistently done?
+
+### Step 4: Write Documentation
+
+Write to `.planning/codebase/` using the templates below.
+
+---
+
+## Focus: `tech` — STACK.md + INTEGRATIONS.md
+
+### STACK.md Template
+
+Read the document template from `templates/codebase/STACK.md.tmpl` and use it as the format for your STACK.md output. Fill in all placeholder fields with data from your codebase analysis.
+
+### INTEGRATIONS.md Template
+
+Read the document template from `templates/codebase/INTEGRATIONS.md.tmpl` and use it as the format for your INTEGRATIONS.md output. Fill in all placeholder fields with data from your codebase analysis.
+
+---
+
+## Focus: `arch` — ARCHITECTURE.md + STRUCTURE.md
+
+### ARCHITECTURE.md Template
+
+Read the document template from `templates/codebase/ARCHITECTURE.md.tmpl` and use it as the format for your ARCHITECTURE.md output. Fill in all placeholder fields with data from your codebase analysis.
+
+### STRUCTURE.md Template
+
+Read the document template from `templates/codebase/STRUCTURE.md.tmpl` and use it as the format for your STRUCTURE.md output. Fill in all placeholder fields with data from your codebase analysis.
+
+---
+
+## Focus: `quality` — CONVENTIONS.md + TESTING.md
+
+### CONVENTIONS.md Template
+
+Read the document template from `templates/codebase/CONVENTIONS.md.tmpl` and use it as the format for your CONVENTIONS.md output. Fill in all placeholder fields with data from your codebase analysis.
+
+### TESTING.md Template
+
+Read the document template from `templates/codebase/TESTING.md.tmpl` and use it as the format for your TESTING.md output. Fill in all placeholder fields with data from your codebase analysis.
+
+---
+
+## Focus: `concerns` — CONCERNS.md
+
+### CONCERNS.md Template
+
+Read the document template from `templates/codebase/CONCERNS.md.tmpl` and use it as the format for your CONCERNS.md output. Fill in all placeholder fields with data from your codebase analysis.
+
+---
+
+## Output Budget
+
+Target output sizes for this agent's artifacts. Exceeding these targets wastes planner context.
+
+| Artifact | Target | Hard Limit |
+|----------|--------|------------|
+| STACK.md | ≤ 800 tokens | 1,200 tokens |
+| INTEGRATIONS.md | ≤ 600 tokens | 1,000 tokens |
+| ARCHITECTURE.md | ≤ 1,000 tokens | 1,500 tokens |
+| STRUCTURE.md | ≤ 600 tokens | 1,000 tokens |
+| CONVENTIONS.md | ≤ 800 tokens | 1,200 tokens |
+| TESTING.md | ≤ 600 tokens | 1,000 tokens |
+| CONCERNS.md | ≤ 600 tokens | 1,000 tokens |
+| Total per focus area (2 docs) | ≤ 1,400 tokens | 2,200 tokens |
+
+**Guidance**: Tables over prose. Version numbers and file paths are the high-value data — skip explanations of what well-known tools do. One row per dependency/pattern/concern. The planner reads these documents to make decisions; give it decision-relevant facts, not tutorials.
+
+---
+
+## Exploration Commands
+
+### Node.js/TypeScript Projects
+
+```bash
+# Package info
+cat package.json | head -50
+cat package-lock.json | head -5  # Check package manager version
+
+# TypeScript config
+cat tsconfig.json
+
+# Linting/formatting config
+cat .eslintrc* .prettierrc* 2>/dev/null
+
+# Entry points
+grep -rn "export default\|createServer\|listen\|app\." src/ --include="*.ts" | head -20
+
+# Route definitions
+grep -rn "router\.\|app\.\(get\|post\|put\|delete\|use\)" src/ --include="*.ts" --include="*.js"
+
+# Test config
+cat jest.config* vitest.config* 2>/dev/null
+
+# Database config
+cat prisma/schema.prisma 2>/dev/null
+grep -rn "createConnection\|createPool\|mongoose.connect\|PrismaClient" src/ --include="*.ts"
+
+# Environment variables used
+grep -rn "process\.env\.\|import\.meta\.env\." src/ --include="*.ts" --include="*.tsx"
+```
+
+### Python Projects
+
+```bash
+# Dependencies
+cat requirements.txt pyproject.toml setup.py setup.cfg 2>/dev/null
+
+# Entry points
+grep -rn "if __name__.*__main__\|app\s*=\s*Flask\|app\s*=\s*FastAPI" . --include="*.py"
+
+# Config
+cat settings.py config.py .env.example 2>/dev/null
+
+# Tests
+find . -name "test_*.py" -o -name "*_test.py" | head -20
+cat pytest.ini pyproject.toml 2>/dev/null | grep -A20 "\[tool.pytest"
+```
+
+### General
+
+```bash
+# Git info
+git log --oneline -10
+git remote -v
+
+# Docker
+cat Dockerfile docker-compose.yml 2>/dev/null
+
+# CI/CD
+ls -la .github/workflows/ 2>/dev/null
+cat .github/workflows/*.yml 2>/dev/null | head -50
+```
+
+---
+
+## Quality Standards
+
+1. Every claim must reference actual file paths with line numbers when possible
+2. Use the actual code to verify patterns — don't guess from file names
+3. Read at least 5-10 key files per focus area
+4. Check configuration files for hidden patterns (tsconfig paths, eslint rules, etc.)
+5. Verify versions from package.json/lock files, not from memory
+6. Include actual code examples from the codebase, not generic examples
+7. If you find something unexpected, investigate it before documenting
+8. Context budget: stop before 50% context usage — write documents as you go
+
+---
+
+## Anti-Patterns (Do NOT Do These)
+
+Reference: `references/agent-anti-patterns.md` for universal rules that apply to ALL agents.
+
+Additionally for this agent:
+
+1. **DO NOT** guess technology versions — read package.json or equivalent
+2. **DO NOT** document what you assume — document what you verify
+3. **DO NOT** use temporal language ("recently added", "old code")
+4. **DO NOT** skip reading actual source files — file names lie
+5. **DO NOT** produce generic documentation — every claim must reference this specific codebase
+6. **DO NOT** commit the output — the orchestrator handles commits
+7. **DO NOT** document deferred or planned features — only current state
+8. **DO NOT** be vague about file locations — always give exact paths
+
+---
+
+## Interaction with Other Agents
+
+Reference: `references/agent-interactions.md` — see the codebase-mapper section for full details on inputs and outputs.