# mehdidolati/project-zero architecture

> Architecture diagram of the GitHub repository mehdidolati/project-zero, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mehdidolati/project-zero
- Repository: https://github.com/mehdidolati/project-zero

## Overview

Project Zero is a research-first operating framework, not a software product: its intended result is trustworthy knowledge about trading opportunities, and custom software is deliberately deferred until the manual method stabilizes. The principal workflow moves from research questions and testable hypotheses into experiments, recorded evidence, and—once supported—discoveries. Governance supplies artifact identity, lifecycle, and traceability rules across that work. The graph also includes the documented EXP002 dataset-verification utility; its sampled code validates raw data and emits a report, not trading signals. Unsampled relationships are omitted rather than inferred.

Main entry points: [`governance`](https://github.com/mehdidolati/project-zero/tree/main/governance) (Governance framework), [`experiments`](https://github.com/mehdidolati/project-zero/tree/main/experiments) (Experiment designs), [`experiments/EXP002-gold-trend-following/tools/verify_full.py`](https://github.com/mehdidolati/project-zero/blob/main/experiments/EXP002-gold-trend-following/tools/verify_full.py) (Dataset verifier), [`questions`](https://github.com/mehdidolati/project-zero/tree/main/questions) (Research questions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_research["Research framing"]
  node_foundation["Research foundation"]
  node_questions["Research questions"]
  node_hypotheses["Hypotheses"]
end

subgraph group_investigation["Experiments and evidence"]
  node_experiments["Experiment designs"]
  node_exp001["EXP001 manual study"]
  node_exp002["EXP002 gold study"]
  node_rawdata[("Raw datasets")]
  node_verifier["Dataset verifier<br/>[verify_full.py]"]
  node_report["Verification report"]
  node_status["Run status checker<br/>[check_status.py]"]
  node_evidence["Experiment evidence"]
end

subgraph group_knowledge["Knowledge governance"]
  node_governance["Governance framework"]
  node_registry["Artifact registry"]
  node_principles["Project principles"]
end

subgraph group_project["Project artifacts"]
  node_discoveries["Validated discoveries"]
  node_sources["Registered sources"]
  node_decisions["Project decisions"]
  node_sessions["Research sessions"]
  node_operating["Operating system"]
end

node_researcher(("Researcher"))

node_researcher -->|"formulates"| node_questions
node_researcher -->|"conducts"| node_experiments
node_experiments -->|"produce evidence"| node_evidence
node_evidence -->|"supports findings"| node_discoveries
node_exp001 -->|"cites sources"| node_sources
node_rawdata -->|"is scanned by"| node_verifier
node_verifier -->|"writes report"| node_report
node_status -->|"checks existence"| node_report
node_governance -->|"defines registry"| node_registry
node_governance -->|"governs research"| node_experiments
node_governance -->|"governs artifacts"| node_questions
node_principles -->|"inform decisions"| node_decisions

click node_foundation "https://github.com/mehdidolati/project-zero/tree/main/research"
click node_questions "https://github.com/mehdidolati/project-zero/tree/main/questions"
click node_hypotheses "https://github.com/mehdidolati/project-zero/tree/main/hypotheses"
click node_experiments "https://github.com/mehdidolati/project-zero/tree/main/experiments"
click node_exp001 "https://github.com/mehdidolati/project-zero/tree/main/experiments/EXP001"
click node_exp002 "https://github.com/mehdidolati/project-zero/tree/main/experiments/EXP002-gold-trend-following"
click node_rawdata "https://github.com/mehdidolati/project-zero/tree/main/experiments/EXP002-gold-trend-following/evidence/raw"
click node_verifier "https://github.com/mehdidolati/project-zero/blob/main/experiments/EXP002-gold-trend-following/tools/verify_full.py"
click node_report "https://github.com/mehdidolati/project-zero/tree/main/experiments/EXP002-gold-trend-following/evidence/derived"
click node_status "https://github.com/mehdidolati/project-zero/blob/main/experiments/EXP002-gold-trend-following/tools/check_status.py"
click node_evidence "https://github.com/mehdidolati/project-zero/tree/main/experiments"
click node_discoveries "https://github.com/mehdidolati/project-zero/tree/main/discoveries"
click node_sources "https://github.com/mehdidolati/project-zero/tree/main/sources"
click node_governance "https://github.com/mehdidolati/project-zero/tree/main/governance"
click node_registry "https://github.com/mehdidolati/project-zero/blob/main/governance/artifact-registry.json"
click node_principles "https://github.com/mehdidolati/project-zero/tree/main/principles"
click node_decisions "https://github.com/mehdidolati/project-zero/tree/main/decisions"
click node_sessions "https://github.com/mehdidolati/project-zero/tree/main/research/sessions"
click node_operating "https://github.com/mehdidolati/project-zero/tree/main/operating-system"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_foundation,node_questions,node_hypotheses toneBlue
class node_experiments,node_exp001,node_exp002,node_rawdata,node_verifier,node_report,node_status,node_evidence toneAmber
class node_governance,node_registry,node_principles toneMint
class node_discoveries,node_sources,node_decisions,node_sessions,node_operating toneRose
class node_researcher toneIndigo
```

## Components

### Research framing

- [Research foundation](https://github.com/mehdidolati/project-zero/tree/main/research): `research`
- [Research questions](https://github.com/mehdidolati/project-zero/tree/main/questions): `questions`
- [Hypotheses](https://github.com/mehdidolati/project-zero/tree/main/hypotheses): `hypotheses`

### Experiments and evidence

- [Experiment designs](https://github.com/mehdidolati/project-zero/tree/main/experiments): `experiments`
- [EXP001 manual study](https://github.com/mehdidolati/project-zero/tree/main/experiments/EXP001): `experiments/EXP001`
- [EXP002 gold study](https://github.com/mehdidolati/project-zero/tree/main/experiments/EXP002-gold-trend-following): `experiments/EXP002-gold-trend-following`
- [Raw datasets](https://github.com/mehdidolati/project-zero/tree/main/experiments/EXP002-gold-trend-following/evidence/raw): `experiments/EXP002-gold-trend-following/evidence/raw`
- [Dataset verifier](https://github.com/mehdidolati/project-zero/blob/main/experiments/EXP002-gold-trend-following/tools/verify_full.py): `experiments/EXP002-gold-trend-following/tools/verify_full.py`
- [Verification report](https://github.com/mehdidolati/project-zero/tree/main/experiments/EXP002-gold-trend-following/evidence/derived): `experiments/EXP002-gold-trend-following/evidence/derived`
- [Run status checker](https://github.com/mehdidolati/project-zero/blob/main/experiments/EXP002-gold-trend-following/tools/check_status.py): `experiments/EXP002-gold-trend-following/tools/check_status.py`
- [Experiment evidence](https://github.com/mehdidolati/project-zero/tree/main/experiments): `experiments`

### Knowledge governance

- [Governance framework](https://github.com/mehdidolati/project-zero/tree/main/governance): `governance`
- [Artifact registry](https://github.com/mehdidolati/project-zero/blob/main/governance/artifact-registry.json): `governance/artifact-registry.json`
- [Project principles](https://github.com/mehdidolati/project-zero/tree/main/principles): `principles`

### Project artifacts

- [Validated discoveries](https://github.com/mehdidolati/project-zero/tree/main/discoveries): `discoveries`
- [Registered sources](https://github.com/mehdidolati/project-zero/tree/main/sources): `sources`
- [Project decisions](https://github.com/mehdidolati/project-zero/tree/main/decisions): `decisions`
- [Research sessions](https://github.com/mehdidolati/project-zero/tree/main/research/sessions): `research/sessions`
- [Operating system](https://github.com/mehdidolati/project-zero/tree/main/operating-system): `operating-system`

### Other components

- **Researcher**

## Connections

- Researcher → Research questions: formulates (evidence: `README.md`)
- Researcher → Experiment designs: conducts (evidence: `README.md`)
- Experiment designs → Experiment evidence: produce evidence (evidence: `README.md`)
- Experiment evidence → Validated discoveries: supports findings (evidence: `README.md`)
- EXP001 manual study → Registered sources: cites sources (evidence: `README.md`)
- Raw datasets → Dataset verifier: is scanned by (evidence: `experiments/EXP002-gold-trend-following/tools/verify_full.py`)
- Dataset verifier → Verification report: writes report (evidence: `experiments/EXP002-gold-trend-following/tools/verify_full.py`)
- Run status checker → Verification report: checks existence (evidence: `experiments/EXP002-gold-trend-following/tools/check_status.py`)
- Governance framework → Artifact registry: defines registry (evidence: `README.md`)
- Governance framework → Experiment designs: governs research (evidence: `README.md`)
- Governance framework → Research questions: governs artifacts (evidence: `README.md`)
- Project principles → Project decisions: inform decisions (evidence: `README.md`)
