feat: finalize beans-prime Claude Code plugin (Refs: beans-j7hd)

.beans/beans-j7hd--research-claude-code-pluginmarketplace.md

@@ -1,12 +1,28 @@
 ---
 # beans-j7hd
 title: Research Claude Code plugin/marketplace
-status: todo
+status: completed
 type: task
 priority: normal
 created_at: 2025-12-13T01:53:55Z
-updated_at: 2026-03-07T23:11:57Z
 order: k
+updated_at: 2026-02-12T00:15:12Z
+updated_at: 2026-02-12T00:15:29Z
 ---
 
 Wrap up our work in progress Claude Code plugin/marketplace to make installation a little easier.
+
+## Tasks
+
+- [x] Finalize plugin README
+- [x] Update main README Claude Code section
+- [x] Add extraKnownMarketplaces to .claude/settings.json
+- [x] Validate plugin structure
+- [x] Commit changes
+
+## Summary of Changes
+
+- Replaced WIP plugin README with actual usage documentation
+- Updated main README's Claude Code section: plugin install instructions up front, manual hook setup in a collapsible details block
+- Added `extraKnownMarketplaces` and `enabledPlugins` to `.claude/settings.json` so projects using beans auto-prompt plugin installation
+- Validated plugin structure with `claude plugin validate` (passes)

.claude/settings.json

@@ -1,4 +1,15 @@
 {
+  "extraKnownMarketplaces": {
+    "beans": {
+      "source": {
+        "source": "github",
+        "repo": "hmans/beans"
+      }
+    }
+  },
+  "enabledPlugins": {
+    "beans-prime@beans": true
+  },
   "hooks": {
     "SessionStart": [
       {

README.md

@@ -86,7 +86,16 @@ Some agents provide mechanisms to automate this step:
 
 ### Claude Code
 
-An official Beans plugin for Claude is in the works, but for the time being, please manually add the following hooks to your project's `.claude/settings.json` file:
+Install the Beans plugin from the marketplace:
+
+1. Add the marketplace: `/plugin marketplace add hmans/beans`
+2. Install the plugin: `/plugin install beans-prime@beans`
+
+This automatically runs `beans prime` at session start and before context compaction.
+
+<details><summary>Manual setup (without plugin)</summary>
+
+Add the following hooks to your project's `.claude/settings.json` file:
 
 ```json
 {
@@ -101,6 +110,8 @@ An official Beans plugin for Claude is in the works, but for the time being, ple
 }
 ```
 
+</details>
+
 ### OpenCode
 
 Beans integrates with OpenCode via a plugin that injects task context into your sessions. To set it up, **copy the plugin** from [`.opencode/plugin/beans-prime.ts`](.opencode/plugin/beans-prime.ts) to your project's `.opencode/plugin/` directory (or `~/.opencode/plugin/` for global availability across all projects).

extras/claude/plugins/beans-prime/README.md

@@ -1,3 +1,17 @@
 # beans-prime
 
-This is a **work in progress** plugin for Claude Code that aims at integrating Beans a little easier with the agent (so the user doesn't have to manually edit their settings file). It's currently not ready for prime time use -- for now, please refer to Beans' main README for instructions on how to set up Beans with Claude Code.
+A Claude Code plugin that integrates [Beans](https://github.com/hmans/beans) into your coding sessions. It runs `beans prime` automatically at session start and before context compaction, giving Claude full context about your project's tasks.
+
+## Installation
+
+```
+/plugin marketplace add hmans/beans
+/plugin install beans-prime@beans
+```
+
+## What it does
+
+This plugin registers hooks for the following Claude Code events:
+
+- **SessionStart**: Runs `beans prime` when a new session begins, providing Claude with your project's task context and instructions.
+- **PreCompact**: Runs `beans prime` before context compaction, ensuring task context is preserved when the conversation is compressed.