@wooojin/forgen 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to forgen will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.1] - 2026-04-13
+
+### Added
+- **specify skill**: Structured requirement specification with Resolved/Provisional/Unresolved 3-level evaluation and readiness percentage
+- **deep-interview skill**: Deep requirement interview with Ambiguity Score (0-10) quantification across 5 axes (What/Who/How/When/Why)
+- **Agent output validation** (Tier 2-F): PostToolUse hook validates sub-agent output for empty/failed/timeout/context overflow
+- **BM25 ensemble scoring** (2-C): 3-way ensemble (TF-IDF 0.5 + BM25 0.3 + bigram 0.2) for solution matching
+- **Intent-based context injection** (2-B): implement/debug/refactor/review intents inject domain-specific rules
+- **Harness maturity diagnosis**: `forgen doctor` shows 5-axis L0-L3 maturity score with Quick Wins
+- **Session brief handoff**: Structured brief saved before compact, restored on next session start
+- **Output overflow prevention**: Solution injection footer includes head_limit guidance
+
+### Fixed
+- **Korean `\b` boundary**: Fixed 7 regex patterns where `\b` failed with Korean text (intent-classifier, keyword-detector)
+- **Revert→drift connection**: `isRevert` was always false (checked messages array instead of boolean flag)
+- **ALL_MODES missing specify**: `cancelforgen` didn't clear specify state
+- **MCP list TypeError**: Crashed on url-format servers without `args` field
+- **Agent empty string**: Empty string (`""`) was falsy, skipping validation
+- **Solution content regex**: `\Z` is not valid in JavaScript (literal Z), changed to `$`
+- **`severity: 'info' as 'warning'`**: Removed forced type assertion
+
+### Changed
+- **Rule renderer AI optimization** (2-A): `[category|strength]` tag prefix format, `include_pack_summary` defaults to false (token reduction)
+- **Recovery messages** (1-A): ENOENT suggests Glob search, EACCES suggests chmod
+- **skill-injector lock**: Session cache protected with `withFileLockSync` (race condition fix)
+- **incrementFailureCounter lock**: Context signals protected with `withFileLockSync`
+- Docker E2E expanded to 68 checks (Phase 8: Hoyeon analysis verification)
+
 ## [5.1.0] - 2026-04-06
 
 ### Fixed

package/README.ja.md

@@ -182,14 +182,63 @@ forgen
 
 ### Compound 知識
 
-知識はセッションを跨いで蓄積され、検索可能になります:
+知識はセッションを跨いで、信頼度ベースのライフサイクルで蓄積されます:
+
+```
+experiment (0.30) → candidate (0.55) → verified (0.75) → mature (0.90)
+```
+
+各ソリューションは `experiment` として始まります。セッションをまたいでコードに反映されるにつれ、自動的に昇格されます。ネガティブなエビデンスはサーキットブレーカーを発動させ（自動リタイア）、実際に機能するパターンだけが残ります。
 
 | 種類 | ソース | Claude の活用方法 |
 |------|--------|------------------|
-| **ソリューション** | セッションから抽出 | MCP 経由の `compound-search` |
-| **スキル** | 検証済みソリューションから昇格 | スラッシュコマンドとして自動ロード |
+| **ソリューション** | セッションから抽出 | プロンプトに関連するものを自動注入（TF-IDF + BM25 + bigram アンサンブル） |
+| **スキル** | 21個の組み込み + 検証済みソリューションから昇格 | キーワードで有効化（`specify`、`deep-interview`、`tdd` など） |
 | **行動パターン** | 3回以上の観察で自動検出 | `forge-behavioral.md` に適用 |
-| **エビデンス** | 修正 + 観察 | ファセット調整の根拠 |
+| **エビデンス** | 修正 + 観察 | ファセット調整 + ルール作成を促進 |
+
+### ソリューション自動注入
+
+入力したプロンプトはすべて、蓄積されたソリューションと照合されます。関連するものはClaudeのコンテキストに自動注入されます — 手動検索は不要です。
+
+```
+入力: "API のエラーハンドリングを修正して"
+                    ↓
+solution-injector がマッチ: starter-error-handling-patterns (0.70)
+                    ↓
+Claude が見るもの: "Matched solutions: error-handling-patterns [pattern|0.70]
+             Use try/catch with specific error types. Always log original error..."
+                    ↓
+Claude が蓄積されたパターンを参照して、より良いエラーハンドリングコードを書く。
+```
+
+### 21個の組み込みスキル
+
+プロンプトにキーワードを含めることで有効化:
+
+| スキル | トリガー | 機能 |
+|-------|---------|------|
+| `specify` | "specify", "명세" | 要件を Resolved/Provisional/Unresolved で整理、準備度 % 付き |
+| `deep-interview` | "deep-interview" | Ambiguity Score (0-10) 付きの深い要件インタビュー |
+| `code-review` | "code review 해줘" | 重大度評価付き20項目チェックリストレビュー |
+| `tdd` | "tdd 해줘" | Red-Green-Refactor テスト駆動開発 |
+| `debug-detective` | "debug-detective" | 再現 → 分離 → 修正 → 検証のループ |
+| `refactor` | "refactor 시작" | テストファーストの安全なリファクタリング |
+| `git-master` | "git-master" | アトミックコミット + クリーンな履歴管理 |
+| `security-review` | "security review" | OWASP Top 10 脆弱性チェック |
+| `ecomode` | "ecomode", "에코 모드" | トークン節約モード |
+| `migrate` | "migrate 해줘", "마이그레이션 시작" | 5フェーズの安全なマイグレーションワークフロー |
+| ... | | 残り11個（api-design, architecture-decision, ci-cd, database, docker, documentation, frontend, incident-response, performance, testing-strategy, compound） |
+
+### セッション管理
+
+| 機能 | 動作 |
+|------|------|
+| **セッションブリーフ** | コンテキスト圧縮前に構造化されたブリーフを保存し、次のセッションで復元 |
+| **ドリフト検出** | EWMA ベースの編集レート追跡 → 15編集で警告、30で危機的、50でハードストップ |
+| **エージェント出力検証** | Claude がサブエージェントを生成すると、その出力品質が自動検証される |
+| **自動コンパクト** | 累積12万文字でコンテキスト圧縮の指示 |
+| **ペンディング compound** | 20回以上のプロンプトセッション後、次のセッションで compound 抽出が自動トリガー |
 
 ---
 
@@ -337,6 +386,12 @@ forgen me                       # パーソナルダッシュボード（inspect
 ```bash
 forgen compound                 # 蓄積された知識をプレビュー
 forgen compound --save          # 自動分析されたパターンを保存
+forgen compound list            # ステータス付きで全ソリューションを一覧表示
+forgen compound inspect <名前>  # ソリューションの詳細を表示
+forgen compound --lifecycle     # 昇格/降格チェックを実行
+forgen compound --verify <名前> # 手動で verified に昇格
+forgen compound export          # 知識を tar.gz でエクスポート
+forgen compound import <パス>   # 知識アーカイブをインポート
 forgen skill promote <名前>     # 検証済みソリューションをスキルに昇格
 forgen skill list               # 昇格されたスキルの一覧
 ```
@@ -345,10 +400,14 @@ forgen skill list               # 昇格されたスキルの一覧
 
 ```bash
 forgen init                     # プロジェクトを初期化
-forgen doctor                   # システム診断
-forgen config hooks             # フック状態を確認
+forgen doctor                   # システム診断（10カテゴリ + ハーネス成熟度）
+forgen dashboard                # 知識概要（6セクション）
+forgen config hooks             # フック状態 + コンテキストバジェットを確認
 forgen config hooks --regenerate # フックを再生成
-forgen mcp                      # MCP サーバー管理
+forgen mcp list                 # インストール済み MCP サーバーを一覧
+forgen mcp add <名前>           # テンプレートから MCP サーバーを追加
+forgen mcp templates            # 利用可能なテンプレートを表示
+forgen notepad show             # セッションノートパッドを表示
 forgen uninstall                # forgen をきれいに削除
 ```
 
@@ -356,12 +415,14 @@ forgen uninstall                # forgen をきれいに削除
 
 | ツール | 目的 |
 |--------|------|
-| `compound-search` | クエリで蓄積された知識を検索 |
-| `compound-read` | ソリューション全文を読む |
-| `compound-list` | フィルタ付きソリューション一覧 |
-| `compound-stats` | 概要統計 |
+| `compound-search` | クエリで蓄積された知識を検索（TF-IDF + BM25 + bigram アンサンブル） |
+| `compound-read` | ソリューション全文を読む（Progressive Disclosure Tier 3） |
+| `compound-list` | ステータス/タイプ/スコープフィルタ付きソリューション一覧 |
+| `compound-stats` | ステータス・タイプ・スコープ別の概要統計 |
 | `session-search` | 過去のセッション会話を検索（SQLite FTS5、Node.js 22+） |
 | `correction-record` | ユーザー修正を構造化されたエビデンスとして記録 |
+| `profile-read` | 現在のパーソナライゼーションプロファイルを読む |
+| `rule-list` | カテゴリ別のアクティブなパーソナライゼーションルールを一覧 |
 
 ---
 
@@ -431,10 +492,12 @@ rule-renderer.ts                     Rule[] を自然言語に変換:
 | **pre-tool-use** | すべてのツール実行前 | `rm -rf`、`curl\|sh`、`--force` push、危険なパターンをブロック |
 | **db-guard** | SQL 操作 | `DROP TABLE`、`WHERE` なし `DELETE`、`TRUNCATE` をブロック |
 | **secret-filter** | ファイル書き込み、出力 | API キー、トークン、認証情報の露出時に警告 |
-| **slop-detector** | コード生成後 | TODO 残骸、`eslint-disable`、`as any`、`@ts-ignore` を検出 |
+| **slop-detector** | コード生成後 | TODO 残骸、`eslint-disable`、`as any`、`@ts-ignore`、空の catch を検出 |
 | **prompt-injection-filter** | すべての入力 | パターン + ヒューリスティックによるプロンプトインジェクションのブロック |
-| **context-guard** | セッション中 | コンテキストウィンドウの上限に近づいた時に警告 |
+| **context-guard** | セッション中 | 50プロンプト/20万文字で警告、12万文字で自動コンパクト、セッションハンドオフ |
 | **rate-limiter** | MCP ツール呼び出し | 過度な MCP ツール呼び出しを防止 |
+| **drift-detector** | ファイル編集 | EWMA ベースのドリフトスコア: 警告 → 危機的 → 50編集でハードストップ |
+| **agent-validator** | エージェントツール出力 | 空/失敗/切り捨てられたサブエージェント出力を警告 |
 
 安全ルールは**ハード制約**です -- パック選択や修正で上書きできません。レンダリングされたルールの「Must Not」セクションは、プロファイルに関係なく常に存在します。
 
@@ -460,7 +523,9 @@ rule-renderer.ts                     Rule[] を自然言語に変換:
 
 ## 共存
 
-forgen はインストール時に他の Claude Code プラグイン（oh-my-claudecode、superpowers、claude-mem）を検出し、重複するフックを無効化します。コアのセーフティフックと compound フックは常にアクティブを維持します。
+forgen はインストール時に他の Claude Code プラグイン（oh-my-claudecode、superpowers、claude-mem）を検出し、コンテキスト注入を自動的に50%削減します（「譲歩原則」）。コアのセーフティフックと compound フックは常にアクティブを維持します。他のプラグインがすでに提供しているスキルは競合を避けるためスキップされます。
+
+詳細は [共存ガイド](docs/guides/with-omc.md) を参照してください。
 
 ---
 

package/README.ko.md

@@ -182,14 +182,63 @@ forgen
 
 ### Compound 지식
 
-지식은 세션을 거치며 축적되고, 검색 가능해집니다:
+지식은 세션을 거치며 신뢰도 기반 라이프사이클로 축적됩니다:
+
+```
+experiment (0.30) → candidate (0.55) → verified (0.75) → mature (0.90)
+```
+
+각 솔루션은 `experiment`로 시작합니다. 세션을 거치며 코드에 반영될수록 자동 승격됩니다. 부정적 evidence는 서킷 브레이커를 작동시켜 자동 은퇴시킵니다. 실제로 당신에게 맞는 패턴만 살아남습니다.
 
 | 유형 | 출처 | Claude 활용 방법 |
 |------|------|-----------------|
-| **솔루션** | 세션에서 추출 | MCP를 통한 `compound-search` |
-| **스킬** | 검증된 솔루션에서 승격 | 슬래시 커맨드로 자동 로드 |
+| **솔루션** | 세션에서 추출 | 프롬프트와 관련 있을 때 자동 주입 (TF-IDF + BM25 + bigram 앙상블) |
+| **스킬** | 21개 내장 + 검증된 솔루션에서 승격 | 키워드로 활성화 (`specify`, `deep-interview`, `tdd` 등) |
 | **행동 패턴** | 3회 이상 관찰 시 자동 감지 | `forge-behavioral.md`에 적용 |
-| **Evidence** | 교정 + 관찰 | facet 조정의 근거 |
+| **Evidence** | 교정 + 관찰 | facet 조정 및 규칙 생성의 근거 |
+
+### Solution 자동 주입
+
+입력하는 모든 프롬프트가 축적된 솔루션과 매칭됩니다. 관련 솔루션은 Claude의 컨텍스트에 자동 주입됩니다 — 직접 찾아볼 필요가 없습니다.
+
+```
+입력: "API의 에러 핸들링을 고쳐줘"
+                    ↓
+solution-injector 매칭: starter-error-handling-patterns (0.70)
+                    ↓
+Claude에게 전달: "매칭된 솔루션: error-handling-patterns [pattern|0.70]
+             특정 에러 타입으로 try/catch 사용. 원본 에러는 반드시 로깅..."
+                    ↓
+Claude가 축적된 패턴을 바탕으로 더 나은 에러 핸들링 코드를 작성합니다.
+```
+
+### 21개 내장 스킬
+
+프롬프트에 키워드를 입력하면 활성화됩니다:
+
+| 스킬 | 트리거 | 기능 |
+|------|--------|------|
+| `specify` | "specify", "명세" | 요구사항을 Resolved/Provisional/Unresolved로 구조화, 준비도 % 산출 |
+| `deep-interview` | "deep-interview" | 주제별 Ambiguity Score (0-10)를 사용한 심층 요구사항 인터뷰 |
+| `code-review` | "code review 해줘" | 심각도 등급이 포함된 20개 항목 체크리스트 리뷰 |
+| `tdd` | "tdd 해줘" | Red-Green-Refactor 테스트 주도 개발 |
+| `debug-detective` | "debug-detective" | 재현 → 격리 → 수정 → 검증 루프 |
+| `refactor` | "refactor 시작" | 테스트 우선 안전한 리팩토링 |
+| `git-master` | "git-master" | 원자적 커밋 + 클린 히스토리 관리 |
+| `security-review` | "security review" | OWASP Top 10 취약점 점검 |
+| `ecomode` | "ecomode", "에코 모드" | 토큰 절약 모드 |
+| `migrate` | "migrate 해줘", "마이그레이션 시작" | 5단계 안전 마이그레이션 워크플로우 |
+| ... | | 11개 추가 (api-design, architecture-decision, ci-cd, database, docker, documentation, frontend, incident-response, performance, testing-strategy, compound) |
+
+### 세션 관리
+
+| 기능 | 동작 |
+|------|------|
+| **세션 브리프** | 컨텍스트 압축 전 구조화된 브리프 저장 → 다음 세션에서 복원 |
+| **drift 감지** | EWMA 기반 편집 속도 추적 → 15회 편집 시 경고, 30회 위험, 50회 강제 정지 |
+| **에이전트 출력 검증** | Claude가 서브 에이전트를 실행할 때 출력 품질 자동 검증 |
+| **자동 압축** | 누적 12만 자 초과 시 Claude에게 컨텍스트 압축 지시 |
+| **pending compound** | 20회 이상 프롬프트 세션 후 다음 세션에서 compound 추출 자동 트리거 |
 
 ---
 
@@ -337,6 +386,12 @@ forgen me                       # 개인 대시보드 (inspect profile 단축키
 ```bash
 forgen compound                 # 축적된 지식 미리보기
 forgen compound --save          # 자동 분석된 패턴 저장
+forgen compound list            # 상태가 포함된 솔루션 전체 목록
+forgen compound inspect <이름>  # 솔루션 전체 내용 확인
+forgen compound --lifecycle     # 승격/강등 검사 실행
+forgen compound --verify <이름> # 수동으로 verified 승격
+forgen compound export          # 지식을 tar.gz로 내보내기
+forgen compound import <경로>   # 지식 아카이브 가져오기
 forgen skill promote <이름>     # 검증된 솔루션을 스킬로 승격
 forgen skill list               # 승격된 스킬 목록
 ```
@@ -345,10 +400,14 @@ forgen skill list               # 승격된 스킬 목록
 
 ```bash
 forgen init                     # 프로젝트 초기화
-forgen doctor                   # 시스템 진단
-forgen config hooks             # 훅 상태 확인
+forgen doctor                   # 시스템 진단 (10개 항목 + 하네스 성숙도)
+forgen dashboard                # 지식 현황 대시보드 (6개 섹션)
+forgen config hooks             # 훅 상태 + 컨텍스트 예산 확인
 forgen config hooks --regenerate # 훅 재생성
-forgen mcp                      # MCP 서버 관리
+forgen mcp list                 # 설치된 MCP 서버 목록
+forgen mcp add <이름>           # 템플릿에서 MCP 서버 추가
+forgen mcp templates            # 사용 가능한 템플릿 목록
+forgen notepad show             # 세션 노트패드 보기
 forgen uninstall                # forgen 깔끔하게 제거
 ```
 
@@ -356,12 +415,14 @@ forgen uninstall                # forgen 깔끔하게 제거
 
 | 도구 | 용도 |
 |------|------|
-| `compound-search` | 축적된 지식을 쿼리로 검색 |
-| `compound-read` | 솔루션 전문 읽기 |
-| `compound-list` | 필터가 있는 솔루션 목록 |
-| `compound-stats` | 통계 요약 |
+| `compound-search` | 축적된 지식을 쿼리로 검색 (TF-IDF + BM25 + bigram 앙상블) |
+| `compound-read` | 솔루션 전문 읽기 (Progressive Disclosure Tier 3) |
+| `compound-list` | 상태/유형/범위 필터가 있는 솔루션 목록 |
+| `compound-stats` | 상태, 유형, 범위별 통계 현황 |
 | `session-search` | 이전 세션 대화 검색 (SQLite FTS5, Node.js 22+) |
 | `correction-record` | 사용자 교정을 구조화된 evidence로 기록 |
+| `profile-read` | 현재 개인화 프로필 읽기 |
+| `rule-list` | 카테고리별 활성 개인화 규칙 목록 |
 
 ---
 
@@ -431,10 +492,12 @@ rule-renderer.ts                     Rule[]을 자연어로 변환:
 | **pre-tool-use** | 모든 도구 실행 전 | `rm -rf`, `curl\|sh`, `--force` push, 위험 패턴 차단 |
 | **db-guard** | SQL 연산 | `DROP TABLE`, `WHERE` 없는 `DELETE`, `TRUNCATE` 차단 |
 | **secret-filter** | 파일 쓰기, 출력 | API 키, 토큰, 자격 증명 노출 시 경고 |
-| **slop-detector** | 코드 생성 후 | TODO 잔재, `eslint-disable`, `as any`, `@ts-ignore` 감지 |
+| **slop-detector** | 코드 생성 후 | TODO 잔재, `eslint-disable`, `as any`, `@ts-ignore`, 빈 catch 감지 |
 | **prompt-injection-filter** | 모든 입력 | 패턴 + 휴리스틱 기반 프롬프트 인젝션 차단 |
-| **context-guard** | 세션 중 | 컨텍스트 윈도우 한계 접근 시 경고 |
+| **context-guard** | 세션 중 | 50 프롬프트/20만 자 시 경고, 12만 자 자동 압축, 세션 인계 |
 | **rate-limiter** | MCP 도구 호출 | 과도한 MCP 도구 호출 방지 |
+| **drift-detector** | 파일 편집 | EWMA 기반 drift 점수: 경고 → 위험 → 50회 편집 시 강제 정지 |
+| **agent-validator** | 에이전트 도구 출력 | 서브 에이전트 출력이 비어있거나 실패/잘린 경우 경고 |
 
 안전 규칙은 **hard constraint**입니다 -- 팩 선택이나 교정으로 재정의할 수 없습니다. 렌더링된 규칙의 "Must Not" 섹션은 프로필과 무관하게 항상 존재합니다.
 
@@ -460,7 +523,19 @@ rule-renderer.ts                     Rule[]을 자연어로 변환:
 
 ## 공존
 
-forgen는 설치 시 다른 Claude Code 플러그인(oh-my-claudecode, superpowers, claude-mem)을 감지하고 겹치는 훅을 비활성화합니다. 핵심 안전 훅과 compound 훅은 항상 활성 상태를 유지합니다.
+forgen는 설치 시 다른 Claude Code 플러그인(oh-my-claudecode, superpowers, claude-mem)을 감지하고 컨텍스트 주입을 50% 자동 축소합니다 (양보 원칙). 핵심 안전 훅과 compound 훅은 항상 활성 상태를 유지합니다. 다른 플러그인이 이미 제공하는 스킬은 충돌을 피하기 위해 건너뜁니다.
+
+자세한 내용은 [공존 가이드](docs/guides/with-omc.md)를 참고하세요.
+
+---
+
+## 문서
+
+| 문서 | 설명 |
+|------|------|
+| [훅 레퍼런스](docs/reference/hooks-reference.md) | 3개 계층의 19개 훅 — 이벤트, 타임아웃, 동작 |
+| [공존 가이드](docs/guides/with-omc.md) | oh-my-claudecode와 forgen 함께 사용하기 |
+| [CHANGELOG](CHANGELOG.md) | 버전 히스토리 및 릴리즈 노트 |
 
 ---
 

package/README.md

@@ -182,14 +182,63 @@ forgen
 
 ### Compound knowledge
 
-Knowledge accumulates across sessions and becomes searchable:
+Knowledge accumulates across sessions with a trust-based lifecycle:
+
+```
+experiment (0.30) → candidate (0.55) → verified (0.75) → mature (0.90)
+```
+
+Each solution starts as an `experiment`. As it gets reflected in your code across sessions, it's automatically promoted. Negative evidence triggers a circuit breaker (auto-retire). This means only patterns that actually work for you survive.
 
 | Type | Source | How Claude uses it |
 |------|--------|--------------------|
-| **Solutions** | Extracted from sessions | `compound-search` via MCP |
-| **Skills** | Promoted from verified solutions | Auto-loaded as slash commands |
+| **Solutions** | Extracted from sessions | Auto-injected when relevant to your prompt (TF-IDF + BM25 + bigram ensemble) |
+| **Skills** | 21 built-in + promoted from verified solutions | Activated by keyword (`specify`, `deep-interview`, `tdd`, etc.) |
 | **Behavioral patterns** | Auto-detected at 3+ observations | Applied to `forge-behavioral.md` |
-| **Evidence** | Corrections + observations | Drives facet adjustments |
+| **Evidence** | Corrections + observations | Drives facet adjustments + rule creation |
+
+### Solution auto-injection
+
+Every prompt you type is matched against your accumulated solutions. Relevant ones are automatically injected into Claude's context — no manual lookup needed.
+
+```
+You type: "fix the error handling in the API"
+                    ↓
+solution-injector matches: starter-error-handling-patterns (0.70)
+                    ↓
+Claude sees: "Matched solutions: error-handling-patterns [pattern|0.70]
+             Use try/catch with specific error types. Always log original error..."
+                    ↓
+Claude writes better error handling code, informed by your accumulated patterns.
+```
+
+### 21 built-in skills
+
+Activate with a keyword in your prompt:
+
+| Skill | Trigger | What it does |
+|-------|---------|-------------|
+| `specify` | "specify", "명세" | Structures requirements as Resolved/Provisional/Unresolved with readiness % |
+| `deep-interview` | "deep-interview" | Deep requirement interview with Ambiguity Score (0-10) per topic |
+| `code-review` | "code review 해줘" | 20-item checklist review with severity ratings |
+| `tdd` | "tdd 해줘" | Red-Green-Refactor test-driven development |
+| `debug-detective` | "debug-detective" | Reproduce → Isolate → Fix → Verify loop |
+| `refactor` | "refactor 시작" | Test-first safe refactoring |
+| `git-master` | "git-master" | Atomic commits + clean history management |
+| `security-review` | "security review" | OWASP Top 10 vulnerability check |
+| `ecomode` | "ecomode", "에코 모드" | Token-saving mode |
+| `migrate` | "migrate 해줘", "마이그레이션 시작" | 5-phase safe migration workflow |
+| ... | | 11 more (api-design, architecture-decision, ci-cd, database, docker, documentation, frontend, incident-response, performance, testing-strategy, compound) |
+
+### Session management
+
+| Feature | What happens |
+|---------|-------------|
+| **Session brief** | Before context compaction, a structured brief is saved and restored in the next session |
+| **Drift detection** | EWMA-based edit rate tracking → warning at 15 edits, critical at 30, hard stop at 50 |
+| **Agent output validation** | When Claude spawns sub-agents, their output quality is automatically verified |
+| **Auto-compact** | At 120K chars accumulated, Claude is instructed to compact context |
+| **Pending compound** | After 20+ prompt sessions, a compound extraction is auto-triggered next session |
 
 ---
 
@@ -337,6 +386,12 @@ forgen me                       # Personal dashboard (shortcut for inspect profi
 ```bash
 forgen compound                 # Preview accumulated knowledge
 forgen compound --save          # Save auto-analyzed patterns
+forgen compound list            # List all solutions with status
+forgen compound inspect <name>  # Show full solution details
+forgen compound --lifecycle     # Run promotion/demotion check
+forgen compound --verify <name> # Manually promote to verified
+forgen compound export          # Export knowledge as tar.gz
+forgen compound import <path>   # Import knowledge archive
 forgen skill promote <name>     # Promote a verified solution to a skill
 forgen skill list               # List promoted skills
 ```
@@ -345,10 +400,14 @@ forgen skill list               # List promoted skills
 
 ```bash
 forgen init                     # Initialize project
-forgen doctor                   # System diagnostics
-forgen config hooks             # View hook status
+forgen doctor                   # System diagnostics (10 categories + harness maturity)
+forgen dashboard                # Knowledge overview (6 sections)
+forgen config hooks             # View hook status + context budget
 forgen config hooks --regenerate # Regenerate hooks
-forgen mcp                      # MCP server management
+forgen mcp list                 # List installed MCP servers
+forgen mcp add <name>           # Add MCP server from template
+forgen mcp templates            # Show available templates
+forgen notepad show             # View session notepad
 forgen uninstall                # Remove forgen cleanly
 ```
 
@@ -356,12 +415,14 @@ forgen uninstall                # Remove forgen cleanly
 
 | Tool | Purpose |
 |------|---------|
-| `compound-search` | Search accumulated knowledge by query |
-| `compound-read` | Read full solution content |
-| `compound-list` | List solutions with filters |
-| `compound-stats` | Overview statistics |
+| `compound-search` | Search accumulated knowledge by query (TF-IDF + BM25 + bigram ensemble) |
+| `compound-read` | Read full solution content (Progressive Disclosure Tier 3) |
+| `compound-list` | List solutions with status/type/scope filters |
+| `compound-stats` | Overview statistics by status, type, scope |
 | `session-search` | Search past session conversations (SQLite FTS5, Node.js 22+) |
 | `correction-record` | Record user corrections as structured evidence |
+| `profile-read` | Read current personalization profile |
+| `rule-list` | List active personalization rules by category |
 
 ---
 
@@ -433,10 +494,12 @@ Safety hooks are automatically registered in `settings.json` and run on every to
 | **pre-tool-use** | Before any tool execution | Blocks `rm -rf`, `curl\|sh`, `--force` push, dangerous patterns |
 | **db-guard** | SQL operations | Blocks `DROP TABLE`, `WHERE`-less `DELETE`, `TRUNCATE` |
 | **secret-filter** | File writes and outputs | Warns when API keys, tokens, or credentials are about to be exposed |
-| **slop-detector** | After code generation | Detects TODO remnants, `eslint-disable`, `as any`, `@ts-ignore` |
+| **slop-detector** | After code generation | Detects TODO remnants, `eslint-disable`, `as any`, `@ts-ignore`, empty catch |
 | **prompt-injection-filter** | All inputs | Blocks prompt injection attempts with pattern + heuristic detection |
-| **context-guard** | During session | Warns when approaching context window limit |
+| **context-guard** | During session | Warns at 50 prompts/200K chars, auto-compact at 120K, session handoff |
 | **rate-limiter** | MCP tool calls | Prevents excessive MCP tool invocations |
+| **drift-detector** | File edits | EWMA-based drift score: warning → critical → hard stop at 50 edits |
+| **agent-validator** | Agent tool output | Warns on empty/failed/truncated sub-agent output |
 
 Safety rules are **hard constraints** -- they cannot be overridden by pack selection or corrections. The "Must Not" section in rendered rules is always present regardless of profile.
 
@@ -462,7 +525,7 @@ Safety rules are **hard constraints** -- they cannot be overridden by pack selec
 
 ## Coexistence
 
-Forgen detects other Claude Code plugins (oh-my-claudecode, superpowers, claude-mem) at install time and disables overlapping hooks. Core safety and compound hooks always remain active.
+Forgen detects other Claude Code plugins (oh-my-claudecode, superpowers, claude-mem) at install time and automatically reduces its context injection by 50% ("yielding principle"). Core safety and compound hooks always remain active. Conflicting skills are skipped when another plugin already provides them.
 
 See [Coexistence Guide](docs/guides/with-omc.md) for details.
 

package/README.zh.md

@@ -182,14 +182,63 @@ forgen
 
 ### Compound 知识
 
-知识跨会话累积，变为可搜索的:
+知识跨会话累积，遵循基于信任度的生命周期:
+
+```
+experiment (0.30) → candidate (0.55) → verified (0.75) → mature (0.90)
+```
+
+每个解决方案从 `experiment` 开始。随着它在多个会话中被反映到你的代码里，会自动晋升。负面证据触发熔断机制（自动退役）。这意味着只有真正适合你的模式才能留存。
 
 | 类型 | 来源 | Claude 如何使用 |
 |------|------|----------------|
-| **解决方案** | 从会话中提取 | 通过 MCP 的 `compound-search` |
-| **技能** | 从已验证的解决方案晋升 | 作为斜杠命令自动加载 |
+| **解决方案** | 从会话中提取 | 与提示相关时自动注入（TF-IDF + BM25 + bigram 集成） |
+| **技能** | 21个内置 + 从已验证解决方案晋升 | 关键词激活（`specify`、`deep-interview`、`tdd` 等） |
 | **行为模式** | 3次以上观察时自动检测 | 应用到 `forge-behavioral.md` |
-| **证据** | 纠正 + 观察 | 驱动 facet 调整 |
+| **证据** | 纠正 + 观察 | 驱动 facet 调整 + 规则创建 |
+
+### 解决方案自动注入
+
+你输入的每个提示都会与你积累的解决方案进行匹配。相关的解决方案会自动注入 Claude 的上下文 — 无需手动查找。
+
+```
+你输入: "修复 API 中的错误处理"
+                    ↓
+solution-injector 匹配: starter-error-handling-patterns (0.70)
+                    ↓
+Claude 看到: "Matched solutions: error-handling-patterns [pattern|0.70]
+             Use try/catch with specific error types. Always log original error..."
+                    ↓
+Claude 参考你积累的模式，写出更好的错误处理代码。
+```
+
+### 21个内置技能
+
+在提示中包含关键词即可激活:
+
+| 技能 | 触发词 | 功能 |
+|------|--------|------|
+| `specify` | "specify", "명세" | 将需求整理为 Resolved/Provisional/Unresolved，附就绪度 % |
+| `deep-interview` | "deep-interview" | 深度需求访谈，每个主题附 Ambiguity Score (0-10) |
+| `code-review` | "code review 해줘" | 附严重度评级的20条清单审查 |
+| `tdd` | "tdd 해줘" | Red-Green-Refactor 测试驱动开发 |
+| `debug-detective` | "debug-detective" | 复现 → 隔离 → 修复 → 验证循环 |
+| `refactor` | "refactor 시작" | 测试优先的安全重构 |
+| `git-master` | "git-master" | 原子提交 + 清晰历史管理 |
+| `security-review` | "security review" | OWASP Top 10 漏洞检查 |
+| `ecomode` | "ecomode", "에코 모드" | Token 节省模式 |
+| `migrate` | "migrate 해줘", "마이그레이션 시작" | 5阶段安全迁移工作流 |
+| ... | | 另外11个（api-design, architecture-decision, ci-cd, database, docker, documentation, frontend, incident-response, performance, testing-strategy, compound） |
+
+### 会话管理
+
+| 功能 | 发生了什么 |
+|------|-----------|
+| **会话摘要** | 上下文压缩前保存结构化摘要，在下一个会话中恢复 |
+| **漂移检测** | 基于 EWMA 的编辑速率追踪 → 15次编辑警告，30次危急，50次硬停止 |
+| **智能体输出验证** | 当 Claude 生成子智能体时，自动验证其输出质量 |
+| **自动压缩** | 累积12万字符时，指示 Claude 压缩上下文 |
+| **待处理 compound** | 超过20个提示会话后，下一个会话自动触发 compound 提取 |
 
 ---
 
@@ -337,6 +386,12 @@ forgen me                       # 个人仪表盘（inspect profile 的快捷方
 ```bash
 forgen compound                 # 预览累积的知识
 forgen compound --save          # 保存自动分析的模式
+forgen compound list            # 列出所有解决方案及状态
+forgen compound inspect <名称>  # 查看解决方案完整详情
+forgen compound --lifecycle     # 运行晋升/降级检查
+forgen compound --verify <名称> # 手动晋升为 verified
+forgen compound export          # 将知识导出为 tar.gz
+forgen compound import <路径>   # 导入知识归档
 forgen skill promote <名称>     # 将已验证的解决方案晋升为技能
 forgen skill list               # 列出已晋升的技能
 ```
@@ -345,10 +400,14 @@ forgen skill list               # 列出已晋升的技能
 
 ```bash
 forgen init                     # 初始化项目
-forgen doctor                   # 系统诊断
-forgen config hooks             # 查看钩子状态
+forgen doctor                   # 系统诊断（10个类别 + 引擎成熟度）
+forgen dashboard                # 知识概览（6个板块）
+forgen config hooks             # 查看钩子状态 + 上下文预算
 forgen config hooks --regenerate # 重新生成钩子
-forgen mcp                      # MCP 服务器管理
+forgen mcp list                 # 列出已安装的 MCP 服务器
+forgen mcp add <名称>           # 从模板添加 MCP 服务器
+forgen mcp templates            # 显示可用模板
+forgen notepad show             # 查看会话记事本
 forgen uninstall                # 干净地卸载 forgen
 ```
 
@@ -356,12 +415,14 @@ forgen uninstall                # 干净地卸载 forgen
 
 | 工具 | 用途 |
 |------|------|
-| `compound-search` | 按查询搜索累积的知识 |
-| `compound-read` | 读取解决方案全文 |
-| `compound-list` | 带过滤器的解决方案列表 |
-| `compound-stats` | 概览统计 |
+| `compound-search` | 按查询搜索累积的知识（TF-IDF + BM25 + bigram 集成） |
+| `compound-read` | 读取解决方案全文（Progressive Disclosure Tier 3） |
+| `compound-list` | 带状态/类型/范围过滤器的解决方案列表 |
+| `compound-stats` | 按状态、类型、范围的概览统计 |
 | `session-search` | 搜索过去的会话对话（SQLite FTS5，Node.js 22+） |
 | `correction-record` | 将用户纠正记录为结构化证据 |
+| `profile-read` | 读取当前个性化档案 |
+| `rule-list` | 按类别列出活跃的个性化规则 |
 
 ---
 
@@ -431,10 +492,12 @@ rule-renderer.ts                     将 Rule[] 转换为自然语言:
 | **pre-tool-use** | 所有工具执行前 | 拦截 `rm -rf`、`curl\|sh`、`--force` push、危险模式 |
 | **db-guard** | SQL 操作 | 拦截 `DROP TABLE`、无 `WHERE` 的 `DELETE`、`TRUNCATE` |
 | **secret-filter** | 文件写入和输出 | API 密钥、令牌、凭据即将暴露时发出警告 |
-| **slop-detector** | 代码生成后 | 检测 TODO 残留、`eslint-disable`、`as any`、`@ts-ignore` |
+| **slop-detector** | 代码生成后 | 检测 TODO 残留、`eslint-disable`、`as any`、`@ts-ignore`、空 catch 块 |
 | **prompt-injection-filter** | 所有输入 | 基于模式 + 启发式的 prompt 注入拦截 |
-| **context-guard** | 会话中 | 接近上下文窗口限制时发出警告 |
+| **context-guard** | 会话中 | 50个提示/20万字符时警告，12万字符自动压缩，会话交接 |
 | **rate-limiter** | MCP 工具调用 | 防止过度的 MCP 工具调用 |
+| **drift-detector** | 文件编辑 | 基于 EWMA 的漂移评分: 警告 → 危急 → 50次编辑硬停止 |
+| **agent-validator** | 智能体工具输出 | 对空/失败/截断的子智能体输出发出警告 |
 
 安全规则是**硬约束** -- 不能被 pack 选择或纠正覆盖。渲染规则中的 "Must Not" 部分无论档案如何始终存在。
 
@@ -460,7 +523,9 @@ rule-renderer.ts                     将 Rule[] 转换为自然语言:
 
 ## 共存
 
-forgen 在安装时检测其他 Claude Code 插件（oh-my-claudecode、superpowers、claude-mem），并禁用重叠的钩子。核心安全钩子和 compound 钩子始终保持活跃。
+forgen 在安装时检测其他 Claude Code 插件（oh-my-claudecode、superpowers、claude-mem），并自动将上下文注入量减少 50%（"让步原则"）。核心安全钩子和 compound 钩子始终保持活跃。当其他插件已提供相同技能时，forgen 会跳过该技能以避免冲突。
+
+详情请参阅 [共存指南](docs/guides/with-omc.md)。
 
 ---