> ## Documentation Index
> Fetch the complete documentation index at: https://doc.blueapi.ir/llms.txt
> Use this file to discover all available pages before exploring further.

# EMEP Project Management: Governance and Cadence

> Governance model for EMEP including docs-first development, ADR-driven changes, phase gates, RACI assignments, and team cadence.

EMEP follows a docs-first governance model. Every change starts as a specification update, proceeds through architectural decision review, and only then moves to implementation. This page defines the governance structure, decision rights, and operational cadence.

## Governance Model

```mermaid theme={null}
flowchart TD
    START([Change Request]) --> DOC{Spec Update Required?}
    DOC -->|Yes| ADR[Write ADR]
    DOC -->|No| REVIEW[Peer Review]
    ADR --> REVIEW
    REVIEW --> APPROVE{Approved?}
    APPROVE -->|Yes| IMPL[Implementation]
    APPROVE -->|No| REVISE[Revise ADR/Spec]
    REVISE --> REVIEW
    IMPL --> TEST[Test Suite]
    TEST --> PASS{All Pass?}
    PASS -->|Yes| MERGE[Merge to Main]
    PASS -->|No| FIX[Fix & Retest]
    FIX --> TEST
    MERGE --> AUDIT[Consistency Audit]
    AUDIT --> END([Done])
```

## ADR-Driven Changes

Every architectural or behavioral change requires an Architecture Decision Record (ADR). The ADR template is maintained in the [decisions](https://doc.blueapi.ir/overview/decisions.md) log. ADRs cover:

* Merge strategy selection
* Evaluation harness choice
* GPU orchestration approach
* Security architecture changes

ADRs are immutable once merged. Superseded ADRs link to their replacements.

## Phase Gates

Each phase in the [roadmap](https://doc.blueapi.ir/project/roadmap.md) ends with a formal gate review. The gate checklist is:

1. All phase [tasks](https://doc.blueapi.ir/project/tasks.md) marked DONE or DEFERRED
2. Spec-to-test traceability above 90%
3. No open [risks](https://doc.blueapi.ir/risk/risk-register.md) rated HIGH without mitigation plan
4. Consistency audit passed ([consistency report](https://doc.blueapi.ir/audit/consistency-report.md))
5. Stakeholder sign-off recorded

## RACI Table

| Artifact | Product Lead | Tech Lead | ML Engineer | Platform Engineer | Security Lead |
| - | - | - | - | - | - |
| [Project Constitution](https://doc.blueapi.ir/overview/project-constitution.md) | A | R | C | I | I |
| [System Architecture](https://doc.blueapi.ir/architecture/system-architecture.md) | C | A/R | C | C | I |
| [Merge Engine Spec](https://doc.blueapi.ir/merge/merge-engine.md) | I | A | R | C | I |
| [Evolution Engine Spec](https://doc.blueapi.ir/evolution/evolution-engine.md) | I | A | R | C | I |
| [Security Architecture](https://doc.blueapi.ir/architecture/security-architecture.md) | I | C | I | C | A/R |
| [Benchmark Catalog](https://doc.blueapi.ir/evaluation/benchmark-catalog.md) | C | C | A/R | I | I |
| [Deployment Spec](https://doc.blueapi.ir/deployment/deployment-specification.md) | C | C | I | A/R | C |
| [KPI Dashboard](https://doc.blueapi.ir/project/kpi-specification.md) | A/R | C | C | C | I |

R = Responsible, A = Accountable, C = Consulted, I = Informed

## Team Cadence

| Meeting | Frequency | Duration | Attendees | Purpose |
| - | - | - | - | - |
| Planning | Weekly | 60 min | Core team | Sprint planning, task assignment |
| Spec Review | Bi-weekly | 90 min | Core + advisors | ADR review, spec changes |
| Phase Gate | Per phase | 120 min | All stakeholders | Go/no-go decision |
| Retro | Per phase | 60 min | Core team | Process improvement |
| Risk Review | Monthly | 45 min | Leads | [Risk register](https://doc.blueapi.ir/risk/risk-register.md) update |

## Documentation First Rule

No implementation task may start without:

1. A merged specification page
2. Linked [tasks](https://doc.blueapi.ir/project/tasks.md) with traceability to the spec
3. Test plan defined in [testing strategy](https://doc.blueapi.ir/testing/testing-strategy.md)

This rule applies to all components including [ModelRegistry](https://doc.blueapi.ir/tracking/model-registry.md), [MergeEngine](https://doc.blueapi.ir/merge/merge-engine.md), [EvolutionEngine](https://doc.blueapi.ir/evolution/evolution-engine.md), and [EvaluationEngine](https://doc.blueapi.ir/evaluation/framework.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.