编码框架
复杂项目的可移植多实例人工智能协调
将任何开发项目转换为协调的多实例工作流，其中专门的Claude Code实例通过Git消息队列进行协作。
它做什么
- 自动设置：单个命令创建完整的项目基础结构
- 动态扩展：根据项目复杂性分配2-4个实例
- 代理人执法：强制使用专业代理（GitHub、Exa搜索、Playwright）
- 零信任安全：所有秘密都通过GCP秘密管理器（从未硬编码）
- 智能协调：基于Git的消息队列，具有LIFO保留功能（节省75%的磁盘）
快速开始
# 1. Clone framework
git clone https://github.com/langley232/coding-framework.git
cd coding-framework
# 2. Run initialization
./initialization/init-project.sh
# 3. Launch instances (commands generated for you)
wsl -d Ubuntu && cd ~/your-project && ./setup-instance.sh && claude创造什么
对于每个项目：
- ✅ GitHub存储库
- ✅ 安装了12个专业代理
- ✅ 已配置14台MCP服务器
- ✅ CLAUDE.md（项目说明）
- ✅ CONSTITUTION.md（治理规则）
- ✅ GCP密钥管理器集成
- ✅ 消息队列协调
- ✅ 实例特定任务列表
- ✅ 每个实例的安装脚本
实例类型（自动分配）
| 复杂性 | 实例 | 角色 |
|---|---|---|
| 小 （1-20个任务） | 2 | 前端+后端 |
| 中等 （20-50个任务） | 3 | 前端+后端+测试 |
| 大的 （50+个任务） | 4 | 前端+后端+测试+主管 |
强制性代理人规则
三个不可谈判的代表团：
- Git操作 →
@github-agent（所有提交、推送、PR） - 浏览器测试 →
@browser-testing-agent（所有剧作家） - 外部搜索 →
@exa-search-agent（所有网络研究）
违规=任务失败+重新执行
安全特性
- GCP秘密经理 必需的（没有硬编码的秘密）
- 环境变量模式:
OPENAI_API_KEY=gcp-secret:openai-api-key - 运行时加载:
await loadAllSecrets()启动时 - 支持33个秘密 （人工智能服务、数据库、支付、OAuth等）
消息队列协议
每2小时（实例1-3）：
- 拉取最新更改
- 检查
coordination/messages/instance-X/获取新消息 - 按优先级处理：用户-覆盖>阻塞>状态
每30分钟（主管）：
- 监视所有实例
- 解决阻断器
- 自动批准通过的PR
- 向用户报告
已创建文件结构
your-project/
├── agents/ ← 12 specialized agents
├── config/
│ └── mcp-servers.json ← 14 MCP servers configured
├── coordination/messages/
│ ├── instance-1/ ← Frontend messages
│ ├── instance-2/ ← Backend messages
│ └── instance-3/ ← Testing messages
├── shared/utils/
│ └── gcp-secrets.js ← Secret Manager integration
├── CLAUDE.md ← Project instructions (auto-generated)
├── CONSTITUTION.md ← Governance rules (auto-generated)
├── setup-instance.sh ← Per-instance setup
└── QUICK-START.md ← Launch commands经过验证的结果
AtlasWeb Mini（生产使用）：
- ✅ 完成31项任务（3周）
- ✅ 4个实例中有100多个提交
- ✅ 0个代理违规（100%合规）
- ✅ 33个秘密迁移到GCP
- ✅ LIFO保留可节省75%的磁盘
先决条件
- WSL2与Ubuntu（20.04，22.04，24.04）
- 克劳德代码CLI
- 启用密钥管理器的GCP项目
- 使用PAT的GitHub帐户
- Node.js 18+
示例用法
# Initialize new SaaS product
./init-project.sh
→ Project Name: acme-crm
→ Type: new-product
→ Tech Stack: React, FastAPI, PostgreSQL
→ Complexity: medium
# Result: 3 instances, 35 tasks, complete setup in 5 minutes文档
docs/AGENT-USAGE-PROTOCOL.md-强制性委托规则docs/MESSAGE-QUEUE-RETENTION-POLICY.md-磁盘优化- 模板在
templates/供参考
许可证
MIT-可自由用于任何项目类型
______________________________________________________________________
框架版本： 1.0.0 使用克劳德代码构建 存储库： https://github.com/langley232/coding-framework