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

1. Confirm the working directory is the project root, or use the user-provided project directory.

2. Gather enough context to name the goal, define the intended outcome, identify constraints, find likely project docs, and determine proof of done.

3. 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.

4. 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>"