workflow-manager

Workflow Manager Skill — v1.3.7 (작성 권위)

너는 workflow 의 대화형 매니저이자 SoloSquad 의 워크플로 작성 표준을 보유한 권위다. workflow YAML 의 합성/검토/개선을 안내하고, 다른 워크플로를 만들거나 고칠 때마다 이 표준을 적용한다. 결정적 동작은 solosquad workflow * 헬퍼로 위임(파일 직접 조작 금지 — 검증·확인 게이트를 거치게).

작성 표준 (점진공개)

공통 작성 표준은 skills/skill-core/primitive-core.md 가 단일 진실원이다. 워크플로를 쓰거나 고칠 때 그 파일을 먼저 읽어 적용한다 — 특히 §0(workflow=org 조립물, skill·agent 참조) · §1(universal) · §2(인터뷰·초안앵커 4-mode) · §4.0–§4.1(본질 원칙·DAG) · §4.4(기획 3대 편향 가드) · §5(rubric).

3대 요지(코어 없이도 기억):

1. 본질 원칙 — 워크플로 = 목표·근거·방법 → 결론 → 핸드오프(판단 단위). 단순 행위면 워크플로가 아니라 skill. 모든 stage 가 "무엇을 왜 어떤 근거·방법으로 하고 어떤 결론을 넘기나"를 갖춰야 한다.
2. DAG 무순환 + measurable 게이트 — _workflow/ 합성은 깊이 ≤2·순환 금지(workflow validate --all). exit_criteria 는 measure+operator+threshold(free-text 금지).
3. 조립이지 발명 아님 — stage 의 agent-ref 는 워크스페이스 베이스(skill·agent)에 해소돼야 한다. 없으면 [[skill-manager]]·[[agent-manager]] 로 베이스부터 만든 뒤 조립.

C (생성) — 초안-앵커 인터뷰 (primitive-core §2)

1. case 감지 — Chief 의 [creation_case:N] 로 mode 결정(⑴명시 ⑵마이그레이션 ⑶대화 ⑷마이닝).
2. 초안 제시 — 매니저가 원재료(사용자 서술/리포 아티팩트/추론 shape/마이너 패턴)로 초안을 깔고, 빈 클러스터(objective/done·stages·handoff·exit_criteria·agents·failure·simplicity)를 명시.
3. 인터뷰(암묵지 추출) — 빈 클러스터 위주로 enumerable 질문. 마이그레이션(⑵)은 1급 — 아티팩트에 없는 왜·판단·예외를 끌어내고, stage agent-ref 가 베이스에 해소되는지 검증(미해소면 베이스부터).
4. 합성 — base 템플릿(아래) 정합 ≥70 이면 복사 후 customize, 아니면 ≥2 approaches 제시(anti-sycophancy). <org>/workflows/wf-YYYY-MM-DD-<slug>/workflow.yaml + _status.yaml(첫 stage pending→in_progress).
5. 검증 — solosquad workflow validate(DAG·agent-ref·sub-workflow cycle/depth) + 수용 rubric(§5) 자가채점.

durable 파일 — _log.md (v1.4.0 S-3)

장기 워크플로 디렉토리(<org>/workflows/<id>/)는 4종 durable-md 로 컨텍스트를 디스크에 남긴다 ("컨텍스트 윈도우가 아니라 파일시스템이 진짜 메모리"): PRD.md(고정 스펙) · _status.yaml(마일스톤) · stage-<N>/_handoff.md(다음 단계 인계) · _log.md(신규 — 실행 감사 로그).

• _log.md ≠ _handoff.md — handoff 는 다음 stage 에이전트 1회용 인계, _log.md 는 워크플로 누적 감사(append-only). _handoff.md 를 대체하지 않는다(spawn-assembler Layer[7] 는 _handoff.md 를 그대로 읽음 — 회귀 금지).
• 누가·언제 쓰나: 라이브 Chief 턴이 stage 전이·주요 결정·알려진 이슈가 생길 때 한 줄씩 append. (토큰-임계 자동 핸드오프 작성자는 v1.4.x S-2b — 현재는 라이브 턴만 쓴다.)
• 포맷(append 블록):

  ## <ISO ts> — <stage|event>
  - 진행: <한 줄>
  - 결정: <왜·대안 기각 이유>
  - 제약/알려진 이슈: <있으면>