Claude Code Army

A multi-agent system based on Claude for software project management and development.

Description

Claude Code Army is a system that uses multiple Claude instances to simulate a complete development team:

• Project Manager: Coordinates the team and manages tasks
• Frontend and Backend Developers: Implement features
• QA: Ensures code quality
• Product Owner: Defines product vision

Prerequisites

• Node.js (v14 or higher)
• npm or yarn
• An Anthropic API key
• Make (to use make commands)

Installation

1. Clone the repository:

git clone https://github.com/your-username/claude-army.git
cd claude-army

2. Install dependencies:

cd backend
npm install
cd ../frontend
npm install

3. Configure the .env file:

cd backend
cp .env.example .env

Edit the .env file and add your Anthropic API key:

ANTHROPIC_API_KEY=your_api_key_here

Configuration

Working Directory

The system requires a valid working directory with appropriate permissions. This directory must:

• Be an absolute path
• Have read/write permissions
• Contain a .claude folder with the settings.local.json file

Claude Permissions

The .claude/settings.local.json file is automatically created with the following permissions:

{
  "permissions": {
    "allow": [
      "Bash(*)",
      "Bash(ls:*)",
      "Edit(*)",
      "Glob(*)",
      "Grep(*)",
      "LS(*)",
      "NotebookRead(*)",
      "NotebookEdit(*)",
      "Read(*)",
      "WebFetch(*)",
      "Write(*_test.go)"
    ],
    "deny": [
      "Bash(git *:*)"
    ]
  }
}

Usage

1. Start the server:

make start

2. Open your browser at: http://localhost:3000

3. In the interface:

   • Specify the working directory
   • Validate the directory
   • Enter your request
   • Follow the interactions between agents

Features

Task Management

• Task creation and tracking
• Automatic assignment to appropriate developers
• QA validation
• Bug management

Backup System

• Automatic backup after each task
• Restoration in case of problems
• Limited correction attempts

Real-time Interface

• Display of agent memories
• Current task tracking
• Communication history
• Project status

Project Structure

claude-army/
├── backend/
│   ├── server.js
│   ├── .env
│   └── package.json
├── frontend/
│   ├── index.html
│   └── package.json
├── prompts/
│   ├── project_manager.md
│   ├── frontend_developer.md
│   ├── backend_developer.md
│   ├── qa.md
│   └── product_owner.md
├── tasks/
├── backups/
└── features/

Development

Adding a New Agent

1. Create a new prompt file in prompts/
2. Add the role to ROLES in server.js
3. Update the frontend interface

Modifying Permissions

1. Modify the CLAUDE_SETTINGS constant in server.js
2. New settings will be applied on next startup

Troubleshooting

Common Errors

1. "The backend/.env file does not exist"

   • Solution: Create the .env file with your API key

2. "The path must be absolute"

   • Solution: Use an absolute path for the working directory

3. "No read/write permission"

   • Solution: Check directory permissions

Contribution

Contributions are welcome! Feel free to:

1. Fork the project
2. Create a branch for your feature
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

License

MIT

Contact

For any questions or suggestions, feel free to open an issue.