# Goal Engineering > Goal engineering replaces one-shot prompts with verifiable, run-until-done objectives for Grok Build /goal. This is the public reference by Cobus Greyling. A goal is one bounded objective that persists across turns until a verifier marks it done, blocked, or paused. Loops discover work. Goals finish it. Published commands: - `npx @cobusgreyling/goal-audit . --suggest` - `npx @cobusgreyling/goal-init . --pattern tests-green --tool grok` `@cobusgreyling/goal` and `@cobusgreyling/goal-cost` live in this repository and are not on npm. ## Start - [Showcase](https://cobusgreyling.github.io/goal-engineering/): pattern picker, readiness simulator, and the /goal overview - [Repository](https://github.com/cobusgreyling/goal-engineering): patterns, starters, skills, and CLIs - [Canonical essay](https://cobusgreyling.github.io/goal-engineering/canonical-essay.html): why one-shot prompts stop at "looks done" - [Medium essay](https://cobusgreyling.medium.com/goal-engineering-788b5ca00e7f): the published article - [Substack](https://cobusgreyling.substack.com/p/goal-engineering): the same idea, shorter ## Docs - [API reference](https://cobusgreyling.github.io/goal-engineering/api-reference.html): `/goal` and `update_goal` - [Four primitives](https://cobusgreyling.github.io/goal-engineering/primitives.html): objective, verifier, GOAL.md, budget - [Primitives across tools](https://cobusgreyling.github.io/goal-engineering/primitives-matrix.html): Grok Build, Claude, Codex, and others - [Goal vs loop](https://cobusgreyling.github.io/goal-engineering/goal-vs-loop.html): finish one task, or discover work on a cadence - [When not to use a goal](https://cobusgreyling.github.io/goal-engineering/when-not-to-use-goals.html): stay with a prompt or a loop - [Stack cookbook](https://cobusgreyling.github.io/goal-engineering/stack-cookbook.html): loop triage hands off to a goal - [Operating goals](https://cobusgreyling.github.io/goal-engineering/operating-goals.html): start, pause, resume, clear - [Design checklist](https://cobusgreyling.github.io/goal-engineering/goal-design-checklist.html): G0 to G3 - [Pattern picker](https://cobusgreyling.github.io/goal-engineering/pattern-picker.html): tests, migration, feature, bug, refactor, coverage - [FAQ](https://cobusgreyling.github.io/goal-engineering/faq.html): missing command, self-grading, compaction - [Anti-patterns](https://cobusgreyling.github.io/goal-engineering/anti-patterns.html): designs that fail quietly - [Failure modes](https://cobusgreyling.github.io/goal-engineering/failure-modes.html): how a run goes wrong, and recovery - [Safety](https://cobusgreyling.github.io/goal-engineering/safety.html): deny lists, human gates, kill switches - [Multi-goal](https://cobusgreyling.github.io/goal-engineering/multi-goal.html): one active goal per session - [Concepts](https://cobusgreyling.github.io/goal-engineering/concepts.html): glossary - [Adopters](https://cobusgreyling.github.io/goal-engineering/adopters.html): who runs the patterns ## Patterns - [Tests green](https://github.com/cobusgreyling/goal-engineering/blob/main/patterns/tests-green.md) - [Fix bug](https://github.com/cobusgreyling/goal-engineering/blob/main/patterns/fix-bug.md) - [Migrate module](https://github.com/cobusgreyling/goal-engineering/blob/main/patterns/migrate-module.md) - [Implement feature](https://github.com/cobusgreyling/goal-engineering/blob/main/patterns/implement-feature.md) - [Refactor safely](https://github.com/cobusgreyling/goal-engineering/blob/main/patterns/refactor-safely.md) - [Coverage target](https://github.com/cobusgreyling/goal-engineering/blob/main/patterns/coverage-target.md) ## Companions - [Loop Engineering](https://github.com/cobusgreyling/loop-engineering): scheduled discovery. Current release v1.6.0 - [Fleet Engineering](https://github.com/cobusgreyling/fleet-engineering): accountability across a population of agents - [Cobus Greyling](https://cobusgreyling.me/): author