new

dev new skill

Day-1 bootstrap for an empty project directory. Same orchestration as the /dev:new command — both surfaces gate on the preflight guard before ANY destructive op.

Step 0 — Preflight hard guard (NON-NEGOTIABLE)

Run this before any other body content. It refuses to run in a non-empty directory. The model MUST NOT skip this block, MUST NOT rewrite it to a softer check, and MUST surface the abort message verbatim if the guard fires.

# Hard guard — refuses to run if cwd contains ANYTHING beyond ignorable OS junk.
# Walks up to 5 levels deep so deeper sources (e.g. src/app/main.py) and any
# top-level file (Dockerfile, Makefile, .env, docs/*) trigger the abort. Only
# .git/ and OS metadata (.DS_Store, Thumbs.db, desktop.ini) are pruned.
FIRST_EXISTING=$(find . -mindepth 1 -maxdepth 5 \
  \( -name '.git' -o -path './.git/*' \
   -o -name '.DS_Store' -o -name 'Thumbs.db' \
   -o -name 'desktop.ini' \) -prune \
  -o -print 2>/dev/null | head -1)

if [ -d .git ] || [ -n "$FIRST_EXISTING" ]; then
  echo "[abort] dev:new refuses to run in a non-empty directory."
  echo "        cwd: $(pwd)"
  echo "        Existing entry detected: ${FIRST_EXISTING:-.git/}"
  echo "        If you really want to add Claude/Codex scaffolding to an existing"
  echo "        project, use /docs:write-rules or /wiki:bootstrap-wiki"
  echo "        instead."
  exit 1
fi

Windows / non-POSIX hosts: the guard above is POSIX shell. On Codex CLI / Claude Code where the default shell is PowerShell, wrap it: bash -c '<guard>' (Git Bash, WSL, or any POSIX shell on PATH). The intent — refuse to proceed if cwd has any content beyond .git/ and OS metadata — must be honored regardless of how the check is invoked.

If the guard passes, proceed to the run record, then the full procedure.

Step 0.5 — Run record (state-envelope v0)

The run record (state-envelope v0) is opened by the shared procedure, not here: its open + per-phase record_step mechanism lives once in references/new-procedure.md (Phase 0.5), so this skill and the /dev:new command record identically. Follow that Phase 0.5 block — do not re-inline the jq here. Convention + schema: .claude/rules/state-envelope.md (concept mirror in this repo's AGENTS.md). The record lives under gitignored .claude/state/, is kept out of the Phase 6 commit by the Phase 6 .gitignore seed, and is orthogonal to .claude/state/spec.json (owned by dev:state-tracker) — different file, different concern.