Footnote keeps docs in three buckets:
architecture: stable system design and interfacesdecisions: durable technical choices and rationalestatus: implementation progress for active work
- Execution Contract Authority Map: Defines the governing authority model and module ownership for execution.
- Incident Reporting: Defines the consented Discord-side report flow and captured context.
- Incident Storage And Audit: Defines the durable incident model, audit trail, and privacy boundary.
- Incident And Breaker Logging: Defines the structured logging schema and examples for incident lifecycle and breaker events.
- Safety Evaluation And Breakers: Defines the target deterministic safety layer and enforcement point.
- Deterministic Breaker Evaluator V1 (Draft): Proposes the concrete evaluator contract, rule model, action mapping, and validation gates for issue #75.
- Prompt Resolution: Defines how prompt layers and overrides resolve at runtime.
- Bounded User Control Mapping: Defines the small user-facing posture set and the internal controls that stay backend-owned.
- Workflow Profile Contract: Defines required profile hooks/fields and blocked/no-generation behavior + provenance expectations.
- Workflow Engine And Provenance: Defines the workflow engine direction, step model, and provenance record shape.
- How to Read Provenance-Related Metadata: Explains how to read mode, TRACE, planner, steerability, and provenance fields without mixing their meanings together.
- Workflow Profiles V1 RFC: Engine Core vs Profile Semantics: Defines ownership boundaries and invariants for single-pass and bounded-review profiles.
- Execution Contract TrustGraph Architecture: Defines advisory TrustGraph integration constraints, runtime wiring, and production-readiness limits.
- Turnstile Selection: Records why Turnstile was chosen for abuse protection.
- Incident Identifier Pseudonymization: Records the decision to store incident-facing Discord identifiers as HMAC digests.
- TRACE: Response Temperament + Compact UI Provenance: Records TRACE as the canonical temperament model and compact Discord provenance UI.
- Env Parsing Standardization: Records the environment parsing and validation approach used across services.
- Multi-Bot Vendoring Plan: Records the plan for shared backend support across multiple Discord bot identities.
- Persona/Core Split + Out-of-Band TRACE Metadata: Records the split between core constraints, persona layers, and control-plane metadata generation.
- Completing Legacy OpenAI Removal Across Text, Image, and Voice: Records the end-state architecture for removing legacy OpenAI product flows across text, image, and voice.
- VoltAgent Runtime Adoption Behind the Existing Backend: Records why VoltAgent is being adopted behind Footnote's backend boundary and what the first MVP should prove.
- External Pattern Adoption: Context Packaging + Tool Governance: Records selective adoption of external architecture patterns without platform migration.
- Incident And Breakers Status: Tracks current implementation progress, gaps, and validation coverage for this active work.
- TrustGraph Foundation Consolidation Status (2026-04-10): Records bounded-scope consolidation work, runtime-truthfulness checks, and outside-review evidence anchors.