mcpField
G
goal-design

goal-design

github.com/owainlewisAgent workflows42343 installsUpdated 2w ago
Repository

About goal-design

A skill that turns a project brief into a concise, verifiable `/goal` prompt for an agent. It specifies checks, evidence, an effort budget, reviewer sign-off, and conditions for stopping as blocked.

Key features

  1. 01Read the brief and referenced material
  2. 02Draft a five-to-eight-sentence `/goal` prompt
  3. 03Specify verifiable checks and proof
  4. 04Set an effort budget and stop conditions
  5. 05Require reviewer sign-off before a pull request

Use cases

  1. 01Convert a change request into an agent goal
  2. 02Define evidence needed to verify completion
  3. 03Bound work with budgets and blocking conditions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/owainlewis/blueprint --skill goal-design

After installing, type/goal-designin Claude Code to confirm it loaded.

Details

From the project README

Goal Design

  1. Read the brief and anything it references. Ask only when the goal cannot be checked from the input.
  2. Write one plain prompt starting with /goal, 5-8 sentences: what to read first, what to change, what checks must pass, what proof to report, an effort budget, and when to stop as blocked.
  3. Return the prompt first. Add a note after only when useful.

Rules

  • The completion condition must be provable from the agent's own output. Name the exact command and expected result; goal evaluation reads the session, it does not run checks itself.
  • Checks are a gate, not a suggestion. Concrete proof: command results, links, files, screenshots.
  • Always include a budget: a turn, iteration, or time limit.
  • Require reviewer sign-off before PR, and a check of each acceptance criterion when criteria exist.
  • Include stop conditions: unclear change, missing secrets or permission, repeating failure, duplicate PR, scope growing beyond the request.
  • No giant Markdown docs, scheduled jobs, or external automation unless asked.

Shape

/goal Finish <result>. Before changing anything, read <sources>. Change only <allowed files or behavior>. Make the smallest complete change, add or update tests, ask another reviewer to check it, and run <checks>. Do not open a PR or report done until <proof> shows <expected output>. Stop after <budget>, or if <stop condition>, and report what blocks the work.

Comments

Markdown supported