agentii.specify

Creates a research thesis directory and its specification.

Hard rules

• Refuse creation while constitution_pin: unratified (Q83 A+): no research may be produced under placeholder governance. Aggregate checks and staged orders hard-fail on unratified — a thesis created early could never be re-reviewed properly (no old constitution to diff against).
• ID allocation is mkdir-as-CAS (Q27): os.mkdir(); FileExistsError → increment and retry. Never exist_ok=True.
• Pillars are priority-ordered and independently falsifiable (Q30): P1 = the Minimum Defensible View; every wrong_if is {metric, threshold, source} — prose is rejected (Q8 contract 4).

What it produces

theses/{nnn}-{slug}/
├── spec.md                       # pillar-prioritized (spec-template.md)
├── thesis.md                     # initialized living file (thesis-template.md)
└── checklists/thesis-quality.md  # machine-maintained, bidirectional (Q32)

Invocation

# Resolve the kit root first — contracts/kit-root.md. The kit's scripts do NOT ship
# with the skills, so never assume the CWD is the checkout.
KIT=""
for c in "${AGENTII_KIT_ROOT:-}" \
         "$(cat "$HOME/.claude/skills/agentii/.kit-root" 2>/dev/null)" \
         "${CLAUDE_PLUGIN_ROOT:-}"; do
  [ -n "$c" ] && [ -f "$c/scripts/agentii_cmd.py" ] && { KIT="$c"; break; }
done
if [ -z "$KIT" ]; then d="$PWD"; while [ "$d" != "/" ]; do
  [ -f "$d/scripts/agentii_cmd.py" ] && { KIT="$d"; break; }; d="$(dirname "$d")"; done; fi
[ -n "$KIT" ] || { echo "agentii kit not found — see contracts/kit-root.md" >&2; exit 1; }

python3 "$KIT/scripts/agentii_cmd.py" specify --workspace /path/to/workspace --slug ai-semiconductors

Gate 1 (after specify, informational) shows pillar/wrong_if decidability.