claude-skills/research/deep-research
Claude 7405298b4b
fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885)
- #954: strip non-spec source/attribution keys from all 39 plugin.json
  manifests so Claude Code's validator accepts them; metadata preserved in
  new .claude-plugin/authoring-notes.json sidecars; check_plugin_json.py now
  hard-fails manifests carrying those keys and sanity-checks the sidecar;
  CLAUDE.md ClawHub schema section updated to the new rule.
- #949: move the c-level-agents plugin out of c-level-advisor/ to a
  top-level directory so the two marketplace sources no longer overlap;
  updated marketplace.json source, homepage, descriptions, all
  cross-references, docs, harness manifest, mirror-tree symlinks/indexes,
  and rebased the moved files' relative links; domain counters trued up
  (18 -> 19 domains).
- #933: replace dead links to the gitignored maintainer-local megaprompts/
  tree with annotated plain-text references (44 files: SKILL.md, READMEs,
  agents, commands).
- #931: DynamoDB on-demand pricing updated to post-Nov-2024 rates
  ($0.625/M writes, $0.125/M strongly consistent reads).
- #969: skill_security_auditor.py and the three dossier scripts reconfigure
  stdout/stderr to UTF-8 (errors=replace) so legacy Windows codepages no
  longer crash at print time; PYTHONUTF8=1 documented.
- #968: Windows Notes section in INSTALLATION.md + README pointer for the
  core.symlinks mirror-tree checkout caveat.
- #924/#885 residuals: hook commands quote "${CLAUDE_PLUGIN_ROOT}" paths in
  all plugin hooks.json/settings.json (space-safe roots); removed the stale
  pre-rename status/review mirror symlinks and index entries left over from
  the memory-status/memory-review rename.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qgc6RYXWJPr5oW9DHU7zR4
2026-08-21 05:47:37 +00:00
..
.claude-plugin fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
agents docs(deep-research): review follow-ups from #872 (merged before fixes landed) 2026-07-01 05:57:49 +00:00
commands feat(research): add deep-research skill (hardened from #851) 2026-07-01 05:46:54 +00:00
skills/deep-research feat(research): add deep-research skill (hardened from #851) 2026-07-01 05:46:54 +00:00
README.md feat(research): add deep-research skill (hardened from #851) 2026-07-01 05:46:54 +00:00

deep-research — Disciplined Meta-Research

The heavyweight end of the research domain: an auditable, reusable, triangulated investigation — for when a wrong answer costs more than the tokens spent getting it right.

deep-research is the rigor-first alternative to the fast research router. Where the router does keyword-classify → delegate → short brief for low-decision-risk questions, deep-research pays for rigor: falsifiable hypotheses, parallel sub-agent fan-out, source triangulation, a mandatory adversarial pass, and per-source files with verbatim quotes.

The 9-phase pipeline

# Phase What it does
1 Reframe Fix the underlying decision; state 2-4 falsifiable hypotheses
2 Genre & blocks Pick report genre + building blocks
3 Plan plan.md: scope, sourcing strategy, opposition queries, risk register, stop-criteria
3.5 Capability discovery Audit available API keys/channels; map subtopics to sources
4 Search (parallel) Fan out sub-agents → fetch & dedup → save each to sources/NN.md
5 Score & triangulate Rate Credibility/Recency/Bias; require >=3 independent, differently-typed sources per thesis
6 Synthesize + adversarial Assemble from blocks; 4 self-critique questions; steel-man counter-arguments
6.5 Verify Lightweight citation check
7 Refresh targets Emit refresh_targets.md for delta-updates

Core discipline

  • No fabricated citations — empty fetch = empty claim; every assertion binds to a saved verbatim quote.
  • Triangulation mandatory — a thesis with < 3 independent, differently-typed sources is "insufficient evidence," not fact.
  • Adversarial pass required on medium/deep investigations.
  • Persist to files — output is a reusable folder, not a chat wall.

Use / don't use

Use for: strategy, comparing N options, hypothesis validation, mapping a field. Not for: quick fact-checks (answer directly), 12-dimension competitor scoring (competitive-teardown), or fast low-risk overviews (the research router).

What's in the box

Attribution

Methodology contributed by @Socialpranker (PR #851). The continuously-maintained source catalog (29 channels, 460+ statistical sources, 39 validated APIs, 103 report blocks) lives upstream at claude-deep-research; the methodology here is self-contained. MIT.