diff --git a/AGENTS.md b/AGENTS.md index 5cb7ee8..3f6540b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -38,6 +38,7 @@ This architecture provides compile-time correctness, observability through event - Do not add "unknown" results when parses or matches fail - these should always throw. - Compile time correctness is a super-power, and investment in it speeds up flywheel for development and user value. - **CLI/Service Interchangeability**: Both the CLI and service must produce identical artifacts (BEL events, logs, metrics, outputs) in the same locations. Users should be able to build with one interface and query/inspect results from the other seamlessly. This principle applies to all DataBuild operations, not just builds. +- The BEL represents real things that happen: job run processes that are started or fail, requests from the user, dep misses, etc. ## Build & Test ```bash