@sienklogic/plan-build-run 2.0.0 → 2.0.1

package/plugins/pbr/templates/research/SUMMARY.md.tmpl

@@ -1,112 +1,112 @@
-<!-- Source: agents/researcher.md | Purpose: Output format for research project SUMMARY.md (executive overview with roadmap implications) -->
-# Project Research Summary
-
-**Project:** {project_name}
-**Domain:** {domain}
-**Researched:** {date}
-**Confidence:** {confidence}
-
-## Executive Summary
-
-{executive_summary}
-
-## Key Findings
-
-### Recommended Stack
-
-{stack_summary}
-
-**Core technologies:**
-- {technology}: {purpose} -- {rationale}
-
-### Expected Features
-
-{features_summary}
-
-**Must have (table stakes):**
-- {feature} -- users expect this
-
-**Should have (competitive):**
-- {feature} -- differentiator
-
-**Defer (v2+):**
-- {feature} -- not essential for launch
-
-### Architecture Approach
-
-{architecture_summary}
-
-**Major components:**
-1. {component} -- {responsibility}
-2. {component} -- {responsibility}
-3. {component} -- {responsibility}
-
-### Critical Pitfalls
-
-{pitfalls_summary}
-
-1. **{pitfall}** -- {avoidance}
-2. **{pitfall}** -- {avoidance}
-3. **{pitfall}** -- {avoidance}
-
-## Implications for Roadmap
-
-Based on research, suggested phase structure:
-
-### Phase 1: {phase_name}
-**Rationale:** {why_first}
-**Delivers:** {deliverables}
-**Addresses:** {features}
-**Avoids:** {pitfall}
-
-### Phase 2: {phase_name}
-**Rationale:** {why_this_order}
-**Delivers:** {deliverables}
-**Uses:** {stack_elements}
-**Implements:** {architecture_component}
-
-### Phase 3: {phase_name}
-**Rationale:** {why_this_order}
-**Delivers:** {deliverables}
-
-### Phase Ordering Rationale
-
-- {ordering_rationale}
-
-### Research Flags
-
-Phases likely needing deeper research during planning:
-- **Phase {x}:** {reason}
-
-Phases with standard patterns (skip research-phase):
-- **Phase {x}:** {reason}
-
-## Confidence Assessment
-
-| Area | Confidence | Notes |
-|------|------------|-------|
-| Stack | {confidence} | {notes} |
-| Features | {confidence} | {notes} |
-| Architecture | {confidence} | {notes} |
-| Pitfalls | {confidence} | {notes} |
-
-**Overall confidence:** {confidence}
-
-### Gaps to Address
-
-- {gap}: {handling}
-
-## Sources
-
-### Primary (HIGH confidence)
-- {source}
-
-### Secondary (MEDIUM confidence)
-- {source}
-
-### Tertiary (LOW confidence)
-- {source}
-
----
-*Research completed: {date}*
-*Ready for roadmap: yes*
+<!-- Source: agents/researcher.md | Purpose: Output format for research project SUMMARY.md (executive overview with roadmap implications) -->
+# Project Research Summary
+
+**Project:** {project_name}
+**Domain:** {domain}
+**Researched:** {date}
+**Confidence:** {confidence}
+
+## Executive Summary
+
+{executive_summary}
+
+## Key Findings
+
+### Recommended Stack
+
+{stack_summary}
+
+**Core technologies:**
+- {technology}: {purpose} -- {rationale}
+
+### Expected Features
+
+{features_summary}
+
+**Must have (table stakes):**
+- {feature} -- users expect this
+
+**Should have (competitive):**
+- {feature} -- differentiator
+
+**Defer (v2+):**
+- {feature} -- not essential for launch
+
+### Architecture Approach
+
+{architecture_summary}
+
+**Major components:**
+1. {component} -- {responsibility}
+2. {component} -- {responsibility}
+3. {component} -- {responsibility}
+
+### Critical Pitfalls
+
+{pitfalls_summary}
+
+1. **{pitfall}** -- {avoidance}
+2. **{pitfall}** -- {avoidance}
+3. **{pitfall}** -- {avoidance}
+
+## Implications for Roadmap
+
+Based on research, suggested phase structure:
+
+### Phase 1: {phase_name}
+**Rationale:** {why_first}
+**Delivers:** {deliverables}
+**Addresses:** {features}
+**Avoids:** {pitfall}
+
+### Phase 2: {phase_name}
+**Rationale:** {why_this_order}
+**Delivers:** {deliverables}
+**Uses:** {stack_elements}
+**Implements:** {architecture_component}
+
+### Phase 3: {phase_name}
+**Rationale:** {why_this_order}
+**Delivers:** {deliverables}
+
+### Phase Ordering Rationale
+
+- {ordering_rationale}
+
+### Research Flags
+
+Phases likely needing deeper research during planning:
+- **Phase {x}:** {reason}
+
+Phases with standard patterns (skip research-phase):
+- **Phase {x}:** {reason}
+
+## Confidence Assessment
+
+| Area | Confidence | Notes |
+|------|------------|-------|
+| Stack | {confidence} | {notes} |
+| Features | {confidence} | {notes} |
+| Architecture | {confidence} | {notes} |
+| Pitfalls | {confidence} | {notes} |
+
+**Overall confidence:** {confidence}
+
+### Gaps to Address
+
+- {gap}: {handling}
+
+## Sources
+
+### Primary (HIGH confidence)
+- {source}
+
+### Secondary (MEDIUM confidence)
+- {source}
+
+### Tertiary (LOW confidence)
+- {source}
+
+---
+*Research completed: {date}*
+*Ready for roadmap: yes*

package/plugins/pbr/templates/research-outputs/phase-research.md.tmpl

@@ -1,81 +1,81 @@
-# Phase Research: {Phase Name}
-
-> Research conducted: {date}
-> Research date: {ISO date}
-> Mode: phase-research
-> Phase: {NN}-{phase-name}
-> Confidence: {overall HIGH/MEDIUM/LOW}
-> Coverage: {COMPLETE/PARTIAL/INSUFFICIENT}
-> Retrieval cycles: {1-3}
-
-## User Constraints
-
-{Copied verbatim from CONTEXT.md}
-
-## Phase Goal
-
-{What this phase aims to achieve, extracted from the phase definition}
-
-## Implementation Approach
-
-### Recommended Approach
-
-{Detailed implementation strategy with source attribution}
-
-**Steps**:
-1. {Step with [S{n}] attribution}
-2. ...
-
-**Key decisions**:
-- {Decision with rationale and source}
-
-### Configuration Details
-
-{Specific configuration values, environment variables, file paths}
-
-```{language}
-// Source: [S{n}]
-{configuration example}
-```
-
-### API Patterns
-
-{Relevant API signatures, request/response formats, authentication patterns}
-
-### Data Models
-
-{Database schemas, type definitions, data flow}
-
-## Dependencies
-
-{What needs to be installed, configured, or available}
-
-| Dependency | Version | Purpose | Required By |
-|-----------|---------|---------|-------------|
-| ... | ... | ... | ... |
-
-## Pitfalls for This Phase
-
-{Phase-specific things that can go wrong}
-
-1. **{Pitfall}** [S{n}]: {Description}
-
-## Testing Strategy
-
-{How to verify this phase works correctly}
-
-## Coverage Assessment
-
-| Question | Status | Confidence | Cycle Resolved |
-|----------|--------|------------|----------------|
-| {Implementation question 1} | ANSWERED | HIGH | 1 |
-| {Implementation question 2} | GAP | — | — |
-
-**Overall coverage**: {COMPLETE/PARTIAL/INSUFFICIENT}
-**Gaps remaining**: {List any unresolved questions}
-
-## Sources
-
-| # | Type | URL/Description | Confidence |
-|---|------|----------------|------------|
-| ... | ... | ... | ... |
+# Phase Research: {Phase Name}
+
+> Research conducted: {date}
+> Research date: {ISO date}
+> Mode: phase-research
+> Phase: {NN}-{phase-name}
+> Confidence: {overall HIGH/MEDIUM/LOW}
+> Coverage: {COMPLETE/PARTIAL/INSUFFICIENT}
+> Retrieval cycles: {1-3}
+
+## User Constraints
+
+{Copied verbatim from CONTEXT.md}
+
+## Phase Goal
+
+{What this phase aims to achieve, extracted from the phase definition}
+
+## Implementation Approach
+
+### Recommended Approach
+
+{Detailed implementation strategy with source attribution}
+
+**Steps**:
+1. {Step with [S{n}] attribution}
+2. ...
+
+**Key decisions**:
+- {Decision with rationale and source}
+
+### Configuration Details
+
+{Specific configuration values, environment variables, file paths}
+
+```{language}
+// Source: [S{n}]
+{configuration example}
+```
+
+### API Patterns
+
+{Relevant API signatures, request/response formats, authentication patterns}
+
+### Data Models
+
+{Database schemas, type definitions, data flow}
+
+## Dependencies
+
+{What needs to be installed, configured, or available}
+
+| Dependency | Version | Purpose | Required By |
+|-----------|---------|---------|-------------|
+| ... | ... | ... | ... |
+
+## Pitfalls for This Phase
+
+{Phase-specific things that can go wrong}
+
+1. **{Pitfall}** [S{n}]: {Description}
+
+## Testing Strategy
+
+{How to verify this phase works correctly}
+
+## Coverage Assessment
+
+| Question | Status | Confidence | Cycle Resolved |
+|----------|--------|------------|----------------|
+| {Implementation question 1} | ANSWERED | HIGH | 1 |
+| {Implementation question 2} | GAP | — | — |
+
+**Overall coverage**: {COMPLETE/PARTIAL/INSUFFICIENT}
+**Gaps remaining**: {List any unresolved questions}
+
+## Sources
+
+| # | Type | URL/Description | Confidence |
+|---|------|----------------|------------|
+| ... | ... | ... | ... |

package/plugins/pbr/templates/research-outputs/project-research.md.tmpl

@@ -1,99 +1,99 @@
-# Research: {Topic Title}
-
-> Research conducted: {date}
-> Research date: {ISO date}
-> Mode: project-research
-> Confidence: {overall HIGH/MEDIUM/LOW}
-> Coverage: {COMPLETE/PARTIAL/INSUFFICIENT}
-> Retrieval cycles: {1-3}
-> Sources consulted: {count}
-
-## User Constraints
-
-{Copied verbatim from CONTEXT.md if it exists. Otherwise: "No CONTEXT.md found."}
-
-## Executive Summary
-
-{2-3 paragraph overview of findings. What is this technology/domain? Why does it matter for this project? What is the recommended approach?}
-
-## Standard Stack
-
-{The conventional/recommended technology stack for this domain}
-
-| Layer | Technology | Version | Confidence | Source |
-|-------|-----------|---------|------------|--------|
-| Runtime | Node.js | 20.x LTS | HIGH | [S2] |
-| Framework | Next.js | 14.x | HIGH | [S2] |
-| ... | ... | ... | ... | ... |
-
-### Stack Rationale
-
-{Why this combination? What alternatives were considered and why they were rejected?}
-
-### Stack Risks
-
-{Known issues, upcoming deprecations, migration concerns}
-
-## Architecture Patterns
-
-### Recommended Pattern: {Name}
-
-{Description with source attribution}
-
-**When to use**: ...
-**When to avoid**: ...
-**Example structure**:
-```
-project/
-  src/
-    ...
-```
-
-### Alternative Pattern: {Name}
-
-{Only include if CONTEXT.md doesn't lock the architecture}
-
-## Common Pitfalls
-
-{Numbered list of things that commonly go wrong}
-
-1. **{Pitfall name}** [S{n}]: {Description and how to avoid}
-2. ...
-
-## Code Examples
-
-{Working code snippets for key patterns. Every snippet must include source attribution.}
-
-### {Pattern Name}
-
-```{language}
-// Source: [S{n}] {url or description}
-{code}
-```
-
-## Integration Points
-
-{How this technology connects with other systems. API patterns, data flow, authentication.}
-
-## Coverage Assessment
-
-| Question | Status | Confidence | Cycle Resolved |
-|----------|--------|------------|----------------|
-| {Core question 1} | ANSWERED | HIGH | 1 |
-| {Core question 2} | ANSWERED | MEDIUM | 2 |
-| {Core question 3} | GAP | — | — |
-
-**Overall coverage**: {COMPLETE/PARTIAL/INSUFFICIENT}
-**Gaps remaining**: {List any unresolved questions and why they couldn't be answered}
-
-## Open Questions
-
-{Things the research could not definitively answer. These need human input or further investigation.}
-
-## Sources
-
-| # | Type | URL/Description | Confidence |
-|---|------|----------------|------------|
-| S1 | Official Docs | {url} | HIGH |
-| S2 | GitHub | {url} | HIGH |
-| ... | ... | ... | ... |
+# Research: {Topic Title}
+
+> Research conducted: {date}
+> Research date: {ISO date}
+> Mode: project-research
+> Confidence: {overall HIGH/MEDIUM/LOW}
+> Coverage: {COMPLETE/PARTIAL/INSUFFICIENT}
+> Retrieval cycles: {1-3}
+> Sources consulted: {count}
+
+## User Constraints
+
+{Copied verbatim from CONTEXT.md if it exists. Otherwise: "No CONTEXT.md found."}
+
+## Executive Summary
+
+{2-3 paragraph overview of findings. What is this technology/domain? Why does it matter for this project? What is the recommended approach?}
+
+## Standard Stack
+
+{The conventional/recommended technology stack for this domain}
+
+| Layer | Technology | Version | Confidence | Source |
+|-------|-----------|---------|------------|--------|
+| Runtime | Node.js | 20.x LTS | HIGH | [S2] |
+| Framework | Next.js | 14.x | HIGH | [S2] |
+| ... | ... | ... | ... | ... |
+
+### Stack Rationale
+
+{Why this combination? What alternatives were considered and why they were rejected?}
+
+### Stack Risks
+
+{Known issues, upcoming deprecations, migration concerns}
+
+## Architecture Patterns
+
+### Recommended Pattern: {Name}
+
+{Description with source attribution}
+
+**When to use**: ...
+**When to avoid**: ...
+**Example structure**:
+```
+project/
+  src/
+    ...
+```
+
+### Alternative Pattern: {Name}
+
+{Only include if CONTEXT.md doesn't lock the architecture}
+
+## Common Pitfalls
+
+{Numbered list of things that commonly go wrong}
+
+1. **{Pitfall name}** [S{n}]: {Description and how to avoid}
+2. ...
+
+## Code Examples
+
+{Working code snippets for key patterns. Every snippet must include source attribution.}
+
+### {Pattern Name}
+
+```{language}
+// Source: [S{n}] {url or description}
+{code}
+```
+
+## Integration Points
+
+{How this technology connects with other systems. API patterns, data flow, authentication.}
+
+## Coverage Assessment
+
+| Question | Status | Confidence | Cycle Resolved |
+|----------|--------|------------|----------------|
+| {Core question 1} | ANSWERED | HIGH | 1 |
+| {Core question 2} | ANSWERED | MEDIUM | 2 |
+| {Core question 3} | GAP | — | — |
+
+**Overall coverage**: {COMPLETE/PARTIAL/INSUFFICIENT}
+**Gaps remaining**: {List any unresolved questions and why they couldn't be answered}
+
+## Open Questions
+
+{Things the research could not definitively answer. These need human input or further investigation.}
+
+## Sources
+
+| # | Type | URL/Description | Confidence |
+|---|------|----------------|------------|
+| S1 | Official Docs | {url} | HIGH |
+| S2 | GitHub | {url} | HIGH |
+| ... | ... | ... | ... |

package/plugins/pbr/templates/research-outputs/synthesis.md.tmpl

@@ -1,36 +1,36 @@
-# Research Synthesis: {Topic}
-
-> Synthesized: {date}
-> Mode: synthesis
-> Input documents: {count}
-> Confidence: {overall}
-
-## Executive Summary
-
-{Unified findings across all input documents}
-
-## Key Findings
-
-{Numbered list of the most important findings, with source document attribution}
-
-## Contradictions Resolved
-
-{Where input documents disagreed and how it was resolved}
-
-| Topic | Document A Says | Document B Says | Resolution | Basis |
-|-------|----------------|----------------|------------|-------|
-| ... | ... | ... | ... | ... |
-
-## Recommended Approach
-
-{The synthesized recommendation}
-
-## Risks and Mitigations
-
-| Risk | Likelihood | Impact | Mitigation |
-|------|-----------|--------|------------|
-| ... | ... | ... | ... |
-
-## Sources
-
-{Consolidated source list from all input documents}
+# Research Synthesis: {Topic}
+
+> Synthesized: {date}
+> Mode: synthesis
+> Input documents: {count}
+> Confidence: {overall}
+
+## Executive Summary
+
+{Unified findings across all input documents}
+
+## Key Findings
+
+{Numbered list of the most important findings, with source document attribution}
+
+## Contradictions Resolved
+
+{Where input documents disagreed and how it was resolved}
+
+| Topic | Document A Says | Document B Says | Resolution | Basis |
+|-------|----------------|----------------|------------|-------|
+| ... | ... | ... | ... | ... |
+
+## Recommended Approach
+
+{The synthesized recommendation}
+
+## Risks and Mitigations
+
+| Risk | Likelihood | Impact | Mitigation |
+|------|-----------|--------|------------|
+| ... | ... | ... | ... |
+
+## Sources
+
+{Consolidated source list from all input documents}