←Leaderboard/Agent Orchestration/architect-loop
Last commit on July 13, 2026·Created on June 12, 2026

DanMcInerney/architect-loop

“A structured framework for translating high-level system goals into detailed technical specifications.”
Combined rank
#490
across all skills
In Agent Orchestration
#25
category rank
Stars
627
+0.2% in last 7d
Forks
54
0.0% in last 7d
Watchers
0
0 watchers in last 7d
Traction scoreGitHub stars can be faked, so popularity alone can be misleading. Traction Score looks for broader signs of recent attention, adoption, and active maintenance.
TL;DR

Architect-loop provides a series of specialized AI workflows designed for technical leads and architects. It moves codebase design through a rigorous pipeline of research, architectural drafting, and adversarial review to ensure system integrity before implementation begins.

The framework focuses on converting abstract requirements into actionable specs and issues, reducing the risk of architectural drift while optimizing token consumption during complex design loops.

WHO IT'S FOR
Technical leads / architects
designing high-quality codebase architectures with AI
AI agent / automation builders
optimizing token usage in complex AI loops
Backend / infrastructure engineers
implementing features using strict TDD cycles
QA / test automation engineers
hardening specifications through adversarial review
Repository contents

11 skill files

Compatible AgentsThe repository documents support for these agents. The skills may also work with other agents that can load SKILL.md files, but they may need some setup or small changes.

Use this skill collection

Follow the documented setup, then try a first task.

I’m using

Bash user-profile installation

Installs: Complete architect-loop skills bundle installed into the user profile: Claude under $HOME/.claude/skills and Codex under $HOME/.agents/skills. · Claude, Codex

Before you start
  • Git
  • Bash
  • Codex CLI >= 0.133 when using Codex default Goal Mode; the Codex builder backend is otherwise optional.

Platform: Bash environment

Run from: A parent directory where the architect-loop repository should be cloned

  1. Clone the repository.

    git clone https://github.com/DanMcInerney/architect-loop
  2. Change into the cloned repository and run the Bash installer. The trailing comment records the corresponding Windows command and is preserved verbatim from the documented code unit.

    cd architect-loop && ./install.sh        # Windows: .\install.ps1
README.md ↗ · Checked Oct 2, 2026install.sh ↗ · Checked Oct 2, 2026

Give it something to do.

Suggested first task

Review one module's interface depth

Uses codebase-design

  • Local repository path
  • Target module or function
Use the codebase-design skill to review [target module or function] in [repository path]. Identify its interface and seam, assess whether it is deep or shallow using leverage, locality, and testability, and suggest one small redesign. Do not edit the code. Replace the bracketed placeholders with the local repository path and the specific module or function to review.
Suggested first task

Implement one behavior with a red-green cycle

Uses tdd

  • Local repository path
  • One small requested behavior
  • Pre-agreed seam from an issue or specification
Use the tdd skill to implement [one small behavior] at the pre-agreed seam [seam named by the issue or spec] in [repository path]. Write one failing behavior test, add only the minimal implementation needed to pass it, run the test, and report the command output and exit code. Do not refactor while RED. Replace the bracketed placeholders with the behavior, the existing named seam, and the local repository path.
skills/tdd/SKILL.md ↗ · Checked Oct 2, 2026