docs: plan for Claude Code adapter (4 tiers + install-mcp CLI)

[plind-junior]

tiered adoption story under adapters/claude-code/: .mcp.json (T1), fenced CLAUDE.md snippet (T2), four slash commands (T3), settings.json with SessionStart hook + read-only auto-allow (T4). new vouch install-mcp claude-code [--tier T1..T4] writes them idempotently into a project.

What changed

Why

What might break

VEP

Tests

• make check passes locally (lint + mypy + pytest)
• New / changed behaviour has a test
• CHANGELOG.md updated under ## [Unreleased]

Summary by CodeRabbit

• Documentation
  • Added implementation plan documentation for a Claude Code adapter, outlining a multi-tier configuration system and integration workflow specifications.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 81cba820-cc4d-4a43-9a29-8ffe19eeb475

📥 Commits

Reviewing files that changed from the base of the PR and between 3beb821 and e80350e.

📒 Files selected for processing (1)

• docs/superpowers/plans/2026-05-27-claude-code-adapter.md

---

📝 Walkthrough

Walkthrough

This PR adds a comprehensive implementation plan document for the Claude Code adapter, specifying four tiered template adoption levels, a test-first installer module, CLI integration, and verification checkpoints. The plan progresses from architecture and template definitions through implementation, testing, and deployment guidance.

Changes

Claude Code Adapter Implementation Plan

Layer / File(s)	Summary
Goal and high-level architecture docs/superpowers/plans/2026-05-27-claude-code-adapter.md (1–41)	Introduction to the adapter adoption plan, defining the goal of tiered templates with idempotent installer, intended architecture, and tech stack overview.
Adapter tier templates (T1–T4) docs/superpowers/plans/2026-05-27-claude-code-adapter.md (43–383)	Task-by-task specification of all four tiers: T1 .mcp.json template with validation, T2 fenced CLAUDE.md.snippet with <!-- BEGIN vouch --> boundaries, T3 four slash-command templates with specific behaviors, and T4 .claude/settings.json with read-only auto-allow and SessionStart hook.
Installation guide and adoption docs/superpowers/plans/2026-05-27-claude-code-adapter.md (386–466)	Tiered adoption guide describing each tier, one-shot install commands via vouch install-mcp claude-code --tier, manual install steps, and verification notes.
Installer module implementation and test specification docs/superpowers/plans/2026-05-27-claude-code-adapter.md (469–693)	Test-first specification for the installer covering adapter listing, T1/T4 installation, idempotency, fenced CLAUDE.md append behavior, and error cases; full proposed implementation of src/vouch/install_adapter.py with tier mapping, validation, idempotent copy logic, and InstallResult data class.
CLI integration docs/superpowers/plans/2026-05-27-claude-code-adapter.md (703–779)	Instructions for wiring the installer into src/vouch/cli.py via install-mcp group and claude-code subcommand with --path and --tier flags, output formatting, and smoke tests.
Changelog entry and final verification docs/superpowers/plans/2026-05-27-claude-code-adapter.md (782–832)	CHANGELOG [Unreleased] Added entry, final push steps, and self-review checklist covering spec coverage, placeholder cleanup, type consistency, and idempotency validation.

🎯 2 (Simple) | ⏱️ ~10 minutes

🐰 A plan so neat, with tiers stacked high,
Adapters and installers reaching the sky,
T1 through T4, a blueprint so clear,
May your code follow swift without fear,
And idempotent writes bring joy through the year! ✨

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/claude-code-adapter

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}