Architect Workflow

Professional team-based workflows for AI software engineering. Includes deterministic planning frameworks, consistency verification, and pipeline auditing.

What's Included

1. Architect Mode (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]

2. Consistency Sweep Team

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

3. Pipeline Health Team

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

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

Quick Start

After installation:

# Launch architect mode
/architect-workflow "Add user authentication with JWT tokens"

# Or paste team definitions directly into Claude
# See team files in .claude/teams/

Architect Mode Process

Deconstruct: Break down goals into objectives + research questions
Research: Spawn parallel Explore agents for codebase investigation
Plan: Write PLAN.md with tasks, sandboxes, success criteria
Approve: User reviews plan before any code is written
Execute: Implementers (Opus) + Reviewers (Sonnet) with accept/reject loops
Integrate: Final checks, cleanup temp files, completion report

Key Feature: NO CODE until Phase 5 approval - prevents "ready, fire, aim" loops

Team Scaling

Scope	Researchers	Implementers	Reviewers
Small (≤3 files)	Skip (Quick Mode)	1 Opus	1 Sonnet
Medium (4-10 files)	2 Explore	2-3 Opus	1 Sonnet
Large (10+ files)	3 Explore	3-4 Opus	1-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.