diff --git a/README.md b/README.md index c59d835..30578ab 100644 --- a/README.md +++ b/README.md @@ -36,6 +36,13 @@ This is the **canonical public reference** for [Grok Build CLI](https://x.ai)'s Fleet Engineering (governed populations)

+

+ 🔄 Loop Engineering v1.5.0 just shipped — loop-sync, loop-constraints, MCP server on npm. +
+ Loops discover work on a cadence. Goals finish bounded tasks. + Stack cookbook → +

+ ## The One-Line Definition A **goal** is a single autonomous objective with a verifiable completion condition. Unlike a loop (which fires on a schedule), a goal **persists across turns** until Grok marks it complete, blocked, or you pause it. @@ -100,6 +107,18 @@ Most agent work fails in the gap between "looks done" and **actually done**. Goa Goals pair naturally with [loop engineering](https://github.com/cobusgreyling/loop-engineering): loops discover work; goals **finish** it. See [docs/stack-cookbook.md](docs/stack-cookbook.md). +**Try the stack:** morning loop triage → pick top item → `/goal` until verifier passes: + +```bash +# Loop side (v1.5.0 — just released) +npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok +npx @cobusgreyling/loop-audit . --suggest + +# Goal side (this repo) +npx @cobusgreyling/goal init . --pattern fix-bug --tool grok +npx @cobusgreyling/goal doctor . --suggest +``` + ## Grok Build API | Surface | Purpose | diff --git a/docs/stack-cookbook.md b/docs/stack-cookbook.md index 7b0a030..6dd63be 100644 --- a/docs/stack-cookbook.md +++ b/docs/stack-cookbook.md @@ -1,6 +1,6 @@ # Stack Cookbook — Loop → Goal → Fleet -One narrative for combining [loop-engineering](https://github.com/cobusgreyling/loop-engineering), **goal-engineering**, and [fleet-engineering](https://github.com/cobusgreyling/fleet-engineering). +One narrative for combining [loop-engineering](https://github.com/cobusgreyling/loop-engineering) ([v1.5.0](https://github.com/cobusgreyling/loop-engineering/releases/tag/v1.5.0) — `loop-sync`, `loop-constraints`, MCP server), **goal-engineering**, and [fleet-engineering](https://github.com/cobusgreyling/fleet-engineering). ## Daily rhythm