---
name: "lex-extract"
description: "Extract candidate terminology for CocoLex."
version: "2.0.1"
author: "CocoPlus"
tags:
  - cocoplus
  - cocolex
---

Your objective is to implement `$lex extract [--path <path>] [--write]`.

Scan targeted docs, lifecycle artifacts, reviews, and wisdom for repeated domain terms. Report candidate terms with examples and confidence. Write candidates only to `.cocoplus/lexicon/candidates.md` when `--write` is supplied.

## Anti-Rationalization

| Shortcut / Temptation | Why It Fails |
|-----------------------|--------------|
| Treat the skill as complete because the file exists | Skill contracts must describe observable behavior and verification, not just command names. |
| Skip artifact and safety checks for a small command | Small commands still mutate state or guide execution; preserve the same gates. |

## Exit Criteria

- [ ] Command behavior matches the owning feature contract.
- [ ] Required reads, writes, and user-visible outputs are described.
- [ ] Safety, governance, and artifact constraints are preserved.
- [ ] Missing state produces a clear, non-destructive result.