AI Coding Framework: Claude Flow + Claude Code + Gemini CLI

A comprehensive framework for AI-assisted development using Claude Flow as the orchestrator with Claude Code and Gemini CLI as specialized tools.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                  Claude Flow (Orchestrator)                 │
│         Coordinates agents, manages memory & sessions       │
├─────────────────────────────────────────────────────────────┤
│              ┌────────────┴────────────┐                    │
│              ▼                         ▼                    │
│      ┌─────────────┐           ┌─────────────┐              │
│      │ Claude Code │           │ Gemini CLI  │              │
│      │  (Editor)   │           │ (Analyzer)  │              │
│      │ Implements  │           │ 1M+ context │              │
│      └─────────────┘           └─────────────┘              │
└─────────────────────────────────────────────────────────────┘

Core Principle

"Claude Flow orchestrates, Claude Code edits, Gemini reads"

Tool	Role	Responsibility
Claude Flow	Orchestrator	Coordinates agents, manages sessions, parallel execution
Claude Code	Editor	Code implementation, file editing, running commands
Gemini CLI	Analyzer	Large codebase analysis (1M+ token context)

Documentation Structure

docs/
├── README.md                    # This file - Overview
├── 01-getting-started.md        # Installation and setup
├── 02-architecture.md           # Framework architecture explained
├── 03-claude-code-basics.md     # Claude Code fundamentals
├── 04-gemini-cli-basics.md      # Gemini CLI fundamentals
├── 05-integration-patterns.md   # How the tools work together
├── 06-claude-flow-orchestration.md  # Orchestration deep-dive
├── 07-project-templates.md      # Ready-to-use templates
├── 08-best-practices.md         # Tips and recommendations
└── examples/                    # Step-by-step workflow examples

Quick Start

Prerequisites

• Node.js 18+
• Claude Code: npm install -g @anthropic-ai/claude-code
• Gemini CLI: npm install -g @google/gemini-cli
• Claude Flow: npm install -g claude-flow@alpha

Initialize Project

# Initialize Claude Flow in your project
npx claude-flow@alpha init --force

Start Working

# Quick task with auto-spawned agents
npx claude-flow@alpha swarm "build a REST API" --claude

# Complex project with persistent session
npx claude-flow@alpha hive-mind spawn "implement auth system" --agents 5 --claude

# Monitor progress
npx claude-flow@alpha hive-mind monitor --live

How It Works

1. You give a task to Claude Flow
2. Claude Flow spawns specialized agents (Coder, Tester, Architect, etc.)
3. Agents use Gemini CLI for large codebase analysis
4. Agents use Claude Code for implementation
5. Claude Flow coordinates and stores results in memory

Workflow

1. ORCHESTRATE - Claude Flow receives task, spawns agents
2. ANALYZE     - Agents use Gemini for codebase understanding
3. PLAN        - Agents coordinate on approach
4. IMPLEMENT   - Claude Code agents make changes
5. VERIFY      - Gemini validates implementation
6. COMPLETE    - Claude Flow records results in memory

Sources & Credits

• Reddit: Gemini CLI + Claude Code integration
• Gemini MCP Server Gist
• Template Repository
• Claude Flow
• AI Engineer Guide

License

MIT - Use freely for your projects.