@sienklogic/plan-build-run 2.12.0 → 2.12.1

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

@@ -1,78 +0,0 @@
-<!-- Source: agents/codebase-mapper.md | Purpose: Output format for INTEGRATIONS.md codebase analysis -->
-# External Integrations
-
-> Analyzed: {date}
-> Total integrations: {n}
-
-## APIs
-
-| Service | Type | Auth Method | Config Var | Used In | Documentation |
-|---------|------|-------------|------------|---------|---------------|
-| {Discord API} | REST | {OAuth2} | DISCORD_TOKEN | {src/integrations/discord.ts} | {URL} |
-| {Stripe} | REST | {API Key} | STRIPE_SECRET_KEY | {src/payments/} | {URL} |
-
-### API Client Patterns
-
-{How API calls are made in this codebase — fetch wrapper? axios instance? SDK?}
-
-```{language}
-// Example from codebase: {file:line}
-{actual code pattern}
-```
-
-## Databases
-
-| Database | Type | ORM/Driver | Config | Schema Location | Migrations |
-|----------|------|-----------|--------|-----------------|------------|
-| {PostgreSQL} | {Relational} | {Prisma} | DATABASE_URL | {prisma/schema.prisma} | {prisma/migrations/} |
-| {Redis} | {Key-value} | {ioredis} | REDIS_URL | - | - |
-
-### Database Patterns
-
-{How database access is structured — repository pattern? direct queries? ORM models?}
-
-## Authentication & Authorization
-
-| Aspect | Implementation | Config | Files |
-|--------|---------------|--------|-------|
-| Method | {JWT / Session / OAuth} | {env vars} | {files} |
-| Provider | {self / Auth0 / Clerk / etc.} | {env vars} | {files} |
-| Storage | {cookie / localStorage / header} | - | {files} |
-| Roles | {admin, user, etc.} | {where defined} | {files} |
-
-## Email/Notifications
-
-| Service | Purpose | Config | Used In |
-|---------|---------|--------|---------|
-| {SendGrid} | {Transactional email} | SENDGRID_KEY | {src/email/} |
-
-## File Storage
-
-| Service | Purpose | Config | Used In |
-|---------|---------|--------|---------|
-| {S3} | {User uploads} | AWS_* vars | {src/storage/} |
-
-## Monitoring & Logging
-
-| Tool | Purpose | Config | Used In |
-|------|---------|--------|---------|
-| {Sentry} | {Error tracking} | SENTRY_DSN | {src/lib/sentry.ts} |
-| {Winston} | {Logging} | - | {src/lib/logger.ts} |
-
-## CI/CD
-
-| Platform | Config | Stages | Deployment |
-|----------|--------|--------|------------|
-| {GitHub Actions} | {.github/workflows/} | {lint, test, build, deploy} | {Vercel / AWS / etc.} |
-
-### Pipeline Details
-
-{Description of the CI/CD pipeline flow}
-
-## Infrastructure
-
-| Component | Provider | Config | Notes |
-|-----------|----------|--------|-------|
-| {Hosting} | {Vercel} | {vercel.json} | {auto-deploy from main} |
-| {DNS} | {Cloudflare} | - | {if relevant} |
-| {CDN} | {included with host} | - | - |

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

@@ -1,78 +0,0 @@
-<!-- Source: agents/codebase-mapper.md | Purpose: Output format for STACK.md codebase analysis -->
-# Technology Stack
-
-> Analyzed: {date}
-> Project: {project name from package.json or directory}
-
-## Languages & Runtime
-
-| Language | Version | Config | Notes |
-|----------|---------|--------|-------|
-| TypeScript | {version from tsconfig target or dep} | `tsconfig.json` | {strict mode? path aliases?} |
-| Node.js | {version from engines or .nvmrc} | `.nvmrc` / `package.json engines` | {LTS?} |
-
-## Frameworks
-
-| Framework | Version | Role | Entry Point | Config |
-|-----------|---------|------|-------------|--------|
-| {Next.js} | {14.x} | {Web framework} | {src/app/} | {next.config.js} |
-| {Express} | {4.x} | {API server} | {src/server.ts} | - |
-
-## Key Dependencies
-
-### Production Dependencies
-
-| Package | Version | Purpose | Used In |
-|---------|---------|---------|---------|
-| {prisma} | {5.x} | {ORM / database} | {src/db/} |
-| {zod} | {3.x} | {Validation} | {src/validators/} |
-
-### Development Dependencies
-
-| Package | Version | Purpose | Config |
-|---------|---------|---------|--------|
-| {jest} | {29.x} | {Testing} | {jest.config.ts} |
-| {eslint} | {8.x} | {Linting} | {.eslintrc.js} |
-
-## Build & Tooling
-
-| Tool | Config File | Purpose | Commands |
-|------|-------------|---------|----------|
-| {TypeScript} | `tsconfig.json` | {Compilation} | `npx tsc --noEmit` |
-| {ESLint} | `.eslintrc.js` | {Linting} | `npm run lint` |
-| {Prettier} | `.prettierrc` | {Formatting} | `npm run format` |
-| {Jest} | `jest.config.ts` | {Testing} | `npm test` |
-
-## Package Manager
-
-- **Manager**: {npm / yarn / pnpm / bun}
-- **Lock file**: {package-lock.json / yarn.lock / pnpm-lock.yaml}
-- **Workspaces**: {yes/no, if yes: list workspace paths}
-
-## Environment Configuration
-
-| Variable | Required | Default | Purpose | Where Used |
-|----------|----------|---------|---------|------------|
-| DATABASE_URL | YES | - | Database connection | {src/db/} |
-| {VAR_NAME} | {YES/NO} | {value} | {purpose} | {files} |
-
-**Template**: {`.env.example` exists? Y/N}
-
-## Platform Requirements
-
-| Requirement | Value | Source |
-|------------|-------|--------|
-| Node version | {>=18} | {package.json engines} |
-| OS | {any / linux only / etc.} | {evidence} |
-| Memory | {if specified} | {evidence} |
-| External services | {list databases, caches, etc.} | {docker-compose, docs} |
-
-## Scripts
-
-| Script | Command | Purpose |
-|--------|---------|---------|
-| `dev` | {command} | {Start dev server} |
-| `build` | {command} | {Build for production} |
-| `test` | {command} | {Run tests} |
-| `lint` | {command} | {Run linter} |
-| {others} | {command} | {purpose} |

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

@@ -1,80 +0,0 @@
-<!-- Source: agents/codebase-mapper.md | Purpose: Output format for STRUCTURE.md codebase analysis -->
-# Project Structure
-
-> Analyzed: {date}
-
-## Directory Layout
-
-```
-{project_root}/
-├── src/                          # Source code
-│   ├── app/                      # {Purpose: Next.js App Router pages}
-│   │   ├── api/                  # {API route handlers}
-│   │   ├── (auth)/               # {Auth-related pages}
-│   │   └── layout.tsx            # {Root layout}
-│   ├── components/               # {Shared UI components}
-│   │   ├── ui/                   # {Primitive UI components}
-│   │   └── features/             # {Feature-specific components}
-│   ├── lib/                      # {Shared utilities and configurations}
-│   ├── services/                 # {Business logic}
-│   ├── models/                   # {Data models / types}
-│   ├── hooks/                    # {Custom React hooks}
-│   └── styles/                   # {Global styles}
-├── prisma/                       # {Database schema and migrations}
-├── public/                       # {Static assets}
-├── tests/                        # {Test files}
-├── docs/                         # {Documentation}
-└── scripts/                      # {Build/deploy scripts}
-```
-
-## File Naming Conventions
-
-| Type | Pattern | Example |
-|------|---------|---------|
-| React components | {PascalCase.tsx} | `UserProfile.tsx` |
-| Hooks | {camelCase.ts, use* prefix} | `useAuth.ts` |
-| Utilities | {camelCase.ts} | `formatDate.ts` |
-| Types | {PascalCase.ts or types.ts} | `User.ts`, `types.ts` |
-| Tests | {*.test.ts or *.spec.ts} | `UserProfile.test.tsx` |
-| API routes | {route.ts in directory} | `app/api/users/route.ts` |
-| Config | {lowercase with dots} | `jest.config.ts` |
-| Constants | {UPPER_CASE or camelCase} | `constants.ts` |
-
-## Module Boundaries
-
-{How the code is organized into modules/features and what the boundaries are}
-
-| Module | Directory | Responsibility | Dependencies |
-|--------|-----------|---------------|-------------|
-| {Auth} | {src/auth/} | {Authentication & session} | {Database, Config} |
-| {Users} | {src/users/} | {User CRUD} | {Auth, Database} |
-
-## Import Patterns
-
-{How imports are organized in this codebase}
-
-```{language}
-// Standard import order observed in this project:
-// {example from actual codebase}
-```
-
-### Path Aliases
-
-| Alias | Maps To | Config |
-|-------|---------|--------|
-| `@/` | `src/` | `tsconfig.json paths` |
-| `@components/` | `src/components/` | `tsconfig.json paths` |
-
-## Where to Add Code
-
-| Type of Code | Location | Convention | Example |
-|-------------|----------|------------|---------|
-| New API route | `src/app/api/{resource}/route.ts` | {pattern} | {example} |
-| New component | `src/components/{feature}/` | {pattern} | {example} |
-| New service | `src/services/` | {pattern} | {example} |
-| New model | `src/models/` | {pattern} | {example} |
-| New test | `{co-located or tests/}` | {pattern} | {example} |
-| New utility | `src/lib/` or `src/utils/` | {pattern} | {example} |
-| New hook | `src/hooks/` | {pattern} | {example} |
-| New migration | `prisma/migrations/` | `npx prisma migrate dev` | - |
-| New env var | `.env` + `.env.example` | {pattern} | {example} |

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

@@ -1,107 +0,0 @@
-<!-- Source: agents/codebase-mapper.md | Purpose: Output format for TESTING.md codebase analysis -->
-# Testing Infrastructure
-
-> Analyzed: {date}
-> Test files found: {n}
-> Coverage: {percentage if configured}
-
-## Framework
-
-| Aspect | Value | Config |
-|--------|-------|--------|
-| Test runner | {Jest / Vitest / pytest / etc.} | {config file path} |
-| Assertion library | {built-in / chai / etc.} | - |
-| Mocking | {jest.mock / vitest.mock / unittest.mock} | - |
-| Coverage tool | {c8 / istanbul / coverage.py} | {config} |
-
-## Running Tests
-
-```bash
-# All tests
-{npm test}
-
-# Specific file
-{npm test -- path/to/file}
-
-# Watch mode
-{npm run test:watch}
-
-# Coverage
-{npm run test:coverage}
-
-# Specific pattern
-{npm test -- --grep "pattern"}
-```
-
-## Test Organization
-
-| Aspect | Pattern | Example |
-|--------|---------|---------|
-| Location | {co-located / separate directory} | `src/auth/auth.test.ts` or `tests/auth.test.ts` |
-| File naming | {.test.ts / .spec.ts / test_.py} | `UserService.test.ts` |
-| Describe blocks | {module/function/feature} | `describe('UserService')` |
-| Test naming | {should X / it X / test_X} | `it('should return user by id')` |
-
-## Test Structure Pattern
-
-```{language}
-// Pattern used in this codebase: {evidence file:line}
-{actual test structure from codebase}
-```
-
-## Mocking Patterns
-
-### External Services
-
-```{language}
-// How external services are mocked: {evidence file:line}
-{actual mock pattern from codebase}
-```
-
-### Database
-
-```{language}
-// How database is mocked/seeded: {evidence file:line}
-{actual pattern from codebase}
-```
-
-### API Calls
-
-```{language}
-// How API calls are mocked: {evidence file:line}
-{actual pattern from codebase}
-```
-
-## Fixtures & Test Data
-
-| Type | Location | Pattern |
-|------|----------|---------|
-| {Factories} | {tests/factories/} | {createUser(), createPost()} |
-| {Fixtures} | {tests/fixtures/} | {JSON files} |
-| {Seeds} | {prisma/seed.ts} | {Prisma seed script} |
-
-## Coverage Configuration
-
-| Setting | Value |
-|---------|-------|
-| Threshold | {if configured: line %, branch %, function %} |
-| Include | {file patterns} |
-| Exclude | {file patterns} |
-| Reporter | {text / html / lcov} |
-
-## E2E Testing
-
-| Aspect | Value | Config |
-|--------|-------|--------|
-| Framework | {Playwright / Cypress / none} | {config file} |
-| Location | {e2e/ or tests/e2e/} | - |
-| Base URL | {config} | - |
-
-## Testing Gaps
-
-| Area | Has Tests | Notes |
-|------|-----------|-------|
-| {Unit tests} | {YES/NO/PARTIAL} | {coverage details} |
-| {Integration tests} | {YES/NO/PARTIAL} | {coverage details} |
-| {E2E tests} | {YES/NO/PARTIAL} | {coverage details} |
-| {API tests} | {YES/NO/PARTIAL} | {coverage details} |

package/plugins/cursor-pbr/templates/continue-here.md.tmpl

@@ -1,74 +0,0 @@
-<!-- canonical: ../../pbr/templates/continue-here.md.tmpl -->
-<!-- Source: skills/pause/SKILL.md | Purpose: Handoff file for session pause/resume, placed in the active phase directory -->
-
-# Template: Continue Here Handoff File
-# Used by: pause/SKILL.md (Step 4)
-# Output path: .planning/phases/{NN}-{phase-name}/.continue-here.md
-# Variables: {datetime}, {hours}, {phase}, {plan}, {status}, {session work}, {remaining}, {decisions}, {blockers}, {context}, {next steps}
-
-# Continue Here
-
-**Paused:** {ISO datetime}
-**Session duration:** ~{estimated hours} (based on git log timestamps)
-
-## Position
-
-Phase: {N} -- {name}
-Plan: {M} of {total} (or "between plans" / "phase complete")
-Status: {in-progress / between-plans / reviewing / planning}
-
-## Completed This Session
-
-{List of work done, with commit references where available}
-
-- Plan {A}: {summary} (commit: {short hash})
-- Plan {B}: {summary} (commit: {short hash})
-- Quick task: {description} (commit: {short hash})
-
-{If nothing was completed:}
-- No plans completed this session (discussion/planning only)
-
-## Remaining
-
-{What still needs to be done in this phase}
-
-- Plan {C}: {brief description from plan frontmatter}
-- Plan {D}: {brief description from plan frontmatter}
-
-{If phase is complete:}
-- Phase {N} is complete. Next: {review or next phase}
-
-## Decisions Made
-
-{Key decisions from this session that affect future work}
-
-- {decision 1}: {brief description}
-- {decision 2}: {brief description}
-
-{If no notable decisions:}
-- No major decisions this session
-
-## Blockers
-
-{Any issues preventing progress}
-
-- {blocker description}
-
-{If no blockers:}
-- None
-
-## Context Notes
-
-{Any additional context that would help the next session}
-
-- {note about something tricky}
-- {note about something to watch out for}
-- {note about user preferences expressed during this session}
-
-## Next Steps
-
-{Ordered list of what to do when resuming}
-
-1. {Specific first action with command}
-2. {Following action}
-3. {And so on}

package/plugins/cursor-pbr/templates/prompt-partials/phase-project-context.md.tmpl

@@ -1,38 +0,0 @@
-<!-- canonical: ../../../pbr/templates/prompt-partials/phase-project-context.md.tmpl -->
-<!-- Source: templates/prompt-partials/ | Purpose: Shared context blocks for agent prompt templates -->
-<!-- Usage: Read this file and fill in placeholders, then include the result in agent prompts. -->
-<!-- Orchestrators should omit sections that don't apply to their agent type. -->
-
-<phase_context>
-Phase: {NN} - {phase_name}
-Phase directory: .planning/phases/{NN}-{slug}/
-Phase goal: {goal from roadmap}
-Phase requirements: {REQ-IDs mapped to this phase, or "None"}
-Phase depends on: {dependency phases, or "None"}
-Success criteria from roadmap:
-{success criteria list, or omit if not applicable}
-</phase_context>
-
-<project_context>
-{Decision Summary from .planning/CONTEXT.md — compact locked/deferred/discretion list}
-{If no CONTEXT.md exists: "No project-level context."}
-
-Phase-specific decisions:
-{Decision Summary from .planning/phases/{NN}-{slug}/CONTEXT.md}
-{If no phase-level CONTEXT.md exists: "No phase-specific discussion captured."}
-
-Full context files (Read on-demand if you need scope/quality/integration details):
-- .planning/CONTEXT.md
-- .planning/phases/{NN}-{slug}/CONTEXT.md
-</project_context>
-
-<prior_work>
-The following prior phase summaries are available. Read any you need via the Read tool.
-
-| Phase | Summary File | Status | Key Exports |
-|-------|-------------|--------|-------------|
-{For each preceding phase SUMMARY.md:}
-| {M} - {name} | {absolute path to SUMMARY.md} | {complete/partial} | {one-line provides list} |
-
-{If no prior phases: "No prior phases completed."}
-</prior_work>

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

@@ -1,124 +0,0 @@
-<!-- Source: agents/researcher.md | Purpose: Output format for research project ARCHITECTURE.md -->
-# Architecture Research
-
-**Domain:** {domain}
-**Researched:** {date}
-**Confidence:** {confidence}
-
-## Standard Architecture
-
-### System Overview
-
-```
-{ascii_architecture_diagram}
-```
-
-### Component Responsibilities
-
-| Component | Responsibility | Typical Implementation |
-|-----------|----------------|------------------------|
-| {component} | {responsibility} | {implementation} |
-
-## Recommended Project Structure
-
-```
-src/
-{project_structure}
-```
-
-### Structure Rationale
-
-- **{folder}/:** {rationale}
-
-## Architectural Patterns
-
-### Pattern 1: {pattern_name}
-
-**What:** {description}
-**When to use:** {conditions}
-**Trade-offs:** {pros_and_cons}
-
-**Example:**
-```{language}
-{code_example}
-```
-
-### Pattern 2: {pattern_name}
-
-**What:** {description}
-**When to use:** {conditions}
-**Trade-offs:** {pros_and_cons}
-
-### Pattern 3: {pattern_name}
-
-**What:** {description}
-**When to use:** {conditions}
-**Trade-offs:** {pros_and_cons}
-
-## Data Flow
-
-### Request Flow
-
-```
-{request_flow_diagram}
-```
-
-### State Management
-
-```
-{state_management_diagram}
-```
-
-### Key Data Flows
-
-1. **{flow_name}:** {description}
-2. **{flow_name}:** {description}
-
-## Scaling Considerations
-
-| Scale | Architecture Adjustments |
-|-------|--------------------------|
-| 0-1k users | {approach} |
-| 1k-100k users | {approach} |
-| 100k+ users | {approach} |
-
-### Scaling Priorities
-
-1. **First bottleneck:** {description}
-2. **Second bottleneck:** {description}
-
-## Anti-Patterns
-
-### Anti-Pattern 1: {name}
-
-**What people do:** {mistake}
-**Why it's wrong:** {problem}
-**Do this instead:** {correct_approach}
-
-### Anti-Pattern 2: {name}
-
-**What people do:** {mistake}
-**Why it's wrong:** {problem}
-**Do this instead:** {correct_approach}
-
-## Integration Points
-
-### External Services
-
-| Service | Integration Pattern | Notes |
-|---------|---------------------|-------|
-| {service} | {pattern} | {notes} |
-
-### Internal Boundaries
-
-| Boundary | Communication | Notes |
-|----------|---------------|-------|
-| {boundary} | {communication} | {notes} |
-
-## Sources
-
-- {sources}
-
----
-*Architecture research for: {domain}*
-*Researched: {date}*

package/plugins/cursor-pbr/templates/research/STACK.md.tmpl

@@ -1,71 +0,0 @@
-<!-- Source: agents/researcher.md | Purpose: Output format for research project STACK.md (external tech evaluation) -->
-# Stack Research
-
-**Domain:** {domain}
-**Researched:** {date}
-**Confidence:** {confidence}
-
-## Recommended Stack
-
-### Core Technologies
-
-| Technology | Version | Purpose | Why Recommended |
-|------------|---------|---------|-----------------|
-| {technology} | {version} | {purpose} | {rationale} |
-
-### Supporting Libraries
-
-| Library | Version | Purpose | When to Use |
-|---------|---------|---------|-------------|
-| {library} | {version} | {purpose} | {use_case} |
-
-### Development Tools
-
-| Tool | Purpose | Notes |
-|------|---------|-------|
-| {tool} | {purpose} | {notes} |
-
-## Installation
-
-```bash
-# Core
-{core_install_commands}
-
-# Supporting
-{supporting_install_commands}
-
-# Dev dependencies
-{dev_install_commands}
-```
-
-## Alternatives Considered
-
-| Recommended | Alternative | When to Use Alternative |
-|-------------|-------------|-------------------------|
-| {our_choice} | {alternative} | {conditions} |
-
-## What NOT to Use
-
-| Avoid | Why | Use Instead |
-|-------|-----|-------------|
-| {technology} | {problem} | {alternative} |
-
-## Stack Patterns by Variant
-
-**If {condition}:**
-- Use {variation}
-- Because {reason}
-
-## Version Compatibility
-
-| Package A | Compatible With | Notes |
-|-----------|-----------------|-------|
-| {package_a} | {package_b} | {notes} |
-
-## Sources
-
-- {sources}
-
----
-*Stack research for: {domain}*
-*Researched: {date}*