Skip to main content

When to Use

When you need to look up a specific STRATT specification detail during implementation. This maps concepts to their authoritative source location.

Two Source Documents

DocumentLocationWhat It Contains
TADGist 79b224b8483d20fe6eec3ab3c3f977feArchitecture reference — layers, schemas, field definitions, CRDT rules, CLI commands, ADRs
Handbookchoco-hq/choco-hqdocs/STRATT-SYSTEMS-LIFECYCLE-HANDBOOK.mdVisual reference — diagrams, state machines, council registry, timeline, sequence diagrams

TAD Section Map

NeedTAD Section
Layer 0 identity/addressingtad.layers[0].addressing
Layer 1 base schema fieldstad.layers[1].base_schema.required_fields
Meta block fieldstad.layers[1].base_schema.meta_block
Contract block fieldstad.layers[1].base_schema.contract_block
Composition block fieldstad.layers[1].base_schema.composition_block
Type-specific constraintstad.layers[1].type_specific_constraints
CRDT field merge rulestad.layers[2].field_merge_rules
Status merge orderingtad.layers[2].field_merge_rulesfield_category: status
Dependency graph modeltad.layers[3].graph_model
Council registrytad.layers[4].registered_councils
CLI commandstad.layers[5].commands
MERIDIAN page structuretad.layers[6].content_architecture
ADR indextad.adr_index

Handbook Section Map

NeedHandbook Section
Architecture overview diagramSection 1
Design principles (P-01 to P-08)Section 2
Launch timelineSection 3
SPUH bit layout (128-bit header)Section 5a
Chain step frame (64-bit)Section 5b
Gate resolution packet (32-bit)Section 5c
Requirements traceability (REQ/CON)Section 6
Lifecycle state machine diagramSection 7
Council registry (all 7 councils)Section 8
CLI command reference tableSection 9
Dependency graph resolution flowSection 10
Chain execution sequenceSection 11
CRDT merge sequenceSection 12

Known Spec Gaps (Corrected)

  • AC-02: TAD status merge order missing tampered. Corrected to: [tombstoned, deprecated, tampered, stable, review, draft]
  • Handbook section 7: tampered → stable transition exists (re-publish by authorised author) but is not shown in all TAD lifecycle references

Fetching the TAD

gh gist view 79b224b8483d20fe6eec3ab3c3f977fe --raw

Reading the Handbook

# Local path (if choco-hq is cloned):
cat /home/devarno/code/workspace/choco-hq/docs/STRATT-SYSTEMS-LIFECYCLE-HANDBOOK.md

# Via GitHub API:
gh api repos/choco-hq/choco-hq/contents/docs/STRATT-SYSTEMS-LIFECYCLE-HANDBOOK.md \
  --jq '.content' | base64 -d