vpc-drift

Analyze this project (read name from CLAUDE.md or package.json) for VPC persona drift — gaps between what persona definitions promise and what the product actually delivers. Produces a per-persona alignment score, drifted attributes, and concrete VPC update recommendations.

Input: $ARGUMENTS — optional flags:

• --persona <names> — comma-separated persona names to analyze. Default: all personas.
• --verbose — show full attribute lists in output (default: summarized).
• --format json — emit the drift report as JSON instead of Markdown.

---

Phase 0: Argument Parsing

Parse $ARGUMENTS to set runtime variables.

Variables to set:

• PERSONA_FILTER — array of lowercased persona names, or "all". Default: "all".
• VERBOSE — boolean. Default: false.
• FORMAT — "markdown" or "json". Default: "markdown".

Parsing rules:

1. Scan $ARGUMENTS for --persona <names>. If found, split <names> on commas, lowercase each, set PERSONA_FILTER=<array>. Strip from arguments.
2. Scan for --verbose. If found, set VERBOSE=true. Strip from arguments.
3. Scan for --format <value>. If found and value is json, set FORMAT="json". Any other value: print Error: unknown format "<value>". Valid: markdown, json and stop.

Print active configuration:

Analyzing personas: <all | comma-separated list>
Format: <markdown|json>
Verbose: <yes|no>

---

Phase 1: Load VPC Personas

Read the persona files to extract the VPC attribute definitions.

Step 1a: Discover persona files

Glob for persona files using these paths in order (use the first that yields results):

1. .claude/agents/ — look for .md files whose content includes a ## Value Proposition Canvas section.
2. {{PERSONA_DIR}}/ — project-level persona directory (set by installer).

If no persona files are found in either location:

Error: No VPC persona files found.
Expected locations (check both): `.specrails/personas/*.md` and `.claude/agents/personas/*.md`
Each persona file must contain a ## Value Proposition Canvas section.
Run /specrails:setup to generate persona files from templates.