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:
Jakub Zych
@@ -1,6 +1,6 @@
|
||||
# はじめてのプロジェクト
|
||||
|
||||
このチュートリアルでは、GSD Core をインストールし、シンプルなコマンドライン To-Do アプリをゼロから作成します。1フェーズ、1プルリクエスト、完全なループを体験します。終わる頃には、コアフェーズループのすべてのコマンドを少なくとも一度は実行し、各コマンドが生成する計画アーティファクトを確認しているはずです。
|
||||
このチュートリアルでは、MSD Core をインストールし、シンプルなコマンドライン To-Do アプリをゼロから作成します。1フェーズ、1プルリクエスト、完全なループを体験します。終わる頃には、コアフェーズループのすべてのコマンドを少なくとも一度は実行し、各コマンドが生成する計画アーティファクトを確認しているはずです。
|
||||
|
||||
---
|
||||
|
||||
@@ -16,16 +16,16 @@ To-Do アイテムをローカルの JSON ファイルに保存し、追加・
|
||||
- **Claude Code** — 使用するプロジェクトディレクトリで開いていること。
|
||||
- 初回インストール用のインターネット接続。
|
||||
|
||||
他のツールは不要です。GSD Core 自体は次のステップでインストールします。
|
||||
他のツールは不要です。MSD Core 自体は次のステップでインストールします。
|
||||
|
||||
---
|
||||
|
||||
## ステップ 1 — GSD Core のインストール
|
||||
## ステップ 1 — MSD Core のインストール
|
||||
|
||||
プロジェクトディレクトリでターミナルを開き、以下を実行します:
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest
|
||||
npx @golem15/msd-core@latest
|
||||
```
|
||||
|
||||
インストーラーが、使用している AI コーディングランタイムとグローバルインストールかカレントプロジェクトへのインストールかを確認します。今は **Claude Code** と **local**（このプロジェクトのみ）を選択してください。
|
||||
@@ -35,10 +35,10 @@ npx @opengsd/gsd-core@latest
|
||||
```text
|
||||
✓ Installed 86 skills to .claude/commands/
|
||||
✓ Installed agents to .claude/agents/
|
||||
✓ GSD Core ready — run /gsd-new-project to start
|
||||
✓ MSD Core ready — run /msd-new-project to start
|
||||
```
|
||||
|
||||
プロジェクト内に `.claude/` ディレクトリが作成されます。これが GSD Core のコマンドとエージェントの格納場所です。
|
||||
プロジェクト内に `.claude/` ディレクトリが作成されます。これが MSD Core のコマンドとエージェントの格納場所です。
|
||||
|
||||
> ローカルとグローバルの違いについて: ローカルインストールはスキルのバージョンをこのプロジェクトに固定します。グローバルインストールを行う場合は、[ランタイムへのインストール](../how-to/install-on-your-runtime.md) を参照してください。
|
||||
|
||||
@@ -46,7 +46,7 @@ npx @opengsd/gsd-core@latest
|
||||
|
||||
## ステップ 2 — 権限フラグ付きで Claude Code を起動
|
||||
|
||||
GSD Core は、ファイルの読み書きを行うサブエージェントを生成します。すべてのファイル操作に対して確認を求められないよう、権限フラグを付けて Claude Code を起動してください:
|
||||
MSD Core は、ファイルの読み書きを行うサブエージェントを生成します。すべてのファイル操作に対して確認を求められないよう、権限フラグを付けて Claude Code を起動してください:
|
||||
|
||||
```bash
|
||||
claude --dangerously-skip-permissions
|
||||
@@ -61,10 +61,10 @@ claude --dangerously-skip-permissions
|
||||
Claude Code のプロンプトで以下のスラッシュコマンドを入力します:
|
||||
|
||||
```text
|
||||
/gsd-new-project
|
||||
/msd-new-project
|
||||
```
|
||||
|
||||
GSD Core が会話を開始し、最初に1つの質問をします:
|
||||
MSD Core が会話を開始し、最初に1つの質問をします:
|
||||
|
||||
```text
|
||||
What do you want to build?
|
||||
@@ -78,13 +78,13 @@ A Node.js CLI tool for managing to-do items. Users run `todo add "buy milk"`,
|
||||
No external dependencies — Node built-ins only.
|
||||
```
|
||||
|
||||
GSD Core がいくつかの確認事項について質問します。自然に答えてください。1つのプランも書く前に、あなたの意図を理解しようとしています。
|
||||
MSD Core がいくつかの確認事項について質問します。自然に答えてください。1つのプランも書く前に、あなたの意図を理解しようとしています。
|
||||
|
||||
質問が終わると、ドメインリサーチの実行を提案します。この規模のプロジェクトであればリサーチをスキップできます。プロンプトが表示されたら **Skip research** を選択してください。
|
||||
|
||||
次に GSD Core がワークフロー設定（モード、粒度、リサーチエージェント）を選択するよう求めます。それぞれ推奨デフォルトを選択してください。これらの設定は `.planning/config.json` に書き込まれます。
|
||||
次に MSD Core がワークフロー設定（モード、粒度、リサーチエージェント）を選択するよう求めます。それぞれ推奨デフォルトを選択してください。これらの設定は `.planning/config.json` に書き込まれます。
|
||||
|
||||
最後に、ロードマッパーのサブエージェントが実行されます（「Spawning roadmapper…」という通知が表示されますが、これは正常です。約1分かかります）。完了すると、GSD Core が提案するロードマップを提示します。単一フェーズのプロジェクトでは次のようになります:
|
||||
最後に、ロードマッパーのサブエージェントが実行されます（「Spawning roadmapper…」という通知が表示されますが、これは正常です。約1分かかります）。完了すると、MSD Core が提案するロードマップを提示します。単一フェーズのプロジェクトでは次のようになります:
|
||||
|
||||
```text
|
||||
Proposed Roadmap
|
||||
@@ -115,7 +115,7 @@ Proposed Roadmap
|
||||
|
||||
## ステップ 4 — コンテキストをクリアしてフェーズ 1 を議論
|
||||
|
||||
GSD Core はフレッシュなコンテキストを前提に設計されています。各フェーズの前にメインセッションウィンドウをクリアしてください:
|
||||
MSD Core はフレッシュなコンテキストを前提に設計されています。各フェーズの前にメインセッションウィンドウをクリアしてください:
|
||||
|
||||
```text
|
||||
/clear
|
||||
@@ -124,10 +124,10 @@ GSD Core はフレッシュなコンテキストを前提に設計されてい
|
||||
次に、フェーズ 1 の議論を開始します:
|
||||
|
||||
```text
|
||||
/gsd-discuss-phase 1
|
||||
/msd-discuss-phase 1
|
||||
```
|
||||
|
||||
GSD Core がフェーズのゴールを読み取り、実装の方針について質問します。これは「何を」作るかではなく、「どのように」作るかを決める質問です。会話の例:
|
||||
MSD Core がフェーズのゴールを読み取り、実装の方針について質問します。これは「何を」作るかではなく、「どのように」作るかを決める質問です。会話の例:
|
||||
|
||||
```text
|
||||
> How should done items be stored — mark them in place or move them?
|
||||
@@ -140,7 +140,7 @@ GSD Core がフェーズのゴールを読み取り、実装の方針につい
|
||||
Create it silently on first add.
|
||||
```
|
||||
|
||||
議論が終了すると、GSD Core が以下のファイルを書き込みます:
|
||||
議論が終了すると、MSD Core が以下のファイルを書き込みます:
|
||||
|
||||
```text
|
||||
.planning/phases/01-core-cli/CONTEXT.md
|
||||
@@ -153,7 +153,7 @@ GSD Core がフェーズのゴールを読み取り、実装の方針につい
|
||||
## ステップ 5 — フェーズ 1 の計画
|
||||
|
||||
```text
|
||||
/gsd-plan-phase 1
|
||||
/msd-plan-phase 1
|
||||
```
|
||||
|
||||
4つのリサーチサブエージェントが並行して実行されます（「Spawning 4 researchers…」という通知が表示されます。1〜5分かかります。中断しないでください）。
|
||||
@@ -169,17 +169,17 @@ GSD Core がフェーズのゴールを読み取り、実装の方針につい
|
||||
01-02-PLAN.md ← タスク: add / list / done コマンドの実装
|
||||
```
|
||||
|
||||
`01-01-PLAN.md` を開いてください。タスク名、対象ファイル、アクションステップ、検証コマンド、完了条件が含まれた `<task>` ブロックがあります。`<verify>` タグに注目してください。GSD Core のエグゼキューターはコードを書いた後にそのコマンドを実行します。
|
||||
`01-01-PLAN.md` を開いてください。タスク名、対象ファイル、アクションステップ、検証コマンド、完了条件が含まれた `<task>` ブロックがあります。`<verify>` タグに注目してください。MSD Core のエグゼキューターはコードを書いた後にそのコマンドを実行します。
|
||||
|
||||
---
|
||||
|
||||
## ステップ 6 — フェーズ 1 の実行
|
||||
|
||||
```text
|
||||
/gsd-execute-phase 1
|
||||
/msd-execute-phase 1
|
||||
```
|
||||
|
||||
GSD Core はプランをウェーブ（独立したプランが並行実行される単位）にグループ化し、プランごとに新しい 200k コンテキストのエグゼキューターを生成し、各タスクをアトミックにコミットします。
|
||||
MSD Core はプランをウェーブ（独立したプランが並行実行される単位）にグループ化し、プランごとに新しい 200k コンテキストのエグゼキューターを生成し、各タスクをアトミックにコミットします。
|
||||
|
||||
以下のような出力が表示されます:
|
||||
|
||||
@@ -215,17 +215,17 @@ node todo.js done 1
|
||||
node todo.js list
|
||||
```
|
||||
|
||||
アイテムが表示され、完了マークを付けた後にアイテム 1 がデフォルトリストから消えているはずです。これが GSD Core によって実現された最初の成果です。
|
||||
アイテムが表示され、完了マークを付けた後にアイテム 1 がデフォルトリストから消えているはずです。これが MSD Core によって実現された最初の成果です。
|
||||
|
||||
---
|
||||
|
||||
## ステップ 7 — 成果物の検証
|
||||
|
||||
```text
|
||||
/gsd-verify-work 1
|
||||
/msd-verify-work 1
|
||||
```
|
||||
|
||||
GSD Core がフェーズの成功基準を抽出し、それぞれについて確認します:
|
||||
MSD Core がフェーズの成功基準を抽出し、それぞれについて確認します:
|
||||
|
||||
```text
|
||||
[1/3] Can you run `node todo.js add "buy milk"` without errors?
|
||||
@@ -240,7 +240,7 @@ GSD Core がフェーズの成功基準を抽出し、それぞれについて
|
||||
All 3 checks passed. Phase 1 verified.
|
||||
```
|
||||
|
||||
いずれかのチェックが失敗した場合、GSD Core が根本原因を診断して修正プランを作成します。`/gsd-execute-phase 1` を再度実行して修正を適用し、その後 `/gsd-verify-work 1` を再実行してください。
|
||||
いずれかのチェックが失敗した場合、MSD Core が根本原因を診断して修正プランを作成します。`/msd-execute-phase 1` を再度実行して修正を適用し、その後 `/msd-verify-work 1` を再実行してください。
|
||||
|
||||
**作成されるファイル:**
|
||||
|
||||
@@ -253,10 +253,10 @@ All 3 checks passed. Phase 1 verified.
|
||||
## ステップ 8 — リリース
|
||||
|
||||
```text
|
||||
/gsd-ship 1
|
||||
/msd-ship 1
|
||||
```
|
||||
|
||||
GSD Core が自動生成された本文付きのプルリクエストを作成します。PR の本文には常に Summary、Changes、Requirements Addressed、Verification、Key Decisions が含まれます。
|
||||
MSD Core が自動生成された本文付きのプルリクエストを作成します。PR の本文には常に Summary、Changes、Requirements Addressed、Verification、Key Decisions が含まれます。
|
||||
|
||||
以下のような出力が表示されます:
|
||||
|
||||
@@ -272,15 +272,15 @@ Title: feat(phase-1): core CLI — add / list / done commands
|
||||
|
||||
## 学んだこと
|
||||
|
||||
- `npx @opengsd/gsd-core@latest` を使った GSD Core のインストール方法。
|
||||
- `/gsd-new-project` が会話を `.planning/` アーティファクトに裏付けられたロードマップに変換する仕組み。
|
||||
- `/gsd-discuss-phase` が計画前に実装の意思決定を記録する仕組み。
|
||||
- `/gsd-plan-phase` が並行リサーチャーを生成してアトミックなタスクプランを作成する仕組み。
|
||||
- `/gsd-execute-phase` がプランを並行ウェーブで実行し各タスクをコミットする仕組み。
|
||||
- `/gsd-verify-work` が成功基準を確認し、必要に応じて修正プランを生成する仕組み。
|
||||
- `/gsd-ship` が検証済みフェーズをプルリクエストに変換する仕組み。
|
||||
- `npx @golem15/msd-core@latest` を使った MSD Core のインストール方法。
|
||||
- `/msd-new-project` が会話を `.planning/` アーティファクトに裏付けられたロードマップに変換する仕組み。
|
||||
- `/msd-discuss-phase` が計画前に実装の意思決定を記録する仕組み。
|
||||
- `/msd-plan-phase` が並行リサーチャーを生成してアトミックなタスクプランを作成する仕組み。
|
||||
- `/msd-execute-phase` がプランを並行ウェーブで実行し各タスクをコミットする仕組み。
|
||||
- `/msd-verify-work` が成功基準を確認し、必要に応じて修正プランを生成する仕組み。
|
||||
- `/msd-ship` が検証済みフェーズをプルリクエストに変換する仕組み。
|
||||
|
||||
マルチフェーズプロジェクトの場合は、各フェーズでステップ 4〜8 を繰り返し、`/gsd-progress --next` を実行して GSD Core に次のステップを自動検出させてください。
|
||||
マルチフェーズプロジェクトの場合は、各フェーズでステップ 4〜8 を繰り返し、`/msd-progress --next` を実行して MSD Core に次のステップを自動検出させてください。
|
||||
|
||||
---
|
||||
|
||||
@@ -288,4 +288,4 @@ Title: feat(phase-1): core CLI — add / list / done commands
|
||||
|
||||
- [フェーズループ](../explanation/the-phase-loop.md) — ループがこの形状である理由
|
||||
- [ハウツーガイド](../README.md#how-to-guides) — 特定の状況に対応したタスク重視のレシピ
|
||||
- [既存コードベースのオンボーディング](onboarding-an-existing-codebase.md) — ブラウンフィールドリポジトリへの GSD Core の導入
|
||||
- [既存コードベースのオンボーディング](onboarding-an-existing-codebase.md) — ブラウンフィールドリポジトリへの MSD Core の導入
|
||||
|
||||
Reference in New Issue
Block a user