makdoong2-team 1.4.0 → 1.4.2

package/README.md

@@ -121,25 +121,74 @@ makdoong2-team doctor            # 설치 진단
 
 ### 모델 정책
 
-빌트인 primary 허용 목록은 `github-copilot/*` 와 `local/*` 브랜드 40개다 (전체 목록: `src/model-fallback-policy.ts` 의 `DEFAULT_ALLOWED_PRIMARIES`). fallback 은 **항상 primary 보다 낮은 tier** 여야 한다 (`low < medium < high < max`).
+체인 하나는 `primary` 1개와 **tier 가 더 낮은** `fallbacks` 로 이뤄진다. 7개 에이전트 전부 아래 빌트인 기본값을 쓴다.
+
+```jsonc
+// src/model-fallback-policy.ts 의 POLICIES — 7개 에이전트가 모두 동일하다
+"makdoong2-engineer": {
+  "primary":   { "id": "github-copilot/gpt-5.6-luna",     "variant": "xhigh", "tier": "medium" },
+  "fallbacks": [{ "id": "github-copilot/claude-haiku-4.5",                    "tier": "low"    }]
+}
+```
+
+| 필드 | 의미 | 설정 키 |
+|---|---|---|
+| `id` | `provider/model`. primary 는 허용 목록 안이어야 한다 — 빌트인 `github-copilot/*` · `local/*` 40개 (`DEFAULT_ALLOWED_PRIMARIES`) + `allowed_primaries` 확장분 | `agents.<agent>.model`, `fallback_models[].id` |
+| `variant` | 추론 강도 `low` · `medium` · `high` · `xhigh` · `max`. **primary 에만** 쓰이고 opencode agent 설정으로 그대로 주입된다 | `agents.<agent>.variant` |
+| `tier` | 폴백 순서 invariant 전용 등급 (`low < medium < high < max`). fallback 은 **항상 primary 보다 낮아야** 한다 | `fallback_models[].tier` |
+
+primary 의 `tier` 는 설정으로 바꿀 수 없다 — 빌트인 값이 유지되고, 빌트인에 없는 새 에이전트는 `medium` 이 된다.
+
+오버라이드 예시:
 
 ```jsonc
 {
   "model_policy": {
+    // 빌트인 허용 목록에 없는 primary 를 쓸 때만 필요하다 (추가 전용 — 빈 배열은 "추가 없음")
     "allowed_primaries": ["custom-provider/custom-model"]
   },
   "agents": {
+    // primary · variant · fallback 을 모두 지정
     "makdoong2-engineer": {
       "model": "github-copilot/claude-opus-4.8",
+      "variant": "high",
       "fallback_models": [
         { "id": "github-copilot/claude-haiku-4.5", "tier": "low" }
       ]
-    }
+    },
+
+    // model 만 적으면 variant 와 fallback 체인은 빌트인 값을 승계한다
+    "makdoong2-planner": { "model": "github-copilot/gpt-5.6-sol" },
+
+    // variant 만 낮추고 싶어도 model 은 반드시 함께 적는다 — model 없는 항목은 통째로 무시된다
+    "makdoong2-verifier": { "model": "github-copilot/gpt-5.6-luna", "variant": "medium" }
   }
 }
 ```
 
-`makdoong2-team validate` 로 위반 여부와 최종 체인을 미리 확인할 수 있다. 위반 시 플러그인은 defaults 로 롤백하고 stderr 에 경고만 남긴다 — 설정 오류로 워크플로우가 죽지 않는다.
+`makdoong2-team validate` 로 위반 여부와 최종 체인을 미리 확인할 수 있다. 위 설정의 실제 출력이다.
+
+```console
+$ makdoong2-team validate
+[makdoong2-team] validate — ~/.config/opencode/makdoong2-team.json
+  ✓ JSON parses
+  ✓ policy invariants pass (primary allow-list + fallback tier ordering)
+  ✓ overrides applied for: makdoong2-engineer, makdoong2-planner, makdoong2-verifier
+  ✓ extra allowed primaries: custom-provider/custom-model
+
+Resolved chain (primary → fallbacks):
+  makdoong2-team-leader      github-copilot/gpt-5.6-luna (medium) → github-copilot/claude-haiku-4.5 (low)
+  makdoong2-analyzer         github-copilot/gpt-5.6-luna (medium) → github-copilot/claude-haiku-4.5 (low)
+  makdoong2-researcher       github-copilot/gpt-5.6-luna (medium) → github-copilot/claude-haiku-4.5 (low)
+  makdoong2-planner          github-copilot/gpt-5.6-sol (medium) → github-copilot/claude-haiku-4.5 (low)
+  makdoong2-engineer         github-copilot/claude-opus-4.8 (medium) → github-copilot/claude-haiku-4.5 (low)
+  makdoong2-publisher        github-copilot/gpt-5.6-luna (medium) → github-copilot/claude-haiku-4.5 (low)
+  makdoong2-verifier         github-copilot/gpt-5.6-luna (medium) → github-copilot/claude-haiku-4.5 (low)
+
+[makdoong2-team] validate: OK ✓
+```
+
+위반 시 플러그인은 defaults 로 롤백하고 stderr 에 경고만 남긴다 — 설정 오류로 워크플로우가 죽지 않는다.
 
 ### 로깅
 
@@ -180,7 +229,7 @@ makdoong2-team doctor            # 설치 진단
 2. `src/opencode-plugin.ts` — `STAGE_ORDER` 배열에 삽입
 3. `stages/NN-<name>.md` — 신규 spec 작성
 4. `agents/makdoong2-<role>.md` + `gates/verify.sh` (+ 전용 `stage*-verify.sh`)
-5. README 매핑표 · `AGENTS.md` sealed workflow 규약 갱신
+5. README 매핑표 · `CLAUDE.md` sealed workflow 규약 갱신
 
 이후 `makdoong2-team validate` → `npm test` 로 회귀를 확인한다.
 
@@ -231,7 +280,7 @@ npm run release:major   # 1.3.1 → 2.0.0  (breaking)
 |---|---|
 | [ARCHITECTURE.md](./ARCHITECTURE.md) | **어떻게 동작하는가** — 모듈, 툴 API, state 스키마, 훅, 런타임 방어, 실패 모드 |
 | [DESIGN.md](./DESIGN.md) | **왜 이렇게 만들었는가** — 하네스 4기둥 (Constrain / Inform / Verify / Correct) 과 트레이드오프 |
-| [AGENTS.md](./AGENTS.md) | **개발 규약** — git commit, npm 배포, sealed workflow, state.sh 하드룰 |
+| [CLAUDE.md](./CLAUDE.md) | **개발 규약** — git commit, npm 배포, sealed workflow, state.sh 하드룰 |
 
 ## 라이선스
 

package/agents/makdoong2-planner.md

@@ -85,7 +85,7 @@ bash <SCRIPTS_DIR>/state.sh get {ISSUE_KEY} '.stages."1_planning".substages."jir
 
 이미 완료된 하위 작업(done 마커, research 완료 등)이 있으면 건너뛰고 미완 지점부터 재개한다.
 
-> **⚠️ state.json 스키마 규약 (반드시 준수):** state.sh 의 모든 jq path 는 hierarchical 표기 `.stages."<PHASE>".substages."<SUBSTAGE>".<field>` 를 사용한다. flat 표기 `.stages."<PHASE>.<SUBSTAGE>"` 는 phantom 키를 만들어 verifier·auto_advance 를 무력화한다. state.sh 훅이 flat 표기 write 를 물리 차단한다. (참조: AGENTS.md "워크플로우 상태 & 위임 규약")
+> **⚠️ state.json 스키마 규약 (반드시 준수):** state.sh 의 모든 jq path 는 hierarchical 표기 `.stages."<PHASE>".substages."<SUBSTAGE>".<field>` 를 사용한다. flat 표기 `.stages."<PHASE>.<SUBSTAGE>"` 는 phantom 키를 만들어 verifier·auto_advance 를 무력화한다. state.sh 훅이 flat 표기 write 를 물리 차단한다. (참조: CLAUDE.md "워크플로우 상태 & 위임 규약")
 
 ### 0-exit. 타깃 substage 가 이미 완료된 경우 (필수 — 최우선 체크)
 

package/agents/makdoong2-team-leader.md

@@ -72,7 +72,7 @@ permission:
    ```
 3. `hang_history` 배열 길이 ≥ 3 이면 **적극 개입 신호**. 다음 substage 진입 전 사용자에게 반드시 다음을 보고하고 진행 승인을 받는다:
    ```
-   ⚠️  LLM 서버 hang 반복 (<N>회). local/qwen3.6-27b 인퍼런스 서버 상태 확인 필요.
+   ⚠️  LLM 서버 hang 반복 (<N>회). github-copilot/gpt-5.6-luna 모델 응답 상태 확인 필요.
         계속 진행할지, get_fallback_model 로 fallback 모델 시도할지 결정 부탁드립니다.
    ```
 4. `dispatch_stage` 최종 응답에 `outcome_kind: "session_gone"` 이 포함된 경우 (MAX_ATTEMPTS 소진): 위 규약과 무관하게 즉시 사용자 보고 후 대기.

package/agents/makdoong2-verifier.md

@@ -87,7 +87,7 @@ bash <SCRIPTS_DIR>/state.sh get <이슈키> '.stages."2_implementation".substage
 
 기대: 모든 항목(boolean)이 `true`인 JSON 객체. 누락·`false`·문법 오류 = **REJECTED**.
 
-> **⚠️ 스키마 규약:** state.sh 의 모든 jq path 는 `.stages."<PHASE>".substages."<SUBSTAGE>".<field>` 형태를 따른다. 참조: AGENTS.md "워크플로우 상태 & 위임 규약".
+> **⚠️ 스키마 규약:** state.sh 의 모든 jq path 는 `.stages."<PHASE>".substages."<SUBSTAGE>".<field>` 형태를 따른다. 참조: CLAUDE.md "워크플로우 상태 & 위임 규약".
 
 ### 2. 단계 명세 재대조
 

package/dist/model-fallback-policy.js

@@ -61,37 +61,37 @@ const TIER_RANK = { low: 1, medium: 2, high: 3, max: 4 };
 export function tierRank(tier) {
     return TIER_RANK[tier];
 }
-// Default chains. All agents now use local/qwen3.6-27b as primary (medium tier).
+// Default chains. All agents now use github-copilot/gpt-5.6-luna (variant xhigh) as primary (medium tier).
 // Fallback chain degrades to strictly lower tier. Override per-agent via 
 // makdoong2-team.json `agents` block.
 export const POLICIES = {
     "makdoong2-team-leader": {
-        primary: { id: "local/qwen3.6-27b", variant: "high", tier: "medium" },
+        primary: { id: "github-copilot/gpt-5.6-luna", variant: "xhigh", tier: "medium" },
         fallbacks: [{ id: "github-copilot/claude-haiku-4.5", tier: "low" }],
     },
     "makdoong2-analyzer": {
-        primary: { id: "local/qwen3.6-27b", variant: "high", tier: "medium" },
+        primary: { id: "github-copilot/gpt-5.6-luna", variant: "xhigh", tier: "medium" },
         fallbacks: [{ id: "github-copilot/claude-haiku-4.5", tier: "low" }],
     },
     // Research fan-out worker — one session per source, spawned in parallel.
     "makdoong2-researcher": {
-        primary: { id: "local/qwen3.6-27b", variant: "high", tier: "medium" },
+        primary: { id: "github-copilot/gpt-5.6-luna", variant: "xhigh", tier: "medium" },
         fallbacks: [{ id: "github-copilot/claude-haiku-4.5", tier: "low" }],
     },
     "makdoong2-planner": {
-        primary: { id: "local/qwen3.6-27b", variant: "high", tier: "medium" },
+        primary: { id: "github-copilot/gpt-5.6-luna", variant: "xhigh", tier: "medium" },
         fallbacks: [{ id: "github-copilot/claude-haiku-4.5", tier: "low" }],
     },
     "makdoong2-engineer": {
-        primary: { id: "local/qwen3.6-27b", variant: "high", tier: "medium" },
+        primary: { id: "github-copilot/gpt-5.6-luna", variant: "xhigh", tier: "medium" },
         fallbacks: [{ id: "github-copilot/claude-haiku-4.5", tier: "low" }],
     },
     "makdoong2-publisher": {
-        primary: { id: "local/qwen3.6-27b", variant: "high", tier: "medium" },
+        primary: { id: "github-copilot/gpt-5.6-luna", variant: "xhigh", tier: "medium" },
         fallbacks: [{ id: "github-copilot/claude-haiku-4.5", tier: "low" }],
     },
     "makdoong2-verifier": {
-        primary: { id: "local/qwen3.6-27b", tier: "medium" },
+        primary: { id: "github-copilot/gpt-5.6-luna", variant: "xhigh", tier: "medium" },
         fallbacks: [{ id: "github-copilot/claude-haiku-4.5", tier: "low" }],
     },
 };

package/dist/opencode-plugin.js

@@ -980,7 +980,7 @@ export const Makdoong2TeamPlugin = async ({ $, client, directory, worktree }) =>
                         `• 다른 substage 작업 필요 시: 결과·스펙을 team-leader에게 반환하면 team-leader가 dispatch_stage로 라우팅.\n` +
                         `• 상태 공유: \`state.sh set\` 으로 state.json 마커에 기록. team-leader가 읽어서 다음 단계 결정.\n\n` +
                         `**아키텍처 원칙:** 각 substage는 self-contained. Inter-substage 의존은 team-leader 오케스트레이션을 통해서만 흐르며, ` +
-                        `agent-to-agent 직접 호출은 금지된다. 참조: AGENTS.md "워크플로우 상태 & 위임 규약".`);
+                        `agent-to-agent 직접 호출은 금지된다. 참조: CLAUDE.md "워크플로우 상태 & 위임 규약".`);
                 }
             }
             else if (agent && SEALED_SUBAGENTS.has(agent) && DELEGATION_LIKE_NAME.test(toolLower) && !KNOWN_SAFE_TOOLS.has(toolLower)) {
@@ -1040,7 +1040,7 @@ export const Makdoong2TeamPlugin = async ({ $, client, directory, worktree }) =>
                     `• Planning 단계 (planner): "무엇을 만들지" 결정만. 실제 파일 생성은 implementation 단계로 위임.\n` +
                     `• Analysis 단계 (analyzer): workspace-analysis.json 1개만 생성 가능 (Write 툴 사용).\n` +
                     `• 초안 파일 필요 시: spec을 team-leader에게 반환 → dev 단계에서 engineer가 구현.\n\n` +
-                    `**참조**: agents/${agent}.md "금지" 섹션, AGENTS.md "워크플로우 상태 & 위임 규약"`);
+                    `**참조**: agents/${agent}.md "금지" 섹션, CLAUDE.md "워크플로우 상태 & 위임 규약"`);
             }
             const hookIssue = sessionIssue.get(sessionID ?? "") ?? "";
             const r = await runScript(HOOKS_DIR, "guard-bash.sh", cmd, hookIssue);

package/dist/poll-sub-session.js

@@ -5,7 +5,7 @@
 // client. The plugin passes its real `client` at call sites; tests inject a
 // scripted mock via the same shape.
 //
-// Design invariants (see AGENTS.md and Oracle diagnosis for rationale):
+// Design invariants (see CLAUDE.md and Oracle diagnosis for rationale):
 //   INV-1: `!status` alone must never mean "idle". A missing status entry can
 //          equally mean "session not registered yet" or "session cleaned up".
 //          Idle is confirmed only by `status.type === "idle"` AFTER we have

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "makdoong2-team",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "publishConfig": {
     "access": "public"
   },

package/scripts/lint-agent-prompts.sh

@@ -63,7 +63,7 @@ echo "$matches" | while IFS=: read -r file line rest; do
 done
 
 cat >&2 <<EOF
-state.json 스키마 규약 (AGENTS.md "state.json 스키마 규약 (hardrule)" 참조):
+state.json 스키마 규약 (CLAUDE.md "state.json 스키마 규약 (hardrule)" 참조):
   hierarchical : .stages."<PHASE>".substages."<SUBSTAGE>".<field>
   flat (금지)  : .stages."<PHASE>.<SUBSTAGE>".<field>
 

package/scripts/model-policy.mjs

@@ -60,32 +60,32 @@ export const TIER_RANK = { low: 1, medium: 2, high: 3, max: 4 };
 // agent-stage-config.ts (team-leader + planner/engineer/publisher/verifier).
 export const DEFAULT_POLICIES = Object.freeze({
   "makdoong2-team-leader": {
-    primary:   { id: "local/qwen3.6-27b",                    variant: "high",   tier: "medium" },
+    primary:   { id: "github-copilot/gpt-5.6-luna",          variant: "xhigh",  tier: "medium" },
     fallbacks: [{ id: "github-copilot/claude-haiku-4.5",                         tier: "low" }],
   },
   "makdoong2-analyzer": {
-    primary:   { id: "local/qwen3.6-27b",                    variant: "high",   tier: "medium" },
+    primary:   { id: "github-copilot/gpt-5.6-luna",          variant: "xhigh",  tier: "medium" },
     fallbacks: [{ id: "github-copilot/claude-haiku-4.5",                         tier: "low" }],
   },
   // Research fan-out worker — one session per source, spawned in parallel.
   "makdoong2-researcher": {
-    primary:   { id: "local/qwen3.6-27b",                    variant: "high",   tier: "medium" },
+    primary:   { id: "github-copilot/gpt-5.6-luna",          variant: "xhigh",  tier: "medium" },
     fallbacks: [{ id: "github-copilot/claude-haiku-4.5",                         tier: "low" }],
   },
   "makdoong2-planner": {
-    primary:   { id: "local/qwen3.6-27b",                    variant: "high",   tier: "medium" },
+    primary:   { id: "github-copilot/gpt-5.6-luna",          variant: "xhigh",  tier: "medium" },
     fallbacks: [{ id: "github-copilot/claude-haiku-4.5",                         tier: "low" }],
   },
   "makdoong2-engineer": {
-    primary:   { id: "local/qwen3.6-27b",                    variant: "medium", tier: "medium" },
+    primary:   { id: "github-copilot/gpt-5.6-luna",          variant: "xhigh",  tier: "medium" },
     fallbacks: [{ id: "github-copilot/claude-haiku-4.5",                         tier: "low" }],
   },
   "makdoong2-publisher": {
-    primary:   { id: "local/qwen3.6-27b",                    variant: "high",   tier: "medium" },
+    primary:   { id: "github-copilot/gpt-5.6-luna",          variant: "xhigh",  tier: "medium" },
     fallbacks: [{ id: "github-copilot/claude-haiku-4.5",                         tier: "low" }],
   },
   "makdoong2-verifier": {
-    primary:   { id: "local/qwen3.6-27b",                                        tier: "medium" },
+    primary:   { id: "github-copilot/gpt-5.6-luna",          variant: "xhigh",  tier: "medium" },
     fallbacks: [{ id: "github-copilot/claude-haiku-4.5",                         tier: "low" }],
   },
 });

package/scripts/smoke-test.mjs

@@ -36,8 +36,8 @@ console.log("\n[smoke-test] model-fallback-policy chain logic\n");
 
 // ── Default chain semantics ──
 
-t("makdoong2-team-leader: qwen → haiku on first failure", () => {
-  const r = nextModel({ agent: "makdoong2-team-leader", current: "local/qwen3.6-27b", reason: "rate_limit" });
+t("makdoong2-team-leader: gpt-5.6-luna → haiku on first failure", () => {
+  const r = nextModel({ agent: "makdoong2-team-leader", current: "github-copilot/gpt-5.6-luna", reason: "rate_limit" });
   eq(r.exhausted, false, "should not be exhausted");
   eq(r.next.id, "github-copilot/claude-haiku-4.5", "next should be haiku-4.5");
 });
@@ -48,23 +48,23 @@ t("makdoong2-team-leader: haiku → exhausted after second failure", () => {
   eq(r.next, null, "next should be null");
 });
 
-t("makdoong2-planner: qwen → haiku", () => {
-  const r = nextModel({ agent: "makdoong2-planner", current: "local/qwen3.6-27b", reason: "5xx" });
+t("makdoong2-planner: gpt-5.6-luna → haiku", () => {
+  const r = nextModel({ agent: "makdoong2-planner", current: "github-copilot/gpt-5.6-luna", reason: "5xx" });
   eq(r.next.id, "github-copilot/claude-haiku-4.5", "planner fallback should be haiku");
 });
 
-t("makdoong2-engineer: qwen → haiku (lower-tier degrade)", () => {
-  const r = nextModel({ agent: "makdoong2-engineer", current: "local/qwen3.6-27b", reason: "context_exceeded" });
+t("makdoong2-engineer: gpt-5.6-luna → haiku (lower-tier degrade)", () => {
+  const r = nextModel({ agent: "makdoong2-engineer", current: "github-copilot/gpt-5.6-luna", reason: "context_exceeded" });
   eq(r.next.id, "github-copilot/claude-haiku-4.5", "engineer fallback should be haiku");
 });
 
-t("makdoong2-publisher: qwen → haiku", () => {
-  const r = nextModel({ agent: "makdoong2-publisher", current: "local/qwen3.6-27b" });
+t("makdoong2-publisher: gpt-5.6-luna → haiku", () => {
+  const r = nextModel({ agent: "makdoong2-publisher", current: "github-copilot/gpt-5.6-luna" });
   eq(r.next.id, "github-copilot/claude-haiku-4.5", "publisher fallback should be haiku");
 });
 
-t("makdoong2-verifier: qwen → haiku", () => {
-  const r = nextModel({ agent: "makdoong2-verifier", current: "local/qwen3.6-27b" });
+t("makdoong2-verifier: gpt-5.6-luna → haiku", () => {
+  const r = nextModel({ agent: "makdoong2-verifier", current: "github-copilot/gpt-5.6-luna" });
   eq(r.next.id, "github-copilot/claude-haiku-4.5", "verifier fallback should be haiku");
 });
 
@@ -75,7 +75,7 @@ t("unknown agent returns exhausted", () => {
 
 t("unknown current model starts from primary", () => {
   const r = nextModel({ agent: "makdoong2-team-leader", current: "anthropic/claude-fictional" });
-  eq(r.next.id, "local/qwen3.6-27b", "unknown current should start at primary");
+  eq(r.next.id, "github-copilot/gpt-5.6-luna", "unknown current should start at primary");
 });
 
 t("all default primaries are in DEFAULT_ALLOWED_PRIMARIES", () => {