Verifiable run-until-done objectives for Grok Build /goal. Patterns, a verifier, and the goal-audit CLI.
/goal does not appear in my sessionCause: Goal mode is not enabled or update_goal is not in the toolset.
Fix:
update_goal.GOAL.md + verifier skill.update_goal(completed: true) without running testsCause: Self-grading (anti-pattern #1).
Fix:
/goal pause immediately.goal-verifier skill: npx @cobusgreyling/goal-init . --pattern minimal-goal --tool grokAGENTS.md: “Never completed: true without verifier PASS.”Cause: Objective only lived in chat, not GOAL.md.
Fix:
/goal clearGOAL.md/goal Read GOAL.md. Continue the Active Objective.Common caps:
npm test / pytest / go testgoal-run-log.md missing recent outcome → log last goal run with date and outcome.github/workflows (even a test workflow)Run: npx @cobusgreyling/goal-audit . --suggest
Fix:
/goal pausegoal-budget.md — was max turns set?goal-scoper — objective may be a mega-goal (anti-patterns)Check:
npx @cobusgreyling/goal or goal-cost returns 404Cause: The meta CLI and the cost estimator are in this repository (tools/goal, tools/goal-cost) and are not published to npm. @cobusgreyling/goal-audit and @cobusgreyling/goal-init are.
Fix:
npx @cobusgreyling/goal-audit . --suggest
npx @cobusgreyling/goal-init . --pattern tests-green --tool grok
| Situation | Use |
|---|---|
| Finish one bounded task | /goal |
| Daily triage / discovery | /loop |
| Loop found a fixable item | Hand off to /goal |
See goal-vs-loop.md and stack-cookbook.md.
- uses: cobusgreyling/goal-engineering/.github/actions/goal-audit@main
with:
path: .
min-level: G2
Or: npx @cobusgreyling/goal-audit . --json --min-level G2