From 9088246a7987feddf60b1b52c80272ba4988a09c Mon Sep 17 00:00:00 2001
From: Cobus Greyling <cobusgreyling@Cobuss-MacBook-Pro-2.local>
Date: Tue, 30 Jun 2026 10:11:26 +0200
Subject: [PATCH] docs: add Loop Engineering v1.5.0 callout + stack quickstart
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Cross-promote the community tools release and show loop→goal handoff commands.
---
 README.md              | 19 +++++++++++++++++++
 docs/stack-cookbook.md |  2 +-
 2 files changed, 20 insertions(+), 1 deletion(-)

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
   <strong><a href="https://github.com/cobusgreyling/fleet-engineering">Fleet Engineering</a></strong> (governed populations)
 </p>
 
+<p align="center">
+  <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.
+  <br>
+  <em>Loops discover work on a cadence. Goals finish bounded tasks.</em>
+  <a href="docs/stack-cookbook.md">Stack cookbook →</a>
+</p>
+
 ## 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