Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .github/workflows/validate.yml
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,13 @@ jobs:
pip install ruff==0.15.1
ruff check .

# tests/test_report_export.py and test_mermaid_figures.py exercise build_report's
# error handling, which only gets reached once pandoc exists — without it every one
# of them dies on "pandoc не найден" and the export path goes unverified. They
# passed on the author's Mac and had never run here.
- name: Install pandoc (report export tests)
run: sudo apt-get update -qq && sudo apt-get install -y -qq pandoc

- name: Run unit tests
run: python -m pytest tests/ -q

Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Need a stat sources file for an industry not covered (e.g., aerospace, mining, f

### 2-4 hours — Add a new report block

The block library has <!--gen:count:blocks-->105<!--/gen--> blocks but specific use cases might need more.
The block library has <!--gen:count:blocks-->106<!--/gen--> blocks but specific use cases might need more.

**Example:** You want a `decision-tree` block in `compare.md`.

Expand Down
4 changes: 2 additions & 2 deletions QUICKSTART.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ can audit.

## Next steps

- Full methodology: [`SKILL.md`](SKILL.md) — the <!--gen:count:phases-->12<!--/gen-->-phase workflow.
- The catalog: [`references/`](references/) — <!--gen:count:blocks-->105<!--/gen--> report
- Full methodology: [`SKILL.md`](SKILL.md) — the <!--gen:count:phases-->13<!--/gen-->-phase workflow.
- The catalog: [`references/`](references/) — <!--gen:count:blocks-->106<!--/gen--> report
blocks, <!--gen:count:genres-->6<!--/gen--> genres.
- Want to add sources or APIs? [`CONTRIBUTING.md`](CONTRIBUTING.md).
23 changes: 12 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Claude: ✓ Reframed your question (3 hypotheses) + decision spec: what you'll

## What this is

A [Claude Code skill](https://docs.anthropic.com/claude/docs/skills) that turns **"research this topic"** into a **<!--gen:count:phases-->12<!--/gen-->-phase pipeline** with hypothesis testing, parallel sub-agent search, source triangulation, and adversarial review.
A [Claude Code skill](https://docs.anthropic.com/claude/docs/skills) that turns **"research this topic"** into a **<!--gen:count:phases-->13<!--/gen-->-phase pipeline** with hypothesis testing, parallel sub-agent search, source triangulation, and adversarial review.

The output is a folder you can return to in a month. Every claim traces to a specific source file. The plan documents *why* you made every choice. No re-research needed.

Expand Down Expand Up @@ -122,7 +122,7 @@ zip -r ../deepdive.skill . -x ".*" -x "*.zip"
<details>
<summary><b>For other LLMs (Codex, Gemini, local)</b></summary>

The <!--gen:count:phases-->12<!--/gen-->-phase methodology is portable. Load `SKILL.md` + `references/*.md` into the LLM's context manually. Skip the sub-agent parts and use separate chat sessions per subtopic.
The <!--gen:count:phases-->13<!--/gen-->-phase methodology is portable. Load `SKILL.md` + `references/*.md` into the LLM's context manually. Skip the sub-agent parts and use separate chat sessions per subtopic.

[Full instructions →](#use-with-other-llms-codex-gemini-etc)

Expand All @@ -132,7 +132,7 @@ The <!--gen:count:phases-->12<!--/gen-->-phase methodology is portable. Load `SK

## How it works

The skill runs **<!--gen:count:phases-->12<!--/gen--> phases** in order:
The skill runs **<!--gen:count:phases-->13<!--/gen--> phases** in order:

| Phase | Name | What happens |
|:---:|:---|:---|
Expand All @@ -145,6 +145,7 @@ The skill runs **<!--gen:count:phases-->12<!--/gen--> phases** in order:
| **4** | **Search** | sonnet / medium |
| **5** | **Claims-ledger + triangulation** | haiku / low |
| **5.5** | **Evidence filter** | sonnet / low |
| **5.7** | **Wiki reconcile** | sonnet / low |
| **6** | **Synthesis + multi-angle red team** | opus / high |
| **6.5** | **Verify** | haiku / low |
| **7** | **Refresh targets** | sonnet / medium |
Expand Down Expand Up @@ -188,7 +189,7 @@ Want to compare models head-to-head? The [eval harness](eval/README.md) scores a
<tr>
<td width="33%" valign="top">

### <!--gen:count:blocks-->105<!--/gen--> Report Blocks
### <!--gen:count:blocks-->106<!--/gen--> Report Blocks

10 categories: **FRAME** · **EXPLAIN** · **COMPARE** · **MAP** · **VALIDATE** · **ANALYZE** · **CLOSE** · **PEOPLE** · **NUMBERS** · **CONTEXT**

Expand Down Expand Up @@ -460,9 +461,9 @@ The file-per-source structure is the key **reuse** mechanism. A single research

It's **structured methodology + curated catalog + reusable templates + automation**.

- The <!--gen:count:phases-->12<!--/gen-->-phase workflow forces discipline
- The <!--gen:count:phases-->13<!--/gen-->-phase workflow forces discipline
- <!--gen:count:stat_sources-->460<!--/gen-->+ stat sources catalog is curated knowledge
- <!--gen:count:blocks-->105<!--/gen--> reusable blocks compose any report shape
- <!--gen:count:blocks-->106<!--/gen--> reusable blocks compose any report shape
- `scripts/validate_phases.py` machine-checks phase completeness, not just style
- A decision spec + mandatory walkthrough (phase 8) ties every research to an actual action, not just a document
- Weekly auto-validation keeps the catalog alive
Expand Down Expand Up @@ -500,8 +501,8 @@ The methodology is portable. ~70% of content is LLM-agnostic markdown templates.
|:---|:---:|:---:|
| `SKILL.md` frontmatter | ✓ | — |
| Sub-agent `Explore` type | ✓ | — |
| <!--gen:count:phases-->12<!--/gen-->-phase workflow | — | ✓ |
| <!--gen:count:blocks-->105<!--/gen--> report blocks | — | ✓ |
| <!--gen:count:phases-->13<!--/gen-->-phase workflow | — | ✓ |
| <!--gen:count:blocks-->106<!--/gen--> report blocks | — | ✓ |
| <!--gen:count:channels-->29<!--/gen--> search channels | — | ✓ |
| <!--gen:count:stat_sources-->460<!--/gen-->+ stat sources | — | ✓ |

Expand All @@ -526,13 +527,13 @@ The methodology is portable. ~70% of content is LLM-agnostic markdown templates.
<details>
<summary><h2>На русском</h2></summary>

**Deepdive** — скилл для [Claude Code](https://claude.com/claude-code), превращающий «загугли это» в дисциплинированный <!--gen:count:phases-->12<!--/gen-->-фазный процесс.
**Deepdive** — скилл для [Claude Code](https://claude.com/claude-code), превращающий «загугли это» в дисциплинированный <!--gen:count:phases-->13<!--/gen-->-фазный процесс.

### Что внутри

- **<!--gen:count:phases-->12<!--/gen--> фаз workflow**: <!--gen:phases:list:ru-->Reframing → Genre & block selection → Plan → Capability Discovery → Plan-review gate → Поиск → Claims-ledger + триангуляция → Evidence-фильтр → Синтез + multi-angle red team → Verify → Refresh targets → Decision walkthrough<!--/gen-->
- **<!--gen:count:phases-->13<!--/gen--> фаз workflow**: <!--gen:phases:list:ru-->Reframing → Genre & block selection → Plan → Capability Discovery → Plan-review gate → Поиск → Claims-ledger + триангуляция → Evidence-фильтр → Сверка с вики → Синтез + multi-angle red team → Verify → Refresh targets → Decision walkthrough<!--/gen-->
- **<!--gen:count:genres-->6<!--/gen--> жанров отчёта**: qa / explainer / decision / landscape / validation / custom
- **<!--gen:count:blocks-->105<!--/gen--> блоков** в 10 категориях — переиспользуемые секции с шаблонами и анти-паттернами
- **<!--gen:count:blocks-->106<!--/gen--> блоков** в 10 категориях — переиспользуемые секции с шаблонами и анти-паттернами
- **<!--gen:count:channels-->29<!--/gen--> каналов поиска** с paywall fallback протоколом (включая api-direct)
- **<!--gen:count:stat_sources-->460<!--/gen-->+ статистических источников** в 14 cross-industry + 19 отраслевых категориях
- **<!--gen:count:api-->47<!--/gen-->+ API endpoints** для programmatic доступа (free no-auth приоритетны)
Expand Down
Loading
Loading