rrce-workflow 0.2.77 → 0.2.79

package/agent-core/templates/research_output.md

@@ -18,48 +18,150 @@
   - {{date}}: ISO date (YYYY-MM-DD)
   - {{source}}: URL or reference to original request
   - {{workspace_name}}: Project name
+  
+  NOTE: This document is the output of an interactive research session.
+  The Research agent engaged in constructive dialogue with the user to
+  achieve 100% understanding before this brief was generated.
 -->
 # Research Brief – {{task_title}}
 
-- Task ID: `{{task_id}}`
-- Task Slug: `{{task_slug}}`
-- Author: `{{author}}`
-- Date: `{{date}}`
-- Source Request / Conversation URL: `{{source}}`
-- Workspace: `{{workspace_name}}`
+| Field | Value |
+|-------|-------|
+| Task ID | `{{task_id}}` |
+| Task Slug | `{{task_slug}}` |
+| Author | `{{author}}` |
+| Date | `{{date}}` |
+| Source Request | `{{source}}` |
+| Workspace | `{{workspace_name}}` |
+
+---
 
 ## 1. Request Summary
-- Concise restatement of the user's ask.
-- Highlight explicit goals, constraints, and success metrics.
 
-## Checklist
-- [ ] Replace with concrete clarification or validation step.
-- [ ] Replace with next ready-to-run action.
+> **Original Request**: [Quote the user's initial request]
+
+**Refined Understanding** (after clarification):
+- [Clear, specific statement of what needs to be built]
+- [Why it needs to be built - problem/opportunity]
+
+---
+
+## 2. Clarification Summary
+
+The following was clarified through interactive dialogue:
+
+| Topic | Question Asked | User Response | Impact on Scope |
+|-------|----------------|---------------|-----------------|
+| Intent | | | |
+| Constraints | | | |
+| Success Criteria | | | |
+| Edge Cases | | | |
+
+**Key Decisions Made**:
+- [Decision 1 and rationale]
+- [Decision 2 and rationale]
+
+---
+
+## 3. Current Knowledge Snapshot
+
+Relevant prior work and context from project knowledge:
+
+| Source | Relevance |
+|--------|-----------|
+| `{{RRCE_DATA}}/knowledge/...` | [How it applies] |
+| [Search result] | [How it applies] |
+
+**Patterns to Follow**:
+- [Existing pattern 1 from codebase]
+- [Existing pattern 2 from codebase]
+
+---
+
+## 4. Requirements
+
+### Functional Requirements
+- [ ] [FR-1]: [Requirement description]
+- [ ] [FR-2]: [Requirement description]
+- [ ] [FR-3]: [Requirement description]
+
+### Non-Functional Requirements
+- [ ] [NFR-1]: [Performance/Security/etc. requirement]
+- [ ] [NFR-2]: [Requirement description]
+
+### Success Criteria
+How we'll know this is done:
+1. [Measurable outcome 1]
+2. [Measurable outcome 2]
+3. [Measurable outcome 3]
+
+---
+
+## 5. Scope Boundaries
+
+### In Scope
+- [Explicit inclusion 1]
+- [Explicit inclusion 2]
+
+### Out of Scope
+- [Explicit exclusion 1]
+- [Explicit exclusion 2]
+
+### Constraints
+- [Hard constraint 1 - e.g., timeline, tech, resources]
+- [Hard constraint 2]
+
+---
+
+## 6. Assumptions & Risks
+
+### Assumptions
+| ID | Assumption | Confidence | Validation Needed |
+|----|------------|------------|-------------------|
+| A1 | [Assumption] | High/Medium/Low | [How to validate] |
+| A2 | [Assumption] | High/Medium/Low | [How to validate] |
+
+### Risks
+| ID | Risk | Impact | Likelihood | Mitigation |
+|----|------|--------|------------|------------|
+| R1 | [Risk description] | High/Medium/Low | High/Medium/Low | [Mitigation] |
+| R2 | [Risk description] | High/Medium/Low | High/Medium/Low | [Mitigation] |
+
+---
+
+## 7. Opportunity & Alternative Approaches
+
+Approaches considered during research:
+
+| Approach | Pros | Cons | Recommendation |
+|----------|------|------|----------------|
+| [Approach A] | | | Chosen / Rejected |
+| [Approach B] | | | Chosen / Rejected |
+
+**Rationale for chosen approach**: [Explanation]
+
+---
 
-## 2. Current Knowledge Snapshot
-- Relevant prior work or documents from `{{RRCE_DATA}}/knowledge` or workspace.
-- Key facts that shape feasibility or scope.
+## 8. Hand-off Notes for Planning
 
-## 3. Clarifications & Responses
-| Question | Answer | Status (answered/pending) | Reference |
-| --- | --- | --- | --- |
-|  |  |  |  |
+### Ready for Planning
+- [ ] Core requirements are clear and specific
+- [ ] Success criteria are measurable
+- [ ] Scope boundaries are explicit
+- [ ] No blocking open questions remain
 
-## 4. Assumptions & Risks
-- Explicit assumptions that require validation.
-- Risks or edge cases that need attention.
+### Context for Planning Agent
+- [Important context the planner needs to know]
+- [Technical considerations for task breakdown]
 
-## 5. Opportunity & Alternative Approaches
-- Potential strategies worth evaluating.
-- Trade-offs or spikes recommended before execution.
+### Open Questions (Non-Blocking)
+- [Question that can be resolved during planning or execution]
 
-## 6. Raw Requirement Draft
-- Bullet the functional outcomes and non-functional requirements as currently understood.
-- Note acceptance signals or metrics where available.
+### References Added to meta.json
+- [List of knowledge files referenced]
 
-## 7. Hand-off Notes
-- Immediate next steps for Planning.
-- Pending clarifications or decisions to resolve.
-- References added to `meta.json`.
+---
 
-> Keep this document under 500 lines. Replace placeholders with concise entries and trim empty sections if unnecessary.
+> **Next Step**: `/plan TASK_SLUG={{task_slug}}`
+> 
+> Keep this document under 500 lines. Replace placeholders with concise entries and trim empty sections.