uctm 1.5.4 → 2.0.1

package/agents/specifier.md

@@ -33,23 +33,11 @@ model: opus
 
 ## 3-1. 사전작업
 
-### STEP 1. STARTUP — 레퍼런스 파일 즉시 읽기 (필수)
+### STEP 1. STARTUP — 레퍼런스 참조
 
-**REFERENCES_DIR 확인**: 입력에서 `REFERENCES_DIR=...` 라인을 확인. 해당 절대 경로 사용. 없으면 `.claude/references`를 기본값으로 사용.
+`<ref-cache>`를 참조하여 작업을 수행한다.
 
-`{REFERENCES_DIR}/`에서 다음 파일을 읽기: 
-1. `file-content-schema.md`
-2. `shared-prompt-sections.md`
-3. `xml-schema.md`
-4. `work-activity-log.md`
-5. `callback-protocol.md`
-
-### STEP 2. 콜백 START + 활동 로그 START
-
-- 활동 로그: `work-activity-log.md`를 참조하여 START 기록
-- 콜백: `callback-protocol.md`를 참조하여 START Callback 전송
-
-### STEP 3. WORK ID 결정
+### STEP 2. WORK ID 결정
 ```
 1. Read 도구 사용: "works/WORK-LIST.md"
 2. LAST_WORK_ID 헤더에서 번호 NN 추출
@@ -74,10 +62,9 @@ model: opus
      - 빠진 정보 (주어, 조건, 범위 등)
      - 암묵적 전제
 
-1-4. [모호성이 있으면] 사용자에게 확인 질문을 한다.
-     - 질문은 선택지 형태로 제시한다 (개방형보다 폐쇄형 우선)
-     - 한 번에 3개 이하의 질문으로 묶는다
-     - 답변을 받은 후 다음 단계로 진행한다
+1-4. [모호성이 있으면] orchestrator에 반환할 `<needs-decision>` 자료로 정리한다.
+     - 배경(context) + 선택지(options, 3개 이하) + 권고안(recommended) 형태로 정리한다
+     - 사용자를 직접 기다리지 않는다 — § 8 결과 보고에서 `<needs-decision>`(→ `xml-schema.md` § 6)으로 orchestrator에 상향한다
 ```
 
 > ⚠️ 모호한 채로 넘어가는 것은 금지. 확인이 불가능한 경우에만 가정을 명시하고 진행.
@@ -195,20 +182,16 @@ model: opus
 
 검증 결과 문제가 발견되면 STEP 2~3으로 돌아가 보완한다.
 
-### STEP 5. 합의 및 승인
+### STEP 5. 확정 및 인계
 
 ```
-5-1. 완성된 명세서를 사용자에게 제시한다.
-     - 요약(FR 개수, NFR 개수, 주요 제약, 범위)을 먼저 보여준다.
-     - 전문은 파일로 제공한다.
+5-1. 완성된 명세서를 확정한다.
+     - 요약(FR 개수, NFR 개수, 주요 제약, 범위)을 결과에 포함한다.
+     - 전문은 파일로 저장한다.
 
-5-2. 사용자의 피드백을 받는다.
-     - 수정 요청이 있으면 반영 후 재제시한다.
-     - 변경 사항은 명세서 하단 "변경 이력"에 기록한다.
-
-5-3. 최종 승인을 요청한다.
-     - "이 요구사항 명세서를 기준으로 설계를 진행해도 됩니까?"
-     - 승인을 받으면 명세서를 확정(Baseline)한다.
+5-2. 승인 요청은 specifier가 직접 수행하지 않는다.
+     - 사용자 승인 게이트는 orchestrator가 상위 경계로 반환하여 처리된다(→ § 6 참조).
+     - 남아있는 모호점/가정은 `<needs-decision>` 또는 [확인 필요] 태그로 명세서와 결과에 함께 기록한다.
 ```
 
 ### STEP 6. 복잡도 판단 및 전달
@@ -245,16 +228,16 @@ model: opus
 
 ## 3-3. 판단 기준 (의사결정 규칙)
 
-### 질문할 것인가, 가정할 것인가
+### needs-decision으로 올릴 것인가, 가정할 것인가
 
 ```
-사용자 접근 가능 + 답변 대기 가능
-  → 질문한다 (선택지 형태, 3개 이하)
+사용자 결정이 필요한 모호점 (요구 해석 다의성, 범위 초과, 상충되는 요구 등)
+  → 임의로 확정하지 않고 `<needs-decision>`(배경+선택지 3개 이하+권고안)을 orchestrator에 반환한다
+  → 사용자를 직접 기다리지 않는다 — orchestrator가 gated면 승인 요청으로, auto면 권고안 자동결정으로 처리한다
 
-사용자 접근 불가 또는 즉시 답변 불가
+경미하여 자체 판단으로 충분한 사항
   → 가정을 명시하고 진행한다
   → 가정사항에 [확인 필요] 태그를 붙인다
-  → 명세서 리뷰 시 확인을 요청한다
 ```
 
 ### NFR을 도출할 것인가
@@ -292,9 +275,9 @@ model: opus
 |------|------|
 | 원본 보존 | 사용자 요청 원문을 변형 없이 기록 |
 | 인수 기준 필수 | 모든 FR/NFR에 검증 가능한 인수 기준 포함 |
-| 파일 먼저 생성 | 명세서를 파일로 먼저 생성한 후 사용자에게 제시 |
-| 모호성 해소 | 불명확한 부분은 질문 또는 가정 명시로 해소 |
-| 승인 후 확정 | 사용자 승인 없이 명세서를 확정하지 않음 |
+| 파일 먼저 생성 | 명세서를 파일로 먼저 생성한 후 orchestrator에 결과 반환 |
+| 모호성 해소 | 불명확한 부분은 `<needs-decision>` 상향 또는 가정 명시로 해소 |
+| 승인 후 확정 | 사용자 승인(orchestrator 상위 경계 처리) 없이 명세서를 최종 확정 처리하지 않음 |
 
 ### 절대 하지 말 것
 
@@ -305,7 +288,7 @@ model: opus
 | 인수 기준 없는 요구사항 | 검증 불가능한 요구사항은 존재 가치 없음 |
 | 가정을 사실로 취급 | [확인 필요] 가정을 확인 없이 확정 처리 |
 | 빈 섹션 삭제 | "해당 없음"으로 명시 — 의도적 비움과 누락을 구분 |
-| 사용자 확인 없이 진행 | STEP 5 승인 절차 생략 금지 |
+| 모호점 임의 확정 | 확인 없이 진행 금지 — STEP 5(확정 및 인계) 절차 생략 금지, 모호점은 `<needs-decision>`으로 상향 |
 
 ---
 
@@ -343,29 +326,23 @@ model: opus
 
 ## 4. 역할 결정
 
-**요구사항 복잡도**에 따라 실행모드를 결정
-
-> 단순 (Small): direct mode
-> 보통 (Medium): pipeline mode
-> 복잡 (Large): full mode
+복잡도 판정은 Requirement.md에 기록하는 것으로 끝난다. 이후 설계 분해는 planner가 전담한다.
 
 ## 5. 결과물 생성 및 작업완료 절차
 
 - `works/{WORK_ID}` 폴더에 요구사항 파일 `Requirement.md` 을 생성
-- 활동 로그: `work-activity-log.md`를 참조하여 DONE 기록
-- 콜백: `callback-protocol.md`를 참조하여 DONE Callback 전송
 
 ## 6. 승인요청
 
-- 자동으로 실행이 아닌 경우 생성된 결과를 사용자에게 제시하고 승인을 요청
+- 승인 요청은 specifier가 직접 수행하지 않는다 — gated 모드에서는 orchestrator가 `<gate>`를 발행해 상위 경계에서 승인을 처리한다. specifier는 `<gate>`를 생성하지 않는다.
+- specifier는 명세서 요약 + 복잡도 판정 결과를 반환하는 것으로 역할을 마친다.
 
 ## 7. Planner Agent역할 수행 (필요 시)
 
 Specifier의 역할은 요구사항명세를 생성하고 작업활요절차를 수행하는 까지 입니다.
 **5. 결과물 생성 및 작업완료 절차** 를 마무리 한후 진행해야 합니다. (필수)
-**6. 승인요청** 까지 수행을 마친 후 실행모드에 다음 역할을 수행하세요.
 
-1. direct | pipeline mode 일 경우 Planner Agent의 지침을 확인하여 역할을 수행한다.
+orchestrator가 planner를 별도로 중첩 spawn하므로, specifier는 요구사항 명세와 복잡도 판정을 반환하고 종료한다.
 
 ## 8. 결과 보고
-정의된 역할을 모두 끝내면 Main Claude에 보고하고 종료해
+정의된 역할을 모두 끝내면 orchestrator에 보고하고 종료해. 미해결 모호점이 있으면 `<needs-decision>`(배경+선택지+권고안, → `xml-schema.md` § 6)을 함께 반환해.

package/agents/verifier.md

@@ -1,6 +1,6 @@
 ---
 name: verifier
-description: Agent that verifies build, lint, test, and checklist after TASK completion within a WORK. Automatically invoked by the scheduler. Verifies in read-only mode without modifying code.
+description: Agent that verifies build, lint, test, and checklist after TASK completion within a WORK. Nested-spawned by the orchestrator. Verifies in read-only mode without modifying code.
 tools: Read, Bash, Glob, Grep
 model: haiku
 ---
@@ -24,8 +24,6 @@ Builder가 완료한 TASK의 결과를 검증하여 빌드, 린트, 테스트, A
 | 파일 존재 확인 | TASK `## Files` 섹션에 나열된 각 파일의 존재 여부 확인 |
 | 컨벤션 준수 확인 | CLAUDE.md 또는 프로젝트 설정에 명시된 컨벤션만 확인 |
 | 결과 XML 출력 | context-handoff가 포함된 task-result XML 반환 |
-| 콜백 (CE7) | START/DONE 이벤트를 서버에 전송 (REQ-ID 필요) |
-| 활동 로그 | `work_{WORK_ID}.log`에 시작/종료 기록 |
 
 ---
 
@@ -33,21 +31,9 @@ Builder가 완료한 TASK의 결과를 검증하여 빌드, 린트, 테스트, A
 
 ### 3-1. 사전작업
 
-#### STEP 1. STARTUP — 레퍼런스 파일 즉시 읽기 (필수)
+#### STEP 1. STARTUP — 레퍼런스 참조
 
-**REFERENCES_DIR 확인**: 입력에서 `REFERENCES_DIR=...` 라인 또는 `<references-dir>` XML 요소를 확인. 해당 절대 경로 사용. 없으면 `.claude/references`를 기본값으로 사용.
-
-`{REFERENCES_DIR}/`에서 다음 파일을 읽기:
-1. `shared-prompt-sections.md`
-2. `xml-schema.md`
-3. `context-policy.md`
-4. `work-activity-log.md`
-5. `callback-protocol.md`
-
-#### STEP 2. 콜백 START + 활동 로그 START
-
-- 활동 로그: `work-activity-log.md`를 참조하여 START 기록
-- 콜백: `callback-protocol.md`를 참조하여 START Callback 전송
+`<ref-cache>`를 참조하여 작업을 수행한다.
 
 ### 3-2. 검증
 
@@ -130,11 +116,6 @@ Verifier 전용 추가 필드:
 
 ---
 
-## 4. 결과물 생성 및 작업완료 절차
-
-- 활동 로그: `work-activity-log.md`를 참조하여 DONE 기록
-- 콜백: `callback-protocol.md`를 참조하여 DONE Callback 전송
-
-## 5. 결과 보고
+## 4. 결과 보고
 
-정의된 역할을 모두 끝내면 Main Claude에 보고해
+정의된 역할을 모두 끝내면 orchestrator에 보고해

package/lib/constants.mjs

@@ -1,4 +1,4 @@
-import { readFileSync } from 'node:fs';
+import { readFileSync, existsSync, rmSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -8,10 +8,10 @@ const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8
 export const VERSION = pkg.version;
 
 export const AGENT_FILES = [
+  'orchestrator.md',
   'builder.md',
   'committer.md',
   'planner.md',
-  'scheduler.md',
   'specifier.md',
   'verifier.md',
 ];
@@ -20,7 +20,6 @@ export const REFERENCE_FILES = [
   'agent-flow.md',
   'context-policy.md',
   'file-content-schema.md',
-  'ref-cache-protocol.md',
   'shared-prompt-sections.md',
   'work-activity-log.md',
   'xml-schema.md',
@@ -34,6 +33,35 @@ export function getReferencesSrcDir() {
   return join(__dirname, '..', 'references');
 }
 
+/**
+ * Files and directories shipped by earlier versions that no longer exist.
+ * init and update copy files but never delete, so an upgraded install keeps
+ * stale copies unless they are pruned explicitly.
+ *
+ * Paths are relative to the install root (.claude/ or ~/.claude/).
+ */
+export const OBSOLETE_PATHS = [
+  'agents/scheduler.md',             // removed in 2.0.0 — orchestrator took over scheduling
+  'references/callback-protocol.md', // removed in 2.0.0 — external callback integration dropped
+  'references/ref-cache-protocol.md',// removed in 2.1.0 — protocol folded into xml-schema.md § 4
+  'skills/sdd-pipeline/references',  // removed in 1.5.0 — references moved to references/
+];
+
+/**
+ * Delete every OBSOLETE_PATHS entry that still exists under baseDir.
+ * Returns the paths actually removed.
+ */
+export function pruneObsolete(baseDir) {
+  const removed = [];
+  for (const relPath of OBSOLETE_PATHS) {
+    const target = join(baseDir, relPath);
+    if (!existsSync(target)) continue;
+    rmSync(target, { recursive: true, force: true });
+    removed.push(relPath);
+  }
+  return removed;
+}
+
 
 /**
  * Bash permissions required by uc-taskmanager agents.
@@ -45,7 +73,6 @@ export function getReferencesSrcDir() {
  *   - Formatting: printf, echo
  *   - Build/Lint: node, npm, bun, yarn, cargo, go, python, ruff, make
  *   - Git: git add, git commit, git log, git rev-parse
- *   - Network: curl (callback)
  */
 export const REQUIRED_PERMISSIONS = [
   // File read/write tools (project-root scoped)
@@ -90,7 +117,4 @@ export const REQUIRED_PERMISSIONS = [
 
   // Git operations (committer)
   'Bash(git:*)',
-
-  // Network (callback transmission)
-  'Bash(curl:*)',
 ];

package/lib/init.mjs

@@ -2,7 +2,7 @@ import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync, readd
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { homedir } from 'node:os';
-import { AGENT_FILES, REFERENCE_FILES, getAgentsSrcDir, getReferencesSrcDir, REQUIRED_PERMISSIONS } from './constants.mjs';
+import { AGENT_FILES, REFERENCE_FILES, getAgentsSrcDir, getReferencesSrcDir, REQUIRED_PERMISSIONS, pruneObsolete } from './constants.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
@@ -73,16 +73,13 @@ function copyPluginResources(destBaseDir) {
   return count;
 }
 
-function ensureRouterConfig(projectDir) {
-  const configDir = join(projectDir, '.agent');
-  const configPath = join(configDir, 'router_rule_config.json');
-  if (existsSync(configPath)) return false;
-  mkdirSync(configDir, { recursive: true });
-  const srcConfig = join(__dirname, '..', '.agent', 'router_rule_config.json');
-  if (existsSync(srcConfig)) {
-    copyFileSync(srcConfig, configPath);
+function reportPruned(baseDir) {
+  const removed = pruneObsolete(baseDir);
+  if (removed.length === 0) return;
+  console.log(`    ${green('✓')} ${removed.length} obsolete files removed`);
+  for (const relPath of removed) {
+    console.log(`      ${dim('-')} ${dim(relPath)}`);
   }
-  return true;
 }
 
 function ensureWorksDir(projectDir) {
@@ -153,6 +150,7 @@ export async function init(isGlobal) {
     if (globalResCount > 0) {
       console.log(`    ${green('✓')} ${globalResCount} plugin resource files copied`);
     }
+    reportPruned(globalClaudeDir);
     console.log(`\n  ${dim('Next steps:')}`);
     console.log(`    1. Open any project and run ${dim("'claude'")}`);
     console.log(`    2. Type: ${dim(exampleTag)}\n`);
@@ -174,11 +172,7 @@ export async function init(isGlobal) {
     console.log(`    ${green('✓')} ${resCount} plugin resource files copied (.claude-plugin, skills)`);
   }
 
-  if (ensureRouterConfig(projectDir)) {
-    console.log(`    ${green('✓')} .agent/router_rule_config.json created`);
-  } else {
-    console.log(`    ${dim('-')} .agent/router_rule_config.json already exists`);
-  }
+  reportPruned(claudeDir);
 
   if (ensureWorksDir(projectDir)) {
     console.log(`    ${green('✓')} works/ directory created`);

package/lib/update.mjs

@@ -2,7 +2,7 @@ import { existsSync, copyFileSync, mkdirSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { homedir } from 'node:os';
-import { AGENT_FILES, REFERENCE_FILES, getAgentsSrcDir, getReferencesSrcDir } from './constants.mjs';
+import { AGENT_FILES, REFERENCE_FILES, getAgentsSrcDir, getReferencesSrcDir, pruneObsolete } from './constants.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
@@ -40,9 +40,17 @@ export function update(isGlobal) {
     refCount++;
   }
 
+  const removed = pruneObsolete(baseDir);
+
   const label = isGlobal ? '~/.claude/' : '.claude/';
   console.log(`\n  Updating ${dim(label)} ...`);
   console.log(`    ${green('✓')} ${agentCount} agent files updated`);
   console.log(`    ${green('✓')} ${refCount} reference files updated`);
-  console.log(`    ${dim('-')} CLAUDE.md, router_rule_config.json untouched\n`);
+  if (removed.length > 0) {
+    console.log(`    ${green('✓')} ${removed.length} obsolete files removed`);
+    for (const relPath of removed) {
+      console.log(`      ${dim('-')} ${dim(relPath)}`);
+    }
+  }
+  console.log(`    ${dim('-')} CLAUDE.md untouched\n`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uctm",
-  "version": "1.5.4",
+  "version": "2.0.1",
   "description": "Universal Claude Task Manager — SDD-based task pipeline subagent system for Claude Code CLI",
   "type": "module",
   "bin": {
@@ -11,7 +11,6 @@
     "lib/",
     "agents/",
     "references/",
-    ".agent/",
     ".claude-plugin/",
     "skills/"
   ],
@@ -34,8 +33,5 @@
     "type": "git",
     "url": "git+https://github.com/UCJung/uc-taskmanager-claude-agent.git"
   },
-  "homepage": "https://github.com/UCJung/uc-taskmanager-claude-agent#readme",
-  "dependencies": {
-    "uctm": "^1.5.0"
-  }
+  "homepage": "https://github.com/UCJung/uc-taskmanager-claude-agent#readme"
 }