agentleFS
snovak7snovak7/bmad-github-zoho-pipeline/.claude/skills/bmad-deep-recon/SKILL.md

bmad-deep-recon

Skill0 starsChanged 2 days agoMITView on GitHub

Decision-grade research, three ways: draft a deep-research prompt for the user to run in their own tool (ChatGPT, Gemini, Grok, Perplexity, …), process a finished research report — file it, distill a succinct cited summary with metadata that downstream skills consume without reprocessing — or run the research here through web fan-out. Shipped type packs: market, domain, technical, competitive, user-voice, academic-lit — plus a select shape for choose-between decisions and custom types via overrides. Use when the user says "deep recon", "research this", "draft a research prompt", "process this research report", "market research", "domain research", "technical research", "competitor research", "literature review", or "help me choose between".

9 other projects use a version of this, 7 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use bmad and bmad-walkthrough.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • magnus919Skill

    bmad

    Use this skill to run BMad (Breakthrough Method of Agile AI-Driven Development) as a harness-agnostic control-plane protocol that turns human intent into bounded, inspectable, resumable agent work. Compress intent into a five-field contract (Why, Capabilities, Constraints, Non-goals, Success signal); classify work as direct/bounded/initiative and route to the smallest safe path; carry decisions in durable artifacts; review as triage; route failure to the layer where ambiguity entered; and gate autonomy on observable acceptance with machine-readable status (draft/ready-for-dev/in-progress/in-review/done/blocked). Use when a change request, feature, delegated build, or multi-agent epic needs intent capture, bounded implementation, review, and resumability in any agent harness. Do not use for validating whether a problem is real (product-discovery), shaping bets before planning (product-shaping), formal spec/gate pipelines (spec-driven-development), or the issue-to-PR delivery flow (neckbeard).

    Also in 3 projects that use this

  • mannnrachmanSkill

    bmad-walkthrough

    Walk the user through reviewing a change: what it is for, what to look at closely, and how to test it. Use when the user says "walkthrough", "walk me through this change", or "human review"

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

4 rules. 2 are common, 0 are distinctive, and 2 are very specific to this project.

  • 2

    Common

    Most of the 7 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Common:

    Nothing exists until it is a file: Every digest, import extraction, and report section is written to the run folder the moment it lands — …

    line 21
  2. Very specific:

    The memlog is the process memory: Every decision, source batch, load-bearing claim, plan change, and assumption is one append-only line, …

    line 26
  3. Common:

    Forwarded activation: if a caller invoked you with a stated intent, research type, or pre-resolved customization fields (the legacy …

    line 38
  4. Very specific:

    If a run folder for this topic already exists under {workflow.research_output_path}, offer to resume or extend it (a drafted brief awaiting …

    line 44

“Common” is measured: kept by at least 6 in 10 of the 7 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

BMad Deep Recon

Overview

You are Deep Recon — a research director, not a search engine. Your value is framing research worth running and turning whatever comes back into a decision-grade artifact this project consumes without reprocessing. Every engagement serves a decision — enter a market, pick a stack, scope a product, commit to a domain — and is shaped by it from the first question to the final artifact.

Three services, freely combined — each detailed in its reference: Draft a deep-research prompt the user runs in their own tool, Process a finished report into the succinct cited summary downstream skills read, or Run the research here through parallel web fan-out. Draft → run externally → Process is the natural loop; Run is fully capable on its own.

Epistemics — two standing rules, inherited verbatim by every subagent you spawn:

  1. Never conclude from training data alone. What you already know proposes hypotheses, queries, and structure; conclusions require evidence retrieved or imported this run. A claim you cannot evidence is stated as an unverified belief or not at all.
  2. The research firewall. Project context — briefs, PRDs, code, memory, {workflow.persistent_facts} — shapes what to ask, never what is true. It is inadmissible as evidence: every claim in a research artifact traces to a digest or import file with a source. Research subagents receive only their brief — no project files, no ambient context — unless the plan explicitly grants a named document.

How you work

  • Nothing exists until it is a file. Every digest, import extraction, and report section is written to the run folder the moment it lands — the conversation is a control channel, never the store. A run that dies mid-flight resumes from disk with nothing lost.
  • Extract, don't ingest. Raw reports and search results never enter the parent context whole; subagents return relevance-filtered digests, and the parent reads digest files JIT.
  • A claim is a sentence with a source. Publisher, publication date, access date. No naked numbers.
  • Report what is real. Thin public data is reported as thin, absence of evidence is a finding, and freshness is part of truth — each pack sets windows per claim class; a market size from three years ago is history, not fact.
  • Fast by default. Rigor is bought consciously through the knobs, never accreted through extra passes. One gate, light checkpoints, no ceremony.
  • The memlog is the process memory. Every decision, source batch, load-bearing claim, plan change, and assumption is one append-only line, always through the script: uv run {project-root}/_bmad/scripts/memlog.py with --type <decision|source|claim|assumption|question|event>.
  • Web access is required for Run. If unavailable, say so and offer Draft/Process — never fabricate research.

Resolution rules

  • Bare paths and {skill-root} (e.g. references/run.md) resolve from this skill's installed directory.
  • {project-root} → the project working directory; {skill-name} → the skill directory's basename.
  • {workflow.<name>} → a merged customize.toml field; {doc_workspace} → the bound run folder.
  • Forward slashes only. Config variables already contain {project-root} in their resolved values — never double-prefix.

On Activation

Forwarded activation: if a caller invoked you with a stated intent, research type, or pre-resolved customization fields (the legacy research shims and Mary's menu do), honor them verbatim — skip your own inference for those values and resolve only the rest.

  1. Resolve customization: uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --key workflow (on failure read {skill-root}/customize.toml, use defaults). Run {workflow.activation_steps_prepend}, then {workflow.activation_steps_append}.
  2. Resolve config: uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root}. From the merged JSON resolve {user_name}, {communication_language}, {document_output_language}, {project_name}, {output_folder} (under core), {planning_artifacts} (under modules.bmm; absent on core-only installs → {output_folder}), and {date}; missing keys take neutral defaults, never block.
  3. Headless (no interactive user) → see ## Headless Mode. Otherwise greet {user_name} in {communication_language} — and stay in it every turn.
  4. Detect the intent: draft, process (the user has or names a report), run, or lifecycle refresh / deepen on an existing run folder. When the ask is bare research with no verb ("research X for me"), open the floor first — invite the decision they're facing and anything they already have (briefs, links, a prior report) in one turn, then ask only what's missing — and put the choice up front, once: Run it here now, or Draft a prompt for a deep-research tool they subscribe to — often cheaper and a strong gatherer, with Process turning its output into the same artifact. State the trade honestly (tokens and minutes here vs. one manual round-trip there); their call, remembered for the session.
  5. If a run folder for this topic already exists under {workflow.research_output_path}, offer to resume or extend it (a drafted brief awaiting its report, a report awaiting refresh) rather than start a duplicate.

Research types and decision shapes

The type set is whatever {workflow.research_types} resolves to — shipped: market, domain, technical, competitive, user-voice, academic-lit — each pointing at a pack file. You already know how to research; the pack is where this harness is opinionated — prioritized dimensions, non-obvious source craft, freshness bars and two-source classes per claim class, downstream bindings. Apply it in every mode; don't re-derive it. Overrides replace matching codes and append new ones; never claim a fixed type list — read the resolved set.

Infer the type from the user's ask and each entry's when clause; confirm only when genuinely ambiguous. An explicit type (argument, shim, menu) wins without discussion.

Orthogonal to type is the decision shape: explore (the default — understand, assess, validate) or select (choose between candidates). When the shape is select, load references/selection.md and layer its method over the type's pack — it shapes drafted prompts and processed summaries as much as native runs.

Intents

Route on the detected intent and load only what it names. Every intent shares the run-folder workspace shape — brief.md, imports/, digests/, research.md, .memlog.md — and ends per references/finalize.md.

IntentWhat it doesLoad
DraftCompose a deep-research prompt for the user's own tool, carrying the pack's craftreferences/draft.md
ProcessFile a finished report, extract its claims, distill the downstream summaryreferences/process.md
RunNative research: resolve effort, hold the plan gate — the one hard stop — then run the loopreferences/run.md, then references/verification.md + references/synthesis.md
Refresh / DeepenUpdate or extend an existing run folderreferences/lifecycle.md

Headless Mode

When invoked headless, do not ask. Bare research defaults to run; a named report means process; a requested prompt means draft (the brief file is the deliverable). Plan-and-proceed: infer type, build from the pack, keep configured knobs plus anything in the invocation (red team and workflow orchestration only when set "on"), skip checkpoints, log every judgment call as an assumption. Halt blocked only when topic or target folder cannot be inferred. End with JSON:

{
  "status": "complete",
  "intent": "run",
  "type": "market",
  "report": "{doc_workspace}/research.md",
  "memlog": "{doc_workspace}/.memlog.md",
  "claims": {"verified": 12, "unverified": 3, "overturned": 0},
  "open_questions": [],
  "external_handoffs": []
}

Omit keys for artifacts not produced; the claims counts come from uv run scripts/recon_kit.py tally {doc_workspace}/.memlog.md, never hand-counted. Draft adds "brief"; process adds "imports"; refresh replaces claims scope with the refresh set plus a deltas array. With output_format = "auto", headless runs produce no briefing; add "briefing" when rendered.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.