Document the v2.2.0 skills-based distribution

Align release notes, version metadata, installation guidance, and maintainer documentation with the canonical skills workflow.

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>

.agents-docs/AGENTS-architecture.md

@@ -34,9 +34,9 @@ plan2code/
 │   └── statusline-config.json  # Default config template
 ├── scripts/                    # Development scripts
 │   └── validate-char-count.js  # Pre-commit character count validator
-├── dist/                       # Generated distribution files (auto-generated)
-│   ├── global-commands/        # For global installation (~/.claude/, etc.)
-│   └── local-commands/         # For per-project installation (.claude/, etc.)
+├── skills/                     # Committed build artifact — one Agent Skill per src/ prompt
+│   └── plan2code-<name>/       # SKILL.md plus references/ where present
+│                               # Generated by npm run build:skills; consumed by skills add
 ├── .husky/                     # Git hooks (husky)
 │   └── pre-commit              # Runs character count validation
 ├── .claude/                    # Repo-local Claude Code config (NOT installed by install.js)
@@ -53,8 +53,9 @@ plan2code/
 
 | File | Purpose |
 |------|---------|
-| `install.js` | Main installer - generates and installs workflow files to AI tool directories |
+| `install.js` | Interactive installer — builds `skills/` from `src/`, then delegates installation to the skills CLI |
 | `src/plan2code-*.md` | Source workflow prompts (the "source of truth") |
+| `skills/` | Generated Agent Skills committed for installation and drift verification |
 | `scripts/validate-char-count.js` | Pre-commit validator ensuring all source prompts ≤ 11,000 chars |
 | `version.json` | Version metadata (name, version, description) |
 | `QUICK-REFERENCE.md` | User quick-reference card |
@@ -93,21 +94,19 @@ Some workflows use companion reference files for depth that exceeds the 11k char
 
 **Pattern:** `src/<source-filename-without-extension>-references/` (e.g., `plan2code-review-references/`)
 
-**How the installer handles them:**
-- **Skill-directory platforms** (Claude Code, Agents, Crush, Devin): reference files are nested as `<skill-name>/references/`. Read paths use canonical `references/<file>.md`.
-- **Flat-file platforms** (Windsurf, Cursor, Copilot, Continue): reference files are placed as a sibling directory. The installer rewrites Read paths to the sibling directory name (e.g., `plan2code-review-references/<file>.md`).
+**How the installer handles them:** the directory is copied verbatim to `skills/<skill-name>/references/`, so `Read references/<file>.md` resolves consistently for every agent. There is one output format, with no flat-file sibling directory or path rewrite.
 
-Reference files are NOT subject to the 11,000 character limit. The review workflow pioneered this pattern (`verification-protocol`, `dimensions`, `false-positives`, `session-end`); the init-update workflow also uses it (`ai-agent-file-sync` for its Step 7), `plan2code-4-finalize.md` uses it for STEP 6.5 (`community-feedback-submission`), and `plan2code-0-pathfinder.md` leans on it hardest (`chart`, `grilling`, `questions`, `resolve`, `handoff`, `trail` — the orchestrator is a dispatcher, the depth lives in the references). Other workflows can adopt it when a source file's detail exceeds the 11k limit.
-
-**`Read` directives must sit at column 0.** `install.js` matches `/^(Read\s+)references\//gm` for the flat-file path rewrite — anchored, with no leading-whitespace tolerance. An indented or bulleted `Read` line is silently skipped, so flat-file platforms ship a `references/` path that does not exist there (they receive the reference dir as a *sibling*, named `plan2code-<name>-references/`).
+Reference files are NOT subject to the 11,000 character limit. The review workflow pioneered this pattern (`verification-protocol`, `dimensions`, `false-positives`, `session-end`); the init-update workflow also uses it (`ai-agent-file-sync` for its Step 7), `plan2code-4-finalize.md` uses it for STEP 6.5 (`community-feedback-submission`), and `plan2code-0-pathfinder.md` leans on it hardest (`chart`, `grilling`, `questions`, `resolve`, `handoff`, `trail`, `github-issues` — the orchestrator is a dispatcher, the depth lives in the references). Other workflows can adopt it when a source file's detail exceeds the 11k limit.
 
 ## Repo-Local Skills (`.claude/skills/`)
 
-Maintainer-only Claude Code skills committed to the repo but **deliberately excluded** from `install.js` — they are dev tooling, not shipped product, so they never install to `~/.claude/skills/` and carry no version bump of their own (a product-version bump would wrongly imply a user-facing release); changelog mentions fold into the current version's entry.
+Maintainer-only skills committed to the repo but deliberately excluded from the generated `skills/` product artifact:
 
-- `plan2code-publish/` — cuts a GitHub Release from the top `CHANGELOG.md` entry once `CHANGELOG.md` / `version.json` / `package.json` agree and the version is ahead of the latest published release. Delegates tag creation to `gh release create --target main`.
+- `plan2code-publish/` — publishes a GitHub Release after version files agree.
+- `plan2code-changelog/` — validates release classification and keeps version files synchronized.
+- `sync-repo/` — decrypts the protected upstream-sync workflow in memory.
 
-**Warning:** anything named `plan2code-*` placed under `~/.claude/skills/` is deleted by the installer's uninstall (`uninstallFiles()` in `install.js`) and by every re-install's pre-copy cleanup in `install()` (both match `/^plan2code-/` for the Claude Code skills target). Keep these skills repo-local only.
+Do not run `skills add` against the repository root: recursive discovery also finds these maintainer skills. `install.js` targets `skills/` and passes explicit workflow names instead. Global install/uninstall cleanup removes `plan2code-*` workflow skills from user skill directories; it never operates on this repository's `.claude/skills/` directory, and `sync-repo` intentionally has no `plan2code-` prefix.
 
 ## Status Line