Intent Engineeringfor Coding Agents

How humans and coding agents design software together.

Foundation

The source-controlled workspace as shared ground. Decisions, design docs, specs, and an agent-facing index, before any per-change intent exists.

AGENTS.md and the .agents/ hub that tells each coding agent how this repo is structured, reviewed, and constrained.

Change-sized specs before code, with OpenSpec as the working example. Developers state intent before agents implement.

Tests as evidence of intent. Stable AC IDs, coverage pairs, PR taxonomy, and checks that keep human intent and generated code aligned.

Adoption, trunk-based development with agents, cross-team coordination, and a time-bounded account of what is still unsettled.

Glossary, living principles, tooling snapshot, the iec companion repo, an adoption checklist, and Honest Maturity.