Workflow Guide

Workflow Selection Guide (Meta Hub)

> Purpose: Auto-analyze project state → recommend 1–2 optimal skills > > Core principle: This skill does not write implementation code. It only performs situation diagnosis → skill recommendation → user confirmation.

---

Absolute Prohibitions

1. Do not write code directly — guide the workflow only.
2. Do not list all skills — recommend 1–2 only, matched to the situation.
3. Do not start with requirements questions — auto-diagnose project state first.

---

Actions to Execute Immediately on Skill Activation

Stage 1: Auto-diagnose project state (Silent Analysis)

# 1. Check for task file
ls TASKS.md 2>/dev/null || ls docs/planning/06-tasks.md 2>/dev/null

# 2. Check codebase (actual code files in src/·app/·lib/)
SOURCE_CODE=$(find src/ app/ lib/ -maxdepth 3 -type f \( -name "*.ts" -o -name "*.js" -o -name "*.py" \) 2>/dev/null | head -1)
echo "source_code=${SOURCE_CODE:+yes}"

# 3. Check for interrupted work (state file + incomplete tasks)
for STATE_PATH in ".claude/orchestrate-state.json" ".claude/orchestrate/orchestrate-state.json"; do
  if [ -f "$STATE_PATH" ] && grep -qE '"status"[[:space:]]*:[[:space:]]*"(in_progress|pending)"' "$STATE_PATH" 2>/dev/null; then
    echo "state_file=$STATE_PATH incomplete_in_state=1"
  fi
done

# 4. Check for git merge conflicts
CONFLICT_FILES=$(git diff --name-only --diff-filter=U 2>/dev/null | wc -l | tr -d ' ')
echo "conflicts=$CONFLICT_FILES"

# 5. Agent/task counts
AGENT_COUNT=$(ls .claude/agents/*.md 2>/dev/null | wc -l | tr -d ' ')
TASK_COUNT=$(grep -cE '^\s*[-*]\s*\[|^#{1,6}\s+\[' TASKS.md 2>/dev/null || echo 0)
INCOMPLETE_COUNT=$(grep -cE '^\s*[-*]\s*\[\s*\]|^#{1,6}\s+\[\s*\]' TASKS.md 2>/dev/null || echo 0)
GOVERNANCE_DONE=$(ls management/project-plan.md 2>/dev/null && echo "yes" || echo "no")
echo "agents=$AGENT_COUNT tasks=$TASK_COUNT incomplete=$INCOMPLETE_COUNT governance=$GOVERNANCE_DONE"

# 6. cmux 감지
CMUX_AVAILABLE=$(cmux ping 2>/dev/null && echo "yes" || echo "no")
echo "cmux=$CMUX_AVAILABLE"

Stage 2: Decision Algorithm (rules + experience hybrid)

> workflow-guide does current state → recommend 1 skill. > When experience data exists, memento's Smart Router can override the rule-based recommendation.

① Recovery: state file incomplete OR merge conflicts → /recover
② No tasks: no TASKS.md → /tasks-init (or /tasks-migrate if legacy exists)
③ Maintenance: source_code exists + bug/fix request → /maintenance
③-b Maintenance (iterative): source_code exists + incomplete>0 → /agile iterate
④ New implementation: incomplete>0 + TASK=30 → /team-orchestrate --mode=auto (or --mode=team if Agent Teams)
⑤-b Very large (50+): incomplete>=50 → /team-orchestrate --mode=thin
⑥ Done: all_tasks_completed → /audit

Memento Experience Override (when .claude/memento/experience.jsonl exists with 5+ entries):

After computing the rule-based recommendation, check if memento's experience-weighted router suggests a different skill with confidence > 0.75. If so, use the experience-based recommendation and note the override reason. See /memento route for the full algorithm. This ensures backward compatibility — without experience data, routing is purely rule-based.

cmux 오버라이드 (CMUX_AVAILABLE=yes일 때 ⑤ 이후 적용):

| 기본 추천 | cmux 대체 | 이유 | |-----------|-----------|------| | /team-orchestrate | /cmux-orchestrate | 물리적 계층 + 이기종 AI 팀 | | /multi-ai-run | /cmux-ai-run | 창 분할 진짜 병렬 실행 | | /multi-ai-review | /cmux-ai-review | 패널 나란히 동시 리뷰 |

cmux 감지 시 추천 메시지에 cmux 변형 스킬을 ⭐ 추천으로 올리고, 기존 스킬은 대안으로 제시.

Prerequisite checks each skill performs on its own:

• /team-orchestrate → checks TASKS.md format and Agent Teams installation
• /agile → checks TASKS.md existence/format, recommends team-orchestrate for ≥30 tasks
• /audit → checks for planning documents, guides to /governance-setup if missing
• /governance-setup → guides to /tasks-init or /tasks-migrate based on TASKS.md state

Stage 3: Tailored Recommendation (AskUserQuestion)

Display the diagnosis result with a starred recommendation for user confirmation:

{
  "questions": [{
    "question": "Project state has been analyzed. Choose the next step:",
    "options": [
      { "label": "⭐ [Recommended] {diagnosed skill}", "description": "{reason for fit}" },
      { "label": "{alternative 1}", "description": "{description}" }
    ]
  }]
}

---

Standalone Skill Catalog (25 skills)

| Skill | Trigger | Role | |-------|---------|------| | /workflow | "what should I do?" | Meta hub — skill routing | | /governance-setup | /governance-setup | Governance + Mini-PRD planning | | /tasks-init | /tasks-init | TASKS.md scaffolding | | /tasks-migrate | /tasks-migrate | Consolidate legacy tasks | | /agile | /agile auto | Layer-based sprint execution | | /team-orchestrate | /team-orchestrate, /auto-orchestrate | Unified orchestration — auto/team/thin modes | | /cmux-orchestrate | /cmux-orchestrate | cmux 물리적 3-Level 팀 (Claude/Gemini/Codex 혼합) | | /multi-ai-run | /multi-ai-run | Role-based model routing | | /cmux-ai-run | /cmux-ai-run | cmux 창 분할 병렬 태스크 실행 | | /checkpoint | "review this" | Two-stage review on task completion | | /security-review | /security-review | OWASP Top 10 security scan | | /audit | /audit | Pre-deployment comprehensive audit | | /multi-ai-review | /multi-ai-review | 3-AI consensus review | | /cmux-ai-review | /cmux-ai-review | cmux 창 분할 병렬 3-Stage 리뷰 | | /recover | "work was interrupted" | Work recovery hub | | /impact | /impact | Change impact analysis | | /deps | /deps | Dependency graph | | /coverage | /coverage | Test coverage | | /architecture | /architecture | Architecture map | | /maintenance | "fix this bug" | ITIL 5-stage production maintenance orchestrator | | /compress | "compress context" | Long context optimization | | /statusline | auto-activated | Progress status bar display | | /changelog | /changelog | Change history query | | /cmux | /cmux | cmux 터미널 멀티플렉서 제어 | | /memento | "skill health", "which skill" | Skill ecosystem intelligence — experience logging, smart routing, health dashboard |

---

Skill Selection by Task Scale

| Task count | Recommended skill | Mode | Prerequisite skills | |------------|-------------------|------|---------------------| | 1–30 | /agile auto | — | — | | 30–50 | /team-orchestrate | --mode=auto or --mode=team | /governance-setup (optional) | | 50–200 | /team-orchestrate | --mode=thin | /governance-setup | | 200+ | /team-orchestrate --mode=thin --phase N | split by phase | /governance-setup |

---

Natural Language → Skill Quick Map (GSD 스타일 확장)

"I don't know where to start"          → /workflow
"I have a spec, start coding"          → /agile auto
"Fix this feature"                     → /agile iterate
"Review the code"                      → /checkpoint
"Do a deep review"                     → /multi-ai-review (cmux: /cmux-ai-review)
"Run a security check"                 → /security-review
"Run a quality check"                  → /audit
"Work was interrupted"                 → /recover
"This is a large project"              → /governance-setup
"Fix this bug"                         → /maintenance
"Fix this in production"               → /maintenance
"Run with an agent team"               → /team-orchestrate (cmux: /cmux-orchestrate)
"Use multiple AIs in parallel"         → /cmux-ai-run (cmux 감지 시) / /multi-ai-run
"Show execution status"                → /whitebox status
"Compress the context"                 → /compress
"Which skill works best for this?"     → /memento route
"Show skill performance"               → /memento health
"Why does this skill keep failing?"    → /memento reflect

# GSD 스타일 자연어 라우팅
"이거 리팩토링해줘"         → /agile auto (복잡) 또는 /agile iterate (단순)
"이 기능 추가해줘"          → /discuss → /agile auto
"뭘 어떻게 해야 할지 모르겠어" → /discuss
"결정해야 할 게 있어"        → /discuss
"요구사항 분석해줘"          → /si-planning
"기능정의서 만들어줘"        → /si-planning
"화면정의서 만들어줘"        → /si-planning
"SI 기획 시작"             → /si-planning --domain=?
"요구사항 변경"             → /si-planning --change
"누락 검사"                → /si-planning --gap
"고객 대시보드"             → /si-planning --dashboard
"이거 검증해줘"             → /audit (goal-backward 포함)
"코드 확인해줘"             → /checkpoint
"이거 맞게 했는지 봐줘"      → /audit
"자동으로 다 해줘"          → /team-orchestrate --mode=autonomous
"알아서 해줘"               → /agile auto

자동 라우팅 모드

--auto 플래그 추가 시 사용자 확인 없이 바로 실행:

# 기존
/workflow → 진단 → 추천 → 사용자 확인 → 실행

# --auto 모드
/workflow --auto → 진단 → 바로 실행

---

Reference Documents

For detailed algorithms, skill integration matrix, and quality gates, see:

• references/decision-algorithm.md — Detailed decision algorithm + scenario validation
• references/skill-integrations.md — Skill-to-skill integrations + failure recovery paths

---

Last Updated: 2026-03-18 (v5.1.0 — cmux auto-detection + cmux skill routing added)

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: insightflo
• Source: insightflo/claude-impl-tools
• License: MIT

Install and usage instructions live in the source repository linked above.