SHIPPED / v0.1
Setup + Doctor
Plan exact file operations, preserve unknown files, then report roots, collisions, permissions, discovery and behavior separately.
System Error Worldwide / v0.1.0
One portable agent workflow across five coding tools.
Thirty-one complete portable skills for Codex, Claude Code, Kimi Code, OpenCode and DeepSeek Harness. One contract covers setup, capability routing, bounded autonomy, evidence and clean handoff.
Open source, MIT licensed and local-first. Created and maintained by Moses Mawila through System Error Worldwide. No hosted account, model lock-in, prompt capture or client telemetry is required.
01 / Workflow
THE LOOP moves one project through six visible stages. Each stage has a purpose, a finish condition and a clear handoff to the next.
Define the problem, scope, constraints and success criteria.
Write the product, technical and delivery plan before building.
Complete one approved piece of work without disturbing anything else.
Run reproducible checks and record every issue that remains.
Fix the issues, rerun the checks and repeat when needed.
Record the final result, remaining limits and next safe action.
02 / Quickstart
Setup starts read-only. It shows the harnesses, destinations, collisions and exact file operations before anything changes.
git clone https://github.com/System-Error-Worldwide/the-loop.git
cd the-loop
# Read-only install plan
python3 scripts/the_loop_setup.py \
--target-root /path/to/project \
--harness codex \
--json
# Apply the reviewed plan
python3 scripts/the_loop_setup.py \
--target-root /path/to/project \
--harness codex \
--apply \
--actor local-user \
--source-version 0.1.0 \
--json
# Verify the installed pack
python3 /path/to/project/.the-loop/toolkit/scripts/the_loop_doctor.py \
--project-root /path/to/project \
--json
Retry the canonical repository. Do not install a mirror or private copy unless its revision and provenance match the official release.
Stop before overwrite. Review the dry-run operation, inspect Doctor's winning precedence and approve only the exact intended change.
Treat file discovery and behavior as separate facts. Doctor must show both locations, the winner, permission limits and the corrective action.
Keep the result UNVERIFIED or UNSUPPORTED. Use a documented target
harness or wait for dated conformance evidence. Never invent an adapter.
03 / Operating modes
Setup and Doctor install and verify the pack. Loop, Auto, Parallel, Cloud and Endless are all shipped v0.1 modes. Their supervision model changes; the safety invariants do not.
SHIPPED / v0.1
Plan exact file operations, preserve unknown files, then report roots, collisions, permissions, discovery and behavior separately.
SHIPPED / v0.1
The attended default. Meaningful gates stay visible while one asset moves through the lifecycle.
SHIPPED / v0.1
One declared asset to green or a configured gate. It never selects an endless stream of work.
SHIPPED / v0.1
Independent lanes with disjoint leases and one integration owner. Shared-file work remains sequential.
SHIPPED / v0.1
Restricted or remote planning, drafting and handoff without private infrastructure assumptions.
SHIPPED / v0.1
Runs an approved queue as a series of bounded Auto missions. It never invents work, and every mission keeps time, token, action, attempt and cost limits.
04 / Complete portable pack
All 31 skills are complete and included in v0.1. They are grouped by what they help you do: install and control, run different modes, manage the build lifecycle and hand work off cleanly.
the-loop-setupthe-loop-doctorthe-loop-skill-plannerthe-loop-skill-creatorthe-loop-autonomythe-loop-controlthe-loop-watchthe-loopthe-loop-autothe-loop-parallelthe-loop-cloudthe-loop-endlessstrategizespec-packbuildtestresolvehealth-checkauditportfolio-reviewlive-state-preflightidea-to-briefstack-summarybootstrap-agent-contextpre-commit-reviewfeature-trackerdecision-loghandoffretrospectivesession-summaryclose05 / Skill selection
THE LOOP checks which compatible skills are already installed. When a qualified specialist is available, it uses it. Otherwise the bundled System Error fallback keeps the workflow moving under the same safety rules.
WHEN AVAILABLE
Used when an installed skill meets the task and safety requirements.
ALWAYS INCLUDED
Used when no installed specialist qualifies. The output and safety rules stay the same.
Installed specialists stay in their maintained source. THE LOOP uses them when available but does not copy their code or instructions into the bundled pack.
06 / Authority and recovery
Default authority covers local, reversible work inside the declared asset. Outward actions, strategy expansion and self-modification require exact, visible permission.
.the-loop/STOP
Detection prevents the next mutation. Removing the file never silently resumes work; explicit resume, a current grant and a fresh lease are required.
07 / Compatibility
One canonical skill source, thin harness adapters and the same status, authority, evidence and failure vocabulary in every supported environment.
| Harness | Version | Adapter | Install | Discovery | Invocation |
|---|---|---|---|---|---|
| Codex | 0.144.1 |
INCLUDED | VERIFIED | VERIFIED | Select or mention $the-loop |
| Claude Code | 2.1.221 |
INCLUDED | VERIFIED | VERIFIED | /the-loop |
| Kimi Code | 0.36.1 |
INCLUDED | VERIFIED | VERIFIED | /skill:the-loop |
| OpenCode | 1.15.1 |
INCLUDED | VERIFIED | VERIFIED | Load skill(the-loop) |
| DeepSeek Harness | 0.1.0-rc.6 |
INCLUDED | VERIFIED | VERIFIED | /the-loop |
08 / Two tracks, one evidence contract
Both tracks declare the asset, route, evidence, issue, resolution and limits. The contract changes by track; the completion rule does not.
EXAMPLE / CODE
feature/slug-validatorEXAMPLE / NON-CODE
docs/workshop-decision-brief.md09 / Provenance and trust
Every shipped file has a public provenance record, a compatible licence and a review trail.
The pack contains System Error originals, clean-room rewrites and approved upstream dependencies. Each shipped file is classified and traceable.
All System Error original and clean-room rewrite work in the public repository is MIT licensed. Third-party dependencies keep their own licences and are included only with an approved provenance record.
This page adds no cookies, analytics, external fonts or event collection.
Read the source contract
Install the current release, inspect the protocol and verify every capability claim against its public evidence.
Open GitHub ↗︎