loop-engineering README

The project's README from github.com/cobusgreyling/loop-engineering. As one markdown file: README.md.

Loop Engineering

Showcase GitHub stars loop npm last triage MIT

Loop Engineering logo

Stop prompting. Design the loop. Get a score.

Loop Engineering — design the system that prompts your agents

Start in 5 minutes · Quickstart · What do you want to do? · Refactor path · 中文 · Pattern picker 

npx @cobusgreyling/loop init . --pattern daily-triage --tool claude
npx @cobusgreyling/loop doctor .

--tool defaults to claude if you omit it. Swap for grok, codex, or opencode. Week one is report-only.

Loop Ready score climbing

You design a system that discovers work, hands it to agents, verifies results, and persists state — instead of typing the next prompt yourself.

New here? Quickstart · Refactor a project · Thin GitHub Action loop (no STATE.md required)

What do you want to do?

This is a pattern library for operating agents around a codebase. It is not a “rewrite the module” button.

I want to… Start here
Keep the repo healthy (issues, CI, deps) Quickstart → daily-triage
Land and babysit PRs PR Babysitter
Run a loop in GitHub Actions with almost no files Thin loop
Ship a feature or refactor (todos → small PRs) Refactor / change path

Full jobs table: docs/jobs.md.

Patterns

Pattern Cadence Week 1 Cost
Daily Triage 1d–2h L1 report Low
Thin loop event + 1d L1 snapshot Very low
PR Babysitter 5–15m L1 watch High
CI Sweeper 5–15m L2 cautious Very high
Dependency Sweeper 6h–1d L2 patch-only Medium
Changelog Drafter 1d or tag L1 draft Low
Post-Merge Cleanup 1d–6h L1 off-peak Low
Issue Triage 2h–1d L1 propose-only Low

Interactive picker: showcase. Index: patterns/registry.yaml.

Getting started

npx @cobusgreyling/loop init . --pattern daily-triage --tool claude
npx @cobusgreyling/loop doctor .
npx @cobusgreyling/loop cost --pattern daily-triage --level L1

Empty repo → first STATE.md walkthrough: scripts/empty-to-state-demo.sh.

Roll out L1 report → L2 assisted → L3 unattended only after the verifier has been right for a week. See loop-design-checklist.

Loop Ready now weights recent runs harder than files on disk. A 30-day-old STATE.md is not L3.

Examples by tool

Claude Code (including the plugin) · Grok · Codex · OpenClaw · Opencode · GitHub Actions

Operating & safety

Failure modes · Anti-patterns · Safety · Operating loops · Stories (wins and failures)

Loop engineering amplifies judgment. Token costs can explode. Unattended loops make unattended mistakes. Read what the loop ships.

Help wanted

Docs and small PRs: first response within 48 hours.

See CONTRIBUTING.md.

CLI packages and companion repos (optional — not required for week one)

Unified front door: npx @cobusgreyling/loop (init · doctor · status · audit · cost). Older packages (loop-init, loop-audit, …) stay supported.

Companions exist for later: memory-engineering, harness-foundry, outerloop, fleet-engineering, goal-engineering. Do not add them until a loop has actually run.

Sources

License

MIT

loop-engineering (cobusgreyling/loop-engineering)

Searching Database…

11.6K ·GitHub
Loop-engineering
Что это такое?Loop Engineering — это библиотека паттернов и набор CLI-инструментов для проектирования автоматизированных циклов, в которых ИИ-агенты для написания кода сами находят задачи, выполняют их, проверяют результат и сохраняют состояние в репозитории, вместо того чтобы вы сами вводили следующий промпт.
Это фреймворк или просто набор CLI-инструментов?В первую очередь это библиотека задокументированных паттернов (Daily Triage, PR Babysitter, CI Sweeper и др.) плюс сопутствующие CLI-инструменты вроде loop-audit, loop-init и loop-cost, а также шаблоны GitHub Actions, которые реализуют эти паттерны. Это не инструмент для переписывания кода в один клик.
С какими агентами для написания кода это работает?В примерах и флаге --tool поддерживаются Claude Code (включая плагин), Grok, Codex, OpenClaw и Opencode; если не указать другой, по умолчанию используется Claude.
Мои агенты работают полностью без присмотра сразу после установки?Нет. Переходить нужно постепенно: от L1 (только отчёты) к L2 (с участием человека) и затем к L3 (полностью автономно), причём только после того, как верификатор целую неделю подтверждал свою правоту. Старый файл STATE.md не означает готовности к L3.
Какие паттерны входят в библиотеку?Восемь задокументированных задач покрывают типичное обслуживание репозитория: Daily Triage, Thin loop, PR Babysitter, CI Sweeper, Dependency Sweeper, Changelog Drafter, Post-Merge Cleanup и Issue Triage. Для каждой указаны рекомендуемая периодичность, стартовый уровень безопасности и примерная стоимость.
Какие CLI-инструменты входят в проект?Более ранние отдельные инструменты loop-init, loop-audit, loop-cost, loop-sync, loop-context и loop-gate по-прежнему поддерживаются, но теперь объединены под одной командой npx @cobusgreyling/loop.
Зачем создали loop engineering?Он формализует идею проектирования системы вокруг ИИ-агента для написания кода вместо разовых промптов. Он опирается на идеи Addy Osmani и Boris Cherny, а в академической работе 2026 года о внедрении агентных циклов его называют эталонной референсной реализацией сообщества.
Какой самый большой риск при запуске таких циклов?В README предупреждается, что loop engineering усиливает ваши суждения, в том числе ошибочные, поэтому затраты на токены могут резко вырасти, а цикл, работающий без присмотра, может наделать ошибок, которые никто не контролирует. Вы должны действительно читать то, что выдаёт цикл.
What are similar projects?agents, pstack-claude, open-swe, pstack, qwen-code, jevmem, claude-code, headroom
Which topics is it in?loop-engineering, claude-code-plugin, devtools, grok, ai-coding, coding-agents, github-actions, github, workflow-automation, agent-orchestration, prompt-engineering, agentic-ai
Creator
cobusgreyling
Size
6.4 MB
Stars
11.6K
Updated
CommitOct 19Releasev1.6.0Jul 20
Age
4mo
Commits · 90 Days