# Specify

> Create a research thesis — theses/{nnn}-{slug}/ via mkdir-as-CAS, pillar-prioritized spec.md, initialized thesis.md, and the thesis-quality checklist. Refuses creation while the workspace constitution is unratified (spec 046 Q83 A+).

- Skill: `agentii-ai/specify` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add agentii-ai/specify`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentii-ai/specify/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: agentii-ai (https://skillmd.com/u/agentii-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/agentii-ai/specify

---


# 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

```bash
python3 scripts/agentii_cmd.py specify --workspace /path/to/workspace --slug ai-semiconductors
```

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