Research Summary — [Task Title]
Phase: 0 — Research | Status: Draft / Reviewed
Date: [YYYY-MM-DD] | Engineer: AI (reviewed by Human)
🎯 Problem Definition
[Identify the core engineering challenge. What is broken? What needs to be built? What is the user impact?]
🔍 Dependency Audit
Files that will be affected:
| File | Type | Current Behavior | Impact Level |
|---|---|---|---|
src/... | Logic / UI / Schema | [What it currently does] | High / Med / Low |
External dependencies involved:
| Package | Version | Purpose | Compatible? |
|---|---|---|---|
package-name | ^x.x.x | [What it does] | ✅ / ❌ |
⚖️ Option Comparison
| Option | Approach | Pros | Cons | Verdict |
|---|---|---|---|---|
| A | [Approach description] | [+] | [-] | ❌ Not recommended |
| B | [Approach description] | [+] | [-] | ✅ Recommended |
| C | [Approach description] | [+] | [-] | ❌ Fallback only |
Recommendation rationale: [Why Option B is the best choice for this specific context]
⚠️ Risks & Boundary Conditions
- Risk 1: [What could go wrong] → Mitigation: [How to prevent it]
- Risk 2: [Edge case] → Mitigation: [How to handle it]
- Breaking change?: Yes / No — [Explain if yes]
🧭 Recommended Next Step
[!summary] Proceed with Option B ([brief approach name]). Ready for
/pphase when human confirms with1.
⏸️ STOP — Awaiting human review. Reply 1 to proceed to planning phase.