{"id":"5b1aecf3-0453-42f2-a67d-ff79fb3a6319","entityType":"agent","slug":"clawhub-caesargattuso-looop","name":"looop","canonicalUrl":"https://www.xpersona.co/agent/clawhub-caesargattuso-looop","canonicalPath":"/agent/clawhub-caesargattuso-looop","generatedAt":"2026-10-11T17:42:15.295Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T14:25:39.887Z","emptyReason":null},"description":"Claude Automated Development Toolkit - Decompose requirements documents, single files, or inline text into detailed task lists and automatically execute in l... Skill: looop Owner: caesargattuso Summary: Claude Automated Development Toolkit - Decompose requirements documents, single files, or inline text into detailed task lists and automatically execute in l... Tags: latest:1.1.1 Version history: v1.1.1 | 2026-04-23T08:03:21.404Z | user No user-visible changes in this version. - Changelog note: No file changes detected; SKILL.md appears unchanged except for truncation at th","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s17ej72f0pesej3c1zbge90x9s856xg2:looop","sourceUrl":"https://clawhub.ai/caesargattuso/looop","homepage":"https://clawhub.ai/caesargattuso/skills/looop","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/caesargattuso/looop","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/caesargattuso/skills/looop","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Claude Automated Development Toolkit - Decompose requirements documents, single files, or inline text into detailed task lists and automatically execute in l..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:25:39.887Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:25:39.887Z","emptyReason":null},"stars":null,"forks":null,"downloads":1050,"packageName":null,"latestVersion":"1.1.1","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:25:39.813Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T14:25:39.887Z","lastCrawledAt":"2026-10-11T14:25:39.813Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T14:25:39.813Z","lastVerifiedAt":null,"highlights":[{"version":"1.1.1","createdAt":"2026-04-23T08:03:21.404Z","changelog":"No user-visible changes in this version. - Changelog note: No file changes detected; SKILL.md appears unchanged except for truncation at the end. Functionality and parameters remain as previously described.","fileCount":6,"zipByteSize":16698},{"version":"1.1.0","createdAt":"2026-04-23T07:40:42.351Z","changelog":"looop 1.0.9 - Expanded requirements decomposition: Supports projects defined by directory, single file, or inline text. - Enhanced task breakdown: Each task now includes task type, estimated files, and clear acceptance criteria. - Updated `tasks.json` structure for greater technical detail and precise project tracking. - Clarified usage notes and improved documentation for all inputs and outputs.","fileCount":5,"zipByteSize":14274},{"version":"1.0.8","createdAt":"2026-04-23T06:03:53.422Z","changelog":"- Added support for inline requirement decomposition with the new `--requirement ` parameter. - `--docs`, `--doc`, and `--requirement` options are now mutually exclusive for decomposition. - Documentation and usage examples updated to reflect support for one-line inline requirements. - The `tasks.json` structure now accommodates inline requirements via `\"requirements_text\"` and sets `\"docs_dir\": null` when applicable.","fileCount":5,"zipByteSize":11459},{"version":"1.0.7","createdAt":"2026-04-22T10:05:27.308Z","changelog":"- Documentation updated for consistency, clarifying that all .looop files are stored under instead of specifically src/. - Minor formatting and table improvements for improved readability. - No changes to code logic or file structure.","fileCount":5,"zipByteSize":10923},{"version":"1.0.6","createdAt":"2026-04-22T09:51:14.528Z","changelog":"- No code or documentation changes detected. - Version bump only; contents and usage remain unchanged from previous release.","fileCount":5,"zipByteSize":10792},{"version":"1.0.5","createdAt":"2026-04-22T09:48:57.135Z","changelog":"- No code or documentation changes detected in this release. - Version bumped to 1.0.5 without any functional modifications.","fileCount":5,"zipByteSize":10879},{"version":"1.0.4","createdAt":"2026-04-22T07:29:42.103Z","changelog":"- Added support for decomposing a single requirements document using the new --doc parameter. - Clarified mutual exclusivity between --docs (directory) and --doc (single file) for decomposition. - Updated usage examples and documentation to show both directory and single file decomposition modes. - Improved parameter table and instructions for greater clarity on decomposition options. - No code changes; documentation update only.","fileCount":5,"zipByteSize":10793},{"version":"1.0.3","createdAt":"2026-04-21T09:30:39.867Z","changelog":"- No file changes detected for this version. - Documentation and usage details remain consistent with the previous version. - No functional or interface changes present in this release.","fileCount":5,"zipByteSize":10466}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17ej72f0pesej3c1zbge90x9s856xg2:looop","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-caesargattuso-looop/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-caesargattuso-looop/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-caesargattuso-looop/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-caesargattuso-looop/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-caesargattuso-looop/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-caesargattuso-looop/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T17:42:15.294Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-caesargattuso-looop/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-caesargattuso-looop/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-caesargattuso-looop/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-caesargattuso-looop/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T14:25:39.887Z","emptyReason":null},"readme":"Skill: looop\n\nOwner: caesargattuso\n\nSummary: Claude Automated Development Toolkit - Decompose requirements documents, single files, or inline text into detailed task lists and automatically execute in l...\n\nTags: latest:1.1.1\n\nVersion history:\n\nv1.1.1 | 2026-04-23T08:03:21.404Z | user\n\nNo user-visible changes in this version.\n- Changelog note: No file changes detected; SKILL.md appears unchanged except for truncation at the end. Functionality and parameters remain as previously described.\n\nv1.1.0 | 2026-04-23T07:40:42.351Z | user\n\nlooop 1.0.9\n\n- Expanded requirements decomposition: Supports projects defined by directory, single file, or inline text.\n- Enhanced task breakdown: Each task now includes task type, estimated files, and clear acceptance criteria.\n- Updated `tasks.json` structure for greater technical detail and precise project tracking.\n- Clarified usage notes and improved documentation for all inputs and outputs.\n\nv1.0.8 | 2026-04-23T06:03:53.422Z | user\n\n- Added support for inline requirement decomposition with the new `--requirement ` parameter.\n- `--docs`, `--doc`, and `--requirement` options are now mutually exclusive for decomposition.\n- Documentation and usage examples updated to reflect support for one-line inline requirements.\n- The `tasks.json` structure now accommodates inline requirements via `\"requirements_text\"` and sets `\"docs_dir\": null` when applicable.\n\nv1.0.7 | 2026-04-22T10:05:27.308Z | user\n\n- Documentation updated for consistency, clarifying that all .looop files are stored under instead of specifically src/.\n- Minor formatting and table improvements for improved readability.\n- No changes to code logic or file structure.\n\nv1.0.6 | 2026-04-22T09:51:14.528Z | user\n\n- No code or documentation changes detected.\n- Version bump only; contents and usage remain unchanged from previous release.\n\nv1.0.5 | 2026-04-22T09:48:57.135Z | user\n\n- No code or documentation changes detected in this release.\n- Version bumped to 1.0.5 without any functional modifications.\n\nv1.0.4 | 2026-04-22T07:29:42.103Z | user\n\n- Added support for decomposing a single requirements document using the new --doc parameter.\n- Clarified mutual exclusivity between --docs (directory) and --doc (single file) for decomposition.\n- Updated usage examples and documentation to show both directory and single file decomposition modes.\n- Improved parameter table and instructions for greater clarity on decomposition options.\n- No code changes; documentation update only.\n\nv1.0.3 | 2026-04-21T09:30:39.867Z | user\n\n- No file changes detected for this version.\n- Documentation and usage details remain consistent with the previous version.\n- No functional or interface changes present in this release.\n\nv1.0.2 | 2026-04-21T09:15:49.361Z | user\n\n- Added logger.py for task execution logging.\n- Introduced per-task log files saved to src/.looop/ with timestamps and task details.\n- Log files contain task start/end times, full Claude CLI output, and debug info.\n- No logs generated for status queries or manual intervention commands.\n- Updated documentation to describe new log file structure and usage.\n\nv1.0.1 | 2026-04-21T07:32:34.383Z | user\n\n- Added requirements and permissions sections to SKILL.md, specifying dependencies (claude-cli, git) and granted permissions.\n- Included a warning about bypassing permission checks and auto-committing/pushing to git.\n- No file or functional changes; documentation update only.\n\nv1.0.0 | 2026-04-20T09:58:26.547Z | user\n\n- Initial release of the Claude Automated Development Toolkit (\"looop\") skill.\n- Converts requirements documents into structured task lists and automates task execution in a loop until project completion.\n- Supports phased workflow: requirements decomposition and task execution, with status tracking and progress recording.\n- Stores all task data and progress in the `src/.looop/` directory.\n- Provides various command-line parameters for decomposing requirements, task execution, progress viewing, manual intervention, and git integration.\n\nArchive index:\n\nArchive v1.1.1: 6 files, 16698 bytes\n\nFiles: logger.py (5795b), run.py (33926b), skill-card.md (2275b), skill.md (8173b), task_utils.py (4008b), _meta.json (124b)\n\nFile v1.1.1:skill.md\n\n---\nname: looop\ndescription: Claude Automated Development Toolkit - Decompose requirements documents, single files, or inline text into detailed task lists and automatically execute in loops until project completion\nrequires:\n - claude-cli: Requires local Claude CLI installation\n - git: Modifies git repository (commits changes)\n - push: Optional git push to remote (--push flag)\npermissions:\n - dangerous: Uses --dangerously-skip-permissions to bypass permission prompts\n - write: Writes files to specified src directory\n - git-commit: Automatically commits task completions\n - git-push: Optional push with --push flag\nwarning: This skill bypasses permission checks and automatically commits/pushes to git. Use with caution on trusted projects only.\n---\n\n# Claude Automated Development Toolkit\n\nYou are an automated development assistant responsible for decomposing project requirements (from documents, single files, or inline text) into executable task lists and automatically executing each task in loops until the project is complete.\n\n## Parameters\n\n| Parameter | Required When | Description |\n|--------------------|----------------------------|----------------------------------------|\n| `--docs ` | Decomposing requirements directory | Requirements document directory path |\n| `--doc ` | Decomposing single doc file | Single requirements document file path |\n| `--requirement ` | Decomposing inline requirement | Direct requirement text string |\n| `--src ` | Always required | Code storage directory path |\n\n**Note:** `--docs`, `--doc`, and `--requirement` are mutually exclusive for decomposition. Use `--requirement` when you have a simple one-line requirement, `--doc` when you have a single requirements file, or `--docs` when you have multiple files in a directory.\n\n## File Storage Location\n\nAll task-related files are stored in `/.looop/` directory:\n\n| File | Path | Description |\n|--------------|---------------------------------|-----------------------|\n| tasks.json | `/.looop/tasks.json` | Task list data |\n| progress.txt | `/.looop/progress.txt` | Task progress records |\n| *.log | `/.looop/*.log` | Task execution logs |\n\n## Log Files\n\nTask execution logs are created per task, named by task ID, name and timestamp:\n\n| Filename Pattern | When Created |\n|---------------------------------------------|----------------------------|\n| `Task_#0_Decompose_YYYY-MM-DD_HH-MM-SS.log` | Requirements decomposition |\n| `Task_#N_TaskName_YYYY-MM-DD_HH-MM-SS.log` | Each task execution |\n\n**Log content:**\n\n- Task start/end timestamps (second precision)\n- Complete Claude CLI output (JSON stream)\n- Debug information\n\n**No log files for:**\n\n- `--status` (status query)\n- `--mark-manual` / `--list-manual` / `--resolve-manual` (manual operations)\n\n## Execute Script\n\n**Important**: Change to the skill directory first before running the script.\n\n```bash\ncd && python run.py --src [--docs | --doc | --requirement ] [other parameters]\n```\n\n## Core Workflow\n\n### Phase 1: Task Decomposition (requires docs/doc/requirement + src)\n\n**Directory mode:** `python run.py --docs --src --decompose`\n\n**Single file mode:** `python run.py --doc --src --decompose`\n\n**Inline requirement mode:** `python run.py --requirement \"\" --src --decompose`\n\nThe script will automatically:\n\n1. Create `/.looop/` directory\n2. Read requirement source (documents or inline text)\n3. Call Claude to analyze and decompose into independent small tasks\n4. Set ID, name, description, priority, dependencies, task_type, estimated_files, acceptance_criteria for each task\n5. Save task list to `/.looop/tasks.json`\n\n### Phase 2: Task Execution (only requires src)\n\nCommand: `python run.py --src `\n\nThe script will first check if `/.looop/tasks.json` exists:\n\n- Not exists → Prompt to run `--decompose` first\n- Exists → Automatically execute tasks in loops\n\nExecution process:\n\n1. Select next executable task from tasks.json\n2. Call Claude to execute task, code goes into src directory\n3. Record progress to progress.txt\n4. Update task status, execute git commit\n5. Continue next round until all tasks complete\n\n## Optional Parameters\n\n| Parameter | Short | Description |\n|-------------------------|-----------|-------------------------------------------------|\n| `--decompose` | `-d` | Decompose requirements documents or text into task list |\n| `--status` | `-s` | View task status statistics |\n| `--max-tasks ` | `-m ` | Maximum N tasks to execute |\n| `--push` | `-P` | Execute git push after completion |\n| `--mark-manual ` | `-M ` | Mark task as needing manual intervention |\n| `--list-manual` | `-L` | List tasks needing manual intervention |\n| `--resolve-manual ` | `-R ` | Restore task to pending status |\n\n## Usage Examples\n\n```\n# Decompose requirements from directory (requires docs + src)\npython run.py --docs docs --src src --decompose\n\n# Decompose from single document file\npython run.py --doc docs/feature-x.md --src src --decompose\n\n# Decompose from inline requirement text\npython run.py --requirement \"Implement a user login feature with form validation and JWT authentication\" --src src --decompose\n\n# Execute tasks (only requires src)\npython run.py --src src\n\n# View status\npython run.py --src src --status\n\n# Execute max 3 tasks and push\npython run.py --src src --max-tasks 3 --push\n```\n\n## tasks.json Data Structure\n\n```json\n{\n \"project\": \"Project name\",\n \"created_at\": \"YYYY-MM-DD\",\n \"docs_dir\": \"docs\",\n \"src_dir\": \"src\",\n \"requirements_docs\": [\n \"docs/xxx.md\"\n ],\n \"tasks\": [\n {\n \"id\": 1,\n \"name\": \"Task name (concise, imperative)\",\n \"description\": \"Detailed technical description including: what to build, files to create/modify, key implementation points\",\n \"priority\": \"high|medium|low\",\n \"dependencies\": [],\n \"task_type\": \"setup|core|feature|refactor|test|docs\",\n \"estimated_files\": [\"expected_file_path_1\"],\n \"acceptance_criteria\": [\"Specific verifiable criteria\"],\n \"status\": \"pending\",\n \"result\": null,\n \"issues\": [],\n \"completed_at\": null\n }\n ]\n}\n```\n\n**Task Fields:**\n| Field | Description |\n|-------|-------------|\n| `id` | Unique task identifier |\n| `name` | Concise imperative name (e.g. 'Create user model') |\n| `description` | Detailed technical description with what/how/why/scope |\n| `priority` | high (essential), medium (important), low (optional) |\n| `dependencies` | Array of task IDs that must complete first |\n| `task_type` | setup, core, feature, refactor, test, docs |\n| `estimated_files` | Expected files to be created/modified |\n| `acceptance_criteria` | Specific verifiable completion criteria |\n| `status` | pending, in_progress, completed, blocked, needs_manual |\n\n**Note:** When using `--requirement`, the structure will include `\"requirements_text\": \"...\"` and `\"docs_dir\": null` instead of `\"requirements_docs\"` and `\"docs_dir\"`.\n\n## Task Status\n\n| Status | Description |\n|----------------|---------------------------|\n| `pending` | Pending execution |\n| `in_progress` | Currently executing |\n| `completed` | Completed |\n| `blocked` | Blocked |\n| `needs_manual` | Needs manual intervention |\n\n## Execution Flow\n\n1. **Receive parameters** - Parse src (required) and optional docs/doc/requirement\n2. **Build command** - Build python command based on parameters\n3. **Execute script** - Change to skill directory, then run run.py using Bash tool\n4. **Output results** - Display execution output and progress\n\nFile v1.1.1:_meta.json\n\n{\n \"ownerId\": \"kn710gz4y1jn74v7nch4cdwe5n856v16\",\n \"slug\": \"looop\",\n \"version\": \"1.1.1\",\n \"publishedAt\": 1776931401404\n}\n\nFile v1.1.1:skill-card.md\n\n## Description:\n\nClaude Automated Development Toolkit decomposes requirements from documents, files, or inline text into task lists and can execute those tasks through Claude CLI until project completion.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[caesargattuso](https://clawhub.ai/user/caesargattuso)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and engineering teams use looop to turn requirements into a tracked implementation plan and optionally have Claude CLI execute the tasks inside a source directory.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill automates Claude CLI to modify code and commit changes with broad authority.\n\nMitigation: Install only for trusted, disposable or well-backed-up repositories and inspect every diff before sharing or pushing.\n\nRisk: Optional git push can publish unintended automated changes.\n\nMitigation: Avoid --push unless the repository and remote are intentionally prepared for automated updates.\n\nRisk: .looop logs may contain sensitive Claude output.\n\nMitigation: Ignore, clean, or review .looop logs before committing or sharing project contents.\n\nRisk: Unbounded task execution can make many changes before human review.\n\nMitigation: Review tasks.json before execution and set --max-tasks for staged runs.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/caesargattuso/skills/looop)\n- [Publisher profile](https://clawhub.ai/user/caesargattuso)\n- [Claude Code](https://claude.ai/code)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance, files]\n\n**Output Format:** [Console text, JSON task files, logs, Markdown-style progress summaries, code changes, and git commits.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Writes task state, progress, and logs under /.looop; can optionally commit and push changes.]\n\n## Skill Version(s):\n\n1.1.1 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.1.0: 5 files, 14274 bytes\n\nFiles: logger.py (5795b), run.py (28555b), skill.md (8173b), task_utils.py (4008b), _meta.json (124b)\n\nFile v1.1.0:skill.md\n\n---\nname: looop\ndescription: Claude Automated Development Toolkit - Decompose requirements documents, single files, or inline text into detailed task lists and automatically execute in loops until project completion\nrequires:\n - claude-cli: Requires local Claude CLI installation\n - git: Modifies git repository (commits changes)\n - push: Optional git push to remote (--push flag)\npermissions:\n - dangerous: Uses --dangerously-skip-permissions to bypass permission prompts\n - write: Writes files to specified src directory\n - git-commit: Automatically commits task completions\n - git-push: Optional push with --push flag\nwarning: This skill bypasses permission checks and automatically commits/pushes to git. Use with caution on trusted projects only.\n---\n\n# Claude Automated Development Toolkit\n\nYou are an automated development assistant responsible for decomposing project requirements (from documents, single files, or inline text) into executable task lists and automatically executing each task in loops until the project is complete.\n\n## Parameters\n\n| Parameter | Required When | Description |\n|--------------------|----------------------------|----------------------------------------|\n| `--docs ` | Decomposing requirements directory | Requirements document directory path |\n| `--doc ` | Decomposing single doc file | Single requirements document file path |\n| `--requirement ` | Decomposing inline requirement | Direct requirement text string |\n| `--src ` | Always required | Code storage directory path |\n\n**Note:** `--docs`, `--doc`, and `--requirement` are mutually exclusive for decomposition. Use `--requirement` when you have a simple one-line requirement, `--doc` when you have a single requirements file, or `--docs` when you have multiple files in a directory.\n\n## File Storage Location\n\nAll task-related files are stored in `/.looop/` directory:\n\n| File | Path | Description |\n|--------------|---------------------------------|-----------------------|\n| tasks.json | `/.looop/tasks.json` | Task list data |\n| progress.txt | `/.looop/progress.txt` | Task progress records |\n| *.log | `/.looop/*.log` | Task execution logs |\n\n## Log Files\n\nTask execution logs are created per task, named by task ID, name and timestamp:\n\n| Filename Pattern | When Created |\n|---------------------------------------------|----------------------------|\n| `Task_#0_Decompose_YYYY-MM-DD_HH-MM-SS.log` | Requirements decomposition |\n| `Task_#N_TaskName_YYYY-MM-DD_HH-MM-SS.log` | Each task execution |\n\n**Log content:**\n\n- Task start/end timestamps (second precision)\n- Complete Claude CLI output (JSON stream)\n- Debug information\n\n**No log files for:**\n\n- `--status` (status query)\n- `--mark-manual` / `--list-manual` / `--resolve-manual` (manual operations)\n\n## Execute Script\n\n**Important**: Change to the skill directory first before running the script.\n\n```bash\ncd && python run.py --src [--docs | --doc | --requirement ] [other parameters]\n```\n\n## Core Workflow\n\n### Phase 1: Task Decomposition (requires docs/doc/requirement + src)\n\n**Directory mode:** `python run.py --docs --src --decompose`\n\n**Single file mode:** `python run.py --doc --src --decompose`\n\n**Inline requirement mode:** `python run.py --requirement \"\" --src --decompose`\n\nThe script will automatically:\n\n1. Create `/.looop/` directory\n2. Read requirement source (documents or inline text)\n3. Call Claude to analyze and decompose into independent small tasks\n4. Set ID, name, description, priority, dependencies, task_type, estimated_files, acceptance_criteria for each task\n5. Save task list to `/.looop/tasks.json`\n\n### Phase 2: Task Execution (only requires src)\n\nCommand: `python run.py --src `\n\nThe script will first check if `/.looop/tasks.json` exists:\n\n- Not exists → Prompt to run `--decompose` first\n- Exists → Automatically execute tasks in loops\n\nExecution process:\n\n1. Select next executable task from tasks.json\n2. Call Claude to execute task, code goes into src directory\n3. Record progress to progress.txt\n4. Update task status, execute git commit\n5. Continue next round until all tasks complete\n\n## Optional Parameters\n\n| Parameter | Short | Description |\n|-------------------------|-----------|-------------------------------------------------|\n| `--decompose` | `-d` | Decompose requirements documents or text into task list |\n| `--status` | `-s` | View task status statistics |\n| `--max-tasks ` | `-m ` | Maximum N tasks to execute |\n| `--push` | `-P` | Execute git push after completion |\n| `--mark-manual ` | `-M ` | Mark task as needing manual intervention |\n| `--list-manual` | `-L` | List tasks needing manual intervention |\n| `--resolve-manual ` | `-R ` | Restore task to pending status |\n\n## Usage Examples\n\n```\n# Decompose requirements from directory (requires docs + src)\npython run.py --docs docs --src src --decompose\n\n# Decompose from single document file\npython run.py --doc docs/feature-x.md --src src --decompose\n\n# Decompose from inline requirement text\npython run.py --requirement \"Implement a user login feature with form validation and JWT authentication\" --src src --decompose\n\n# Execute tasks (only requires src)\npython run.py --src src\n\n# View status\npython run.py --src src --status\n\n# Execute max 3 tasks and push\npython run.py --src src --max-tasks 3 --push\n```\n\n## tasks.json Data Structure\n\n```json\n{\n \"project\": \"Project name\",\n \"created_at\": \"YYYY-MM-DD\",\n \"docs_dir\": \"docs\",\n \"src_dir\": \"src\",\n \"requirements_docs\": [\n \"docs/xxx.md\"\n ],\n \"tasks\": [\n {\n \"id\": 1,\n \"name\": \"Task name (concise, imperative)\",\n \"description\": \"Detailed technical description including: what to build, files to create/modify, key implementation points\",\n \"priority\": \"high|medium|low\",\n \"dependencies\": [],\n \"task_type\": \"setup|core|feature|refactor|test|docs\",\n \"estimated_files\": [\"expected_file_path_1\"],\n \"acceptance_criteria\": [\"Specific verifiable criteria\"],\n \"status\": \"pending\",\n \"result\": null,\n \"issues\": [],\n \"completed_at\": null\n }\n ]\n}\n```\n\n**Task Fields:**\n| Field | Description |\n|-------|-------------|\n| `id` | Unique task identifier |\n| `name` | Concise imperative name (e.g. 'Create user model') |\n| `description` | Detailed technical description with what/how/why/scope |\n| `priority` | high (essential), medium (important), low (optional) |\n| `dependencies` | Array of task IDs that must complete first |\n| `task_type` | setup, core, feature, refactor, test, docs |\n| `estimated_files` | Expected files to be created/modified |\n| `acceptance_criteria` | Specific verifiable completion criteria |\n| `status` | pending, in_progress, completed, blocked, needs_manual |\n\n**Note:** When using `--requirement`, the structure will include `\"requirements_text\": \"...\"` and `\"docs_dir\": null` instead of `\"requirements_docs\"` and `\"docs_dir\"`.\n\n## Task Status\n\n| Status | Description |\n|----------------|---------------------------|\n| `pending` | Pending execution |\n| `in_progress` | Currently executing |\n| `completed` | Completed |\n| `blocked` | Blocked |\n| `needs_manual` | Needs manual intervention |\n\n## Execution Flow\n\n1. **Receive parameters** - Parse src (required) and optional docs/doc/requirement\n2. **Build command** - Build python command based on parameters\n3. **Execute script** - Change to skill directory, then run run.py using Bash tool\n4. **Output results** - Display execution output and progress\n\nFile v1.1.0:_meta.json\n\n{\n \"ownerId\": \"kn710gz4y1jn74v7nch4cdwe5n856v16\",\n \"slug\": \"looop\",\n \"version\": \"1.1.0\",\n \"publishedAt\": 1776930042351\n}\n\nArchive v1.0.8: 5 files, 11459 bytes\n\nFiles: logger.py (5799b), run.py (19297b), skill.md (7051b), task_utils.py (4008b), _meta.json (124b)\n\nFile v1.0.8:skill.md\n\n---\nname: looop\ndescription: Claude Automated Development Toolkit - Decompose requirements documents into task lists and automatically execute in loops until project completion\nrequires:\n - claude-cli: Requires local Claude CLI installation\n - git: Modifies git repository (commits changes)\n - push: Optional git push to remote (--push flag)\npermissions:\n - dangerous: Uses --dangerously-skip-permissions to bypass permission prompts\n - write: Writes files to specified src directory\n - git-commit: Automatically commits task completions\n - git-push: Optional push with --push flag\nwarning: This skill bypasses permission checks and automatically commits/pushes to git. Use with caution on trusted projects only.\n---\n\n# Claude Automated Development Toolkit\n\nYou are an automated development assistant responsible for decomposing project requirements documents into executable\ntask lists and automatically executing each task in loops until the project is complete.\n\n## Parameters\n\n| Parameter | Required When | Description |\n|--------------------|----------------------------|----------------------------------------|\n| `--docs ` | Decomposing requirements directory | Requirements document directory path |\n| `--doc ` | Decomposing single doc file | Single requirements document file path |\n| `--requirement ` | Decomposing inline requirement | Direct requirement text string |\n| `--src ` | Always required | Code storage directory path |\n\n**Note:** `--docs`, `--doc`, and `--requirement` are mutually exclusive for decomposition. Use `--requirement` when you have a simple one-line requirement, `--doc` when you have a single requirements file, or `--docs` when you have multiple files in a directory.\n\n## File Storage Location\n\nAll task-related files are stored in `/.looop/` directory:\n\n| File | Path | Description |\n|--------------|---------------------------------|-----------------------|\n| tasks.json | `/.looop/tasks.json` | Task list data |\n| progress.txt | `/.looop/progress.txt` | Task progress records |\n| *.log | `/.looop/*.log` | Task execution logs |\n\n## Log Files\n\nTask execution logs are created per task, named by task ID, name and timestamp:\n\n| Filename Pattern | When Created |\n|---------------------------------------------|----------------------------|\n| `Task_#0_Decompose_YYYY-MM-DD_HH-MM-SS.log` | Requirements decomposition |\n| `Task_#N_TaskName_YYYY-MM-DD_HH-MM-SS.log` | Each task execution |\n\n**Log content:**\n\n- Task start/end timestamps (second precision)\n- Complete Claude CLI output (JSON stream)\n- Debug information\n\n**No log files for:**\n\n- `--status` (status query)\n- `--mark-manual` / `--list-manual` / `--resolve-manual` (manual operations)\n\n## Execute Script\n\n**Important**: Change to the skill directory first before running the script.\n\n```bash\ncd && python run.py --src [--docs | --doc | --requirement ] [other parameters]\n```\n\n## Core Workflow\n\n### Phase 1: Task Decomposition (requires docs/doc/requirement + src)\n\n**Directory mode:** `python run.py --docs --src --decompose`\n\n**Single file mode:** `python run.py --doc --src --decompose`\n\n**Inline requirement mode:** `python run.py --requirement \"\" --src --decompose`\n\nThe script will automatically:\n\n1. Create `/.looop/` directory\n2. Read requirement source (documents or inline text)\n3. Call Claude to analyze and decompose into independent small tasks\n4. Set ID, name, description, priority, dependencies for each task\n5. Save task list to `/.looop/tasks.json`\n\n### Phase 2: Task Execution (only requires src)\n\nCommand: `python run.py --src `\n\nThe script will first check if `/.looop/tasks.json` exists:\n\n- Not exists → Prompt to run `--decompose` first\n- Exists → Automatically execute tasks in loops\n\nExecution process:\n\n1. Select next executable task from tasks.json\n2. Call Claude to execute task, code goes into src directory\n3. Record progress to progress.txt\n4. Update task status, execute git commit\n5. Continue next round until all tasks complete\n\n## Optional Parameters\n\n| Parameter | Short | Description |\n|-------------------------|-----------|-------------------------------------------------|\n| `--decompose` | `-d` | Decompose requirements documents or text into task list |\n| `--status` | `-s` | View task status statistics |\n| `--max-tasks ` | `-m ` | Maximum N tasks to execute |\n| `--push` | `-P` | Execute git push after completion |\n| `--mark-manual ` | `-M ` | Mark task as needing manual intervention |\n| `--list-manual` | `-L` | List tasks needing manual intervention |\n| `--resolve-manual ` | `-R ` | Restore task to pending status |\n\n## Usage Examples\n\n```\n# Decompose requirements from directory (requires docs + src)\npython run.py --docs docs --src src --decompose\n\n# Decompose from single document file\npython run.py --doc docs/feature-x.md --src src --decompose\n\n# Decompose from inline requirement text\npython run.py --requirement \"实现一个用户登录功能，包含表单验证和JWT认证\" --src src --decompose\n\n# Execute tasks (only requires src)\npython run.py --src src\n\n# View status\npython run.py --src src --status\n\n# Execute max 3 tasks and push\npython run.py --src src --max-tasks 3 --push\n```\n\n## tasks.json Data Structure\n\n```json\n{\n \"project\": \"Project name\",\n \"created_at\": \"YYYY-MM-DD\",\n \"docs_dir\": \"docs\",\n \"src_dir\": \"src\",\n \"requirements_docs\": [\n \"docs/xxx.md\"\n ],\n \"tasks\": [\n {\n \"id\": 1,\n \"name\": \"Task name\",\n \"description\": \"Detailed description\",\n \"priority\": \"high|medium|low\",\n \"dependencies\": [],\n \"status\": \"pending\"\n }\n ]\n}\n```\n\n**Note:** When using `--requirement`, the structure will include `\"requirements_text\": \"...\"` and `\"docs_dir\": null` instead of `\"requirements_docs\"` and `\"docs_dir\"`.\n\n## Task Status\n\n| Status | Description |\n|----------------|---------------------------|\n| `pending` | Pending execution |\n| `in_progress` | Currently executing |\n| `completed` | Completed |\n| `blocked` | Blocked |\n| `needs_manual` | Needs manual intervention |\n\n## Execution Flow\n\n1. **Receive parameters** - Parse src (required) and optional docs/doc/requirement\n2. **Build command** - Build python command based on parameters\n3. **Execute script** - Change to skill directory, then run run.py using Bash tool\n4. **Output results** - Display execution output and progress\n\nFile v1.0.8:_meta.json\n\n{\n \"ownerId\": \"kn710gz4y1jn74v7nch4cdwe5n856v16\",\n \"slug\": \"looop\",\n \"version\": \"1.0.8\",\n \"publishedAt\": 1776924233422\n}\n\nArchive v1.0.7: 5 files, 10923 bytes\n\nFiles: logger.py (5799b), run.py (16982b), skill.md (6360b), task_utils.py (4008b), _meta.json (124b)\n\nFile v1.0.7:skill.md\n\n---\nname: looop\ndescription: Claude Automated Development Toolkit - Decompose requirements documents into task lists and automatically execute in loops until project completion\nrequires:\n - claude-cli: Requires local Claude CLI installation\n - git: Modifies git repository (commits changes)\n - push: Optional git push to remote (--push flag)\npermissions:\n - dangerous: Uses --dangerously-skip-permissions to bypass permission prompts\n - write: Writes files to specified src directory\n - git-commit: Automatically commits task completions\n - git-push: Optional push with --push flag\nwarning: This skill bypasses permission checks and automatically commits/pushes to git. Use with caution on trusted projects only.\n---\n\n# Claude Automated Development Toolkit\n\nYou are an automated development assistant responsible for decomposing project requirements documents into executable\ntask lists and automatically executing each task in loops until the project is complete.\n\n## Parameters\n\n| Parameter | Required When | Description |\n|----------------|--------------------------|----------------------------------------|\n| `--docs ` | Decomposing requirements | Requirements document directory path |\n| `--doc ` | Decomposing single doc | Single requirements document file path |\n| `--src ` | Always required | Code storage directory path |\n\n**Note:** `--docs` and `--doc` are mutually exclusive for decomposition. Use `--doc` when you have a single requirements\nfile, or `--docs` when you have multiple files in a directory.\n\n## File Storage Location\n\nAll task-related files are stored in `/.looop/` directory:\n\n| File | Path | Description |\n|--------------|---------------------------------|-----------------------|\n| tasks.json | `/.looop/tasks.json` | Task list data |\n| progress.txt | `/.looop/progress.txt` | Task progress records |\n| *.log | `/.looop/*.log` | Task execution logs |\n\n## Log Files\n\nTask execution logs are created per task, named by task ID, name and timestamp:\n\n| Filename Pattern | When Created |\n|---------------------------------------------|----------------------------|\n| `Task_#0_Decompose_YYYY-MM-DD_HH-MM-SS.log` | Requirements decomposition |\n| `Task_#N_TaskName_YYYY-MM-DD_HH-MM-SS.log` | Each task execution |\n\n**Log content:**\n\n- Task start/end timestamps (second precision)\n- Complete Claude CLI output (JSON stream)\n- Debug information\n\n**No log files for:**\n\n- `--status` (status query)\n- `--mark-manual` / `--list-manual` / `--resolve-manual` (manual operations)\n\n## Execute Script\n\n**Important**: Change to the skill directory first before running the script.\n\n```bash\ncd && python run.py --src [--docs | --doc ] [other parameters]\n```\n\n## Core Workflow\n\n### Phase 1: Task Decomposition (requires docs/doc + src)\n\n**Directory mode:** `python run.py --docs --src --decompose`\n\n**Single file mode:** `python run.py --doc --src --decompose`\n\nThe script will automatically:\n\n1. Create `/.looop/` directory\n2. Read documents (all files in directory or single specified file)\n3. Call Claude to analyze and decompose into independent small tasks\n4. Set ID, name, description, priority, dependencies for each task\n5. Save task list to `/.looop/tasks.json`\n\n### Phase 2: Task Execution (only requires src)\n\nCommand: `python run.py --src `\n\nThe script will first check if `/.looop/tasks.json` exists:\n\n- Not exists → Prompt to run `--decompose` first\n- Exists → Automatically execute tasks in loops\n\nExecution process:\n\n1. Select next executable task from tasks.json\n2. Call Claude to execute task, code goes into src directory\n3. Record progress to progress.txt\n4. Update task status, execute git commit\n5. Continue next round until all tasks complete\n\n## Optional Parameters\n\n| Parameter | Short | Description |\n|-------------------------|-----------|-------------------------------------------------|\n| `--decompose` | `-d` | Decompose requirements documents into task list |\n| `--status` | `-s` | View task status statistics |\n| `--max-tasks ` | `-m ` | Maximum N tasks to execute |\n| `--push` | `-P` | Execute git push after completion |\n| `--mark-manual ` | `-M ` | Mark task as needing manual intervention |\n| `--list-manual` | `-L` | List tasks needing manual intervention |\n| `--resolve-manual ` | `-R ` | Restore task to pending status |\n\n## Usage Examples\n\n```\n# Decompose requirements from directory (requires docs + src)\npython run.py --docs docs --src src --decompose\n\n# Decompose from single document file\npython run.py --doc docs/feature-x.md --src src --decompose\n\n# Execute tasks (only requires src)\npython run.py --src src\n\n# View status\npython run.py --src src --status\n\n# Execute max 3 tasks and push\npython run.py --src src --max-tasks 3 --push\n```\n\n## tasks.json Data Structure\n\n```json\n{\n \"project\": \"Project name\",\n \"created_at\": \"YYYY-MM-DD\",\n \"docs_dir\": \"docs\",\n \"src_dir\": \"src\",\n \"requirements_docs\": [\n \"docs/xxx.md\"\n ],\n \"tasks\": [\n {\n \"id\": 1,\n \"name\": \"Task name\",\n \"description\": \"Detailed description\",\n \"priority\": \"high|medium|low\",\n \"dependencies\": [],\n \"status\": \"pending\"\n }\n ]\n}\n```\n\n## Task Status\n\n| Status | Description |\n|----------------|---------------------------|\n| `pending` | Pending execution |\n| `in_progress` | Currently executing |\n| `completed` | Completed |\n| `blocked` | Blocked |\n| `needs_manual` | Needs manual intervention |\n\n## Execution Flow\n\n1. **Receive parameters** - Parse src (required) and optional docs\n2. **Build command** - Build python command based on parameters\n3. **Execute script** - Change to skill directory, then run run.py using Bash tool\n4. **Output results** - Display execution output and progress\n\nFile v1.0.7:_meta.json\n\n{\n \"ownerId\": \"kn710gz4y1jn74v7nch4cdwe5n856v16\",\n \"slug\": \"looop\",\n \"version\": \"1.0.7\",\n \"publishedAt\": 1776852327308\n}\n\nArchive v1.0.6: 5 files, 10792 bytes\n\nFiles: logger.py (5798b), run.py (16956b), skill.md (5609b), task_utils.py (4008b), _meta.json (124b)\n\nFile v1.0.6:skill.md\n\n---\nname: looop\ndescription: Claude Automated Development Toolkit - Decompose requirements documents into task lists and automatically execute in loops until project completion\nrequires:\n - claude-cli: Requires local Claude CLI installation\n - git: Modifies git repository (commits changes)\n - push: Optional git push to remote (--push flag)\npermissions:\n - dangerous: Uses --dangerously-skip-permissions to bypass permission prompts\n - write: Writes files to specified src directory\n - git-commit: Automatically commits task completions\n - git-push: Optional push with --push flag\nwarning: This skill bypasses permission checks and automatically commits/pushes to git. Use with caution on trusted projects only.\n---\n\n# Claude Automated Development Toolkit\n\nYou are an automated development assistant responsible for decomposing project requirements documents into executable task lists and automatically executing each task in loops until the project is complete.\n\n## Parameters\n\n| Parameter | Required When | Description |\n|------|---------|------|\n| `--docs ` | Decomposing requirements | Requirements document directory path |\n| `--doc ` | Decomposing single doc | Single requirements document file path |\n| `--src ` | Always required | Code storage directory path |\n\n**Note:** `--docs` and `--doc` are mutually exclusive for decomposition. Use `--doc` when you have a single requirements file, or `--docs` when you have multiple files in a directory.\n\n## File Storage Location\n\nAll task-related files are stored in `src/.looop/` directory:\n\n| File | Path | Description |\n|------|------|------|\n| tasks.json | `src/.looop/tasks.json` | Task list data |\n| progress.txt | `src/.looop/progress.txt` | Task progress records |\n| *.log | `src/.looop/*.log` | Task execution logs |\n\n## Log Files\n\nTask execution logs are created per task, named by task ID, name and timestamp:\n\n| Filename Pattern | When Created |\n|---------------------------------------------|------|\n| `Task_#0_Decompose_YYYY-MM-DD_HH-MM-SS.log` | Requirements decomposition |\n| `Task_#N_TaskName_YYYY-MM-DD_HH-MM-SS.log` | Each task execution |\n\n**Log content:**\n- Task start/end timestamps (second precision)\n- Complete Claude CLI output (JSON stream)\n- Debug information\n\n**No log files for:**\n- `--status` (status query)\n- `--mark-manual` / `--list-manual` / `--resolve-manual` (manual operations)\n\n## Execute Script\n\n**Important**: Change to the skill directory first before running the script.\n\n```bash\ncd && python run.py --src [--docs | --doc ] [other parameters]\n```\n\n## Core Workflow\n\n### Phase 1: Task Decomposition (requires docs/doc + src)\n\n**Directory mode:** `python run.py --docs --src --decompose`\n\n**Single file mode:** `python run.py --doc --src --decompose`\n\nThe script will automatically:\n1. Create `src/.looop/` directory\n2. Read documents (all files in directory or single specified file)\n3. Call Claude to analyze and decompose into independent small tasks\n4. Set ID, name, description, priority, dependencies for each task\n5. Save task list to `src/.looop/tasks.json`\n\n### Phase 2: Task Execution (only requires src)\n\nCommand: `python run.py --src `\n\nThe script will first check if `src/.looop/tasks.json` exists:\n- Not exists → Prompt to run `--decompose` first\n- Exists → Automatically execute tasks in loops\n\nExecution process:\n1. Select next executable task from tasks.json\n2. Call Claude to execute task, code goes into src directory\n3. Record progress to progress.txt\n4. Update task status, execute git commit\n5. Continue next round until all tasks complete\n\n## Optional Parameters\n\n| Parameter | Short | Description |\n|------|------|------|\n| `--decompose` | `-d` | Decompose requirements documents into task list |\n| `--status` | `-s` | View task status statistics |\n| `--max-tasks ` | `-m ` | Maximum N tasks to execute |\n| `--push` | `-P` | Execute git push after completion |\n| `--mark-manual ` | `-M ` | Mark task as needing manual intervention |\n| `--list-manual` | `-L` | List tasks needing manual intervention |\n| `--resolve-manual ` | `-R ` | Restore task to pending status |\n\n## Usage Examples\n\n```\n# Decompose requirements from directory (requires docs + src)\npython run.py --docs docs --src src --decompose\n\n# Decompose from single document file\npython run.py --doc docs/feature-x.md --src src --decompose\n\n# Execute tasks (only requires src)\npython run.py --src src\n\n# View status\npython run.py --src src --status\n\n# Execute max 3 tasks and push\npython run.py --src src --max-tasks 3 --push\n```\n\n## tasks.json Data Structure\n\n```json\n{\n \"project\": \"Project name\",\n \"created_at\": \"YYYY-MM-DD\",\n \"docs_dir\": \"docs\",\n \"src_dir\": \"src\",\n \"requirements_docs\": [\"docs/xxx.md\"],\n \"tasks\": [\n {\n \"id\": 1,\n \"name\": \"Task name\",\n \"description\": \"Detailed description\",\n \"priority\": \"high|medium|low\",\n \"dependencies\": [],\n \"status\": \"pending\"\n }\n ]\n}\n```\n\n## Task Status\n\n| Status | Description |\n|------|------|\n| `pending` | Pending execution |\n| `in_progress` | Currently executing |\n| `completed` | Completed |\n| `blocked` | Blocked |\n| `needs_manual` | Needs manual intervention |\n\n## Execution Flow\n\n1. **Receive parameters** - Parse src (required) and optional docs\n2. **Build command** - Build python command based on parameters\n3. **Execute script** - Change to skill directory, then run run.py using Bash tool\n4. **Output results** - Display execution output and progress\n\nFile v1.0.6:_meta.json\n\n{\n \"ownerId\": \"kn710gz4y1jn74v7nch4cdwe5n856v16\",\n \"slug\": \"looop\",\n \"version\": \"1.0.6\",\n \"publishedAt\": 1776851474528\n}\n\nArchive v1.0.5: 5 files, 10879 bytes\n\nFiles: logger.py (5798b), run.py (16969b), skill.md (5609b), task_utils.py (4008b), _meta.json (124b)\n\nFile v1.0.5:skill.md\n\n---\nname: looop\ndescription: Claude Automated Development Toolkit - Decompose requirements documents into task lists and automatically execute in loops until project completion\nrequires:\n - claude-cli: Requires local Claude CLI installation\n - git: Modifies git repository (commits changes)\n - push: Optional git push to remote (--push flag)\npermissions:\n - dangerous: Uses --dangerously-skip-permissions to bypass permission prompts\n - write: Writes files to specified src directory\n - git-commit: Automatically commits task completions\n - git-push: Optional push with --push flag\nwarning: This skill bypasses permission checks and automatically commits/pushes to git. Use with caution on trusted projects only.\n---\n\n# Claude Automated Development Toolkit\n\nYou are an automated development assistant responsible for decomposing project requirements documents into executable task lists and automatically executing each task in loops until the project is complete.\n\n## Parameters\n\n| Parameter | Required When | Description |\n|------|---------|------|\n| `--docs ` | Decomposing requirements | Requirements document directory path |\n| `--doc ` | Decomposing single doc | Single requirements document file path |\n| `--src ` | Always required | Code storage directory path |\n\n**Note:** `--docs` and `--doc` are mutually exclusive for decomposition. Use `--doc` when you have a single requirements file, or `--docs` when you have multiple files in a directory.\n\n## File Storage Location\n\nAll task-related files are stored in `src/.looop/` directory:\n\n| File | Path | Description |\n|------|------|------|\n| tasks.json | `src/.looop/tasks.json` | Task list data |\n| progress.txt | `src/.looop/progress.txt` | Task progress records |\n| *.log | `src/.looop/*.log` | Task execution logs |\n\n## Log Files\n\nTask execution logs are created per task, named by task ID, name and timestamp:\n\n| Filename Pattern | When Created |\n|---------------------------------------------|------|\n| `Task_#0_Decompose_YYYY-MM-DD_HH-MM-SS.log` | Requirements decomposition |\n| `Task_#N_TaskName_YYYY-MM-DD_HH-MM-SS.log` | Each task execution |\n\n**Log content:**\n- Task start/end timestamps (second precision)\n- Complete Claude CLI output (JSON stream)\n- Debug information\n\n**No log files for:**\n- `--status` (status query)\n- `--mark-manual` / `--list-manual` / `--resolve-manual` (manual operations)\n\n## Execute Script\n\n**Important**: Change to the skill directory first before running the script.\n\n```bash\ncd && python run.py --src [--docs | --doc ] [other parameters]\n```\n\n## Core Workflow\n\n### Phase 1: Task Decomposition (requires docs/doc + src)\n\n**Directory mode:** `python run.py --docs --src --decompose`\n\n**Single file mode:** `python run.py --doc --src --decompose`\n\nThe script will automatically:\n1. Create `src/.looop/` directory\n2. Read documents (all files in directory or single specified file)\n3. Call Claude to analyze and decompose into independent small tasks\n4. Set ID, name, description, priority, dependencies for each task\n5. Save task list to `src/.looop/tasks.json`\n\n### Phase 2: Task Execution (only requires src)\n\nCommand: `python run.py --src `\n\nThe script will first check if `src/.looop/tasks.json` exists:\n- Not exists → Prompt to run `--decompose` first\n- Exists → Automatically execute tasks in loops\n\nExecution process:\n1. Select next executable task from tasks.json\n2. Call Claude to execute task, code goes into src directory\n3. Record progress to progress.txt\n4. Update task status, execute git commit\n5. Continue next round until all tasks complete\n\n## Optional Parameters\n\n| Parameter | Short | Description |\n|------|------|------|\n| `--decompose` | `-d` | Decompose requirements documents into task list |\n| `--status` | `-s` | View task status statistics |\n| `--max-tasks ` | `-m ` | Maximum N tasks to execute |\n| `--push` | `-P` | Execute git push after completion |\n| `--mark-manual ` | `-M ` | Mark task as needing manual intervention |\n| `--list-manual` | `-L` | List tasks needing manual intervention |\n| `--resolve-manual ` | `-R ` | Restore task to pending status |\n\n## Usage Examples\n\n```\n# Decompose requirements from directory (requires docs + src)\npython run.py --docs docs --src src --decompose\n\n# Decompose from single document file\npython run.py --doc docs/feature-x.md --src src --decompose\n\n# Execute tasks (only requires src)\npython run.py --src src\n\n# View status\npython run.py --src src --status\n\n# Execute max 3 tasks and push\npython run.py --src src --max-tasks 3 --push\n```\n\n## tasks.json Data Structure\n\n```json\n{\n \"project\": \"Project name\",\n \"created_at\": \"YYYY-MM-DD\",\n \"docs_dir\": \"docs\",\n \"src_dir\": \"src\",\n \"requirements_docs\": [\"docs/xxx.md\"],\n \"tasks\": [\n {\n \"id\": 1,\n \"name\": \"Task name\",\n \"description\": \"Detailed description\",\n \"priority\": \"high|medium|low\",\n \"dependencies\": [],\n \"status\": \"pending\"\n }\n ]\n}\n```\n\n## Task Status\n\n| Status | Description |\n|------|------|\n| `pending` | Pending execution |\n| `in_progress` | Currently executing |\n| `completed` | Completed |\n| `blocked` | Blocked |\n| `needs_manual` | Needs manual intervention |\n\n## Execution Flow\n\n1. **Receive parameters** - Parse src (required) and optional docs\n2. **Build command** - Build python command based on parameters\n3. **Execute script** - Change to skill directory, then run run.py using Bash tool\n4. **Output results** - Display execution output and progress\n\nFile v1.0.5:_meta.json\n\n{\n \"ownerId\": \"kn710gz4y1jn74v7nch4cdwe5n856v16\",\n \"slug\": \"looop\",\n \"version\": \"1.0.5\",\n \"publishedAt\": 1776851337135\n}\n\nArchive v1.0.4: 5 files, 10793 bytes\n\nFiles: logger.py (5798b), run.py (16935b), skill.md (5609b), task_utils.py (4008b), _meta.json (124b)\n\nFile v1.0.4:skill.md\n\n---\nname: looop\ndescription: Claude Automated Development Toolkit - Decompose requirements documents into task lists and automatically execute in loops until project completion\nrequires:\n - claude-cli: Requires local Claude CLI installation\n - git: Modifies git repository (commits changes)\n - push: Optional git push to remote (--push flag)\npermissions:\n - dangerous: Uses --dangerously-skip-permissions to bypass permission prompts\n - write: Writes files to specified src directory\n - git-commit: Automatically commits task completions\n - git-push: Optional push with --push flag\nwarning: This skill bypasses permission checks and automatically commits/pushes to git. Use with caution on trusted projects only.\n---\n\n# Claude Automated Development Toolkit\n\nYou are an automated development assistant responsible for decomposing project requirements documents into executable task lists and automatically executing each task in loops until the project is complete.\n\n## Parameters\n\n| Parameter | Required When | Description |\n|------|---------|------|\n| `--docs ` | Decomposing requirements | Requirements document directory path |\n| `--doc ` | Decomposing single doc | Single requirements document file path |\n| `--src ` | Always required | Code storage directory path |\n\n**Note:** `--docs` and `--doc` are mutually exclusive for decomposition. Use `--doc` when you have a single requirements file, or `--docs` when you have multiple files in a directory.\n\n## File Storage Location\n\nAll task-related files are stored in `src/.looop/` directory:\n\n| File | Path | Description |\n|------|------|------|\n| tasks.json | `src/.looop/tasks.json` | Task list data |\n| progress.txt | `src/.looop/progress.txt` | Task progress records |\n| *.log | `src/.looop/*.log` | Task execution logs |\n\n## Log Files\n\nTask execution logs are created per task, named by task ID, name and timestamp:\n\n| Filename Pattern | When Created |\n|---------------------------------------------|------|\n| `Task_#0_Decompose_YYYY-MM-DD_HH-MM-SS.log` | Requirements decomposition |\n| `Task_#N_TaskName_YYYY-MM-DD_HH-MM-SS.log` | Each task execution |\n\n**Log content:**\n- Task start/end timestamps (second precision)\n- Complete Claude CLI output (JSON stream)\n- Debug information\n\n**No log files for:**\n- `--status` (status query)\n- `--mark-manual` / `--list-manual` / `--resolve-manual` (manual operations)\n\n## Execute Script\n\n**Important**: Change to the skill directory first before running the script.\n\n```bash\ncd && python run.py --src [--docs | --doc ] [other parameters]\n```\n\n## Core Workflow\n\n### Phase 1: Task Decomposition (requires docs/doc + src)\n\n**Directory mode:** `python run.py --docs --src --decompose`\n\n**Single file mode:** `python run.py --doc --src --decompose`\n\nThe script will automatically:\n1. Create `src/.looop/` directory\n2. Read documents (all files in directory or single specified file)\n3. Call Claude to analyze and decompose into independent small tasks\n4. Set ID, name, description, priority, dependencies for each task\n5. Save task list to `src/.looop/tasks.json`\n\n### Phase 2: Task Execution (only requires src)\n\nCommand: `python run.py --src `\n\nThe script will first check if `src/.looop/tasks.json` exists:\n- Not exists → Prompt to run `--decompose` first\n- Exists → Automatically execute tasks in loops\n\nExecution process:\n1. Select next executable task from tasks.json\n2. Call Claude to execute task, code goes into src directory\n3. Record progress to progress.txt\n4. Update task status, execute git commit\n5. Continue next round until all tasks complete\n\n## Optional Parameters\n\n| Parameter | Short | Description |\n|------|------|------|\n| `--decompose` | `-d` | Decompose requirements documents into task list |\n| `--status` | `-s` | View task status statistics |\n| `--max-tasks ` | `-m ` | Maximum N tasks to execute |\n| `--push` | `-P` | Execute git push after completion |\n| `--mark-manual ` | `-M ` | Mark task as needing manual intervention |\n| `--list-manual` | `-L` | List tasks needing manual intervention |\n| `--resolve-manual ` | `-R ` | Restore task to pending status |\n\n## Usage Examples\n\n```\n# Decompose requirements from directory (requires docs + src)\npython run.py --docs docs --src src --decompose\n\n# Decompose from single document file\npython run.py --doc docs/feature-x.md --src src --decompose\n\n# Execute tasks (only requires src)\npython run.py --src src\n\n# View status\npython run.py --src src --status\n\n# Execute max 3 tasks and push\npython run.py --src src --max-tasks 3 --push\n```\n\n## tasks.json Data Structure\n\n```json\n{\n \"project\": \"Project name\",\n \"created_at\": \"YYYY-MM-DD\",\n \"docs_dir\": \"docs\",\n \"src_dir\": \"src\",\n \"requirements_docs\": [\"docs/xxx.md\"],\n \"tasks\": [\n {\n \"id\": 1,\n \"name\": \"Task name\",\n \"description\": \"Detailed description\",\n \"priority\": \"high|medium|low\",\n \"dependencies\": [],\n \"status\": \"pending\"\n }\n ]\n}\n```\n\n## Task Status\n\n| Status | Description |\n|------|------|\n| `pending` | Pending execution |\n| `in_progress` | Currently executing |\n| `completed` | Completed |\n| `blocked` | Blocked |\n| `needs_manual` | Needs manual intervention |\n\n## Execution Flow\n\n1. **Receive parameters** - Parse src (required) and optional docs\n2. **Build command** - Build python command based on parameters\n3. **Execute script** - Change to skill directory, then run run.py using Bash tool\n4. **Output results** - Display execution output and progress\n\nFile v1.0.4:_meta.json\n\n{\n \"ownerId\": \"kn710gz4y1jn74v7nch4cdwe5n856v16\",\n \"slug\": \"looop\",\n \"version\": \"1.0.4\",\n \"publishedAt\": 1776842982103\n}\n\nArchive v1.0.3: 5 files, 10466 bytes\n\nFiles: logger.py (5798b), run.py (15998b), skill.md (5040b), task_utils.py (4008b), _meta.json (124b)\n\nFile v1.0.3:skill.md\n\n---\nname: looop\ndescription: Claude Automated Development Toolkit - Decompose requirements documents into task lists and automatically execute in loops until project completion\nrequires:\n - claude-cli: Requires local Claude CLI installation\n - git: Modifies git repository (commits changes)\n - push: Optional git push to remote (--push flag)\npermissions:\n - dangerous: Uses --dangerously-skip-permissions to bypass permission prompts\n - write: Writes files to specified src directory\n - git-commit: Automatically commits task completions\n - git-push: Optional push with --push flag\nwarning: This skill bypasses permission checks and automatically commits/pushes to git. Use with caution on trusted projects only.\n---\n\n# Claude Automated Development Toolkit\n\nYou are an automated development assistant responsible for decomposing project requirements documents into executable task lists and automatically executing each task in loops until the project is complete.\n\n## Parameters\n\n| Parameter | Required When | Description |\n|------|---------|------|\n| `--docs ` | Decomposing requirements | Requirements document directory path |\n| `--src ` | Always required | Code storage directory path |\n\n## File Storage Location\n\nAll task-related files are stored in `src/.looop/` directory:\n\n| File | Path | Description |\n|------|------|------|\n| tasks.json | `src/.looop/tasks.json` | Task list data |\n| progress.txt | `src/.looop/progress.txt` | Task progress records |\n| *.log | `src/.looop/*.log` | Task execution logs |\n\n## Log Files\n\nTask execution logs are created per task, named by task ID, name and timestamp:\n\n| Filename Pattern | When Created |\n|------|------|\n| `Task_#0_Decompose_YYYY-MM-DD_HH-MM-SS.log` | Requirements decomposition |\n| `Task_#N_任务名_YYYY-MM-DD_HH-MM-SS.log` | Each task execution |\n\n**Log content:**\n- Task start/end timestamps (second precision)\n- Complete Claude CLI output (JSON stream)\n- Debug information\n\n**No log files for:**\n- `--status` (status query)\n- `--mark-manual` / `--list-manual` / `--resolve-manual` (manual operations)\n\n## Execute Script\n\n**Important**: Change to the skill directory first before running the script.\n\n```bash\ncd && python run.py --src [--docs ] [other parameters]\n```\n\n## Core Workflow\n\n### Phase 1: Task Decomposition (requires docs + src)\n\nCommand: `python run.py --docs --src --decompose`\n\nThe script will automatically:\n1. Create `src/.looop/` directory\n2. Read all documents in requirements directory (.md, .txt, .json files)\n3. Call Claude to analyze and decompose into independent small tasks\n4. Set ID, name, description, priority, dependencies for each task\n5. Save task list to `src/.looop/tasks.json`\n\n### Phase 2: Task Execution (only requires src)\n\nCommand: `python run.py --src `\n\nThe script will first check if `src/.looop/tasks.json` exists:\n- Not exists → Prompt to run `--decompose` first\n- Exists → Automatically execute tasks in loops\n\nExecution process:\n1. Select next executable task from tasks.json\n2. Call Claude to execute task, code goes into src directory\n3. Record progress to progress.txt\n4. Update task status, execute git commit\n5. Continue next round until all tasks complete\n\n## Optional Parameters\n\n| Parameter | Short | Description |\n|------|------|------|\n| `--decompose` | `-d` | Decompose requirements documents into task list |\n| `--status` | `-s` | View task status statistics |\n| `--max-tasks ` | `-m ` | Maximum N tasks to execute |\n| `--push` | `-P` | Execute git push after completion |\n| `--mark-manual ` | `-M ` | Mark task as needing manual intervention |\n| `--list-manual` | `-L` | List tasks needing manual intervention |\n| `--resolve-manual ` | `-R ` | Restore task to pending status |\n\n## Usage Examples\n\n```\n# Decompose requirements (requires docs + src)\npython run.py --docs docs --src src --decompose\n\n# Execute tasks (only requires src)\npython run.py --src src\n\n# View status\npython run.py --src src --status\n\n# Execute max 3 tasks and push\npython run.py --src src --max-tasks 3 --push\n```\n\n## tasks.json Data Structure\n\n```json\n{\n \"project\": \"Project name\",\n \"created_at\": \"YYYY-MM-DD\",\n \"docs_dir\": \"docs\",\n \"src_dir\": \"src\",\n \"requirements_docs\": [\"docs/xxx.md\"],\n \"tasks\": [\n {\n \"id\": 1,\n \"name\": \"Task name\",\n \"description\": \"Detailed description\",\n \"priority\": \"high|medium|low\",\n \"dependencies\": [],\n \"status\": \"pending\"\n }\n ]\n}\n```\n\n## Task Status\n\n| Status | Description |\n|------|------|\n| `pending` | Pending execution |\n| `in_progress` | Currently executing |\n| `completed` | Completed |\n| `blocked` | Blocked |\n| `needs_manual` | Needs manual intervention |\n\n## Execution Flow\n\n1. **Receive parameters** - Parse src (required) and optional docs\n2. **Build command** - Build python command based on parameters\n3. **Execute script** - Change to skill directory, then run run.py using Bash tool\n4. **Output results** - Display execution output and progress\n\nFile v1.0.3:_meta.json\n\n{\n \"ownerId\": \"kn710gz4y1jn74v7nch4cdwe5n856v16\",\n \"slug\": \"looop\",\n \"version\": \"1.0.3\",\n \"publishedAt\": 1776763839867\n}\n\nArchive v1.0.2: 5 files, 10465 bytes\n\nFiles: logger.py (5798b), run.py (16030b), skill.md (5040b), task_utils.py (4008b), _meta.json (124b)\n\nFile v1.0.2:skill.md\n\n---\nname: looop\ndescription: Claude Automated Development Toolkit - Decompose requirements documents into task lists and automatically execute in loops until project completion\nrequires:\n - claude-cli: Requires local Claude CLI installation\n - git: Modifies git repository (commits changes)\n - push: Optional git push to remote (--push flag)\npermissions:\n - dangerous: Uses --dangerously-skip-permissions to bypass permission prompts\n - write: Writes files to specified src directory\n - git-commit: Automatically commits task completions\n - git-push: Optional push with --push flag\nwarning: This skill bypasses permission checks and automatically commits/pushes to git. Use with caution on trusted projects only.\n---\n\n# Claude Automated Development Toolkit\n\nYou are an automated development assistant responsible for decomposing project requirements documents into executable task lists and automatically executing each task in loops until the project is complete.\n\n## Parameters\n\n| Parameter | Required When | Description |\n|------|---------|------|\n| `--docs ` | Decomposing requirements | Requirements document directory path |\n| `--src ` | Always required | Code storage directory path |\n\n## File Storage Location\n\nAll task-related files are stored in `src/.looop/` directory:\n\n| File | Path | Description |\n|------|------|------|\n| tasks.json | `src/.looop/tasks.json` | Task list data |\n| progress.txt | `src/.looop/progress.txt` | Task progress records |\n| *.log | `src/.looop/*.log` | Task execution logs |\n\n## Log Files\n\nTask execution logs are created per task, named by task ID, name and timestamp:\n\n| Filename Pattern | When Created |\n|------|------|\n| `Task_#0_Decompose_YYYY-MM-DD_HH-MM-SS.log` | Requirements decomposition |\n| `Task_#N_任务名_YYYY-MM-DD_HH-MM-SS.log` | Each task execution |\n\n**Log content:**\n- Task start/end timestamps (second precision)\n- Complete Claude CLI output (JSON stream)\n- Debug information\n\n**No log files for:**\n- `--status` (status query)\n- `--mark-manual` / `--list-manual` / `--resolve-manual` (manual operations)\n\n## Execute Script\n\n**Important**: Change to the skill directory first before running the script.\n\n```bash\ncd && python run.py --src [--docs ] [other parameters]\n```\n\n## Core Workflow\n\n### Phase 1: Task Decomposition (requires docs + src)\n\nCommand: `python run.py --docs --src --decompose`\n\nThe script will automatically:\n1. Create `src/.looop/` directory\n2. Read all documents in requirements directory (.md, .txt, .json files)\n3. Call Claude to analyze and decompose into independent small tasks\n4. Set ID, name, description, priority, dependencies for each task\n5. Save task list to `src/.looop/tasks.json`\n\n### Phase 2: Task Execution (only requires src)\n\nCommand: `python run.py --src `\n\nThe script will first check if `src/.looop/tasks.json` exists:\n- Not exists → Prompt to run `--decompose` first\n- Exists → Automatically execute tasks in loops\n\nExecution process:\n1. Select next executable task from tasks.json\n2. Call Claude to execute task, code goes into src directory\n3. Record progress to progress.txt\n4. Update task status, execute git commit\n5. Continue next round until all tasks complete\n\n## Optional Parameters\n\n| Parameter | Short | Description |\n|------|------|------|\n| `--decompose` | `-d` | Decompose requirements documents into task list |\n| `--status` | `-s` | View task status statistics |\n| `--max-tasks ` | `-m ` | Maximum N tasks to execute |\n| `--push` | `-P` | Execute git push after completion |\n| `--mark-manual ` | `-M ` | Mark task as needing manual intervention |\n| `--list-manual` | `-L` | List tasks needing manual intervention |\n| `--resolve-manual ` | `-R ` | Restore task to pending status |\n\n## Usage Examples\n\n```\n# Decompose requirements (requires docs + src)\npython run.py --docs docs --src src --decompose\n\n# Execute tasks (only requires src)\npython run.py --src src\n\n# View status\npython run.py --src src --status\n\n# Execute max 3 tasks and push\npython run.py --src src --max-tasks 3 --push\n```\n\n## tasks.json Data Structure\n\n```json\n{\n \"project\": \"Project name\",\n \"created_at\": \"YYYY-MM-DD\",\n \"docs_dir\": \"docs\",\n \"src_dir\": \"src\",\n \"requirements_docs\": [\"docs/xxx.md\"],\n \"tasks\": [\n {\n \"id\": 1,\n \"name\": \"Task name\",\n \"description\": \"Detailed description\",\n \"priority\": \"high|medium|low\",\n \"dependencies\": [],\n \"status\": \"pending\"\n }\n ]\n}\n```\n\n## Task Status\n\n| Status | Description |\n|------|------|\n| `pending` | Pending execution |\n| `in_progress` | Currently executing |\n| `completed` | Completed |\n| `blocked` | Blocked |\n| `needs_manual` | Needs manual intervention |\n\n## Execution Flow\n\n1. **Receive parameters** - Parse src (required) and optional docs\n2. **Build command** - Build python command based on parameters\n3. **Execute script** - Change to skill directory, then run run.py using Bash tool\n4. **Output results** - Display execution output and progress\n\nFile v1.0.2:_meta.json\n\n{\n \"ownerId\": \"kn710gz4y1jn74v7nch4cdwe5n856v16\",\n \"slug\": \"looop\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1776762949361\n}\n\nArchive v1.0.1: 4 files, 8307 bytes\n\nFiles: run.py (15788b), skill.md (4436b), task_utils.py (4008b), _meta.json (124b)\n\nFile v1.0.1:skill.md\n\n---\nname: looop\ndescription: Claude Automated Development Toolkit - Decompose requirements documents into task lists and automatically execute in loops until project completion\nrequires:\n - claude-cli: Requires local Claude CLI installation\n - git: Modifies git repository (commits changes)\n - push: Optional git push to remote (--push flag)\npermissions:\n - dangerous: Uses --dangerously-skip-permissions to bypass permission prompts\n - write: Writes files to specified src directory\n - git-commit: Automatically commits task completions\n - git-push: Optional push with --push flag\nwarning: This skill bypasses permission checks and automatically commits/pushes to git. Use with caution on trusted projects only.\n---\n\n# Claude Automated Development Toolkit\n\nYou are an automated development assistant responsible for decomposing project requirements documents into executable task lists and automatically executing each task in loops until the project is complete.\n\n## Parameters\n\n| Parameter | Required When | Description |\n|------|---------|------|\n| `--docs ` | Decomposing requirements | Requirements document directory path |\n| `--src ` | Always required | Code storage directory path |\n\n## File Storage Location\n\nAll task-related files are stored in `src/.looop/` directory:\n\n| File | Path | Description |\n|------|------|------|\n| tasks.json | `src/.looop/tasks.json` | Task list data |\n| progress.txt | `src/.looop/progress.txt` | Task progress records |\n\n## Execute Script\n\n**Important**: Change to the skill directory first before running the script.\n\n```bash\ncd && python run.py --src [--docs ] [other parameters]\n```\n\n## Core Workflow\n\n### Phase 1: Task Decomposition (requires docs + src)\n\nCommand: `python run.py --docs --src --decompose`\n\nThe script will automatically:\n1. Create `src/.looop/` directory\n2. Read all documents in requirements directory (.md, .txt, .json files)\n3. Call Claude to analyze and decompose into independent small tasks\n4. Set ID, name, description, priority, dependencies for each task\n5. Save task list to `src/.looop/tasks.json`\n\n### Phase 2: Task Execution (only requires src)\n\nCommand: `python run.py --src `\n\nThe script will first check if `src/.looop/tasks.json` exists:\n- Not exists → Prompt to run `--decompose` first\n- Exists → Automatically execute tasks in loops\n\nExecution process:\n1. Select next executable task from tasks.json\n2. Call Claude to execute task, code goes into src directory\n3. Record progress to progress.txt\n4. Update task status, execute git commit\n5. Continue next round until all tasks complete\n\n## Optional Parameters\n\n| Parameter | Short | Description |\n|------|------|------|\n| `--decompose` | `-d` | Decompose requirements documents into task list |\n| `--status` | `-s` | View task status statistics |\n| `--max-tasks ` | `-m ` | Maximum N tasks to execute |\n| `--push` | `-P` | Execute git push after completion |\n| `--mark-manual ` | `-M ` | Mark task as needing manual intervention |\n| `--list-manual` | `-L` | List tasks needing manual intervention |\n| `--resolve-manual ` | `-R ` | Restore task to pending status |\n\n## Usage Examples\n\n```\n# Decompose requirements (requires docs + src)\npython run.py --docs docs --src src --decompose\n\n# Execute tasks (only requires src)\npython run.py --src src\n\n# View status\npython run.py --src src --status\n\n# Execute max 3 tasks and push\npython run.py --src src --max-tasks 3 --push\n```\n\n## tasks.json Data Structure\n\n```json\n{\n \"project\": \"Project name\",\n \"created_at\": \"YYYY-MM-DD\",\n \"docs_dir\": \"docs\",\n \"src_dir\": \"src\",\n \"requirements_docs\": [\"docs/xxx.md\"],\n \"tasks\": [\n {\n \"id\": 1,\n \"name\": \"Task name\",\n \"description\": \"Detailed description\",\n \"priority\": \"high|medium|low\",\n \"dependencies\": [],\n \"status\": \"pending\"\n }\n ]\n}\n```\n\n## Task Status\n\n| Status | Description |\n|------|------|\n| `pending` | Pending execution |\n| `in_progress` | Currently executing |\n| `completed` | Completed |\n| `blocked` | Blocked |\n| `needs_manual` | Needs manual intervention |\n\n## Execution Flow\n\n1. **Receive parameters** - Parse src (required) and optional docs\n2. **Build command** - Build python command based on parameters\n3. **Execute script** - Change to skill directory, then run run.py using Bash tool\n4. **Output results** - Display execution output and progress\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn710gz4y1jn74v7nch4cdwe5n856v16\",\n \"slug\": \"looop\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1776756754383\n}","readmeExcerpt":"Skill: looop Owner: caesargattuso Summary: Claude Automated Development Toolkit - Decompose requirements documents, single files, or inline text into detailed task lists and automatically execute in l... Tags: latest:1.1.1 Version history: v1.1.1 | 2026-04-23T08:03:21.404Z | user No user-visible changes in this version. - Changelog note: No file changes detected; SKILL.md appears unchanged except for truncation at th","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"cd && python run.py --src [--docs | --doc | --requirement ] [other parameters]"},{"language":"text","snippet":"# Decompose requirements from directory (requires docs + src)\npython run.py --docs docs --src src --decompose\n\n# Decompose from single document file\npython run.py --doc docs/feature-x.md --src src --decompose\n\n# Decompose from inline requirement text\npython run.py --requirement \"Implement a user login feature with form validation and JWT authentication\" --src src --decompose\n\n# Execute tasks (only requires src)\npython run.py --src src\n\n# View status\npython run.py --src src --status\n\n# Execute max 3 tasks and push\npython run.py --src src --max-tasks 3 --push"},{"language":"json","snippet":"{\n \"project\": \"Project name\",\n \"created_at\": \"YYYY-MM-DD\",\n \"docs_dir\": \"docs\",\n \"src_dir\": \"src\",\n \"requirements_docs\": [\n \"docs/xxx.md\"\n ],\n \"tasks\": [\n {\n \"id\": 1,\n \"name\": \"Task name (concise, imperative)\",\n \"description\": \"Detailed technical description including: what to build, files to create/modify, key implementation points\",\n \"priority\": \"high|medium|low\",\n \"dependencies\": [],\n \"task_type\": \"setup|core|feature|refactor|test|docs\",\n \"estimated_files\": [\"expected_file_path_1\"],\n \"acceptance_criteria\": [\"Specific verifiable criteria\"],\n \"status\": \"pending\",\n \"result\": null,\n \"issues\": [],\n \"completed_at\": null\n }\n ]\n}"},{"language":"bash","snippet":"cd && python run.py --src [--docs | --doc | --requirement ] [other parameters]"},{"language":"text","snippet":"# Decompose requirements from directory (requires docs + src)\npython run.py --docs docs --src src --decompose\n\n# Decompose from single document file\npython run.py --doc docs/feature-x.md --src src --decompose\n\n# Decompose from inline requirement text\npython run.py --requirement \"Implement a user login feature with form validation and JWT authentication\" --src src --decompose\n\n# Execute tasks (only requires src)\npython run.py --src src\n\n# View status\npython run.py --src src --status\n\n# Execute max 3 tasks and push\npython run.py --src src --max-tasks 3 --push"},{"language":"json","snippet":"{\n \"project\": \"Project name\",\n \"created_at\": \"YYYY-MM-DD\",\n \"docs_dir\": \"docs\",\n \"src_dir\": \"src\",\n \"requirements_docs\": [\n \"docs/xxx.md\"\n ],\n \"tasks\": [\n {\n \"id\": 1,\n \"name\": \"Task name (concise, imperative)\",\n \"description\": \"Detailed technical description including: what to build, files to create/modify, key implementation points\",\n \"priority\": \"high|medium|low\",\n \"dependencies\": [],\n \"task_type\": \"setup|core|feature|refactor|test|docs\",\n \"estimated_files\": [\"expected_file_path_1\"],\n \"acceptance_criteria\": [\"Specific verifiable criteria\"],\n \"status\": \"pending\",\n \"result\": null,\n \"issues\": [],\n \"completed_at\": null\n }\n ]\n}"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"skill.md","content":"---\nname: looop\ndescription: Claude Automated Development Toolkit - Decompose requirements documents, single files, or inline text into detailed task lists and automatically execute in loops until project completion\nrequires:\n - claude-cli: Requires local Claude CLI installation\n - git: Modifies git repository (commits changes)\n - push: Optional git push to remote (--push flag)\npermissions:\n - dangerous: Uses --dangerously-skip-permissions to bypass permission prompts\n - write: Writes files to specified src directory\n - git-commit: Automatically commits task completions\n - git-push: Optional push with --push flag\nwarning: This skill bypasses permission checks and automatically commits/pushes to git. Use with caution on trusted projects only.\n---\n\n# Claude Automated Development Toolkit\n\nYou are an automated development assistant responsible for decomposing project requirements (from documents, single files, or inline text) into executable task lists and automatically executing each task in loops until the project is complete.\n\n## Parameters\n\n| Parameter | Required When | Description |\n|--------------------|----------------------------|----------------------------------------|\n| `--docs ` | Decomposing requirements directory | Requirements document directory path |\n| `--doc ` | Decomposing single doc file | Single requirements document file path |\n| `--requirement ` | Decomposing inline requirement | Direct requirement text string |\n| `--src ` | Always required | Code storage directory path |\n\n**Note:** `--docs`, `--doc`, and `--requirement` are mutually exclusive for decomposition. Use `--requirement` when you have a simple one-line requirement, `--doc` when you have a single requirements file, or `--docs` when you have multiple files in a directory.\n\n## File Storage Location\n\nAll task-related files are stored in `/.looop/` directory:\n\n| File | Path | Description |\n|--------------|---------------------------------|-----------------------|\n| tasks.json | `/.looop/tasks.json` | Task list data |\n| progress.txt | `/.looop/progress.txt` | Task progress records |\n| *.log | `/.looop/*.log` | Task execution logs |\n\n## Log Files\n\nTask execution logs are created per task, named by task ID, name and timestamp:\n\n| Filename Pattern | When Created |\n|---------------------------------------------|----------------------------|\n| `Task_#0_Decompose_YYYY-MM-DD_HH-MM-SS.log` | Requirements decomposition |\n| `Task_#N_TaskName_YYYY-MM-DD_HH-MM-SS.log` | Each task execution |\n\n**Log content:**\n\n- Task start/end timestamps (second precision)\n- Complete Claude CLI output (JSON stream)\n- Debug information\n\n**No log files for:**\n\n- `--status` (status query)\n- `--mark-manual` / `--list-manual` / `--resolve-ma"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn710gz4y1jn74v7nch4cdwe5n856v16\",\n \"slug\": \"looop\",\n \"version\": \"1.1.1\",\n \"publishedAt\": 1776931401404\n}"},{"path":"skill-card.md","content":"## Description:\n\nClaude Automated Development Toolkit decomposes requirements from documents, files, or inline text into task lists and can execute those tasks through Claude CLI until project completion.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[caesargattuso](https://clawhub.ai/user/caesargattuso)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and engineering teams use looop to turn requirements into a tracked implementation plan and optionally have Claude CLI execute the tasks inside a source directory.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill automates Claude CLI to modify code and commit changes with broad authority.\n\nMitigation: Install only for trusted, disposable or well-backed-up repositories and inspect every diff before sharing or pushing.\n\nRisk: Optional git push can publish unintended automated changes.\n\nMitigation: Avoid --push unless the repository and remote are intentionally prepared for automated updates.\n\nRisk: .looop logs may contain sensitive Claude output.\n\nMitigation: Ignore, clean, or review .looop logs before committing or sharing project contents.\n\nRisk: Unbounded task execution can make many changes before human review.\n\nMitigation: Review tasks.json before execution and set --max-tasks for staged runs.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/caesargattuso/skills/looop)\n- [Publisher profile](https://clawhub.ai/user/caesargattuso)\n- [Claude Code](https://claude.ai/code)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance, files]\n\n**Output Format:** [Console text, JSON task files, logs, Markdown-style progress summaries, code changes, and git commits.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Writes task state, progress, and logs under /.looop; can optionally commit and push changes.]\n\n## Skill Version(s):\n\n1.1.1 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Claude Automated Development Toolkit - Decompose requirements documents, single files, or inline text into detailed task lists and automatically execute in l... Skill: looop Owner: caesargattuso Summary: Claude Automated Development Toolkit - Decompose requirements documents, single files, or inline text into detailed task lists and automatically execute in l... Tags: latest:1.1.1 Version history: v1.1.1 | 2026-04-23T08:03:21.404Z | user No user-visible changes in this version. - Changelog note: No file changes detected; SKILL.md appears unchanged except for truncation at th","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1283,"uniquenessScore":47,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T14:25:39.887Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T14:25:39.887Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T17:42:15.295Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}