I stopped trusting my AI coding agent's "done" — so I built gates

说明与用途

作者构建了 FlowSkill，一个在 AI 代码完成前强制执行机械和语义门的工具，消除了空洞完成并确保可靠构建。

问题

AI coding agents reported "done" without verifying success, leading to broken builds and missing tests.

结果

FlowSkill prevents hollow completes by requiring mechanical and semantic verification before marking a task as done, reducing debugging overhead and ensuring reliable builds.

工作流

• Describe the task to FlowSkill
• Run the AI agent to generate code
• Execute /flow check to run mechanical gates (build, tests, linter)
• If mechanical gates pass, run semantic gate (SKILL.md) to verify task intent
• If any gate fails, log failure to DEBT.md and abort the attempt
• Optionally run /flow doctor for environment checks

证据

My coding agent kept telling me "done." The build was broken. The tests it claimed to pass didn't exist.

来源

FlowSkill is a small open-source harness that sits between your coding agent and the word "done."

来源

Two kinds of gates: Mechanical gates (flow.sh) — does it build? Do the tests pass? Does the linter stay quiet?

来源

Semantic gates (SKILL.md) — does the change actually do what was asked?

来源

If a gate fails, the attempt dies there and the failure gets logged to DEBT.md — a record of what didn't work, so you stop paying for the same dead ideas twice.

来源