Principles

Phoenix Principles

Six engineering rules for reliable agent systems.

Back to Overview

Six Principles

1) Write-Then-Verify

Every write action is followed by a read or verify step to confirm success.

2) Abstraction Ladder (V1-V6)

Capabilities are taught progressively: foundation, conditional logic, chaining, natural keys, async, synthesis.

3) Domain Doctor Tool Design

Tools are atomic, single-purpose, and deterministic. State belongs to tools, not the agent.

4) Anti-Hallucination Templates

Reports are generated from structured templates, not freeform text.

5) Test-and-Prove Cycle

Golden files, unit tests, and validation suites prove correctness before release.

6) Human-in-the-Loop Gate (Post-V4)

After natural-key capability, a human reviewer issues binding GO/NO-GO with audit trail before progression.

Implementation Detail

These principles emerged from high-stakes deployments where deterministic, auditable behavior mattered more than model size.

HITL is intentionally a late-stage gate: meaningful review requires outputs that humans can ground-truth against source data.