Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# CBE Agent Instructions

- CBE is derived from QBE.
- The project goal is categorical/proof-artifact infrastructure, not QBE's original minimal-backend goal.
- Preserve inherited QBE behavior unless a task explicitly says otherwise.
- Keep `master` as upstream/QBE baseline.
- Do CBE work on `cbe`; in Codex Cloud, the checked-out task branch may be called `work`, and that is acceptable.
- Prefer small, reviewable commits.
- Every behavior-changing patch must include either a test or a clear manual validation command.
- Do not introduce external dependencies without justification.
- Keep C code style close to existing QBE style unless a new subsystem clearly needs a different style.
- New semantic/provenance code should be isolated under clearly named files rather than tangled into backend code.
11 changes: 11 additions & 0 deletions docs/architecture.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# CBE Architecture (Planned)

Intended transformation and artifact pipeline:

QBE IL
→ parsed QBE AST / internal structures
→ block-argument SSA normalization
→ olog-shaped artifact graph
→ derived facts
→ proof obligations
→ provenance / invalidation
8 changes: 8 additions & 0 deletions docs/roadmap.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# CBE Roadmap

- M0: preserve baseline build
- M1: machine-readable IR dump
- M2: phi-to-block-argument normalization
- M3: olog JSON export
- M4: structural proof obligations
- M5: dependency provenance and invalidation