v1.0.0
Loop-Engineering v1.0.0
Superseded by v1.0.1, which fixes Claude Code marketplace loading and GitHub CLI pinned-install metadata compatibility. Use v1.0.1 for new installations.
Loop-Engineering is now a complete, installable Agent Skill with an evidence-bound local reference runtime.
Highlights
- one canonical Skill for Codex and Claude Code
- progressive references, self-contained assets, scripts, and behavior evals
- Codex and Claude plugin/marketplace manifests
- portable
loop.yamlprotocol with fail-closed schema and safety validation - independent evaluator artifacts bound by context ID and SHA-256
- durable state, retries, budgets, pause/resume, leases, and audit logs
- matched-benchmark task-strategy experiments with mechanical scoring
- digest-bound human approval, version archives, and monotonic rollback
- Chinese-first README with a complete English counterpart
Install
gh skill install sheepxux/Loop-Engineering loop-engineering@v1.0.0 --agent codex
gh skill install sheepxux/Loop-Engineering loop-engineering@v1.0.0 --agent claude-codeSee the README for Codex plugin, Claude plugin, source, and optional npm installation paths.
Important boundaries
“Evolution” means benchmark-gated optimization of task instructions. It does not update model weights, weaken the immutable loop contract, or guarantee improvement. Merge, deployment, deletion, spending, external messaging, and permission changes remain human-only. The local Runner is not an operating-system sandbox, and the generated GitHub Actions workflow is a read-only preflight scaffold until an operator adds a real executor and durable state channel.
Validation
- 42 automated tests across runtime, evidence, safety, evolution, installation, and rendering
- CI on Node.js 20, 22, and 24
- official Skill, Codex plugin, Claude plugin, and GitHub Skill validation
- clean tarball installation and README quick-start execution
- fresh-agent behavior checks for one-shot, recurring, and unsafe-loop requests
- npm production dependency audit: 0 vulnerabilities
Upgrade notes
The canonical Skill now lives at skills/loop-engineering/. Codex loop instances render to .agents/skills/<loop-name>/; Claude Code instances render to .claude/skills/<loop-name>/. The old duplicated static Codex and Claude adapter Skills were removed. Protocol schemas and evidence requirements are stricter than v0.1.0, so revalidate existing loop contracts before recording new runs.