Spectral Codex

Compile business logic into executable agent behavior. Spectral turns operational judgment into versioned world models and deterministic decision modules that agents call before they act.

Codex is how that system is built. It covers the decision-time mechanism, the world-model authoring path, the domain knowledge that grounds enshrinement, and the patterns engineers follow in the codebase.

Spectral is for systems where an LLM agent has been put in front of an operational decision the business cannot afford to let the LLM reinterpret on the fly — payments, regulatory release, vendor onboarding, anything where “the model felt confident” is not a defensible audit answer. The agent consults Spectral; Spectral decides and records the outcome; the agent is expected to honor that decision.

If you’re new

Read these in order. They take a cold reader from zero to oriented.

1. How Spectral Works — what Spectral does at decision time, the two-pillar shape (world-model system + platform), and how a caller integrates.
2. Operator Walkthrough — an operator bootstraps the first world model end-to-end on the Operations app.
3. Domains — the domain knowledge that grounds enshrinement. Tax-prep’s problem spaces, source materials, and rules live here.
4. System Design — foundations, agents, the world-model system, the platform pillar, operator surfaces, and topology.
5. Your First Feature — the contributor walkthrough. Build a feature end-to-end through every layer.

Looking for something specific

Browse the sidebar or search with Ctrl+K / Cmd+K.

• Glossary — canonical terminology; one-line definitions for cross-referenced concepts.
• Decisions — every ADR and its supersession graph. The “why” behind each choice.