Skip to content

Add ACH-enhanced deep research, upgrade research workflow - #18

Merged
5uck1ess merged 3 commits into
mainfrom
feat/deep-research
Apr 5, 2026
Merged

Add ACH-enhanced deep research, upgrade research workflow#18
5uck1ess merged 3 commits into
mainfrom
feat/deep-research

Conversation

@5uck1ess

@5uck1ess 5uck1ess commented Apr 5, 2026

Copy link
Copy Markdown
Owner

Summary

  • Upgraded research skill — query decomposition with explicit goals, iterative summarization, source corroboration tracking (CONFIRMED/UNCORROBORATED/CONTESTED)
  • New deep-research skill + command — Analysis of Competing Hypotheses (ACH) pipeline: perspective discovery, directed disconfirmation, evidence matrix, sensitivity analysis, self-critique
  • New deep-research.yml workflow — 13-step YAML workflow for the Go engine
  • Updated research.yml workflow — matches upgraded skill with decomposition and corroboration steps

Design

Two tiers triggered by keyword:

  • "research X" → lightweight search/synthesize (~200k budget)
  • "deep research X" → full ACH pipeline (~400k budget)

ACH pipeline (from CIA methodology):

  1. Discover perspectives from overview articles
  2. Decompose into sub-questions with disconfirmation queries
  3. Extract atomic claims from sources
  4. Generate 2-4 competing hypotheses
  5. Directed disconfirmation — try to KILL each hypothesis
  6. Evidence matrix — score by fewest inconsistencies
  7. Sensitivity check — identify linchpin evidence
  8. Self-critique before output

Test plan

  • Run /devkit:deep-research on a real question and verify full ACH pipeline executes
  • Run research skill on a simple question and verify it stays lightweight
  • Verify YAML workflows parse correctly via devkit workflow deep-research
  • Check README/ROADMAP counts are accurate (21 commands, 16 skills, 13 workflows)

5uck1ess added 3 commits April 5, 2026 11:12
Two-tier research system:
- research (upgraded): query decomposition with explicit goals, iterative
  summarization to prevent context overflow, source corroboration tracking
  (CONFIRMED/UNCORROBORATED/CONTESTED), follow-up on gaps
- deep-research (new): Analysis of Competing Hypotheses pipeline —
  perspective discovery, directed disconfirmation, evidence matrix scoring
  by fewest inconsistencies, sensitivity analysis, self-critique pass

Based on research into OpenAI Deep Research, Perplexity, Stanford STORM,
gpt-researcher, and Anthropic's multi-agent research system.
Add explicit NOT clause to research skill description so "deep research"
and "validate" requests route to deep-research, not research.
Caught by Claude reviewer in tri-review of PR #18.
…tree, fix hook count

- Remove deep-research from Coding Principles table (it's an auto-trigger
  workflow, not a coding principle — already in the correct table above)
- Add scratchpad/SKILL.md to repo structure tree (was missing)
- Fix ROADMAP hook consolidation count: 9 → 10 (stale from before PR #17)

Caught by PR review toolkit (code-reviewer + comment-analyzer).
@5uck1ess
5uck1ess merged commit 97a1a44 into main Apr 5, 2026
1 check passed
@5uck1ess
5uck1ess deleted the feat/deep-research branch April 5, 2026 16:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant