-
Notifications
You must be signed in to change notification settings - Fork 0
Step 0 Research
github-actions[bot] edited this page Apr 8, 2026
·
4 revisions
Command: /research [topic] · Habit: H5 Seek First to Understand · Position: Optional pre-step before /requirements
Investigate the problem space before writing requirements. Prevents specifying the wrong thing — the most expensive bug class.
- Problem space is unclear or unfamiliar
- Multiple existing solutions exist and you need a comparison
- Domain has non-obvious constraints (regulatory, performance, security)
- You catch yourself thinking "I'll just start coding and see"
- You have deep domain knowledge already
- Requirement is crystal clear (e.g. "fix typo in header")
- Prior ADR already covers the decision space
- Define the question — 1 sentence, specific
- Gather prior art — existing code, docs, web research, comparable libraries
- Compare — if evaluating alternatives, produce a trade-off matrix
- Surface constraints — legal, performance, team skills, budget
- Recommend (not decide) — AI recommends; human decides in Step 2
A research brief containing:
- Problem statement
- Findings summary
- Comparison matrix (if applicable)
- Constraints
- Recommendation + rationale
- Open questions
- Expects: A topic or question from the user
-
Produces for
/requirements: Research brief that informs PRD scope and success criteria
"Have I fully understood the problem before proposing a solution?"
Source of truth: this wiki is generated from docs/wiki/. Edits made through the GitHub Wiki web UI may be overwritten by the next sync. To change a page, open a PR against the repository source file.
Repository · Issues · README · License
Workflow discipline for AI-assisted development
Start
Workflow
- Overview
- 0 · Research
- 1 · Requirements
- 2 · Design
- 3 · Breakdown
- 4 · Build Brief
- 5 · Review AI
- 6 · Deploy Guide
- 7 · Monitor Setup
Operations
Reference
- Habits Reference
- Maturity Model
- Architecture
- Limitations
- Vibe Coding vs Structured
- Harness Engineering
Project