EC-CUBE Dev Agents

EC-CUBE/Symfony development toolkit with specialized AI agents, Gemini integration, GitHub automation, and Slack notifications. Optimized for EC-CUBE/Symfony but applicable to any development project.

Features

🤖 Specialized AI Agents

• implementation-analyzer - Analyzes implementation status by examining specs, PRs, commits, and staged changes
• bug-investigator - Investigates bugs with detailed error log analysis and systematic debugging
• log-analyzer - Analyzes GitHub Actions CI/CD logs to identify root causes of test failures
• refactoring-expert - Improves code quality, identifies DRY violations, and applies best practices

⚡ Custom Commands

Development Workflow

• create-plan - Create implementation plans as checklists with auto-generated filenames
• update-plan - Update implementation plans with progress tracking
• load-plan - Load and summarize implementation plans with progress status
• save-context - Save conversation context with auto-generated descriptive filename and timestamp (e.g., auth-feature-202510301730.md)
• load-context - Load saved context to resume work after /clear (auto-detects latest context file)

GitHub Integration

• github-check - View PR/Issue details with automatic number extraction
• github-logs-analyze - Analyze failed GitHub Actions jobs
• generate-commit - Generate commit messages from git diff
• update-pr-description - Auto-update PR descriptions based on changes
• create-pr - Create PRs with template support, remote sync check, and argument parsing

AI Search

• gemini-search - Web search using Google Gemini CLI
• gemini - Direct Gemini CLI interaction with custom prompts

🔔 Slack Notifications

Automatic notifications to Slack:

• Task completion notifications (Stop hook)
• Task confirmation notifications (Notification hook)
• AI-summarized conversation content in Japanese with mrkdwn formatting

Prerequisites

• Gemini CLI - The gemini command must be available in your PATH
• GitHub CLI (gh) - For GitHub integration commands
• jq - JSON processor for hook commands
• curl - For Slack webhook integration

Installation

Quick Start (Recommended)

Install directly from GitHub:

# Add the GitHub marketplace
claude plugin marketplace add nanasess/eccube-dev-agents

# Install the plugin
claude plugin install eccube-dev-agents

Restart Claude Code to activate the plugin.

Alternative: Local Development Installation

For plugin development or testing local modifications:

# Clone the repository to a local directory
git clone https://github.com/nanasess/eccube-dev-agents.git /path/to/local/eccube-dev-agents

# Add the local marketplace
# Note: Point to the repository root directory containing .claude-plugin/marketplace.json
claude plugin marketplace add /path/to/local/eccube-dev-agents

# Install the plugin
claude plugin install eccube-dev-agents

The repository uses a nested structure where the actual plugin contents are in plugins/eccube-dev-agents/ subdirectory. The marketplace.json at the root configures this layout.

Environment Setup

For Slack notifications to work, set your Slack webhook URL:

export ECCUBE_DEV_AGENTS_SLACK_WEBHOOK_URL="https://hooks.slack.com/services/YOUR/WEBHOOK/URL"

Add this to your ~/.bashrc or ~/.zshrc to make it persistent.

Usage

Using Agents

# Analyze implementation status
"Use implementation-analyzer agent to analyze the current implementation"

# Investigate bugs
"Use bug-investigator agent to find the root cause of this error"

# Analyze CI logs
"Use log-analyzer agent to analyze this failed GitHub Actions run"

# Refactor code
"Use refactoring-expert agent to refactor this code"

Using Commands

Development Workflow Commands

# Create implementation plan (auto-generates filename from context)
/create-plan
# → Saves to .ai-agent/plans/

# Create plan with specific filename
/create-plan authentication-feature-plan.md
# → Saves to .ai-agent/plans/authentication-feature-plan.md

# Update implementation plan (auto-finds *-plan.md files in .ai-agent/plans/)
/update-plan

# Update specific plan
/update-plan authentication-feature-plan.md

# Load implementation plan (searches in .ai-agent/plans/)
/load-plan authentication-feature-plan.md

# Save conversation context before clearing (auto-generates filename)
/save-context
# → Example output: .ai-agent/sessions/auth-feature-202510301730.md

# Or specify custom filename
/save-context my-work.md
# → Saves to .ai-agent/sessions/my-work.md

# Load saved context to resume work (auto-detects latest file in .ai-agent/sessions/)
/load-context

# Or specify filename explicitly
/load-context auth-feature-202510301730.md

File Organization:

• Context files: .ai-agent/sessions/
• Implementation plans: .ai-agent/plans/
• Both directories are auto-created when needed

Typical workflow:

1. /create-plan feature-plan.md      # Create plan → .ai-agent/plans/feature-plan.md
2. [Implementation work]              # Code, test, etc.
3. /update-plan                       # Update progress
4. /save-context                      # Save → .ai-agent/sessions/feature-202511130924.md
5. /clear                             # Clear context
6. /load-context                      # Restore (auto-detects latest in .ai-agent/sessions/)
7. /load-plan feature-plan.md        # Check plan (.ai-agent/plans/feature-plan.md)
8. [Continue work]                    # Resume implementation

GitHub Integration Commands

# Check GitHub PR
/github-check #450

# Analyze failed CI
/github-logs-analyze <job-id>

# Generate commit message
/generate-commit

# Update PR description
/update-pr-description

# Create pull request
/create-pr

# Create PR with options
/create-pr --repo upstream/repo --base develop
/create-pr --draft

AI Search Commands

# Web search
/gemini-search latest EC-CUBE 4.2 features

# Direct Gemini interaction
/gemini explain the difference between Doctrine and Eloquent

Configuration

Customizing Hooks

Edit hooks/hooks.json to customize notification behavior:

• Modify the Gemini prompt for different summarization styles
• Change the Slack message format
• Add additional hooks for other events

Gemini CLI Setup

Ensure the gemini command is available in your PATH. If it's installed in a custom location, you can:

• Add it to your PATH: export PATH="$PATH:/path/to/gemini"
• Or create a symlink: ln -s /path/to/gemini/bin/gemini /usr/local/bin/gemini

Structure

eccube-dev-agents/
├── .claude-plugin/
│   └── marketplace.json              # Local marketplace configuration
├── plugins/eccube-dev-agents/        # Plugin contents
│   ├── .claude-plugin/
│   │   └── plugin.json               # Plugin metadata
│   ├── agents/                       # AI agent definitions
│   │   ├── implementation-analyzer.md
│   │   ├── bug-investigator.md
│   │   ├── log-analyzer.md
│   │   └── refactoring-expert.md
│   ├── commands/                     # Custom slash commands
│   │   ├── create-plan.md
│   │   ├── update-plan.md
│   │   ├── load-plan.md
│   │   ├── save-context.md
│   │   ├── load-context.md
│   │   ├── gemini-search.md
│   │   ├── gemini.md
│   │   ├── github-check.md
│   │   ├── github-logs-analyze.md
│   │   ├── generate-commit.md
│   │   ├── update-pr-description.md
│   │   └── create-pr.md
│   └── hooks/
│       └── hooks.json                # Event hooks configuration
├── CLAUDE.md                          # Plugin development guide
└── README.md

Contributing

Issues and pull requests are welcome! Please feel free to contribute improvements.

License

MIT

Author

nanasess