@sienklogic/plan-build-run 2.21.0 → 2.21.2

package/plugins/cursor-pbr/templates/RESEARCH-SUMMARY.md.tmpl

@@ -1,98 +0,0 @@
-<!-- canonical: ../../pbr/templates/RESEARCH-SUMMARY.md.tmpl -->
-# Research Summary
-
-> Synthesized: {date}
-> Input documents: {count}
-> Sources: {list of document names/paths}
-
-## Executive Summary
-
-{3-5 sentences maximum. What was researched, the single most important conclusion, and the recommended approach. This paragraph should give a planner enough context to start planning without reading further.}
-
-## Recommended Stack
-
-{Only include if project-level synthesis. For phase-level, skip this section.}
-
-| Layer | Choice | Version | Confidence | Alternatives | Source |
-|-------|--------|---------|------------|-------------|--------|
-| Runtime | {Node.js} | {20.x} | HIGH | {Bun, Deno} | {Doc A, Doc B} |
-| Framework | {Next.js} | {14.x} | HIGH | {Remix, Astro} | {Doc A} |
-| Database | {PostgreSQL} | {16.x} | HIGH | {MySQL} | {Doc A, Doc C} |
-| ORM | {Prisma} | {5.x} | MEDIUM | {Drizzle, TypeORM} | {Doc B} |
-| Auth | {NextAuth.js} | {5.x} | MEDIUM | {Clerk, Auth0} | {Doc A} |
-| Hosting | {Vercel} | - | MEDIUM | {AWS, Railway} | {Doc C} |
-| Testing | {Vitest} | {1.x} | HIGH | {Jest} | {Doc B} |
-
-### Stack Rationale
-
-{Brief explanation of why this combination. 2-3 sentences.}
-
-## Architecture Recommendations
-
-{Key architectural decisions informed by research. Use bullet points.}
-
-- **Pattern**: {Recommended pattern with rationale}
-- **Data flow**: {How data should move through the system}
-- **Separation**: {How to organize the code}
-- **State**: {How to manage state}
-
-## Key Patterns
-
-{Patterns to follow during implementation.}
-
-| Pattern | When to Use | Example |
-|---------|------------|---------|
-| {Repository} | {Database access} | {Brief code hint} |
-| {Middleware} | {Auth, logging, validation} | {Brief code hint} |
-| {DTO validation} | {API input/output} | {Zod schemas} |
-
-## Pitfalls & Warnings
-
-{Ranked by severity. These are the things most likely to cause problems.}
-
-| # | Pitfall | Severity | Source | Mitigation |
-|---|---------|----------|--------|------------|
-| 1 | {Most critical pitfall} | CRITICAL | {Doc A} | {How to avoid} |
-| 2 | {Second pitfall} | HIGH | {Doc B, Doc C} | {How to avoid} |
-| 3 | {Third pitfall} | MEDIUM | {Doc A} | {How to avoid} |
-
-## Contradictions Resolved
-
-{Where input documents disagreed and how it was resolved.}
-
-| Topic | Position A | Position B | Resolution | Basis |
-|-------|-----------|-----------|------------|-------|
-| {Database} | PostgreSQL (Doc A, C) | MongoDB (Doc B) | PostgreSQL | Majority + S2 source |
-| {Auth} | JWT (Doc A, B) | Sessions (Doc C) | JWT | Majority + better for API |
-
-{If any contradictions could not be resolved:}
-
-### Unresolved: {Topic}
-
-**Options**: {A} vs {B}
-**Trade-offs**: {A is better for X, B is better for Y}
-**Recommendation**: {best guess} `[NEEDS DECISION]`
-
-## Open Questions
-
-{Things that none of the research documents could definitively answer.}
-
-1. {Question} -- Impact: {what planning/implementation is blocked by this}
-2. {Question} -- Impact: {what planning/implementation is blocked by this}
-
-## Additional Notes
-
-{P3 (Nice to Know) items. Brief bullet points only.}
-
-- {Performance tip from Doc A}
-- {Future consideration from Doc C}
-- {Alternative approach worth noting from Doc B}
-
-## Sources
-
-{Consolidated source list from all input documents.}
-
-| # | Document | Key Contribution | Confidence |
-|---|----------|-----------------|------------|
-| 1 | {path/name} | {what it contributed} | {overall confidence} |
-| 2 | {path/name} | {what it contributed} | {overall confidence} |

package/plugins/cursor-pbr/templates/ROADMAP.md.tmpl

@@ -1,41 +0,0 @@
-<!-- canonical: ../../pbr/templates/ROADMAP.md.tmpl -->
-# Project Roadmap
-
-> Generated: {date}
-> Total phases: {n}
-> Estimated plans: {n}
-
-## Phase Overview
-
-| Phase | Name | Goal | Plans | Wave | Status |
-|-------|------|------|-------|------|--------|
-| 01 | Project Setup | Development environment ready | 2 | 1 | pending |
-| 02 | Authentication | Users can sign in | 3 | 1 | pending |
-| 03 | Core Models | Data layer complete | 4 | 2 | pending |
-| ... | ... | ... | ... | ... | ... |
-
-## Dependency Graph
-
-```
-Phase 01 ──→ Phase 02 ──→ Phase 04
-         └──→ Phase 03 ──→ Phase 05
-                       └──→ Phase 04
-```
-
-## Phase Details
-
-### Phase 01: Project Setup
-
-**Goal**: {goal statement}
-**Must-Haves**:
-- {truth 1}
-- {truth 2}
-
-**Planned Plans**:
-1. {plan name} (Wave 1, autonomous)
-2. {plan name} (Wave 1, autonomous)
-
-**Dependencies**: None (starting phase)
-
-### Phase 02: Authentication
-...

package/plugins/cursor-pbr/templates/SUMMARY.md.tmpl

@@ -1,82 +0,0 @@
-<!-- canonical: ../../pbr/templates/SUMMARY.md.tmpl -->
-# SUMMARY.md Template
-
-> Referenced by: executor agent, build skill, review skill
-> Do not edit this template during execution — copy the structure into your output.
-
-## Frontmatter (YAML)
-
-```yaml
----
-phase: "{phase_id}"
-plan: "{plan_id}"
-status: "complete"           # complete | partial | checkpoint
-subsystem: "{main subsystem affected}"
-tags:
-  - "{tag1}"
-  - "{tag2}"
-requires:                    # What this plan needs from other plans
-  - "{plan_id}: {artifact}"
-provides:                    # What this plan produces for other plans
-  - "{export/artifact description}"
-affects:
-  - "{affected area 1}"
-  - "{affected area 2}"
-tech_stack:
-  - "{technology used}"
-key_files:
-  - "{file1}: {what it does}"
-  - "{file2}: {what it does}"
-key_decisions:
-  - "{decision 1}: {rationale}"
-patterns:
-  - "{pattern used}: {where}"
-metrics:
-  duration_minutes: {n}
-  tasks_completed: {n}
-  tasks_total: {n}
-  commits: {n}
-  files_created: {n}
-  files_modified: {n}
-deferred:
-  - "{thing noticed but not implemented}"
-self_check_failures:         # Only present if self-check found issues
-  - "{failure description}"
----
-```
-
-## Body Structure
-
-```markdown
-# Plan Summary: {plan_id}
-
-## What Was Built
-
-{2-3 paragraph description of what was accomplished}
-
-## Task Results
-
-| Task | Status | Commit | Files | Verify |
-|------|--------|--------|-------|--------|
-| {task_id}: {name} | done | {hash} | {count} | passed |
-
-## Key Implementation Details
-
-{Important details about HOW things were implemented that future plans need to know}
-
-## Known Issues
-
-{Any issues discovered during execution that weren't blockers but should be tracked}
-
-## Dependencies Provided
-
-{What other plans can now depend on — exports, files, APIs created}
-```
-
-## Status Values
-
-| Status | Meaning |
-|--------|---------|
-| `complete` | All tasks completed successfully |
-| `partial` | Some tasks completed, execution stopped |
-| `checkpoint` | Execution paused at a checkpoint task, waiting for human |

package/plugins/cursor-pbr/templates/VERIFICATION-DETAIL.md.tmpl

@@ -1,117 +0,0 @@
-<!-- canonical: ../../pbr/templates/VERIFICATION-DETAIL.md.tmpl -->
-<!-- Source: agents/verifier.md | Purpose: Detailed output format for verification reports produced by the verifier agent -->
-
-```yaml
----
-phase: "{phase_id}"
-verified: "{ISO timestamp}"
-status: "passed"           # passed | gaps_found | human_needed
-is_re_verification: false  # true if re-verifying after gap closure
-score:
-  total_must_haves: {n}
-  verified: {n}
-  failed: {n}
-  partial: {n}
-  human_needed: {n}
-gaps:
-  - must_have: "{description of the failed must-have}"
-    level: "{existence | substantive | wired}"
-    evidence: "{what you found}"
-    recommendation: "{specific action to fix}"
-anti_patterns:
-  todos: {count}
-  stubs: {count}
-  console_logs: {count}
-  skipped_tests: {count}
-  hardcoded_secrets: {count}
----
-
-# Phase Verification: {phase_name}
-
-> Verified: {date}
-> Status: **{STATUS}**
-> Score: {verified}/{total} must-haves verified
-> Re-verification: {yes/no}
-
-## Observable Truths
-
-| # | Truth | Status | Evidence |
-|---|-------|--------|----------|
-| 1 | {truth statement} | VERIFIED | {evidence summary with file paths and line numbers} |
-| 2 | {truth statement} | FAILED | {what's wrong, what was expected, what was found} |
-| 3 | {truth statement} | HUMAN_NEEDED | {why it can't be verified programmatically} |
-
-## Artifact Verification
-
-| # | Artifact | L1: Exists | L2: Substantive | L3: Wired | Status |
-|---|----------|-----------|-----------------|-----------|--------|
-| 1 | `{file/export}` | YES | YES (142 lines, real logic) | WIRED (imported by 3 files) | PASS |
-| 2 | `{file/export}` | YES | STUB (TODO at L42, empty handler L67) | N/A | FAIL |
-| 3 | `{file/export}` | YES | YES | ORPHANED (not imported anywhere) | FAIL |
-| 4 | `{file/export}` | NO | N/A | N/A | FAIL |
-
-## Key Link Verification
-
-| # | Link Description | Source | Target | Status | Evidence |
-|---|-----------------|--------|--------|--------|----------|
-| 1 | {what connects to what} | `{source_file}` | `{target_file}` | WIRED | Import at L12, called at L45 |
-| 2 | {what connects to what} | `{source_file}` | `{target_file}` | BROKEN | Imported but never called |
-
-## Gaps Found
-
-{Only present if status is gaps_found}
-
-### Gap 1: {Short description}
-
-- **Must-Have**: {which must-have this gap blocks}
-- **Level Failed**: {existence / substantive / wired}
-- **Evidence**: {specific evidence — file paths, line numbers, command output}
-- **Impact**: {what doesn't work because of this gap}
-- **Recommendation**: {specific action to close this gap}
-
-### Gap 2: {Short description}
-...
-
-## Human Verification Items
-
-{Only present if there are items requiring human verification}
-
-### Item 1: {What needs checking}
-
-- **Must-Have**: {which must-have this relates to}
-- **Why Manual**: {why it can't be verified automatically}
-- **How to Test**: {step-by-step instructions}
-- **Expected Result**: {what success looks like}
-
-## Anti-Pattern Scan
-
-| Pattern | Count | Severity | Files |
-|---------|-------|----------|-------|
-| TODO/FIXME comments | {n} | {low/medium/high} | {file list} |
-| Stub implementations | {n} | {high} | {file list} |
-| Console.log in production | {n} | {low} | {file list} |
-| Skipped tests | {n} | {medium} | {file list} |
-| Hardcoded secrets | {n} | {critical} | {file list} |
-| Empty catch blocks | {n} | {medium} | {file list} |
-
-## Regressions
-
-{Only present in re-verification mode}
-
-| # | Must-Have | Previous Status | Current Status | Evidence |
-|---|----------|----------------|----------------|----------|
-| 1 | {must-have} | VERIFIED | FAILED | {what changed} |
-
-## Summary
-
-### Phase Health
-- **Must-haves**: {n}/{total} verified ({percentage}%)
-- **Gaps**: {n} blocking, {n} non-blocking
-- **Anti-patterns**: {n} total ({n} critical)
-- **Human items**: {n} pending
-
-### Recommendations
-1. {Most important action to take}
-2. {Second most important}
-3. ...
-```

package/plugins/cursor-pbr/templates/codebase/ARCHITECTURE.md.tmpl

@@ -1,98 +0,0 @@
-<!-- Source: agents/codebase-mapper.md | Purpose: Output format for ARCHITECTURE.md codebase analysis -->
-# Architecture
-
-> Analyzed: {date}
-> Pattern: {MVC / Layered / Hexagonal / Microservices / Monolith / etc.}
-
-## Pattern Overview
-
-{2-3 paragraphs describing the overall architectural pattern with evidence from the codebase}
-
-**Evidence**: {file paths, import patterns, directory structure that support this classification}
-
-## Layers
-
-| Layer | Purpose | Directory | Key Files |
-|-------|---------|-----------|-----------|
-| {Presentation} | {UI rendering} | {src/components/} | {App.tsx, Layout.tsx} |
-| {API/Routes} | {HTTP handling} | {src/routes/ or src/app/api/} | {users.ts, auth.ts} |
-| {Business Logic} | {Core domain} | {src/services/} | {UserService.ts} |
-| {Data Access} | {Database interaction} | {src/repositories/ or src/db/} | {UserRepo.ts} |
-| {Infrastructure} | {External services} | {src/lib/ or src/integrations/} | {email.ts, storage.ts} |
-
-### Layer Rules
-
-{How layers communicate — what imports what? What are the dependency rules?}
-
-```
-Presentation → API → Business → Data Access → Database
-                ↓
-            Infrastructure
-```
-
-## Data Flow
-
-### Request Lifecycle
-
-{How a typical request flows through the system}
-
-```
-1. Client sends request
-2. → {Router/Framework} routes to handler
-3. → {Middleware} runs (auth, validation, logging)
-4. → {Controller/Handler} processes request
-5. → {Service} executes business logic
-6. → {Repository/Model} queries database
-7. → Response returns through the stack
-```
-
-### State Management
-
-| Context | Approach | Implementation | Files |
-|---------|----------|---------------|-------|
-| Client state | {Redux / Zustand / Context / etc.} | {how it's structured} | {store files} |
-| Server state | {React Query / SWR / etc.} | {how it's used} | {hook files} |
-| Session state | {JWT / cookies / etc.} | {how it's managed} | {auth files} |
-
-## Key Abstractions
-
-| Abstraction | Purpose | Implementation | Used By |
-|-------------|---------|---------------|---------|
-| {Repository} | {Database access} | {Abstract class + implementations} | {Services} |
-| {Middleware} | {Cross-cutting concerns} | {Function signature} | {Routes} |
-| {DTO/Schema} | {Data validation} | {Zod schemas / class-validator} | {Routes, Services} |
-
-## Entry Points
-
-| Type | File | Config | Notes |
-|------|------|--------|-------|
-| Web app | {src/app/page.tsx} | {port 3000} | {Next.js App Router} |
-| API server | {src/server.ts} | {port 8080} | {Express server} |
-| CLI | {src/cli.ts} | - | {Commander.js} |
-| Workers | {src/workers/} | {queue config} | {Bull/BullMQ} |
-| Cron | {src/cron/} | {schedule} | {node-cron} |
-
-## Error Handling Strategy
-
-| Layer | Pattern | Implementation |
-|-------|---------|---------------|
-| API | {Error middleware + HTTP status codes} | {src/middleware/error.ts} |
-| Service | {Custom error classes} | {src/errors/} |
-| Client | {Error boundaries + toast notifications} | {src/components/ErrorBoundary.tsx} |
-
-### Error Flow
-
-```
-Service throws AppError → Controller catches → Error middleware formats response → Client displays
-```
-
-## Security Architecture
-
-| Aspect | Implementation | Files |
-|--------|---------------|-------|
-| Authentication | {how auth works} | {files} |
-| Authorization | {RBAC / ABAC / etc.} | {files} |
-| Input validation | {where and how} | {files} |
-| CORS | {configuration} | {files} |
-| Rate limiting | {if present} | {files} |
-| CSRF protection | {if present} | {files} |

package/plugins/cursor-pbr/templates/codebase/CONCERNS.md.tmpl

@@ -1,93 +0,0 @@
-<!-- Source: agents/codebase-mapper.md | Purpose: Output format for CONCERNS.md codebase analysis -->
-# Concerns & Technical Debt
-
-> Analyzed: {date}
-> Severity summary: {n critical, n high, n medium, n low}
-
-## Technical Debt
-
-| # | Area | Issue | Severity | Files | Evidence |
-|---|------|-------|----------|-------|----------|
-| 1 | {area} | {what's wrong} | critical/high/medium/low | {file paths} | {what you saw} |
-| 2 | {area} | {what's wrong} | {severity} | {file paths} | {what you saw} |
-
-### Debt Details
-
-#### TD-1: {Issue Title}
-
-**Severity**: {critical / high / medium / low}
-**Files**: {list of affected files}
-**Description**: {detailed description of the issue}
-**Evidence**: {specific code examples, line numbers}
-**Impact**: {what problems this causes or could cause}
-**Recommendation**: {specific action to fix}
-
-## Known Bugs
-
-| # | Description | Severity | Location | Reproduction |
-|---|-------------|----------|----------|--------------|
-| 1 | {bug description} | {severity} | {file:line} | {how to trigger} |
-
-## Security Considerations
-
-| # | Issue | Severity | Location | Recommendation |
-|---|-------|----------|----------|----------------|
-| 1 | {Missing input validation on API} | high | {src/routes/users.ts} | {Add zod schema validation} |
-| 2 | {Hardcoded secret in source} | critical | {src/config.ts:42} | {Move to environment variable} |
-| 3 | {SQL injection risk} | critical | {src/db/queries.ts:15} | {Use parameterized queries} |
-| 4 | {No rate limiting} | medium | {src/server.ts} | {Add express-rate-limit} |
-| 5 | {No CSRF protection} | medium | {src/routes/} | {Add csrf tokens} |
-
-## Performance Risks
-
-| # | Issue | Location | Impact | Recommendation |
-|---|-------|----------|--------|----------------|
-| 1 | {N+1 query in user list} | {src/routes/users.ts:30} | {Slow page load} | {Use eager loading} |
-| 2 | {No pagination on large queries} | {src/routes/posts.ts:15} | {Memory exhaustion} | {Add cursor pagination} |
-| 3 | {Synchronous file operations} | {src/utils/file.ts} | {Blocks event loop} | {Use async fs methods} |
-
-## Fragile Areas
-
-| # | Area | Why Fragile | Impact of Breaking | Files |
-|---|------|-------------|-------------------|-------|
-| 1 | {Auth middleware} | {Tightly coupled to 5 services} | {All protected routes fail} | {files} |
-| 2 | {Data migration} | {No rollback mechanism} | {Data loss on failure} | {files} |
-
-## Dependency Risks
-
-| Package | Version | Issue | Recommendation |
-|---------|---------|-------|----------------|
-| {package} | {version} | {Deprecated / EOL / Known vulnerability} | {Update to X / Replace with Y} |
-
-## Scaling Limitations
-
-| # | Limitation | When It Breaks | Current State | Fix Approach |
-|---|-----------|---------------|---------------|-------------|
-| 1 | {Single database instance} | {>1000 concurrent users} | {adequate for current load} | {Read replicas} |
-| 2 | {In-memory session store} | {Multiple server instances} | {single instance} | {Redis session store} |
-
-## Missing Infrastructure
-
-| Category | Status | Impact | Priority |
-|----------|--------|--------|----------|
-| Error monitoring | {absent/partial/present} | {bugs go unnoticed} | {high} |
-| Logging | {absent/partial/present} | {hard to debug production} | {high} |
-| CI/CD | {absent/partial/present} | {manual deployments} | {medium} |
-| Automated tests | {absent/partial/present} | {regressions not caught} | {high} |
-| Documentation | {absent/partial/present} | {onboarding difficulty} | {low} |
-| Backup/Recovery | {absent/partial/present} | {data loss risk} | {critical} |
-| Health checks | {absent/partial/present} | {outages not detected} | {medium} |
-
-## Recommendations (Prioritized)
-
-### Critical (Fix Immediately)
-1. {Recommendation with specific action}
-
-### High (Fix Soon)
-1. {Recommendation with specific action}
-
-### Medium (Plan to Fix)
-1. {Recommendation with specific action}
-
-### Low (When Convenient)
-1. {Recommendation with specific action}

package/plugins/cursor-pbr/templates/codebase/CONVENTIONS.md.tmpl

@@ -1,104 +0,0 @@
-<!-- Source: agents/codebase-mapper.md | Purpose: Output format for CONVENTIONS.md codebase analysis -->
-# Code Conventions
-
-> Analyzed: {date}
-> Based on: {n} files inspected
-
-## Naming Conventions
-
-| Entity | Convention | Example |
-|--------|-----------|---------|
-| Files (components) | {PascalCase.tsx} | `UserProfile.tsx` |
-| Files (utilities) | {camelCase.ts} | `formatDate.ts` |
-| Functions | {camelCase} | `getUserById` |
-| Classes | {PascalCase} | `UserService` |
-| Interfaces | {PascalCase, no I prefix} | `UserProfile` |
-| Types | {PascalCase} | `CreateUserInput` |
-| Constants | {SCREAMING_SNAKE_CASE or camelCase} | `MAX_RETRIES` or `maxRetries` |
-| Enum members | {PascalCase} | `UserRole.Admin` |
-| Environment variables | {SCREAMING_SNAKE_CASE} | `DATABASE_URL` |
-| CSS classes | {kebab-case or camelCase modules} | `user-profile` |
-| Database tables | {snake_case} | `user_profiles` |
-| API endpoints | {kebab-case} | `/api/user-profiles` |
-
-## Code Style
-
-| Aspect | Setting | Config File |
-|--------|---------|-------------|
-| Indentation | {2 spaces / 4 spaces / tabs} | {.editorconfig / .prettierrc} |
-| Quotes | {single / double} | {.prettierrc} |
-| Semicolons | {yes / no} | {.prettierrc} |
-| Trailing commas | {all / es5 / none} | {.prettierrc} |
-| Line width | {80 / 100 / 120} | {.prettierrc} |
-| Line endings | {LF / CRLF} | {.editorconfig} |
-
-## Import Organization
-
-{Observed import order pattern from the codebase}
-
-```{language}
-// 1. Node.js built-in modules
-import path from 'path';
-
-// 2. External packages
-import React from 'react';
-import { z } from 'zod';
-
-// 3. Internal aliases
-import { Button } from '@/components/ui';
-import { useAuth } from '@/hooks/useAuth';
-
-// 4. Relative imports
-import { UserCard } from './UserCard';
-import type { User } from './types';
-
-// 5. Style imports
-import styles from './UserProfile.module.css';
-```
-
-## Function Patterns
-
-### Async Functions
-
-```{language}
-// Pattern used in this codebase: {evidence file:line}
-{actual code pattern from codebase}
-```
-
-### Error Handling
-
-```{language}
-// Pattern used in this codebase: {evidence file:line}
-{actual code pattern from codebase}
-```
-
-### API Route Handlers
-
-```{language}
-// Pattern used in this codebase: {evidence file:line}
-{actual code pattern from codebase}
-```
-
-### React Components
-
-```{language}
-// Pattern used in this codebase: {evidence file:line}
-{actual code pattern from codebase}
-```
-
-## Comment Conventions
-
-| When | Style | Example |
-|------|-------|---------|
-| {Complex logic} | {inline comment} | `// Calculate tax with progressive rates` |
-| {Public API} | {JSDoc} | `/** @param user - The user to validate */` |
-| {Temporary} | {TODO with ticket} | `// TODO(#123): refactor after migration` |
-| {Warning} | {IMPORTANT prefix} | `// IMPORTANT: this must run before auth` |
-
-## Git Conventions
-
-| Aspect | Convention | Example |
-|--------|-----------|---------|
-| Branch naming | {pattern} | `feature/add-user-auth` |
-| Commit format | {conventional commits / custom} | `feat(auth): add login flow` |
-| PR titles | {pattern} | `[Feature] Add user authentication` |