docs(agents): make the gate gate the commit
Two rules added to the quality-gate step, both learned by getting them wrong tonight. The gate must gate the commit: one conditional chain, so its exit status is what decides whether the commit runs. Written as separate statements on one command line it is decorative, because nothing reads its status but the operator -- the failure is discovered after it has already been pushed. And never assert a gate result that was not just produced on that exact tree. A commit message outlives the tree it describes and is read by people who were not there; if the tree has moved, describe the change and let the run speak. AGENTS.md is a symlink to this file, so the edit belongs here.
This commit is contained in:
1 file changed
+9
@@ -282,6 +282,15 @@ structures found in legacy packages.
|
||||
2. **Green (Implementation):** Implement minimal code to satisfy the failing
|
||||
tests.
|
||||
3. **Quality Gate:** Run `task check`.
|
||||
- **The gate gates the commit.** Let the gate's exit status decide whether
|
||||
the commit runs, as one conditional chain (`check && commit && push`).
|
||||
Writing them as separate statements on one command line makes the gate
|
||||
decorative: nothing reads its status but the operator, and a failure is
|
||||
discovered after it has already been pushed.
|
||||
- **Never assert a gate result you have not just produced on that exact
|
||||
tree.** A commit message outlives the tree it describes, and "verified"
|
||||
is read by people who were not there. If the tree moved, describe the
|
||||
change and let the run speak.
|
||||
4. **Formatting is LAW:** Adopt all formatting and simplification changes from
|
||||
`task fmt` (`go fix` + the configured golangci-lint formatters) verbatim.
|
||||
Never revert or fight canonical linter/formatter diffs.
|
||||
|
||||
Reference in new issue
Block a user