ralph-loop

Automate loop development for user stories in prd.json with progress tracking.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/ddmanyes/antigravity-skills-zht --skill ralph-loop-ddmanyes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-loop
Source: https://github.com/ddmanyes/antigravity-skills-zht/tree/main/skills/ralph-loop
Command: npx skills add https://github.com/ddmanyes/antigravity-skills-zht --skill ralph-loop-ddmanyes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

讓 AI 代理人根據 prd.json 進行自主循環開發,每一輪任務後標記進度並交由系統重啟 Context。

Core Features & Use Cases

  • 自動循環開發:讓 AI 代理人根據需求清單循環實作、測試與更新,逐步完成所有使用者故事。
  • 進度追蹤與重置:每輪結束自動記錄進度並重啟 Context,以避免狀態污染。
  • 適用場景:適用於需要長時間、多階段迭代的軟體開發與需求實作。

Quick Start

依序自動選取 prd.json 中第一個尚未完成的使用者故事並實作,完成後更新進度並重啟 Context。

Frequently Asked Questions about ralph-loop

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

FAQPage Schema
How do I automate autonomous loop development for user stories in prd.json?

Autonomous loop development for prd.json is automated by reading user stories, implementing tasks, running tests, updating progress.txt, and restarting context after each cycle. This enforces a single-task-per-cycle workflow to iteratively complete all defined requirements.

What is the best way to track progress and prevent context pollution during long AI agent development cycles?

Tracking progress and preventing context pollution is handled by automatically recording results in progress.txt and restarting context after each development cycle. This approach ensures the AI agent maintains a clean state and avoids status contamination across iterative loops.

How does context restart work with autonomous AI agents for continuous software development?

Context restart for autonomous AI agents works by completing one task per cycle, saving the outcome, and resetting the operational context. This mechanism prevents state pollution and allows the agent to resume subsequent user stories defined in prd.json with a clean environment.

Do I need AGENTS.md and prd.json to run autonomous development cycles?

Yes, AGENTS.md and prd.json are required to run autonomous development cycles. The workflow reads these files alongside progress.txt to identify pending user stories, execute tasks, enforce the single-task-per-cycle rule, and mark stories as passed when tests succeed.

Why does my AI agent stop after completing one user story instead of continuing the loop?

An AI agent stops after one user story because the workflow enforces a single-task-per-cycle rule. After executing the task, it records results, updates progress.txt, and relies on the system to restart context for the next pending story in prd.json.

Can I use this autonomous loop for multi-stage software iterations and requirement implementation?

Yes, this autonomous loop is designed for multi-stage software iterations and requirement implementation. It continuously selects the first unfinished user story from prd.json, implements it, runs tests, and updates progress until all stories are marked as passed.