agentleFS
ZadAnthonyZadAnthony/meta-workflow/skills/execute-with-spec/SKILL.md

execute-with-spec

Skill0 starsChanged 5 months agoMITView on GitHub

Use when executing a frozen plan — hand the work to superpowers execution skills, and carry each stage's expected-value × how-to-verify into every sub-agent you dispatch (fractal hand-off). Part of meta-workflow (Step ③). Intentionally thin — execution itself is superpowers' job.

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Fractal hand-off: when you dispatch a sub-agent, write that stage's *expected value × how to verify* into its prompt.

    line 20
  2. Distinctive:

    Don't defer judgment-dense work: If it can be finished this session, don't split into "do the mechanical part now, review the hard part …

    line 24

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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

Step ③ — Execute against the table

Why this exists: the frozen table only works if it pulls the work the whole way. Left in a drawer until review, it does nothing. And a sub-agent dispatched without the bar will invent its own — usually a lower one.

Do

  1. Re-read the frozen acceptance table and the relevant quality bar before starting. Aim each stage at its expected value — don't just run to "it executes" and wait for Step ④ to catch problems.
  2. Pick the superpowers execution skill that fits: executing-plans (batch with checkpoints), subagent-driven-development (fresh sub-agent per task), test-driven- development, or systematic-debugging.
  3. Fractal hand-off: when you dispatch a sub-agent, write that stage's expected value × how to verify into its prompt. The sub-agent runs the same 0→⑤ loop inside its scope and returns its own self-check. When you dispatch a spec reviewer, the "spec" you feed it is the frozen acceptance stage, not a vague plan.
  4. Don't defer judgment-dense work. If it can be finished this session, don't split into "do the mechanical part now, review the hard part later." Schedule only for real future triggers (an external dependency, an observation window), not to push today's hard call into tomorrow.

Note

The sub-agent's self-check is Step ③, not Step ④. Execution verifying itself is not independent verification — that still has to happen in Step ④.

Relationship to superpowers

This skill is thin on purpose. Execution is entirely superpowers' job; this only enforces that the frozen spec travels with the work down to every sub-agent.

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.