MindForge - AI Toolkit for Claude Code

MindForge is a comprehensive toolkit for managing MCP (Model Context Protocol) services, AI Agents, and Skills, designed to supercharge your Claude Code development experience.

✨ Features

Multi-language Support: Choose between English or Chinese versions of agents and skills
Rich Agent Collection: Specialized agents for Java, Python, Go, Frontend, and System Architecture
Reusable Skills: Domain-specific skills that can be composed and shared across agents
MCP Services: Extensible collection of Model Context Protocol services
Easy Setup: One-command installation script for Claude Code integration
Flexible Tech Stack: Each component can use its own preferred technology stack

🚀 Quick Start with Claude Code

MindForge integrates seamlessly with Claude Code. Run the setup script to automatically configure all agents and skills:

# Use default language (English)
./setup-claude.sh

# Use Chinese
./setup-claude.sh --lang=zh-cn

# Use English (explicit)
./setup-claude.sh --lang=en

This creates symbolic links to your ~/.claude/ directory, allowing Claude Code to automatically load all agents and skills.

🎛️ User-Level Configuration

For personalized behavior across all your projects, you can configure user-level instructions:

# Copy user-level instructions to your Claude directory
cp user_claude_md/en/CLAUDE.md ~/.claude/CLAUDE.md    # English
cp user_claude_md/zh-cn/CLAUDE.md ~/.claude/CLAUDE.md  # Chinese

What user-level configuration provides:

Global principles: Default behavior applied across all conversations
Language preference: Set your preferred response language (English or Chinese)
Search priority: Instructions for handling uncertain questions
Safety rules: Confirmation requirements for destructive operations
Built-in capability priority: Guidance on when to use agents/skills vs external tools

Note: User-level configuration is optional. If not configured, Claude Code will use its default behavior.

🌍 Supported Languages

en - English
zh-cn - Simplified Chinese

🤖 Available Agents

@code-reviewer - Expert code reviewer (software architecture, design patterns, code quality, SOLID principles)
@frontend-engineer - Modern frontend expert (React, Vue, Svelte, TypeScript)
@golang-backend-engineer - Go backend development expert (Fiber, Cobra, GORM, Clean Architecture)
@ios-developer - Expert iOS Developer (Swift 6, SwiftUI, MVVM, TCA)
@java-backend-engineer - Professional Java backend engineer (Spring Boot, MyBatis, Clean Architecture)
@java-unit-test - Professional Java unit test generator (JUnit, Mockito, AssertJ)
@product-manager - Product management expert (PRD, user stories, competitive analysis)
@python-test-engineer - Professional Python testing engineer (pytest, unittest, pytest-asyncio)
@system-architect - System architecture design expert (patterns, tech selection, ADR docs)

🎯 Available Skills

api-design - API design (REST, GraphQL, gRPC)
database-design - Database design and optimization
enterprise-java - Enterprise Java development (Spring Boot, microservices)
frontend-react - React ecosystem (Next.js, Server Components, Tailwind)
frontend-svelte - Svelte ecosystem (SvelteKit, shadcn-svelte)
frontend-vue - Vue ecosystem (Nuxt, Composition API, Pinia)
git-guru - Advanced Git operations and version control mastery
go-development - Go development (Fiber, Cobra, GORM)
javascript-typescript - JavaScript/TypeScript development (Node.js, Express, React)
product-management - Product management and strategy
python-development - Python development (FastAPI, Django, Flask, asyncio)
session-summary - Summarize current session context for seamless handover
swift-development - Core Swift 6+ development (Concurrency, Macros, Testing)
swiftui-development - Modern SwiftUI development (NavigationStack, Observation, SwiftData)
system-architecture - System architecture design
tech-documentation - Technical documentation writing
testing - General testing skills (unit, integration, TDD/BDD)
xcode-management - Xcode project management (automated file addition, project.pbxproj handling)

📁 Project Structure

mindforge/
├── agents/              # Claude Code format Agents (multi-language)
│   ├── en/             # English versions
│   │   ├── code-reviewer.md
│   │   ├── frontend-engineer.md
│   │   ├── golang-backend-engineer.md
│   │   ├── ios-developer.md
│   │   ├── java-backend-engineer.md
│   │   ├── java-unit-test.md
│   │   ├── product-manager.md
│   │   ├── python-test-engineer.md
│   │   └── system-architect.md
│   └── zh-cn/          # Chinese versions
│       ├── code-reviewer.md
│       ├── frontend-engineer.md
│       ├── golang-backend-engineer.md
│       ├── java-backend-engineer.md
│       ├── java-unit-test.md
│       ├── product-manager.md
│       ├── python-test-engineer.md
│       └── system-architect.md
├── skills/              # Claude Code format Skills (multi-language)
│   ├── en/             # English versions
│   │   ├── testing/SKILL.md
│   │   ├── enterprise-java/SKILL.md
│   │   ├── go-development/SKILL.md
│   │   ├── python-development/SKILL.md
│   │   ├── javascript-typescript/SKILL.md
│   │   ├── system-architecture/SKILL.md
│   │   ├── api-design/SKILL.md
│   │   ├── database-design/SKILL.md
│   │   ├── tech-documentation/SKILL.md
│   │   ├── frontend-development/SKILL.md
│   │   ├── git-guru/SKILL.md
│   │   └── xcode-management/SKILL.md
│   ├── zh-cn/          # Chinese versions
│   │   ├── testing/SKILL.md
│   │   ├── enterprise-java/SKILL.md
│   │   ├── go-development/SKILL.md
│   │   ├── python-development/SKILL.md
│   │   ├── javascript-typescript/SKILL.md
│   │   ├── system-architecture/SKILL.md
│   │   ├── api-design/SKILL.md
│   │   ├── database-design/SKILL.md
│   │   ├── tech-documentation/SKILL.md
│   │   ├── frontend-development/SKILL.md
│   │   ├── git-guru/SKILL.md
│   │   └── xcode-management/SKILL.md
│   └── scripts/        # Shared executable scripts for skills
│       └── xcode-management/
│           └── add_files_to_xcode.py  # Automated Xcode file addition
├── user_claude_md/      # User-level Claude instructions (multi-language)
│   ├── en/
│   │   └── CLAUDE.md   # English user-level instructions
│   └── zh-cn/
│       └── CLAUDE.md   # Chinese user-level instructions
├── templates/           # Templates for creating new resources
│   ├── agent-template-en.md      # English agent template
│   ├── agent-template-zhcn.md    # Chinese agent template
│   ├── skill-template-en.md      # English skill template
│   └── skill-template-zhcn.md    # Chinese skill template
├── mcp/                 # MCP services collection
│   ├── _template/
│   └── mcp-*/
├── docs/                # Documentation
│   ├── README-zhcn.md   # Chinese README
│   └── agents-detail/   # Detailed agent documentation
│       ├── en/          # English detailed guides
│       │   ├── java-backend-engineer/README.md
│       │   ├── java-unit-test/README.md
│       │   ├── python-test-engineer/README.md
│       │   ├── system-architect/README.md
│       │   ├── golang-backend-engineer/README.md
│       │   └── frontend-engineer/README.md
│       └── zh-cn/       # Chinese detailed guides
│           ├── java-backend-engineer/README.md
│           ├── java-unit-test/README.md
│           ├── python-test-engineer/README.md
│           ├── system-architect/README.md
│           ├── golang-backend-engineer/README.md
│           └── frontend-engineer/README.md
├── Makefile             # Build and resource management
└── setup-claude.sh      # Claude Code setup script (supports --lang parameter)

🛠️ Usage

Quick Start

# Show all available commands
make help

List Resources

# List all MCP services
make list-mcp

# List all Agents (shows both English and Chinese)
make list-agents

# List all Skills (shows both English and Chinese)
make list-skills

Create Resources from Templates

MindForge provides ready-to-use templates for creating new agents and skills. Templates are available in both English and Chinese.

Create a New Agent

# Create an English agent (default)
make init-agent AGENT=my-agent

# Create a Chinese agent
make init-agent AGENT=my-agent LANG=zh-cn

# Create an English agent (explicit)
make init-agent AGENT=my-agent LANG=en

What you get:

A complete agent file with frontmatter (name, description, tools, model, skills)
Structured sections for role definition, principles, and best practices
Code templates and quality checklists
Ready to customize for your specific use case

After creation:

Edit agents/{lang}/{agent-name}.md to customize the agent
Update the name, description, and system prompt
Specify which tools and skills the agent should use
Run ./setup-claude.sh --lang={lang} to activate

Create a New Skill

# Create an English skill (default, no scripts)
make init-skill SKILL=my-skill

# Create a skill with executable scripts
make init-skill SKILL=my-skill WITH_SCRIPTS=yes

# Create a Chinese skill
make init-skill SKILL=my-skill LANG=zh-cn

# Create a Chinese skill with scripts
make init-skill SKILL=my-skill LANG=zh-cn WITH_SCRIPTS=yes