architect-planner

name	architect-planner
description	架构规划专家 - 使用 Codex 本地上下文、仓库证据和只读 child agent 进行大型系统架构设计与规划。
auto_invoke	true
tags	["architecture","planning","codex-native","system-design"]
version	0.2.0
source	fork
checksum	8d45cc8e68cd1f71940dc4393ebdc3e3a1672cfea5c6fc9de7723d2244532555
updated_at	2026-06-08T02:50:00.000Z
layer	research

Architect Planner - Codex 原生架构规划

核心功能

面向复杂系统设计、架构评审和迁移规划。默认使用 Codex 当前会话、仓库检索、项目文档和只读 child agent；不调用外部模型 CLI。

触发场景

• "架构设计"
• "系统规划"
• "架构评审"
• "技术架构方案"
• "planner"

手动触发：

使用 architect-planner 设计：<架构需求>

Workflow

Step 1: 收集输入

明确以下信息：

• 业务目标和成功标准
• 非功能需求：性能、可用性、数据规模、安全、合规
• 约束：团队、时间、预算、技术栈、迁移窗口
• 当前系统事实：入口、模块边界、依赖、部署方式

优先读取本地证据：

rg --files
rg -n "architecture|deploy|service|database|queue|auth|cache" README.md docs . 2>/dev/null

Step 2: 项目事实扫描

如在代码仓内，先用本地 ProjectMind 或直接检索建立事实基础：

PROJECT_PATH="$(pwd)"
PROJECTMIND_HOME="${PROJECTMIND_HOME:-/Users/WangQiao/claude-enhanced-quality}"
PYTHON_BIN="${PYTHON_BIN:-$(command -v python3 || command -v python || true)}"
if [ -z "$PYTHON_BIN" ]; then
  echo "ProjectMind error: no python3 or python interpreter found" >&2
  exit 1
fi
"$PYTHON_BIN" "$PROJECTMIND_HOME/project_mind.py" "$PROJECT_PATH"

补充读取：

• README.md
• docs/
• package/build/deploy 配置
• 关键入口文件和模块边界

Step 3: 派发架构探索代理

复杂场景使用 explorer 做只读架构调研：

spawn_agent(agent_type="explorer", message="<architecture exploration prompt>")
wait_agent
close_agent

Prompt 框架：

Your task is architecture exploration. Read-only.

<agent-instructions>
Inputs:
- Goal: <架构目标>
- Constraints: <约束>
- Known files/docs: <本地证据>

Trace the current architecture and produce:
1. Current system map
2. Critical dependencies and coupling points
3. Architecture risks
4. Candidate target architectures
5. Migration constraints and unknowns

Cite concrete files and configuration paths.
</agent-instructions>