Human Decision as Development Artifact

When AI writes the code, what is the actual product of software development? The claim: it’s not the diff. It’s the decisions the human made while shaping it.

The shift

In traditional development, the artifact is the code — the human wrote it, so the code is the record of decisions. In an AI-assisted workflow where the agent generates the diff, the code alone doesn’t tell you what the human chose. The decisions happen in the parse phase — choosing between approaches, evaluating tradeoffs, setting constraints. Those decisions are the development artifact. The code is just their downstream expression.

Implications

This reframes what should be preserved and what’s ephemeral. Decision rationale becomes first-class documentation. The diff’s comments about why something was done aren’t scaffolding — they’re the point. The code without them has lost its development history.

Parent discussions

• 01-Log/Daily/Sunday June 28 2026 — sparked on 2026-06-28

Connected concepts

• AI Pair Programming Workflow
• …