# Goal Manager

> Manage /goal usage for concrete Codex work, including objective writing, success criteria, done criteria, long-running implementation, verification, PR creation, resumption, and completion decisions.

- Skill: `s-hiraoku/goal-manager-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add s-hiraoku/goal-manager-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/s-hiraoku/goal-manager-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: s-hiraoku (https://skillmd.com/u/s-hiraoku)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/s-hiraoku/goal-manager-2

---

# Goal Manager

Use this workflow when a task should be tracked with `/goal` or goal-tool state.

## Workflow

1. Decide whether goal tracking is useful.
   - Create or use a goal when the user explicitly mentions `/goal`, asks for a goal or objective, or requests multi-step implementation, verification, release, or PR work.
   - Do not create a goal for quick questions, simple command output, casual brainstorming, or work that will clearly finish in one short response.
2. Shape the objective before creating the goal.
   - Make it outcome-focused, verifiable, and scoped to the current task.
   - Include expected verification and final reporting when they are part of the work.
   - Pass a token budget only when the user explicitly provides one.
3. Use the active goal during the task.
   - Check it after resuming, before broad edits, when the user changes direction, and before the final response.
   - If the newest user request conflicts with the active goal, follow the newest request and state the shift briefly.
4. Complete the goal only when the real outcome is done.
   - Required implementation or investigation is complete.
   - Relevant checks have run, or blocked checks are clearly reported.
   - The final response can summarize changed files, verification, and remaining risks.

For objective examples, read `references/examples.md` only when wording is unclear.

## Final Report

Include:

- the final goal status
- what changed or was learned
- checks or verification run
- known risks, blockers, or follow-up work