claudecode

Use when locating a function, option, symbol, or "where is X handled/implemented" inside this system's own packages (SourceVault, ClaudeOrchestrator, ClaudeRuntime, NBAccess, claudecode, github) — i.e. the initial narrowing step of a code-investigation task, before reading files. Prefer SourceVault MCP packageapi mining over a broad full-text rg sweep of $packageDirectory. Covers concept-token query discipline, sourcevault_get view=body, freshness (StaleDocs) handling, filters.packages scoping, and the bounded grep fallback.

Manipulate/DynamicModule/Dynamic ベースの一覧パネル (SourceVault ワークフロー一覧・ 保存プロンプト一覧など) が「一瞬フリーズしてから $Aborted」になり中身が出ない事故の 原因と直し方。真因は (1) DynamicModule の body や Dynamic[...] の中身の評価は FE の 評価予算で外部 Abort される (通常セル評価と違い時間切れで $Aborted になる)、 (2) Grid 描画 Dynamic の中で「行ごとに重い全走査関数」を呼ぶと row*N 倍のコストで 予算超過する、の 2 点。重いデータは DynamicModule の外 (公開関数の通常評価) で先に 算出して焼き込み、繰り返し読む registry はキャッシュし、行ごとの重い lookup は NextFire 等の不要フィールド計算を外す。headless で再現しないときは FE だけがロード する副パッケージ (SourceVault_autotrigger 等) の差分を疑う。 Use when a Wolfram panel/palette shows $Aborted (especially after a brief FE freeze) instead of its list/grid, when a DynamicModule/Manipulate UI is slow to render or gets aborted, when adding per-row badges/status cells to a list Grid, or when a UI bug reproduces in the FrontEnd but not in headless wolframscript. 関連 rules: 95 (ScheduledTask 安全)。関連 skill: ui-output-font-customization, wolfram-syntax-pitfalls。

Use when generating or updating package documentation with ClaudeCreateDocumentation or ClaudeUpdateDocumentation. Covers resumption after limits, README structure, document queue ordering, and option usage.

Use when the user reports the SourceVault MCP server (or any SourceVault detached service) is stuck "停止中"/Stopped and clicking the palette toggle does not bring it back, when SourceVaultMCPRunningQ stays False, or when diagnosing detached WL service kernel + Python proxy lifecycle (start/stop/restart/heartbeat/scheduled-task/per-machine runtime) issues in SourceVault_servicemanager.wl. Covers the stale status.json "Running" after a kernel crash trap, the PidAlive gate, runtime file inspection, and immediate recovery.

SourceVault.wl の ingest 済みソース行 (SourceVaultSources / SourceVaultArXiv) の Summary 列を埋める設計 (2026-06-24 実装)。arXiv ソースは ingest 時にアブストラクトを arXiv API から取得し $Language へ翻訳して meta["Summary"] に格納する (iIngestURL フック、 同期/非同期両カバー、TimeConstrained best-effort)。既存ソースは公開 API SourceVaultBackfillArXivSummaries[] で backfill。翻訳は cloud LLM (arXiv は公開なので PL 0.0)、iSVLooksLikeLLMError ゲートで利用制限/エラー本文の保存を防ぐ、失敗時は原文 fallback。 Use when implementing or modifying source-row Summary population, arXiv abstract fetch, ingest-time enrichment, or summary translation in SourceVault. 表示パスを LLM-free に保つ 原則と headless $Language 罠を含む。

Use when generating or editing .wl or .m files, dealing with Unicode escapes, Windows Mathematica encoding issues, Japanese identifiers, or RegularExpression patterns in Wolfram Language.

Use for Wolfram Language / Mathematica coding, editing, notebook output style, package conventions, and overall implementation constraints in this environment. Especially relevant for .wl, .m, and .nb work.

Wolfram Language で踏みやすい syntax / semantic / 評価モデルの罠とその 確実な回避策をまとめた skill。Mathematica で大規模パッケージを書くときに 繰り返し遭遇する未文書化挙動・優先順位ミス・スコープ問題などを記録する。 特に Module / Return / Catch/Throw / Quiet/Check / 評価スタックの相互作用 には未文書化の罠が多いため、最初から「何を使わない」と決めて純粋な if/else 評価で組むのが最も安全。

ClaudeEval のプロンプトが LM Studio 等の短コンテキストモデルでトークン超過する (n_keep >= n_ctx) 事故の診断と修正。X0a (context budget / bounded assembly)、 X0b-1 (history 境界・planner hook 配線)、X1 (prompt-only 依存分類器 + planner) の as-built メモ。真因の特定法 (推測でなく実測)、単一チョークポイント戦略 ($UseClaudeRuntime True/False の両経路をカバー)、planning フラグと各予算変数、 pkgDocs キーワード過剰マッチの教訓。ClaudeEval が「保存済み候補」UI で堂々巡り する別件 (saved-prompt 提案) との切り分けも含む。決定的 FunctionRoute (「新規ノートブック」→ SourceVaultNewNotebook 等) が ClaudeOrchestrator 未ロード時に 活性ゲートで遮断され LLM に流れる不具合の診断・修正 (deterministic 提案はゲート迂回) も収録。

実行環境の電源状態（AC / バッテリー）に応じて、プロンプト・ルーティングが使う light モデル階層を Local / Cloud / Off に自動・手動で切り替える機能の実装メモ。 ノートPC のバッテリー運用時にローカル LLM 起動を避け、クラウド light（Haiku 相当） に回す、または停止する運用。Windows での AC/バッテリー検出方法、package-neutral hook（claudecode 所有・SourceVault 弱参照）、パレットのトグル UI、契約層 `SourceVaultResolveModelForPromptRouter` への配線、rule 02/11 準拠、既知の モデル分類ギャップ（spec §12.1.1）を含む。

Runtime ClaudeEval ($UseClaudeRuntime = True) が「無関係な/既存の/承認ボタン直後の セル」を confidential (pink 背景・PrivacyLevel 1.0) に誤マークする事故の診断と修正。 原因は 2 つ: (1) auto-mark が dispatch 時 cell 数 + 位置範囲ベースで、非同期中に 増えたセルや末尾セルを巻き込む。(2) ローカルモデルが accessLevel 1.0 で無条件 autoMark → echo した良性コードセルを機密化 → 変数が機密化 → iPrecisionConfidentialCheck の依存スキャンが連鎖して無関係セルをマーク。ローカル light モデル使用時に頻発。 機密マークの誤爆・variable taint cascade・iAutoMarkNewCellsConfidential の話。

Use when the user asks about email, mail, メール, 〆切, deadline, 受信, inbox, 返信, reply, IMAP, or references a mail database (univ, hu2022, apple, etc.). 正準システムは SourceVault mail サブシステム (SourceVault_maildb.wl, context SourceVault`): SourceVaultMailEnsureLoaded / SourceVaultMailView / SourceVaultSearchMailSnapshots / SourceVaultInferMailDerivedBatch / SourceVaultMailFetchNew / SourceVaultRegisterMailAccount。旧 maildb.wl は maildb_legacy.wl に改名され参照専用 (mailEnsureLoaded/showMails/searchFromMails/mailAskLLM は新規コードで使わない)。Security routing: privacy > 0.5 は $ClaudePrivateModel (ローカル LLM)。

Use when creating slide images (16:9 PNG) that must visually match the user's Mathematica notebook presentation deck — white background, orange heavy title, maroon square nested bullets (3 levels + gray sub-sub), Hiragino Japanese fonts, no-bullet paragraph items. Covers the HTML+headless-browser pipeline (reliable for Japanese, easy multi-column), the exact style spec / color / Hiragino font palette, the two-column layout the Mathematica deck cannot do natively, and the render command. Worked examples: Templates/Slides/mathematica-style-twocolumn-slide.html and mathematica-style-bullets-levels.html.

ClaudeRuntime と ClaudeOrchestrator の責務境界、特に並列化の許容範囲を判定する。Use when adding new functionality to either ClaudeRuntime or ClaudeOrchestrator, especially involving parallelism, retry, approval, worker spawning, or workflow state. Workflow Migration プロジェクト (stategraph → ClaudeOrchestrator`Workflow` 吸収) の Stage A〜C を進める間は常時参照。

Use when the user asks to "open" a file, folder, notebook, or design document. Generates SystemOpen[] calls that launch files/folders in the OS default application. Does NOT read/write file contents.

ClaudeEval / ClaudeQuery にセキュリティ・プライバシーのガード (クラウド送信拒否、 Private ノートブック保護、機密チェック等) を追加するときの正しい配置位置。 $UseClaudeRuntime=True で Runtime Bridge 経由になるとガードを通らない落とし穴、 dispatch (PromptRouter/Orchestrator hook) より前に置く必要性を扱う。 Stage 9 P1.5 の Private ノートブック保護で実装・実証済み。

SourceVault.wl Stage 6b の Compiled Registry + Seed bootstrap 設計。 SourceVaultLookup / SourceVaultResolve / ClaudeResolveModel 互換 wrapper、 seeds/<topic>-seed.json と compiled/<channel>/<topic>.json の 2 階建てストレージ、 channel 分離 (public / private)、Availability/Freshness/Class の優先順位 sort、 AllowSeed -> False で厳格モード、Stage 1 旧定義 (in-memory) 削除の経緯、 iModelSeedEntries による自動 bootstrap (claudecode/anthropic/openai/lmstudio 6 entries)、 仕様書 §4.5 / §5.4 / §8.1 / §11 / §14.10 の最小実装。

Append-only JSONL ストア + 多重インデックス (master + by-X) の設計テンプレ。 各 record を 1 行 1 JSON で書き、別軸 (topic / source / etc.) の jsonl ファイルに 並行で重複 append する。Wolfram Language で書く時の Windows CRLF + UTF-8 対応 (罠 #20)、安全な OpenAppend、頑健な ReadByteArray 読み込みを含む。 SourceVault.wl Stage 5 ClaimStore で実装・実証済み。

claudecode.wl の LLMGraphDAGCreate で起動した DAG ジョブの扱いで躓きやすい 2 挙動 (完了ジョブの registry 自動削除、$iLLMGraphDAGJobs の context 解決が予測しにくい問題) と安全な扱い方。Use when retrieving DAG job results, observing LLMGraphDAG job state, or debugging why a finished job disappears from the registry in claudecode.wl.

外部パッケージ (ClaudeStateGraph 等) から NotebookLLMGraph のノードを追加・更新するときの正しいパターン。誤ると書き込んだノードが直後の NotebookLLMGraphNodes[] で見えないバグになる。直接キャッシュ更新 + Flush、必要な Public 化シンボルを扱う。Use when adding or updating NotebookLLMGraph nodes from an external package, or when written nodes are not visible afterward.

SourceVault.wl Stage 9 Phase 1 (P0) の Notebook Management 拡張設計。 Mathematica notebook を first-class source として扱い、先頭 Input セルから Header Association を HoldComplete + whitelist で safe parse、TodoItem cell を style 経由で列挙、TaggingRules や StrikeThrough を優先順位付きで Done 判定、7 種 lint (HeaderStatusTodoButNoOpenTodos、DeadlinePast、 NextReviewPast 等) で Header/Todo 不整合検出、deterministic SourceVaultFindNotebooks クエリ (OpenTodos/NextReview/Deadline/Keywords/Status)、notebooks/{sources,snapshots,todos,review,lint}/ の index 配置、Phase 2/3 (TaggingRules 標準化、semantic hash、ClaudeEval 統合) への伏線。 レビュー資料 sourcevault_notebook_review_todo_deadline.md と添付 notebook の実装。

既存パッケージ (claudecode.wl 等) の関数を新パッケージ (ClaudePackageManager.wl 等) に分離・移管するときの context shadowing 罠と回避パターン。BeginPackage の依存リスト無しが context path をリセットし既存関数が連鎖破損する問題を、Phase ごとの安全実装でまとめる。Use when splitting or migrating functions between Wolfram Language packages, or when a namespace migration breaks existing package functions.

SourceVault.wl の notebook source 鮮度管理・移動追跡・UUID 同定の設計 (2026-05-22 完成、Stage 9 P1 の次フェーズ)。SourceVaultSync (mtime 鮮度トークンで Stale な .nb を再 index)、SourceVaultRelinkSources (UUID / 内容ハッシュ / ファイル名の 3 段照合で移動した notebook を再リンク、シンボリックパス解決で別 PC のパス差を移動と誤検出しない、 StaleDuplicate 残骸判定)、Notebook UUID 埋め込み (TaggingRules SourceVault>NotebookUUID、 非破壊、ファイルと一緒に移動)。Use when implementing or modifying notebook source crawling, freshness/staleness detection, file-move tracking, re-linking, or notebook UUID embedding in SourceVault. notebooks/sync, notebooks/relink ストアの設計を含む。

Use when adding or changing display fonts in ClaudeEval / SourceVault / NBAccess UI output (Grid, Column, Style, Button, Tooltip, Hyperlink cells), or when a font / style / color setting "does not apply" to rendered notebook output. Especially relevant for $ClaudeStandardFont, iSVStandardFont, schedule/notebook list tables, and any helper that injects FontFamily into boxed output. Covers traps

Wolfram Language の実行時の文字列⇔バイト変換 (HTTP 送受信ボディ、JSON ファイル 読み書き) で非ASCII (日本語) が文字化けしないための手順。Windows の Mathematica は 暗黙にシステムエンコーディング (ShiftJIS/CP932) を使うため、HTTP / ファイル I/O の両方で 化ける。ExportString["RawJSON"] と Developer`WriteRawJSONString の戻り値エンコードの違い、 ISO8859-1 vs UTF-8 の使い分け、HTTPRequest の Body に ByteArray を渡す原則、 resp["BodyByteArray"] 受信を扱う。Use when sending/receiving HTTP request bodies, writing/reading JSON files, or debugging garbled Japanese in API calls or JSON stores in Wolfram Language. 制約は rules/30-encoding-safety.md、ソース内のエスケープ/regex は skill wl-encoding-and-regex を参照。

SourceVault.wl Stage 6a の claim dedup + Compact 設計。 by-source ファイル単位の ContentHash 照合による書込み時 dedup、 master 全体の DeleteDuplicatesBy + atomic rewrite による Compact、 最古残し (Reverse → DeleteDuplicatesBy → Reverse) パターン、 Windows 対応の path.tmp + DeleteFile + RenameFile atomic write、 .bak.<ISODateTime> backup の運用。dedup scope の意図的な制約。

claudecode.wl の Claude Code CLI 経路 (provider == "claudecode") で multimodal / vision API (Image・PDF page 画像 OCR 等) を使うときの設計と動作パターン。 Phase 35 で `iClaudeQueryBgAPIMultimodal` に CLI リダイレクトが追加され、 $ClaudeModel = {"claudecode", "..."} のまま画像 OCR が無課金で動くようになった 仕組み。SourceVault.wl Stage 4C OCR (ClaudeVision backend) で実証済み。

SourceVault.wl Stage 6c の Evidence Bundle 設計。 生成物 (.wl/.md/.tex/.nb 等) が依存した source/snapshot/claim を bundle として記録、 snapshot LifecycleStatus 集約による自動 stale 検出、手動 Invalidate の永続化、 bundles/<bundleId>.json による 1 bundle 1 ファイル設計、 Status 計算の優先順位 (Manual > Invalidated > NeedsReview > Stale > Current)、 Phase 2/3 (階層集約・hash-based stale・contradiction 検出) への伏線。 仕様書 §4.6/§5.7/§12.2/§17.5 の最小実装。

LLM (Claude Code CLI / Anthropic API 等) を使った構造化情報抽出パイプライン の設計テンプレ。Schema 駆動 prompt 構築、頑健な JSON parser (bracket counting + truncated 復旧)、iSanitizeForJSON サニタイズ、verbose モードによる診断機構を 含む。SourceVault.wl Stage 5 (Claim extraction) で実装済み・実証済み。

既存パッケージ (ClaudeOrchestrator 等) の worker prompt template に、 外部からドキュメントや指示を注入するときの prompt engineering パターン。 単純な prepend / append では LLM が「これは参照情報であって依存ではない」 と切り分けて応答を歪めることがある。 XML タグの選び方、明示的指示コメントの書き方、template placeholder ラベル の StringReplace 置換戦略、fallback としての prepend、を SourceVault.wl A5 hook 実装 (2026-05-18) で検証済みのパターンとして記録する。

NBAccess.wl Stage 9 P1 で追加された高レベル semantic API 7 個 (読み取り 3 + 書き込み 4) の設計詳細。 FrontEnd を起動せずに .nb ファイルを直接編集する atomic-write パイプライン、AccessLevel RBAC + DryRun 安全機構、 CellPath (List of Integer) による CellGroupData ネスト対応の cell 位置記録、Header と Todo metadata を区別する iNBIsHeaderLikeAssoc フィルタ、NBReadHeader の 3 経路 fallback (Notebook TaggingRules → Cell TaggingRules → BoxData MakeExpression)、 With[{c=v}, HoldComplete[c]] による DryRun の Before/After 値埋め込み (罠 #27 回避)、CellGroupData の再帰展開 (罠 #26 回避)、 Public API 仕様、内部ヘルパー設計、SourceVaultMarkTodo がこれを薄くラップする経路、Stage 9 P0 の Approval Workflow 経路との 使い分け、Stage 9 Phase 3 (P2) で予定されているバッチ Todo 操作・privacy profile route 分岐への伏線。 result22.nb〜result34.nb で実装・動作実証完了 (2026-05-20)、handoff_2026-05-20-stage9-p1.md と対応。

SourceVault.wl Stage 6d の NBAuthorize 2 段階統合設計。 SourceVaultExtract に sendDecision (LLM 送出前) + persistDecision (claim 保存前) を組み込み、 SourceVaultContext は RequireApproval も block する形に拡張。 4 種 Decision (Permit/Screen/RequireApproval/Deny) の扱い、iSpecFromClaim による NBClaimSpec 生成、 AccessLabel の元 source 継承、batch 判定 (代表 claim 1 件) の理由、 "AuthorizationCheck" -> False の opt-out スイッチ (regression 回避)、 レスポンス形式の AccessDecisions: <|"Send" -> _, "Persist" -> _|>、Phase 2 への伏線。 仕様書 §14.4.1 / §14.4.2 の最小実装。

SourceVault.wl Stage 4C で実装した 3 backend OCR 設計 (ClaudeVision / TextRecognize / Custom) と、その診断機構 (OCRAttempted / OCRFailReasons / $SourceVaultOCRVerbose) の skill。PDF page を Image 化して LLM や native OCR に流すパッケージを書くときの テンプレ。PDFIndex.wl の OCR パターン (上下分割 + 30px overlap) を踏襲。

既存パッケージの公開シンボル (e.g. ClaudeAttach, ClaudeAttachments) に対して 「元の動作を保ちつつ追加処理を挟む」hook を装着するときに踏みやすい罠と 検証済みの実装パターン集。 Block / OptionsPattern / Catch / DownValues / Memory registry の各層で 正しく組まないと、OptionValue::optnf、scheduled task からの不可視、Abort 時の hook 永続破損、冪等性違反などの不具合が出る。 SourceVault.wl P1〜P4 hook 統合 (2026-05-18) で実装・テスト完了したテンプレを 永続記録する。

SourceVault.wl Stage 8 の snapshot lifecycle + vN diff 設計。 page-hashes.json (Stage 4B) を使った snapshot 間の page hash 差分計算、 snapshot meta の LifecycleStatus を更新することで Bundle が lazy に自動 stale 化される passive consumer pattern、events/source-events.jsonl への append-only event log、 VersionedUpdate / Retraction / SourceDeletion / SchemaChange の 4 種 event、 RefreshSnapshot による diff + Stale + SupersededBy + event 一括処理、Phase 2/3 への伏線。 仕様書 §4.2.1 / §5.2 / §7.4 / §11.4 の最小実装。

ClaudeOrchestrator Workflow で「handler が非同期 LLM 呼び出しを投げて Status -> AwaitingLLM を返し、 callback または engine timer 経由で完了する」Z 案パターンの正しい書き方と落とし穴。 WorkflowNet, WorkflowTransition, ClaudeQueryAsyncSilent, ClaudeCompleteHandlerOutput, ClaudeAwaitingTransitions, AwaitingLLMTimeout, DefaultAwaitingLLMTimeout, ClaudeSnapshotWorkflow, ClaudeRestoreWorkflow, $iRestoreFallbackTimeout を扱うとき、または「非同期 handler」「awaiting LLM」「Z 案」「awaitId」「AwaitingLLMTransitions」「callback handler」「handler が AwaitingLLM」のいずれかの言葉が出たら必ずこのスキルを参照する。 また workflow が AwaitingLLM 状態で停滞している、 timeout 発火が動かない、 snapshot 復元後に完了しない、 callback が二重発火する、 といった症状の診断にも使う。

petri_from_prompt 系で複数 LLM プロバイダ (Claude / ChatGPT / 各種ローカル LLM 等) を並列に使う Petri net を生成するときの handler I/O 規約と Provider/Model 指定ルール。`AddProviderSupportToPetriPrompt[]` 経由で `$petriNetGuide` に注入される。LLM が petri net コードを書く際に参照する仕様書。

Use when the user reports odd behavior in adapter-path ClaudeEval (i.e. $UseClaudeRuntime = True). Typical symptoms include the tool_call text being written into a Column[{...}] cell verbatim, the LLM complaining "過去の検索結果が見えない" and re-searching repeatedly, the final LLM response not appearing in the notebook, web_search looping 4+ times, or LLM hallucinating an answer while ignoring rich tool results. This skill covers ClaudeTurnTrace, ConversationState inspection, and how to tell from an event trace where in the turn pipeline things went wrong.

Mathematica で Association を更新するときの安全パターン。ReplacePart は新規キー追加に使えない、Append / Join / AssociateTo / MapAt の使い分け、ネスト Association の更新方法を扱う。Use when writing or reviewing Wolfram Language code that mutates Association data structures (token registries, configuration maps, state objects), especially when adding new keys to nested structures.

Use when adding or modifying tool execution logic in the adapter path (`$UseClaudeRuntime = True`), especially when introducing parallel tool calls (e.g. `web_search`, future `web_fetch`), worrying about main kernel blocking during tool execution, or debugging AsyncToolExec state machine. Covers the Phase 32k Step 3 (Phase A-D2) design: how `iToolUseAndContinue` hybrid path classifies sync/async tool calls, how `iScheduleAsyncToolExecPoll` runs them in separate OS processes via `StartProcess`, and how `iAsyncToolExecFinalize` re-enters `ClaudeRunTurn` after completion. Also covers the WindowStatusArea update contract (Phase D2) for "0 sec stuck" prevention.