From 2b9c2740d0f0c27c1f107d3ad2698b75a2b3c626 Mon Sep 17 00:00:00 2001 From: Cobus Greyling Date: Sat, 13 Jun 2026 10:25:32 +0200 Subject: [PATCH] chore(discoverability): tighten repo About, add topics, improve README hook + attribution, enrich npm package metadata - GitHub: clearer description naming the tools + Addy/Boris; added coding-agents, anthropic, claude, devtools topics - README: audience line for Grok/Claude/Codex/Cursor users; stronger centered links (showcase + canonical Addy essay) - Packages: richer descriptions + expanded keywords for npm/npx discoverability (all three CLIs) --- README.md | 8 ++++++-- tools/loop-audit/package.json | 2 +- tools/loop-cost/package.json | 9 +++++++-- tools/loop-init/package.json | 10 ++++++++-- 4 files changed, 22 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index d798e96..20ed963 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,8 @@ **Loop engineering is replacing yourself as the person who prompts the agent. You design the system that does it instead.** +For developers using Grok, Claude Code, Codex, Cursor, and other AI coding agents. + A loop is a recursive goal: you define a purpose and the AI iterates (often with sub-agents, verification, and external state) until the goal is complete or the loop decides to hand off to you. @@ -33,9 +35,11 @@ A loop is a recursive goal: you define a purpose and the AI iterates (often with

- → cobusgreyling.github.io/loop-engineering + → Interactive showcase + pattern picker +
+ → Loop Engineering essay (Substack)
- → Read the Loop Engineering essay on Substack + Canonical essay by Addy Osmani

## Contents diff --git a/tools/loop-audit/package.json b/tools/loop-audit/package.json index 987b4bf..f7952ea 100644 --- a/tools/loop-audit/package.json +++ b/tools/loop-audit/package.json @@ -1,7 +1,7 @@ { "name": "@cobusgreyling/loop-audit", "version": "1.4.0", - "description": "Loop Readiness Score — audit a project for loop engineering readiness (L0-L3). Dynamic activity detection + --suggest. npx @cobusgreyling/loop-audit . --suggest", + "description": "Loop engineering readiness auditor. Compute Loop Readiness Score (L0-L3), detect activity, and get actionable suggestions. npx @cobusgreyling/loop-audit . --suggest", "type": "module", "bin": { "loop-audit": "./dist/cli.js" diff --git a/tools/loop-cost/package.json b/tools/loop-cost/package.json index a05fac9..6c49d85 100644 --- a/tools/loop-cost/package.json +++ b/tools/loop-cost/package.json @@ -1,7 +1,7 @@ { "name": "@cobusgreyling/loop-cost", "version": "1.0.1", - "description": "Estimate daily token spend for loop engineering patterns by cadence and readiness level.", + "description": "Estimate token budgets and daily costs for loop engineering patterns. By cadence, readiness level (L1/L2/L3), and coding agent tool.", "type": "module", "bin": { "loop-cost": "dist/cli.js" @@ -24,8 +24,13 @@ "keywords": [ "loop-engineering", "ai-agents", + "coding-agents", "token-budget", - "cost-estimate" + "cost-estimate", + "claude-code", + "grok", + "budget", + "devtools" ], "author": "Cobus Greyling", "license": "MIT", diff --git a/tools/loop-init/package.json b/tools/loop-init/package.json index 85e175a..fb96ba9 100644 --- a/tools/loop-init/package.json +++ b/tools/loop-init/package.json @@ -1,7 +1,7 @@ { "name": "@cobusgreyling/loop-init", "version": "1.2.0", - "description": "Scaffold loop engineering starters into your project by pattern and tool.", + "description": "Scaffold loop engineering patterns and starters into any project. Supports Grok, Claude Code, Codex and more. npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok", "type": "module", "bin": { "loop-init": "./dist/cli.js" @@ -25,8 +25,14 @@ "keywords": [ "loop-engineering", "ai-agents", + "coding-agents", "scaffold", - "starter" + "starter", + "claude-code", + "grok", + "codex", + "github-actions", + "patterns" ], "author": "Cobus Greyling", "license": "MIT",