Create Packet Goals
sk-create-goal authors goal.md content for an existing spec packet. It fills per-kind templates that are checked copies of the system-spec-kit goal template and keeps runtime goal state with its existing owners.
1. WHEN TO USE
Activation Triggers
Use this packet to:
- Author or revise a top-level goal or phase-parent goal.
- Author or revise a nested phase-child goal.
- Add
goal.md to an existing packet that has no goal.
- Add a binding row and matching child goal when someone adds a phase.
- Cut an over-budget parent goal without dropping a completion criterion.
- Print a parent goal's chat slice for the operator to set or resend.
- Handle a request that enters through
/create:goal.
Keyword triggers: create packet goal, author goal.md, revise packet goal, phase parent goal, nested phase child goal, add a goal file, goal chat slice, /create:goal.
When NOT to Use
- The target packet does not exist. Use system-spec-kit to create it first.
- The packet's phase structure is not established. Use system-spec-kit to plan the phases first.
- The request is to set, bind, inject or resend a session objective. Redirect it to the goal hooks or the host's native goal command.
- The request changes runtime goal behavior or system-spec-kit template tooling. Those owners remain outside this packet.
This packet authors files only. Its goal-file work does not change session state.
2. SMART ROUTING
The sk-doc hub routes goal-file authoring here: a request to author or revise a packet goal.md selects this packet through the hub's sk-create-goal mode signal.
A request to set, bind or resend a session objective is not file work, so the hub leaves it to the goal hooks.
An authoring or revision request loads references/parent-and-nested-goals.md first, which holds the workflow for every goal kind.
The same request also loads references/authoring-standards.md, assets/goal-exemplars.md and the template for the goal's kind.
A budget measurement or a chat-slice handoff loads references/budget-and-handoff.md.
Read ROUTER.md before selecting skill-local resources; open only the matched files.
3. HOW IT WORKS
- Read the target packet's source specification and acceptance criteria. For a phase parent, read its phase map and inspect every direct phase-child directory on disk.
- Apply the four routing decisions in
ROUTER.md. For top-level, phase-parent, nested-child, retrofit, phase-add and amendment work, load and follow references/parent-and-nested-goals.md. Identify which goal files to add or revise and whether a child change requires a parent amendment first.
- Start each goal from the template for its kind:
goal-top-level-template.md, goal-phase-parent-template.md or goal-phase-child-template.md.
Each is a checked copy of system-spec-kit's goal.md.tmpl at that kind's level.
Copy the block between its template markers into goal.md.
When create.sh --with-goal has already scaffolded a child's goal.md, keep that file and fill it with the child template's guidance.
Child scaffolding alone does not create its parent goal.
- Before filling the template, load
authoring-standards.md and goal-exemplars.md.
Fill it with packet-specific content and apply both resources.
Use three to seven self-contained completion criteria that can be checked without opening another file.
Leave no template placeholders.
Copy the criteria verbatim into the objective text required by the goal contract.
- For a phase parent, make the binding table match the filesystem. Add one row for each direct phase-child directory, with that child's goal document as the target. Keep the table only in the phase-parent goal.
- Keep the durable slice at or below 4,000 characters wherever the cap applies. Load
references/budget-and-handoff.md: section 2 says which goals carry the cap and how to read the packet report, and section 3 is the cut order for a goal that runs over. Never remove a criterion or make one uncheckable.
- Before handing off any authored or revised goal, run
node .skilled/skills/sk-doc/sk-create-goal/scripts/check-goal.cjs <packet> from the repository root and resolve each finding.
A finding left open for any reason, an operator brief included, stops the run: report it, print no chat slice and end with STATUS=FAIL.
To see which criteria may break rules 4 and 5 below, run the advisory lint node .skilled/skills/sk-doc/sk-create-goal/scripts/lint-goal-criteria.cjs <packet>.
It always exits 0 and never blocks the handoff.
- Only after the checker passes, and after authoring or amending a parent goal, load
references/budget-and-handoff.md for the projection distinction and runtime matrix, then print its chat slice with node .skilled/hooks/goal/bin/goal.cjs packet <packet> --workspace <root>. The chat_slice is for the operator to set or resend. It is not a session bind.
4. RULES
✅ ALWAYS
- Run the four pre-write decisions before changing a goal file.
- Derive each goal from the existing packet's source documents, not from a guessed or remembered summary.
- Start every goal from the asset template for its kind. Keep each template's fixed text identical to
goal.md.tmpl. The parity test fails when they drift.
- Use three to seven self-contained criteria.
- Make each criterion checkable without opening another file.
- Remove every template placeholder.
- Preserve every criterion when cutting an over-budget parent.
- Compare each binding row with the direct phase-child directories on disk.
- Print the updated parent chat slice for the operator when parent goal content changes.
⛔ NEVER
- Never change an asset template's fixed text or structure on its own. Change
goal.md.tmpl through system-spec-kit, then carry its new fixed text into all three templates.
- Never modify system-spec-kit's template tooling or shared validator from this packet.
- Never bind a packet to a session, set or resend a session objective, inject runtime state or track whether an operator has set the goal.
- Never put a binding table in a top-level goal or a phase-child goal.
- Never omit a phase child from the parent's binding table or drop a completion criterion to meet the budget.
⚠️ ESCALATE IF
- The source documents disagree about a decision or criterion. They also must describe the same phase structure. Report any conflict instead of choosing a truth silently.
- A phase child is missing the source documents needed to author its goal.
- The parent phase map and child directories do not agree.
- A child change requires a parent decision or criterion amendment, but the request would leave the parent untouched.
- A parent cannot meet the durable budget without losing a criterion or making one unclear. Do not cut the criterion count. Ask whether the packet scope should be split.
- The request requires session-goal state or a change to a system-spec-kit-owned contract.
5. REFERENCES
references/parent-and-nested-goals.md defines the top-level, phase-parent, child, retrofit, phase-add and amendment workflows.
authoring-standards.md gives the reader checks for goal content.
references/budget-and-handoff.md explains the durable budget, the one full cut order, what a parent goal sent in chat contains and the runtime handoff.
goal-exemplars.md records cited pass and failure examples.
goal-top-level-template.md, goal-phase-parent-template.md and goal-phase-child-template.md are the blanks each goal kind is filled from.
goal.md.tmpl is the system-spec-kit source the three templates copy.
scripts/README.md describes the checker, the advisory criteria lint and their tests.
goal-set-string-playbook.md documents the objective set string a runtime binds and when a changed goal is resent. The budget, the cut order and what a goal sent in chat contains are in budget-and-handoff.md.
goal hooks README documents the runtime session-state boundary.
goal.cjs prints a packet's file-derived slices without binding a session.
6. SUCCESS CRITERIA
- Every authored goal starts from the template for its kind, and all three templates match
goal.md.tmpl.
- Every phase-parent binding row corresponds to a direct phase-child directory on disk. No child is omitted.
- Each goal has three to seven self-contained criteria. No template placeholders remain.
- Top-level and phase-parent durable slices meet the 4,000-character limit without losing a criterion.
- Print parent chat slices for the operator. Do not change session objectives or runtime state.
7. INTEGRATION POINTS
- system-spec-kit: Owns
goal.md.tmpl, the source the three asset templates copy, and create.sh --with-goal, which scaffolds child goals with the same structure.
- Goal hooks and host command: Own session binding and objective delivery. This includes injection and resend tracking. This packet only authors the source file and prints its chat slice for the operator.
- Command surface: The intended entry point is
/create:goal. The command itself lives outside this packet.
- sk-doc: Routes goal-file authoring to this packet.
8. RELATED RESOURCES
1---2name: sk-create-goal3description: Authors packet goal.md files from existing specs and leaves the goal template and session state with their owners.4allowed-tools: [Read, Write, Edit, Bash, Grep, Glob]5version: 1.4.7.06metadata:7 source: https://skillmd.com/skills/michelkerkmeester/sk-create-goal8---910# Create Packet Goals1112`sk-create-goal` authors `goal.md` content for an existing spec packet. It fills per-kind templates that are checked copies of the system-spec-kit goal template and keeps runtime goal state with its existing owners.1314---1516## 1. WHEN TO USE1718### Activation Triggers1920Use this packet to:2122- Author or revise a top-level goal or phase-parent goal.23- Author or revise a nested phase-child goal.24- Add `goal.md` to an existing packet that has no goal.25- Add a binding row and matching child goal when someone adds a phase.26- Cut an over-budget parent goal without dropping a completion criterion.27- Print a parent goal's chat slice for the operator to set or resend.28- Handle a request that enters through `/create:goal`.2930Keyword triggers: `create packet goal`, `author goal.md`, `revise packet goal`, `phase parent goal`, `nested phase child goal`, `add a goal file`, `goal chat slice`, `/create:goal`.3132### When NOT to Use3334- The target packet does not exist. Use system-spec-kit to create it first.35- The packet's phase structure is not established. Use system-spec-kit to plan the phases first.36- The request is to set, bind, inject or resend a session objective. Redirect it to the goal hooks or the host's native goal command.37- The request changes runtime goal behavior or system-spec-kit template tooling. Those owners remain outside this packet.3839This packet authors files only. Its goal-file work does not change session state.4041---4243## 2. SMART ROUTING4445The `sk-doc` hub routes goal-file authoring here: a request to author or revise a packet `goal.md` selects this packet through the hub's `sk-create-goal` mode signal.46A request to set, bind or resend a session objective is not file work, so the hub leaves it to the goal hooks.4748An authoring or revision request loads [`references/parent-and-nested-goals.md`](references/parent-and-nested-goals.md) first, which holds the workflow for every goal kind.49The same request also loads [`references/authoring-standards.md`](references/authoring-standards.md), [`assets/goal-exemplars.md`](assets/goal-exemplars.md) and the template for the goal's kind.50A budget measurement or a chat-slice handoff loads [`references/budget-and-handoff.md`](references/budget-and-handoff.md).5152Read [`ROUTER.md`](./ROUTER.md) before selecting skill-local resources; open only the matched files.5354---5556## 3. HOW IT WORKS57581. Read the target packet's source specification and acceptance criteria. For a phase parent, read its phase map and inspect every direct phase-child directory on disk.592. Apply the four routing decisions in [`ROUTER.md`](./ROUTER.md). For top-level, phase-parent, nested-child, retrofit, phase-add and amendment work, load and follow [`references/parent-and-nested-goals.md`](references/parent-and-nested-goals.md). Identify which goal files to add or revise and whether a child change requires a parent amendment first.603. Start each goal from the template for its kind: [`goal-top-level-template.md`](assets/goal-top-level-template.md), [`goal-phase-parent-template.md`](assets/goal-phase-parent-template.md) or [`goal-phase-child-template.md`](assets/goal-phase-child-template.md).61 Each is a checked copy of system-spec-kit's [`goal.md.tmpl`](../../system-spec-kit/templates/addons/goal.md.tmpl) at that kind's level.62 Copy the block between its template markers into `goal.md`.63 When [`create.sh`](../../system-spec-kit/runtime/cli/spec/create.sh) `--with-goal` has already scaffolded a child's `goal.md`, keep that file and fill it with the child template's guidance.64 Child scaffolding alone does not create its parent goal.654. Before filling the template, load [`authoring-standards.md`](references/authoring-standards.md) and [`goal-exemplars.md`](assets/goal-exemplars.md).66 Fill it with packet-specific content and apply both resources.67 Use three to seven self-contained completion criteria that can be checked without opening another file.68 Leave no template placeholders.69 Copy the criteria verbatim into the objective text required by the goal contract.705. For a phase parent, make the binding table match the filesystem. Add one row for each direct phase-child directory, with that child's goal document as the target. Keep the table only in the phase-parent goal.716. Keep the durable slice at or below 4,000 characters wherever the cap applies. Load [`references/budget-and-handoff.md`](references/budget-and-handoff.md): section 2 says which goals carry the cap and how to read the packet report, and section 3 is the cut order for a goal that runs over. Never remove a criterion or make one uncheckable.727. Before handing off any authored or revised goal, run `node .skilled/skills/sk-doc/sk-create-goal/scripts/check-goal.cjs <packet>` from the repository root and resolve each finding.73 A finding left open for any reason, an operator brief included, stops the run: report it, print no chat slice and end with `STATUS=FAIL`.74 To see which criteria may break rules 4 and 5 below, run the advisory lint `node .skilled/skills/sk-doc/sk-create-goal/scripts/lint-goal-criteria.cjs <packet>`.75 It always exits 0 and never blocks the handoff.768. Only after the checker passes, and after authoring or amending a parent goal, load [`references/budget-and-handoff.md`](references/budget-and-handoff.md) for the projection distinction and runtime matrix, then print its chat slice with `node .skilled/hooks/goal/bin/goal.cjs packet <packet> --workspace <root>`. The `chat_slice` is for the operator to set or resend. It is not a session bind.7778---7980## 4. RULES8182### ✅ ALWAYS83841. Run the four pre-write decisions before changing a goal file.852. Derive each goal from the existing packet's source documents, not from a guessed or remembered summary.863. Start every goal from the asset template for its kind. Keep each template's fixed text identical to `goal.md.tmpl`. The parity test fails when they drift.874. Use three to seven self-contained criteria.885. Make each criterion checkable without opening another file.896. Remove every template placeholder.907. Preserve every criterion when cutting an over-budget parent.918. Compare each binding row with the direct phase-child directories on disk.929. Print the updated parent chat slice for the operator when parent goal content changes.9394### ⛔ NEVER95961. Never change an asset template's fixed text or structure on its own. Change `goal.md.tmpl` through system-spec-kit, then carry its new fixed text into all three templates.972. Never modify system-spec-kit's template tooling or shared validator from this packet.983. Never bind a packet to a session, set or resend a session objective, inject runtime state or track whether an operator has set the goal.994. Never put a binding table in a top-level goal or a phase-child goal.1005. Never omit a phase child from the parent's binding table or drop a completion criterion to meet the budget.101102### ⚠️ ESCALATE IF1031041. The source documents disagree about a decision or criterion. They also must describe the same phase structure. Report any conflict instead of choosing a truth silently.1052. A phase child is missing the source documents needed to author its goal.1063. The parent phase map and child directories do not agree.1074. A child change requires a parent decision or criterion amendment, but the request would leave the parent untouched.1085. A parent cannot meet the durable budget without losing a criterion or making one unclear. Do not cut the criterion count. Ask whether the packet scope should be split.1096. The request requires session-goal state or a change to a system-spec-kit-owned contract.110111---112113## 5. REFERENCES114115- [`references/parent-and-nested-goals.md`](references/parent-and-nested-goals.md) defines the top-level, phase-parent, child, retrofit, phase-add and amendment workflows.116- [`authoring-standards.md`](references/authoring-standards.md) gives the reader checks for goal content.117- [`references/budget-and-handoff.md`](references/budget-and-handoff.md) explains the durable budget, the one full cut order, what a parent goal sent in chat contains and the runtime handoff.118- [`goal-exemplars.md`](assets/goal-exemplars.md) records cited pass and failure examples.119- [`goal-top-level-template.md`](assets/goal-top-level-template.md), [`goal-phase-parent-template.md`](assets/goal-phase-parent-template.md) and [`goal-phase-child-template.md`](assets/goal-phase-child-template.md) are the blanks each goal kind is filled from.120- [`goal.md.tmpl`](../../system-spec-kit/templates/addons/goal.md.tmpl) is the system-spec-kit source the three templates copy.121- [`scripts/README.md`](scripts/README.md) describes the checker, the advisory criteria lint and their tests.122- [`goal-set-string-playbook.md`](../../system-spec-kit/references/workflows/goal-set-string-playbook.md) documents the objective set string a runtime binds and when a changed goal is resent. The budget, the cut order and what a goal sent in chat contains are in `budget-and-handoff.md`.123- [`goal hooks README`](../../../hooks/goal/README.md) documents the runtime session-state boundary.124- [`goal.cjs`](../../../hooks/goal/bin/goal.cjs) prints a packet's file-derived slices without binding a session.125126---127128## 6. SUCCESS CRITERIA129130- Every authored goal starts from the template for its kind, and all three templates match `goal.md.tmpl`.131- Every phase-parent binding row corresponds to a direct phase-child directory on disk. No child is omitted.132- Each goal has three to seven self-contained criteria. No template placeholders remain.133- Top-level and phase-parent durable slices meet the 4,000-character limit without losing a criterion.134- Print parent chat slices for the operator. Do not change session objectives or runtime state.135136---137138## 7. INTEGRATION POINTS139140- **system-spec-kit:** Owns `goal.md.tmpl`, the source the three asset templates copy, and `create.sh --with-goal`, which scaffolds child goals with the same structure.141- **Goal hooks and host command:** Own session binding and objective delivery. This includes injection and resend tracking. This packet only authors the source file and prints its chat slice for the operator.142- **Command surface:** The intended entry point is `/create:goal`. The command itself lives outside this packet.143- **sk-doc:** Routes goal-file authoring to this packet.144145---146147## 8. RELATED RESOURCES148149- [`README.md`](./README.md) is the short reader entry point.