kotonoha 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -7,6 +7,42 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-10-19
+
+### Added
+
+- Add duplicate-particle/word, Japanese bracket, and paragraph style-mixing
+  diagnostics, plus a minimal-edit `proofread` skill mode.
+- Add a Markdown-aware invariant gate with protected-content checks and
+  required hash-bound semantic review of edits.
+
+### Fixed
+
+- Avoid treating obligation expressions as double-negative errors and
+  conclusion questions as formulaic assertions.
+- Keep shorter fence markers and fence-like info strings inside code blocks
+  out of prose diagnostics.
+- Require the invariant gate and current semantic review to pass before
+  claiming Japanese prose optimization completed.
+
+## [0.3.0] - 2026-09-30
+
+### Added
+
+- Add the `consulting-analyst` skill for issue trees, testable hypotheses,
+  evidence discipline, Current–Target–Gap analysis, transparent option
+  comparison, Pyramid Principle synthesis, and traceable handoff to writing
+  and presentation skills.
+- Add general-purpose Blueprint and White Paper doctypes with Japanese
+  templates, intake guidance, responsibility boundaries, traceability,
+  evidence controls, and review checklists.
+
+### Fixed
+
+- Require ASCII half-width spaces immediately before and after Markdown
+  strong emphasis embedded in prose, and flag full-width, non-breaking, or
+  tab spacing such as `これは　**「重要」**　と説明する`.
+
 ## [0.2.0] - 2026-09-29
 
 ### Changed

package/README-ja.md

@@ -1,6 +1,8 @@
 # kotonoha
 
-kotonohaは、技術文書の作成とプレゼンテーション設計を支援するGitHub Copilot CLIスキルを提供します。`tech-writer`は、開発文書、要件・設計文書、運用・移行文書、調達文書、Qiita・Zenn記事の構成と文章を整えます。対応する文書の一覧は「対応している文書」に掲載しています。`presentation-planner`は、プレゼンテーションシナリオ、スライド構成、デザイン仕様、PPTX作成スキル向けの引き継ぎ情報を生成します。
+kotonohaは、コンサルティング分析、技術文書、日本語表現、プレゼンテーション設計を支援するGitHub Copilot CLIスキルを提供します。曖昧な課題の構造化から、文書化、日本語表現の改善、プレゼンテーション設計までを一連の流れとして支援します。
+
+`consulting-analyst`は、課題を論点、仮説、証拠、選択肢、提言へ構造化します。分析結果を受け取った`tech-writer`は、README、設計文書、Blueprint、White Paper、提案書などへ内容を落とし込みます。日本語の表現品質は`japanese-prose`がGiNZAベースの診断で改善します。プレゼンテーションが必要な場合は、`presentation-planner`がシナリオ、スライド構成、デザイン仕様、PPTX作成スキル向けの引き継ぎ情報を生成します。
 
 [English](./README.md) | [日本語](./README-ja.md)
 
@@ -8,9 +10,9 @@ kotonohaは、技術文書の作成とプレゼンテーション設計を支援
 
 `kotonoha`は、「言葉」「言語」「和歌」を表す古典的・詩的な表現「言の葉（ことのは）」に由来します。読み手の意図を、明確で構造化された言葉へ育てるという、このプロジェクトの目的を表しています。
 
-『万葉集』との関係には補足が必要です。『万葉集』という書名を「万（よろづ）の言の葉、すなわち数多くの歌」と解釈する伝統的な説がありますが、書名の由来は確定していません。「やまとうたは、人の心を種として、よろづの言の葉とぞなれりける」という有名な表現の直接の典拠は、『万葉集』ではなく紀貫之による[『古今和歌集』仮名序](https://ja.wikisource.org/wiki/%E5%8F%A4%E4%BB%8A%E5%92%8C%E6%AD%8C%E9%9B%86%E4%BB%AE%E5%90%8D%E5%BA%8F)です。
+『万葉集』との関係には補足が必要です。その書名を「万（よろづ）の言の葉、すなわち数多くの歌」と解釈する伝統的な説がありますが、由来は確定していません。「やまとうたは、人の心を種として、よろづの言の葉とぞなれりける」という有名な表現の直接の典拠は、『万葉集』ではなく紀貫之による[『古今和歌集』仮名序](https://ja.wikisource.org/wiki/%E5%8F%A4%E4%BB%8A%E5%92%8C%E6%AD%8C%E9%9B%86%E4%BB%AE%E5%90%8D%E5%BA%8F)です。
 
-それ以前の『万葉集』にも、言葉が現実に働きかけるという近い思想が「言霊」として詠まれています。奈良県立万葉文化館の「万葉百科」では、山上憶良の[894番歌](https://manyo-hyakka.pref.nara.jp/db/detailLink?cls=db_manyo&pkey=894)や[3254番歌](https://manyo-hyakka.pref.nara.jp/db/detailLink?cls=db_manyo&pkey=3254)で確認できます。「言の葉」の歴史的な語義については、[コトバンク](https://kotobank.jp/word/%E8%A8%80%E3%81%AE%E8%91%89-503155)も参照しています。
+一方、それ以前に成立した『万葉集』でも、言葉が現実に働きかけるという近い思想が「言霊」として詠まれています。奈良県立万葉文化館の「万葉百科」では、山上憶良の[894番歌](https://manyo-hyakka.pref.nara.jp/db/detailLink?cls=db_manyo&pkey=894)や[3254番歌](https://manyo-hyakka.pref.nara.jp/db/detailLink?cls=db_manyo&pkey=3254)で確認できます。「言の葉」の歴史的な語義については、[コトバンク](https://kotobank.jp/word/%E8%A8%80%E3%81%AE%E8%91%89-503155)も参照しています。
 
 ## tech-writerが解決する課題
 
@@ -20,7 +22,8 @@ kotonohaは文書構造と技術的な不変条件を固定してから日本語
 
 ## 主な機能
 
-- README、設計書・ADR、APIリファレンス、PR説明・コミットメッセージ・Issue、リリースノート、ユーザーマニュアル、コードコメント、要件定義書、システム設計書、テスト計画書、運用設計書・Runbook、移行計画書、セキュリティ設計書、技術提案書、RFI・RFP、Qiita・Zenn記事の作成とレビュー
+- Issue Tree、仮説・証拠台帳、Current–Target–Gap、意思決定マトリクス、ピラミッド原則を使った事業・技術課題の構造化
+- README、設計書・ADR、APIリファレンス、PR説明、コミットメッセージ、Issue本文、リリースノート、ユーザーマニュアル、コードコメント、要件定義書、システム設計書、テスト計画書、運用設計書・Runbook、移行計画書、セキュリティ設計書、技術提案書、Blueprint、White Paper、RFI・RFP、Qiita・Zenn記事の作成とレビュー
 - 文書種別ごとの推奨構成とチェックリスト
 - ID、事実、表、コード、受け入れ基準を変更せずに日本語表現を反復的に最適化する、GiNZAベースの独自`japanese-prose`文章診断
 - 文書作成後のrubber-duck reviewと、対応可能な指摘がなくなるまでの修正・再レビュー
@@ -46,21 +49,47 @@ kotonohaは文書構造と技術的な不変条件を固定してから日本語
 | 利用者向け文書 | ユーザーマニュアル、手順書、チュートリアル | `user-manual` |
 | ソースコード文書 | コードコメント、docstring | `code-comments` |
 | 社内向け技術提案 | アーキテクチャ、投資、デリバリー提案 | `technical-proposal` |
+| 将来構想・変革設計図 | 事業、Operating Model、データ、技術のBlueprint | `blueprint` |
+| 証拠に基づく解説・提言 | 技術・事業White Paper | `white-paper` |
 | 情報提供依頼 | RFI | `rfi` |
 | 提案依頼 | RFP | `rfp` |
 | 技術記事 | Zenn記事 | `zenn` |
 | 技術記事 | Qiita記事 | `qiita` |
 
-再利用可能なテンプレートには、README、設計判断、ユーザーマニュアル、PR説明があります。要件定義、システム設計、テスト、運用、移行、セキュリティの各文書にも対応しています。技術提案、RFI、RFP、Qiita記事のテンプレートも含まれます。すべての文書種別には、`skills/tech-writer/references/doctypes/`配下に専用の構成ガイドとレビューチェックリストがあります。
+再利用可能なテンプレートには、README、設計判断、ユーザーマニュアル、PR説明があります。要件定義、システム設計、テスト、運用、移行、セキュリティの各文書にも対応しています。技術提案、Blueprint、White Paper、RFI、RFP、Qiita記事のテンプレートも含まれます。すべての文書種別には、`skills/tech-writer/references/doctypes/`配下に専用の構成ガイドとレビューチェックリストがあります。
+
+## consulting-analystの機能
+
+- 文書やプレゼンテーションを作る前に、意思決定者、意思決定の問い、成果、範囲、証拠不足を定義
+- フレームワークを機械的に埋めず、意思決定に必要な最小構成を選択
+- Issue Treeと検証可能な仮説・証拠台帳を作成
+- Current–Target–Gap分析と、採点基準・感度分析を伴う選択肢比較を実施
+- 事実、推定、前提、解釈、提言を区別
+- `tech-writer`と`presentation-planner`へ、証拠を追跡できる分析結果を引き継ぐ
+
+自然言語では、次のように依頼できます。
+
+```text
+この事業課題をIssue Treeで構造化し、優先論点ごとに必要な証拠を整理して
+```
+
+```text
+現状と目標状態を比較してGapを特定し、Blueprint向けの分析を準備して
+```
+
+```text
+複数案を明示的な評価基準で比較し、不足する証拠を捏造せずに
+White Paper向けの分析を作成して
+```
 
 ## presentation-plannerの機能
 
 - 対象者、意思決定、行動喚起、プレゼンテーションの制約を定義
 - ブリーフ、対象者の理解を導くシナリオ、主張型タイトルを使ったスライド構成を生成
-- YAMLデザイン仕様とPPTX作成スキル向けの決定的な引き継ぎ情報を生成
+- YAMLデザイン仕様とPPTX作成スキル向けの再現可能で明確な引き継ぎ情報を生成
 - 経営判断、技術説明、データ報告向けのシナリオテンプレート
 - 経営提案、技術説明、データ報告向けのデザイン仕様
-- `.pptx`の生成、バイナリ編集、レンダリング、視覚的な品質確認は専用PPTXスキルへ委譲
+- `.pptx`の生成、バイナリ編集、レンダリング、視覚的な品質確認は専用のPPTXスキルに委ねる
 
 ## セットアップ
 
@@ -68,11 +97,11 @@ kotonohaは文書構造と技術的な不変条件を固定してから日本語
 
 - GitHub Copilot CLIがインストールされていること
 - tech-writerの構造lintを実行する場合はPython 3.9以上
-- 同梱`japanese-prose`の文章lint、読解負荷分析、アウトライン抽出、用語検査を実行する場合はPython 3.10以上と`uv`。GiNZA、`ja_ginza`、spaCyは初回実行時に`uv`が解決
+- 同梱`japanese-prose`の文章lint、読解負荷分析、アウトライン抽出、用語検査、編集前後の不変条件検査を実行する場合はPython 3.10以上と`uv`。GiNZA、`ja_ginza`、spaCy、Markdown解析用の依存関係は、各スクリプトの初回実行時に`uv`が解決
 
 ### npmからインストール
 
-パッケージをインストールし、同梱CLIでスキルをスキルディレクトリへコピーします。
+パッケージをインストールし、同梱CLIで各スキルを対象のスキルディレクトリへコピーします。
 
 ```bash
 npm install --save-dev kotonoha
@@ -81,16 +110,17 @@ npx kotonoha install
 
 ### 同梱スキルをまとめてインストール
 
-`kotonoha install`は、まだ存在しない同梱スキルをすべてインストールします。次のコマンドは、`tech-writer`、`japanese-prose`、`presentation-planner`を`.github/skills/`へインストールします。
+`kotonoha install`は、まだ存在しない同梱スキルをすべてインストールします。次のコマンドは、`consulting-analyst`、`tech-writer`、`japanese-prose`、`presentation-planner`を`.github/skills/`へインストールします。
 
 ```bash
 npm install --save-dev kotonoha
 npx kotonoha install --skill all
 ```
 
-`--skill all`が既定値であるため、`npx kotonoha install`も同じ動作です。3つのスキルがインストールされたことを確認します。
+`--skill all`が既定値であるため、`npx kotonoha install`も同じ動作です。4つのスキルがインストールされたことを確認します。
 
 ```bash
+test -f .github/skills/consulting-analyst/SKILL.md
 test -f .github/skills/tech-writer/SKILL.md
 test -f .github/skills/japanese-prose/SKILL.md
 test -f .github/skills/presentation-planner/SKILL.md
@@ -106,25 +136,53 @@ npx kotonoha install --skill all --force
 
 kotonohaには独自開発の`japanese-prose`が同梱されるため、文章最適化スキルを別途インストールする必要はありません。`npx kotonoha install`により`tech-writer`と同じスキルルートへ配置され、GiNZAを使った文章lint、読解負荷検査、用語抽出、アウトライン検査、反復的な文章レビューをローカルで実行できます。この実装はkotonoha向けにゼロから開発しており、`natural-japanese`のソースコードを含みません。GiNZAの依存関係とライセンス情報は`skills/japanese-prose/NOTICE.md`に記録しています。
 
-既定のインストール先は、現在のプロジェクトの`.github/skills/tech-writer`、`.github/skills/japanese-prose`、`.github/skills/presentation-planner`です。スキルを1つだけインストールする場合や、別の対応ディレクトリを使用する場合は、次のように指定します。
+文章lintでは、隣接する助詞・単語の重複、和文括弧の不整合、同一段落内の敬体・常体の混在も確認します。指摘は自動置換の指示ではなく、文脈を確認する対象です。`proofread`モードでは、任意の言い換えを避け、誤字と文法上の誤りだけを最小限に修正します。100点満点のスコアは確認箇所を探す補助であり、訂正精度や品質の保証ではありません。
+
+編集前の原文は変更せずに保存します。同梱の`scripts/invariants.py`が、数値、識別子、コード、表、リンク、指定された固有名詞・専門用語などの変更を検査します。編集した文章には、原文と編集後のファイルのハッシュに対応した意味保存レビューが必要です。機械的な一致だけでは、意味が保たれたとは判定しません。レビュー形式と終了コードは、[`review-workflow.md`](skills/japanese-prose/references/review-workflow.md)を参照してください。
+
+自然言語で指示するときは、GiNZAを明示する必要はありません。「日本語文書を自然にする」「読みやすくする」「簡潔にする」「AIらしい定型表現を減らす」といった依頼をすると、同梱の文章最適化ワークフローが呼び出されます。
+
+```text
+README-ja.mdの日本語を自然で読みやすい表現に修正して
+```
+
+```text
+この設計書の不自然な日本語、長すぎる文、AIらしい反復表現を確認し、
+指摘を修正して
+```
+
+目的に応じて、次のようにモードを指定できます。
+
+- ファイルを修正する: `README-ja.mdの日本語表現を最適化して`
+- 誤りだけを修正する: `README-ja.mdをproofreadモードで校正して。任意の言い換えはせず、誤字と文法上の誤りだけを最小限に修正して`
+- 修正せずにレビューする: `README-ja.mdの日本語をレビューして。ファイルは修正しないで`
+- 採点だけ行う: `README-ja.mdの日本語表現を100点満点で採点して`
+- すべての診断を実行する: `README-ja.mdをfullモードで日本語表現最適化して`
+- GiNZAを明示する: `README-ja.mdをGiNZAで解析し、係り受けや読解負荷を改善して`
+
+新しい日本語文書では、`このリポジトリの日本語READMEを作成して`のように依頼すると、`tech-writer`が下書きと構造レビューを行い、rubber-duck reviewの前にGiNZAベースの文章最適化を実行します。文章最適化を確実に指定する場合は、`<ファイル名>を技術文書として作成または修正し、GiNZAによる日本語表現最適化まで実施して`と指示します。
+
+既定のインストール先は、現在のプロジェクトの`.github/skills/consulting-analyst`、`.github/skills/tech-writer`、`.github/skills/japanese-prose`、`.github/skills/presentation-planner`です。スキルを1つだけインストールする場合や、対応している別のディレクトリを使用する場合は、次のように指定します。
 
 ```bash
+npx kotonoha install --skill consulting-analyst
 npx kotonoha install --skill presentation-planner
 npx kotonoha install --target .claude/skills
 npx kotonoha install --target ~/.copilot/skills
 ```
 
-`--skill <name>`を明示したインストールは、既存のスキルディレクトリを上書きしません。既存のインストールを確認またはバックアップし、選択したスキルを置き換える場合にだけ`--force`を指定します。
+`--skill <name>`を明示したインストールは、既存のスキルディレクトリを上書きしません。すべてのスキルを置き換える場合は、既存のインストールを確認またはバックアップしてから`--force`を指定します。
 
 ```bash
 npx kotonoha install --force
 ```
 
-すべてのスキルをインストールする場合、既存のスキルディレクトリはスキップされ、不足しているスキルだけが追加されます。このため、`tech-writer`だけをインストール済みの環境から安全に更新できます。
+既定の全スキルインストールでは、既存のスキルディレクトリをスキップし、不足しているスキルだけを追加します。このため、`tech-writer`だけがインストールされた環境にも、ほかの同梱スキルを安全に追加できます。
 
 ```bash
 npx kotonoha install
 # Skipped tech-writer (...)
+# Installed consulting-analyst (...)
 # Installed japanese-prose (...)
 # Installed presentation-planner (...)
 ```
@@ -139,7 +197,7 @@ npx kotonoha install
 npm install --save-dev kotonoha@latest
 ```
 
-現在のプレリリース版を試す場合は、`next`タグをインストールします。
+`next`タグで公開されているプレリリース版を試す場合は、次のようにインストールします。
 
 ```bash
 npm install --save-dev kotonoha@next
@@ -154,18 +212,19 @@ npx kotonoha install --force
 スキルを1つだけ更新する場合は、次のように実行します。
 
 ```bash
+npx kotonoha install --skill consulting-analyst --force
 npx kotonoha install --skill tech-writer --force
 npx kotonoha install --skill japanese-prose --force
 npx kotonoha install --skill presentation-planner --force
 ```
 
-最初のインストールで別のインストール先を指定した場合は、同じディレクトリを再度指定します。
+最初のインストールで別のインストール先を指定した場合は、更新時にも同じディレクトリを指定します。
 
 ```bash
 npx kotonoha install --target ~/.copilot/skills --force
 ```
 
-インストール済みパッケージのバージョンを確認し、置き換えられたファイルをコミット前に確認します。
+インストール済みパッケージのバージョンと、置き換えられたファイルの差分をコミット前に確認します。
 
 ```bash
 npx kotonoha --version
@@ -178,9 +237,10 @@ git diff -- .github/skills
 
 このリポジトリでは、スキルが`.github/skills/`配下にリンクされているため、Copilot CLIで使用するための追加設定は不要です。
 
-別のプロジェクトでソースチェックアウトのスキルを使用する場合は、スキルのディレクトリを対象リポジトリの`.github/skills/`、`.claude/skills/`、またはグローバルの`~/.copilot/skills/`へコピーします。
+別のプロジェクトでソースチェックアウトに含まれるスキルを使用する場合は、各スキルのディレクトリを対象リポジトリの`.github/skills/`、`.claude/skills/`、またはグローバルの`~/.copilot/skills/`へコピーします。
 
 ```bash
+cp -r skills/consulting-analyst /path/to/your-repo/.github/skills/consulting-analyst
 cp -r skills/tech-writer /path/to/your-repo/.github/skills/tech-writer
 cp -r skills/japanese-prose /path/to/your-repo/.github/skills/japanese-prose
 cp -r skills/presentation-planner /path/to/your-repo/.github/skills/presentation-planner
@@ -209,12 +269,16 @@ python3 skills/tech-writer/scripts/lint.py path/to/document.md
 ## リポジトリ構成
 
 ```text
+skills/consulting-analyst/   # 課題構造化と証拠に基づく分析スキル
+  SKILL.md                   # 分析ワークフロー、制約、引き継ぎ
+  references/                # フレームワーク選択、証拠規律、引き継ぎ契約
+  assets/templates/          # ブリーフ、Issue Tree、証拠、意思決定、統合artifact
 skills/tech-writer/          # tech-writerスキル
   SKILL.md                   # スキル定義
   references/                # 構成原則、文書種別ごとの規則とチェックリスト
-  references/doctypes/       # README、要件、設計、テスト、運用、移行、セキュリティ、API、PR・Issue、リリースノート、提案、RFI・RFP、Qiita・Zenn
+  references/doctypes/       # README、要件、設計、テスト、運用、移行、セキュリティ、API、PR・Issue、リリースノート、提案、Blueprint、White Paper、RFI・RFP、Qiita・Zenn
   scripts/lint.py            # 構造とMarkdown表示のlintスクリプト
-  assets/templates/          # 要件、設計、テスト、運用、移行、セキュリティ、調達などの文書テンプレート
+  assets/templates/          # 要件、設計、テスト、運用、移行、セキュリティ、将来構想、調査・提言、調達などの文書テンプレート
 skills/japanese-prose/       # 独自開発のGiNZAベース文章最適化スキル
   SKILL.md                   # 執筆、lint、レビュー、収束のワークフロー
   references/                # 執筆規則、レビューワークフロー、採点規則
@@ -226,12 +290,14 @@ skills/presentation-planner/ # シナリオ、デザイン仕様、PPTX引き継
   assets/scenario-templates/ # 経営判断、技術説明、データ報告向けシナリオ
   assets/design-templates/   # 経営提案、技術説明、データ報告向けYAMLデザイン
 .github/skills/tech-writer   # Copilot CLIが読み込むskills/tech-writerへのシンボリックリンク
+.github/skills/consulting-analyst
 .github/skills/japanese-prose
 .github/skills/presentation-planner
 ```
 
 ## 既知の制約
 
+- `consulting-analyst`は、提供済みまたは検証済みの証拠を構造化します。市場データ、顧客情報、見積もり、引用を捏造しません。
 - `skills/tech-writer/scripts/lint.py`は、見出し、コードブロック、プレースホルダー、リンク、Markdown強調記号などの構造・表示上の問題を検出します。文章の自然さ、語彙、リズム、読解負荷は、別工程として呼び出される同梱`skills/japanese-prose`がGiNZAで検査します。
 - 文書種別は主に日本語の技術文書作成規則を前提としています。コミットメッセージの命令形などを含む多くのガイドは、英語文書にも適用できます。
 - `presentation-planner`だけでは`.pptx`バイナリを生成または検証できません。生成と視覚的な品質確認には専用PPTXスキルが必要です。
@@ -239,7 +305,7 @@ skills/presentation-planner/ # シナリオ、デザイン仕様、PPTX引き継
 
 ## 謝辞
 
-- [GiNZA](https://github.com/megagonlabs/ginza)（MIT License）— kotonoha独自の日本語文章診断に、形態素解析、品詞タグ付け、係り受け解析、見出し語化、文境界、固有表現抽出を提供します。
+- [GiNZA](https://github.com/megagonlabs/ginza)（MIT License）— kotonoha独自の日本語文章診断に、形態素解析、品詞タグ付け、係り受け解析、原形化、文境界、固有表現抽出を提供します。
 
 ## ライセンス
 

package/README.md

@@ -1,14 +1,13 @@
 # kotonoha
 
-kotonoha provides GitHub Copilot CLI skills for technical documents and
-presentation planning. `tech-writer` helps structure and polish README, design
-docs/ADRs, API reference, PR descriptions/commit messages/issue reports,
-release notes, user manuals/how-to guides, code comments, requirements
-definitions, system designs, test plans, operations runbooks, migration plans,
-security designs, technical proposals, RFI/RFP procurement documents, and
-Qiita/Zenn articles,
-structured so readers never get lost. `presentation-planner` turns source
-material into a reusable presentation scenario, slide outline, design
+kotonoha provides GitHub Copilot CLI skills for consulting analysis, technical
+documents, Japanese prose, and presentation planning. `consulting-analyst`
+structures ambiguous problems into issue trees, hypotheses, evidence, option
+comparisons, and recommendations. `tech-writer` turns that reasoning into
+README, design documents, Blueprints, White Papers, proposals, and other
+technical documents without losing the reader. `japanese-prose` improves
+Japanese wording with GiNZA-based diagnostics. `presentation-planner` turns
+source material into a reusable presentation scenario, slide outline, design
 specification, and handoff for a dedicated PPTX creation skill.
 
 [English](./README.md) | [日本語](./README-ja.md)
@@ -48,11 +47,15 @@ review.
 
 ## What it does
 
+- Structure ambiguous business and technical problems with issue trees,
+  hypotheses, evidence ledgers, Current–Target–Gap analysis, transparent
+  decision matrices, and Pyramid Principle synthesis
 - Create/review README, design docs/ADRs, API reference, PR
   descriptions/commit messages/issue reports, release notes, user manuals,
   code comments, requirements definitions, system designs, test plans,
   operations runbooks, migration plans, security designs, technical proposals,
-  RFI/RFP procurement documents, and Qiita/Zenn articles
+  Blueprints, White Papers, RFI/RFP procurement documents, and Qiita/Zenn
+  articles
 - Doctype-specific structure and checklists to guide writing
 - Original GiNZA-based `japanese-prose` lint, reading-load review, terminology
   checks, and iterative prose optimization without changing IDs, facts,
@@ -88,6 +91,8 @@ review.
 | User guidance | User manual, how-to guide, tutorial | `user-manual` |
 | Source documentation | Code comments, docstrings | `code-comments` |
 | Internal technical proposal | Architecture, investment, and delivery proposal | `technical-proposal` |
+| Future-state blueprint | Business, operating-model, data, and technology transformation blueprint | `blueprint` |
+| Evidence-led publication | Technical or business White Paper | `white-paper` |
 | Request for information | RFI | `rfi` |
 | Request for proposal | RFP | `rfp` |
 | Technical article | Zenn article | `zenn` |
@@ -96,10 +101,41 @@ review.
 Reusable templates are included for README, design decisions, user manuals,
 PR descriptions, requirements definitions, system designs, test plans,
 operations runbooks, migration plans, security designs, technical proposals,
-RFI, RFP, and Qiita articles. Every supported doctype includes dedicated
-structure guidance and a review checklist under
+Blueprints, White Papers, RFI, RFP, and Qiita articles. Every supported
+doctype includes dedicated structure guidance and a review checklist under
 `skills/tech-writer/references/doctypes/`.
 
+## What consulting-analyst does
+
+- Defines the decision-maker, decision question, outcome, scope, and evidence
+  gaps before a document or presentation is written
+- Selects the smallest useful framework set instead of filling frameworks
+  mechanically
+- Builds an issue tree and testable hypothesis/evidence ledger
+- Supports Current–Target–Gap analysis and weighted option comparison with
+  scoring anchors and sensitivity analysis
+- Separates facts, estimates, assumptions, interpretations, and
+  recommendations
+- Produces a traceable synthesis handoff for `tech-writer` and
+  `presentation-planner`
+
+Example requests:
+
+```text
+Structure this business problem as an issue tree and identify the evidence
+needed to answer each priority issue.
+```
+
+```text
+Analyze the current and target states, identify the gaps, and prepare the
+analysis for a Blueprint.
+```
+
+```text
+Compare these alternatives using explicit criteria and prepare a White Paper
+handoff without inventing missing evidence.
+```
+
 ## What presentation-planner does
 
 - Defines the audience, decision, call to action, and presentation constraints
@@ -119,7 +155,8 @@ structure guidance and a review checklist under
 
 - GitHub Copilot CLI installed
 - Python 3.9+ for tech-writer's structural lint
-- Python 3.10+ and `uv` for the bundled GiNZA diagnostics such as prose lint,
+- Python 3.10+ and `uv` for the edit-invariant gate and bundled GiNZA
+  diagnostics such as prose lint,
   reading-load analysis, outline extraction, and terminology checks; `uv`
   resolves GiNZA, `ja_ginza`, and spaCy on first use
 
@@ -136,8 +173,8 @@ npx kotonoha install
 ### Install all bundled skills together
 
 `kotonoha install` installs every packaged skill that is not already present.
-The following commands install `tech-writer`, `japanese-prose`, and
-`presentation-planner` into `.github/skills/`:
+The following commands install `consulting-analyst`, `tech-writer`,
+`japanese-prose`, and `presentation-planner` into `.github/skills/`:
 
 ```bash
 npm install --save-dev kotonoha
@@ -145,9 +182,10 @@ npx kotonoha install --skill all
 ```
 
 `--skill all` is the default, so `npx kotonoha install` has the same behavior.
-Confirm that all three skills were installed:
+Confirm that all four skills were installed:
 
 ```bash
+test -f .github/skills/consulting-analyst/SKILL.md
 test -f .github/skills/tech-writer/SKILL.md
 test -f .github/skills/japanese-prose/SKILL.md
 test -f .github/skills/presentation-planner/SKILL.md
@@ -172,12 +210,55 @@ scratch for kotonoha and does not include `natural-japanese` source code.
 GiNZA dependency and license information is recorded in
 `skills/japanese-prose/NOTICE.md`.
 
-The default destinations are `.github/skills/tech-writer`,
-`.github/skills/japanese-prose`, and
+The lint also flags adjacent duplicate particles/words, Japanese bracket
+mismatches, and polite/plain style mixing within a paragraph. Findings are
+review targets, not automatic replacements. Use `proofread` mode for minimal
+typo/grammar corrections without optional stylistic rewriting. The 0–100
+score is a triage aid, not correction accuracy or a quality certificate.
+
+Before editing, the workflow saves an immutable original. The bundled
+`scripts/invariants.py` checks protected content and requires a hash-bound
+semantic review of changed prose. Numbers, identifiers, code, tables, links,
+and caller-supplied proper names/domain terms cannot be silently changed.
+Mechanical equality alone does not establish preserved meaning. See
+[`review-workflow.md`](skills/japanese-prose/references/review-workflow.md)
+for the review format and gate exit codes.
+
+You do not need to name GiNZA explicitly in a natural-language request.
+Requests to make a Japanese document more natural, readable, concise, or less
+formulaic invoke the bundled prose-optimization workflow. For example:
+
+```text
+Rewrite README-ja.md in natural, readable Japanese.
+```
+
+```text
+Review this design document for unnatural Japanese, overly long sentences,
+and repetitive AI-like phrasing, then fix the findings.
+```
+
+You can specify the intended mode more precisely:
+
+- Edit the file: `Optimize the Japanese prose in README-ja.md.`
+- Correct errors only: `Proofread README-ja.md; make minimal typo/grammar corrections without stylistic rewrites.`
+- Review without editing: `Review the Japanese in README-ja.md, but do not modify the file.`
+- Score only: `Score the Japanese prose in README-ja.md out of 100.`
+- Run every diagnostic: `Run the full Japanese prose optimization workflow on README-ja.md.`
+- Request GiNZA explicitly: `Analyze README-ja.md with GiNZA and improve dependency depth and reading load.`
+
+When creating a new Japanese document, asking `Create a Japanese README for
+this repository` lets `tech-writer` create and structurally review the draft,
+then run the GiNZA-based prose pass before rubber-duck review. To require the
+pass unambiguously, ask: `Create or revise <file> as a technical document and
+run GiNZA-based Japanese prose optimization.`
+
+The default destinations are `.github/skills/consulting-analyst`,
+`.github/skills/tech-writer`, `.github/skills/japanese-prose`, and
 `.github/skills/presentation-planner` in the current project. To install only
 one skill, or use another supported skill directory:
 
 ```bash
+npx kotonoha install --skill consulting-analyst
 npx kotonoha install --skill presentation-planner
 npx kotonoha install --target .claude/skills
 npx kotonoha install --target ~/.copilot/skills
@@ -198,6 +279,7 @@ installation safe:
 ```bash
 npx kotonoha install
 # Skipped tech-writer (...)
+# Installed consulting-analyst (...)
 # Installed japanese-prose (...)
 # Installed presentation-planner (...)
 ```
@@ -230,6 +312,7 @@ npx kotonoha install --force
 To update only one skill:
 
 ```bash
+npx kotonoha install --skill consulting-analyst --force
 npx kotonoha install --skill tech-writer --force
 npx kotonoha install --skill japanese-prose --force
 npx kotonoha install --skill presentation-planner --force
@@ -263,6 +346,7 @@ into that repository's `.github/skills/`, `.claude/skills/`, or your global
 `~/.copilot/skills/`.
 
 ```bash
+cp -r skills/consulting-analyst /path/to/your-repo/.github/skills/consulting-analyst
 cp -r skills/tech-writer /path/to/your-repo/.github/skills/tech-writer
 cp -r skills/japanese-prose /path/to/your-repo/.github/skills/japanese-prose
 cp -r skills/presentation-planner /path/to/your-repo/.github/skills/presentation-planner
@@ -292,12 +376,16 @@ works too (standard library only).
 ## Repository layout
 
 ```text
+skills/consulting-analyst/   # problem structuring and evidence-led analysis skill
+  SKILL.md                   # analysis workflow, safeguards, and handoff
+  references/                # framework selection, evidence discipline, handoff contract
+  assets/templates/          # brief, issue tree, evidence, decision, and synthesis artifacts
 skills/tech-writer/          # the skill itself
   SKILL.md                   # skill definition
   references/                # structure constitution + doctype rules/checklists
-  references/doctypes/       # README, requirements/design/test/operations/migration/security, API docs, PR/issue, release notes, proposals, RFI/RFP, Qiita/Zenn
+  references/doctypes/       # README, requirements/design/test/operations/migration/security, API docs, PR/issue, release notes, proposals, Blueprints, White Papers, RFI/RFP, Qiita/Zenn
   scripts/lint.py            # structural lint script
-  assets/templates/          # doctype skeletons including requirements, design, test, operations, migration, security, and procurement
+  assets/templates/          # doctype skeletons including requirements, design, test, operations, migration, security, strategy, evidence-led publications, and procurement
 skills/japanese-prose/       # original GiNZA-based prose optimization skill
   SKILL.md                   # writing, lint, review, and convergence workflow
   references/                # writing guidelines, review workflow, and scoring
@@ -309,12 +397,15 @@ skills/presentation-planner/ # storyline, design-spec, and PPTX handoff skill
   assets/scenario-templates/ # executive, technical, and data-report narrative scenarios
   assets/design-templates/   # executive, technical, and data-report YAML designs
 .github/skills/tech-writer   # symlink to skills/tech-writer (where Copilot CLI reads it)
+.github/skills/consulting-analyst
 .github/skills/japanese-prose
 .github/skills/presentation-planner
 ```
 
 ## Known limitations
 
+- `consulting-analyst` structures supplied or verified evidence but does not
+  manufacture market data, customer facts, estimates, or citations.
 - `skills/tech-writer/scripts/lint.py` detects structural and Markdown
   rendering issues. Prose naturalness, vocabulary, rhythm, and reading load
   are handled by the separately invoked but bundled

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kotonoha",
-  "version": "0.2.0",
-  "description": "GitHub Copilot CLI skills for technical writing and PPTX presentation planning.",
+  "version": "0.4.0",
+  "description": "GitHub Copilot CLI skills for consulting analysis, technical writing, Japanese prose, and PPTX planning.",
   "license": "MIT",
   "author": "nahisaho",
   "repository": {
@@ -27,6 +27,9 @@
     "github-copilot",
     "skill",
     "technical-writing",
+    "consulting",
+    "analysis",
+    "strategy",
     "documentation",
     "markdown",
     "presentation",