git:20260413.220d4ab to git:20260825.708c3e3

+ ## Agent-first design principle (non-negotiable)

+

+ All infrastructure code, tooling, gates, hooks, and workflows in this

+ repository are designed and optimized for **AI coding agents**, not humans.

+ Humans interact with this repo only to approve and monitor; agents execute.

+

+ Consequences:

+

+ - **Do not add interactive prompts, manual checkpoints, or pauses for human

+ confirmation** to any tool or workflow. Every step must be executable

+ autonomously from start to finish.

+ - **Do not add human-legibility conveniences** (colorized spinners, interactive

+ menus, PAGER output) that break non-interactive shells or pipe

+ consumption.

+ - **When a tool or workflow requires a decision**, encode the decision logic

+ directly in the script rather than delegating to a human prompt. If the

+ decision cannot be automated, the tool should fail clearly and exit

+ non-zero with a machine-readable error, not wait.

+ - **Quality gates exist to run autonomously.** A gate that requires human

+ review before it can be checked does not belong here.

+ - **ship.sh is the canonical end-to-end agent workflow.** Any friction it

+ exposes is a bug in the infrastructure, not a feature.

+

+ If you find yourself writing a step that says "then the human should...",

+ stop — that step belongs in the tool itself or the tool is incomplete.

+