{
  "markdown": "# claude-rfc-plugin\n\nA Claude Code plugin for drafting Request for Comments (RFC) documents through interactive, multi-option exploration.\n\nGood decisions need good options. This plugin locks Claude into \"thinking partner\" mode — no code, no premature decisions — until you've explored the problem space together. It surfaces multiple solution approaches, captures trade-offs honestly, and names open questions explicitly. The output is a draft RFC ready for team review, not a final spec.\n\n## Installation\n\nAdd to `~/.claude/settings.json`:\n\n```json\n{\n  \"pluginDirs\": [\"/path/to/claude-rfc-plugin\"]\n}\n```\n\nOr use the CLI flag:\n\n```bash\nclaude --plugin-dir /path/to/claude-rfc-plugin\n```\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `/rfc:start [topic]` | Start a new RFC session |\n| `/rfc:section <name>` | Jump to a specific section |\n| `/rfc:status` | Show drafting progress |\n| `/rfc:review` | Analyze RFC for gaps, missing options, tone issues |\n| `/rfc:refine` | Iterate on current section |\n| `/rfc:done` | Generate draft and exit RFC mode |\n| `/rfc:help` | Show help |\n\n### Starting a session\n\n```\n/rfc:start session retention strategy\n```\n\nImport from a brainstorm session:\n\n```\n/rfc:start api versioning --from brainstorm-api-20260503.md\n```\n\n## RFC Sections (8 total)\n\n| # | Section | Purpose |\n|---|---|---|\n| 1 | Context & Problem | What's going on and why it matters |\n| 2 | Goals | What success looks like (outcome-focused) |\n| 3 | Non-Goals | What's explicitly out of scope |\n| 4 | Proposed Solutions | **≥2 options required** — alternatives are the point |\n| 5 | Trade-offs | What each option gains and gives up |\n| 6 | Open Questions | What we don't know yet (surface, don't suppress) |\n| 7 | Prior Art | What others have tried; what's in the codebase |\n| 8 | Recommendation | Optional, non-binding leaning with rationale |\n\n## How it works\n\n1. `/rfc:start` creates a `.rfc-state` file and a `rfc-[topic]-[timestamp].md` session file\n2. The `rfc-enforcer.sh` hook injects rules on every prompt while RFC mode is active\n3. Claude explores each section collaboratively — sections can stay open, no forced completion\n4. You navigate, review, and refine at your own pace\n5. `/rfc:done` generates a clean `rfc-[topic]-DRAFT.md` with warnings for missing options or open questions, then removes the state file\n\n## Hook enforcement\n\nWhile RFC mode is active, Claude:\n- Cannot write code files (only `rfc-*.md` files are auto-approved)\n- Cannot run arbitrary bash commands (only session scripts are approved)\n- Cannot present a single solution as the only option\n- Cannot exit RFC mode except via `/rfc:done`\n\n## Files generated\n\n- `.rfc-state` - Session state (deleted on `/rfc:done`)\n- `rfc-[topic]-[timestamp].md` - Working document with full session history (preserved)\n- `rfc-[topic]-DRAFT.md` - Clean draft ready to share (generated on `/rfc:done`)\n\n## Project structure\n\n```\nclaude-rfc-plugin/\n├── .claude-plugin/\n│   └── plugin.json\n├── commands/\n│   ├── start.md\n│   ├── section.md\n│   ├── status.md\n│   ├── review.md\n│   ├── refine.md\n│   ├── done.md\n│   └── help.md\n├── hooks/\n│   ├── hooks.json\n│   └── rfc-enforcer.sh\n└── scripts/\n    ├── start-rfc-session.sh\n    ├── end-rfc-session.sh\n    ├── generate-rfc-draft.sh\n    ├── approve-rfc-write.sh\n    ├── approve-rfc-bash.sh\n    └── approve-rfc-websearch.sh\n```\n\n## License\n\nMIT\n",
  "bytes": 3374,
  "sha": "b1d1ea964a96df927584bccf561ebc99a5bf24f21f466da8164d76d7001ed75e",
  "repo_slug": "benedixx/claude-rfc",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_benedixx_claude_rfc_rfc_generator_1a7c4f98/readme"
}