Menu
Determine the next sequential phase ID for creating a new phase. Use when planning a new phase.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | find-next-phase-number |
| description | Determine the next sequential phase ID for creating a new phase. Use when planning a new phase. |
| user-invocable | true |
Run this command to determine the next available phase number:
current=$(ls -1 .ushabti/phases/ 2>/dev/null | sed 's/-.*//' | sort -n | tail -1)
if [ -z "$current" ]; then
echo "0001 (first phase)"
else
printf "%04d (after %s)\n" $((10#$current + 1)) "$current"
fi
0001, 0002, 0003, ...0001-initial-setup, 0002-add-auth, ...Once you have the next number and a slug:
mkdir -p .ushabti/phases/NNNN-your-slug
Replace NNNN with the next ID and your-slug with a short, lowercase, hyphenated description.
Bootstrap phase context for Builder. Provides current phase, next step, and full phase file contents.
Bootstrap phase context for Overseer. Provides phase under review with full file contents and card metadata.
Approve a phase — sets status to complete, marks all steps reviewed, updates linked card. Use when declaring a phase green.
Create a phase directory with all required files in one call. Use instead of separate mkdir + Write calls when creating a new phase.
Kick a phase back to building — sets status and adds new step entries to progress.yaml. Use when requesting fixes from Builder.
Mark a step as implemented in progress.yaml with notes and touched files. Use after completing each step instead of manual Edit calls.