loop-factory

Runs a spec-driven agent loop moving markdown specs through inbox, active, and archive states.

Updated May 26, 2026
One-click install
npx skills add https://github.com/KinalVR-Expo2026/KinalVR-Client --skill loop-factory-kinalvr-expo2026
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: loop-factory
Source: https://github.com/KinalVR-Expo2026/KinalVR-Client/tree/main/.claude/.agents/skills/loop-factory
Command: npx skills add https://github.com/KinalVR-Expo2026/KinalVR-Client --skill loop-factory-kinalvr-expo2026

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It turns ad-hoc agent coding requests into a visible, reviewable assembly line where each task is a markdown spec whose folder location represents its state, preventing agents from silently deciding product direction. ## Core Features & Use Cases - Spec-driven task queue: Tasks live as markdown specs with frontmatter (id, agent, risk, verification) that move through inbox, active, and archive directories via the loop-factory CLI. - Dispatch, review, and archive gates: Generate implementation prompts for Claude Code or Codex, verify against acceptance criteria, and require an explicit accepted review before archiving. - Autonomous mode: Drain the inbox of grill-gated specs on a schedule via /loop or cron, building and verifying work while leaving acceptance as a human decision. - Use Case: A solo developer writes specs for upcoming features, grills each one for scope and risk, then runs a scheduled pass that implements and verifies ready specs overnight, reviewing the diffs in the morning. ## Quick Start Install the loop-factory CLI, run loop-factory init in your git repo, then ask the agent to scan the inbox and dispatch the first ready spec to Claude Code.

Frequently Asked Questions about loop-factory

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

FAQPage Schema
How do I set up a spec-driven agent loop in my repo?

Install the loop-factory CLI with pip install -e from the Loop-Factory repo, then run loop-factory init inside any git repository to scaffold the factory/specs directories. Run loop-factory doctor to confirm git and agent CLIs are wired up.

How do I dispatch a spec to Claude Code or Codex?

Run loop-factory dispatch --agent claude --stage to generate an implementation prompt and move the spec from inbox to active. Add --execute only when the local claude or codex CLI is installed and you want live execution.

Can the loop run autonomously on a schedule?

Yes, use /loop 30m /loop-factory for local recurring passes or the native /schedule command for cloud cron runs that return work as a pull request. Autonomous passes only build grill-gated specs and never archive anything.

What is the grill gate in a spec?

The grill gate is a section of questions answered before dispatch, covering decision ownership, scope, riskiest assumption, and smallest acceptable version. Specs without a completed grill gate are skipped in autonomous mode and flagged by loop-factory doctor.

Why won't loop-factory archive my finished spec?

Archiving requires the --accepted flag after a passing review, and only active specs can be archived. A failed review leaves the spec in active for another pass; there is no way to archive without confirmed acceptance by design.