analysis-wiki

/analysis-wiki

Maintain the Analysis Wiki — a structured, AI-maintained knowledge base built from your team's analyses.

Subcommands: update | check | show {entity}

Instructions

Step 1: Parse subcommand

Read $ARGUMENTS:

• update or no argument → rebuild wiki from analyses (go to Step 2a)
• check → health-check the wiki for issues (go to Step 2b)
• show {entity} → display a wiki page (go to Step 2c)

---

Step 2a: Update

Goal: Scan all analyses and compile/update structured wiki pages.

Step 2a-1: Inventory

Read:

• .analysis/config.md — team context, metrics list, language
• analyses/decisions/INDEX.md — existing DRs (to link wiki pages to decisions)

List all archived analyses:

• analyses/archive/ — all folders recursively
• /analysis-wiki update always does a full scan (not incremental) to ensure wiki accuracy. For large archives, this takes longer but prevents stale pages from persisting.

If analyses/wiki/ doesn't exist yet, create the directory structure:

analyses/wiki/
├── INDEX.md
├── metrics/
│   └── INDEX.md
├── patterns/
│   └── INDEX.md
└── hypotheses/
    └── INDEX.md

Step 2a-2: Extract from each analysis

For each archived analysis, read:

• summary.md — key findings, type, tags
• 01_ask.md — primary metric, hypothesis tree
• 03_investigate.md — hypothesis scorecard results, statistical findings
• 05_evolve.md — proposed new metrics, follow-up analyses

Extract:

• Metrics referenced: note the metric name + how it was defined in this analysis
• Hypotheses tested: each hypothesis from the scorecard + its result (validated / rejected / inconclusive) + effect size
• Key findings: top 1-2 VOICE-stage findings for this metric
• Patterns detected: look for notes about Simpson's paradox, seasonality, sampling bias, etc.

Step 2a-3: Build/update metric pages

For each unique metric found across analyses:

If analyses/wiki/metrics/{metric-slug}.md already exists:

• Append new findings to the Key Findings section
• Add new hypothesis results to the appropriate section (Validated / Rejected / Inconclusive)
• Update Watch Points if new quirks found
• Update Last updated and Source analyses count