|
7 | 7 | - Invocation assumption: The executing developer has standing approval to run brainstorm sessions immediately; results are logged but don't require approval gates before proceeding to research or planning. |
8 | 8 |
|
9 | 9 | ## Inputs |
10 | | -- Required: Brainstorm topic or problem statement, desired mode (`exploratory`, `targeted`, or `expansion`), mission context (from `product/mission.md`), known constraints (technical, compliance, budget, timeline). |
11 | | -- Optional: Prior brainstorm results, user feedback or pain points, competitive intelligence, specific stakeholder perspectives to explore (user, developer, business, technical), guiding questions from `product/guiding-questions.md`. |
| 10 | +- Required: Brainstorm topic or problem statement, desired mode (`exploratory`, `targeted`, or `expansion`), mission context (from `workspace/product/mission.md`), known constraints (technical, compliance, budget, timeline). |
| 11 | +- Optional: Prior brainstorm results, user feedback or pain points, competitive intelligence, specific stakeholder perspectives to explore (user, developer, business, technical), guiding questions from `workspace/product/guiding-questions.md`. |
12 | 12 | - Request missing info by: Sending a mode-specific checklist (e.g., "Provide specific mission gap or user need for targeted mode", "Link existing feature concept for expansion mode"); if core inputs are still missing, record them as assumptions and proceed with available context, flagging gaps in the output. |
13 | 13 |
|
14 | 14 | ## Resource Strategy |
15 | | -- `.devagent/templates/brainstorm-packet-template.md` — base outline for all brainstorm outputs; duplicate and customize per mode. |
16 | | -- `.devagent/product/brainstorms/` — canonical storage for brainstorm packets (format: `YYYY-MM-DD_<topic>.md`). |
17 | | -- `.devagent/product/mission.md` — primary source for mission alignment and success metrics. |
18 | | -- `.devagent/product/guiding-questions.md` — reference for known gaps and open questions; update with new insights from brainstorms. |
19 | | -- `.devagent/memory/constitution.md` — guardrails and principles that ideas must respect; cite relevant clauses when evaluating candidates. |
20 | | -- `.devagent/product/roadmap.md` — context for existing priorities and strategic themes. |
21 | | -- `.devagent/memory/decision-journal.md` — log brainstorm sessions and key decision rationale. |
| 15 | +- `.devagent/core/templates/brainstorm-packet-template.md` — base outline for all brainstorm outputs; duplicate and customize per mode. |
| 16 | +- `.devagent/workspace/product/brainstorms/` — canonical storage for brainstorm packets (format: `YYYY-MM-DD_<topic>.md`). |
| 17 | +- `.devagent/workspace/product/mission.md` — primary source for mission alignment and success metrics. |
| 18 | +- `.devagent/workspace/product/guiding-questions.md` — reference for known gaps and open questions; update with new insights from brainstorms. |
| 19 | +- `.devagent/workspace/memory/constitution.md` — guardrails and principles that ideas must respect; cite relevant clauses when evaluating candidates. |
| 20 | +- `.devagent/workspace/product/roadmap.md` — context for existing priorities and strategic themes. |
| 21 | +- `.devagent/workspace/memory/decision-journal.md` — log brainstorm sessions and key decision rationale. |
22 | 22 | - #ProductMissionPartner — validate mission alignment or request clarification on strategic priorities before deep ideation. |
23 | 23 | - #ResearchAgent — hand off prioritized feature candidates with formulated research questions for evidence gathering. |
24 | 24 |
|
|
28 | 28 | - **Expansion:** Take an existing feature concept and generate variations, enhancements, or alternative approaches. Explore different implementation angles, scope adjustments, and complementary capabilities. Produce a comparative evaluation of variations with recommended directions. |
29 | 29 |
|
30 | 30 | ## Knowledge Sources |
31 | | -- Internal: `.devagent/product/` artifacts (mission, roadmap, guiding-questions), `.devagent/memory/` logs (constitution, decision-journal), feature hubs for related work, existing specs and task plans for context. |
| 31 | +- Internal: `.devagent/workspace/product/` artifacts (mission, roadmap, guiding-questions), `.devagent/workspace/memory/` logs (constitution, decision-journal), feature hubs for related work, existing specs and task plans for context. |
32 | 32 | - External: Industry best practices (via research tools when needed), technology trends, competitive patterns (when explicitly provided or researched). |
33 | 33 | - Retrieval etiquette: Start with internal mission and constitution sources, cite file paths for all internal references, flag when external research would strengthen evaluation, and refresh mission context before each session. |
34 | 34 |
|
|
51 | 51 | - Research questions for #ResearchAgent |
52 | 52 | - Parking lot for lower-priority or future ideas |
53 | 53 | - Session metadata (date, participants, constraints, assumptions) |
54 | | -8. **Post-run logging:** Store brainstorm packet at `.devagent/product/brainstorms/YYYY-MM-DD_<topic>.md`, update `.devagent/memory/decision-journal.md` with session summary and key decisions, note relevant insights in `product/guiding-questions.md` if they address open questions, and prepare hand-off for downstream agents. |
| 54 | +8. **Post-run logging:** Store brainstorm packet at `.devagent/workspace/product/brainstorms/YYYY-MM-DD_<topic>.md`, update `.devagent/workspace/memory/decision-journal.md` with session summary and key decisions, note relevant insights in `workspace/product/guiding-questions.md` if they address open questions, and prepare hand-off for downstream agents. |
55 | 55 |
|
56 | 56 | ## Adaptation Notes |
57 | 57 | - **Exploratory mode** emphasizes breadth and creative diversity—encourage wild ideas and defer judgment until convergent phase. Use multiple ideation techniques to maximize idea space exploration. |
|
69 | 69 | - When ideas consistently conflict with constitution: Pause ideation, review principles with session owner, consider whether mission or constitution needs updating. |
70 | 70 |
|
71 | 71 | ## Expected Output |
72 | | -- **All modes:** Markdown brainstorm packet stored in `.devagent/product/brainstorms/YYYY-MM-DD_<topic>.md` following the template structure, plus chat response summarizing top candidates and next steps. |
| 72 | +- **All modes:** Markdown brainstorm packet stored in `.devagent/workspace/product/brainstorms/YYYY-MM-DD_<topic>.md` following the template structure, plus chat response summarizing top candidates and next steps. |
73 | 73 | - **Exploratory:** Full idea list with clustered themes, top 3-5 prioritized candidates with evaluation matrix, research questions for #ResearchAgent, and parking lot for future ideas. |
74 | 74 | - **Targeted:** Solutions addressing specific criteria, comparative evaluation against constraints, recommended solution(s) with trade-off analysis, and research questions for validation. |
75 | 75 | - **Expansion:** Feature variations with comparative analysis, recommended directions with rationale, implementation trade-offs, and suggested phasing or scoping adjustments. |
|
81 | 81 | - #ProductMissionPartner — can be notified if brainstorm reveals mission gaps or strategic pivots |
82 | 82 | - #SpecArchitect — receives validated candidates (post-research) for spec drafting |
83 | 83 | - Integration points: |
84 | | - - Update `.devagent/product/guiding-questions.md` when brainstorm addresses or raises open questions |
85 | | - - Log session in `.devagent/memory/decision-journal.md` with key decisions and rationale |
| 84 | + - Update `.devagent/workspace/product/guiding-questions.md` when brainstorm addresses or raises open questions |
| 85 | + - Log session in `.devagent/workspace/memory/decision-journal.md` with key decisions and rationale |
86 | 86 | - Cross-reference relevant constitution clauses in outputs |
87 | 87 | - Link to related feature hubs if brainstorm extends existing work |
88 | 88 | - Metrics / signals: Track brainstorm cadence, number of candidates progressing to research, alignment scores with mission metrics, and downstream agent rework rates (signals need for clearer outputs). |
|
0 commit comments