sdaduanbilei/cc-haha
1
0
Fork 0
mirror of https://github.com/NanmiCoder/cc-haha synced 2026-07-16 13:03:31 +08:00
Code Issues Packages Projects Releases Wiki Activity
cc-haha/docs/en/agent/index.md
程序员阿江(Relakkes) 7f08e7a3bc Refresh brand assets around the new app logo 
The desktop app and documentation need to present the new logo consistently, so the canonical 1024px source icon now feeds the Tauri icon family, desktop public assets, README images, and VitePress brand imagery.

Constraint: Tauri bundle icons are generated assets and must be refreshed from the source icon rather than relying on README or public image replacement alone
Rejected: Rename logo paths | existing README, desktop, and docs references can keep stable paths and pick up the new files directly
Confidence: high
Scope-risk: moderate
Directive: Regenerate desktop/src-tauri/icons whenever desktop/src-tauri/app-icon.png changes
Tested: cd desktop && bun run build; npm run --loglevel=error docs:build; git diff --check; iconutil expanded icon.icns size ladder
Not-tested: full local quality gate per request
2026-05-13 10:38:13 +08:00

6.6 KiB
Raw Blame History

Claude Code Multi-Agent System Documentation

Complete guide and technical reference for multi-agent orchestration

Documentation Index

01-usage-guide.md — Usage Guide

A comprehensive user-facing manual covering:

  • Agent Tool: Parameter reference, spawn methods, background execution
  • Six Built-in Agents: general-purpose, Explore, Plan, verification, claude-code-guide, statusline-setup
  • Background Tasks: Asynchronous execution, progress tracking, completion notifications
  • Agent Teams: Team creation, member collaboration, message communication
  • Worktree Isolation: Independent environments, branch management, secure contexts
  • Custom Agents: Definition format, tool pool configuration, system prompts

Target Audience: All Claude Code users

02-implementation.md — Implementation Details

A deep technical reference for developers covering:

  • Architecture Overview: 5 agent categories, 4 spawn paths
  • Agent Spawn Flow: Detailed walkthrough of Sync / Async / Fork / Teammate paths
  • Tool Pool System: Three-layer filtering, constant definitions, permission mapping
  • Context Passing: CacheSafeParams, system prompt construction, fork cache optimization
  • Teams Internals: TeamFile structure, mailbox system, inbox polling, message routing
  • Background Task Engine: LocalAgentTask lifecycle, progress tracking, notification queue
  • Permission Synchronization: Team-level permissions, mode propagation, bubble mode
  • End-to-End Data Flow: From Agent Tool invocation to result delivery

Target Audience: Contributors, architects, and developers seeking deep implementation understanding

03-agent-framework.md — Agent Framework Deep Dive

Deconstructing the architecture behind Claude Code's agent framework from source code, covering:

  • Core Agent Loop: AsyncGenerator state machine, five-phase while(true) loop
  • System Prompt Engineering: Layered construction, cache boundary, CLAUDE.md loading
  • Tool System Design: Full lifecycle management, three-stage registration, 7-step execution pipeline
  • Context Management & Compression: Four-level progressive compression, system context injection
  • Skills & Plugin Ecosystem: Skill definition and discovery, plugins, hooks, MCP integration
  • Permission & Security Model: Layered permission model, rule pattern matching
  • Fault Recovery Mechanisms: 6 built-in recovery strategies, model fallback
  • Comparison with LangChain/ReAct: Architecture paradigm differences, why not ReAct
  • Why Claude Code Is So Good: 7 core design principles

Target Audience: Architects studying AI agent design, AI application developers, technical researchers

Illustration Notes

All diagrams use a dark background (#1a1a2e) with Claude Code Haha orange-blue accent (#FF7A00), consistent with Claude Code's official documentation style.

Image Description Document
01-agent-overview.png Multi-Agent System Overview — Architecture panorama Usage Guide
02-agent-types.png Six Built-in Agents — Type comparison matrix Usage Guide
03-spawn-flow.png Agent Spawn Flow — Four-path decision tree Usage Guide
04-agent-teams.png Agent Teams Collaboration — Team communication topology Usage Guide
05-architecture.png Implementation Architecture — Core module relationships Implementation
06-context-passing.png Context Passing — CacheSafeParams data flow Implementation
07-tool-pool.png Tool Pool System — Three-layer filtering pipeline Implementation
08-background-task.png Background Task Engine — Lifecycle state machine Implementation
09-teams-mailbox.png Teams Mailbox System — Message routing topology Implementation
10-fork-cache.png Fork Cache Optimization — Byte-level consistent sharing Implementation
11-agent-framework-overview.png Agent Framework Overview — Core component relationships Framework Deep Dive
12-agent-core-loop.png Core Agent Loop — Five-phase state machine Framework Deep Dive
13-system-prompt-pipeline.png System Prompt Pipeline — Layered cache pipeline Framework Deep Dive
14-context-compression.png Context Compression — Four-level progressive strategy Framework Deep Dive

Quick Start

For Users

  1. Read the Usage Guide
  2. Learn about the six built-in agents and their use cases
  3. Try spawning subagents using the Agent tool in a conversation
  4. Explore multi-agent collaboration with Agent Teams

For Developers

  1. Read the Implementation Details
  2. Browse the source code:
    • src/tools/AgentTool/ — Agent tool implementation
    • src/tools/TeamCreateTool/ — Team creation
    • src/tools/SendMessageTool/ — Inter-agent communication
    • src/utils/swarm/ — Swarm collaboration infrastructure
    • src/utils/forkedAgent.ts — Fork agent context
    • src/tasks/ — Task management system
  3. Understand the four spawn paths and context passing mechanisms

Core Concepts Quick Reference

Concept Description
Agent Tool Primary entry point — accepts a prompt + subagent_type to spawn a subagent
Subagent An independent child agent that executes tasks with its own tool pool and permissions
Fork Agent A forked agent that inherits the parent's full context and shares prompt cache
Teammate A collaborative member within an Agent Team, communicating via mailbox
Worktree Git worktree isolation mode providing an independent file environment
LocalAgentTask Local agent task state, tracking running/completed/failed status
DreamTask Automatic memory consolidation task that runs periodically in the background
CacheSafeParams Cache-safe parameters ensuring byte-level consistency of API request prefixes
TeamFile Team configuration file storing the member list and permissions
Mailbox File-based message queue supporting asynchronous communication between teammates

Related Resources