agentleFS
inanna-malickinanna-malick/agent-skills/skills/write-plans/SKILL.md

write-plans

Skill22 starsChanged 38 days agoMITView on GitHub

Write or revise plans for future execution by capable agents or collaborators. Use when the requested deliverable is an implementation plan, investigation plan, execution brief, or continuation handoff that must preserve intent and support adaptation across context changes.

2 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. narumiruna/skills★ 17same name
    2. marcus/marcus-skills★ 4same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository2 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    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:

    Use references/methods.md when the underlying planning concepts or their limits need grounding.

    line 34

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

Write Plans

Write for a capable executor who will have less conversational context and more evidence than you do now. Carry forward intent, a useful problem representation, a repertoire of methods, and the grounds for choosing the next action. Use high-salience domain concepts to compress shared knowledge and make room for breadth. Supply the local distinctions that change their application.

Select and combine the lenses below as the task warrants. Scale detail to uncertainty, dependencies, and consequences. Let the requested artifact determine the structure; a short plan can be sufficient. Match the surrounding assignment: deliver a plan when planning is requested, or use it to continue work already authorized.

Intent; constraint satisfaction; acceptance criteria. Recover the desired outcome, its purpose, scope, and consequential user preferences. Distinguish requirements from preferences and proposed solutions. Define success through observable results or artifacts. For exploratory work, specify the question and what would constitute an informative result without assuming the conclusion. Preserve why a constraint matters so later choices can honor its purpose. Keep uncertainties about the goal separate from uncertainties about implementation.

Problem representation; affordances; analogical transfer. Expose the relationships that make the work tractable: state transitions, dependencies, invariants, audiences, incentives, representations, or asymmetries between construction and verification. Name applicable methods and useful adjacencies, including approaches whose value may become apparent later. Connect them through shared structure, prerequisites, alternatives, and tradeoffs. Incremental derived state suggests recomputation oracles; compatibility constraints suggest staged migration; competing explanations suggest discriminating experiments. Teach recognition beyond the initial examples. Distinguish committed actions from the available methodological repertoire.

Epistemic state; provenance; decision records. Separate observations, inferences, assumptions, proposals, and decisions already made. Ground consequential claims in inspectable artifacts; record revisions or dates where freshness affects the choice. Preserve the rationale for significant decisions, including rejected alternatives when the reason for rejection could change. Carry forward corrections and constraints established in the conversation. An unresolved premise should remain visible as a question, assumption, or proposed check; confident prose must not convert it into an established fact.

Backward chaining; means–ends analysis; proof obligations. Work backward from the intended result to the evidence, intermediate capabilities, and actions needed to obtain it. Explain how consequential steps contribute to the outcome. Make the first useful move executable with the available context: an entry point, a question to resolve, a candidate method, or a bounded change with a meaningful check. Specify interfaces and failure-sensitive details where they constrain correctness; leave ordinary implementation choices to the executor. Carry useful partial results forward when a later question remains open.

Partial-order planning; causal links; critical path. Order work by real dependencies. Identify what each substantial work item needs and produces, and which actions could invalidate another item's prerequisites. Distinguish necessary ordering from convenient sequencing. Where parallel work helps, define independent responsibilities, shared interfaces, resource constraints, and integration evidence. Account for shared mutable artifacts and duplicated effort. Make the current bottleneck visible so new information can change the allocation of work.

Contingent planning; hypothesis discrimination; value of information. Turn important uncertainties into observations that can change a decision. Pair a consequential question with a useful probe, interpretation of its possible results, and the resulting branch. Prefer investigations that discriminate between plausible approaches or unlock several dependent tasks. Keep independent work moving while a question is unresolved. Spend planning and research effort in proportion to their expected effect on the next decision; stop elaborating when the executor has a sound next move and useful grounds for adaptation.

Assumption-based planning; signposts; sensitivity analysis. Identify assumptions whose failure would materially change the approach. For uncertain, consequential assumptions, describe observable signs that warrant reassessment and the affected decisions. Consider how the plan changes if a dependency behaves differently, a resource is unavailable, or an early hypothesis is wrong. Preserve useful fallback options and actions that reduce dependence on uncertain premises. Investigate plausible, consequential failure modes in proportion to the task; ordinary work need not become a catalog of hypothetical disasters.

Receding horizon; least commitment; option value. Make near-term work concrete and later work conditional on what it will reveal. Defer expensive commitments whose justification depends on missing evidence; retain choices that make subsequent revision cheap. Refine the plan as uncertainty resolves. Treat estimates as estimates and tie checkpoints to useful evidence or deliverables. Avoid inventing deadlines, budgets, or certainty about implementation details the task has not established.

Feedback control; observability; independent verification. Connect actions to expected observations and criteria for continuing, changing approach, or finishing. Separate activity measures from evidence that the intended result holds. Choose checks appropriate to the claim: executable regressions, independent calculations, source checks, representative examples, or editorial review. If a check or search is quiet, consider whether it could detect the relevant failure before treating silence as assurance. Keep proposed validation separate from completed validation and retain the limitations of the evidence.

State externalization; prospective memory; dependency invalidation. Make the plan resumable: retain the current objective, consequential decisions, completed evidence, active work, next useful actions, and unresolved dependencies. Link durable artifacts instead of copying transcripts or tool output. When evidence invalidates a premise, revise the downstream approach and mark superseded decisions where their history still matters. Keep current guidance coherent. Preserve enough context to resume without repeating completed work or mistaking a stale instruction for the current plan.

Counterfactual review; executable walkthrough; proportionality. Read the plan as a fresh executor. Can you begin, choose among methods, inspect the evidence, and recognize completion? Perturb an important assumption and check whether the plan supports an intelligent response. Look for missing causal links, circular dependencies, unsupported assertions, and steps whose outcome would not affect subsequent work. For simple tasks, check that the plan remains simple. Trim repeated exposition while retaining distinct useful concepts, consequential constraints, and reasons that would otherwise be lost at handoff.

Use references/methods.md when the underlying planning concepts or their limits need grounding. The repertoire remains open: recruit other methods when they make the work easier to recognize, investigate, or complete.

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.