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

Next Phase Number

How to Find Next ID

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

Phase Numbering Convention

• Phase IDs are 4-digit, zero-padded integers: 0001, 0002, 0003, ...
• Combined with a slug: 0001-initial-setup, 0002-add-auth, ...

Creating the Directory

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.