kotonoha 0.4.1 → 0.5.0

package/CHANGELOG.md

@@ -7,6 +7,53 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-10-20
+
+### Added
+
+- Add explicit `kotonoha install --agent
+  copilot|claude|all` selection for GitHub Copilot, Claude Code, or both.
+  Keep the Copilot default and independent `--skill` selection.
+- Preserve existing Skills in both roots, preflight explicit-skill conflicts
+  before copying, and allow `--target` overrides for a single agent.
+
+### Changed
+
+- Document both hosts and their installation/update paths. Extend
+  `tech-writer`'s prose Skill discovery to Claude project and personal roots.
+- Keep npm installation free of automatic Skill writes or interactive setup.
+
+### Fixed
+
+- Shorten `tech-writer`'s description to the Agent Skills 1,024-character
+  limit so hosts discover all seven bundled Skills. Add a regression check.
+
+## [0.4.2] - 2026-10-20
+
+### Added
+
+- Add `obsidian-bases` for Table, Cards, List and Kanban configuration with direct
+  authorized host edits, four original templates and a read-only stdin checker.
+  Ship a private dependency lock, excluding dependency caches from installation.
+- Add `obsidian-canvas` for scoped JSON Canvas diagnosis, four diagram
+  templates, explicit edits, layout proposals and approval-gated saves.
+- Add per-string semantic reviews for selected Canvas text and labels,
+  persistent evidence/proposal markings, and original acceptance fixtures.
+
+### Changed
+
+- Allow explicitly authorized host-tool creation and editing of Vault Markdown
+  notes without mandatory CLI plans. Keep CLI plan-approved saving optional,
+  preserve proofreading checks, and distinguish direct-edit failure guarantees.
+- Use the user-specified directory, or the current directory by default, for
+  Vault direct editing. Modify the authorized target itself rather than a
+  session-state copy; retain Vault scope and auxiliary-copy consent checks.
+- Rewrite the `obsidian-vault` Skill entrypoint in concise English to reduce
+  loading tokens while preserving its operating and safety rules.
+- Share authorized storage and atomic commit primitives with `obsidian-vault`
+  while preserving its Markdown CLI contract. Existing unapplied plans must
+  be regenerated and approved after updating the implementation.
+
 ## [0.4.1] - 2026-10-19
 
 ### Added
@@ -163,4 +210,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [0.1.0]: https://github.com/nahisaho/kotonoha/releases/tag/v0.1.0
 [0.1.4]: https://github.com/nahisaho/kotonoha/compare/v0.1.2...v0.1.4
 [0.1.5]: https://github.com/nahisaho/kotonoha/compare/v0.1.4...v0.1.5
-[Unreleased]: https://github.com/nahisaho/kotonoha/compare/v0.1.5...HEAD
+[0.4.2]: https://github.com/nahisaho/kotonoha/compare/d76ef4a...v0.4.2
+[0.5.0]: https://github.com/nahisaho/kotonoha/compare/v0.4.2...v0.5.0
+[Unreleased]: https://github.com/nahisaho/kotonoha/compare/v0.5.0...HEAD

package/README-ja.md

@@ -1,6 +1,6 @@
 # kotonoha
 
-kotonohaは、コンサルティング分析、技術文書、日本語表現、プレゼンテーション設計を支援するGitHub Copilot CLIスキルを提供します。曖昧な課題の構造化から、文書化、日本語表現の改善、プレゼンテーション設計までを一連の流れとして支援します。
+kotonohaは、GitHub CopilotとClaude Code向けのスキルを提供します。曖昧な課題の構造化から、文書化、日本語表現の改善、プレゼンテーション設計までを一連の流れとして支援します。
 
 `consulting-analyst`は、課題を論点、仮説、証拠、選択肢、提言へ構造化します。分析結果を受け取った`tech-writer`は、README、設計文書、Blueprint、White Paper、提案書などへ内容を落とし込みます。日本語の表現品質は`japanese-prose`がGiNZAベースの診断で改善します。プレゼンテーションが必要な場合は、`presentation-planner`がシナリオ、スライド構成、デザイン仕様、PPTX作成スキル向けの引き継ぎ情報を生成します。
 
@@ -63,19 +63,60 @@ Obsidianでは、[`obsidian.md`](skills/tech-writer/assets/templates/obsidian.md
 
 ## Obsidian Vaultの操作
 
-専用の`obsidian-vault`は、Vaultの規約確認、ノート新規作成、関連ノート候補、内部リンク診断、日本語添削を担当します。
-文書構成はtech-writer、日本語表現はjapanese-proseを利用するため、3つのSkillを同じ場所へ導入してください。
-初期対応はLinux、CPython 3.12、uvです。Obsidianアプリ、MCP、プラグインには依存しません。
-
-Vault、読み取り範囲、モデルに渡す情報を利用者が明示し、保存する場合は正確な差分と計画を承認します。
-保存は専用CLIのapplyだけで行い、添削時の記法保護とハッシュ付き意味レビューを迂回しません。
+専用の`obsidian-vault`は、Vaultの規約確認、Markdownノートの直接作成・編集、関連ノート候補、内部リンク診断、日本語添削を担当します。
+直接編集は`kotonoha@0.4.2`に含まれます。
+対象と変更内容への許可を確認し、ホストのファイルツールで本文・プロパティ・タグ・リンクを変更できます。
+直接編集には専用CLIの計画ファイル、Python、uvは不要です。Obsidianアプリ、MCP、プラグインにも依存しません。
+文書構成にはtech-writer、日本語添削にはjapanese-proseを利用します。
+
+Vault、読み取り範囲、モデルに渡す情報を利用者が明示し、指定外の内容を保持します。
+保存前の確認を求められた場合は、差分承認まで保存しません。
+直接編集の作業ディレクトリはユーザー指定を優先し、未指定なら依頼開始時のカレントディレクトリを使います。
+相対保存先はそこから解決しますが、Vaultルート基準と明示したパスや絶対パスは維持します。
+許可済みのVaultと範囲内にある対象自体を編集し、セッション領域のコピーで代替しません。
+補助ファイルへの同意と適切な保存場所も別途必要です。
+CLI計画保存モードも選べます。こちらはLinux、CPython 3.12、uvを使い、正確な差分と計画の承認後にapplyします。
+両モードとも、添削時の記法保護とハッシュ付き意味レビューは省略しません。
 未解決リンクを誤りと断定せず、自動修復もしません。
-処理はオフライン・lock付きで起動します。依存関係の初回準備は別途の許可が必要です。
+CLI処理はオフライン・lock付きで起動します。依存関係の初回準備は別途の許可が必要です。
 依頼例、コマンド、コピーの保持と復旧は[操作ガイド](skills/obsidian-vault/references/workflow.md)を参照してください。
 
-保存は確認できたローカルFSに限定し、シンボリックリンク、維持できない属性、複数ハードリンクを拒否します。
+保存は必要な確認ができるローカル通常ファイルに限定し、シンボリックリンク、維持できない属性、複数ハードリンクを拒否します。
 拡張属性付きファイルも保存非対応であり、SELinuxラベルなどの削除を回避策にしません。
-最終照合直後の外部編集やLLMの誤判断は完全には防げず、ホストを隔離する機能でもありません。
+直接編集はCLIの原子的確定、ルートロック、成功記録による再実行保護を利用しません。
+保存後に読み戻して確認しますが、途中失敗や同時編集の完全な防止は保証しません。
+LLMの誤判断を完全には防げず、ホストを隔離する機能でもありません。
+
+## Obsidian Canvasの操作
+
+専用の`obsidian-canvas`は、ノート関係図、アイデア整理、条件付きの手順、資料比較を扱います。
+JSON Canvas 1.0の読み取り・診断・配置提案・編集に対応し、Obsidianの起動やURLへの通信は行いません。
+この機能は`kotonoha@0.4.2`に含まれます。
+
+同じ場所に共用API版1のobsidian-vaultを導入します。Canvasだけの選択導入では兄弟を自動更新しません。
+添削ではjapanese-proseも必要です。初期対応はLinux、CPython 3.12、固定依存によるオフライン実行です。
+既存の兄弟Skillが旧版なら、必要な更新を明示し、許可なく置き換えません。
+
+保存前にID・属性ごとの変更、根拠や提案の文字による表示、正確な差分と計画を確認します。
+日本語添削には変更文字列ごとのハッシュ付き意味レビューが必要です。
+保存は利用者が明示承認した1Canvasだけに限定し、参照元ノートや添付を変更しません。
+未知の構造は診断のみとし、実表示や任意の拡張、casefoldファイルシステムの検証済み対応は保証しません。
+同意、コマンド、部分実施、保存結果が不明な場合の復旧は[Canvas操作ガイド](skills/obsidian-canvas/references/workflow.md)を参照してください。
+
+## Obsidian Basesの操作
+
+専用の`obsidian-bases`は、Table・Cards・List・Kanbanの`.base`を作成・診断・直接編集します。
+この機能は`kotonoha@0.4.2`に含まれます。
+作業ディレクトリはユーザー指定を優先し、未指定ならカレントディレクトリを使います。
+許可済みの対象自体をホストツールで編集し、ノートのプロパティや埋め込みbaseブロックは変更しません。
+
+読み取り専用のNode検査器へ正確な文字列を渡し、保存するバイト列と検査結果のハッシュを照合します。
+Node 18以上と固定依存が必要です。依存の準備は別途許可を得たnpm ciで行い、検査中の自動取得はしません。
+導入時には専用のロックファイルを含め、node_modulesはコピーしません。
+式の実行やObsidian表示は確認せず、未知の機能・アプリ版不明・未完了の検査では保存を拒否します。
+条件・数式の変更は正確な差分と保存の許可を確認し、条件なしでは全Vaultが表示されることを説明します。
+直接編集にはCLIのロック・原子的確定・再実行記録はありません。
+依存の準備、4種類の独自テンプレート、原文保持、失敗時の扱いは[Bases操作ガイド](skills/obsidian-bases/references/workflow.md)を参照してください。
 
 ## consulting-analystの機能
 
@@ -114,7 +155,8 @@ White Paper向けの分析を作成して
 
 ### 前提条件
 
-- GitHub Copilot CLIがインストールされていること
+- GitHub Copilot（CLIまたは対応IDEのエージェントモード）かClaude Codeがインストールされていること
+- インストーラー用のNode.js 18以上とnpm
 - tech-writerの構造lintを実行する場合はPython 3.9以上
 - 同梱`japanese-prose`の文章lint、読解負荷分析、アウトライン抽出、用語検査、編集前後の不変条件検査を実行する場合はPython 3.10以上と`uv`。GiNZA、`ja_ginza`、spaCy、Markdown解析用の依存関係は、各スクリプトの初回実行時に`uv`が解決
 
@@ -127,22 +169,52 @@ npm install --save-dev kotonoha
 npx kotonoha install
 ```
 
+`npm install`はパッケージの導入だけを行います。エージェントの選択画面は表示せず、スキルディレクトリにも自動で書き込みません。
+
+### GitHub Copilot・Claude Code・両方を選択
+
+`--agent`はkotonoha `0.5.0`以降で利用できます。`0.4.2`などの旧版では使えないため、先にnpmパッケージを更新してください。
+
+```bash
+npx kotonoha install --agent copilot   # .github/skills/
+npx kotonoha install --agent claude    # .claude/skills/
+npx kotonoha install --agent all       # 両方のディレクトリ
+```
+
+未指定時は従来どおり`--agent copilot`です。`--agent`で配置先のエージェント、`--skill`で導入するスキルを選びます。両エージェントには同じSkillファイル、スクリプト、テンプレートを配置します。エージェント本体のインストール、認証設定、各スキルのPython・Node実行依存の準備は行いません。
+
+エージェントとスキルの選択は組み合わせられます。
+
+```bash
+npx kotonoha install --agent claude --skill tech-writer
+npx kotonoha install --agent all --skill obsidian-bases
+npx kotonoha install --agent all --force
+```
+
+既存ディレクトリの保護と`--force`は、選択した各配置先に適用します。明示した単一スキルがどちらかの配置先に存在する場合、コピー開始前に処理を止めます。ただし、コピー中のファイルシステムエラーでは、それ以前のコピーが残ることがあります。複数の配置先をまとめて元に戻す機能はありません。
+
+単一エージェントでは`--target`で配置先を変更できます。`--agent all`と`--target`は併用できません。配置先を個別に変える場合は、エージェントごとに実行します。
+
+この選択はファイルの配置先を決めるもので、エージェント間の隔離ではありません。Copilotも`.claude/skills`を認識するため、Claude向けに配置してもCopilotからの読み込みは防げません。対応する配置先は、公式資料（[CopilotのSkill説明](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills)、[Claude CodeのSkill説明](https://code.claude.com/docs/en/skills)）を参照してください。
+
 ### 同梱スキルをまとめてインストール
 
-`kotonoha install`は、まだ存在しない同梱スキルをすべてインストールします。次のコマンドは、`consulting-analyst`、`tech-writer`、`japanese-prose`、`obsidian-vault`、`presentation-planner`を`.github/skills/`へインストールします。
+`kotonoha install`は、まだ存在しない同梱スキルをすべてインストールします。`consulting-analyst`、`tech-writer`、`japanese-prose`、`obsidian-vault`、`obsidian-canvas`、`obsidian-bases`、`presentation-planner`を`.github/skills/`へインストールします。
 
 ```bash
 npm install --save-dev kotonoha
 npx kotonoha install --skill all
 ```
 
-`--skill all`が既定値であるため、`npx kotonoha install`も同じ動作です。5つのスキルがインストールされたことを確認します。
+`--skill all`が既定値であるため、`npx kotonoha install`も同じ動作です。7つのスキルがインストールされたことを確認します。0.4.1はCanvasとBasesを含まない5つでした。
 
 ```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/obsidian-vault/SKILL.md
+test -f .github/skills/obsidian-canvas/SKILL.md
+test -f .github/skills/obsidian-bases/SKILL.md
 test -f .github/skills/presentation-planner/SKILL.md
 ```
 
@@ -183,13 +255,14 @@ README-ja.mdの日本語を自然で読みやすい表現に修正して
 新しい日本語文書では、`このリポジトリの日本語READMEを作成して`のように依頼すると、`tech-writer`が下書きと構造レビューを行い、rubber-duck reviewの前にGiNZAベースの文章最適化を実行します。文章最適化を確実に指定する場合は、`<ファイル名>を技術文書として作成または修正し、GiNZAによる日本語表現最適化まで実施して`と指示します。
 
 既定のインストール先は、現在のプロジェクトの`.github/skills/`です。
-consulting-analyst、tech-writer、japanese-prose、obsidian-vault、presentation-plannerをそれぞれのサブディレクトリに配置します。
+consulting-analyst、tech-writer、japanese-prose、obsidian-vault、obsidian-canvas、obsidian-bases、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 --agent claude
+npx kotonoha install --agent claude --target ~/.claude/skills
 npx kotonoha install --target ~/.copilot/skills
 ```
 
@@ -229,8 +302,12 @@ npmパッケージを更新しても、コピー済みのスキルは自動更
 
 ```bash
 npx kotonoha install --force
+npx kotonoha install --agent claude --force
+npx kotonoha install --agent all --force
 ```
 
+上記のうち、初回の導入と同じ`--agent`に対応するコマンドを1つ実行します。最初のコマンドが更新するのは、既定のCopilot向け配置先だけです。
+
 スキルを1つだけ更新する場合は、次のように実行します。
 
 ```bash
@@ -250,7 +327,7 @@ npx kotonoha install --target ~/.copilot/skills --force
 
 ```bash
 npx kotonoha --version
-git diff -- .github/skills
+git diff -- .github/skills .claude/skills
 ```
 
 `--force`なしで`npx kotonoha install`を実行しても既存のスキルディレクトリは更新されず、不足しているスキルだけがインストールされます。
@@ -265,12 +342,15 @@ git diff -- .github/skills
 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/obsidian-vault /path/to/your-repo/.github/skills/obsidian-vault
+cp -r skills/obsidian-canvas /path/to/your-repo/.github/skills/obsidian-canvas
+cp -r skills/obsidian-bases /path/to/your-repo/.github/skills/obsidian-bases
 cp -r skills/presentation-planner /path/to/your-repo/.github/skills/presentation-planner
 ```
 
-## Copilotに文書作成を依頼
+## Copilot・Claude Codeに文書作成を依頼
 
-Copilot CLIセッションで必要な文書種別を依頼すると、対応するスキルが自動的に呼び出されます。
+CopilotまたはClaude Codeのセッションで必要な文書種別を依頼すると、対応するスキルが自動的に呼び出されます。
 
 - 「READMEを書いて」「この設計書をレビューして」「PR説明文を書いて」「この手順書を分かりやすくして」
 - 「要件定義書を作って」「承認済み要件からシステム設計書を書いて」「移行計画とRunbookを作って」
@@ -311,10 +391,20 @@ skills/presentation-planner/ # シナリオ、デザイン仕様、PPTX引き継
   references/                # 責任境界、シナリオ・デザインガイド、カスタマイズ、引き継ぎ契約
   assets/scenario-templates/ # 経営判断、技術説明、データ報告向けシナリオ
   assets/design-templates/   # 経営提案、技術説明、データ報告向けYAMLデザイン
+skills/obsidian-vault/       # 許可範囲のMarkdown操作と共用保存API
+skills/obsidian-canvas/      # JSON Canvas診断、配置、承認付き保存
+  scripts/                   # 固定依存のオフラインCLIと独自受入データの試験
+  assets/templates/          # 関係図、アイデア、手順、比較の構成例
+skills/obsidian-bases/       # Basesの直接編集と読み取り専用検査
+  scripts/                   # 標準入力の検査器、専用依存のlock、作業コピー用の試験
+  assets/templates/          # Table、Cards、List、Kanban
 .github/skills/tech-writer   # Copilot CLIが読み込むskills/tech-writerへのシンボリックリンク
 .github/skills/consulting-analyst
 .github/skills/japanese-prose
 .github/skills/presentation-planner
+.github/skills/obsidian-vault
+.github/skills/obsidian-canvas
+.github/skills/obsidian-bases
 ```
 
 ## 既知の制約

package/README.md

@@ -1,6 +1,6 @@
 # kotonoha
 
-kotonoha provides GitHub Copilot CLI skills for consulting analysis, technical
+kotonoha provides skills for GitHub Copilot and Claude Code: 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
@@ -10,7 +10,12 @@ 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.
 The `obsidian-vault` skill applies scoped Vault conventions and link diagnostics
-and saves new or proofread notes only after explicit plan approval.
+and directly creates or edits authorized Markdown notes using host file tools,
+with optional CLI plan-approved saving. Direct editing is included in 0.4.2.
+The `obsidian-canvas` skill adds scoped diagram diagnosis,
+layout and approval-gated Canvas edits in 0.4.2.
+The `obsidian-bases` skill adds direct `.base` configuration editing
+and a read-only static checker for Table, Cards, List and Kanban.
 
 [English](./README.md) | [日本語](./README-ja.md)
 
@@ -119,24 +124,84 @@ for setup, placeholder handling, and limitations.
 
 ## Working with an Obsidian Vault
 
-Use the dedicated `obsidian-vault` skill for Vault conventions, note creation,
-related-note proposals, internal-link diagnosis and Japanese proofreading.
-Its local CLI requires Linux, CPython 3.12 and uv; it does not require
-Obsidian, MCP or plugins. Install `tech-writer` and `japanese-prose` alongside
-it for creation and proofreading, or install all skills.
+Use the dedicated `obsidian-vault` skill for Vault conventions, direct Markdown
+creation and editing, related-note proposals, internal-link diagnosis and Japanese
+proofreading. The direct-edit workflow uses host file tools without
+requiring Python, uv, Obsidian, MCP or plugins. Use `tech-writer` for document
+structure and `japanese-prose` for proofreading.
 
 The user explicitly selects the Vault, read scopes and model-context consent.
-Only `apply` writes a single approved `.md` note; a hash-bound plan, protected
-syntax checks and an exact semantic review are required for changed edits.
+Direct editing requires authorization for the exact target and changes, preserves
+unspecified content, refuses unsafe paths, and reads back the saved file.
+A request for a proposal or pre-save approval never authorizes a write.
+Direct edits use the user-specified working directory, or the current directory
+at request start by default. Relative targets resolve there unless explicitly
+Vault-relative; absolute targets stay unchanged. Edit the authorized target
+itself, not a session-state copy. This does not broaden the permitted Vault scope;
+auxiliary copies still need separate consent and a suitable location.
+Protected syntax checks and a hash-bound semantic review remain required for
+Japanese proofreading in either mode.
 Unresolved links are observations, not automatic repair requests.
-Runtime commands use `uv run --offline --locked --python 3.12`; dependency
-bootstrap needs separate consent. See the [Japanese workflow guide](skills/obsidian-vault/references/workflow.md)
+
+Optional CLI plan-approved saving remains available for creation and proofreading,
+not general content edits. Only `apply` writes in this mode, after exact plan
+approval. It requires Linux, CPython 3.12 and uv, using
+`uv run --offline --locked --python 3.12`; dependency bootstrap needs separate
+consent. Direct edits do not use the CLI's root lock, atomic commit or receipt-based
+replay protection, and must not be an automatic fallback from CLI failures.
+See the [Japanese workflow guide](skills/obsidian-vault/references/workflow.md)
 for requests, command examples, data retention and recovery.
 
-Saving is limited to verified local filesystems and conservatively refuses
-symlinks, unsupported ownership/modes, multiple hard links and all xattrs,
-including SELinux labels. Post-check external edits and LLM mistakes cannot
-be eliminated. The skill is not a host sandbox.
+Saving requires verifiable local regular files and preserved ownership/modes;
+symlinks, multiple hard links and unsupported attributes are refused.
+CLI saving additionally requires a verified filesystem and refuses all xattrs,
+including SELinux labels. Never remove attributes to bypass a refusal.
+Direct-edit failure and concurrency limitations are disclosed before saving;
+neither mode eliminates post-check external edits or LLM mistakes.
+The skill is not a host sandbox.
+
+## Working with Obsidian Canvas
+
+The dedicated `obsidian-canvas` skill handles note maps, mind maps, conditional
+workflows and evidence comparisons in JSON Canvas 1.0. It reads, diagnoses,
+lays out and edits `.canvas` files without opening Obsidian or fetching URLs.
+This feature is included in `kotonoha@0.4.2`.
+
+Install `obsidian-vault` alongside it with storage API version 1. A selective
+Canvas install does not silently add or replace siblings; an old backend
+reports a missing dependency. Japanese proofreading additionally requires
+`japanese-prose`. Runtime commands are locked and offline on Linux/Python 3.12.
+
+Every changed plan binds exact content, authorized ID/field changes, persisted
+evidence/proposal markings and the review. Selected text and labels require
+per-string semantic reviews when proofreading. Only an explicitly approved
+plan can save a single Canvas; source notes and attachments are unchanged.
+Unknown structure is diagnosis-only. Rendering, arbitrary Obsidian extensions
+and casefold filesystem behavior are not claimed as verified.
+See the [Japanese Canvas workflow](skills/obsidian-canvas/references/workflow.md)
+for scope, copying consent, partial results and uncertain-save recovery.
+
+## Working with Obsidian Bases
+
+`obsidian-bases` creates, reads, diagnoses and directly edits standalone `.base`
+files for Table, Cards, List and Kanban. It does not change source notes,
+Markdown properties or embedded base blocks. This feature is included in
+`kotonoha@0.4.2`.
+
+Authorized host tools save the exact target in the user-selected working
+directory (cwd by default). A Node >=18 stdin checker only validates text:
+no Vault paths, saving, expression evaluation or network. Prepare its private
+fixed dependencies explicitly with separate consent, using
+`npm ci --prefix <bases-dir>/scripts --ignore-scripts --no-audit --no-fund`;
+add `--offline` for a separately selected cache-only preparation.
+Installation ships the private lockfile but excludes dependency caches.
+
+Every filter/formulas change needs exact content/save authority; unfiltered
+display covers the whole Vault when opened. Unknown features, application version
+or incomplete checks block saving. Direct edits have no CLI lock, atomic commit
+or receipt protection. Rendering, real expression results and arbitrary host
+enforcement remain unverified. See the [Bases workflow](skills/obsidian-bases/references/workflow.md)
+for exact-byte preservation, four original templates and failure handling.
 
 ## What consulting-analyst does
 
@@ -186,7 +251,8 @@ handoff without inventing missing evidence.
 
 ### Prerequisites
 
-- GitHub Copilot CLI installed
+- GitHub Copilot (CLI or a supported IDE agent mode) or Claude Code installed
+- Node.js 18+ and npm for the installer
 - Python 3.9+ for tech-writer's structural lint
 - Python 3.10+ and `uv` for the edit-invariant gate and bundled GiNZA
   diagnostics such as prose lint,
@@ -203,11 +269,54 @@ npm install --save-dev kotonoha
 npx kotonoha install
 ```
 
+`npm install` installs the package only; it does not write to your agent's
+skill directories or prompt you to choose an agent.
+
+### Choose GitHub Copilot, Claude Code, or both
+
+Agent selection requires kotonoha `0.5.0` or later. Older packages such as
+`0.4.2` do not support `--agent`; update the npm package before using it.
+
+```bash
+npx kotonoha install --agent copilot   # .github/skills/
+npx kotonoha install --agent claude    # .claude/skills/
+npx kotonoha install --agent all       # both directories
+```
+
+The default is `--agent copilot`, preserving existing installations.
+`--agent` chooses the destination agent(s); `--skill` chooses the bundled
+skill(s). Both agents receive the same Skill files, scripts and templates.
+The installer does not install either agent application, configure credentials,
+or prepare Python/Node runtime dependencies for individual skills.
+
+You can combine agent and skill selection:
+
+```bash
+npx kotonoha install --agent claude --skill tech-writer
+npx kotonoha install --agent all --skill obsidian-bases
+npx kotonoha install --agent all --force
+```
+
+Existing-directory protection and `--force` apply separately in each selected
+root. An explicitly selected skill that already exists in either root blocks
+the operation before any Skill is copied. A later filesystem/copy error can
+still leave earlier copies installed; this is not a transaction across roots.
+
+For one agent, `--target` overrides its default root. Combining `--target`
+with `--agent all` is rejected; use separate commands for custom roots.
+
+Agent selection controls file placement, not isolation: Copilot can also
+discover `.claude/skills`. Installing for Claude does not prevent Copilot from
+loading those files. See the official
+[Copilot Skill locations](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills)
+and [Claude Code Skills](https://code.claude.com/docs/en/skills).
+
 ### Install all bundled skills together
 
 `kotonoha install` installs every packaged skill that is not already present.
 The following commands install `consulting-analyst`, `tech-writer`,
-`japanese-prose`, `obsidian-vault`, and `presentation-planner` into `.github/skills/`:
+`japanese-prose`, `obsidian-vault`, `obsidian-canvas`, `obsidian-bases`, and `presentation-planner`
+into `.github/skills/`:
 
 ```bash
 npm install --save-dev kotonoha
@@ -215,13 +324,15 @@ npx kotonoha install --skill all
 ```
 
 `--skill all` is the default, so `npx kotonoha install` has the same behavior.
-Confirm that all five skills were installed:
+Confirm that all seven skills were installed (0.4.1 had five):
 
 ```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/obsidian-vault/SKILL.md
+test -f .github/skills/obsidian-canvas/SKILL.md
+test -f .github/skills/obsidian-bases/SKILL.md
 test -f .github/skills/presentation-planner/SKILL.md
 ```
 
@@ -287,14 +398,17 @@ 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/tech-writer`, `.github/skills/japanese-prose`,
+`.github/skills/obsidian-vault`, `.github/skills/obsidian-canvas`,
+`.github/skills/obsidian-bases`, 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 --agent claude
+npx kotonoha install --agent claude --target ~/.claude/skills
 npx kotonoha install --target ~/.copilot/skills
 ```
 
@@ -341,8 +455,13 @@ skills. Reinstall all packaged skills after the package update:
 
 ```bash
 npx kotonoha install --force
+npx kotonoha install --agent claude --force
+npx kotonoha install --agent all --force
 ```
 
+Choose the command matching the original `--agent`; these are alternatives.
+The first updates only the default Copilot destination.
+
 To update only one skill:
 
 ```bash
@@ -364,7 +483,7 @@ committing them:
 
 ```bash
 npx kotonoha --version
-git diff -- .github/skills
+git diff -- .github/skills .claude/skills
 ```
 
 Running `npx kotonoha install` without `--force` is safe but does not update
@@ -383,12 +502,15 @@ into that repository's `.github/skills/`, `.claude/skills/`, or your global
 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/obsidian-vault /path/to/your-repo/.github/skills/obsidian-vault
+cp -r skills/obsidian-canvas /path/to/your-repo/.github/skills/obsidian-canvas
+cp -r skills/obsidian-bases /path/to/your-repo/.github/skills/obsidian-bases
 cp -r skills/presentation-planner /path/to/your-repo/.github/skills/presentation-planner
 ```
 
-## Ask Copilot for the document you need
+## Ask Copilot or Claude Code for the document you need
 
-Just ask for the document type you need in a Copilot CLI session, and it's
+Just ask for the document type you need in a Copilot or Claude Code session, and it's
 invoked automatically.
 
 - "Write a README", "Review this design doc", "Write the PR description",
@@ -430,10 +552,20 @@ skills/presentation-planner/ # storyline, design-spec, and PPTX handoff skill
   references/                # boundary, scenario/design guidance, customization, handoff contract
   assets/scenario-templates/ # executive, technical, and data-report narrative scenarios
   assets/design-templates/   # executive, technical, and data-report YAML designs
+skills/obsidian-vault/       # scoped Markdown notes and shared storage API
+skills/obsidian-canvas/      # JSON Canvas diagnosis, layouts, and approved saves
+  scripts/                   # locked offline CLI and original-fixture tests
+  assets/templates/          # note map, mind map, workflow, comparison
+skills/obsidian-bases/       # direct Bases configuration and read-only validation
+  scripts/                   # stdin checker, private dependency lock, checkout-only tests
+  assets/templates/          # Table, Cards, List, Kanban
 .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
+.github/skills/obsidian-vault
+.github/skills/obsidian-canvas
+.github/skills/obsidian-bases
 ```
 
 ## Known limitations