[H1][DESIGN-SYNTHESIS]
<br>Dictum: Design decisions require grounded context before implementation.
Synthesize research findings into design decisions via light codebase investigation.
Workflow:
- •§INGEST — Load research artifact, parse original request
- •§SCAN — Light codebase investigation via
parallel-dispatch(3-4 agents) - •§EXPLORE — Generate 2-3 approaches with trade-offs
- •§SELECT — Commit to best approach with rationale
- •§OUTPUT — Structured design document
Dependencies:
- •
parallel-dispatch— Agent orchestration for codebase scan - •Research artifact — External findings from
deep-research
Input:
- •
Research: Path to research artifact (research_{slug}.md) - •
Request: Original user request/intent
[1][INGEST]
<br>Dictum: Grounded context prevents speculative design.
Load and parse inputs:
| [INDEX] | Source | Extract |
|---|---|---|
| [1] | Research file | Findings, confidence levels, key sources |
| [2] | Request | Intent, scope boundaries, success criteria |
Parse research structure:
- •
## [1][FINDINGS]→ Domain knowledge by category - •
## [2][CONFIDENCE]→ High/Medium/Low ratings - •
## [3][SOURCES]→ Attribution for decisions
[IMPORTANT]:
- •[ALWAYS] Extract high-confidence findings as primary input.
- •[ALWAYS] Note low-confidence areas as design risks.
- •[NEVER] Proceed without understanding request intent.
[2][SCAN]
<br>Dictum: Pattern awareness prevents reinvention.
Dispatch 3-4 agents via parallel-dispatch for codebase context.
Agent Assignment:
| [INDEX] | [AGENT] | [SCOPE] | [RETURNS] |
|---|---|---|---|
| [1] | Patterns | Similar implementations in codebase | Conventions, reusable patterns, prior art |
| [2] | Constraints | Project rules, architecture limits | Hard boundaries, style requirements |
| [3] | Interfaces | Entry/exit points for feature area | Touch points, consumers, integration surface |
Agent Prompt Template:
code
Scope: [Specific investigation area] Objective: Surface [patterns|constraints|interfaces] relevant to: [request summary] Output: Bullet list of findings with file paths Context: Research indicates: [key findings summary] Exclusions: Do NOT analyze implementation details or specific file contents
[CRITICAL]:
- •[ALWAYS] Dispatch ALL agents in ONE message block.
- •[ALWAYS] Scope to patterns/constraints/interfaces—NOT implementation.
- •[NEVER] Deep-dive into file contents—that's plan's job.
[3][EXPLORE]
<br>Dictum: Comparison reveals optimal trade-offs.
Generate 2-3 distinct approaches from research + scan findings.
Per Approach:
| [INDEX] | Aspect | Content |
|---|---|---|
| [1] | Strategy | High-level implementation direction |
| [2] | Alignment | How it leverages research findings |
| [3] | Patterns | Which codebase conventions it follows |
| [4] | Trade-offs | Pros and cons |
Approach Generation Criteria:
- •Approach A: Most aligned with existing patterns (conservative)
- •Approach B: Best leverage of research findings (optimal)
- •Approach C: Simplest implementation path (minimal) — optional
[IMPORTANT]:
- •[ALWAYS] Ground approaches in scan findings—no speculation.
- •[ALWAYS] Include trade-off analysis per approach.
- •[ALWAYS] Apply YAGNI—cut unnecessary scope from all approaches.
- •[NEVER] Generate approaches without codebase evidence.
[4][SELECT]
<br>Dictum: Committed direction enables focused planning.
Select best approach via weighted criteria:
| [INDEX] | Criterion | Weight | Evaluation |
|---|---|---|---|
| [1] | Pattern alignment | High | Matches existing codebase conventions |
| [2] | Research support | High | Backed by high-confidence findings |
| [3] | Simplicity | Medium | Minimal moving parts |
| [4] | Risk profile | Medium | Low-confidence areas minimized |
Selection Output:
- •Selected approach name
- •Primary rationale (1-2 sentences)
- •Key trade-off accepted
[CRITICAL]:
- •[ALWAYS] Commit to ONE approach—no hedging.
- •[ALWAYS] Document trade-off accepted.
- •[NEVER] Defer selection to downstream phases.
[5][OUTPUT]
<br>Dictum: Downstream consumers require predictable structure.
Produce brainstorm.md with structure:
markdown
# [H1][DESIGN]: [Title] >**Dictum:** *[Build target—refined from request]* <br> **Research Summary:** [Key findings relevant to design] --- ## [1][APPROACHES] ### [1.1][APPROACH_A]: [Name] | [INDEX] | [ASPECT] | [DETAIL] | | :-----: | --------- | ------------------------------- | | [1] | Strategy | [High-level direction] | | [2] | Alignment | [Research findings leveraged] | | [3] | Patterns | [Codebase conventions followed] | | [4] | Pros | [Benefits] | | [5] | Cons | [Drawbacks] | --- ### [1.2][APPROACH_B]: [Name] | [INDEX] | [ASPECT] | [DETAIL] | | :-----: | --------- | ------------------------------- | | [1] | Strategy | [High-level direction] | | [2] | Alignment | [Research findings leveraged] | | [3] | Patterns | [Codebase conventions followed] | | [4] | Pros | [Benefits] | | [5] | Cons | [Drawbacks] | --- ## [2][SELECTED_APPROACH] | [INDEX] | [KEY] | [VALUE] | | :-----: | ------------------ | ---------------------- | | [1] | Choice | [Approach name] | | [2] | Rationale | [Why this approach] | | [3] | Trade-off Accepted | [What we're giving up] | --- ## [3][DESIGN_CONSTRAINTS] | [INDEX] | [CONSTRAINT] | [SOURCE] | | :-----: | --------------- | --------------- | | [1] | [Hard boundary] | [Codebase scan] | | [2] | ... | ... | --- ## [4][KEY_DECISIONS] | [INDEX] | [DECISION] | [CHOICE] | [RATIONALE] | | :-----: | --------------- | ----------------- | ----------- | | [1] | [Design choice] | [Selected option] | [Why] | | [2] | [Design choice] | [Selected option] | [Why] |
[CRITICAL]:
- •[ALWAYS] Include all sections—downstream depends on structure.
- •[ALWAYS] Table format for approaches and decisions.
- •[NEVER] Prose paragraphs—tables and lists only.
[6][VALIDATION]
<br>Dictum: Incomplete synthesis cascades errors downstream.
[VERIFY]:
- • Ingest: Research parsed, request intent extracted
- • Scan: 3-4 agents dispatched in ONE message
- • Explore: 2-3 approaches with trade-offs generated
- • Select: ONE approach committed with rationale
- • Output: All sections present, table format used
- • YAGNI: Unnecessary scope cut from all approaches