StatePlane

StatePlane is infrastructure for compiling, validating, and explaining the context sent to AI systems we control directly, plus integrations that expose explicit extension surfaces.

What Exists Today

• context_core provides typed schemas, normalization, validation, deterministic selection, and typed compilation receipts.
• provider_openai provides the first provider-specific adapter and request/response receipt surface.
• examples/openai_context_demo shows the current golden path: compile a fixture-backed request, inspect the exact payload, and optionally make one real OpenAI call.

Product Boundary

StatePlane is not universal hidden-prompt control for closed third-party agent backends.

StatePlane is strongest when one of these is true:

• we own the backend that decides what to send to the model
• we can route requests through our own service
• the target product exposes explicit extension points such as MCP, hooks, rules, or plugins

Start Here

• Read Getting Started to install dependencies and run the demo.
• Read Context Compiler for the current pipeline and invariants.
• Read OpenAI Context Demo for the first end-to-end workflow.
• Read Repo Shape for the current package layout.

Current Limits

The repo is still early. The current implementation does not include:

• repo scanning
• tool execution loops
• multi-step agent runtimes
• persistence and replay flows
• dashboard features
• provider adapters beyond the first OpenAI slice

The long-form architecture briefs remain available under Architecture for broader intent and roadmap context.