1906reblabs/adci-pilot

Agent-researched, code-scored weekly index tracking Africa's transition toward digitally- and AI-mediated economic civilization — piloting with Nigeria, Kenya, and South Africa. Claude agents gather and validate evidence; a deterministic Python engine computes every score. # ADCI — Africa Digital Civilization Intelligence A Claude-Project-run index that measures Africa's transition toward digitally- and AI-mediated economic civilization. Agents research and interpret inside the Project; a deterministic Python engine (run there, via code execution) scores; you export the results to GitHub by hand; GitHub Pages publishes them. Pilot scope: **South Africa, Nigeria, Kenya** × **10 indicators**. Expand only after the methodology proves itself (see `system/METHODOLOGY.md`). ## How it fits together ``` system/ the constitution — rules every agent must follow indicators/ the indicator registry (schema for what gets measured) countries/ per-country config (which indicators, notes, overrides) agents/ one prompt spec per agent role (Claude plays each role in sequence, in one Project conversation, per AGENT_ROLES.md) evidence/ raw sourced claims, produced in-session, dated by week engine/ scoring.py — deterministic math, NOT an LLM (see below) scores/ current/ = latest ADCI scores, historical/ = every past run, nothing is ever overwritten, only appended with a reason docs/ the GitHub Pages dashboard (static HTML, reads docs/data/) PROJECT_INSTRUCTIONS.md paste into the Claude Project's custom instructions WEEKLY_RUNBOOK.md the human checklist — what you do, every week ``` The most important design rule, carried over from the architecture this repo implements: **the LLM never assigns a country's score directly.** Agents produce evidence and structured indicator observations; `engine/scoring.py` does the arithmetic — executed for real, inside the Project, via its code execution tool. This is what keeps the index reproducible instead of vibes-based, even without a CI pipeline enforcing it. ## What's already in this repo `evidence/2026/2026-08-18/observations.json`, `scores/current/`, `scores/historical/2026-08- …