CLAUDE.md@plugins/itp git:20260504.5baaa1eA

Immutable. This exact content never changes and is served at /api/v1/blob/610c6733cad61d22.

# itp Plugin

> Implement-The-Plan workflow: ADR-driven 4-phase development with preflight, implementation, formatting, and release automation.

**Hub**: [Root CLAUDE.md](../../CLAUDE.md) | **Sibling**: [itp-hooks CLAUDE.md](../itp-hooks/CLAUDE.md)

## Overview

Execute approved plans from Claude Code's Plan Mode through an ADR-driven 4-phase workflow: preflight → implementation → formatting → release. The neutral acronym "ITP" avoids action inference that caused Claude to skip preflight.

## 4-Phase Workflow

```
Preflight (ADR + Spec) → Phase 1 (Implement) → Phase 2 (Format) → Phase 3 (Release)
```

1. **Preflight**: Creates ADR (MADR 4.0), design spec, and graph-easy diagrams
2. **Phase 1**: Implement from design spec with TodoWrite tracking
3. **Phase 2**: Format with Prettier, push to GitHub
4. **Phase 3**: Release via the repo's mise release pipeline (main/master only)

## Plan Mode Bridge

Two paths from Plan Mode to `/itp:go`:

| Path                              | Steps          | Interface                               |
| --------------------------------- | -------------- | --------------------------------------- |
| **A**: Type in rejection feedback | Fewer (direct) | Plain text field                        |
| **B**: Defer to command prompt    | Extra step     | Native slash commands with autocomplete |

## Skills

- [adr-code-traceability](./skills/adr-code-traceability/SKILL.md)
- [adr-graph-easy-architect](./skills/adr-graph-easy-architect/SKILL.md)
- [bootstrap-monorepo](./skills/bootstrap-monorepo/SKILL.md)
- [code-hardcode-audit](./skills/code-hardcode-audit/SKILL.md)
- [go](./skills/go/SKILL.md)
- [graph-easy](./skills/graph-easy/SKILL.md)
- [tether](./skills/tether/SKILL.md) — renamed from `hooks` to avoid `/hooks` clash
- [impl-standards](./skills/impl-standards/SKILL.md)
- [implement-plan-preflight](./skills/implement-plan-preflight/SKILL.md)
- [mise-configuration](./skills/mise-configuration/SKILL.md)
- [mise-tasks](./skills/mise-tasks/SKILL.md)
- [pypi-doppler](./skills/pypi-doppler/SKILL.md)
- [setup](./skills/setup/SKILL.md)

## Commands

| Command       | Purpose                                        |
| ------------- | ---------------------------------------------- |
| `/itp:go`     | Execute 4-phase workflow                       |
| `/itp:setup`  | Install dependencies and configure environment |
| `/itp:tether` | Install/uninstall enforcement hooks            |

For release, use the repo's mise pipeline directly: `/mise:run-full-release`.

## Dependencies

| Tool       | Install               | Notes                              |
| ---------- | --------------------- | ---------------------------------- |
| uv         | `mise install uv`     | Or `brew install uv`               |
| gh         | `brew install gh`     | **NEVER use mise** (iTerm2 issues) |
| prettier   | `bun add -g prettier` | Bun-first policy                   |
| graph-easy | `cpanm Graph::Easy`   | Requires `brew install cpanminus`  |