# Are Plan

> Compare AI planning quality with and without ARE documentation (experimental) Use when this capability is needed.

- Skill: `tomevault-io/are-plan` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/are-plan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/are-plan/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/are-plan

---


Compare AI planning quality with and without ARE documentation.

<execution>
Run the plan command to create an A/B comparison of AI planning quality.

## Steps

1. **Read version**: Read `.claude/ARE-VERSION` → store as `$VERSION`. Show the user: `agents-reverse-engineer v$VERSION`

2. **Run the plan command**:
   ```bash
   npx agents-reverse-engineer@$VERSION plan --backend claude $ARGUMENTS
   ```

3. **Wait for completion** — the command runs two sequential AI planning sessions (without docs, then with docs) and outputs a comparison table.

4. **On completion**, summarize the comparison results:
   - Quantitative metrics (file references, actionable steps, code identifiers)
   - Cost and latency comparison
   - Quality evaluation scores (if `--eval` was used)

This creates two git branches from HEAD and runs an AI planner in each:
- **With ARE docs**: Full documentation available
- **Without ARE docs**: Source code only (ARE artifacts stripped)

The comparison measures how much ARE documentation improves AI planning quality.

**Options:**
- `--eval`: Run AI quality evaluator on both plans (5-point rubric)
- `--eval-model <name>`: Model for the evaluator (default: same as --model)
- `--model <name>`: AI model to use for planning
- `--dry-run`: Show what would happen without executing
- `--list`: List all saved plan comparisons
- `--show <id>`: View a previous comparison by date
- `--force`: Overwrite existing branches for the same task
- `--debug`: Show verbose AI execution details
</execution>

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/geoloeg-ist) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->