Touli Architecture Packet

Client-Facing Unified Document

• touli-unified-architecture.md — single consolidated architecture reference (share with client)
• touli-unified-architecture.docx — Word export (regenerate via python3 tools/scripts/generate-architecture-docx.py)

Core Documents

• touli-core-hld.md
• touli-verification-dld.md
• touli-points-dld.md
• touli-blockchain-dld.md
• touli-schema-delta-spec.md
• touli-api-event-contracts.md
• touli-compliance-controls.md
• touli-rollout-risk-readiness.md
• touli-gift-economy-flowchart.md

ADR Set

• adr/README.md
• Create a new ADR: yarn docs:new "Short decision title"

Docs site

• Local preview: yarn docs:dev
• Published: docs.<env>.platform.touli.ai (prod: docs.platform.touli.ai)
• ADR index sync: yarn docs:sync:adr (checked on pre-commit via yarn docs:check)

Intended Use

This packet is implementation-ready architecture guidance for the deferred modules (AI verification, deterministic points, blockchain anchoring) and is designed for engineering kickoff after architecture freeze.