Iran Transition Project

Independent Analytical Framework for Iranian Regime Architecture and Transition Dynamics

Structured analysis connecting available information — regime primary sources, Farsi media, institutional architecture — to actionable understanding. All outputs published openly.

Analytical Outputs

Iran Transition Baseline (ITB)

8 pillars, 22 analytical modules mapping how the regime actually works. 86 tracked variables, 57 registered research gaps.

Active 22 modules

Iran Stress Architecture (ISA)

14 documented analytical traps where standard frameworks fail. 30 observations. 12 transition scenario models.

Active 12 scenarios

Convergence Briefs

Policy-focused analysis for professionals and journalists. Each brief anchors claims to the ITB baseline with full epistemic tagging.

14 published

Methodology

The project applies structured analytical standards to Iran analysis: factional neutrality (no faction is treated as reformist or hardline by default), epistemic tagging (every claim marked as Fact, Inference, Uncertain, or Speculation), source discipline (5-tier source hierarchy with provenance tracking), and full transparency (all instruction files, methodology, and AI usage are public).

AI (Claude by Anthropic) is used as an analytical tool, not a source. All AI instructions are committed to version control. The framework database is the source of truth — maintained as a live Git repository with every analytical decision tracked in commit history.

Technology

The analytical engine is built on open-source infrastructure developed as part of this project. These tools are available independently for anyone building multi-agent AI workflows.

Heddle

Actor-based Python framework for orchestrating multi-LLM workflows via NATS messaging. Workers, pipelines, MCP gateway, Workshop UI.

v0.8.0 Python API Docs

Baft

ITP analytical engine — 13 specialized worker configurations, 3-tier pipeline orchestration, blind audit system, session management.

v0.3.0 Application

Docman

Document processing pipeline. PDF/DOCX extraction, LLM classification, summarization, DuckDB persistence with vector search.

v0.5.0 Application

Community

Baseline Discussions

Analytical discussions about the ITP framework content — methodology questions, module feedback, scenario analysis, research gaps.

Heddle Discussions

Technical support for Heddle developers and users — architecture questions, integration help, feature requests.

Issue Trackers & Contributing

Bug reports, feature requests, and contribution guidelines for all project repositories.

Recent Posts

All posts →