feat: claims.csv, gap-волна, диапазоны источников, блоки F9/Z12

CONTRIBUTING.md

@@ -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-->103<!--/gen--> blocks but specific use cases might need more.
+The block library has <!--gen:count:blocks-->105<!--/gen--> blocks but specific use cases might need more.
 
 **Example:** You want a `decision-tree` block in `compare.md`.
 

QUICKSTART.md

@@ -47,6 +47,6 @@ can audit.
 ## Next steps
 
 - Full methodology: [`SKILL.md`](SKILL.md) — the <!--gen:count:phases-->9<!--/gen-->-phase workflow.
-- The catalog: [`references/`](references/) — <!--gen:count:blocks-->103<!--/gen--> report
+- The catalog: [`references/`](references/) — <!--gen:count:blocks-->105<!--/gen--> report
   blocks, <!--gen:count:genres-->6<!--/gen--> genres.
 - Want to add sources or APIs? [`CONTRIBUTING.md`](CONTRIBUTING.md).

README.md

@@ -141,7 +141,7 @@ The skill runs **<!--gen:count:phases-->9<!--/gen--> phases** in order:
 | **3** | **Plan** | opus / medium |
 | **3.5** | **Capability Discovery** | sonnet / low |
 | **4** | **Search** | sonnet / medium |
-| **5** | **Scoring + triangulation** | sonnet / medium |
+| **5** | **Claims-ledger + triangulation** | haiku / low |
 | **6** | **Synthesis + multi-angle red team** | opus / high |
 | **6.5** | **Verify** | haiku / low |
 | **7** | **Refresh targets** | sonnet / medium |<!--/gen-->
@@ -158,7 +158,7 @@ Every phase is **transparent**: you see what's happening, you confirm key decisi
 <tr>
 <td width="33%" valign="top">
 
-### <!--gen:count:blocks-->103<!--/gen--> Report Blocks
+### <!--gen:count:blocks-->105<!--/gen--> Report Blocks
 
 10 categories: **FRAME** · **EXPLAIN** · **COMPARE** · **MAP** · **VALIDATE** · **ANALYZE** · **CLOSE** · **PEOPLE** · **NUMBERS** · **CONTEXT**
 
@@ -391,7 +391,7 @@ It's **structured methodology + curated catalog + reusable templates + automatio
 
 - The <!--gen:count:phases-->9<!--/gen-->-phase workflow forces discipline
 - <!--gen:count:stat_sources-->460<!--/gen-->+ stat sources catalog is curated knowledge
-- <!--gen:count:blocks-->103<!--/gen--> reusable blocks compose any report shape
+- <!--gen:count:blocks-->105<!--/gen--> reusable blocks compose any report shape
 - Weekly auto-validation keeps the catalog alive
 - 25+ upstream awesome-lists give infinite discovery layer
 
@@ -417,7 +417,7 @@ The methodology is portable. ~70% of content is LLM-agnostic markdown templates.
 | `SKILL.md` frontmatter | ✓ | — |
 | Sub-agent `Explore` type | ✓ | — |
 | <!--gen:count:phases-->9<!--/gen-->-phase workflow | — | ✓ |
-| <!--gen:count:blocks-->103<!--/gen--> report blocks | — | ✓ |
+| <!--gen:count:blocks-->105<!--/gen--> report blocks | — | ✓ |
 | <!--gen:count:channels-->29<!--/gen--> search channels | — | ✓ |
 | <!--gen:count:stat_sources-->460<!--/gen-->+ stat sources | — | ✓ |
 
@@ -446,9 +446,9 @@ The methodology is portable. ~70% of content is LLM-agnostic markdown templates.
 
 ### Что внутри
 
-- **<!--gen:count:phases-->9<!--/gen--> фаз workflow**: <!--gen:phases:list:ru-->Reframing → Genre & block selection → Plan → Capability Discovery → Поиск → Скоринг + триангуляция → Синтез + multi-angle red team → Verify → Refresh targets<!--/gen-->
+- **<!--gen:count:phases-->9<!--/gen--> фаз workflow**: <!--gen:phases:list:ru-->Reframing → Genre & block selection → Plan → Capability Discovery → Поиск → Claims-ledger + триангуляция → Синтез + multi-angle red team → Verify → Refresh targets<!--/gen-->
 - **<!--gen:count:genres-->6<!--/gen--> жанров отчёта**: qa / explainer / decision / landscape / validation / custom
-- **<!--gen:count:blocks-->103<!--/gen--> блоков** в 10 категориях — переиспользуемые секции с шаблонами и анти-паттернами
+- **<!--gen:count:blocks-->105<!--/gen--> блоков** в 10 категориях — переиспользуемые секции с шаблонами и анти-паттернами
 - **<!--gen:count:channels-->29<!--/gen--> каналов поиска** с paywall fallback протоколом (включая api-direct)
 - **<!--gen:count:stat_sources-->460<!--/gen-->+ статистических источников** в 14 cross-industry + 19 отраслевых категориях
 - **<!--gen:count:api-->39<!--/gen-->+ API endpoints** для programmatic доступа (free no-auth приоритетны)

SKILL.md

@@ -112,8 +112,8 @@ Estimated ~$2 (vs ~$8 если бы всё на Opus). Скажи если ну
 2. **Genre & block selection** [`sonnet`/medium] — определить жанр отчёта (qa/explainer/decision/landscape/validation/custom) и набор блоков. Подтвердить пользователю одной строкой. См. `references/genres.md` и `references/blocks/INDEX.md`.
 3. **Plan** [`opus`/medium] — записать `plan.md` (5 секций: HEADER → SCOPE → STRUCTURE → EXECUTION → TRACKING). Включает: user context, time-box, acceptance criteria, discovered existing, glossary, жанр + blocks + rationale, гипотезы, risk register, subtopic↔blocks mapping, information sourcing strategy (каналы + stat-источники + API endpoints), opposition queries, stop-criteria, notes для tracking. См. `workflow.md` → Фаза 3 для полного шаблона.
 3.5. **Capability Discovery** [`sonnet`/low] (опциональная для shallow, рекомендуется для medium, обязательна для deep) — audit env vars для API ключей, map подтемы → доступные APIs, fallback на upstream awesome-lists для unknown gaps, сводный отчёт пользователю. См. `references/capability_discovery.md`.
-4. **Поиск** [main `sonnet`/medium; sub-agents per-task: `haiku` для web/api, `sonnet` для academic/long-source, `opus` для heavy reasoning subtask] — 4 шага: (4.0) **Source Dispatch** — прогнать каждый подвопрос через `source_dispatch.md` matrix, заполнить plan.md секцию 12 с per-subquestion primary/secondary/fallback каналами. (4.1) Launch — для medium/deep: суб-агенты `subagent_type=Explore` в параллель с `model:` параметром из `model_routing.md`, для shallow: главный поток сам. (4.2) Fetch & dedup. (4.3) Save в `sources/NN_slug.md`. Loop: после каждого раунда оркестратор может потратить bounded deviation — включая trajectory-чек промежуточных claims (не плодить поиск на неподтверждённом тезисе) и динамическую ревизию outline (ScaffoldAgent). См. `references/source_dispatch.md`, `references/subagents_v2.md`, `references/workflow.md` → Фаза 4.
-5. **Скоринг + триангуляция** [scoring `haiku`/low; triangulation `sonnet`/medium] — каждый источник оценить по 3 осям (Credibility/Recency/Bias). Каждый тезис в выводах — ≥3 независимых источника разного типа. См. `references/source_scoring.md`.
+4. **Поиск** [main `sonnet`/medium; sub-agents per-task: `haiku` для web/api, `sonnet` для academic/long-source, `opus` для heavy reasoning subtask] — 4 шага: (4.0) **Source Dispatch** — прогнать каждый подвопрос через `source_dispatch.md` matrix, заполнить plan.md секцию 12. (4.1) Launch — для medium/deep: суб-агенты `subagent_type=general-purpose` (нужен Write) в параллель, каждому свой диапазон номеров источников (`s01-s09`, `s10-s19`, ...); для shallow — главный поток сам. (4.2) Fetch & dedup. (4.3) Save в `sources/NN_slug.md` — пишет сам агент, в главный поток возвращаются только index-строки. Loop: bounded deviation между раундами (trajectory-чек claims, ревизия outline). См. `references/source_dispatch.md`, `references/subagents_v2.md`, `references/workflow.md` → Фаза 4.
+5. **Claims-ledger + триангуляция** [`haiku`/low] — из index-строк собирается `claims.csv` (claim_id, sources, status, confidence, primary_source). Механическая триангуляция: ≥3 источника И ≥2 типа → `triangulated`; primary-first — confidence не выше `medium` без primary-источника. Loop: gap-волна на строки не-triangulated, максимум 2 круга, иначе `data-insufficient`. См. `references/source_scoring.md` и `references/workflow.md` → Фаза 5.
 6. **Синтез + multi-angle red team** [red-team суб-агенты `opus`/high **обязательно** для deep, `sonnet`/high для medium; synthesis `sonnet`/high] — собрать `<date>_<genre>.md` из блоков, затем: draft → claim ledger → N параллельных враждебных ролей (Skeptic / Contrarian / Gap-hunter) как `general-purpose` суб-агенты → триаж по severity → ОДИН раунд ремедиации HIGH (точечный до-поиск или caveat) → финал. Finder ≠ fixer. Гейт: shallow=R1 инлайн, medium=R1+R2, deep=R1+R2+R3 обязательно. См. `references/adversarial_pass.md` и `references/blocks/`.
 6.5. **Verify** [`haiku`/low] (medium/deep — обязательно) — runtime-проверка цитат по двум осям: (1) **liveness** — ссылка жива (`check_citations.py`); (2) **faithfulness** — источник реально подтверждает тезис (entailment claim ⊨ цитата из `sources/NN.md`). Битые/неподтверждающие источники чинятся (re-search), смягчаются (overclaim → слабее) или тезис уходит в Open Questions. Отчёт получает verification-header и не «готов» без него. Per-source verification — defensible-фича против закрытых DR-продуктов. См. `references/runtime_verification.md`.
 7. **Refresh targets** [`sonnet`/medium] (medium/deep — обязательно) — извлечь entities/numbers/hypotheses/topic-markers из финального отчёта в `refresh_targets.md`. Это точка входа для будущих `update <slug>` — без неё каждый update тратит время на re-discovery «что отслеживать». См. блок Z11 в `references/blocks/close.md` и `references/refresh_protocol.md`.
@@ -145,6 +145,7 @@ Estimated ~$2 (vs ~$8 если бы всё на Opus). Скажи если ну
 <slug>/
 ├── plan.md                          # Фаза 3 — план + changelog (секция 16) + notes (секция 15)
 ├── sources.csv                      # индекс всех источников с оценками
+├── claims.csv                       # Фаза 5 — claim-ledger (claim/sources/status/confidence)
 ├── sources/                         # один файл = один источник (с метаданными + цитаты)
 │   ├── 01_<short-slug>.md
 │   ├── 02_<short-slug>.md
@@ -171,6 +172,7 @@ Estimated ~$2 (vs ~$8 если бы всё на Opus). Скажи если ну
 
 **Шаблоны:**
 - `sources/NN.md` — см. `references/source_scoring.md`
+- `claims.csv` — claim-ledger, см. `references/source_scoring.md` (раздел «Claims-ledger»)
 - `<date>_<genre>.md` — собирается из блоков, см. `references/genres.md` (пресеты) и `references/blocks/` (шаблоны блоков)
 - `findings/FN.md` — атомарный тезис, см. `references/blocks/close.md` (блок Z6)
 
@@ -197,7 +199,8 @@ Estimated ~$2 (vs ~$8 если бы всё на Opus). Скажи если ну
 - Не обходить ограничения WebFetch через bash/curl.
 - Не использовать источники с total < 8 как основу для выводов.
 - Не пропускать multi-angle red team в medium/deep.
-- Не использовать `subagent_type=general-purpose` если хватает `Explore` (Explore быстрее и read-only). Исключение — Фаза 6 red team: роли судят, а не ищут → `general-purpose`.
+- Для fetch+save (Фаза 4.1) и red team (Фаза 6) — `general-purpose` с явным диапазоном номеров, не `Explore` (read-only, только для разведки).
+- Не пропускать gap-волну (нетриангулированные строки `claims.csv`, max 2 круга) и не давать confidence выше `medium` без primary-источника.
 - Не оставлять «висящие» утверждения без ссылки на конкретный `sources/NN.md`.
 - Не запускать суб-агентов последовательно — только параллельно в одном сообщении.
 - Не сжимать sources/ в один файл — теряется поиск и переиспользование между ресёрчами.
@@ -219,7 +222,7 @@ URL-friendly: латиница, цифры, дефисы. Пример:
 - `references/workflow.md` — детали <!--gen:count:phases-->9<!--/gen--> фаз (включая опц. 3.5) (читать в начале medium/deep).
 - `references/question_reframing.md` — шаблоны Фазы 1.
 - `references/genres.md` — пресеты блоков <!--gen:count:genres-->6<!--/gen--> жанров + эвристика выбора (Фаза 2) + каналы по жанрам.
-- `references/blocks/INDEX.md` — индекс <!--gen:count:blocks-->103<!--/gen--> блоков по 10 категориям (после выбора жанра).
+- `references/blocks/INDEX.md` — индекс <!--gen:count:blocks-->105<!--/gen--> блоков по 10 категориям (после выбора жанра).
 - `references/channels.md` — <!--gen:count:channels-->29<!--/gen--> каналов поиска (включая api-direct) с query patterns, paywall fallbacks (Фаза 3-4).
 - `references/stat_sources/INDEX.md` — навигационная карта 33 категорий статистических источников (Фаза 3-4).
 - `references/api_sources/INDEX.md` — каталог <!--gen:count:api-->39<!--/gen-->+ API endpoints (10 категорий) для programmatic доступа (Фаза 3-4).
@@ -230,19 +233,19 @@ URL-friendly: латиница, цифры, дефисы. Пример:
 - `references/refresh_protocol.md` — **протокол update**: 4 категории дельты (new entrants, entity diff, numbers refresh, adversarial trigger), шаблон `diffs/<date>_delta.md`. Используется в режиме `update <slug>`. Дополняется блоком Z11 `refresh-targets` из `blocks/close.md`.
 
 **Категорийные файлы (только нужные для выбранного жанра/blocks):**
-- `references/blocks/frame.md` — F1-F8: TL;DR, scope, claim, metadata.
+- `references/blocks/frame.md` — F1-F10: TL;DR, scope, background, claim, metadata, verification header.
 - `references/blocks/explain.md` — E1-E14: mental-model, glossary, mechanism.
 - `references/blocks/compare.md` — C1-C13: matrices, scoring, trade-offs.
 - `references/blocks/map.md` — M1-M12: profiles, positioning, trends.
 - `references/blocks/validate.md` — V1-V10: falsification, evidence grades.
 - `references/blocks/analyze.md` — A1-A13: data tables, SWOT, root cause.
-- `references/blocks/close.md` — Z1-Z10: counter-args, open Q, next research.
+- `references/blocks/close.md` — Z1-Z12: counter-args, open Q, next research, so-what-for-you.
 - `references/blocks/people.md` — P1-P7: persona, journey, incentives.
 - `references/blocks/numbers.md` — N1-N8: metrics, market sizing, forecasts.
 - `references/blocks/context.md` — X1-X7: regulatory, geo, culture.
 
 **По фазам:**
-- `references/source_scoring.md` — оценка источников + шаблон `sources/NN.md` с `channel:` и `access:` (Фаза 5).
+- `references/source_scoring.md` — оценка источников + шаблон `sources/NN.md` с `channel:` и `access:`; claims-ledger (`claims.csv`) и правило primary-first (Фаза 5).
 - `references/subagents_v2.md` — паттерн суб-агентов с CHANNELS TO USE (Фаза 4, medium/deep).
 - `references/adversarial_pass.md` — multi-angle red team: роли, триаж severity, ограниченный цикл ремедиации (Фаза 6, medium/deep).
 - `references/runtime_verification.md` — runtime-проверка цитат: резолв тезисов к sources/NN.md, verification-header (Фаза 6.5, medium/deep).

docs/_config.yml

@@ -3,7 +3,7 @@
 # or by GitHub Pages for the docs/ folder.
 
 title: Deep Research
-description: A structured <!--gen:count:phases-->9<!--/gen-->-phase meta-research skill for Claude Code. <!--gen:count:channels-->29<!--/gen--> channels, <!--gen:count:stat_sources-->460<!--/gen-->+ stat sources, <!--gen:count:blocks-->103<!--/gen--> report blocks.
+description: A structured <!--gen:count:phases-->9<!--/gen-->-phase meta-research skill for Claude Code. <!--gen:count:channels-->29<!--/gen--> channels, <!--gen:count:stat_sources-->460<!--/gen-->+ stat sources, <!--gen:count:blocks-->105<!--/gen--> report blocks.
 url: https://socialpranker.github.io
 baseurl: /claude-deep-research