# Canonical Specs Index

Canonical specs in this folder are hard-law for ALGO.

## Current B-series

- `B1_alignment_matrix.txt`
- `B2_core_overview_architecture.txt`
- `B3_ea_output_spec.txt`
- `B4_ea_ai_prompt_dev_rules.txt`
- `B5_ea_technical_template.py`
- `B6_ea_output_validator_strict.py`
- `B7_metrics_spec.txt`
- `B8_ea_generation_master_specs.txt`
- `B9_external_ai_dev_handoff_pack.txt`
- `B10_ea_canonical_examples.txt`

## Reading order for EA generation work

1. `B2_core_overview_architecture.txt`
2. `B3_ea_output_spec.txt`
3. `B4_ea_ai_prompt_dev_rules.txt`
4. `B5_ea_technical_template.py`
5. `B6_ea_output_validator_strict.py`
6. `B7_metrics_spec.txt`
7. `B8_ea_generation_master_specs.txt`
8. `B9_external_ai_dev_handoff_pack.txt`
9. `B10_ea_canonical_examples.txt`

## Role of the newer docs

- `B8`: master model for AI-driven EA generation
- `B9`: ready-to-send operational pack for external AI DEV
- `B10`: canonical worked examples to imitate

## Important note on versions

- Document version and payload `contract_version` are not the same thing.
- The B-series documents can advance for governance and clarification while the enforced EA payload contract remains `B3-V04` until explicitly changed in both spec and validator.