Skip to content

EXP-04 — New Feature, Existing Service

When the existing codebase is already well-structured, does the guide still matter? On a conforming hexagonal service, both conditions — with and without the guide — produced 0 violations. The existing architecture constrains the agent’s output.

0violations — both conditions
nullguide had no effect
Without guide With guide
───────────────────── ──────────────────────────────
0 violations ✓ 0 violations ✓
hexagonal shape ✓ hexagonal shape ✓
verikt check: PASS verikt check: PASS

Both conditions generated 5 files extending the existing orders-service with cancellation logic in the correct layers.

Without guideWith guide
Violations00
verikt checkpasspass
Hexagonal shapetruetrue
Packagesadapter, cmd, domain, port, serviceadapter, cmd, domain, port, service
Files generated55
Input tokens34
Cache tokens042,708
Output tokens2,8193,179

Null result. On a conforming codebase, the guide adds nothing measurable.

The agent follows the patterns it finds in the embedded fixture — hexagonal structure, correct layer boundaries, existing naming conventions. The existing code is the context. The guide is redundant when the codebase already teaches the agent what it needs to know.

This constrasts sharply with greenfield experiments (EXP-01, EXP-02) where there’s no existing code to learn from. The guide’s value is highest when the agent has no architectural reference — a new service, or a codebase with mixed patterns.

  • Task: Add order cancellation to an existing conforming hexagonal orders service
  • Agent: claude-sonnet-4-6
  • Fixture: orders-service (hexagonal, conforming) — Mode B, embedded
  • Runs: 1 per condition

→ Experiment Methodology — reproduction instructions

→ Artifacts on GitHub

→ EXP-05: Does the prompt even matter?