К основному содержанию
скилл CX Codex

loop-architect — скилл для Claude Code: дизайн агент-луп перед запуском

Скилл loop-architect проектирует агент-луп с проверкой по best practice и кросс-модельными воротами рецензирования. Помогает, если нужно построить итеративный рабочий процесс, self-review луп, LLM-as-judge или многомодельный совет.

MIT ★ 141 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add fabricioctelles/skills --skill loop-architect -a claude-code
Открыть на GitHub

Что делает loop-architect

loop-architect интервьюирует вас по семи этапам: уточняет цель, типизирует критерии верификации, выбирает модель-хоста и рецензентов, настраивает терминацию и наблюдаемость. Каждый этап критикуется против rubric перед принятием — слабую цель толкает к outcome и done state, нечёткую проверку — к программным критериям или судебной рубрике.

На выходе пишет portable артефакты: loop.yaml, loop.resolved.json, LOOP.md, RUN_IN_SESSION.md и run-loop.py. Луп можно запустить сразу внутри сессии через /goal или позже через Python runner. Если в совете участвуют модели других вендоров, скилл явно проговаривает, какой контекст покинет машину и какие редакции применяются.

Какие задачи решает

  • спроектировать self-review луп с чёткими критериями выхода
  • собрать многомодельный совет для рецензирования с судебными вердиктами
  • настроить итеративный workflow с guard rails на количество итераций и прогресс
  • описать loop в portable формате для запуска вне сессии или по расписанию
  • вставить проверку и рецензирование перед тем, как луп начнёт работать

Примеры запросов агенту

  • Спроектируй луп для написания отчёта: агент пишет, другая модель рецензирует по критериям, выход — готовый документ
  • Построй self-review луп с max 5 итерациями, на каждой агент проверяет результат через программный хеклист
  • Создай многомодельный совет для код-ревью: Claude планирует, Gemini судит по rubric, терминация если score > 0.8

Как установить loop-architect

1Через Skills CLI (Vercel)

npx skills add fabricioctelles/skills --skill loop-architect -a claude-code

2Вручную: положить файлы

~/.claude/skills/loop-architect/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/loop-architect/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о loop-architect

Как установить loop-architect в Claude Code?

Выполни npx skills add fabricioctelles/skills --skill loop-architect -a claude-code, затем открой ~/.claude/skills/loop-architect/SKILL.md.

Что делает loop-architect?

Проектирует агент-луп с прохождением всех этапов: уточнение цели, типизация проверок, выбор рецензентов, guard rails. Генерирует YAML-конфиг и Python runner для запуска.

В чём разница между loop-architect и /goal?

/goal просто запускает самопроверяющийся луп на текущей модели. loop-architect сначала помогает спроектировать луп правильно — с критериями, рецензентами и терминацией — и потом может запустить его через /goal или Python runner.

Исходный текст

SKILL.md · MIT
---
name: loop-architect
description: >
  Design well-structured agent loops with best-practice coaching and cross-model
  review gates before you run them. Use when the user wants to design, build, or
  set up an agent loop, iterative agent workflow, self-review loop, LLM-as-judge
  loop, multi-model council, reviewer/judge gate, or goal-driven looping process.
  Guides goal refinement, typed verification criteria, reviewer/judge selection,
  privacy boundaries, termination guards, and observability, then emits a
  RUN_IN_SESSION.md handoff prompt plus portable loop.yaml, loop.resolved.json,
  LOOP.md, and run-loop.py.
metadata:
  author: https://ft.ia.br
  version: "1.2"
  date: 2026-10-14
  repository: https://github.com/fabricioctelles/skills
  license: MIT
  original_project: https://github.com/ksimback/looper
  original_author: Kevin Simback (@ksimback)
  attribution: >
    Reinterpretation of Looper (MIT License) by Kevin Simback, adapted for
    Kiro CLI with native /goal, subagent, and review loop integration.
  category: code-scaffolding-and-templates
---

# Loop Architect

A loop design coach for Kiro CLI. Interviews you, critiques your design against
built-in best-practice rubrics, wires in cross-model reviewers or judges, shows
the loop as an ASCII flow preview, and writes portable artifacts you can run
immediately with `/goal` or later with the Python runner.

> Based on [Looper](https://github.com/ksimback/looper) by Kevin Simback, MIT License.
> Adapted for Kiro CLI by ft.ia.br.

## Why This Exists

Kiro CLI ships `/goal` (autonomous loop with self-verification) and subagents
(parallel pipelines with review loops). These **execute** a loop. Loop Architect
helps you **design** one worth executing — with a coached goal, typed
verification, a cross-model gate, and explicit termination guards.

| | `/goal` | Subagent pipeline | **Loop Architect** |
|---|---|---|---|
| Layer | execution | execution | **design (pre-flight)** |
| Coaches your goal | no | no | **yes** |
| Typed verification | no | no | **yes (programmatic / judge / human)** |
| Reviewer model | same model | configurable | **different model, by default** |
| Portable artifact | no | no | **loop.yaml + resolved spec** |
| Runs the loop | **yes** | **yes** | **yes, via handoff** |

## Workflow

1. Resolve the target path from the user. Default: `./loop-architect-output`. If
   the target contains an existing `loop.yaml`, treat as edit/resume.

2. Load the relevant rubric only when entering that stage:
   - Goal stage: `references/goal-rubric.md`
   - Verification stage: `references/verification-rubric.md`
   - Council stage: `references/council-rubric.md`
   - Control stage: `references/control-rubric.md`
   - Model detection: `references/model-detection.md`

3. Interview in seven stages: goal, verification, host model, council,
   gates/control, confirmation flow preview, emit/run option. In the control
   stage, cover execution boundary, isolation, no-progress signals, state, and
   run logging.

4. Critique each stage before accepting it. Prefer concrete alternatives over
   vague warnings. Push weak goals toward outcome, scope, context, and done
   state. Push weak verification toward programmatic checks first, then judge
   rubrics, then human signoff.

5. Keep reviewer and judge roles distinct. A reviewer writes notes. A judge
   returns a structured verdict. `revise_until_clean` must name a judge member
   or `human` as `verdict_source`.

6. Require multiple termination guards: `max_iterations`, a revision cap on
   each gate, a no-progress stop, and either a budget cap or an explicit human
   stop point.

7. Before any cross-vendor council member is selected, state what context will
   leave the user's machine, which CLI receives it, which redaction globs apply,
   and that both execution paths require first-send consent.

8. Show an ASCII flow preview and ask for confirmation before final emission.

9. Emit these files into the target:
   - `loop.yaml`
   - `loop.resolved.json`
   - `LOOP.md`
   - `RUN_IN_SESSION.md`
   - `run-loop.py`
   - `loop-workspace/`
   - `README.md`

10. After writing `loop.yaml`, compile it:
    ```bash
    python3 ~/.kiro/skills/loop-architect/scripts/looper.py compile \
      <target>/loop.yaml \
      --out <target>/loop.resolved.json \
      --render <target>/LOOP.md \
      --session-prompt <target>/RUN_IN_SESSION.md
    ```

11. Ask whether the user wants to run the loop now. If yes:
    - **Easy path**: Follow `RUN_IN_SESSION.md` directly, or suggest a `/goal`
      one-liner derived from the `definition_of_done`.
    - **Subagent path**: If the council uses a model with `review_loop`
      capability, offer to execute via a subagent pipeline with native review
      loops.
    - **External path**: Explain that `run-loop.py` is available for running
      later or outside the session.

## Execution Paths

### Path 1: `/goal` (simplest)

When the loop is straightforward and the host is the current Kiro session:

```
/goal --max 12 <definition_of_done from loop.yaml>
```

This uses Kiro's native self-verification loop. No cross-model review, but
fast and zero-config.

### Path 2: Subagent review pipeline (recommended)

When a cross-model reviewer is needed and the host has `subagent` capability:

```
Implement the loop following RUN_IN_SESSION.md. Use a subagent as reviewer
with trigger "NEEDS_CHANGES" and max 3 iterations per gate.
```

This leverages Kiro's native `loop_to` mechanism for the plan and delivery
gates.

### Path 3: External Python runner (advanced)

```bash
python3 ./loop-architect-output/run-loop.py
```

For scheduled runs, CI integration, or when you need strict budget enforcement.

## File Rules

- Write argv arrays, never shell command strings, for all model invocations.
- Do not write API keys, tokens, or credentials into any emitted file.
- Default redaction globs: `.env`, `.env.*`, `secrets/**`, `**/*.key`.
- Keep `loop.yaml` human-readable and commented.
- Keep `RUN_IN_SESSION.md` as the default/easy execution handoff.
- Copy `templates/run-loop.py` exactly unless the user asks to edit it.

## Helper Scripts

Detect model CLIs:
```bash
python3 ~/.kiro/skills/loop-architect/scripts/looper.py detect-models --write
```

Register a custom CLI:
```bash
python3 ~/.kiro/skills/loop-architect/scripts/looper.py register-model <id> \
  --invoke kiro-cli chat --trust-all-tools -p --authed
```

Compile and render:
```bash
python3 ~/.kiro/skills/loop-architect/scripts/looper.py compile <target>/loop.yaml \
  --out <target>/loop.resolved.json \
  --render <target>/LOOP.md \
  --session-prompt <target>/RUN_IN_SESSION.md
```

## Confirmation Flow Preview

```text
+--------------------------------+
| 1. Goal + context              |
|    read sources                |
+--------------------------------+
              |
              v
+--------------------------------+
| 2. Draft plan.md               |
|    state -> state.json         |
+--------------------------------+
              |
              v
+--------------------------------+
| 3. Plan gate                   |
|    verdict: reviewer-1         |
+--------------------------------+
  | needs work -> revise <= 3 -> step 2
  | pass
              v
+--------------------------------+
| 4. Write delivery-N.md         |
|    log -> run-log.md           |
+--------------------------------+
              |
              v
+--------------------------------+
| 5. Delivery gate               |
|    verdict: reviewer-1         |
+--------------------------------+
  | needs work -> revise <= 3 -> step 4
  | pass
              v
+--------------------------------+
| 6. Final output                |
|    all gates clean             |
+--------------------------------+

Stops: pass gates | max 12 iterations | no progress x2 | budget 30m, $5.0
```

## Emit Checklist

- The goal has a clear outcome, scope boundary, context sources, and done state.
- Verification criteria are typed as `programmatic`, `judge`, or `human`.
- At least one criterion is not purely vibe-based.
- Each `revise_until_clean` gate has a valid `verdict_source`.
- Every external invocation is an argv array with a timeout.
- Cross-vendor egress is scoped, redacted, and consent-gated.
- `loop_control` has iteration, revision, no-progress, and budget caps.
- Execution boundary and isolation are explicit.
- Observability names a `run-log.md` and `state.json` path.
- Compiled artifacts (`loop.resolved.json`, `LOOP.md`, `RUN_IN_SESSION.md`)
  pass validation before handoff.

© https://ft.ia.br · MIT · fabricioctelles/skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
loop-factory JuliusBrussee Скилл loop-factory для Claude Code, Codex, Cursor и других агентов: задачи живут как markdown-спеки и двигаются по конвейеру inbox → active → archive. Агент строит по критериям приёмки, а в архив спека попадает только после ревью. CX Codex +1 2 000установок continuous-agent-loop affaan-m Скилл continuous-agent-loop для Claude Code задаёт схему автономного цикла агента: выбор режима, контроль качества, прогон evals и выход из сбоев. Держит агент на ходу без ручного присмотра. CX Codex +1 6 300установок re0-loop LilMGenius Скилл re0-loop для Claude Code ведёт разработку через повторяющийся цикл сборки, проверки и фиксации выводов. Прогресс здесь измеряется решёнными задачами и модулями, а не объёмом написанных строк. CX Codex +1 1 400установок ralph-loop cursor Скилл ralph-loop запускает цикл, в котором агент получает одну и ту же задачу заново после каждого хода и видит свою прошлую работу. CX Codex +1 1 100установок gauntlet-loop robonuggets Скилл gauntlet-loop превращает любую цель в короткий промпт, который заставляет агента гонять работу по кругу, пока результат не побьёт реальный эталон. CX Codex +1 635установок check-if-done szarkans Проверяет, доведена ли задача до конца, а не просто выглядит завершённой: сверяет обещанное с кодом и требует команду, которая это подтвердит. Запускается перед PR или в конце сессии по фразам «is this done», «check if done». CX Codex +1 ★ 25звёзд репо

Из того же набора46

Весь набор →
human-ai Скилл human-ai редактирует английский текст: убирает шаблонные обороты и сохраняет факты, смысл и голос автора. Подходит для правки черновиков и заметок. CX Codex +1 ★ 141звёзд репо design-md-validator Скилл design-md-validator проверяет DESIGN.md на соответствие спецификации Google через CLI-линтер @google/design.md. Находит битые ссылки на токены и считает контраст по WCAG. CX Codex +1 ★ 141звёзд репо humanizar Скилл humanizar редактирует и пишет тексты на бразильском португальском без штампов нейросетей, строго сохраняя факты автора. CX Codex +1 ★ 141звёзд репо agent-plugin-eval Скилл agent-plugin-eval для Claude Code проверяет Agent Plugins по спецификации, выставляет оценку и сравнивает два репозитория. Задача — ревью перед выпуском. CX Codex +1 ★ 141звёзд репо astro-sites-manager Скилл astro-sites-manager помогает создавать и обновлять проекты на Astro v7, настраивать фоновый dev-сервер для агентов и связываться с MCP-сервером astro-docs. CX Codex +1 ★ 141звёзд репо ralph-loop-kiro-specs Скилл ralph-loop-kiro-specs запускает kiro-cli в цикле и берёт по одной задаче из спеки Kiro за итерацию. Пригодится, чтобы автоматизировать выполнение задач и проверку критериев выхода. CX Codex +1 ★ 141звёзд репо security-specialist Скилл security-specialist запускает аудит кодовой базы, строит модель угроз, находит подтверждённые уязвимости и оформляет отчёт в HTML. Помогает проверить репозиторий или пулреквест на эксплуатируемые ошибки. CX Codex +1 ★ 141звёзд репо human-ai Скилл human-ai редактирует английскую прозу: убирает шаблонные AI-обороты и сохраняет смысл, голос автора и фактические детали. CX Codex +1 ★ 141звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой