← Back to list
workflow-architecture
by cuioss
An orchestration layer for AI coding assistants (currently Claude Code) that enforces consistency, reliability, and more predictable outputs.
⭐ 0🍴 0📅 Jan 17, 2026
Run in ManusSKILL.md
name: workflow-architecture description: Centralized architecture documentation for the pm-workflow bundle with visual diagrams allowed-tools: Read
PM-Workflow Architecture
Role: Central architecture reference for the pm-workflow bundle. Provides visual documentation of the 5-phase execution model, thin agent pattern, and data layer.
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ PM-WORKFLOW ARCHITECTURE │
│ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ 5-PHASE EXECUTION MODEL │ │
│ │ │ │
│ │ ┌────────┐ ┌───────────┐ ┌────────┐ ┌───────────┐ ┌────────────┐ │ │
│ │ │ 1-init │▶│ 2-outline │▶│ 3-plan │▶│ 4-execute │▶│ 5-finalize │ │ │
│ │ └────────┘ └───────────┘ └────────┘ └───────────┘ └────────────┘ │ │
│ │ │ │ │ │ │ │ │
│ │ ▼ ▼ ▼ ▼ ▼ │ │
│ │ config solution TASK-* project commit │ │
│ │ status outline .toon files PR │ │
│ │ request │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ THIN AGENT PATTERN │ │
│ │ │ │
│ │ Orchestrator ──▶ Agent ──▶ Skill │ │
│ │ │ │ │ │
│ │ │ └──▶ Domain Knowledge │ │
│ │ │ │ │
│ │ └──▶ Context Isolation │ │
│ │ │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ DATA LAYER │ │
│ │ │ │
│ │ manage-config manage-lifecycle manage-tasks manage-solution │ │
│ │ │ │ │ │ │ │
│ │ ▼ ▼ ▼ ▼ │ │
│ │ config.toon status.toon TASK-*.toon solution_outline.md │ │
│ │ │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
Quick Navigation
| Document | Focus | Key Visuals |
|---|---|---|
| standards/phases.md | 5-phase model | Phase flow, transitions, outputs |
| standards/agents.md | Thin agent pattern | Agent structure, delegation |
| standards/data-layer.md | manage-* skills | File operations, TOON format |
| standards/skill-loading.md | Two-tier loading | System vs domain skills |
| standards/artifacts.md | Plan file formats | config.toon, status.toon, TASK-*.toon |
| standards/task-executor-routing.md | Task executor routing | Profile→executor mapping, extensibility |
pm-workflow:workflow-extension-api | Extension mechanism | Domain extensions for outline/triage |
Core Principles
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ CORE DESIGN PRINCIPLES │
│ │
├─────────────────────────────────────────────────────────────────────────────┤
│ │
│ 1. DOMAIN-AGNOSTIC WORKFLOW │
│ ════════════════════════ │
│ Workflow skills contain NO domain-specific logic. │
│ Domain knowledge comes from marshal.json at runtime. │
│ │
│ 2. THIN AGENT PATTERN │
│ ═══════════════════ │
│ A single parameterized agent (plan-phase-agent) with different │
│ `phase` parameters results in 5 invocation modes, all sharing │
│ one implementation. Agents are minimal wrappers that: │
│ • Resolve skills from marshal.json │
│ • Load resolved skills │
│ • Delegate to skills for actual work │
│ │
│ 3. SINGLE SOURCE OF TRUTH │
│ ════════════════════════ │
│ Plan files (.toon, .md) are the source of truth. │
│ Skills read/write via manage-* scripts only. │
│ │
│ 4. SCRIPT-BASED FILE ACCESS │
│ ═════════════════════════ │
│ ALL .plan/ file access goes through execute-script.py. │
│ NEVER use Read/Write/Edit on .plan/ files directly. │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
Component Overview
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ COMPONENT HIERARCHY │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ COMMANDS (User-facing) │ │
│ │ ══════════════════════ │ │
│ │ /plan-manage /plan-execute /pr-doctor │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ AGENTS (Single Parameterized Agent) │ │
│ │ ═══════════════════════════════════ │ │
│ │ plan-phase-agent phase=1-init | 2-outline | 3-plan | 4-execute | 5-finalize │
│ │ (One agent, 5 invocation modes) │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ WORKFLOW SKILLS (Phase Logic) │ │
│ │ ═════════════════════════════ │ │
│ │ phase-1-init phase-2-outline phase-3-plan │ │
│ │ phase-4-execute phase-5-finalize │ │
│ │ task-implementation task-module_testing │ │
│ │ git-workflow pr-workflow │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ DATA LAYER (manage-* Skills) │ │
│ │ ════════════════════════════ │ │
│ │ manage-config manage-lifecycle manage-tasks │ │
│ │ manage-solution-outline manage-plan-documents │ │
│ │ manage-files manage-references │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ PLAN FILES (.plan/plans/{plan_id}/) │ │
│ │ ═══════════════════════════════════ │ │
│ │ config.toon status.toon request.md solution_outline.md │ │
│ │ references.toon TASK-001.toon TASK-002.toon ... │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
Related Skills
| Skill | Purpose |
|---|---|
pm-workflow:workflow-extension-api | Extension points for domain customization |
pm-workflow:phase-1-init | Init phase implementation |
pm-workflow:phase-2-outline | Outline phase implementation |
pm-workflow:phase-3-plan | Plan phase implementation |
pm-workflow:phase-4-execute | Execute phase implementation |
pm-workflow:phase-5-finalize | Finalize phase implementation |
pm-workflow:task-implementation | Implementation profile workflow |
pm-workflow:task-module_testing | Module testing profile workflow |
Standards Documents
Load on-demand based on what aspect of the architecture you need to understand:
# Understanding the 5-phase model
Read standards/phases.md
# Understanding thin agent pattern
Read standards/agents.md
# Understanding data layer (manage-* skills)
Read standards/data-layer.md
# Understanding skill loading
Read standards/skill-loading.md
# Understanding plan file formats
Read standards/artifacts.md
# Understanding task executor routing
Read standards/task-executor-routing.md
Score
Total Score
70/100
Based on repository quality metrics
✓SKILL.md
SKILL.mdファイルが含まれている
+20
✓LICENSE
ライセンスが設定されている
+10
✓説明文
100文字以上の説明がある
+10
○人気
GitHub Stars 100以上
0/15
○最近の活動
3ヶ月以内に更新がある
0/10
○フォーク
10回以上フォークされている
0/5
✓Issue管理
オープンIssueが50未満
+5
✓言語
プログラミング言語が設定されている
+5
○タグ
1つ以上のタグが設定されている
0/5
Reviews
💬
Reviews coming soon