strategic-extensions-methodology.md
May 15, 2026 ยท View on GitHub
๐ Strategic Extensions Methodology
๐ Family C โ Depth Layer for High-Significance Events
๐ฏ Scenario Analysis ยท Comparative International ยท Devil's Advocate (ACH) ยท Intelligence Assessment ยท Methodology Reflection
๐ Document Owner: CEO | ๐ Version: 1.4 | ๐ Last Updated: 2026-05-15 (UTC) ๐ Review Cycle: Quarterly | โฐ Next Review: 2026-07-21 ๐ข Owner: Hack23 AB (Org.nr 5595347807) | ๐ท๏ธ Classification: Public
๐ฏ AI-FIRST Methodology Card
๐ฆ Read this card before writing a single paragraph. It names the artifact this methodology owns, the gate check it satisfies, the evidence-density target it must hit, and the Pass-1 / Pass-2 discipline required by
.github/copilot-instructions.mdยง5 (AI-FIRST Quality Principle).
| Field | Value |
|---|---|
| Purpose | Family C โ step-by-step production of the 5 strategic-extension artifacts (scenarios, comparative international, ACH devil's advocate, intelligence assessment, methodology reflection). |
| Inputs | Family A synthesis + SWOT + risk + threat; OSINT tradecraft standards; reference-quality-thresholds for the article type |
| Outputs | scenario-analysis.md, comparative-international.md, devils-advocate.md, intelligence-assessment.md, methodology-reflection.md |
| Owning artifact(s) | All 5 Family C artifacts |
| Owning gate check | Check 7 (Family C structure: โฅ 3 scenarios, โฅ 3 KJs with confidence, โฅ 3 ACH hypotheses, ICD 203 audit marker) |
| Citation density target | โฅ 1 evidence anchor per scenario/hypothesis/KJ; โฅ 2 cycle-aged sources per year/cycle horizon claim |
| Banned phrases | Enforced via political-style-guide.md ยงMachine-readable banned-phrase list |
| Threshold source | reference-quality-thresholds.json โ thresholds[articleType][artifact] (fallback defaults.coreArtifactFloor) |
โ Pass-1 checklist (creation โ minimal viable artifact)
- โฅ 3 distinct scenarios with WEP probability and total โค 100%
- โฅ 3 ACH competing hypotheses with explicit consistent/inconsistent/N-A scoring per evidence row
- โฅ 3 Key Judgments each with VERY HIGH/HIGH/MEDIUM/LOW/VERY LOW confidence and โฅ 1 PIR reference
-
methodology-reflection.mdcontains an ICD 203 audit marker or โฅ 3 named methodology improvements - Produce every required sub-section listed in the owning template
- Add โฅ 1 evidence anchor (
dok_id, vote id, named MP, or primary-source URL) per analytical claim - Apply the correct WEP confidence band for the run's horizon (
72h / week / month / quarter / year / cycle) - Include โฅ 1 themed Mermaid diagram with
style โฆorthemeVariablesconfig (where structurally meaningful) - Cross-link the relevant template under
analysis/templates/and the gate check it satisfies
๐ Pass-2 checklist (read-back & improve โ AI-FIRST mandatory)
- Add โฅ 1 wildcard / black-swan to scenario-analysis where horizon โฅ
year - Verify comparator set covers โฅ 2 peer countries with named indicators (IMF / SCB / WB)
- Read back devils-advocate: each hypothesis must survive at least one elimination test
- Re-read the file end-to-end; flag every claim that lacks an evidence anchor and add one
- Replace every banned phrase listed in
political-style-guide.mdยงMachine-readable banned-phrase list with an evidence-anchored alternative - Tighten WEP language: never above likely without โฅ 3 cycle-aged sources for
year/cyclehorizons - Strengthen Mermaid (color-coded
style โฆdirectives,themeVariables, โฅ 5 nodes where the structure admits it) - Add โฅ 1 second-order effect, cui-bono note, or counterfactual where the artifact admits one
- Verify citation density meets the per-file target below and the gate's evidence-density rules
๐ข Exemplar (good โ pattern-match this)
(scenario row) "Scenario B โ Tidรถ coalition holds (likely, ~70 %): M+KD+L+SD pass H902FiU1 budget; precedent: 2024 budget vote (cf. H801FiU1, 175โ174). Wildcard: SD walkout if migration deal slips (~10 %). Sources:
dok_idH902FiU1, statskontoret.se freshness 2026-04-22."
๐ด Anti-exemplar (failure mode โ never ship this)
(failure mode) "Several scenarios are possible. The coalition might hold or might not. Experts believe the situation is fluid." โ < 3 scenarios, no probabilities, banned phrases, no
dok_id.
๐ Cross-links
- Template(s):
analysis/templates/scenario-analysis.md,analysis/templates/comparative-international.md,analysis/templates/devils-advocate.md,analysis/templates/intelligence-assessment.md,analysis/templates/methodology-reflection.md - Gate check:
.github/prompts/05-analysis-gate.md - AI-FIRST canon:
.github/copilot-instructions.mdยง5 ยทai-driven-analysis-guide.md - Style canon:
political-style-guide.mdยทosint-tradecraft-standards.md - Catalog row:
artifact-catalog.md
๐ Tradecraft Anchors
| Element | Value | Reference |
|---|---|---|
| F3EAD Stage | ANALYZE | This methodology covers deep analytical processing โ competing hypotheses, alternative futures, cross-country comparison |
| PIRs Served | Per-file: intelligence-assessment.md declares served PIRs; devils-advocate challenges PIR-relevant hypotheses; comparative-international benchmarks PIR-4 (Defence), PIR-5 (Fiscal) | See political-style-guide.md ยงPIR/EEI Catalog |
| Admiralty Floor | devils-advocate.md requires โฅ[B2] evidence per hypothesis; intelligence-assessment.md Key Judgments require โฅ[A1] or โฅ2ร[B2] | See political-style-guide.md ยงAdmiralty Code |
| WEP Requirement | scenario-analysis.md probabilities in WEP language; intelligence-assessment.md Key Judgments with WEP + ODNI confidence | See political-style-guide.md ยงWEP + ODNI |
| ICD 203 Gate | Standard 2 (uncertainties), 3 (judgments vs assumptions), 4 (alternative analysis), 7 (explain changes) | See political-style-guide.md ยงICD 203 |
| SAT(s) | ACH, Red Team, Devil's Advocacy (devils-advocate.md); What If?, Morphological (scenario-analysis.md); Outside-In Thinking (comparative-international.md); Key Assumptions Check, Quality of Information Check (methodology-reflection.md) | See political-style-guide.md ยงSATs |
๐ฏ Purpose
Family C delivers analytic depth when the daily event set warrants it. Where Family A narrates what happened, Family C answers:
- What could happen next? (scenario-analysis)
- How does this compare internationally? (comparative-international)
- What are we getting wrong? (devils-advocate โ ACH)
- What does this mean at the intelligence level? (intelligence-assessment)
- Was our process sound? (methodology-reflection)
Core โ every run produces all 5
Family C files are always produced on every workflow run. They are not trigger-driven. Depth per file adapts to the day's DIW distribution, but the output set is stable: every folder ships scenario-analysis.md, comparative-international.md, devils-advocate.md, intelligence-assessment.md, and methodology-reflection.md.
๐งญ Family C is exactly 5 files โ not 6.
executive-brief.mdis Family A (synthesis layer), not Family C. If a downstream document or README enumerates 6 Family C files includingexecutive-brief.md, that document is stale โ the canonical inventory isartifact-catalog.mdยง"Family C โ Strategic Extensions (5 artifacts)".methodology-reflection.mdbelongs to Family C even though its production order (Step 5, after the other four) and its self-audit role make it feel meta โ the gate at05-analysis-gate.mdcheck 7 enforces this exact 5-file structure.
| File | Behaviour on a light news day | Behaviour on a P0-dense day |
|---|---|---|
scenario-analysis.md | Three scenarios converge on a narrow-band consensus; file documents why branching is low | Three divergent scenarios with probability-weighted indicators |
comparative-international.md | Compares baseline Swedish position to โฅ5 Nordic + EU peers | Peer-country reform response with deep causal analysis |
devils-advocate.md | ACH on the day's #1 ranked document with โฅ3 competing hypotheses | Full ACH on every P0 + red-team hypothesis + Bayesian base-rate check |
intelligence-assessment.md | 3 Key Judgments tied to PIRs for the next 72 h | 5โ7 Key Judgments with confidence + warning indicators + HUMINT/OSINT cross-checks |
โญ methodology-reflection.md | Vital run-audit gate. Evidence sufficiency, confidence distribution, source diversity, party-neutrality arithmetic, โฅ3 concrete methodology improvements for the next cycle | Same structure; skipping the file breaks the self-correction loop and fails the quality gate |
โญ
methodology-reflection.mdis vital. It is the only file that audits the run itself. Treat a missing or stubmethodology-reflection.mdas a broken workflow and revise before commit. The Pass-2 rewrite in the AI-Driven Guide Step 7 reads this file before revising every other file.
flowchart LR
classDef famA fill:#E8F5E9,stroke:#4CAF50,color:#1B5E20
classDef scenario fill:#E3F2FD,stroke:#1565C0,color:#0D47A1
classDef ach fill:#FFEBEE,stroke:#D32F2F,color:#B71C1C
classDef intl fill:#FFF8E1,stroke:#FFC107,color:#3E2723
classDef intel fill:#F3E5F5,stroke:#7B1FA2,color:#311B92
classDef reflect fill:#FFF3E0,stroke:#FF9800,color:#BF360C,stroke-width:3px
A[Family A<br/>synthesis + impact]:::famA
C1[scenario-analysis.md<br/>๐ฎ plausible futures]:::scenario
C2[comparative-international.md<br/>๐ EU/Nordic parallels]:::intl
C3[devils-advocate.md<br/>โ๏ธ ACH + Red Team]:::ach
C4[intelligence-assessment.md<br/>๐ฏ strategic bottom line]:::intel
C5[โญ methodology-reflection.md<br/>๐ฌ VITAL run-audit gate]:::reflect
A --> C1
A --> C2
A --> C3
C1 --> C4
C3 --> C4
C2 --> C4
C4 --> C5
๐ฎ Part 1 โ Scenario Analysis (scenario-analysis.md)
Purpose
Explore โฅ3 plausible forward paths for the top P0/P1 items over a 30โ180 day horizon, each evidenced and each with pre-declared indicators so analysts can track which path materialises.
Input
- significance-scoring.md (which items to scenario)
- synthesis-summary.md (current narrative baseline)
- stakeholder-perspectives.md (actor positions that drive branching)
- Historical baseline (Family D
historical-parallels.mdwhen available)
Output โ required structure
- Baseline (expected) โ the path implied by current stated positions + prior revealed preferences
- Upside โ a plausible path more favourable to democratic accountability / institutional strength
- Downside โ a plausible path more hostile to the status quo
- Wildcard โ low-probability / high-impact branch (โค10 % probability)
- For each scenario:
- Narrative (โค120 words)
- Triggering events (โฅ3 concrete, each with a source or dated leading indicator)
- Blocking events (what would make this scenario fail)
- Probability (with 5-level confidence label)
- Consequence summary (actor-by-actor, institution-by-institution)
- Early-warning indicators (observable within 14 days)
- Scenario-probability Mermaid โ color-coded probability bar
- Branching decision Mermaid โ color-coded flowchart of key forks
- Cross-scenario comparison table โ impact ร probability ร reversibility
Required Mermaid โ branching paths
flowchart TD
classDef base fill:#9E9E9E,stroke:#424242,color:#FFFFFF
classDef upside fill:#4CAF50,stroke:#1B5E20,color:#FFFFFF
classDef downside fill:#FF9800,stroke:#E65100,color:#FFFFFF
classDef wild fill:#D32F2F,stroke:#B71C1C,color:#FFFFFF
classDef fork fill:#FFC107,stroke:#F57F17,color:#3E2723
T0[Today โ P0 document filed]:::base
F1{Fork 1<br/>committee vote โค14d}:::fork
F2{Fork 2<br/>opposition cohesion}:::fork
S_base[Baseline<br/>orderly passage ยท 55 %]:::base
S_up[Upside<br/>compromise amendment ยท 20 %]:::upside
S_down[Downside<br/>coalition fracture ยท 20 %]:::downside
S_wild[Wildcard<br/>snap extra utskott ยท 5 %]:::wild
T0 --> F1
F1 -->|pass| F2
F1 -->|block| S_down
F2 -->|unified| S_base
F2 -->|split| S_up
F1 -->|escalation| S_wild
Quality gate
- Probabilities sum to 100 %
- Each scenario has โฅ3 named triggering events with sources
- Each scenario has โฅ2 early-warning indicators with ISO dates
- Wildcard probability โค10 %
- Blocking events named and sourced
- Cross-scenario table present
๐ Part 2 โ Comparative International (comparative-international.md)
Filename variant: international-comparative.md โ identical structure.
Purpose
Place the Swedish political event in international context so readers understand precedent, best practice, and likely interactions with EU / Nordic / OECD peers.
Input
- synthesis-summary.md (current events)
- IMF WEO / FM / IFS / BOP / GFS_COFOG / DOTS / PCPS / MFS_IR / ER (economic context); SCB for Swedish-specific ground truth; World Bank for governance (WGI
source=75), environment, social/education participation, defence historicals, crime/justice - EU legislative database references (where EU law intersects)
- Named peer countries (default set: DK, NO, FI, DE, NL, EE for Nordic+Baltic-West benchmark)
Output โ required structure
- Issue framing โ โค80 words: what is the Swedish question being compared?
- Peer-country evidence table โ for each peer country:
- Country ยท Approach (brief) ยท Outcome (quantified) ยท Source ยท Applicability to Sweden
- Best-practice extraction โ three elements worth importing, with sources
- Incompatibility notes โ three elements that do not travel well, with reasons
- EU-law intersection โ directives, regulations, and open infringement procedures that apply
- Comparative Mermaid โ color-coded country grid on the chosen axis (e.g. policy permissiveness)
- Benchmark trend chart โ quantitative time-series Mermaid using IMF macro/fiscal data as primary economic source (WB WGI / environment / social residue may be charted only where the axis is non-economic โ governance, environment, social participation)
Required Mermaid โ peer grid
graph LR
classDef high fill:#4CAF50,stroke:#1B5E20,color:#FFFFFF
classDef med fill:#FFC107,stroke:#F57F17,color:#3E2723
classDef low fill:#FF9800,stroke:#E65100,color:#FFFFFF
classDef crit fill:#D32F2F,stroke:#B71C1C,color:#FFFFFF
classDef sv fill:#1565C0,stroke:#0D47A1,color:#FFFFFF
SE[Sweden<br/>current SE-specific score]:::sv
DK[Denmark<br/>high-strictness regime]:::high
NO[Norway<br/>medium-strictness regime]:::med
FI[Finland<br/>medium-strictness regime]:::med
DE[Germany<br/>low-strictness regime]:::low
NL[Netherlands<br/>low-strictness regime]:::low
EE[Estonia<br/>critical-outlier datapoint]:::crit
SE -.benchmark.- DK
SE -.benchmark.- NO
SE -.benchmark.- FI
SE -.benchmark.- DE
SE -.benchmark.- NL
SE -.benchmark.- EE
Quality gate
- โฅ5 peer countries included (default Nordic+Baltic-West set is acceptable)
- Every peer row has a quantified outcome and a source URL
- Applicability column distinguishes constitutional, institutional, and operational transferability
- EU-law intersection lists specific directive/regulation numbers
- Benchmark chart included when IMF economic data exists, or World Bank non-economic data exists for governance, environment, or social axes
โ๏ธ Part 3 โ Devil's Advocate (devils-advocate.md)
Purpose
Apply the Analysis of Competing Hypotheses (ACH) technique to stress-test the dominant interpretation of the day's events. Surfaces alternative explanations, red-teams the narrative, and quantifies residual uncertainty.
Input
- synthesis-summary.md (candidate narrative)
- stakeholder-perspectives.md (declared positions)
- Family B cross-reference-map.md (coordinated-activity patterns)
- Open-source intelligence (OSINT) on actor history
Output โ required structure
- Dominant hypothesis (H1) โ the synthesis's main interpretation, stated in โค40 words
- Alternative hypotheses (H2, H3, โฆ Hn, n โฅ 3) โ each a genuinely different interpretation
- Evidence matrix โ rows: observable evidence items; columns: each hypothesis; cells: Supports (+), Contradicts (โ), Ambiguous (~)
- Diagnostic value analysis โ each piece of evidence scored by how much it discriminates between hypotheses
- Residual uncertainty statement โ what would have to be true to flip the ranking
- Red-team section โ a maximally adversarial interpretation from the POV of a hostile actor
- Confidence summary โ per-hypothesis confidence label
- ACH Mermaid โ color-coded outcome network
Required Mermaid โ ACH outcome
graph TB
classDef win fill:#4CAF50,stroke:#1B5E20,color:#FFFFFF
classDef lose fill:#D32F2F,stroke:#B71C1C,color:#FFFFFF
classDef neutral fill:#9E9E9E,stroke:#424242,color:#FFFFFF
classDef red fill:#C2185B,stroke:#880E4F,color:#FFFFFF
H1[H1 โ dominant<br/>policy continuity<br/>๐ฉ HIGH confidence]:::win
H2[H2 โ alternative<br/>pre-election signalling<br/>๐ง MEDIUM]:::neutral
H3[H3 โ alternative<br/>coalition renegotiation<br/>๐ง MEDIUM]:::neutral
H4[H4 โ red-team<br/>deliberate misdirection<br/>๐ฅ LOW]:::red
H5[H5 โ rejected<br/>uncoordinated noise<br/>โฌ VERY LOW]:::lose
Evidence[Observable evidence set] --> H1
Evidence --> H2
Evidence --> H3
Evidence --> H4
Evidence --> H5
``$
### \text{ACH} \text{scoring} \text{rules} โ \text{positive}-\text{voice}
- \text{Produce} \text{an} \text{evidence} \text{matrix} \text{with} \text{at} \text{least} 5 \text{rows} \text{of} \text{diagnostic} \text{evidence}
- \text{Rank} \text{hypotheses} \text{by} \text{inconsistency} \text{score} (\text{fewer} โ \text{cells} \text{wins})
- \text{Call} \text{out} \text{the} \text{evidence} \text{item} \text{whose} \text{removal} \text{would} \text{flip} \text{the} \text{top}-2 \text{ranking} โ \text{that}'\text{s} \text{the} "\text{fragility} \text{point}"
- \text{Include} \text{a} \text{hypothesis} \text{that} \text{a} \text{hostile} \text{actor} \text{would} \text{push} (\text{Red} \text{Team} \text{H\_n})
- \text{Pre}-\text{declare} \text{a} \text{disconfirming} \text{observation} \text{that} \text{would} \text{reverse} \text{the} \text{assessment}
### \text{Quality} \text{gate}
- [ ] \text{n} โฅ 3 \text{alternative} \text{hypotheses}, \text{each} \text{substantively} \text{different}
- [ ] \text{Evidence} \text{matrix} โฅ5 \text{rows} \times โฅ4 \text{hypothesis} \text{columns}
- [ ] \text{Fragility} \text{point} \text{identified}
- [ ] \text{Red}-\text{team} \text{hypothesis} \text{present} \text{with} \text{explicit} "\text{this} \text{is} \text{adversarial} \text{framing}" \text{label}
- [ ] \text{Residual} \text{uncertainty} \text{statement} \text{quantified}
---
## ๐ฏ \text{Part} 4 โ \text{Intelligence} \text{Assessment} ($intelligence-assessment.md`)
### Purpose
Deliver the **strategic bottom line** at intelligence-community quality: single assessment paragraph per question, confidence label, alternative view, and collection gap.
### Input
- synthesis-summary.md ยท stakeholder-impact.md ยท scenario-analysis.md ยท devils-advocate.md
- Behavioral-analysis insights (actor history, cognitive biases)
- Prior intelligence-assessment.md files from the last 30 days (for continuity)
### Output โ required structure
1. **Key Judgments (KJs)** โ 3โ7 numbered paragraphs, each with:
- Assertion (โค60 words)
- Confidence label (5-level scale)
- Key evidence (โฅ2 citations)
- Alternative view (one sentence)
2. **Strategic implications** โ 3 bullets on what this means for decision-makers over 30โ180 days
3. **Collection gaps** โ 3 explicit questions the evidence base does not answer
4. **Priority intelligence requirements (PIR)** โ 3 things the next cycle should prioritise
5. **Tradecraft note** โ which analytic techniques were applied (ACH, SWOT, PESTLE, Network, etc.)
6. **Intelligence Mermaid** โ color-coded confidence bar per KJ
### Required Mermaid โ KJ confidence
```mermaid
graph LR
classDef vh fill:#1565C0,stroke:#0D47A1,color:#FFFFFF
classDef h fill:#4CAF50,stroke:#1B5E20,color:#FFFFFF
classDef m fill:#FFC107,stroke:#F57F17,color:#3E2723
classDef l fill:#FF9800,stroke:#E65100,color:#FFFFFF
classDef vl fill:#D32F2F,stroke:#B71C1C,color:#FFFFFF
KJ1[KJ1 โ coalition holds<br/>๐ฆ VERY HIGH]:::vh
KJ2[KJ2 โ budget amendment passes<br/>๐ฉ HIGH]:::h
KJ3[KJ3 โ opposition unity weakens<br/>๐ง MEDIUM]:::m
KJ4[KJ4 โ EU infringement risk<br/>๐ฅ LOW]:::l
KJ5[KJ5 โ snap election trigger<br/>โฌ VERY LOW]:::vl
Quality gate
- 3โ7 Key Judgments
- Confidence labels distributed realistically (not all HIGH)
- Every KJ has โฅ2 citations
- 3 collection gaps named
- 3 PIRs formatted as answerable questions
- Tradecraft note lists techniques explicitly
๐ฌ Part 5 โ Methodology Reflection (methodology-reflection.md)
Purpose
Transparent analytic audit of the workflow run โ what worked, what didn't, what the next cycle must fix. This file is the platform's self-correction mechanism.
Input
- All other outputs from the workflow
- Comparison with prior day's equivalent outputs
- Tool-call logs from the workflow runner
- Confidence-label distribution across outputs
Output โ required structure
- Evidence sufficiency audit โ for each Family A output, was evidence sufficient? (yes/no with reason)
- Confidence distribution โ histogram Mermaid of confidence labels across the workflow
- Source diversity โ percentage of claims from Riksdag API vs Regeringen vs SCB vs international
- Bias audit โ were all 8 parties given fair analytical depth given their evidence footprint? Quantify.
- Tradecraft audit โ which techniques were applied; which were skipped and why
- Forward methodology adjustments โ 3 concrete improvements for next cycle, each actionable
- Prior-period comparison โ what has the methodology done better / worse vs last workflow?
Required Mermaid โ confidence distribution
pie showData
title Confidence label distribution across this workflow
"๐ฆ VERY HIGH" : 12
"๐ฉ HIGH" : 34
"๐ง MEDIUM" : 38
"๐ฅ LOW" : 12
"โฌ VERY LOW" : 4
Positive-voice bias audit rule
Produce a table of parties ร claims-about-them ร depth-score (words + citations) so a reader can see neutrality arithmetically. Acceptable outcome: no party's depth deviates from the evidence-weighted average by more than 25 %.
Quality gate
- Evidence sufficiency assessed per Family A output
- Confidence distribution Mermaid present
- Source diversity percentages sum to 100 %
- Bias audit quantified with specific numbers
- โฅ3 concrete methodology adjustments named for next cycle
๐ Long-horizon extensions (horizonDays โฅ 90)
DRY policy. This section summarizes operational floors; canonical values live in the bounded-context authority:
- Authoritative source for horizon stratification, scenario-tree depth, counterfactual minima, IMF projection-year stamps, PESTLE-mandatory thresholds, cross-horizon citation rules and forward-indicator bands โ
.github/prompts/ext/long-horizon-forecasting.md.- Aggregation multipliers (1.7 / 2.0 / 2.5) and sibling-folder ingestion โ
.github/prompts/ext/tier-c-aggregation.md.- Gate enforcement โ
.github/prompts/05-analysis-gate.md, check LH-3 = counterfactual paragraph minima.
Long-horizon scenario-tree composition
When the run resolves to quarter-ahead, year-ahead or election-cycle, scenario-analysis.md MUST branch deeper than the baseline โฅ 3 scenarios. Tree shape comes from analysis/article-types.json โ longHorizonRules, using scenarioCount for base scenarios plus wildcardCount (year-ahead) and scenarioBranchesPerScenario (election-cycle) where applicable:
| Article type | Tree shape (minimum) | Leaves |
|---|---|---|
quarter-ahead | 4 base scenarios | 4 |
year-ahead | 4 base scenarios + 5 wildcards by default (recorded in wildcards-blackswans.md) | โฅ 9 |
election-cycle | 4 base scenarios ร 3 governing-coalition branches | 12 |
Probabilities sum to 100 % at every level (base set; per-scenario branch set). See the canonical scenario summary table and per-scenario branching Mermaid in analysis/templates/scenario-analysis.md. Year-ahead wildcards are authored in analysis/templates/wildcards-blackswans.md.
Counterfactual reasoning (mandatory at year/cycle)
devils-advocate.md MUST contain explicit **Counterfactual N โ <name>** paragraphs at the minima below. Each counterfactual references at least one scenario ID from the sibling scenario-analysis.md (e.g. S2-Coalition-Collapse) and is anchored on a primary-source dok_id or URL. Gate LH-3 in 05-analysis-gate.md enforces the paragraph-count floor via grep.
| Article type | Minimum counterfactual paragraphs |
|---|---|
week-ahead / month-ahead | 1 |
quarter-ahead | 2 |
year-ahead | โฅ 2 mandatory |
election-cycle | โฅ 3 mandatory |
Paragraph structure (4โ8 sentences): (a) restate the assumption being challenged, (b) construct the alternative world referencing the linked scenario ID, (c) declare the falsification trigger that would update the analysis.
Horizon stratification of strategic extensions
When horizonDays โฅ 90, every Family-C/D artifact in this methodology gains a horizon-class column (72h | week | month | quarter | year | cycle | election) on its probabilistic tables.
WEP terms (very likely, likely, roughly even, unlikely, very unlikely) carry an inline [horizon:<band>] tag within ยฑ 80 characters of the term. WEP-band degradation rules โ no very likely / very unlikely at year / cycle without โฅ 3 corroborated cycle-aged sources โ are enforced at Pass-2 review per ext/long-horizon-forecasting.md ยง1.
Affected artifacts:
scenario-analysis.md,devils-advocate.md,intelligence-assessment.md(Family C)risk-assessment.md,threat-analysis.md(Family A)cross-reference-map.md(Family B)forward-indicators.md,pestle-analysis.md(Family D โpestle-analysis.mdblocking for year/cycle),wildcards-blackswans.md(Family D)
Single-horizon (horizonDays < 90) Family-C/D artifacts retain their existing column structure โ no regression.
๐ ๏ธ Production Workflow โ step-by-step
flowchart TD
classDef trig fill:#1565C0,stroke:#0D47A1,color:#FFFFFF
classDef step fill:#E8F5E9,stroke:#4CAF50,color:#1B5E20
classDef gate fill:#FFF8E1,stroke:#FFC107,color:#3E2723
classDef out fill:#F3E5F5,stroke:#7B1FA2,color:#311B92
classDef vital fill:#FFF3E0,stroke:#FF9800,color:#BF360C,stroke-width:3px
Trig[Family A + B complete<br/>โ Family C begins]:::trig
S1[Step 1 โ Branch paths<br/>โ scenario-analysis.md]:::step
S2[Step 2 โ International framing<br/>โ comparative-international.md]:::step
S3[Step 3 โ ACH + Red Team<br/>โ devils-advocate.md]:::step
S4[Step 4 โ Strategic bottom line<br/>โ intelligence-assessment.md]:::step
S5[โญ Step 5 โ VITAL run-audit<br/>โ methodology-reflection.md]:::vital
G{Gate โ all 5 files<br/>produced + quality-gated?}:::gate
O[Family C complete]:::out
Trig --> S1
Trig --> S2
Trig --> S3
S1 --> S4
S2 --> S4
S3 --> S4
S4 --> S5
S5 --> G
G -->|pass| O
G -->|fail| S1
โ Family-C Completion Checklist
-
scenario-analysis.mdโ โฅ4 scenarios ยท probabilities sum to 100 % ยท branching Mermaid ยท early-warning indicators with ISO dates -
comparative-international.mdโ โฅ5 peer countries ยท quantified outcomes ยท EU-law section ยท benchmark chart -
devils-advocate.mdโ n โฅ 3 hypotheses ยท evidence matrix โฅ5 rows ยท fragility point ยท red-team hypothesis -
intelligence-assessment.mdโ 3โ7 KJs ยท confidence labels ยท collection gaps ยท PIRs ยท tradecraft note -
methodology-reflection.mdโ evidence audit ยท confidence distribution ยท bias audit ยท forward adjustments - All files use canonical color palette and 5-level confidence scale
- All files cross-link to Family A and Family B inputs
๐ Template bindings
| Template | Methodology section |
|---|---|
analysis/templates/scenario-analysis.md | Part 1 above |
analysis/templates/comparative-international.md | Part 2 above |
analysis/templates/devils-advocate.md | Part 3 above |
analysis/templates/intelligence-assessment.md | Part 4 above |
analysis/templates/methodology-reflection.md | Part 5 above |
๐ Cross-references to other methodology layers
- Upstream: synthesis-methodology.md (Family A) ยท structural-metadata-methodology.md (Family B)
- Downstream / parallel: electoral-domain-methodology.md (Family D โ lens-specific extensions)
- Long-horizon authority (DRY):
.github/prompts/ext/long-horizon-forecasting.mdโ scenario-tree depth, counterfactual minima, horizon stratification, IMFT+Nstamps, cross-horizon citation - Tier-C aggregation:
.github/prompts/ext/tier-c-aggregation.mdโ multiplier table (1.7 / 2.0 / 2.5) and sibling-folder ingestion - Frameworks: political-swot-framework.md ยท political-risk-methodology.md ยท political-threat-framework.md
- Master protocol: ai-driven-analysis-guide.md
๐ ISMS Alignment
| Control | How this methodology satisfies it |
|---|---|
| ISO 27001 A.5.7 (Threat intelligence) | Scenario + devils-advocate + intelligence-assessment constitute structured threat intelligence |
| ISO 27001 A.5.31 (Legal, regulatory) | Comparative-international maps EU-law intersection |
| NIST CSF ID.RA-3 (Threats identified) | ACH surfaces alternative threat interpretations |
| NIST CSF ID.RA-5 (Risks prioritised) | Scenario probabilities + impact enable risk ranking |
| CIS 17.5 (Incident response plan โ decision support) | Intelligence-assessment maps to decision-support doctrine |
| GDPR Art. 35 DPIA methodology | Methodology-reflection provides audit trail |
๐ Changelog
- v1.4 (2026-05-15) โ Aligned version badge with header text (both now 1.4); bumped date to 2026-05-15.
- v1.3 (2026-04-25) โ Explicit "Family C is exactly 5" close-out with placement rationale;
methodology-reflection.mdconfirmed as 5th member and run-audit gate.
๐ Document Control
Owner: CEO (Intelligence Program) ยท Reviewer: CISO + Chief Analyst ยท Review Cycle: Quarterly Next Review: 2026-07-21 ยท Related: ai-driven-analysis-guide.md, synthesis-methodology.md, electoral-domain-methodology.md
Generated following Riksdagsmonitor Strategic Extensions Methodology v1.0 โ Family C Depth Layer.