plan-context-loader

Étoiles9

Forks4

Mis à jour31 juillet 2026 à 07:50

設計・計画タスク時に、Obsidian vault から関連 ADR・contract・review・runbook を必要最小限だけ集めて計画の精度を上げる。次のときに使う: - 「計画を立てて」「設計して」「プランを作って」 - ADR や過去の決定を確認したい - Knowledge Trail / Knowledge Home や reproject-safe / immutable 設計が絡む

Installation

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Source

Kaikei-e

Kaikei-e/Alt

Ouvrir le dépôt GitHub Voir les dépôts du créateur

Téléchargement

Métiers associésSOC

Basé sur la classification professionnelle SOC

Spécialistes en gestion de projetsProfessions des affaires et des opérations financières·SOC 13-1082

Explorateur de fichiers

2 fichiers

SKILL.md

readonly

name	plan-context-loader
description	設計・計画タスク時に、Obsidian vault から関連 ADR・contract・review・runbook を必要最小限だけ集めて計画の精度を上げる。次のときに使う: - 「計画を立てて」「設計して」「プランを作って」 - ADR や過去の決定を確認したい - Knowledge Trail / Knowledge Home や reproject-safe / immutable 設計が絡む
allowed-tools	Bash, Read, Glob, Grep, Agent, mcp__obsidian__view, mcp__obsidian__get_workspace_files
argument-hint	<計画・設計の対象>

Plan Context Loader

設計前に vault から正規コンテキストを集めるスキル。
目的は「たくさん読む」ことではなく、正しい文書を少数読むこと。

Claude Code の原則に合わせる:

まず探索し、その後に計画する
必要な文書だけ読む
長い引用ではなく短いブリーフに圧縮する
実装判断が割れる点だけを前面に出す

ワークフロー

1. タスクを 1 行で言い換える

$ARGUMENTS から次を確定する。

影響サービス
対象ドメイン
主要な不変条件
調べるべき論点

この段階では推測しすぎない。まだ結論は出さない。

2. 先に正規 contract を当てる

最初に以下から必要なものだけ開く。

対象	参照先
Knowledge Trail	`docs/plan/knowledge-trail-core-concept.md`
Trail 実装 wave	`docs/plan/knowledge-trail-implementation-plan.md`
イミュータブルデータモデル	`docs/wiki/architecture/immutable-data-model.md` + Trail §C
Knowledge Home（価値・入口）	`docs/plan/knowledge-home-value-position-plan.md`
Loop / Home phase0 / IMPL_*	historical — 現行契約として開かない（[[000940]]）

ルール:

全文を読むのではなく、対象論点の節だけを開く
contract と食い違う既存案があるかを先に見る
Trail plan は core-concept + implementation-plan の 2 文書上限（3 つ目を作らない）

3. ADR を少数読む

ADR は 2-6 件の高信号なものに絞る。
現行契約は status: accepted かつ inbound supersedes が無いものに限る。
docdag resolve <id> で葉（現行後継）を確認する。
superseded / inbound 置換済み / Loop・IMPL_*（[[000940]]）は historical — 現行契約として開かない。
Related は must-read にしない（参考のみ）。

検索例:

grep -rl "affected_services:.*<service>" docs/ADR/ | sort | tail -10
grep -rl "tags:.*<tag>" docs/ADR/ | sort | tail -10
grep -rl "<keyword>" docs/ADR/ | sort | tail -10
docdag resolve 000929   # → 000940
docdag validate         # status / stub / cycle

各 ADR から拾うのは次だけ。

なぜその判断が必要だったか
何を固定したか
今回の計画に効く制約は何か

4. review / runbook / daily を補助的に拾う

必要な場合だけ追加で確認する。

docs/review/: 既知の未達、是正指示、監査結果
docs/runbooks/: reproject、障害復旧、degraded mode などの運用制約
docs/daily/: 直近 1-2 日の作業文脈

運用文書は「設計を縛る事実」があるときだけ使う。
作業メモ全体を読み込まない。

5. 衝突を明示する

次の衝突があれば必ず書く。

既存案が canonical contract と矛盾する
read model を source of truth 扱いしている
reproject-safe を壊す副作用更新がある
feature flag の意図と恒久設計が混線している
Loop 時代の語彙（4-bucket / primary surface /loop）を現行として扱っている

6. 短いコンテキストブリーフを出す

出力は 1 画面で読める長さを優先する。

## 計画コンテキストブリーフ

### 対象
- 何を決めるタスクか

### 関連 ADR
- [[000NNN]] タイトル — 今回効く判断だけ

### 適用される不変条件
- append-first
- reproject-safe
- versioned projection

### 参照すべき contract / plan
- 文書名と該当セクション

### 運用制約
- runbook / review 由来の制約だけ

### 潜在的な衝突
- 今回の設計で踏みやすい地雷

守ること

先に探索、あとで計画
読む文書は少なく、要約はさらに短く
引用の羅列ではなく、意思決定に必要な差分だけ残す
不変条件を満たさない既存案は、その場で明示して止める

Plus depuis ce dépôt

même dépôt

tdd-workflow

Kaikei-e/Alt

Drive Alt changes test-first in outside-in order — E2E (Playwright/Hurl) → CDC (Pact) → Unit (RED-GREEN-REFACTOR) — and close with a local CI parity sweep (format/lint/type/security) for every touched microservice. Use when implementing a feature, fixing a bug, or refactoring, when deciding what test to write first, or when the user says "TDDで". Also use before declaring work complete, since "tests pass" is not "CI will pass".

2026-07-319

alt-adr-writer

Kaikei-e/Alt

Alt の Architecture Decision Record を日本語で `docs/ADR/NNNNNN.md` に書き起こす。番号採番、frontmatter（title/date/status/tags/affected_services/aliases/supersedes）、Context・Decision・Consequences の書き分け、wikilink 形式、OSS 公開向けの情報衛生を扱う。実装が一段落して決定を記録するときに使う。ユーザが「ADR書いて」「ADRにまとめて」「ADRに記録して」「実装が終わったのでドキュメントに」と言ったとき、または設計上の判断を伴う変更を終えたときに使う。

2026-07-319

grill-with-docs

Kaikei-e/Alt

Interrogate a plan against the project's documented decisions and domain language — challenging fuzzy terms, cross-referencing the code, and surfacing where the plan contradicts an existing ADR or canonical contract. Use when the user wants a plan stress-tested against what the project has already decided, rather than in the abstract. Prefer plain grill-me when there is no documented model to test against, and plan-context-loader when the goal is to gather vault context rather than be questioned.

2026-07-319

improve-codebase-architecture

Kaikei-e/Alt

Hunt for deepening opportunities — shallow modules whose interface costs as much to learn as their implementation saves — and present them as a visual before/after report, informed by the decisions already recorded in docs/ADR/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, reduce the cost of understanding a subsystem, or make code more testable. Use clean-architecture instead when the question is whether a specific change violates Alt's layer rules.

2026-07-319

bp-go

Kaikei-e/Alt

Alt の Go 規約を適用する。エラーラップ、context 第一引数、slog、テーブル駆動テスト、http.Server の 4 タイムアウト、Redis Streams の XACK/XAUTOCLAIM 対、fail-fast 設定を扱う。Go のコードを書く・直す・レビューするときに使う。ユーザが「Go」や規約名に触れなくても、Go サービス（alt-backend, auth-hub, pre-processor, search-indexer, mq-hub, rag-orchestrator, altctl）の実装・修正に入るなら使う。

2026-07-279

bp-python

Kaikei-e/Alt

Alt の Python 3.14+ 規約を適用する。型ヒント必須と Pyrefly、具体例外と原因チェーン、Pydantic/frozen dataclass の境界保護、asyncio と同期推論の分離、spawn プロセスプール、起動時 fail-closed を扱う。Python のコードを書く・直す・レビューするときに使う。ユーザが「Python」や規約名に触れなくても、Python サービス（news-creator, tag-generator, metrics, recap-subworker, recap-evaluator, acolyte-orchestrator）の実装・修正に入るなら使う。

2026-07-279

name	plan-context-loader
description	設計・計画タスク時に、Obsidian vault から関連 ADR・contract・review・runbook を必要最小限だけ集めて計画の精度を上げる。次のときに使う: - 「計画を立てて」「設計して」「プランを作って」 - ADR や過去の決定を確認したい - Knowledge Trail / Knowledge Home や reproject-safe / immutable 設計が絡む
allowed-tools	Bash, Read, Glob, Grep, Agent, mcp__obsidian__view, mcp__obsidian__get_workspace_files
argument-hint	<計画・設計の対象>

Plan Context Loader

設計前に vault から正規コンテキストを集めるスキル。
目的は「たくさん読む」ことではなく、正しい文書を少数読むこと。

Claude Code の原則に合わせる:

まず探索し、その後に計画する
必要な文書だけ読む
長い引用ではなく短いブリーフに圧縮する
実装判断が割れる点だけを前面に出す

ワークフロー

1. タスクを 1 行で言い換える

$ARGUMENTS から次を確定する。

影響サービス
対象ドメイン
主要な不変条件
調べるべき論点

この段階では推測しすぎない。まだ結論は出さない。

2. 先に正規 contract を当てる

最初に以下から必要なものだけ開く。

対象	参照先
Knowledge Trail	`docs/plan/knowledge-trail-core-concept.md`
Trail 実装 wave	`docs/plan/knowledge-trail-implementation-plan.md`
イミュータブルデータモデル	`docs/wiki/architecture/immutable-data-model.md` + Trail §C
Knowledge Home（価値・入口）	`docs/plan/knowledge-home-value-position-plan.md`
Loop / Home phase0 / IMPL_*	historical — 現行契約として開かない（[[000940]]）

ルール:

全文を読むのではなく、対象論点の節だけを開く
contract と食い違う既存案があるかを先に見る
Trail plan は core-concept + implementation-plan の 2 文書上限（3 つ目を作らない）

3. ADR を少数読む

検索例:

grep -rl "affected_services:.*<service>" docs/ADR/ | sort | tail -10
grep -rl "tags:.*<tag>" docs/ADR/ | sort | tail -10
grep -rl "<keyword>" docs/ADR/ | sort | tail -10
docdag resolve 000929   # → 000940
docdag validate         # status / stub / cycle

各 ADR から拾うのは次だけ。

なぜその判断が必要だったか
何を固定したか
今回の計画に効く制約は何か

4. review / runbook / daily を補助的に拾う

必要な場合だけ追加で確認する。

docs/review/: 既知の未達、是正指示、監査結果
docs/runbooks/: reproject、障害復旧、degraded mode などの運用制約
docs/daily/: 直近 1-2 日の作業文脈

運用文書は「設計を縛る事実」があるときだけ使う。
作業メモ全体を読み込まない。

5. 衝突を明示する

次の衝突があれば必ず書く。

既存案が canonical contract と矛盾する
read model を source of truth 扱いしている
reproject-safe を壊す副作用更新がある
feature flag の意図と恒久設計が混線している
Loop 時代の語彙（4-bucket / primary surface /loop）を現行として扱っている

6. 短いコンテキストブリーフを出す

出力は 1 画面で読める長さを優先する。

## 計画コンテキストブリーフ

### 対象
- 何を決めるタスクか

### 関連 ADR
- [[000NNN]] タイトル — 今回効く判断だけ

### 適用される不変条件
- append-first
- reproject-safe
- versioned projection

### 参照すべき contract / plan
- 文書名と該当セクション

### 運用制約
- runbook / review 由来の制約だけ

### 潜在的な衝突
- 今回の設計で踏みやすい地雷

守ること

先に探索、あとで計画
読む文書は少なく、要約はさらに短く
引用の羅列ではなく、意思決定に必要な差分だけ残す
不変条件を満たさない既存案は、その場で明示して止める