@wooojin/forgen 0.4.13 → 0.5.5

package/dist/store/host-mismatch.js

@@ -15,19 +15,19 @@ import { loadAllEvidence } from './evidence-store.js';
 const DOMINANCE_THRESHOLD = 0.8; // 80% 이상이 한 host 에서 발생하면 dominant.
 const MIN_TOTAL_FOR_DEMOTE = 5; // 너무 적은 표본은 무시.
 function summarize(events) {
-    const byHost = { claude: 0, codex: 0 };
+    const byHost = { claude: 0, codex: 0, opencode: 0 };
     for (const e of events) {
         const h = (e.host ?? 'claude');
         byHost[h] += 1;
     }
-    const total = byHost.claude + byHost.codex;
+    // host-agnostic 집계 — 새 host 추가 시 이 로직은 수정 불필요.
+    const entries = Object.entries(byHost);
+    const total = entries.reduce((s, [, n]) => s + n, 0);
     if (total === 0) {
         return { byHost, total, skew: 0, dominantHost: null, demoteRecommended: false };
     }
-    const claudeShare = byHost.claude / total;
-    const codexShare = byHost.codex / total;
-    const dominant = claudeShare >= codexShare ? 'claude' : 'codex';
-    const skew = Math.max(claudeShare, codexShare);
+    const [dominant, dominantCount] = entries.reduce((max, cur) => (cur[1] > max[1] ? cur : max));
+    const skew = dominantCount / total;
     const demoteRecommended = total >= MIN_TOTAL_FOR_DEMOTE && skew >= DOMINANCE_THRESHOLD;
     return { byHost, total, skew, dominantHost: dominant, demoteRecommended };
 }
@@ -53,10 +53,10 @@ export function summarizeNegativeSignalsForRef(refId) {
 }
 export function summarizeAllByHost() {
     const all = loadAllEvidence();
-    const r = { claude: 0, codex: 0 };
+    const r = { claude: 0, codex: 0, opencode: 0 };
     for (const e of all)
         r[(e.host ?? 'claude')] += 1;
-    return { ...r, total: r.claude + r.codex };
+    return { ...r, total: r.claude + r.codex + r.opencode };
 }
 /** 테스트 노출용 — 임계값이 변경되면 회귀 즉시 감지. */
 export const HOST_MISMATCH_TUNING = {

package/dist/store/profile-store.d.ts

@@ -5,6 +5,7 @@
  * Authoritative schema: docs/plans/2026-04-03-forgen-data-model-storage-spec.md §2
  */
 import type { Profile, QualityPack, AutonomyPack, JudgmentPack, CommunicationPack, TrustPolicy } from './types.js';
+import type { HostId } from '../core/trust-layer-intent.js';
 export declare function createProfile(userId: string, qualityPack: QualityPack, autonomyPack: AutonomyPack, trustPolicy: TrustPolicy, trustSource: Profile['trust_preferences']['source'], judgmentPack?: JudgmentPack, communicationPack?: CommunicationPack): Profile;
 export declare function loadProfile(): Profile | null;
 export declare function loadProfileRaw(): unknown;
@@ -50,7 +51,7 @@ export declare function bumpAxisConfidence(axis: 'quality_safety' | 'autonomy' |
  * fgx / forgen 무인자 실행 시 어느 host 를 spawn 할지 결정. 'ask' 면 매번 묻기.
  * 미설정(undefined) 은 legacy 사용자 호환 — 'claude' 로 resolve.
  */
-export type DefaultHost = 'claude' | 'codex' | 'ask';
+export type DefaultHost = HostId | 'ask';
 export declare function getDefaultHost(): DefaultHost | undefined;
 export declare function setDefaultHost(host: DefaultHost): boolean;
 /**
@@ -58,4 +59,4 @@ export declare function setDefaultHost(host: DefaultHost): boolean;
  * 우선순위: explicit override > profile.default_host > 'claude' fallback.
  * 'ask' 는 caller 가 별도 처리 (interactive prompt).
  */
-export declare function resolveDefaultHost(override?: 'claude' | 'codex'): 'claude' | 'codex' | 'ask';
+export declare function resolveDefaultHost(override?: HostId): DefaultHost;

package/dist/store/rule-store.d.ts

@@ -33,6 +33,23 @@ export declare function appendRule(rule: Rule): Promise<{
 export declare function loadRule(ruleId: string): Rule | null;
 export declare function loadAllRules(): Rule[];
 export declare function loadActiveRules(): Rule[];
+/**
+ * render_key(+source, +scope)로 기존 rule을 찾는다 — status 무관(active/suppressed/removed/
+ * superseded 전부 포함). ADR-013 채굴 룰 재생성 결함 수정(RCA): promoteSessionCandidates가
+ * loadActiveRules() 로만 dedup 하다 보니 TTL/cap 로 은퇴(removed)된 render_key가 재차 채굴되면
+ * "없음" 으로 오판해 매번 새 rule_id + created_at=now 로 재생성 — 이게 6,701개 파일 중
+ * 6,525개가 removed 로 죽어 쌓인 근본 원인. 이 함수로 upsert identity 를 render_key 로
+ * 고정한다: 있으면 재활성화, 없을 때만 신규 생성.
+ *
+ * scope 필터가 필요한 이유: processCorrection()(evidence-processor.ts)이 fix-now/avoid-this
+ * 에 대해 scope:'session' 임시 rule 을 만들 때 *같은 render_key 공식*(`${axis}.${target-slug}`)
+ * 을 쓴다. scope 를 안 걸면 promoteSessionCandidates 가 그 임시 rule 을 "기존 me rule" 로
+ * 오인해 재활성화해버려 영구 승격이 아예 안 되는 회귀가 생긴다(실측: 회귀 테스트로 발견).
+ *
+ * 동일 render_key 매칭이 여럿(레거시 데이터 등 이례적 상황)이면 active 우선, 그다음
+ * updated_at 최신순으로 하나만 반환.
+ */
+export declare function findRuleByRenderKey(renderKey: string, source?: RuleSource, scope?: RuleScope): Rule | null;
 /**
  * ADR-002 Meta signal — rule 들이 프롬프트에 inject 되었음을 기록.
  * rule.lifecycle.inject_count +1, last_inject_at = now.
@@ -45,4 +62,28 @@ export declare function updateRuleStatus(ruleId: string, status: RuleStatus): bo
  * 현재 세션 ID와 다른 scope:'session' 규칙을 비활성화.
  * 이전 세션의 임시 규칙이 새 세션에서 영향을 미치지 않도록 정리.
  */
+/** status:'removed' rule 파일 정리 결과. */
+export interface PruneResult {
+    /** retention 기간을 지나 삭제 대상인 rule_id (dry-run/apply 공통). */
+    candidates: string[];
+    /** apply=true 일 때 실제 unlink 된 rule_id (dry-run 이면 항상 빈 배열). */
+    deleted: string[];
+}
+/** removed 룰 보관 기간 기본값 — 7일. TTL 로 은퇴된 지 이만큼 지나면 prune 대상. */
+export declare const DEFAULT_PRUNE_RETENTION_MS: number;
+/**
+ * status:'removed' 파일을 retention 기간이 지난 것만 실제 unlink.
+ * RCA: retire(updateRuleStatus)는 status flip만 하고 파일을 지우지 않아 6,525개 죽은
+ * 파일이 ~/.forgen/me/rules 에 쌓여 loadAllRules() linear scan 비용을 키우고
+ * cross-process race 창을 넓혔다. status 전이 시각(updated_at) 기준으로 retention을
+ * 재는 이유: removed 직후 즉시 지우면 (a) findRuleByRenderKey 가 재활성화할 기회를
+ * 없애고 (b) 오탐 은퇴를 되돌릴 유예가 사라진다.
+ *
+ * 기본 dry-run(apply=false) — 프로덕션 데이터 삭제는 호출측이 명시적으로 apply:true
+ * 를 넘길 때만. (compound-sweep-cli 의 `--prune-removed`는 `--apply` 없으면 dry-run.)
+ */
+export declare function pruneRemovedRules(opts?: {
+    retentionMs?: number;
+    apply?: boolean;
+}): PruneResult;
 export declare function cleanupStaleSessionRules(_currentSessionId: string): number;

package/dist/store/rule-store.js

@@ -160,6 +160,37 @@ function resolveProjectRulesDir() {
 export function loadActiveRules() {
     return loadAllRules().filter(r => r.status === 'active');
 }
+/**
+ * render_key(+source, +scope)로 기존 rule을 찾는다 — status 무관(active/suppressed/removed/
+ * superseded 전부 포함). ADR-013 채굴 룰 재생성 결함 수정(RCA): promoteSessionCandidates가
+ * loadActiveRules() 로만 dedup 하다 보니 TTL/cap 로 은퇴(removed)된 render_key가 재차 채굴되면
+ * "없음" 으로 오판해 매번 새 rule_id + created_at=now 로 재생성 — 이게 6,701개 파일 중
+ * 6,525개가 removed 로 죽어 쌓인 근본 원인. 이 함수로 upsert identity 를 render_key 로
+ * 고정한다: 있으면 재활성화, 없을 때만 신규 생성.
+ *
+ * scope 필터가 필요한 이유: processCorrection()(evidence-processor.ts)이 fix-now/avoid-this
+ * 에 대해 scope:'session' 임시 rule 을 만들 때 *같은 render_key 공식*(`${axis}.${target-slug}`)
+ * 을 쓴다. scope 를 안 걸면 promoteSessionCandidates 가 그 임시 rule 을 "기존 me rule" 로
+ * 오인해 재활성화해버려 영구 승격이 아예 안 되는 회귀가 생긴다(실측: 회귀 테스트로 발견).
+ *
+ * 동일 render_key 매칭이 여럿(레거시 데이터 등 이례적 상황)이면 active 우선, 그다음
+ * updated_at 최신순으로 하나만 반환.
+ */
+export function findRuleByRenderKey(renderKey, source, scope) {
+    const matches = loadAllRules().filter((r) => r.render_key === renderKey
+        && (source === undefined || r.source === source)
+        && (scope === undefined || r.scope === scope));
+    if (matches.length === 0)
+        return null;
+    matches.sort((a, b) => {
+        if (a.status === 'active' && b.status !== 'active')
+            return -1;
+        if (b.status === 'active' && a.status !== 'active')
+            return 1;
+        return b.updated_at.localeCompare(a.updated_at);
+    });
+    return matches[0];
+}
 /**
  * ADR-002 Meta signal — rule 들이 프롬프트에 inject 되었음을 기록.
  * rule.lifecycle.inject_count +1, last_inject_at = now.
@@ -188,10 +219,54 @@ export function updateRuleStatus(ruleId, status) {
     saveRule(rule);
     return true;
 }
+/** removed 룰 보관 기간 기본값 — 7일. TTL 로 은퇴된 지 이만큼 지나면 prune 대상. */
+export const DEFAULT_PRUNE_RETENTION_MS = 7 * 24 * 60 * 60 * 1000;
 /**
- * 현재 세션 ID와 다른 scope:'session' 규칙을 비활성화.
- * 이전 세션의 임시 규칙이 새 세션에서 영향을 미치지 않도록 정리.
+ * status:'removed' 파일을 retention 기간이 지난 것만 실제 unlink.
+ * RCA: retire(updateRuleStatus)는 status flip만 하고 파일을 지우지 않아 6,525개 죽은
+ * 파일이 ~/.forgen/me/rules 에 쌓여 loadAllRules() linear scan 비용을 키우고
+ * cross-process race 창을 넓혔다. status 전이 시각(updated_at) 기준으로 retention을
+ * 재는 이유: removed 직후 즉시 지우면 (a) findRuleByRenderKey 가 재활성화할 기회를
+ * 없애고 (b) 오탐 은퇴를 되돌릴 유예가 사라진다.
+ *
+ * 기본 dry-run(apply=false) — 프로덕션 데이터 삭제는 호출측이 명시적으로 apply:true
+ * 를 넘길 때만. (compound-sweep-cli 의 `--prune-removed`는 `--apply` 없으면 dry-run.)
  */
+export function pruneRemovedRules(opts = {}) {
+    const retentionMs = opts.retentionMs ?? DEFAULT_PRUNE_RETENTION_MS;
+    const apply = opts.apply ?? false;
+    const now = Date.now();
+    const candidates = [];
+    const deleted = [];
+    if (!fs.existsSync(ME_RULES))
+        return { candidates, deleted };
+    for (const file of fs.readdirSync(ME_RULES)) {
+        if (!file.endsWith('.json'))
+            continue;
+        const filePath = path.join(ME_RULES, file);
+        const rule = safeReadJSON(filePath, null);
+        if (rule?.status !== 'removed')
+            continue;
+        // 안전 불변식: prune 은 auto-mined advisory churn(결함1의 폭주 산출물)만 삭제한다.
+        // 영구·명시 룰(L1 하드룰, source:'explicit_correction')은 status:'removed' 여도
+        // 파일을 지우지 않는다 — 회귀 시 이력/복구 근거가 되고, 애초에 이 함수의 대상이 아니다.
+        const isAutoMinedChurn = rule.source === 'behavior_inference' || rule.render_key?.startsWith('auto:');
+        if (!isAutoMinedChurn)
+            continue;
+        const age = now - Date.parse(rule.updated_at);
+        if (!Number.isFinite(age) || age < retentionMs)
+            continue;
+        candidates.push(rule.rule_id);
+        if (apply) {
+            try {
+                fs.unlinkSync(filePath);
+                deleted.push(rule.rule_id);
+            }
+            catch { /* best-effort — 다음 prune 에서 재시도 */ }
+        }
+    }
+    return { candidates, deleted };
+}
 export function cleanupStaleSessionRules(_currentSessionId) {
     if (!fs.existsSync(ME_RULES))
         return 0;

package/dist/store/types.d.ts

@@ -4,6 +4,7 @@
  * Authoritative source: docs/plans/2026-04-03-forgen-data-model-storage-spec.md
  * Runtime contracts: docs/plans/2026-04-03-forgen-component-interface-design.md
  */
+import type { HostId } from '../core/trust-layer-intent.js';
 export type QualityPack = '보수형' | '균형형' | '속도형';
 export type AutonomyPack = '확인 우선형' | '균형형' | '자율 실행형';
 export type JudgmentPack = '최소변경형' | '균형형' | '구조적접근형';
@@ -110,6 +111,12 @@ export interface Rule {
      * ADR-002 §Data Model.
      */
     lifecycle?: LifecycleState;
+    /**
+     * W3-2 (교정 클러스터링): 이 rule 이 클러스터 통합으로 superseded 되었다면, 통합 결과
+     * rule 의 rule_id. `forgen rules --unmerge-cluster` 로 복원 시 이 링크로 원본을 되살린다.
+     * 통합 rule 쪽에는 설정되지 않는다(원본에만). ADR-010 W3-2.
+     */
+    clustered_into?: string;
 }
 export type EvidenceType = 'explicit_correction' | 'behavior_observation' | 'session_summary';
 export interface Evidence {
@@ -128,7 +135,7 @@ export interface Evidence {
      * evidence 가 어느 host 에서 발생했는지 태그. 미지정 시 'claude' 로 backfill (기존 데이터 호환).
      * core 의 학습 로직은 이 필드를 *호스트별 가중치* 가 아니라 *불일치 demote 신호* 로만 사용한다.
      */
-    host?: 'claude' | 'codex';
+    host?: HostId;
 }
 export interface QualityFacets {
     verification_depth: number;
@@ -187,7 +194,7 @@ export interface Profile {
      *   - 'ask': 매번 묻기 (interactive prompt)
      *   - undefined: legacy / 미설정 → 'claude' fallback (마이그레이션 호환)
      */
-    default_host?: 'claude' | 'codex' | 'ask';
+    default_host?: HostId | 'ask';
 }
 export type RecommendationSource = 'onboarding' | 'mismatch_recommendation';
 export type RecommendationStatus = 'proposed' | 'accepted' | 'archived';

package/hooks/hooks.json

@@ -1,5 +1,5 @@
 {
-  "description": "Forgen harness hooks (auto-generated, 22/22 active)",
+  "description": "Forgen harness hooks (auto-generated, 23/23 active)",
   "hooks": {
     "UserPromptSubmit": [
       {
@@ -195,6 +195,18 @@
           }
         ]
       }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/hooks/session-end.js\"",
+            "timeout": 3
+          }
+        ]
+      }
     ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wooojin/forgen",
-  "version": "0.4.13",
+  "version": "0.5.5",
   "preferGlobal": true,
   "main": "dist/lib.js",
   "types": "./dist/lib.d.ts",
@@ -79,7 +79,7 @@
   "devDependencies": {
     "@biomejs/biome": "^2.4.16",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^25.9.1",
+    "@types/node": "^26.1.1",
     "@vitest/coverage-v8": "^4.1.7",
     "typescript": "^5.9.3",
     "vitest": "^4.1.7"
@@ -87,6 +87,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.28.0",
     "js-yaml": "^4.1.1",
+    "jsonc-parser": "^3.3.1",
     "zod": "^4.4.3"
   },
   "peerDependencies": {

package/plugin.json

@@ -1,11 +1,11 @@
 {
   "$schema": "https://claude.ai/schemas/claude-plugin.json",
   "name": "forgen",
-  "version": "0.4.13",
+  "version": "0.5.5",
   "description": "Claude Code harness — the more you use Claude, the better it gets",
   "author": {
     "name": "jang-ujin",
-    "url": "https://github.com/wooo-jin"
+    "url": "https://github.com/forgen-team"
   },
   "repository": "https://github.com/forgen-team/forgen",
   "homepage": "https://github.com/forgen-team/forgen",

package/skills/architecture-decision/SKILL.md

@@ -1,6 +1,24 @@
 ---
 name: architecture-decision
 description: This skill should be used when the user asks to "adr,ch-architecture decision,아키텍처 결정,설계 결정,기술 결정". ADR 생성 -- 대안 평가, 가중 트레이드오프 매트릭스, 결정 라이프사이클 관리
+argument-hint: "[결정 주제]"
+model: opus
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Write
+  - Edit
+  - mcp__forgen-compound__compound-search
+  - mcp__forgen-compound__compound-read
+  - mcp__forgen-compound__compound-list
+triggers:
+  - "adr"
+  - "ch-architecture decision"
+  - "아키텍처 결정"
+  - "설계 결정"
+  - "기술 결정"
 ---
 
 <Purpose>

package/skills/calibrate/SKILL.md

@@ -1,6 +1,24 @@
 ---
 name: calibrate
 description: This skill should be used when the user asks to "calibrate, 캘리브레이트, 프로필 보정, 프로필 조정, 프로필 확인". 축적된 evidence(교정 기록)를 분석하여 4축 프로필 조정을 제안합니다.
+argument-hint: "[기간: 7d/30d/90d]"
+model: opus
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - mcp__forgen-compound__compound-search
+  - mcp__forgen-compound__compound-read
+  - mcp__forgen-compound__profile-read
+  - mcp__forgen-compound__correction-record
+triggers:
+  - "calibrate"
+  - "캘리브레이트"
+  - "프로필 보정"
+  - "프로필 조정"
+  - "프로필 확인"
+  - "프로필 업데이트"
 ---
 
 <Purpose>

package/skills/code-review/SKILL.md

@@ -1,6 +1,23 @@
 ---
 name: code-review
 description: This skill should be used when the user asks to "code review,코드 리뷰,리뷰해줘,review this". 신뢰도 보정 기반 체계적 코드 리뷰 — compound 이력 연동, auto-fix, 20개 체크리스트.
+argument-hint: "[file, PR number, or git range]"
+model: opus
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Edit
+  - Write
+  - Agent
+triggers:
+  - "code review"
+  - "코드 리뷰"
+  - "리뷰해줘"
+  - "review this"
+  - "리뷰"
+  - "review"
 ---
 
 <Purpose>

package/skills/compound/SKILL.md

@@ -1,6 +1,23 @@
 ---
 name: compound
 description: This skill should be used when the user asks to "복리화,compound,패턴 추출,솔루션 축적,what did we learn". Compound Engineering — extract reusable patterns from this session's work
+argument-hint: "[solution description]"
+model: inherit
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - mcp__forgen-compound__compound-search
+  - mcp__forgen-compound__compound-read
+  - mcp__forgen-compound__compound-list
+  - mcp__forgen-compound__compound-stats
+triggers:
+  - "복리화"
+  - "compound"
+  - "패턴 추출"
+  - "솔루션 축적"
+  - "what did we learn"
+  - "배운 것 정리"
 ---
 
 <Purpose>

package/skills/deep-interview/SKILL.md

@@ -1,6 +1,13 @@
 ---
 name: deep-interview
 description: This skill should be used when the user asks to "deep-interview,딥인터뷰,심층인터뷰,deep interview". Deep requirement interview with weighted dimension scoring, challenge modes, and ontology tracking
+argument-hint: "[project or feature description]"
+triggers:
+  - "deep-interview"
+  - "딥인터뷰"
+  - "심층인터뷰"
+  - "deep interview"
+  - "요구사항 인터뷰"
 ---
 
 <Purpose>

package/skills/docker/SKILL.md

@@ -1,6 +1,24 @@
 ---
 name: docker
 description: This skill should be used when the user asks to "docker,container,컨테이너,dockerfile,도커,docker-compose". Docker 컨테이너화 -- Dockerfile 최적화, Compose 구성, 보안 강화
+argument-hint: "[컨테이너화 대상]"
+model: sonnet
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Write
+  - Edit
+  - mcp__forgen-compound__compound-search
+  - mcp__forgen-compound__compound-read
+triggers:
+  - "docker"
+  - "container"
+  - "컨테이너"
+  - "dockerfile"
+  - "도커"
+  - "docker-compose"
 ---
 
 <Purpose>

package/skills/forge-loop/SKILL.md

@@ -1,6 +1,29 @@
 ---
 name: forge-loop
 description: This skill should be used when the user asks to "forge-loop, 포지루프, 끝까지, don't stop, goal, 목표, goal lock, scope lock". 작업을 PRD(User Story)로 분해 + 모든 수용 기준 충족까지 반복 실행. `--goal-only` 플래그로 PRD/수용기준 박제만 (실행 사이클 없이) 가능 — goal-locking pattern lightweight 진입점.
+argument-hint: "[task description] [--goal-only]"
+model: inherit
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Agent
+  - Edit
+  - Write
+triggers:
+  - "forge-loop"
+  - "포지루프"
+  - "끝까지"
+  - "don't stop"
+  - "완료될 때까지"
+  - "루프로 실행"
+  - "goal"
+  - "목표"
+  - "goal lock"
+  - "scope lock"
+  - "completion criteria"
+  - "수용 기준"
 ---
 
 <Purpose>
@@ -65,13 +88,19 @@ PRD 확정 직후 **반드시** `~/.forgen/state/forge-loop.json`에 저장:
 mkdir -p ~/.forgen/state
 cat > ~/.forgen/state/forge-loop.json <<EOF
 {"active":true,"startedAt":"$(date -u +%Y-%m-%dT%H:%M:%SZ)","stories":[
-  {"id":"US-001","title":"...","passes":false,"attempts":0}
+  {"id":"US-001","title":"...","passes":false,"attempts":0,"acceptanceCriteria":["..."]}
 ]}
 EOF
 ```
 
 이 파일이 있어야 Claude가 중간에 멈추지 않도록 Stop 훅이 차단합니다.
+소유 세션은 최초 차단 시점에 Stop 훅이 자동 귀속하므로(`sessionId` 필드) 이
+파일을 쓸 때 세션 ID를 직접 넣을 필요는 없습니다 — 단, 귀속된 세션과 다른
+세션에서는 이 루프가 차단하지 않습니다. 24시간 이상 갱신이 없으면 자동
+해제(1회성 안내 포함)되며, 연속 30회 차단 시에도 안전 상한으로 자동 해제됩니다.
 스토리 완료 시 `passes: true`로 업데이트. 전체 완료는 Stop 훅이 자동 처리.
+`acceptanceCriteria[0]`은 차단 메시지에 `AC1:`로 노출되므로 있으면 첫 항목을
+구체적이고 검증 가능한 문장으로 작성하세요 (없어도 정상 동작).
 
 ### goal-only 모드 — Phase 1 종료 분기
 

package/skills/learn/SKILL.md

@@ -1,6 +1,21 @@
 ---
 name: learn
 description: This skill should be used when the user asks to "learn, 학습 관리, compound 정리, 솔루션 정리". Compound 지식의 관리 인터페이스 — 검색, 통계, 가지치기, 내보내기/가져오기.
+argument-hint: "[search {query}|stats|prune|export|import {path}]"
+model: inherit
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+triggers:
+  - "learn"
+  - "학습 관리"
+  - "compound 정리"
+  - "솔루션 정리"
+  - "compound 관리"
+  - "솔루션 관리"
+  - "지식 관리"
 ---
 
 <Purpose>

package/skills/retro/SKILL.md

@@ -1,6 +1,22 @@
 ---
 name: retro
 description: This skill should be used when the user asks to "retro, 회고, retrospective, 돌아보기". Git 메트릭 + compound 건강도 + 학습 추세를 교차 분석하는 회고 리포트.
+argument-hint: "[7d|14d|30d] [compare]"
+model: inherit
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+triggers:
+  - "retro"
+  - "회고"
+  - "retrospective"
+  - "돌아보기"
+  - "주간 회고"
+  - "월간 회고"
+  - "주간회고"
+  - "월간회고"
 ---
 
 <Purpose>

package/skills/ship/SKILL.md

@@ -1,6 +1,24 @@
 ---
 name: ship
 description: This skill should be used when the user asks to "ship, 배포, 릴리스, release". 비대화형 자동 릴리스 파이프라인 — 테스트, 리뷰, 버전, CHANGELOG, PR을 원커맨드로.
+argument-hint: "[patch|minor|major]"
+model: inherit
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Agent
+  - Edit
+  - Write
+triggers:
+  - "ship"
+  - "배포"
+  - "릴리스"
+  - "release"
+  - "릴리즈"
+  - "배포해줘"
 ---
 
 <Purpose>
@@ -148,10 +166,27 @@ npm version {patch|minor|major} --no-git-tag-version
 
 커밋을 주제별 그룹핑 -> CHANGELOG.md 상단에 추가.
 
+## Step 6.5: Smoke 증거 생성 (forgen 레포 한정)
+
+forgen 레포 자체를 ship 할 때는 릴리스 커밋 전에 smoke 증거를 생성한다
+(ADR-010 W0-2 — CI self-gate 가 릴리스 커밋에서 smoke-report 를 요구).
+
+```bash
+# forgen 레포에서만. vitest 는 Step 3 에서 이미 돌았지만 게이트 증거는
+# smoke.cjs 산출물만 인정 — 전체 실행 (실제 프로세스 산출물 원칙).
+if [ -f scripts/smoke.cjs ]; then
+  node scripts/smoke.cjs || ABORT
+fi
+```
+
+- 실패 -> ABORT ("smoke 증거 생성 실패 — 게이트 통과 불가")
+
 ## Step 7: 릴리스 커밋
 
 ```bash
-git add package.json CHANGELOG.md
+git add package.json package-lock.json CHANGELOG.md
+# forgen 레포: smoke 증거 포함
+[ -f .forgen-release/smoke-report.json ] && git add .forgen-release/smoke-report.json
 git commit -m "release: v{version}"
 ```