Claude Personas v2

# claude-personas v2 Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** Replace claude-personas v1's broken `autoMemoryDirectory` mechanism with native filesystem symlinks at Claude Code's per-project hash-derived memory paths, while preserving v1's role-based memory model.

**Architecture:** Per-project clones of claude-personas. Each role's `~/.claude/projects/<role-hash>/memory/` becomes a symlink into the clone's role folder. The clone's `shared/` is a symlink to the project's main-repo hash dir, which hosts shared content. Worktree-per-role is mandatory.

**Tech Stack:** Bash 4+, git, GitHub Actions, plain shell-based tests (no test framework dependency).

**Source spec:** `docs/superpowers/specs/2026-05-07-claude-personas-v2-design.md`

---

## File structure

**Files created:**
- `scripts/tests/test_helpers.sh` — shared assertion helpers (assertEqual, assertSymlink, etc.)
- `scripts/tests/test_init_worktree.sh` — smoke + integration tests for init script
- `scripts/tests/test_list_roles.sh` — tests for list-roles
- `scripts/tests/run_all.sh` — test runner that executes all `test_*.sh`
- `scripts/list-roles.sh` — audit script that lists wired worktrees
- `CHANGELOG.md` — v2.0.0 release notes with breaking changes + manual upgrade recipe

**Files modified:**
- `scripts/init-worktree.sh` — full rewrite per design Section "Implementation"
- `README.md` — major rewrite (per-project clone model, triple-symlink topology, worktree-per-role)
- `CONVENTIONS.md` — drop CLAUDE.local.md row from Three-system table; rewrite "Why role-specific memory directories?"
- `developer/MEMORY.md`, `pm/MEMORY.md`, `designer/MEMORY.md`, `shared/MEMORY.md` — replace v1 boilerplate references to autoMemoryDirectory/settings.local.json
- `.github/workflows/validate.yml` — drop checks for removed `.example` files; add init smoke test + list-roles smoke test

**Files deleted:**
- `settings.local.json.example`
- `CLAUDE.local.md.example`

---

## Task 1: Tag v1.0 and create v2-dev branch

**Files:**
- No file changes (git operations only)

- [ ] **Step 1: Confirm clean working tree on main**