joycraft-research

What problem does it solve?

Produce objective codebase research by isolating question generation from fact-gathering — subagent sees only questions, never the brief.

Core Features & Use Cases

• Phase 1: Generate Research Questions by reading the brief and identifying relevant codebase zones, producing 5-10 objective, codebase-specific, answerable questions and writing them to docs/research/.questions-tmp.md without including brief content.
• Phase 2: Spawn Research Subagent by passing only the research questions; the subagent returns FACTS ONLY about file paths, signatures, data flows, dependencies, or notes that a question cannot be answered.
• Phase 3: Write the Research Document to docs/research/YYYY-MM-DD-feature-name.md; delete the temporary questions file; present structured results and recommended next steps.

Quick Start

Provide a feature brief or inline description, then run the research workflow to generate questions, spawn a subagent, and publish the findings.