plannotator-setup-goal
Create reviewed Codex goal setup packages for long-running /goal work. Use when the user wants to turn an idea, backlog, project mission, or vague objective into durable goal files under a project goals slug folder, with Plannotator review gates for brief, narrative plan with acceptance criteria, verification, blockers, and the final /goal prompt.
Best for project kickoffWorks with GitHub
⌘source
- author
@backnotprop- language
- TypeScript
★5kstars
348forks
May 5, 2026
✦overview.md
Key Features
- ·Creates durable goal packages under goals/<slug>/
- ·Uses plannotator review gates for critical docs
- ·Automates scaffolding with a Python script
- ·Guides iterative refinement through user review
Use Cases
- →Turning a backlog item into a formal goal with acceptance criteria and verification
- →Starting a long-running project with clear mission and guardrails
- →Collaboratively refining a vague idea into a concrete objective with reviewer sign-off
Best for
- ✓project kickoff
- ✓goal setting
- ✓team leads
Not ideal for
- !quick one-time tasks
- !already well-defined goals
FAQs
name
plannotator-setup-goal
description
Create reviewed Codex goal setup packages for long-running /goal work. Use when the user wants to turn an idea, backlog, project mission, or vague objective into durable goal files under a project goals slug folder, with Plannotator review gates for brief, narrative plan with acceptance criteria, verification, blockers, and the final /goal prompt.
Plannotator Setup Goal
Overview
Create a durable goal package in the current project at goals/<slug>/ so Codex /goal has a clear mission, guardrails, proof of done, and external memory. Use Plannotator as the user review UI: every critical document must be gated with plannotator annotate <document.md> --gate and revised until approved.
Workflow
-
Confirm the working directory is the project root, or use the user-provided project directory.
-
Gather enough context to name the goal, define the intended outcome, identify constraints, find likely project docs, and determine proof of done.
-
Ask focused questions whenever the goal is vague, risky, too broad, missing a finish line, or missing verification. Do not proceed with guessed critical requirements.
-
Create a slug from the goal name and scaffold
goals/<slug>/with:python3 <skill_dir>/scripts/scaffold_goal.py --root . --slug <slug> --title "<goal title>" --objective "<one sentence outcome>" -
Draft and refine the critical documents in this order:
brief.mdplan.mdverification.mdblockers.mdgoal-prompt.md
$install
1-click copynpx skills add backnotprop/plannotator --skill plannotator-setup-goalSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
4/ 5
highMostly actionable with clear steps; only a few small gaps remain.