59 lines (39 loc) · 1.92 KB

🛠 Engineering Guidelines

1. Core Principles

Models interpret intent and meaning.
Code controls execution and state.

2. Architecture Rules

Model calls must be isolated to a single layer.
State must have a single source of truth.
The CLI must not contain business logic.

3. Code Rules

Type definitions are required.
JSON validation must be enforced.
Errors must be handled explicitly.

4. Collaboration Rules

Define interfaces first.
Keep pull requests small.
Reach agreement before changing schemas.

5. Performance Principles

Minimize token usage.
Eliminate duplication.
Execute only the work that is necessary.

6. Prohibited Practices

Using model outputs without validation ❌
Changing schemas arbitrarily ❌
Managing duplicated state ❌

Core Principle

The model interprets, and the code controls.