Back to Details

architect-workflow

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Architect Workflow

架构师工作流

Professional team-based workflows for AI software engineering. Includes deterministic planning frameworks, consistency verification, and pipeline auditing.
面向AI软件工程的专业团队协作工作流，包含确定性规划框架、一致性验证和流水线审计功能。

What's Included

包含内容

1. Architect Mode (Command + Team)

1. 架构师模式（Command + Team）

A 6-phase framework for rigorous software engineering:
  • Phase 1-2: Deconstruction & Research (no code)
  • Phase 3-4: Planning & Approval gates
  • Phase 5: Delegated implementation with enforced review loops
  • Phase 6: Integration & completion report
Use when: Complex features, architectural changes, anything >3 files
Trigger: 
/architect-workflow [goal]
一套用于严谨软件工程的6阶段框架：
  • 阶段1-2：拆解与调研（无代码）
  • 阶段3-4：规划与审批节点
  • 阶段5：委托实现并强制执行审查循环
  • 阶段6：集成与完成报告
适用场景：复杂功能、架构变更、涉及3个以上文件的任务
触发命令：
/architect-workflow [目标]

2. Consistency Sweep Team

2. 一致性扫描团队

4 specialized agents verify docs, config, and architecture stay in sync:
  • Docs Verifier: Compare documentation against actual code
  • Dashboard Verifier: Match UI components to backend config
  • Config Verifier: Validate defaults, constants, schemas
  • Architecture Verifier: Check structural docs match reality
Use when: After major refactors, before releases, maintaining large codebases
4个专业Agent负责验证文档、配置与架构保持同步：
  • 文档验证Agent：对比文档与实际代码
  • 仪表盘验证Agent：匹配UI组件与后端配置
  • 配置验证Agent：验证默认值、常量与模式
  • 架构验证Agent：检查结构文档与实际情况是否一致
适用场景：重大重构后、发布前、维护大型代码库时

3. Pipeline Health Team

3. 流水线健康团队

4 auditors investigate content generation pipelines for bugs and performance:
  • Draft Phase Auditor: End-to-end draft flow analysis
  • Critique Phase Auditor: Critique/re-draft loop verification
  • Validator Auditor: Check validators and enforcers
  • Orchestration Auditor: State machine and phase coordination
Use when: Debugging complex pipelines, performance tuning, quality audits
4个审计Agent负责排查内容生成流水线的漏洞与性能问题：
  • 草稿阶段审计Agent：端到端草稿流程分析
  • 评审阶段审计Agent：评审/重写循环验证
  • 验证器审计Agent：检查验证器与强制执行器
  • 编排审计Agent：状态机与阶段协调检查
适用场景：调试复杂流水线、性能调优、质量审计

Installation

安装

This skill installs files to:
  • .claude/commands/architect-workflow.md
    - The /architect-workflow command
  • .claude/teams/architect.md
    - Architect Mode team workflow
  • .claude/teams/consistency-sweep.md
    - Consistency verification team
  • .claude/teams/pipeline-perf.md
    - Pipeline health audit team
该Skill会将文件安装至以下路径：
  • .claude/commands/architect-workflow.md
    - 
    /architect-workflow
    命令文件
  • .claude/teams/architect.md
    - 架构师模式团队工作流文件
  • .claude/teams/consistency-sweep.md
    - 一致性验证团队文件
  • .claude/teams/pipeline-perf.md
    - 流水线健康审计团队文件

Quick Start

快速开始

After installation:
bash
undefined
安装完成后：
bash
undefined

Launch architect mode

启动架构师模式

/architect-workflow "Add user authentication with JWT tokens"
/architect-workflow "Add user authentication with JWT tokens"

Or paste team definitions directly into Claude

或直接将团队定义粘贴至Claude

See team files in .claude/teams/

查看.claude/teams/目录下的团队文件

undefined
undefined

Architect Mode Process

架构师模式流程

  1. Deconstruct: Break down goals into objectives + research questions
  2. Research: Spawn parallel Explore agents for codebase investigation
  3. Plan: Write PLAN.md with tasks, sandboxes, success criteria
  4. Approve: User reviews plan before any code is written
  5. Execute: Implementers (Opus) + Reviewers (Sonnet) with accept/reject loops
  6. Integrate: Final checks, cleanup temp files, completion report
Key Feature: NO CODE until Phase 5 approval - prevents "ready, fire, aim" loops
  1. 拆解：将目标分解为具体任务与调研问题
  2. 调研：启动多个并行的Explore Agent调查代码库
  3. 规划：编写PLAN.md文件，包含任务、沙箱与成功标准
  4. 审批：用户在编写任何代码前先评审规划
  5. 执行：由Opus（实现者）+ Sonnet（评审者）协作，包含接受/拒绝循环
  6. 集成：最终检查、清理临时文件、生成完成报告
核心特性：在阶段5获得审批前不编写任何代码——避免“准备、开火、瞄准”的混乱循环

Team Scaling

团队规模适配

ScopeResearchersImplementersReviewers
Small (≤3 files)Skip (Quick Mode)1 Opus1 Sonnet
Medium (4-10 files)2 Explore2-3 Opus1 Sonnet
Large (10+ files)3 Explore3-4 Opus1-2 Sonnet
范围调研人员实现人员评审人员
小型（≤3个文件）跳过（快速模式）1个Opus1个Sonnet
中型（4-10个文件）2个Explore2-3个Opus1个Sonnet
大型（10个以上文件）3个Explore3-4个Opus1-2个Sonnet

When to Use What

场景选择指南

Architect Mode: Building new features, refactoring, architectural changes Consistency Sweep: Post-refactor verification, release prep, doc maintenance Pipeline Health: Debugging multi-stage flows, performance investigation, quality audits
架构师模式：构建新功能、重构、架构变更 一致性扫描：重构后验证、发布准备、文档维护 流水线健康审计：调试多阶段流程、性能排查、质量审计

Philosophy

设计理念

These workflows enforce discipline:
  • Research before planning
  • Planning before implementation
  • Review before merging
  • Measurable success criteria
  • Explicit file sandboxes
  • No code outside scope
Result: Higher quality, fewer bugs, better architecture decisions.
这些工作流旨在强化工程纪律：
  • 先调研再规划
  • 先规划再实现
  • 先评审再合并
  • 可衡量的成功标准
  • 明确的文件沙箱
  • 不编写超出范围的代码
最终成果：更高的代码质量、更少的漏洞、更优的架构决策。