API Internal Documentation

API_Dócs // Clássifíed_Índex

ᚠ ᛫ ᛟ ᛫ ᚱ ᛫ ᛒ ᛫ ᛟ ᛫ ᚲ

Design and specification documents for the ForbocAI API and related systems. Served at classified.forboc.ai.

Design Documents

Document	Description
Soul Storage, Encryption, and Trading-Card Architecture	Authoritative design for Soul storage (Arweave), encryption (AES-256-GCM, key-in-metadata), compression (optional gzip), single canonical version, and trade/key-transfer flows. No gaps; implementations MUST follow this spec.
Architecture Audit Report	Audit of md/mdx across repos: Layer 1/2/3 gatekeeping, Soul storage (IPFS→Arweave) alignment, proprietary info placement.

Reference Documents

Document	Description
API Overview	Scope, glossary, architecture, onboarding, protocol contracts.
Toolchain Concept	Story Engine vision, Disco Elysium case study, composable components.
Side Notes	Vision and context.

Planning & Checklists

Document	Description
TODO (Master Checklist)	SDK & API implementation checklist, phases, BDD status.
TODO TMP	Actionable checklist (legacy).
TODO Phase 2 BDD	Phase 2 BDD plan.
TODO Phase 2 BDD Cortex	Cortex-first BDD status.

Testing

Document	Description
BDD Testing	BDD harness, feature files, Haskell steps, run instructions.

Internal Tooling

Document	Description
Classified Setup	Hakyll build, local dev, Render deployment for classified.forboc.ai.

style-guide.md — Aesthetic protocols (api repo).