Skip to content

Commit e2fc485

Browse files
Merge pull request #1 from cobusgreyling/docs/loop-v1.5.0-callout
docs: Loop Engineering v1.5.0 callout + stack quickstart
2 parents 8ff926a + 9088246 commit e2fc485

2 files changed

Lines changed: 20 additions & 1 deletion

File tree

README.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,13 @@ This is the **canonical public reference** for [Grok Build CLI](https://x.ai)'s
3636
<strong><a href="https://github.com/cobusgreyling/fleet-engineering">Fleet Engineering</a></strong> (governed populations)
3737
</p>
3838

39+
<p align="center">
40+
<strong>🔄 <a href="https://github.com/cobusgreyling/loop-engineering/releases/tag/v1.5.0">Loop Engineering v1.5.0</a> just shipped</strong> — <code>loop-sync</code>, <code>loop-constraints</code>, MCP server on npm.
41+
<br>
42+
<em>Loops discover work on a cadence. Goals finish bounded tasks.</em>
43+
<a href="docs/stack-cookbook.md">Stack cookbook →</a>
44+
</p>
45+
3946
## The One-Line Definition
4047

4148
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
100107

101108
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).
102109

110+
**Try the stack:** morning loop triage → pick top item → `/goal` until verifier passes:
111+
112+
```bash
113+
# Loop side (v1.5.0 — just released)
114+
npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok
115+
npx @cobusgreyling/loop-audit . --suggest
116+
117+
# Goal side (this repo)
118+
npx @cobusgreyling/goal init . --pattern fix-bug --tool grok
119+
npx @cobusgreyling/goal doctor . --suggest
120+
```
121+
103122
## Grok Build API
104123

105124
| Surface | Purpose |

docs/stack-cookbook.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Stack Cookbook — Loop → Goal → Fleet
22

3-
One narrative for combining [loop-engineering](https://github.com/cobusgreyling/loop-engineering), **goal-engineering**, and [fleet-engineering](https://github.com/cobusgreyling/fleet-engineering).
3+
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).
44

55
## Daily rhythm
66

0 commit comments

Comments
 (0)