docs: GP architecture — SIR schema, extraction protocol, validation engine, compilation layer

Browse source

The four design docs from the GP architecture research thread. These define Speckl's
general-purpose architecture: conversation → SIR → deterministic compile, with domain
plugins for state machines, data schemas, and workflows.

- sir-schema.md (48KB): Central IR data structure with ~20 interfaces, 8 domain element tables
- extraction-protocol.md (47KB): How conversation populates the SIR
- validation-engine.md (39KB): SIR validation before compilation
- compilation-layer.md (43KB): How validated SIRs compile to deterministic artifacts

Phase strategy: build GP core now, ship state machines first, layer data schemas
and workflows on the same architecture (no rewrites).

...

This commit is contained in:

cos Agent 2026-05-09 23:46:57 -07:00 • committed by Scott Scoble

parent f62bdc33f5

commit 34b8de549f

4 changed files with 5448 additions and 0 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download patch file Download diff file Expand all files Collapse all files

1317

docs/compilation-layer.md Normal file

View file

File diff suppressed because it is too large Load diff

1460

docs/extraction-protocol.md Normal file

View file

File diff suppressed because it is too large Load diff

1484

docs/sir-schema.md Normal file

View file

File diff suppressed because it is too large Load diff

1187

docs/validation-engine.md Normal file

View file

File diff suppressed because it is too large Load diff