requirement-loop

requirement-loop is a command for Claude Code from alphaelements/handoff-mcp. It costs 33 tokens per session (8,272 once invoked), scanned A, original, MIT.

A guided process for turning an idea into checked software requirements and a delivery plan. It pauses for your approval between stages such as architecture, detailed requirements, verification, and roadmap creation.

In plain words
What is it for?
It helps define system structure, non-functional requirements such as speed or security, testable acceptance criteria, review findings, a roadmap, and a project baseline.
Why use it?
It reduces unclear requirements, missed cases, and unapproved changes by making each planning step explicit. It also coordinates separate work for writing and checking requirements.

Command for Claude Code

Written for Claude Code: argument-hint in frontmatter. Also seen: names the AskUserQuestion tool.

Part of the handoff-task-loop plugin — 1 skill, 4 commands, 16 agents shipped together

Good fit It helps define system structure, non-functional requirements such as speed or security, testable acceptance criteria, review findings, a roadmap, and a project baseline.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/alphaelements/handoff-mcp/requirement-loop
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/alphaelements/handoff-mcp

Made for: Claude Code.

Or install handoff-task-loop, the plugin that ships this one along with the rest of its 1 skill, 4 commands, 16 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for requirement-loop

README.md
[![agentmods](https://agentmods.dev/badge/commands/alphaelements/handoff-mcp/requirement-loop/github.svg)](https://agentmods.dev/commands/alphaelements/handoff-mcp/requirement-loop)
Your own site
<a href="https://agentmods.dev/commands/alphaelements/handoff-mcp/requirement-loop"><img src="https://agentmods.dev/badge/commands/alphaelements/handoff-mcp/requirement-loop/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for requirement-loop

Your own site · 80×15
<a href="https://agentmods.dev/commands/alphaelements/handoff-mcp/requirement-loop"><img src="https://agentmods.dev/badge/commands/alphaelements/handoff-mcp/requirement-loop.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 33 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 8,272 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00033 $0.08272
Opus 5.5 $0.00013 $0.03309
Sonnet 5.5 $0.00007 $0.01654
Haiku 4.5 $0.00003 $0.00827

Measured 2d ago against content hash a84c70ebedc4, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

requirement-loop scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugin-task-loop/commands/requirement-loop.md · 609 lines

How it starts

The opening of the file, as written. The whole thing — 609 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Requirement Loop (Requirements Coordinator)

You are the requirements coordinator. You do not decompose, check, or review requirements at scale yourself. Your job is to run the dialogue phases with the user (profile, architecture, NFR), launch the requirement-execute Workflow for the parallel authoring and verification phases, finish the roadmap and baseline yourself, and hand the result to /session-loop. Between every two phases you stop at a user approval gate and run the matching preflight checklist.

Same role as the session manager in session-loop.md, applied to requirements: Opus, orchestration only, all state changes through handoff_* MCP tools.

Flow overview

Phase 0  Project initialization      (coordinator + user)   -> Gate #0  profile
Phase 1  Architecture design         (coordinator + user)   -> Gate #1  system context + scopes
Phase 2  Shared contracts (NFR)      (coordinator + user)   -> Gate #2  NFR checklist result
Phase 3  Basic requirements          (Workflow: DRAFT+CHECK)-> Gate #3  tree + coverage + lint
Phase 4  Adversarial verification    (Workflow: REVIEW loop)-> Gate #4  final requirements + quality
Phase 5  Roadmap                     (coordinator)          -> Gate #5  tasks + schedule + plan
Phase 6  Baseline and handoff        (coordinator)          -> /session-loop

Each gate = preflight checklist (skills/handoff-requirements/references/preflight-checklists.md) + AskUserQuestion approval. Never enter the next phase on a failed checklist or without an explicit "approved" answer.

Which parts run where

Phase Executor Why
0-2 coordinator (you) with the user needs user decisions; no agent can answer them
3-4 requirement-execute Workflow per-scope work is independent and parallel; review needs a fresh Opus context
5-6 coordinator (you) short, mechanical, and need the user's approval of tasks and schedule

One Workflow run covers Phases 3 and 4. requirement-execute runs DRAFT -> CHECK -> REVIEW (-> REWORK, up to max_rounds) -> REGISTER in a single call and returns once. You launch it once (Phase 3), then present Gate #3 from the first-round worker/checker reports and Gate #4 from the review result and final state. See "Workflow behaviors you must account for" below for the registrar caveat.

Read the full file on GitHub · 609 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 609 lines · 33 tokens per session scan A a84c70ebedc4

Subscribe to this mod's changes

requirement-loop is a command published in the GitHub repository alphaelements/handoff-mcp (0 stars, last pushed 3d ago), licensed MIT. It adds 33 tokens to every session and 8,272 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-20.