Workflow Commands

기획, 숙의, 감사, 목표 관리, 병렬 팀 오케스트레이션을 위한 슬래시 커맨드입니다. 이 커맨드들은 CLI-JAW의 구조화된 워크플로우 라이프사이클을 구동합니다 -- 초기 아이디어부터 실행과 완료까지.

개요

워크플로우 커맨드는 채팅 인터페이스에서 /를 앞에 붙여 실행합니다. 이 커맨드들은 단일 대화 턴으로는 수행하기 어려운 전문적인 기획 및 오케스트레이션 루틴을 실행합니다. 각 커맨드는 고유한 컨텍스트, 프롬프트, 출력 구조를 가진 전용 워크플로우를 활성화합니다.

/plan [request]

자연어 요청으로부터 구조화된 구현 계획을 생성합니다. 계획에는 단계, 파일 수준 작업, 수락 기준, 위험 요소, 예상 공수가 포함됩니다. 출력은 마크다운 형식이며 /goal로 직접 전달할 수 있습니다.

인자

생성되는 내용

• 문제 정의 -- 어떤 문제를 왜 해결하는지
• 범위 및 비목표 -- 범위 확대를 방지하기 위한 명시적 경계
• 구현 단계 -- 의존성이 포함된 순서화된 단계
• 파일 계획 -- 파일별 생성/수정/삭제 주석
• 수락 기준 -- "완료"를 정의하는 테스트 가능한 조건
• 위험 및 완화 방안 -- 알려진 불확실성과 대안 전략
• 공수 추정 -- 대략적인 시간/복잡도 등급

사용 예시

# Plan a new feature
/plan add SSE-first real-time notifications

# Plan a refactor
/plan refactor the authentication middleware to support multiple providers

# Plan from conversation context (no argument)
/plan

# Plan with constraints
/plan migrate from REST to GraphQL, keep backward compatibility for 2 releases

/interview <request>

구현에 바로 뛰어들기 전에, /interview는 모호한 요구사항을 명확히 하기 위해 1--3개의 목표 지향적 질문을 던집니다. 이를 통해 잘못 이해한 스펙으로 인한 불필요한 작업을 방지하고, 하위 커맨드(/plan, /goal)가 활용할 수 있는 정제된 요구사항 문서를 생성합니다.

인자

동작 방식

1. 분석 -- 요청을 파싱하여 모호한 영역, 암묵적 가정, 누락된 제약 조건을 식별합니다
2. 질문 -- 구현 결정에 미치는 영향도 순으로 정렬된 1--3개의 집중 질문을 생성합니다
3. 정제 -- 답변을 반영하여 정제된 요구사항 요약을 작성합니다
4. 인계 -- 정제된 요구사항은 /plan 또는 /goal set에서 바로 사용할 수 있습니다

사용 예시

# Clarify a vague request
/interview build a notification system

# Clarify with some context already provided
/interview add user roles -- we need admin and viewer at minimum

# Clarify a complex migration
/interview migrate the monolith to microservices

인터뷰에서 생성될 수 있는 일반적인 질문 예시:

1. Should notifications use the SSE-first event channel or polling?
   This affects architecture, infrastructure, and client complexity.

2. What notification channels are in scope -- in-app only, or also
   email/push/SMS?

3. Do notifications need to persist (read/unread state, history) or
   are they ephemeral?

/deliberate <topic>

주제에 대해 구조화된 다중 페르소나 숙의를 실행합니다. 세 가지 내부 페르소나 -- 기획자, 아키텍트, 비평가 -- 가 서로 다른 관점에서 주제를 토론하여, 트레이드오프, 권장 사항, 반대 의견이 포함된 균형 잡힌 분석을 생성합니다.

인자

세 가지 페르소나

출력 구조

• 요약 -- 합의(또는 합의 부재)에 대한 한 문단 요약
• 기획자의 관점 -- 실행 가능성 및 단계 구성 권장 사항
• 아키텍트의 관점 -- 해당되는 경우 다이어그램을 포함한 기술 분석
• 비평가의 관점 -- 반론, 위험 요소, 대안적 접근 방식
• 권장 사항 -- 신뢰 수준 및 주의 사항이 포함된 최종 권장 사항

사용 예시

# Deliberate an architecture decision
/deliberate should we use event sourcing or CRUD for the order service?

# Deliberate a technology choice
/deliberate database migration strategy: PostgreSQL vs CockroachDB for multi-region

# Deliberate a process decision
/deliberate monorepo vs polyrepo for our 5-service backend

# Deliberate with constraints
/deliberate real-time sync approach -- must work offline, team of 2, 3-week deadline

/planaudit [plan]

기존 계획에 대한 읽기 전용 감사를 수행합니다. 계획을 생성하는 /plan과 달리, /planaudit는 계획을 검토합니다 -- 누락 사항, 비현실적인 추정, 놓친 엣지 케이스, 의존성 문제, 범위 위험을 확인합니다. 계획을 수정하지 않으며, 감사 보고서를 생성합니다.

인자

감사 차원

사용 예시

# Audit the current plan in conversation
/planaudit

# Audit a specific plan
/planaudit The plan is: Phase 1 - Set up database schema ...

# Audit after generating a plan
/plan add user authentication
/planaudit

감사 출력 예시:

Plan Audit Report
=================
Overall score: 7/10

[PASS] Completeness -- All stated requirements have corresponding tasks
[WARN] Feasibility  -- Phase 2 estimates 2 days for OAuth integration;
                       typical implementations take 3-5 days
[FAIL] Edge cases   -- No error handling for token refresh failures
[PASS] Scope risk   -- Non-goals clearly stated
[WARN] Testability  -- "Works correctly" is not a measurable criterion;
                       suggest specific test scenarios

/goal set|status|done|cancel|update|history

대화 세션을 넘어 유지되는 영속적 목표를 관리합니다. 목표는 진행 상황을 추적하고, 컨텍스트를 축적하며, 생성부터 완료까지 구조화된 라이프사이클을 제공합니다. 목표 상태는 디스크에 저장되며 대시보드를 통해 인스턴스 간에 동기화됩니다.

하위 커맨드

목표 라이프사이클

  set ──> active ──> done
             │
             ├──> update (repeatable, appends progress)
             │
             └──> cancel (archived)

사용 예시

# Create a goal
/goal set Implement SSE-first notification system with read/unread tracking

# Check progress
/goal status

# Record incremental progress
/goal update Phase 1 complete -- schema and migrations are in place
/goal update Phase 2 in progress -- SSE event publisher done, client pending

# Complete the goal
/goal done

# Cancel a goal that is no longer relevant
/goal cancel 3

# Review all past goals
/goal history

다른 커맨드와의 통합

목표는 다른 워크플로우 커맨드와 자연스럽게 조합됩니다:

# Interview, plan, then set a goal from the refined output
/interview build user authentication
# (answer the clarifying questions)
/plan
/goal set Implement user authentication per refined requirements

# The goal tracks progress as you work
/goal update Auth middleware scaffolded, starting JWT integration
/goal update JWT working, adding refresh token rotation
/goal done

/team plan|audit|status|collect|stop

대규모 작업을 위한 병렬 멀티 에이전트 팀을 오케스트레이션합니다. /team 커맨드는 여러 하위 에이전트를 생성하고, 독립적인 작업 스트림을 할당하며, 진행 상황을 모니터링하고, 결과를 통합된 출력으로 수집합니다.

하위 커맨드

동작 방식

1. 분해 -- /team plan이 요청을 분석하고 병렬로 실행할 수 있는 독립적인 작업 스트림을 식별합니다
2. 할당 -- 각 작업 스트림은 고유한 컨텍스트와 지시 사항을 가진 하위 에이전트에 할당됩니다
3. 실행 -- 에이전트들이 병렬로 실행됩니다. 각 에이전트는 파일 시스템 접근 권한이 있지만 대화 컨텍스트는 공유하지 않습니다
4. 모니터링 -- /team status가 모든 에이전트의 진행 상황 업데이트를 폴링합니다
5. 감사 -- /team audit가 병합 전에 교차 에이전트 충돌을 확인합니다
6. 수집 -- /team collect가 모든 에이전트 출력을 하나의 일관된 결과로 병합합니다

사용 예시

# Refactor 4 API modules in parallel
/team plan Refactor user, order, product, and payment modules to use new BaseService class

# Check how agents are doing
/team status

# Run an audit to catch conflicts
/team audit

# Collect all results when agents finish
/team collect

# Emergency stop
/team stop

실전 워크플로우

# Full team workflow for a large migration
/interview migrate from Express to Hono
# (answer clarifying questions)
/plan
/planaudit
/goal set Migrate Express to Hono

# Execute in parallel
/team plan Migrate Express to Hono -- routes, middleware, tests, docs

# Monitor and audit
/team status
/team audit

# Collect and finalize
/team collect
/goal update Migration complete, all tests passing
/goal done

커맨드 체이닝

워크플로우 커맨드는 조합하도록 설계되었습니다. 일반적인 기능 개발 라이프사이클은 여러 커맨드를 순서대로 연결합니다:

# 1. Clarify requirements
/interview 실시간 알림 시스템 만들어야 돼

# 2. Generate a plan from the refined requirements
/plan

# 3. Audit the plan for gaps
/planaudit

# 4. Deliberate on key design decisions
/deliberate SSE event channel vs polling for our notification delivery

# 5. Set a persistent goal
/goal set Implement real-time notification system (SSE-first)

# 6. Execute with a parallel team (for large tasks)
/team plan Implement notification system -- server, client, tests, docs

# 7. Monitor and collect
/team status
/team collect

# 8. Finalize
/goal update All modules integrated and tested
/goal done

빠른 참조