agentleFS
niksavisniksavis/basicly/.agents/skills/harness-loop/SKILL.md

harness-loop

Skill2 starsChanged 5 days agoMITView on GitHub

Drives tracked work through the basicly loop, intake to ship. Use to start or resume work, or to move an issue past a checkpoint or gate.

5 other projects use a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

6 rules. 0 are common, 5 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 4 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Read loop state only when starting, advancing or recovering work explicitly managed by basicly loop:

    line 13
  2. Distinctive:

    Keep the base checkout read-only while another pass runs.

    line 27
  3. Distinctive:

    When using loop transitions to start a leaf, classify/decompose, land, validate, ship or recover a refusal, read operations.

    line 33
  4. Distinctive:

    Before deciding which checks to run or rerun, read verification.

    line 34
  5. Distinctive:

    Before waiting on a long-running command or CI, read bounded waiting.

    line 35
  6. Distinctive:

    Before running parallel lanes, read the Many lanes section of operations.

    line 36

“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md
<!-- Generated by `basicly skills-build` from skill.yaml. Do not edit; edit the source. -->

Harness Loop

Ordinary work stays with one owner using the tracker, direct implementation and checks. This skill does not require a loop or a new refinement pass. For user-requested observer repair, work outside the controller and report any authorized hook bypasses honestly.

Read loop state only when starting, advancing or recovering work explicitly managed by basicly loop:

basicly loop status <issue>

The tracker is authoritative. Continue the existing task and worktree; do not restart completed steps or create another owner merely because the session changed.

Boundaries

  • For loop-managed work, commit code on its branch before advancing; the engine commits loop tracker state. Direct observer work commits its own tracker evidence.
  • The build-to-verify transition performs landing and records verification. Do not record that gate early; it can skip the landing. Confirm landing from the [merged] output.
  • Keep the base checkout read-only while another pass runs. Never clear another session's files to unblock landing.
  • Reuse verification only when the engine establishes equivalent trusted inputs. Changed inputs or failed checks require the affected checks again.
  • Observe a recorded pending process before launching another. A polling timeout does not prove it stopped.

Read only the procedure needed now

  • When using loop transitions to start a leaf, classify/decompose, land, validate, ship or recover a refusal, read operations. It includes exact commands, phase inputs, ledger handling and escalation rules.
  • Before deciding which checks to run or rerun, read verification.
  • Before waiting on a long-running command or CI, read bounded waiting.
  • Before running parallel lanes, read the Many lanes section of operations. For lane limits and spending observations, also read many-lanes.
  • For ordinary implementation inside an existing lane, use the task facts and relevant implementation skills. Load the operational reference when a transition or failure requires it.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.