agentleFS
peterbamuhigirepeterbamuhigire/chwezi-dev-engine/skills/execution-plan-scripts/SKILL.md

execution-plan-scripts

Skill31 starsChanged 18 days agoMITView on GitHub

Use when converting an approved long-running plan into self-contained execution prompts across sessions or workers. Covers dependency order, checkpoints, capability fallback and evidence handoff; use world-class-engineering for a single implementation slice.

The file

We split this skill into the rules it gives an agent

12 rules. About 0 are common, 11 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈11

    Distinctive · estimate

    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. Distinctive:

    Read the plan, user corrections and repository instructions.

    line 48
  2. Distinctive:

    Write self-contained prompts using the task contract below.

    line 50
  3. Distinctive:

    Check every prompt against the plan: owner, required inputs, allowed scope, output, acceptance evidence and checkpoint.

    line 52
  4. Distinctive:

    Keep a durable checkpoint outside chat.

    line 60
  5. Distinctive:

    Before delegation, verify the specialist's live skills, tools, readiness and scoped authority.

    line 70
  6. Distinctive:

    When authoring a software/app execution script, load this skill and discover the current domain catalogue from the executing environment's …

    line 86
  7. Distinctive:

    Do not hardcode a skills-library path.

    line 111
  8. Distinctive:

    Use the project's own task/status format.

    line 117
  9. Distinctive:

    Run risk-matched integration and cleanup checks.

    line 119
  10. Distinctive:

    Keep publication within existing authority and configured controls.

    line 120
  11. Very specific:

    When this engine changes auto-agents, update the canonical copy in skills-engine-agents first, regenerate its manifest, run its tests, then …

    line 157
  12. Distinctive:

    Use the project-owned plan for scope, authority, decisions, acceptance, ordered slices and recovery handoff.

    line 166

≈ “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

Execution Plan Scripts

<!-- dual-compat-start -->

Required Inputs

InputOwnerIf absent
Approved plan, current task states and acceptance criteriaTask ownerDraft the plan before generating execution prompts
Repository instructions, live skill inventory and supported capabilitiesExecuting environmentDiscover them; do not assume a named plugin or tool exists
Dependencies, file ownership and last verified checkpointCoordinatorSequence dependent work and resolve overlapping writes
Existing authorisation and external-action limitsUser and host policyCarry forward the existing scope; stop only for work outside it

Capability and degraded modes

Authoring requires read/search access and the plan-authoring scope. Execution and delegation are optional: use sequential prompts when workers are unavailable. An optional process skill may help but is never a prerequisite. If a required source, capability, test environment or credential is unavailable, mark the affected evidence NOT ASSESSED and continue independent work. Do not turn a missing required test into an expected failure to make a suite green.

Decision rules

ConditionPrompt designEvidence required
A task consumes another task's outputRun after the producer's acceptance gateProducer artefact and result
Independent tasks have disjoint write sets and delegation is availableAssign one owner per write setReconciled diffs and worker results
A slice delivers one end-to-end user outcomeRepresent it as a tracer-bullet node with blocking edgesRunnable thin-slice evidence
A live contract or schema cannot change atomicallyUse expand-contract nodes and preserve a green compatibility boundaryVersion-skew and rollback checks
Delegation or a named process skill is unavailableExecute the same tasks sequentiallySame acceptance criteria and checkpoint
A session resumes or compactsRead the checkpoint and inspect current stateRemaining work, prior results and user corrections
An action exceeds existing authorityFinish independent preparation, then request that specific authorityReviewable proposal and scope boundary

Workflow

  1. Read the plan, user corrections and repository instructions; enumerate live skills and capabilities.
  2. Partition work by outcome, dependency and exclusive write ownership. Keep the next blocking task with the coordinator; delegate only when the worker is available and ready.
  3. Write self-contained prompts using the task contract below. Quote applicable skills by name, never a machine-specific path.
  4. Name exact acceptance checks, semantic expected results, relevant failure states, unresolved prerequisites and the recovery point.
  5. Check every prompt against the plan: owner, required inputs, allowed scope, output, acceptance evidence and checkpoint.

Durable task and recovery contract

Give each independently verified task a stable ID, prerequisites, one accountable owner, exclusive write set, exact inputs or producer outputs, expected result and acceptance oracle. Bind evidence to revision, configuration/runtime, environment, command, inputs, date and outcome; a zero exit alone is not semantic acceptance. Keep a durable checkpoint outside chat. After interruption, reboot, quota expiry, session replacement or wait timeout, inspect the worktree and checkpoint, reconcile task state and external effects, then resume at the first dependency-ready incomplete task. Repeat only when relevant inputs or conditions changed. A timeout is not proof of completion; supervise the process/result or mark it NOT ASSESSED with an owner and recovery action. Record watch status with time, source and inspected scope; silence or an empty poll does not establish clearance. See the on-demand prompt construction and review guide for templates and conditional plan-status rules.

Before delegation, verify the specialist's live skills, tools, readiness and scoped authority. Preserve independent review evidence and unresolved disagreement. Keep context to relevant plan sections, files and constraints; select checks by risk. Continue already authorised phases in dependency order without a routine fresh permission request at each checkpoint. Pause only for a missing decision, required approval, genuine blocker or governing instruction; continue independent work.

Quality standards

Prompts preserve existing authorisation, corrections and incomplete work. Completion requires observed acceptance evidence. A tool call, generated file or unrun test is not completion. Use concise, self-contained prompts that retain the handoff a fresh session needs.

Dynamic skill discovery

When authoring a software/app execution script, load this skill and discover the current domain catalogue from the executing environment's repository instructions. Select only relevant domain skills and available process guidance; quote skill names in each prompt and re-quote them in each delegated prompt. Never freeze a list of skill names or hardcode the library path. Self-load this skill for multi-prompt software/app plans; use world-class-engineering and the relevant domain skill for a single implementation slice.

Each prompt distinguishes:

  • Domain guidance: what good work looks like. Resolve its path from the live environment and load the skills that apply to that task.
  • Process guidance: how to organise testing, review, verification or delegation. Discover what is available; use only what adds value, without making a named plugin a prerequisite.

Prompt construction and execution

Make every prompt runnable in a fresh session without relying on prior conversation. State its task/outcome, repository, required source files, discovered skill names, scope and exclusions, dependencies, acceptance evidence, next checkpoint and authority boundary. Detailed examples, delegation mechanics, operator-action blocks, verification format and project-specific status conventions are in the linked reference; load only the sections needed for the plan.

Do not hardcode a skills-library path. Use the executor's CLAUDE.md, AGENTS.md, GEMINI.md or equivalent to resolve names. A prompt may name a skill only after the authoring session has checked the live catalogue.

Closeout rules

  • Use the project's own task/status format. Update task state only after evidence; apply phase/index conventions only when the plan defines them.
  • Surface an operator-only prerequisite before the affected task. Use existing authority; request new authority only for the specific action that exceeds it. Continue independent work.
  • Run risk-matched integration and cleanup checks; do not impose blanket security, tenancy, i18n, memory or other sweeps where the work does not affect them.
  • Keep publication within existing authority and configured controls. Prompts must not expand authority, bypass gates or push/merge on their own.
  • Review every delegated diff against its write scope and reconcile it with the acceptance criteria before integration.

References

  • Prompt construction and review guide: load for a prompt skeleton, delegation and verification examples, operator actions, and plan-specific status controls.
  • Tracer-bullet work graphs and expand-contract
  • Plan header and proportion check: spec pointer, constraints, per-node interfaces, review focus and proportion.

Outputs

  • A Markdown script with purpose, task order, domain/process skill sources, authority boundary and self-contained prompts for each task.
  • A prompt-to-task mapping with owners, dependencies and acceptance checks.
  • Operator notes for run order, prerequisites, and deferred checks.

Evidence Produced

CategoryArtifactFormatExample
CorrectnessTask-to-prompt coverage with dependencies and acceptance checksMarkdown tableEach approved task maps to one owner and an acceptance oracle
OperabilityResume checkpoint and capability fallbackMarkdownCompleted task evidence, remaining work and sequential fallback
Release evidenceVerification results and unresolved prerequisitesMarkdownFailed and unavailable checks with release consequence
<!-- dual-compat-end -->

Unattended execution handoff

For an owner-authorised unattended development plan, use the project-local auto-agents/README.md and auto-agents/config.json. Keep the plan and authority explicit; configure project-specific verification commands and a durable handoff. Publishing, remote, branch, runner and limits remain project settings. A worktree is checkout isolation, not a sandbox. Preserve host permissions and security controls. Failed or unavailable checks are never passes. Verify the actual driver version and runtime before relying on it.

Propagate tool upgrades

When this engine changes auto-agents, update the canonical copy in skills-engine-agents first, regenerate its manifest, run its tests, then discover and update installed project and engine copies through its managed propagation workflow. Preserve local configuration, plans and edits; report blocked or missing targets. Batch required host plugin-cache refreshes at the end and retain hook-trust checks. See auto-agents/README.md.

Durable execution plan and verification

Use the project-owned plan for scope, authority, decisions, acceptance, ordered slices and recovery handoff. The local plan template is optional; adapt it rather than filling it mechanically. Configure meaningful checks before execution and record unrun or failed checks accurately. Resume from durable evidence, verify the resulting revision independently before configured publication, continue independent authorised work, and correct material review findings.

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.