메뉴
設計・計画タスク時に、Obsidian vault から関連 ADR・contract・review・runbook を 必要最小限だけ集めて計画の精度を上げる。 次のときに使う: - 「計画を立てて」「設計して」「プランを作って」 - ADR や過去の決定を確認したい - Knowledge Trail / Knowledge Home や reproject-safe / immutable 設計が絡む
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
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".
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に記録して」「実装が終わったのでドキュメントに」と言ったとき、または設計上の判断を伴う変更を終えたときに使う。
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.
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.
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）の実装・修正に入るなら使う。
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）の実装・修正に入るなら使う。
| 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 | <計画・設計の対象> |
設計前に vault から正規コンテキストを集めるスキル。
目的は「たくさん読む」ことではなく、正しい文書を少数読むこと。
Claude Code の原則に合わせる:
$ARGUMENTS から次を確定する。
この段階では推測しすぎない。まだ結論は出さない。
最初に以下から必要なものだけ開く。
| 対象 | 参照先 |
|---|---|
| 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]]） |
ルール:
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 から拾うのは次だけ。
必要な場合だけ追加で確認する。
docs/review/:
既知の未達、是正指示、監査結果docs/runbooks/:
reproject、障害復旧、degraded mode などの運用制約docs/daily/:
直近 1-2 日の作業文脈運用文書は「設計を縛る事実」があるときだけ使う。
作業メモ全体を読み込まない。
次の衝突があれば必ず書く。
/loop）を現行として扱っている出力は 1 画面で読める長さを優先する。
## 計画コンテキストブリーフ
### 対象
- 何を決めるタスクか
### 関連 ADR
- [[000NNN]] タイトル — 今回効く判断だけ
### 適用される不変条件
- append-first
- reproject-safe
- versioned projection
### 参照すべき contract / plan
- 文書名と該当セクション
### 運用制約
- runbook / review 由来の制約だけ
### 潜在的な衝突
- 今回の設計で踏みやすい地雷