docs: document Claude Code plugin install and three release artifacts

Author: damienen

CLAUDE.md

@@ -7,6 +7,8 @@ This file is the repository-level guide for humans and AI agents working in this
 ## What's In Here
 
 ```
+.claude-plugin/         plugin manifest for `/plugin install normalpowers@fastxyz`
+hooks/                  session-start hook — injects normalpowers.md at Claude Code session start
 skills/                 plain-markdown skill files — the product
 normalpowers.md         the master prompt (paste-as-system-prompt)
 README.md               what it is + per-platform install
@@ -49,7 +51,7 @@ Before modifying anything in `skills/`:
 
 These get closed without review:
 
-- **Platform-specific integrations** (plugin manifests, hooks, custom tool wiring). Push those to a fork — not core.
+- **New platform integrations** beyond the existing Claude Code plugin manifest. We ship one — `/plugin install normalpowers@fastxyz` via `.claude-plugin/` + `hooks/`. Adding Cursor, Codex, or others requires a design doc and maintainer approval.
 - **Domain-specific skills** (sales-discovery, specific-industry-workflows). Use `writing-skills` to author them in your own bundle.
 - **"Compliance" rewrites** restructuring skills to match some external style guide without eval evidence that behavior improved.
 - **Rebrands, rewording sweeps, or tone-unification PRs** without a specific behavioral problem they solve.

README.md

@@ -51,6 +51,20 @@ Copy `normalpowers.md` from this repo. Paste it into whichever platform you use.
 
 Install guide priority: Claude first (it's our internal stack), then ChatGPT and Gemini.
 
+### Claude Code — one-click install
+
+```bash
+/plugin install normalpowers@fastxyz
+```
+
+Or download `normalpowers-vX.Y.Z.plugin` from [Releases](https://github.com/fastxyz/normalpowers/releases/latest) for a local offline install:
+
+```bash
+/plugin install ./normalpowers-vX.Y.Z.plugin
+```
+
+For skill-compatible platforms, download `normalpowers-vX.Y.Z.skill` from Releases.
+
 ### Claude.ai — Projects (recommended)
 
 1. Open [claude.ai](https://claude.ai) → **Projects** → **New project**.

docs/comparison-to-superpowers.md

@@ -41,6 +41,8 @@ normalpowers has none of that. It is plain markdown by design:
 
 This is a deliberate scope constraint. Portability across every LLM front-end beats deeper integration with one of them.
 
+normalpowers does ship a `.claude-plugin/` manifest and a `hooks/session-start` script so that Claude Code users can do `/plugin install normalpowers@fastxyz` for a one-click install. The hook injects `normalpowers.md` at session start — no Skill tool, no subagents. The skills remain plain markdown and work identically on every other platform.
+
 ## Recommendation
 
 **If you are writing software, use [superpowers](https://github.com/obra/superpowers).** It is tuned for that work and sharper on that axis than anything we could offer. The TDD and subagent skills in particular have no substitute here.