agentleFS
augments-labsaugments-labs/sdlc-skills/skills/planning/define-goals/SKILL.md

define-goals

Skill1 starsChanged 3 months agoMITView on GitHub

Pins down what a new project or initiative is for: the objective, the stakeholders, how success is measured, and the guardrails. Use when a new project or initiative starts before scoping or building, or when the user wants to build X with no stated objective, or when the objective is vague or missing. Skip a single feature, and skip while a decision or approval reply is pending.

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 4 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Before scope or design, name the outcome, and how you will know you reached it.

    line 8
  2. Very specific:

    Skip: when a drafted goal or brief is awaiting a direct answer.

    line 18
  3. Distinctive:

    Ask "why this, why now?" until the answer is what the world does differently afterward, not code that exists.

    line 26
  4. Distinctive:

    Write the guardrails and the failure criterion.

    line 38
  5. Distinctive:

    Write the value in one sentence.

    line 39
  6. Very specific:

    Write the ## Goals section, which is never edited once its identity is issued, to .sdlc-skills/briefs/{{YYYY-MM-DD}}-{{topic}}.md or the …

    line 43
  7. Very specific:

    Ask this and end the turn.

    line 64

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

Define Goals

Before scope or design, name the outcome, and how you will know you reached it.

When to use

  • Starting a new project, product, or substantial initiative with a fuzzy "why".
  • Skip for a single feature or task. Use clarifying-intent only for genuine ambiguity about which initiative or procedure is intended; writing-specs owns settled, detailed feature requirements.
  • Skip when a drafted goal or brief is awaiting a direct answer. If the reply informs but does not answer, handle it with clarifying-intent, not with a new goal pass.

Step 1: Find the objective

Open assets/goals-section.md before starting; each step fills its section.

  1. Ask "why this, why now?" until the answer is what the world does differently afterward, not code that exists.
  2. Name who benefits, who operates or bears risk, what changes for each, and who owns the outcome. If goals compete, give each its own metric, never one averaged metric.
  3. Record one accountable decision owner, or else the approvers, the conflict resolver, and the decision rule. If the user is the only stakeholder (a solo owner), write the user as the decision owner in Decision rule: and name no approvers or conflict resolver.
  4. For each outcome, record its current baseline, target, time horizon, measurement source, and accountable owner. If an outcome has no source or date, it cannot be checked, so it is not a goal.
  5. Write the guardrails and the failure criterion.
  6. Write the value in one sentence.

Step 2: Write and present

  1. Write the ## Goals section, which is never edited once its identity is issued, to .sdlc-skills/briefs/{{YYYY-MM-DD}}-{{topic}}.md or the user-set path, leaving the approved sections around it untouched. When the work came from a captured ticket, fill Source with the capture's path and identity.
  2. Present:

    Goals {{path}} — version {{identity (per template)}}
    Objective: {{one line}}
    Measure: {{baseline}} → {{target}} by {{horizon}}, source {{source}}
    Guardrails: {{list}}
    
    1. Approve the goals
    2. Request changes
    3. Reject the objective
    4. Cancel
    
    Recommendation: {{option the open assumptions support}} — {{one sentence}}.

    Ask this and end the turn; clarifying-intent owns what closes it.

  3. REQUIRED SUB-SKILL: on option 1, invoke feasibility-check unless an existing feasibility section already fills every dimension row from evidence and no row is unknown; then, if the boundary is next, invoke scoping. Never impose a phase that is already complete.

Gotchas

  • A guardrail can look complete just because it is written down while no observation could ever show it broken. scoping treats every goal guardrail as a non-negotiable constraint on each cut, so a guardrail with no observable threshold lets a cut violate it with nothing in place to catch that.
  • Naming several approvers for the objective without also naming a conflict resolver and a decision rule leaves no way to settle it when they disagree about what the goal actually is; the brief then stalls on a tie nobody is placed to break.

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.