Ruleloop

A small Codex skill I use for long tasks so work stays traceable and less fragile.

I am sharing this as-is because it helped me avoid common execution problems:

• losing context across many batches
• forgetting to sync rules/docs after code changes
• weak checkpoints that are hard to review or roll back
• closing findings without clean evidence

If you run multi-batch remediation, audit, or refactor work, this may help.

---

What Ruleloop does

Ruleloop enforces a practical execution loop:

1. Define one clear batch scope.
2. Implement the smallest safe change.
3. Validate immediately (tests/lint/typecheck/build/E2E as needed).
4. Capture decision-grade evidence.
5. Sync rules, backlog, and logbook in the same batch.
6. Create a clean checkpoint commit.

The goal is simple: keep momentum without losing governance.

---

Repository Structure

skills/
  ruleloop/
    SKILL.md
    agents/openai.yaml
    references/templates.md
LICENSE
README.md

---

Install (Manual)

Copy the skill into your global Codex skills folder:

mkdir -p "${HOME}/.codex/skills"
cp -R skills/ruleloop "${HOME}/.codex/skills/"

---

How to use

Call the skill from Codex when starting a long-running task:

Use $ruleloop for this multi-batch task.

Example:

Use $ruleloop to run a full remediation pass and keep rules/logbook synced after each batch.

---

Best fit

• UI/UX remediation with many batches
• cross-file refactors that need strict traceability
• tasks where documentation drift is likely
• autonomous execution where context can be lost

---

Suggested GitHub Metadata

Use this in the repository "About" panel:

• Description:
  • Codex skill for governed multi-batch execution with logbook discipline, rules sync, evidence hygiene, and safe git checkpoints.
• Topics:
  • codex-skill
  • ai-agent
  • workflow
  • governance
  • audit
  • remediation
  • runbook
  • developer-productivity

Optional:

• Website:
  • your docs page or gist (if you have one)
• Social preview:
  • a simple image with text: Ruleloop - Governed Multi-Batch Execution

---

Notes

This is not a universal framework.
It is just a workflow that worked well for me in real long-running tasks.

If you improve it, feel free to open a PR.