refactor: hard-fork GSD -> MSD (Make Software Done)
Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
This commit is contained in:
@@ -1,4 +1,4 @@
|
||||
# GSD Core アーキテクチャ
|
||||
# MSD Core アーキテクチャ
|
||||
|
||||
> コントリビューターおよび上級ユーザー向けのシステムアーキテクチャ文書です。ユーザー向けドキュメントは [機能リファレンス](FEATURES.md) または [ユーザーガイド](USER-GUIDE.md) をご覧ください。
|
||||
|
||||
@@ -21,7 +21,7 @@
|
||||
|
||||
## システム概要
|
||||
|
||||
GSD Core は、ユーザーと AI コーディングエージェント(Claude Code、Kimi CLI、OpenCode、Kilo、Codex、Copilot、Antigravity、Trae、Cline、Augment Code)の間に位置する **メタプロンプティングフレームワーク** です。以下の機能を提供します:
|
||||
MSD Core は、ユーザーと AI コーディングエージェント(Claude Code、Kimi CLI、OpenCode、Kilo、Codex、Copilot、Antigravity、Trae、Cline、Augment Code)の間に位置する **メタプロンプティングフレームワーク** です。以下の機能を提供します:
|
||||
|
||||
1. **コンテキストエンジニアリング** — タスクごとに AI が必要とするすべてを提供する構造化アーティファクト([コンテキストエンジニアリング](explanation/context-engineering.md) 参照)
|
||||
2. **マルチエージェントオーケストレーション** — フレッシュなコンテキストウィンドウで専門化されたエージェントを生成する薄いオーケストレーター([マルチエージェントオーケストレーション](explanation/multi-agent-orchestration.md) 参照)
|
||||
@@ -31,18 +31,18 @@ GSD Core は、ユーザーと AI コーディングエージェント(Claude
|
||||
```
|
||||
┌──────────────────────────────────────────────────────┐
|
||||
│ USER │
|
||||
│ /gsd-command [args] │
|
||||
│ /msd-command [args] │
|
||||
└─────────────────────┬────────────────────────────────┘
|
||||
│
|
||||
┌─────────────────────▼────────────────────────────────┐
|
||||
│ COMMAND LAYER │
|
||||
│ commands/gsd/*.md — Prompt-based command files │
|
||||
│ commands/msd/*.md — Prompt-based command files │
|
||||
│ (Claude Code custom commands / Codex skills) │
|
||||
└─────────────────────┬────────────────────────────────┘
|
||||
│
|
||||
┌─────────────────────▼────────────────────────────────┐
|
||||
│ WORKFLOW LAYER │
|
||||
│ gsd-core/workflows/*.md — Orchestration logic │
|
||||
│ msd-core/workflows/*.md — Orchestration logic │
|
||||
│ (Reads references, spawns agents, manages state) │
|
||||
└──────┬──────────────┬─────────────────┬──────────────┘
|
||||
│ │ │
|
||||
@@ -54,7 +54,7 @@ GSD Core は、ユーザーと AI コーディングエージェント(Claude
|
||||
│ │ │
|
||||
┌──────▼──────────────▼─────────────────▼──────────────┐
|
||||
│ CLI TOOLS LAYER │
|
||||
│ gsd-core/bin/gsd-tools.cjs │
|
||||
│ msd-core/bin/msd-tools.cjs │
|
||||
│ (State, config, phase, roadmap, verify, templates) │
|
||||
└──────────────────────┬───────────────────────────────┘
|
||||
│
|
||||
@@ -75,8 +75,8 @@ GSD Core は、ユーザーと AI コーディングエージェント(Claude
|
||||
|
||||
### 2. 軽量オーケストレーター
|
||||
|
||||
ワークフローファイル(`gsd-core/workflows/*.md`)は重い処理を行いません。以下の役割に徹します:
|
||||
- `gsd-tools.cjs init <workflow>` でコンテキストを読み込む
|
||||
ワークフローファイル(`msd-core/workflows/*.md`)は重い処理を行いません。以下の役割に徹します:
|
||||
- `msd-tools.cjs init <workflow>` でコンテキストを読み込む
|
||||
- 焦点を絞ったプロンプトで専門エージェントを起動する
|
||||
- 結果を収集し、次のステップにルーティングする
|
||||
- ステップ間で状態を更新する
|
||||
@@ -104,31 +104,31 @@ GSD Core は、ユーザーと AI コーディングエージェント(Claude
|
||||
|
||||
## コンポーネントアーキテクチャ
|
||||
|
||||
### コマンド(`commands/gsd/*.md`)
|
||||
### コマンド(`commands/msd/*.md`)
|
||||
|
||||
ユーザー向けのエントリーポイントです。各ファイルには YAML フロントマター(name、description、allowed-tools)とワークフローをブートストラップするプロンプト本文が含まれています。コマンドは以下の形式でインストールされます:
|
||||
|
||||
- **Claude Code:** カスタムスラッシュコマンド(ハイフン形式、`/gsd-command-name`)
|
||||
- **OpenCode / Kilo:** スラッシュコマンド(ハイフン形式、`/gsd-command-name`)
|
||||
- **Codex:** スキル(`$gsd-command-name`)
|
||||
- **Copilot:** スラッシュコマンド(ハイフン形式、`/gsd-command-name`)
|
||||
- **Claude Code:** カスタムスラッシュコマンド(ハイフン形式、`/msd-command-name`)
|
||||
- **OpenCode / Kilo:** スラッシュコマンド(ハイフン形式、`/msd-command-name`)
|
||||
- **Codex:** スキル(`$msd-command-name`)
|
||||
- **Copilot:** スラッシュコマンド(ハイフン形式、`/msd-command-name`)
|
||||
- **Antigravity:** スキル
|
||||
|
||||
**コマンド総数:** 信頼できる数と完全なロスターについては [`docs/INVENTORY.md`](INVENTORY.md#commands) を参照。
|
||||
|
||||
#### 2 段階の階層的ルーティング(v1.40、[#2792](https://github.com/open-gsd/gsd-core/issues/2792))
|
||||
|
||||
eager なスキルリストのトークンコストを低く保つため、v1.40 では 6 つの名前空間 **メタスキル**(`gsd-workflow`、`gsd-project`、`gsd-quality`、`gsd-context`、`gsd-manage`、`gsd-ideate` ——`commands/gsd/ns-*.md` から取得されるが、呼び出し可能な `name:` はここに示すベア形式)を具体的なサブスキルの上にレイヤーとして導入しています。モデルは平坦な 86 スキルリスト(約 2,150 トークン)の代わりに 6 つの名前空間ルーター(約 120 トークン)を見て名前空間を選択し、名前空間ルーターの本文に埋め込まれたルーティングテーブルを通じて具体的なサブスキルにルーティングします。名前空間スキルは **付加的** です——すべての具体的なコマンドは依然として直接呼び出し可能です。
|
||||
eager なスキルリストのトークンコストを低く保つため、v1.40 では 6 つの名前空間 **メタスキル**(`msd-workflow`、`msd-project`、`msd-quality`、`msd-context`、`msd-manage`、`msd-ideate` ——`commands/msd/ns-*.md` から取得されるが、呼び出し可能な `name:` はここに示すベア形式)を具体的なサブスキルの上にレイヤーとして導入しています。モデルは平坦な 86 スキルリスト(約 2,150 トークン)の代わりに 6 つの名前空間ルーター(約 120 トークン)を見て名前空間を選択し、名前空間ルーターの本文に埋め込まれたルーティングテーブルを通じて具体的なサブスキルにルーティングします。名前空間スキルは **付加的** です——すべての具体的なコマンドは依然として直接呼び出し可能です。
|
||||
|
||||
#### MCP トークンバジェットの相互作用
|
||||
|
||||
eager なスキルリストはターンごとの 2 つの主要コストの一つです。もう一つは `.claude/settings.json` で有効化されている各 MCP サーバーが注入する MCP ツールスキーマです。重量級の MCP サーバー(ブラウザ/playwright、Mac ツール、Windows ツール)はそれぞれターンごとに 20k+ トークンかかる場合があり、多くの場合 `model_profile` のチューニングで節約できるものをはるかに上回ります。トグルは Claude Code ハーネスにあります(`.claude/settings.json` の `enabledMcpjsonServers` / `disabledMcpjsonServers`)で、GSD の懸念事項ではありません。
|
||||
eager なスキルリストはターンごとの 2 つの主要コストの一つです。もう一つは `.claude/settings.json` で有効化されている各 MCP サーバーが注入する MCP ツールスキーマです。重量級の MCP サーバー(ブラウザ/playwright、Mac ツール、Windows ツール)はそれぞれターンごとに 20k+ トークンかかる場合があり、多くの場合 `model_profile` のチューニングで節約できるものをはるかに上回ります。トグルは Claude Code ハーネスにあります(`.claude/settings.json` の `enabledMcpjsonServers` / `disabledMcpjsonServers`)で、MSD の懸念事項ではありません。
|
||||
|
||||
### ワークフロー(`gsd-core/workflows/*.md`)
|
||||
### ワークフロー(`msd-core/workflows/*.md`)
|
||||
|
||||
コマンドが参照するオーケストレーションロジックです。以下を含むステップバイステップのプロセスが記述されています:
|
||||
|
||||
- `gsd-tools.cjs init` によるコンテキスト読み込み
|
||||
- `msd-tools.cjs init` によるコンテキスト読み込み
|
||||
- モデル解決を伴うエージェント起動の指示
|
||||
- ゲート/チェックポイントの定義
|
||||
- 状態更新パターン
|
||||
@@ -138,7 +138,7 @@ eager なスキルリストはターンごとの 2 つの主要コストの一
|
||||
|
||||
#### ワークフローのプログレッシブディスクロージャー
|
||||
|
||||
ワークフローファイルは、対応する `/gsd-*` コマンドが呼び出されるたびに Claude のコンテキストにそのまま読み込まれます。そのコストを制限するため、`tests/workflow-size-budget.test.cjs` で強制されるワークフローサイズバジェットはエージェントサイズバジェット規則を反映します:
|
||||
ワークフローファイルは、対応する `/msd-*` コマンドが呼び出されるたびに Claude のコンテキストにそのまま読み込まれます。そのコストを制限するため、`tests/workflow-size-budget.test.cjs` で強制されるワークフローサイズバジェットはエージェントサイズバジェット規則を反映します:
|
||||
|
||||
| ティア | ファイルごとの行数制限 |
|
||||
|-----------|--------------------|
|
||||
@@ -157,7 +157,7 @@ eager なスキルリストはターンごとの 2 つの主要コストの一
|
||||
|
||||
**エージェント総数:** 33
|
||||
|
||||
### リファレンス(`gsd-core/references/*.md`)
|
||||
### リファレンス(`msd-core/references/*.md`)
|
||||
|
||||
ワークフローとエージェントが `@-reference` で参照する共有知識ドキュメント(信頼できる数と完全なロスターについては [`docs/INVENTORY.md`](INVENTORY.md#references-41-shipped) を参照):
|
||||
|
||||
@@ -193,9 +193,9 @@ eager なスキルリストはターンごとの 2 つの主要コストの一
|
||||
- `user-profiling.md` — ユーザー行動プロファイリングの方法論
|
||||
- `thinking-partner.md` — 決定ポイントでの条件付きシンキングパートナー起動
|
||||
|
||||
### テンプレート(`gsd-core/templates/`)
|
||||
### テンプレート(`msd-core/templates/`)
|
||||
|
||||
すべてのプランニングアーティファクト用のMarkdownテンプレートです。`gsd-tools.cjs template fill` および `scaffold` コマンドにより、事前構造化されたファイルを作成するために使用されます:
|
||||
すべてのプランニングアーティファクト用のMarkdownテンプレートです。`msd-tools.cjs template fill` および `scaffold` コマンドにより、事前構造化されたファイルを作成するために使用されます:
|
||||
- `project.md`、`requirements.md`、`roadmap.md`、`state.md` — コアプロジェクトファイル
|
||||
- `phase-prompt.md` — フェーズ実行プロンプトテンプレート
|
||||
- `summary.md`(+ `summary-minimal.md`、`summary-standard.md`、`summary-complex.md`)— 粒度対応のサマリーテンプレート
|
||||
@@ -211,20 +211,20 @@ eager なスキルリストはターンごとの 2 つの主要コストの一
|
||||
|
||||
| フック | イベント | 目的 |
|
||||
|------|-------|---------|
|
||||
| `gsd-statusline.js` | `statusLine` | モデル、タスク、ディレクトリ、コンテキスト使用量バーを表示 |
|
||||
| `gsd-context-monitor.js` | `PostToolUse` / `AfterTool` | コンテキスト残量35%/25%でエージェント向け警告を注入 |
|
||||
| `gsd-check-update.js` | `SessionStart` | GSDの新バージョンをバックグラウンドで確認 |
|
||||
| `gsd-prompt-guard.js` | `PreToolUse` | `.planning/` への書き込みにプロンプトインジェクションパターンがないかスキャン(アドバイザリー) |
|
||||
| `gsd-workflow-guard.js` | `PreToolUse` | GSDワークフローコンテキスト外でのファイル編集を検出(アドバイザリー、`hooks.workflow_guard` によるオプトイン) |
|
||||
| `gsd-secret-read-guard.js` | `PreToolUse` | Read / Grep / Bash による `.env`、`.env.<suffix>`(`.env.example` などのテンプレートは除外)、`.secrets` の読み取りをハードブロック。インストーラが書き込んでいた `Read(.env*)` の deny ルールを置き換える(#4221) |
|
||||
| `msd-statusline.js` | `statusLine` | モデル、タスク、ディレクトリ、コンテキスト使用量バーを表示 |
|
||||
| `msd-context-monitor.js` | `PostToolUse` / `AfterTool` | コンテキスト残量35%/25%でエージェント向け警告を注入 |
|
||||
| `msd-check-update.js` | `SessionStart` | MSDの新バージョンをバックグラウンドで確認 |
|
||||
| `msd-prompt-guard.js` | `PreToolUse` | `.planning/` への書き込みにプロンプトインジェクションパターンがないかスキャン(アドバイザリー) |
|
||||
| `msd-workflow-guard.js` | `PreToolUse` | MSDワークフローコンテキスト外でのファイル編集を検出(アドバイザリー、`hooks.workflow_guard` によるオプトイン) |
|
||||
| `msd-secret-read-guard.js` | `PreToolUse` | Read / Grep / Bash による `.env`、`.env.<suffix>`(`.env.example` などのテンプレートは除外)、`.secrets` の読み取りをハードブロック。インストーラが書き込んでいた `Read(.env*)` の deny ルールを置き換える(#4221) |
|
||||
|
||||
### コマンドルーティングハブ(`gsd-core/bin/lib/command-routing-hub.cjs`)
|
||||
### コマンドルーティングハブ(`msd-core/bin/lib/command-routing-hub.cjs`)
|
||||
|
||||
CJS コマンドファミリールーターは `CommandRoutingHub` を通じてディスパッチします。ハブはノースロー純粋結果コントラクト(`hub.dispatch()` は内部例外をキャッチして `{ ok: false, kind, ...typedPayload }` を返す)とクローズドランタイムエラー分類(`UnknownCommand`、`InvalidArgs`、`HandlerRefusal`、`HandlerFailure`)を所有します。ルーターアダプターは薄い CLI トランスレーターのままです——ハブを構築し、`dispatch` を呼び出し、結果を `output()`/`error()` 呼び出しにマッピングします。`docs/adr/0174-retire-gsd-sdk-package-boundary.md` を参照。
|
||||
CJS コマンドファミリールーターは `CommandRoutingHub` を通じてディスパッチします。ハブはノースロー純粋結果コントラクト(`hub.dispatch()` は内部例外をキャッチして `{ ok: false, kind, ...typedPayload }` を返す)とクローズドランタイムエラー分類(`UnknownCommand`、`InvalidArgs`、`HandlerRefusal`、`HandlerFailure`)を所有します。ルーターアダプターは薄い CLI トランスレーターのままです——ハブを構築し、`dispatch` を呼び出し、結果を `output()`/`error()` 呼び出しにマッピングします。`docs/adr/0174-retire-msd-sdk-package-boundary.md` を参照。
|
||||
|
||||
### CLI ツール(`gsd-core/bin/`)
|
||||
### CLI ツール(`msd-core/bin/`)
|
||||
|
||||
`gsd-core/bin/lib/` にドメインモジュールが分割された Node.js CLI ユーティリティ(`gsd-tools.cjs`)(信頼できるロスターについては [`docs/INVENTORY.md`](INVENTORY.md#cli-modules-33-shipped) を参照):
|
||||
`msd-core/bin/lib/` にドメインモジュールが分割された Node.js CLI ユーティリティ(`msd-tools.cjs`)(信頼できるロスターについては [`docs/INVENTORY.md`](INVENTORY.md#cli-modules-33-shipped) を参照):
|
||||
|
||||
| モジュール | 責務 |
|
||||
| ---------------------- | --------------------------------------------------------------------------------------------------- |
|
||||
@@ -258,10 +258,10 @@ CJS コマンドファミリールーターは `CommandRoutingHub` を通じて
|
||||
```
|
||||
Orchestrator (workflow .md)
|
||||
│
|
||||
├── Load context: gsd-tools.cjs init <workflow> <phase>
|
||||
├── Load context: msd-tools.cjs init <workflow> <phase>
|
||||
│ Returns JSON with: project info, config, state, phase details
|
||||
│
|
||||
├── Resolve model: gsd-tools.cjs resolve-model <agent-name>
|
||||
├── Resolve model: msd-tools.cjs resolve-model <agent-name>
|
||||
│ Returns: opus | sonnet | haiku | inherit
|
||||
│
|
||||
├── Spawn Agent (Task/SubAgent call)
|
||||
@@ -272,27 +272,27 @@ Orchestrator (workflow .md)
|
||||
│
|
||||
├── Collect result
|
||||
│
|
||||
└── Update state: gsd-tools.cjs state update/patch/advance-plan
|
||||
└── Update state: msd-tools.cjs state update/patch/advance-plan
|
||||
```
|
||||
|
||||
### 主要エージェント生成カテゴリ
|
||||
|
||||
21 の主要エージェントの概念的な生成パターン分類。信頼できる 31 エージェントロスター(`gsd-pattern-mapper`、`gsd-code-reviewer`、`gsd-code-fixer`、`gsd-ai-researcher`、`gsd-domain-researcher`、`gsd-eval-planner`、`gsd-eval-auditor`、`gsd-framework-selector`、`gsd-debug-session-manager`、`gsd-intel-updater` などの 10 の高度/専門化エージェントを含む)については、[`docs/INVENTORY.md`](INVENTORY.md#agents-31-shipped) を参照。
|
||||
21 の主要エージェントの概念的な生成パターン分類。信頼できる 31 エージェントロスター(`msd-pattern-mapper`、`msd-code-reviewer`、`msd-code-fixer`、`msd-ai-researcher`、`msd-domain-researcher`、`msd-eval-planner`、`msd-eval-auditor`、`msd-framework-selector`、`msd-debug-session-manager`、`msd-intel-updater` などの 10 の高度/専門化エージェントを含む)については、[`docs/INVENTORY.md`](INVENTORY.md#agents-31-shipped) を参照。
|
||||
|
||||
| カテゴリ | エージェント | 並列性 |
|
||||
| ---------------- | --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
|
||||
| **リサーチャー** | gsd-project-researcher、gsd-phase-researcher、gsd-ui-researcher、gsd-advisor-researcher | 4 並列(stack、features、architecture、pitfalls);advisor は discuss-phase 中に起動 |
|
||||
| **シンセサイザー** | gsd-research-synthesizer | 逐次(リサーチャー完了後) |
|
||||
| **プランナー** | gsd-planner、gsd-roadmapper | 逐次 |
|
||||
| **チェッカー** | gsd-plan-checker、gsd-integration-checker、gsd-ui-checker、gsd-nyquist-auditor | 逐次(検証ループ、最大 3 回反復) |
|
||||
| **エグゼキューター** | gsd-executor | ウェーブ内は並列、ウェーブ間は逐次 |
|
||||
| **ベリファイアー** | gsd-verifier | 逐次(全エグゼキューター完了後) |
|
||||
| **マッパー** | gsd-codebase-mapper | 4 並列(tech、arch、quality、concerns) |
|
||||
| **デバッガー** | gsd-debugger | 逐次(インタラクティブ) |
|
||||
| **オーディター** | gsd-ui-auditor、gsd-security-auditor | 逐次 |
|
||||
| **Doc ライター** | gsd-doc-writer、gsd-doc-verifier | 逐次(ライター後に検証者) |
|
||||
| **プロファイラー** | gsd-user-profiler | 逐次 |
|
||||
| **アナライザー** | gsd-assumptions-analyzer | 逐次(discuss-phase 中) |
|
||||
| **リサーチャー** | msd-project-researcher、msd-phase-researcher、msd-ui-researcher、msd-advisor-researcher | 4 並列(stack、features、architecture、pitfalls);advisor は discuss-phase 中に起動 |
|
||||
| **シンセサイザー** | msd-research-synthesizer | 逐次(リサーチャー完了後) |
|
||||
| **プランナー** | msd-planner、msd-roadmapper | 逐次 |
|
||||
| **チェッカー** | msd-plan-checker、msd-integration-checker、msd-ui-checker、msd-nyquist-auditor | 逐次(検証ループ、最大 3 回反復) |
|
||||
| **エグゼキューター** | msd-executor | ウェーブ内は並列、ウェーブ間は逐次 |
|
||||
| **ベリファイアー** | msd-verifier | 逐次(全エグゼキューター完了後) |
|
||||
| **マッパー** | msd-codebase-mapper | 4 並列(tech、arch、quality、concerns) |
|
||||
| **デバッガー** | msd-debugger | 逐次(インタラクティブ) |
|
||||
| **オーディター** | msd-ui-auditor、msd-security-auditor | 逐次 |
|
||||
| **Doc ライター** | msd-doc-writer、msd-doc-verifier | 逐次(ライター後に検証者) |
|
||||
| **プロファイラー** | msd-user-profiler | 逐次 |
|
||||
| **アナライザー** | msd-assumptions-analyzer | 逐次(discuss-phase 中) |
|
||||
|
||||
### ウェーブ実行モデル
|
||||
|
||||
@@ -321,7 +321,7 @@ Wave Analysis:
|
||||
- **エグゼキューターエージェント** は前のウェーブの SUMMARY.md ファイルとフェーズの CONTEXT.md/RESEARCH.md を受け取り、フェーズ内でのクロスプラン認識を可能にする
|
||||
- **検証者エージェント** はすべての PLAN.md、SUMMARY.md、CONTEXT.md ファイルと REQUIREMENTS.md を受け取り、履歴を考慮した検証を可能にする
|
||||
|
||||
オーケストレーターは設定から `context_window` を読み取り(`gsd-tools.cjs config-get context_window`)、値が >= 500,000 の場合に条件付きでより豊富なコンテキストを含めます。標準 200K ウィンドウでは、プロンプトはコンテキスト効率を最大化するためにキャッシュフレンドリーな順序で切り詰められたバージョンを使います。
|
||||
オーケストレーターは設定から `context_window` を読み取り(`msd-tools.cjs config-get context_window`)、値が >= 500,000 の場合に条件付きでより豊富なコンテキストを含めます。標準 200K ウィンドウでは、プロンプトはコンテキスト効率を最大化するためにキャッシュフレンドリーな順序で切り詰められたバージョンを使います。
|
||||
|
||||
#### 並列コミットの安全性
|
||||
|
||||
@@ -426,10 +426,10 @@ UI-SPEC.md (per phase) ───────────────────
|
||||
|
||||
```
|
||||
~/.claude/ # Claude Code (global install)
|
||||
├── skills/gsd-*/SKILL.md # Global skills (authoritative roster: docs/INVENTORY.md)
|
||||
├── commands/gsd/*.md # Local Claude installs use slash commands instead of global skills
|
||||
├── gsd-core/
|
||||
│ ├── bin/gsd-tools.cjs # CLI utility
|
||||
├── skills/msd-*/SKILL.md # Global skills (authoritative roster: docs/INVENTORY.md)
|
||||
├── commands/msd/*.md # Local Claude installs use slash commands instead of global skills
|
||||
├── msd-core/
|
||||
│ ├── bin/msd-tools.cjs # CLI utility
|
||||
│ ├── bin/lib/*.cjs # Domain modules (authoritative roster: docs/INVENTORY.md)
|
||||
│ ├── workflows/*.md # Workflow definitions (authoritative roster: docs/INVENTORY.md)
|
||||
│ ├── references/*.md # Shared reference docs (authoritative roster: docs/INVENTORY.md)
|
||||
@@ -467,14 +467,14 @@ UI-SPEC.md (per phase) ───────────────────
|
||||
├── STATE.md # 生きたメモリ:位置、決定事項、ブロッカー、メトリクス
|
||||
├── config.json # ワークフロー設定
|
||||
├── MILESTONES.md # 完了済みマイルストーンのアーカイブ
|
||||
├── research/ # /gsd-new-project によるドメインリサーチ
|
||||
├── research/ # /msd-new-project によるドメインリサーチ
|
||||
│ ├── SUMMARY.md
|
||||
│ ├── STACK.md
|
||||
│ ├── FEATURES.md
|
||||
│ ├── ARCHITECTURE.md
|
||||
│ └── PITFALLS.md
|
||||
├── codebase/ # ブラウンフィールドマッピング(/gsd-map-codebase または /gsd-onboard から)
|
||||
├── onboarding/ # ブラウンフィールドオンボーディング概要(/gsd-onboard から)
|
||||
├── codebase/ # ブラウンフィールドマッピング(/msd-map-codebase または /msd-onboard から)
|
||||
├── onboarding/ # ブラウンフィールドオンボーディング概要(/msd-onboard から)
|
||||
│ ├── STACK.md
|
||||
│ ├── ARCHITECTURE.md
|
||||
│ ├── CONVENTIONS.md
|
||||
@@ -500,13 +500,13 @@ UI-SPEC.md (per phase) ───────────────────
|
||||
├── todos/
|
||||
│ ├── pending/ # キャプチャされたアイデア
|
||||
│ └── completed/ # 完了済みtodo
|
||||
├── threads/ # 永続コンテキストスレッド(/gsd-thread から)
|
||||
├── seeds/ # 将来に向けたアイデア(/gsd-capture --seed から)
|
||||
├── threads/ # 永続コンテキストスレッド(/msd-thread から)
|
||||
├── seeds/ # 将来に向けたアイデア(/msd-capture --seed から)
|
||||
├── debug/ # アクティブなデバッグセッション
|
||||
│ ├── *.md # アクティブセッション
|
||||
│ ├── resolved/ # アーカイブ済みセッション
|
||||
│ └── knowledge-base.md # 永続的なデバッグ知見
|
||||
├── ui-reviews/ # /gsd-ui-review からのスクリーンショット(gitignore対象)
|
||||
├── ui-reviews/ # /msd-ui-review からのスクリーンショット(gitignore対象)
|
||||
└── continue-here.md # コンテキスト引き継ぎ(pause-work から)
|
||||
```
|
||||
|
||||
@@ -530,15 +530,15 @@ UI-SPEC.md (per phase) ───────────────────
|
||||
- Windsurf: ルール参照付きスキルファースト
|
||||
- Trae: `~/.trae` / `./.trae` へのスキルファーストインストール、`settings.json` またはフック統合なし
|
||||
- Qwen Code: Qwen ブランドのパスとプロンプト書き換え付きスキルファースト
|
||||
- Hermes Agent: `skills/gsd/` 下のカテゴリベーススキル
|
||||
- Hermes Agent: `skills/msd/` 下のカテゴリベーススキル
|
||||
- CodeBuddy: CodeBuddy パスとプロンプト書き換え付きスキルファースト
|
||||
- Cline: ルールベース統合のための `.clinerules` を書き込む
|
||||
- Augment Code: スキルファースト、完全なスキル変換と設定管理
|
||||
5. **パス正規化** — `~/.claude/` パスをランタイム固有のパスに置換
|
||||
6. **設定統合** — ランタイムの `settings.json` にフックを登録
|
||||
7. **パッチバックアップ** — v1.17 以降、ローカルで変更されたファイルを `/gsd-update --reapply` 用に `gsd-local-patches/` へバックアップ
|
||||
8. **マニフェスト追跡** — クリーンアンインストールのために `gsd-file-manifest.json` を書き込み
|
||||
9. **アンインストールモード** — `--uninstall` ですべての GSD ファイル、フック、設定を削除
|
||||
7. **パッチバックアップ** — v1.17 以降、ローカルで変更されたファイルを `/msd-update --reapply` 用に `msd-local-patches/` へバックアップ
|
||||
8. **マニフェスト追跡** — クリーンアンインストールのために `msd-file-manifest.json` を書き込み
|
||||
9. **アンインストールモード** — `--uninstall` ですべての MSD ファイル、フック、設定を削除
|
||||
|
||||
インストール時のファイル移動、古いアーティファクトのクリーンアップ、設定の書き換え、ユーザーデータの保全は Installer Migration Module によって管理されます。[Installer Migrations](../installer-migrations.md) と [ADR 0008](../adr/0008-installer-migration-module.md) を参照してください。
|
||||
|
||||
@@ -557,17 +557,17 @@ UI-SPEC.md (per phase) ───────────────────
|
||||
```
|
||||
Runtime Engine (Claude Code / Antigravity CLI)
|
||||
│
|
||||
├── statusLine event ──► gsd-statusline.js
|
||||
├── statusLine event ──► msd-statusline.js
|
||||
│ Reads: stdin (session JSON)
|
||||
│ Writes: stdout (formatted status), /tmp/claude-ctx-{session}.json (bridge)
|
||||
│
|
||||
├── PostToolUse/AfterTool event ──► gsd-context-monitor.js
|
||||
├── PostToolUse/AfterTool event ──► msd-context-monitor.js
|
||||
│ Reads: stdin (tool event JSON), /tmp/claude-ctx-{session}.json (bridge)
|
||||
│ Writes: stdout (hookSpecificOutput with additionalContext warning)
|
||||
│
|
||||
└── SessionStart event ──► gsd-check-update.js
|
||||
└── SessionStart event ──► msd-check-update.js
|
||||
Reads: VERSION file
|
||||
Writes: ~/.claude/cache/gsd-update-check.json (spawns background process)
|
||||
Writes: ~/.claude/cache/msd-update-check.json (spawns background process)
|
||||
```
|
||||
|
||||
### コンテキストモニターの閾値
|
||||
@@ -596,52 +596,52 @@ Runtime Engine (Claude Code / Antigravity CLI)
|
||||
|
||||
| レイヤー | コンポーネント | アクション |
|
||||
|-------|-----------|--------|
|
||||
| 調査 | `gsd-phase-researcher` | `gsd-tools query package-legitimacy check --ecosystem <npm\|pypi\|crates> <pkgs>` を実行;`## Package Legitimacy Audit` テーブルを RESEARCH.md に書き込む;RESEARCH.md が書かれる前に `[SLOP]` パッケージを除去 |
|
||||
| 計画 | `gsd-planner` | 監査テーブルを読み取る;任意の `[ASSUMED]` または `[SUS]` インストールタスクの前に `checkpoint:human-verify` を挿入;`<threat_model>` に `T-{phase}-SC` STRIDE サプライチェーン行を追加 |
|
||||
| 実行 | `gsd-executor` | RULE 3 はパッケージインストールを自動修正スコープから除外;失敗したインストールはチェックポイントとして表面化し、サイレントな代替なし |
|
||||
| 調査 | `msd-phase-researcher` | `msd-tools query package-legitimacy check --ecosystem <npm\|pypi\|crates> <pkgs>` を実行;`## Package Legitimacy Audit` テーブルを RESEARCH.md に書き込む;RESEARCH.md が書かれる前に `[SLOP]` パッケージを除去 |
|
||||
| 計画 | `msd-planner` | 監査テーブルを読み取る;任意の `[ASSUMED]` または `[SUS]` インストールタスクの前に `checkpoint:human-verify` を挿入;`<threat_model>` に `T-{phase}-SC` STRIDE サプライチェーン行を追加 |
|
||||
| 実行 | `msd-executor` | RULE 3 はパッケージインストールを自動修正スコープから除外;失敗したインストールはチェックポイントとして表面化し、サイレントな代替なし |
|
||||
|
||||
セキュリティモデルの概念的な概要については [セキュリティモデル](explanation/security-model.md) を参照。
|
||||
|
||||
### セキュリティフック(v1.27)
|
||||
|
||||
**Prompt Guard**(`gsd-prompt-guard.js`):
|
||||
**Prompt Guard**(`msd-prompt-guard.js`):
|
||||
|
||||
- `.planning/` ファイルへの Write/Edit 時にトリガー
|
||||
- プロンプトインジェクションパターン(ロールオーバーライド、指示バイパス、system タグインジェクション)をスキャン
|
||||
- アドバイザリーのみ — 検出をログに記録するが、ブロックはしない
|
||||
- フックの独立性のため、パターンはインライン化(`security.cjs` のサブセット)
|
||||
|
||||
**Workflow Guard**(`gsd-workflow-guard.js`):
|
||||
**Workflow Guard**(`msd-workflow-guard.js`):
|
||||
|
||||
- `.planning/` 以外のファイルへの Write/Edit 時にトリガー
|
||||
- GSD ワークフローコンテキスト外での編集を検出(アクティブな `/gsd-` コマンドや Task サブエージェントがない場合)
|
||||
- 状態追跡される変更には `/gsd-quick` や `/gsd-fast` の使用をアドバイス
|
||||
- MSD ワークフローコンテキスト外での編集を検出(アクティブな `/msd-` コマンドや Task サブエージェントがない場合)
|
||||
- 状態追跡される変更には `/msd-quick` や `/msd-fast` の使用をアドバイス
|
||||
- `hooks.workflow_guard: true` によるオプトイン(デフォルト: false)
|
||||
|
||||
---
|
||||
|
||||
## ランタイム抽象化
|
||||
|
||||
GSD Core は統一されたコマンド/ワークフローアーキテクチャを通じて複数の AI コーディングランタイムをサポートしています:
|
||||
MSD Core は統一されたコマンド/ワークフローアーキテクチャを通じて複数の AI コーディングランタイムをサポートしています:
|
||||
|
||||
### ランタイムインストールコントラクトマトリクス
|
||||
|
||||
| ランタイム | グローバルルート | ローカルルート | 呼び出し面 | エージェント面 | 設定とフック |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| Claude Code | `~/.claude` | `./.claude` | グローバル `skills/gsd-*/SKILL.md`;ローカル `commands/gsd/*.md` | `agents/gsd-*.md` | `settings.json` フックと statusLine エントリ |
|
||||
| OpenCode | `~/.config/opencode` | `./.opencode` | `command/gsd-*.md` | `agents/gsd-*.md` | `opencode.json` または `opencode.jsonc`;GSD フックなし |
|
||||
| Kilo | `~/.config/kilo` | `./.kilo` | `command/gsd-*.md` | `agents/gsd-*.md` | `kilo.json` または `kilo.jsonc`;GSD フックなし |
|
||||
| Codex | `~/.codex` | `./.codex` | `skills/gsd-*/SKILL.md` | エージェントソース markdown + エージェントごとの TOML | `config.toml` `[agents.gsd-*]`、`[features].hooks`、フックテーブル |
|
||||
| GitHub Copilot | `~/.copilot` | `./.github` | `skills/gsd-*/SKILL.md` と `copilot-instructions.md` | `.agent.md` ファイル | GSD フックまたは statusline なし |
|
||||
| Antigravity | auto-detected:`~/.gemini/antigravity`、`~/.gemini/antigravity-ide`、または `~/.gemini/antigravity-cli` | `./.agent` | `skills/gsd-*/SKILL.md` | `agents/gsd-*.md` | GSD がインストールした場合の Gemini スタイル `settings.json` フックエントリ |
|
||||
| Cursor | `~/.cursor` | `./.cursor` | `skills/gsd-*/SKILL.md` | `agents/gsd-*.md` | `rules/` 下のルール参照;GSD フックなし |
|
||||
| Windsurf | `~/.codeium/windsurf` | `./.windsurf` | `skills/gsd-*/SKILL.md` | `agents/gsd-*.md` | `rules/` 下のルール参照;GSD フックなし |
|
||||
| Augment Code | `~/.augment` | `./.augment` | `skills/gsd-*/SKILL.md` | `agents/gsd-*.md` | GSD フックまたは statusline なし |
|
||||
| Trae | `~/.trae` | `./.trae` | `skills/gsd-*/SKILL.md` | `agents/gsd-*.md` | `rules/` 下のルール参照;GSD フックなし |
|
||||
| Qwen Code | `~/.qwen` | `./.qwen` | `skills/gsd-*/SKILL.md` | `agents/gsd-*.md` | サポートされている場合の共通 GSD 設定とフックエントリ |
|
||||
| Hermes Agent | `~/.hermes` | `./.hermes` | `skills/gsd/DESCRIPTION.md` と `skills/gsd/gsd-*/SKILL.md` | `agents/gsd-*.md` | サポートされている場合の共通 GSD 設定とフックエントリ |
|
||||
| CodeBuddy | `~/.codebuddy` | `./.codebuddy` | `skills/gsd-*/SKILL.md` | `agents/gsd-*.md` | サポートされている場合の共通 GSD 設定とフックエントリ |
|
||||
| Cline | `~/.cline` | project root | `.clinerules` | ルールのみ | GSD フックまたは statusline なし |
|
||||
| Claude Code | `~/.claude` | `./.claude` | グローバル `skills/msd-*/SKILL.md`;ローカル `commands/msd/*.md` | `agents/msd-*.md` | `settings.json` フックと statusLine エントリ |
|
||||
| OpenCode | `~/.config/opencode` | `./.opencode` | `command/msd-*.md` | `agents/msd-*.md` | `opencode.json` または `opencode.jsonc`;MSD フックなし |
|
||||
| Kilo | `~/.config/kilo` | `./.kilo` | `command/msd-*.md` | `agents/msd-*.md` | `kilo.json` または `kilo.jsonc`;MSD フックなし |
|
||||
| Codex | `~/.codex` | `./.codex` | `skills/msd-*/SKILL.md` | エージェントソース markdown + エージェントごとの TOML | `config.toml` `[agents.msd-*]`、`[features].hooks`、フックテーブル |
|
||||
| GitHub Copilot | `~/.copilot` | `./.github` | `skills/msd-*/SKILL.md` と `copilot-instructions.md` | `.agent.md` ファイル | MSD フックまたは statusline なし |
|
||||
| Antigravity | auto-detected:`~/.gemini/antigravity`、`~/.gemini/antigravity-ide`、または `~/.gemini/antigravity-cli` | `./.agent` | `skills/msd-*/SKILL.md` | `agents/msd-*.md` | MSD がインストールした場合の Gemini スタイル `settings.json` フックエントリ |
|
||||
| Cursor | `~/.cursor` | `./.cursor` | `skills/msd-*/SKILL.md` | `agents/msd-*.md` | `rules/` 下のルール参照;MSD フックなし |
|
||||
| Windsurf | `~/.codeium/windsurf` | `./.windsurf` | `skills/msd-*/SKILL.md` | `agents/msd-*.md` | `rules/` 下のルール参照;MSD フックなし |
|
||||
| Augment Code | `~/.augment` | `./.augment` | `skills/msd-*/SKILL.md` | `agents/msd-*.md` | MSD フックまたは statusline なし |
|
||||
| Trae | `~/.trae` | `./.trae` | `skills/msd-*/SKILL.md` | `agents/msd-*.md` | `rules/` 下のルール参照;MSD フックなし |
|
||||
| Qwen Code | `~/.qwen` | `./.qwen` | `skills/msd-*/SKILL.md` | `agents/msd-*.md` | サポートされている場合の共通 MSD 設定とフックエントリ |
|
||||
| Hermes Agent | `~/.hermes` | `./.hermes` | `skills/msd/DESCRIPTION.md` と `skills/msd/msd-*/SKILL.md` | `agents/msd-*.md` | サポートされている場合の共通 MSD 設定とフックエントリ |
|
||||
| CodeBuddy | `~/.codebuddy` | `./.codebuddy` | `skills/msd-*/SKILL.md` | `agents/msd-*.md` | サポートされている場合の共通 MSD 設定とフックエントリ |
|
||||
| Cline | `~/.cline` | project root | `.clinerules` | ルールのみ | MSD フックまたは statusline なし |
|
||||
|
||||
### 抽象化ポイント
|
||||
|
||||
@@ -649,7 +649,7 @@ GSD Core は統一されたコマンド/ワークフローアーキテクチャ
|
||||
2. **フックイベント名** — Claude Code は `PostToolUse`、Antigravity は `AfterTool` を使用
|
||||
3. **エージェントフロントマター** — 各ランタイムは独自のエージェント定義形式を持つ
|
||||
4. **パス規約** — 各ランタイムは異なるディレクトリに設定を保存
|
||||
5. **モデル参照** — `inherit` プロファイルにより、GSD はランタイムのモデル選択に委譲
|
||||
5. **モデル参照** — `inherit` プロファイルにより、MSD はランタイムのモデル選択に委譲
|
||||
|
||||
インストーラーはインストール時にすべての変換を処理します。ワークフローとエージェントは Claude Code のネイティブ形式で記述され、デプロイ時に変換されます。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user