loop-architect

Classify agent-loop tasks and select loop architecture with a structured ADR.

1|Updated Jun 20, 2026
One-click install
npx skills add https://github.com/SollanSystems/loop-engineer --skill loop-architect-sollansystems
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: loop-architect
Source: https://github.com/SollanSystems/loop-engineer/tree/main/skills/loop-architect
Command: npx skills add https://github.com/SollanSystems/loop-engineer --skill loop-architect-sollansystems

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns an ambiguous agent-loop request into a concrete architecture decision so you can avoid building the wrong kind of system.

Core Features & Use Cases

  • Architecture selection: Chooses between single-agent, supervisor, multi-agent, and repo-backed loop shapes.
  • Realization mapping: Matches the task to the right Claude Code execution style and control flow.
  • Decision output: Produces a structured ADR with risk profile, terminal states, loop patterns, and next spokes.
  • Use case: Use it when you need to decide whether a task should be handled by one agent, many agents, or an acceptance-gated workflow.

Quick Start

Ask the loop-architect skill to classify your task, choose the loop architecture, and emit an ADR for the next steps.

Frequently Asked Questions about loop-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose the right loop architecture for an ambiguous agent task?

To choose the right loop architecture, classify the agent task to determine if it requires a single-agent, supervisor, multi-agent, or repo-backed loop shape based on your specific objectives and constraints.

When do I need a multi-agent loop architecture instead of a single agent?

You need a multi-agent loop architecture when a task involves long-horizon repo-backed work or acceptance-gated slices that exceed a single agent's capacity, requiring a supervisor to orchestrate downstream execution.

What is an architecture decision record for Claude Code agent orchestration?

An architecture decision record (ADR) for Claude Code agent orchestration is a structured output that captures the chosen loop patterns, realization, risk profile, terminal states, and next spokes for downstream execution.

How do I map an agent workflow design to a specific Claude Code realization?

You map an agent workflow design to a Claude Code realization by classifying the task's control flow requirements and selecting the execution style that matches your acceptance-gated slices or underspecified objectives.

Can I use loop architecture selection for underspecified objectives?

Yes, you can use loop architecture selection for underspecified objectives because the process classifies the task and produces a structured ADR to concretize the architecture decision before building the system.

What are the limitations of using a single agent for long-horizon repo-backed work?

The limitation of using a single agent for long-horizon repo-backed work is the inability to handle complex, acceptance-gated slices, which necessitates a supervisor or multi-agent loop architecture to manage terminal states effectively.