{"id":51158093,"url":"https://github.com/lucagattoni/claude-warp","last_synced_at":"2026-06-29T01:00:43.153Z","repository":{"id":366621071,"uuid":"1276722822","full_name":"lucagattoni/Claude-Warp","owner":"lucagattoni","description":"Loop harness for Claude Code — scaffold, guard, and schedule autonomous loops in any project","archived":false,"fork":false,"pushed_at":"2026-06-26T12:12:35.000Z","size":328,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-26T12:22:08.717Z","etag":null,"topics":["ai-agents","automation","claude-code","loop-engineering"],"latest_commit_sha":null,"homepage":"https://github.com/lucagattoni/Claude-Warp","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lucagattoni.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-22T08:29:35.000Z","updated_at":"2026-06-26T12:12:40.000Z","dependencies_parsed_at":"2026-06-29T01:00:35.017Z","dependency_job_id":null,"html_url":"https://github.com/lucagattoni/Claude-Warp","commit_stats":null,"previous_names":["lucagattoni/claude-warp"],"tags_count":50,"template":false,"template_full_name":null,"purl":"pkg:github/lucagattoni/Claude-Warp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucagattoni%2FClaude-Warp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucagattoni%2FClaude-Warp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucagattoni%2FClaude-Warp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucagattoni%2FClaude-Warp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lucagattoni","download_url":"https://codeload.github.com/lucagattoni/Claude-Warp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucagattoni%2FClaude-Warp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34909138,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","automation","claude-code","loop-engineering"],"created_at":"2026-06-26T12:00:25.564Z","updated_at":"2026-06-29T01:00:43.133Z","avatar_url":"https://github.com/lucagattoni.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ClaudeWarp\n\n\u003e The loop harness for Claude Code. Scaffold, guard, and schedule autonomous loops in any project.\n\n---\n\n## What it is\n\nClaudeWarp installs the infrastructure layer that Claude Code does not provide natively: loop scaffolding, scheduling guards, headless runners, and a self-pruning mechanism that retires harness components as Claude Code absorbs them.\n\nIt is intentionally thin. Anything Claude Code already handles — subagents, worktrees, memory, code review, scheduling runtime — is documented and referenced, not reimplemented.\n\n---\n\n## Install\n\n**Prerequisites:** Claude Code installed, and a git repository as your working directory.\n\n```bash\nbash \u003c(curl -fsSL https://raw.githubusercontent.com/lucagattoni/Claude-Warp/main/install.sh)\n```\n\nThis runs `/claude-warp-setup` autonomously: detects your project type, fills `CLAUDE.md` and `harness-manifest.json`, installs all skills under `.claude/skills/`, and commits everything in one go.\n\n→ Full installation guide: [docs/install.md](docs/install.md)\n\n---\n\n## Quick start\n\n```bash\n# Scaffold a daily loop from a one-line goal\nclaude -p '/claude-warp-new-loop \"summarise new GitHub Issues every morning\"'\n\n# Test it before scheduling\nbash scripts/run-\u003cslug\u003e.sh\n\n# Schedule it — cloud-hosted (preferred)\nclaude -p \"/schedule\"\n\n# Or wire to local cron (paste the generated snippet)\ncrontab -e\n\n# Keep skills up to date\nclaude -p \"/claude-warp-update\"\n```\n\n→ Full usage guide: [docs/usage.md](docs/usage.md)\n\n---\n\n## Skills\n\n| Skill | What it does |\n|---|---|\n| `/claude-warp-setup` | Per-project installer |\n| `/claude-warp-new \"goal\"` | **Start here** — assess complexity and route to the right scaffold automatically |\n| `/claude-warp-contract \"goal\"` | Interactively negotiate a complete, risk-classified [Loop Contract](docs/goal-readiness.md) — draft-first, critically reviewed — then hand off to a scaffolder; use when a goal needs proper specification first |\n| `/claude-warp-new-loop \"goal\"` | Scaffold a recurring single-agent loop or fan-out loop |\n| `/claude-warp-new-goal \"goal\"` | Scaffold a one-shot bounded goal that runs once and stops at a verifiable criterion |\n| `/claude-warp-new-harness \"goal\"` | Scaffold a two-part harness for large multi-stage goals |\n| `/claude-warp-new-agent \"role\"` | Scaffold a specialized subagent in `.claude/agents/` |\n| `/claude-warp-new-hook \"description\"` | Scaffold a hook (8 patterns): verify-before-stop, destructive-block, audit-log, subagent-chain, security-scan, evidence-gate, kill-switch, steer |\n| `/claude-warp-inventory` | Self-inspect installed skills, agents, hooks, loops — report versions and health issues |\n| `/claude-warp-retro \"slug\"` | Retrospective on a loop — what worked, what failed, top 3 improvements; writes RETRO.md |\n| `/claude-warp-sync` | Prune harness components superseded by Claude Code |\n| `/claude-warp-update` | Pull the latest ClaudeWarp skills from GitHub |\n| `/claude-warp-sync-research` | Scan Claude-Loops and GitHub for new patterns; implement findings automatically |\n\n---\n\n## Docs\n\n| Document | Contents |\n|---|---|\n| [docs/install.md](docs/install.md) | Prerequisites, install command, verification, update, uninstall |\n| [docs/usage.md](docs/usage.md) | Loop types, scheduling, iterating, keeping the harness current |\n| [docs/loop-harness.md](docs/loop-harness.md) | Architecture: native vs harness boundary, skills in depth, templates reference |\n| [docs/goal-readiness.md](docs/goal-readiness.md) | G0–G3 readiness scale — how to specify goals so agents know when they are done |\n\n---\n\n## Companion\n\n[ClaudeLoops](https://github.com/lucagattoni/Claude-Loops) is the knowledge base behind ClaudeWarp — loop engineering patterns, failure modes, and building blocks.\n\n---\n\n## Design\n\nClaudeWarp separates two kinds of thing, and they move in opposite directions:\n\n- **Native-replaceable components** (skill distribution, scheduling guards, cross-run state) are *meant to shrink*. Each tracks a `native_since` field in `harness-manifest.json`; when `/claude-warp-sync` confirms Claude Code covers it natively, the component is marked superseded and retired.\n- **Loop-engineering workflow skills** (scaffolding, the contract negotiator, checkers, hooks, retrospectives) are the durable value. These track the *practice* of loop engineering, not gaps in Claude Code — as the discipline matures (\"the harness now matters more than the model\"), this layer grows.\n\nSo the harness as plumbing shrinks toward zero, while the harness as method deepens. Conflating the two is the easy mistake; `/claude-warp-sync` only ever retires the former.\n\n---\n\n## Developing\n\nWorking on ClaudeWarp itself? `scripts/dev.sh` self-hosts the skills (symlinks them so they run as live `/claude-warp-*` commands in this repo) and verifies source integrity:\n\n```bash\nscripts/dev.sh selfhost   # symlink skills into .claude/skills/ (single source of truth)\nscripts/dev.sh verify     # deterministic checks: integrity, install copy contract, docs coherence\n```\n\nSee the [Developing ClaudeWarp](docs/loop-harness.md#developing-claudewarp) section for the full command reference and what `verify` does (and doesn't) cover.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucagattoni%2Fclaude-warp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flucagattoni%2Fclaude-warp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucagattoni%2Fclaude-warp/lists"}