Gsd Project Researcher

## RESEARCH COMPLETE

**Research Type:** [stack | features | architecture | pitfalls]
**Output:** .planning/research/[DIMENSION].md

**Key Findings:**
- [Finding 1]
- [Finding 2]
- [Finding 3]

Ready for synthesizer.

# Technology Stack

**Analysis Date:** [YYYY-MM-DD]

## Languages

**Primary:**
- [Language] [Version] - [Where used]

**Secondary:**
- [Language] [Version] - [Where used]

## Runtime

**Environment:**
- [Runtime] [Version]

**Package Manager:**
- [Manager] [Version]
- Lockfile: [present/missing]

## Frameworks

**Core:**
- [Framework] [Version] - [Purpose]

**Testing:**
- [Framework] [Version] - [Purpose]

**Build/Dev:**
- [Tool] [Version] - [Purpose]

## Key Dependencies

**Critical:**
- [Package] [Version] - [Why it matters]

**Infrastructure:**
- [Package] [Version] - [Purpose]

## Configuration

**Environment:**
- [How configured]
- [Key configs required]

**Build:**
- [Build config files]

## Platform Requirements

**Development:**
- [Requirements]

**Production:**
- [Deployment target]

---

*Stack analysis: [date]*

# Features Analysis

**Analysis Date:** [YYYY-MM-DD]

## Table Stakes

**Must-have features** (users expect these or they leave):
- [Feature 1] - [Brief description]
- [Feature 2] - [Brief description]
- [Feature 3] - [Brief description]

**Differentiators** (competitive advantages):
- [Feature 1] - [Why this gives you an edge]
- [Feature 2] - [Why this is valuable]
- [Feature 3] - [Brief description]

**Anti-features** (things to deliberately NOT build):
- [Feature 1] - [Why not to build this]
- [Feature 2] - [Why defer or skip]

## Feature Complexity

[Notes on implementation effort and dependencies]

---

*Features analysis: [date]*

# Architecture Analysis

**Analysis Date:** [YYYY-MM-DD]

## Pattern Overview

**Overall:** [Pattern name]

**Key Characteristics:**
- [Characteristic 1]
- [Characteristic 2]
- [Characteristic 3]

## Layers

**[Layer Name]:**
- Purpose: [What this layer does]
- Location: `[path]`
- Contains: [Types of code]
- Depends on: [What it uses]
- Used by: [What uses it]

## Data Flow

**[Flow Name]:**

1. [Step 1]
2. [Step 2]
3. [Step 3]

**State Management:**
- [How state is handled]

## Key Abstractions

**[Abstraction Name]:**
- Purpose: [What it represents]
- Examples: `[file paths]`
- Pattern: [Pattern used]

## Entry Points

**[Entry Point]:**
- Location: `[path]`
- Triggers: [What invokes it]
- Responsibilities: [What it does]

## Error Handling

**Strategy:** [Approach]

**Patterns:**
- [Pattern 1]
- [Pattern 2]

## Cross-Cutting Concerns

**Logging:** [Approach]
**Validation:** [Approach]
**Authentication:** [Approach]

---

*Architecture analysis: [date]*

# Common Pitfalls

**Analysis Date:** [YYYY-MM-DD]

## Critical Pitfalls

**1. [Pitfall Name]**
   - **Warning Signs:** [How to detect early]
   - **Prevention Strategy:** [How to avoid]
   - **Which Phase Should Address:** [Phase number]

**2. [Pitfall Name]**
   - **Warning Signs:** [How to detect early]
   - **Prevention Strategy:** [How to avoid]
   - **Which Phase Should Address:** [Phase number]

**3. [Pitfall Name]**
   - **Warning Signs:** [How to detect early]
   - **Prevention Strategy:** [How to avoid]
   - **Which Phase Should Address:** [Phase number]

---

*Pitfalls analysis: [date]*