coconut-rules

Coconut Claude Code Plugins

A collection of Claude Code plugins for intelligent git workflows, rules management, and workflow automation.

Table of Contents

• Overview
• Plugins
• Installation
• Quick Start
• Plugin Details
• Architecture
• Flow Diagrams
• Development
• Contributing
• License

Overview

Coconut is a curated collection of Claude Code plugins designed to enhance developer productivity through:

• Intelligent Git Commits: Semantic grouping with conventional commits and user stories
• Rules Management: Context-based loading for efficient token usage
• Workflow Automation: Conversational workflow creation for teams

Collection Stats

Metric	Value
Plugins	3
Total Commands	6
Total Agents	7
Total Skills	4

Plugins

Plugin	Version	Description
coconut-commit-work	0.2.0	Intelligent git commits with semantic grouping and parallel execution
coconut-rules	3.0.0	Context-based rules management with retrospective analysis
coconut-workflow	0.1.0	Interactive workflow creation through conversational requirements

Installation

Option 1: Clone and Symlink (Recommended for Development)

# Clone the repository
git clone https://github.com/FrancisVarga/coconut-claude-code-plugins.git

# Symlink to Claude Code plugins directory
ln -s $(pwd)/coconut-claude-code-plugins ~/.claude/plugins/coconut

Option 2: Copy Individual Plugins

# Copy specific plugin to global plugins
cp -r coconut-commit-work ~/.claude/plugins/

# Or copy to project-specific plugins
cp -r coconut-rules /path/to/project/.claude-plugin/

Option 3: Use as Marketplace Collection

The marketplace.json file defines this as a plugin collection:

{
  "name": "coconut-claude-code-plugins",
  "plugins": [
    { "name": "coconut-commit-work", "source": "./coconut-commit-work" },
    { "name": "coconut-workflow", "source": "./coconut-workflow" },
    { "name": "coconut-rules", "source": "./coconut-rules" }
  ]
}

Quick Start

Commit Your Changes Intelligently

# Analyze, group, commit, and push all changes
/coconut-commit-work:commit-work

# Preview without executing
/coconut-commit-work:commit-work --dry-run

Add a New Rule

# Add rule with automatic placement
/coconut-rules:add-rule Always validate API inputs with Pydantic

# Run retrospective to extract session learnings
/coconut-rules:retrospective

Create a Workflow

# Start interactive workflow creation
/coconut-workflow:create

# Start with description
/coconut-workflow:create "deploy to staging with approval"

Plugin Details

coconut-commit-work

Intelligent git commits with semantic grouping, conventional commit messages, emoji prefixes, user stories, and parallel sub-agent execution.

Commands

Command	Description
/coconut-commit-work:commit-work	Analyze and commit changes with semantic grouping
/coconut-commit-work:commit-work --dry-run	Preview commits without executing
/coconut-commit-work:commit-work --no-push	Commit without pushing to remote

Agents

Agent	Purpose	Model
commit-analyzer	Semantic analysis and grouping	Inherited
commit-executor	Execute single atomic commit	Haiku (fast)

Features

• Semantic Grouping: Groups changes by feature, layer, or concern
• Conventional Commits: Emoji prefixes with proper format
• User Stories: Scrum-like user story in each commit
• Parallel Analysis: Fast multi-agent analysis
• Sequential Execution: Safe atomic commits

Commit Format

✨ feat(auth): add password reset functionality

## Why (User Story)
As a user who forgot my password, I want to reset it via email so that I can regain access.

## What Changed
- Added resetPassword function in src/auth/reset.ts
- Created email template in templates/reset-email.html

## Acceptance Criteria
- [ ] User receives reset email within 1 minute
- [ ] Reset link expires after 24 hours

Full Documentation

---

coconut-rules

Manage Claude Code rules with context-based loading, retrospective analysis, and knowledge graph integration.

Commands

Command	Description
/coconut-rules:add-rule [desc]	Add rule with automatic placement
/coconut-rules:list-rules	Show current structure and status
/coconut-rules:organize	Restructure rules for context-based loading
/coconut-rules:retrospective	Analyze session for learnings

Agents