agentleFS
runxhqrunxhq/runx/skills/work-plan/SKILL.md

work-plan

Skill97 starsChanged 33 days agoApache-2.0View on GitHub

Compile a bounded objective or issue-intake change set into a dependency-safe Runx execution plan, with deterministic checks for evidence preservation, mutation boundaries, catalog references, and skill-package ownership. Use before multi-step or cross-surface work; this skill plans but does not execute.

6 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

1 rule. 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 6 edited versions we read keep these.

  • 0

    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:

    Start from objective. When change_set is supplied by issue-intake, preserve it exactly.

    line 12

“Common” is measured: kept by at least 6 in 10 of the 6 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

Work Plan

Turn one objective into a plan that downstream runners can consume without reinterpreting the source request.

Procedure

  1. Start from objective. When change_set is supplied by issue-intake, preserve it exactly; do not rewrite its target surfaces, invariants, success criteria, or commencement decision.
  2. Classify the plan as workspace_change or skill_package. Skill-package authoring belongs to skill-lab; do not route it through a generic repo-change step.
  3. Split work at authority, mutation, dependency, and review boundaries. Keep steps coarse enough to produce a meaningful artifact.
  4. Declare ordered phases and repo change requests. Parallel work must have no dependency or shared mutation target.
  5. Declare orchestration steps with exact skill references, scopes, mutation flags, inputs, and prior-step context references.
  6. Return blocked when a question must be answered before mutation. Never turn uncertainty into an executable plan.
  7. Native catalog inspection supplies the actual installed skill set. The domain validator then verifies source preservation, ordered DAGs, mutation declarations, context references, catalog ownership, and the skill-lab boundary. Invalid candidates are withheld and returned as a blocked packet.

This skill does not approve or execute mutations. A mutating: true field describes authority a future step will need.

Output

decision: ready | blocked
plan_kind: workspace_change | skill_package
change_set: object
objective_summary: string
workspace_change_plan: object
orchestration_steps: array
required_skills: array
open_questions: array
evidence: object
validation:
  status: pass | hold
  findings: array

workspace_change_plan contains plan_id, change_set_id, objective_summary, shared invariants, success criteria, ordered phases, integration checks, and open questions. Each phase contains ordered repo change requests with dependencies, validation commands, and mutation declarations.

evidence.source_change_set_status is preserved, drifted, or not_supplied; source_change_set_preserved: false is never a successful preservation claim. When a caller supplies source context, drift or loss blocks the plan.

Inputs are objective, optional project_context, thread_locator, thread, change_set, and harness_context. harness_context is passed through from the caller; the agent does not reconstruct or advance it.

Agent task contracts

work-plan-draft

Return work_plan_draft with decision, plan_kind, change_set, objective_summary, workspace_change_plan, orchestration_steps, required_skills, and open_questions. Preserve a supplied change_set exactly. Split at authority, mutation, dependency, and review boundaries; do not split for cognitive convenience. Every phase, repo request, and orchestration step needs an id, ordered dependencies, and an explicit mutation flag. A ready plan has no blocking open questions. Use plan_kind skill_package for Runx skill authoring and route that work through skill-lab. This runner plans only and never claims downstream execution.

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.