basic BMAD setup

2026-10-15 08:57:23 +02:00
parent 44029127dc
commit 5e747654b9
438 changed files with 41818 additions and 0 deletions
@@ -0,0 +1,24 @@
+# Research with deep recon
+
+Open this when the user asks how to get the most from `bmad-deep-recon` or which of its services to use.
+
+## Start from the decision
+
+Every run serves a decision: enter a market, pick a library, scope a product. Have the user state it first. A vague question gives vague research, so when the idea itself is still loose, recommend `bmad-forge-idea` first.
+
+## Which service
+
+| Service | Recommend when |
+|---|---|
+| Draft: writes a prompt for the user's own deep-research tool | The user subscribes to ChatGPT, Gemini, Perplexity, or similar. It is the cheap option and often covers more public sources. |
+| Process: turns a finished report into a short cited summary | The user has any report, from a tool or an analyst. Draft then Process is the usual pairing. |
+| Run: researches here with parallel web searches | The user wants results in one sitting, or the research needs sources only this session can reach. It costs tokens and minutes and needs web access. |
+
+## What to tell the user
+
+- It can go quick or deep. Suggest a quick pass for a narrow question, and a deep pass with stronger verification when the decision is costly to reverse. The user just says so.
+- "Help me choose between A and B" is supported for any research type. It agrees the requirements first and ends with a pick, a runner-up, and the strongest argument against the pick.
+- Research types cover market, domain, technical, competitive, user voice, and academic literature. A team can add its own through `bmad-customize`.
+- Conclusions come only from sources retrieved during the run, with citations. The model's memory and the project's files only shape the questions. Thin evidence is reported as thin.
+- A report ages. An existing run can be refreshed, which re-checks only the claims most likely to be stale, or deepened in one area. When a run on the topic already exists, recommend resuming it.
+- The result is `research-<topic>.md`, a cited summary other skills can take as input without reprocessing.