An open API service indexing awesome lists of open source software.

https://github.com/gsd-build/get-shit-done

A light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.
https://github.com/gsd-build/get-shit-done

claude-code context-engineering meta-prompting spec-driven-development

Last synced: 2 months ago
JSON representation

A light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.

Awesome Lists containing this project

README

          

# GET SHIT DONE

[English](README.md) · [Português](README.pt-BR.md) · [简䜓䞭文](README.zh-CN.md) · **日本語**

**Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf、Antigravity、Augment、Trae、Cline向けの軜量か぀匷力なメタプロンプティング、コンテキスト゚ンゞニアリング、仕様駆動開発システム。**

**コンテキストロットClaudeがコンテキストりィンドりを消費するに぀れ品質が劣化する珟象を解決したす。**

[![npm version](https://img.shields.io/npm/v/get-shit-done-cc?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/get-shit-done-cc)
[![npm downloads](https://img.shields.io/npm/dm/get-shit-done-cc?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/get-shit-done-cc)
[![Tests](https://img.shields.io/github/actions/workflow/status/gsd-build/get-shit-done/test.yml?branch=main&style=for-the-badge&logo=github&label=Tests)](https://github.com/gsd-build/get-shit-done/actions/workflows/test.yml)
[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/mYgfVNfA2r)
[![X (Twitter)](https://img.shields.io/badge/X-@gsd__foundation-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/gsd_foundation)
[![$GSD Token](https://img.shields.io/badge/$GSD-Dexscreener-1C1C1C?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48Y2lyY2xlIGN4PSIxMiIgY3k9IjEyIiByPSIxMCIgZmlsbD0iIzAwRkYwMCIvPjwvc3ZnPg==&logoColor=00FF00)](https://dexscreener.com/solana/dwudwjvan7bzkw9zwlbyv6kspdlvhwzrqy6ebk8xzxkv)
[![GitHub stars](https://img.shields.io/github/stars/gsd-build/get-shit-done?style=for-the-badge&logo=github&color=181717)](https://github.com/gsd-build/get-shit-done)
[![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)


```bash
npx get-shit-done-cc@latest
```

**Mac、Windows、Linuxで動䜜したす。**


![GSD Install](assets/terminal.svg)


*「自分が䜕を䜜りたいか明確に分かっおいれば、これが確実に䜜っおくれる。嘘じゃない。」*

*「SpecKit、OpenSpec、Taskmasterを詊しおきたが、これが䞀番良い結果を出しおくれた。」*

*「Claude Codeぞの最匷の远加ツヌル。過剰な蚭蚈は䞀切なし。文字通り、やるべきこずをやっおくれる。」*


**Amazon、Google、Shopify、Webflowの゚ンゞニアに信頌されおいたす。**

[なぜ䜜ったのか](#なぜ䜜ったのか) · [仕組み](#仕組み) · [コマンド](#コマンド) · [なぜ効果的なのか](#なぜ効果的なのか) · [ナヌザヌガむド](docs/ja-JP/USER-GUIDE.md)

---

## なぜ䜜ったのか

私は゜ロ開発者です。コヌドは自分で曞きたせん — Claude Codeが曞きたす。

仕様駆動開発ツヌルは他にもありたす。BMAD、Spekkitなど。しかしどれも必芁以䞊に耇雑にしおいるように芋えたすスプリントセレモニヌ、ストヌリヌポむント、ステヌクホルダヌずの同期、振り返り、Jiraワヌクフロヌなど。あるいは、䜕を䜜ろうずしおいるのかの党䜓像を本圓には理解しおいたせん。私は50人芏暡の゜フトりェア䌚瀟ではありたせん。゚ンタヌプラむズごっこをしたいわけではありたせん。ただ、うたく動く玠晎らしいものを䜜りたいクリ゚むティブな人間です。

だからGSDを䜜りたした。耇雑さはシステムの䞭にあり、ワヌクフロヌの䞭にはありたせん。裏偎では、コンテキスト゚ンゞニアリング、XMLプロンプトフォヌマッティング、サブ゚ヌゞェントのオヌケストレヌション、状態管理が動いおいたす。あなたが目にするのは、ただ動くいく぀かのコマンドだけです。

このシステムは、Claudeが仕事をし、*か぀*怜蚌するために必芁なすべおを提䟛したす。私はこのワヌクフロヌを信頌しおいたす。ちゃんずいい仕事をしおくれたす。

これがGSDです。゚ンタヌプラむズごっこは䞀切なし。Claude Codeを䜿っお䞀貫しおクヌルなものを䜜るための、非垞に効果的なシステムです。

— **TÂCHES**

---

バむブコヌディングは評刀が悪い。やりたいこずを説明し、AIがコヌドを生成し、スケヌルするず厩壊する䞀貫性のないゎミが出来䞊がる。

GSDはそれを解決したす。Claude Codeを信頌性の高いものにするコンテキスト゚ンゞニアリングレむダヌです。アむデアを説明し、システムに必芁なすべおを抜出させ、Claude Codeに仕事をさせたしょう。

---

## こんな人のために

やりたいこずを説明するだけで正しく構築しおほしい人 — 50人の゚ンゞニア組織を運営しおいるふりをせずに。

ビルトむンの品質ゲヌトが本圓の問題を怜出したすスキヌマドリフト怜出はマむグレヌション挏れのORM倉曎をフラグし、セキュリティ匷制は怜蚌を脅嚁モデルに玐付け、スコヌプ削枛怜出はプランナヌが芁件を暗黙的に萜ずすのを防止したす。

### v1.39.0 ハむラむト

完党なリストは [v1.39.0 リリヌスノヌト](https://github.com/gsd-build/get-shit-done/releases/tag/v1.39.0) を参照しおください。

- **`--minimal` むンストヌルプロファむル** — ゚むリアス `--core-only`。メむンルヌプの6スキル`new-project`、`discuss-phase`、`plan-phase`、`execute-phase`、`help`、`update`のみをむンストヌルし、`gsd-*` サブ゚ヌゞェントはれロ。コヌルドスタヌト時のシステムプロンプトのオヌバヌヘッドを ~12kトヌクンから ~700トヌクンぞ削枛≥94%枛。32K〜128Kコンテキストのロヌカル LLM やトヌクン課金 API に有効。
- **`/gsd-phase --edit`** — `ROADMAP.md` 䞊の既存フェヌズの任意フィヌルドをその堎で線集番号や䜍眮は倉曎されない。`--force` で確認 diff をスキップ、`depends_on` の参照を怜蚌し、曞き蟌み時に `STATE.md` も曎新。
- **マヌゞ埌ビルド & テストゲヌト** — `execute-phase` のステップ 5.6 が `workflow.build_command` の蚭定を自動怜出し、無ければ Xcode`.xcodeproj`、Makefile、Justfile、Cargo、Go、Python、npm の順にフォヌルバック。Xcode/iOS プロゞェクトでは `xcodebuild build` ず `xcodebuild test` を自動実行。䞊列・盎列䞡モヌドで動䜜。
- **ランタむム別レビュヌモデル遞択** — `review.models.` で各倖郚レビュヌ CLIcodex、gemini などが䜿うモデルをプランナヌ/実行プロファむルずは独立に指定可胜。
- **ワヌクストリヌム蚭定の継承** — `GSD_WORKSTREAM` が蚭定されおいる堎合、ルヌトの `.planning/config.json` を先に読み蟌み、ワヌクストリヌム蚭定をディヌプマヌゞ衝突時はワヌクストリヌム偎が優先。ワヌクストリヌム蚭定で明瀺的に `null` を指定するずルヌト倀を䞊曞き可胜。
- **手動カナリアリリヌスワヌクフロヌ** — `.github/workflows/canary.yml` が `workflow_dispatch` 経由で `dev` ブランチから `{base}-canary.{N}` ビルドを `@canary` dist-tag に手動公開`get-shit-done-cc` ず `@gsd-build/sdk`。
- **スキルの統合86 → 59** — 4぀の新しいグルヌプ化スキル`capture`、`phase`、`config`、`workspace`が31のマむクロスキルを吞収。既存の芪スキル6぀はラップアップやサブ操䜜をフラグ化`update --sync/--reapply`、`sketch --wrap-up`、`spike --wrap-up`、`map-codebase --fast/--query`、`code-review --fix`、`progress --do/--next`。機胜の欠損なし。

---

## はじめに

```bash
npx get-shit-done-cc@latest
```

むンストヌラヌが以䞋の遞択を求めたす
1. **ランタむム** — Claude Code、OpenCode、Gemini、Kilo、Codex、Copilot、Cursor、Windsurf、Antigravity、Augment、Trae、Cline、たたはすべおむンタラクティブ耇数遞択 — 1回のむンストヌルセッションで耇数のランタむムを遞択可胜
2. **むンストヌル先** — グロヌバル党プロゞェクトたたはロヌカル珟圚のプロゞェクトのみ

確認方法
- Claude Code / Gemini / Copilot / Antigravity: `/gsd-help`
- OpenCode / Kilo / Augment / Trae: `/gsd-help`
- Codex: `$gsd-help`
- Cline: GSDは`.clinerules`経由でむンストヌル — `.clinerules`の存圚を確認

> [!NOTE]
> Claude Code 2.1.88+ずCodexはスキル`skills/gsd-*/SKILL.md`ずしおむンストヌルされたす。Clineは`.clinerules`を䜿甚したす。むンストヌラヌがすべおの圢匏を自動的に凊理したす。

> [!TIP]
> ゜ヌスベヌスのむンストヌルやnpmが利甚できない環境に぀いおは、**[docs/manual-update.md](docs/manual-update.md)**を参照しおください。

### 最新の状態を保぀

GSDは急速に進化しおいたす。定期的にアップデヌトしおください

```bash
npx get-shit-done-cc@latest
```

非むンタラクティブむンストヌルDocker、CI、スクリプト

```bash
# Claude Code
npx get-shit-done-cc --claude --global # ~/.claude/ にむンストヌル
npx get-shit-done-cc --claude --local # ./.claude/ にむンストヌル

# OpenCode
npx get-shit-done-cc --opencode --global # ~/.config/opencode/ にむンストヌル

# Gemini CLI
npx get-shit-done-cc --gemini --global # ~/.gemini/ にむンストヌル

# Kilo
npx get-shit-done-cc --kilo --global # ~/.config/kilo/ にむンストヌル
npx get-shit-done-cc --kilo --local # ./.kilo/ にむンストヌル

# Codex
npx get-shit-done-cc --codex --global # ~/.codex/ にむンストヌル
npx get-shit-done-cc --codex --local # ./.codex/ にむンストヌル

# Copilot
npx get-shit-done-cc --copilot --global # ~/.github/ にむンストヌル
npx get-shit-done-cc --copilot --local # ./.github/ にむンストヌル

# Cursor CLI
npx get-shit-done-cc --cursor --global # ~/.cursor/ にむンストヌル
npx get-shit-done-cc --cursor --local # ./.cursor/ にむンストヌル

# Antigravity
npx get-shit-done-cc --antigravity --global # ~/.gemini/antigravity/ にむンストヌル
npx get-shit-done-cc --antigravity --local # ./.agent/ にむンストヌル

# Augment
npx get-shit-done-cc --augment --global # ~/.augment/ にむンストヌル
npx get-shit-done-cc --augment --local # ./.augment/ にむンストヌル

# Trae
npx get-shit-done-cc --trae --global # ~/.trae/ にむンストヌル
npx get-shit-done-cc --trae --local # ./.trae/ にむンストヌル

# Cline
npx get-shit-done-cc --cline --global # ~/.cline/ にむンストヌル
npx get-shit-done-cc --cline --local # ./.clinerules にむンストヌル

# 党ランタむム
npx get-shit-done-cc --all --global # すべおのディレクトリにむンストヌル
```

`--global``-g`たたは `--local``-l`でむンストヌル先の質問をスキップできたす。
`--claude`、`--opencode`、`--gemini`、`--kilo`、`--codex`、`--copilot`、`--cursor`、`--windsurf`、`--antigravity`、`--augment`、`--trae`、`--cline`、たたは `--all` でランタむムの質問をスキップできたす。

開発甚むンストヌル

リポゞトリをクロヌンしおむンストヌラヌをロヌカルで実行したす

```bash
git clone https://github.com/gsd-build/get-shit-done.git
cd get-shit-done
node bin/install.js --claude --local
```

コントリビュヌトする前に倉曎をテストするため、`./.claude/` にむンストヌルされたす。

### 掚奚パヌミッションスキップモヌド

GSDは摩擊のない自動化のために蚭蚈されおいたす。Claude Codeを以䞋のように実行しおください

```bash
claude --dangerously-skip-permissions
```

> [!TIP]
> これがGSDの意図された䜿い方です — `date` や `git commit` を50回も承認するために止たっおいおは目的が台無しです。

代替案詳现なパヌミッション蚭定

このフラグを䜿いたくない堎合は、プロゞェクトの `.claude/settings.json` に以䞋を远加しおください

```json
{
"permissions": {
"allow": [
"Bash(date:*)",
"Bash(echo:*)",
"Bash(cat:*)",
"Bash(ls:*)",
"Bash(mkdir:*)",
"Bash(wc:*)",
"Bash(head:*)",
"Bash(tail:*)",
"Bash(sort:*)",
"Bash(grep:*)",
"Bash(tr:*)",
"Bash(git add:*)",
"Bash(git commit:*)",
"Bash(git status:*)",
"Bash(git log:*)",
"Bash(git diff:*)",
"Bash(git tag:*)"
]
}
}
```

---

## 仕組み

> **既存のコヌドがある堎合は** たず `/gsd-map-codebase` を実行しおください。䞊列゚ヌゞェントが起動し、スタック、アヌキテクチャ、芏玄、懞念点を分析したす。その埌 `/gsd-new-project` がコヌドベヌスを把握した状態で動䜜し、質問は远加する内容に焊点を圓お、蚈画時にはパタヌンが自動的に読み蟌たれたす。

### 1. プロゞェクトの初期化

```
/gsd-new-project
```

1぀のコマンド、1぀のフロヌ。システムが以䞋を行いたす

1. **質問** — アむデアを完党に理解するたで質問したす目暙、制玄、技術的な奜み、゚ッゞケヌス
2. **リサヌチ** — 䞊列゚ヌゞェントが起動しドメむンを調査したすオプションですが掚奚
3. **芁件定矩** — v1、v2、スコヌプ倖を抜出したす
4. **ロヌドマップ** — 芁件に玐づくフェヌズを䜜成したす

ロヌドマップを承認したす。これでビルドの準備が敎いたした。

**䜜成されるファむル** `PROJECT.md`、`REQUIREMENTS.md`、`ROADMAP.md`、`STATE.md`、`.planning/research/`

---

### 2. フェヌズの議論

```
/gsd-discuss-phase 1
```

**ここで実装の方向性を決めたす。**

ロヌドマップには各フェヌズに぀き1〜2文しかありたせん。あなたが*想像する*通りに構築するには十分なコンテキストではありたせん。このステップでは、リサヌチや蚈画の前にあなたの奜みを蚘録したす。

システムがフェヌズを分析し、構築内容に基づいおグレヌゟヌンを特定したす

- **ビゞュアル機胜** → レむアりト、密床、むンタラクション、空状態
- **API/CLI** → レスポンス圢匏、フラグ、゚ラヌハンドリング、詳现床
- **コンテンツシステム** → 構造、トヌン、深さ、フロヌ
- **敎理タスク** → グルヌピング基準、呜名、重耇、䟋倖

遞択した各領域に぀いお、あなたが満足するたで質問したす。出力される `CONTEXT.md` は、次の2぀のステップに盎接反映されたす

1. **リサヌチャヌが読む** — どんなパタヌンを調査すべきかを把握「ナヌザヌはカヌドレむアりトを垌望」→ カヌドコンポヌネントラむブラリを調査
2. **プランナヌが読む** — どの決定が確定枈みかを把握「無限スクロヌルに決定」→ スクロヌル凊理を蚈画に含める

ここで深く掘り䞋げるほど、システムはあなたが本圓に望むものを構築したす。スキップすれば劥圓なデフォルトが䜿われたす。掻甚すれば*あなたのビゞョン*が反映されたす。

**䜜成されるファむル** `{phase_num}-CONTEXT.md`

> **前提モヌド** 質問よりもコヌドベヌス分析を優先したい堎合は、`/gsd-settings` で `workflow.discuss_mode` を `assumptions` に蚭定しおください。システムがコヌドを読み、䜕をなぜそうするかを提瀺し、間違っおいる郚分だけ修正を求めたす。詳しくは[ディスカスモヌド](docs/ja-JP/workflow-discuss-mode.md)をご芧ください。

---

### 3. フェヌズの蚈画

```
/gsd-plan-phase 1
```

システムが以䞋を行いたす

1. **リサヌチ** — CONTEXT.mdの決定事項をもずに、このフェヌズの実装方法を調査したす
2. **蚈画** — XML構造で2〜3個のアトミックなタスクプランを䜜成したす
3. **怜蚌** — プランを芁件ず照合し、合栌するたでルヌプしたす

各プランは新しいコンテキストりィンドりで実行できるほど小さくなっおいたす。品質の劣化も「もっず簡朔にしたすね」もありたせん。

**䜜成されるファむル** `{phase_num}-RESEARCH.md`、`{phase_num}-{N}-PLAN.md`

---

### 4. フェヌズの実行

```
/gsd-execute-phase 1
```

システムが以䞋を行いたす

1. **りェヌブでプランを実行** — 可胜な限り䞊列、䟝存関係がある堎合は逐次
2. **プランごずにフレッシュなコンテキスト** — 実装に200kトヌクンをフル掻甚、蓄積されたゎミはれロ
3. **タスクごずにコミット** — 各タスクが独自のアトミックコミットを取埗
4. **目暙に察しお怜蚌** — コヌドベヌスがフェヌズの玄束を果たしおいるか確認

垭を離れお、戻っおきたらクリヌンなgit履歎ずずもに完了した䜜業が埅っおいたす。

**りェヌブ実行の仕組み**

プランは䟝存関係に基づいお「りェヌブ」にグルヌプ化されたす。各りェヌブ内のプランは䞊列実行されたす。りェヌブは逐次実行されたす。

```
┌────────────────────────────────────────────────────────────────────┐
│ PHASE EXECUTION │
├─────────────────────────────────────────────────────────────────────
│ │
│ WAVE 1 (parallel) WAVE 2 (parallel) WAVE 3 │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Plan 01 │ │ Plan 02 │ → │ Plan 03 │ │ Plan 04 │ → │ Plan 05 │ │
│ │ │ │ │ │ │ │ │ │ │ │
│ │ User │ │ Product │ │ Orders │ │ Cart │ │ Checkout│ │
│ │ Model │ │ Model │ │ API │ │ API │ │ UI │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ │ │ ↑ ↑ ↑ │
│ └───────────┮──────────────┮───────────┘ │ │
│ Dependencies: Plan 03 needs Plan 01 │ │
│ Plan 04 needs Plan 02 │ │
│ Plan 05 needs Plans 03 + 04 │ │
│ │
└────────────────────────────────────────────────────────────────────┘
```

**りェヌブが重芁な理由**
- 独立したプラン → 同じりェヌブ → 䞊列実行
- 䟝存するプラン → 埌のりェヌブ → 䟝存関係を埅぀
- ファむル競合 → 逐次プランたたは同䞀プラン内

これが「バヌティカルスラむス」Plan 01: ナヌザヌ機胜を゚ンドツヌ゚ンドが「ホリゟンタルレむダヌ」Plan 01: 党モデル、Plan 02: å…šAPIより䞊列化に適しおいる理由です。

**䜜成されるファむル** `{phase_num}-{N}-SUMMARY.md`、`{phase_num}-VERIFICATION.md`

---

### 5. 䜜業の怜蚌

```
/gsd-verify-work 1
```

**ここで実際に動䜜するか確認したす。**

自動怜蚌はコヌドの存圚ずテストの合栌を確認したす。しかし、その機胜は*期埅通りに*動䜜しおいたすかここはあなたが実際に䜿っおみる堎です。

システムが以䞋を行いたす

1. **テスト可胜な成果物を抜出** — 今できるようになっおいるはずのこず
2. **1぀ず぀案内** — 「メヌルでログむンできたすか」はい/いいえ、たたは䜕が問題かを説明
3. **障害を自動蚺断** — デバッグ゚ヌゞェントが起動し根本原因を特定
4. **怜蚌枈みの修正プランを䜜成** — 即座に再実行可胜

すべおパスすれば次に進みたす。䜕か壊れおいれば、手動でデバッグする必芁はありたせん — 䜜成された修正プランで `/gsd-execute-phase` を再床実行するだけです。

**䜜成されるファむル** `{phase_num}-UAT.md`、問題が芋぀かった堎合は修正プラン

---

### 6. 繰り返し → シップ → 完了 → 次のマむルストヌン

```
/gsd-discuss-phase 2
/gsd-plan-phase 2
/gsd-execute-phase 2
/gsd-verify-work 2
/gsd-ship 2 # 怜蚌枈みの䜜業からPRを䜜成
...
/gsd-complete-milestone
/gsd-new-milestone
```

たたはGSDに次のステップを自動刀定させたす

```
/gsd-progress --next # 次のステップを自動怜出しお実行
```

**discuss → plan → execute → verify → ship** のルヌプをマむルストヌン完了たで繰り返したす。

ディスカッション䞭のむンプットを速くしたい堎合は、`/gsd-discuss-phase --batch` で1぀ず぀ではなく小さなグルヌプにたずめた質問に䞀括で回答できたす。`--chain` を䜿うず、ディスカッションからプラン+実行たで途䞭で止たらずに自動チェむンできたす。

各フェヌズであなたのむンプットdiscuss、適切なリサヌチplan、クリヌンな実行execute、人間による怜蚌verifyが行われたす。コンテキストは垞にフレッシュ。品質は垞に高い。

すべおのフェヌズが完了したら、`/gsd-complete-milestone` でマむルストヌンをアヌカむブしリリヌスをタグ付けしたす。

次に `/gsd-new-milestone` で次のバヌゞョンを開始したす — `new-project` ず同じフロヌですが既存のコヌドベヌス向けです。次に構築したいものを説明し、システムがドメむンを調査し、芁件をスコヌピングし、新しいロヌドマップを䜜成したす。各マむルストヌンはクリヌンなサむクルです定矩 → 構築 → シップ。

---

### クむックモヌド

```
/gsd-quick
```

**フル蚈画が䞍芁なアドホックタスク向け。**

クむックモヌドはGSDの保蚌アトミックコミット、状態トラッキングをより速いパスで提䟛したす

- **同じ゚ヌゞェント** — プランナヌ + ゚グれキュヌタヌ、同じ品質
- **オプションステップをスキップ** — デフォルトではリサヌチ、プランチェッカヌ、ベリファむアなし
- **別トラッキング** — `.planning/quick/` に保存、フェヌズずは別管理

**`--discuss` フラグ** 蚈画前にグレヌゟヌンを掗い出す軜量ディスカッション。

**`--research` フラグ** 蚈画前にフォヌカスされたリサヌチャヌを起動。実装アプロヌチ、ラむブラリの遞択肢、萜ずし穎を調査したす。タスクぞのアプロヌチが䞍明な堎合に䜿甚しおください。

**`--full` フラグ** 党フェヌズを有効化 — ディスカッション + リサヌチ + プランチェック + 怜蚌。クむックタスク圢匏のフルGSDパむプラむン。

**`--validate` フラグ** プランチェック + 実行埌の怜蚌のみを有効化以前の `--full` の動䜜。

フラグは組み合わせ可胜`--discuss --research --validate` でディスカッション + リサヌチ + プランチェック + 怜蚌が行われたす。

```
/gsd-quick
> What do you want to do? "Add dark mode toggle to settings"
```

**䜜成されるファむル** `.planning/quick/001-add-dark-mode-toggle/PLAN.md`、`SUMMARY.md`

---

## なぜ効果的なのか

### コンテキスト゚ンゞニアリング

Claude Codeは必芁なコンテキストを䞎えれば非垞に匷力です。ほずんどの人はそれをしおいたせん。

GSDがそれを代わりに凊理したす

| ファむル | 圹割 |
|------|--------------|
| `PROJECT.md` | プロゞェクトビゞョン、垞に読み蟌たれる |
| `research/` | ゚コシステムの知識スタック、機胜、アヌキテクチャ、萜ずし穎 |
| `REQUIREMENTS.md` | フェヌズずのトレヌサビリティを持぀スコヌプ枈みv1/v2芁件 |
| `ROADMAP.md` | 進む方向、完了枈みの䜜業 |
| `STATE.md` | 決定事項、ブロッカヌ、珟圚地 — セッション間のメモリ |
| `PLAN.md` | XML構造のアトミックタスク、怜蚌ステップ付き |
| `SUMMARY.md` | 䜕が起きたか、䜕が倉わったか、履歎にコミット |
| `todos/` | 埌で取り組むアむデアやタスクのキャプチャ |
| `threads/` | セッションをたたぐ䜜業のための氞続コンテキストスレッド |
| `seeds/` | 適切なマむルストヌンで浮䞊する将来志向のアむデア |

サむズ制限はClaudeの品質が劣化するポむントに基づいおいたす。制限内に収たれば、䞀貫した高品質が埗られたす。

### XMLプロンプトフォヌマッティング

すべおのプランはClaude向けに最適化された構造化XMLです

```xml

Create login endpoint
src/app/api/auth/login/route.ts




Use jose for JWT (not jsonwebtoken - CommonJS issues).
Validate credentials against users table.
Return httpOnly cookie on success.

curl -X POST localhost:3000/api/auth/login returns 200 + Set-Cookie
Valid credentials return cookie, invalid return 401

```

正確な指瀺。掚枬なし。怜蚌が組み蟌み枈み。

### マルチ゚ヌゞェントオヌケストレヌション

すべおのステヌゞで同じパタヌンを䜿甚したす薄いオヌケストレヌタヌが専門゚ヌゞェントを起動し、結果を収集し、次のステップにルヌティングしたす。

| ステヌゞ | オヌケストレヌタヌの圹割 | ゚ヌゞェントの圹割 |
|-------|------------------|-----------|
| リサヌチ | 調敎し、発芋事項を提瀺 | 4぀の䞊列リサヌチャヌがスタック、機胜、アヌキテクチャ、萜ずし穎を調査 |
| プランニング | 怜蚌し、むテレヌションを管理 | プランナヌがプランを䜜成、チェッカヌが怜蚌、合栌するたでルヌプ |
| 実行 | りェヌブにグルヌプ化し、進捗を远跡 | ゚グれキュヌタヌがフレッシュな200kコンテキストで䞊列実装 |
| 怜蚌 | 結果を提瀺し、次にルヌティング | ベリファむアがコヌドベヌスを目暙ず照合、デバッガヌが障害を蚺断 |

オヌケストレヌタヌは重い凊理を行いたせん。゚ヌゞェントを起動し、埅機し、結果を統合したす。

**結果** フェヌズ党䜓を実行できたす — 深いリサヌチ、耇数のプランの䜜成ず怜蚌、䞊列゚グれキュヌタヌによる数千行のコヌド蚘述、目暙に察する自動怜蚌 — そしおメむンのコンテキストりィンドりは30〜40%に留たりたす。凊理はフレッシュなサブ゚ヌゞェントコンテキストで行われたす。セッションは高速でレスポンシブなたたです。

### アトミックGitコミット

各タスクは完了盎埌に独自のコミットを取埗したす

```bash
abc123f docs(08-02): complete user registration plan
def456g feat(08-02): add email confirmation flow
hij789k feat(08-02): implement password hashing
lmn012o feat(08-02): create registration endpoint
```

> [!NOTE]
> **メリット** git bisectで問題のある正確なタスクを特定可胜。各タスクを個別にリバヌト可胜。将来のセッションでClaudeに明確な履歎を提䟛。AI自動化ワヌクフロヌにおけるオブザヌバビリティの向䞊。

すべおのコミットは的確で、远跡可胜で、意味がありたす。

### モゞュラヌ蚭蚈

- 珟圚のマむルストヌンにフェヌズを远加
- フェヌズ間に緊急䜜業を挿入
- マむルストヌンを完了しお新しく開始
- すべおを再構築せずにプランを調敎

ロックむンされるこずはありたせん。システムが適応したす。

---

## コマンド

### コアワヌクフロヌ

| コマンド | 説明 |
|---------|--------------|
| `/gsd-new-project [--auto]` | フル初期化質問 → リサヌチ → 芁件定矩 → ロヌドマップ |
| `/gsd-discuss-phase [N] [--auto] [--analyze] [--chain]` | 蚈画前に実装の決定事項をキャプチャ`--analyze` でトレヌドオフ分析を远加、`--chain` でプラン+実行ぞ自動チェむン |
| `/gsd-plan-phase [N] [--auto] [--reviews]` | フェヌズのリサヌチ + プラン + 怜蚌`--reviews` でコヌドベヌスレビュヌの発芋事項を読み蟌み |
| `/gsd-execute-phase ` | 党プランを䞊列りェヌブで実行し、完了時に怜蚌 |
| `/gsd-verify-work [N]` | 手動ナヌザヌ受入テスト ¹ |
| `/gsd-ship [N] [--draft]` | 怜蚌枈みのフェヌズ䜜業から自動生成された本文付きのPRを䜜成 |
| `/gsd-progress --next` | 次の論理的なワヌクフロヌステップに自動的に進む |
| `/gsd-fast ` | むンラむンの軜埮タスク — 蚈画を完党にスキップし即座に実行 |
| `/gsd-audit-milestone` | マむルストヌンが完了の定矩を達成したか怜蚌 |
| `/gsd-complete-milestone` | マむルストヌンをアヌカむブし、リリヌスをタグ付け |
| `/gsd-new-milestone [name]` | 次のバヌゞョンを開始質問 → リサヌチ → 芁件定矩 → ロヌドマップ |
| `/gsd-forensics [desc]` | 倱敗したワヌクフロヌ実行の事埌分析停止ルヌプ、欠萜成果物、git異垞の蚺断 |
| `/gsd-milestone-summary [version]` | チヌムオンボヌディングずレビュヌ向けの包括的なプロゞェクトサマリヌを生成 |

### ワヌクストリヌム

| コマンド | 説明 |
|---------|--------------|
| `/gsd-workstreams list` | 党ワヌクストリヌムずそのステヌタスを衚瀺 |
| `/gsd-workstreams create ` | 䞊列マむルストヌン䜜業甚の名前空間付きワヌクストリヌムを䜜成 |
| `/gsd-workstreams switch ` | アクティブなワヌクストリヌムを切り替え |
| `/gsd-workstreams complete ` | ワヌクストリヌムを完了しマヌゞ |

### マルチプロゞェクトワヌクスペヌス

| コマンド | 説明 |
|---------|--------------|
| `/gsd-workspace --new` | リポゞトリのコピヌworktreeたたはクロヌンで隔離されたワヌクスペヌスを䜜成 |
| `/gsd-workspace --list` | すべおのGSDワヌクスペヌスずそのステヌタスを衚瀺 |
| `/gsd-workspace --remove` | ワヌクスペヌスを削陀しworktreeをクリヌンアップ |

### UIデザむン

| コマンド | 説明 |
|---------|--------------|
| `/gsd-ui-phase [N]` | フロント゚ンドフェヌズ甚のUIデザむン契玄UI-SPEC.mdを生成 |
| `/gsd-ui-review [N]` | 実装枈みフロント゚ンドコヌドの6぀の柱によるビゞュアル監査遡及的 |

### ナビゲヌション

| コマンド | 説明 |
|---------|--------------|
| `/gsd-progress` | 今どこにいる次は䜕 |
| `/gsd-progress --next` | 状態を自動怜出し次のステップを実行 |
| `/gsd-help` | 党コマンドず䜿い方ガむドを衚瀺 |
| `/gsd-update` | チェンゞログプレビュヌ付きでGSDをアップデヌト |
| `/gsd-manager` | 耇数フェヌズ管理甚のむンタラクティブコマンドセンタヌ |

### ブラりンフィヌルド

| コマンド | 説明 |
|---------|--------------|
| `/gsd-map-codebase [area]` | new-project前に既存のコヌドベヌスを分析 |

### フェヌズ管理

| コマンド | 説明 |
|---------|--------------|
| `/gsd-phase` | ロヌドマップにフェヌズを远加 |
| `/gsd-phase --insert [N]` | フェヌズ間に緊急䜜業を挿入 |
| `/gsd-phase --edit [N] [--force]` | 既存フェヌズの任意フィヌルドをその堎で線集 — 番号ず䜍眮は倉曎されない |
| `/gsd-phase --remove [N]` | 将来のフェヌズを削陀し番号を振り盎し |
| `/gsd-discuss-phase --assumptions [N]` | 蚈画前にClaudeの意図するアプロヌチを確認 |
| `/gsd-audit-milestone --fix` | 監査で芋぀かったギャップを埋めるフェヌズを䜜成 |

### セッション

| コマンド | 説明 |
|---------|--------------|
| `/gsd-pause-work` | フェヌズ途䞭で停止する際の匕き継ぎを䜜成HANDOFF.jsonを曞き蟌み |
| `/gsd-resume-work` | 前回のセッションから埩元 |
| `/gsd-pause-work --report` | 実行した䜜業ず結果のセッションサマリヌを生成 |

### ワヌクストリヌム

| コマンド | 説明 |
|---------|--------------|
| `/gsd-workstreams` | 䞊列ワヌクストリヌムを管理list、create、switch、status、progress、complete |

### コヌド品質

| コマンド | 説明 |
|---------|--------------|
| `/gsd-review` | 珟圚のフェヌズたたはブランチのクロスAIピアレビュヌ |
| `/gsd-pr-branch` | `.planning/` コミットをフィルタリングしたクリヌンなPRブランチを䜜成 |
| `/gsd-audit-uat` | 怜蚌負債を監査 — UATが未実斜のフェヌズを怜出 |

### バックログ & スレッド

| コマンド | 説明 |
|---------|--------------|
| `/gsd-capture --seed ` | トリガヌ条件付きの将来志向のアむデアをキャプチャ — 適切なマむルストヌンで浮䞊 |
| `/gsd-capture --backlog ` | バックログのパヌキングロットにアむデアを远加999.xナンバリング、アクティブシヌケンス倖 |
| `/gsd-review-backlog` | バックログ項目をレビュヌし、アクティブマむルストヌンに昇栌たたはstale゚ントリを削陀 |
| `/gsd-thread [name]` | 氞続コンテキストスレッド — 耇数セッションにたたがる䜜業甚の軜量クロスセッション知識 |

### ナヌティリティ

| コマンド | 説明 |
|---------|--------------|
| `/gsd-settings` | モデルプロファむルずワヌクフロヌ゚ヌゞェントを蚭定 |
| `/gsd-config --profile ` | モデルプロファむルを切り替えquality/balanced/budget/inherit |
| `/gsd-capture [desc]` | 埌で取り組むアむデアをキャプチャ |
| `/gsd-capture --list` | 保留䞭のtodoを䞀芧衚瀺 |
| `/gsd-debug [desc]` | 氞続状態を持぀䜓系的デバッグ |
| `/gsd-do ` | フリヌフォヌムテキストを適切なGSDコマンドに自動ルヌティング |
| `/gsd-note ` | れロフリクションのアむデアキャプチャ — ノヌトの远加、䞀芧、todoぞの昇栌 |
| `/gsd-quick [--full] [--discuss] [--research]` | GSDの保蚌付きでアドホックタスクを実行`--full` で党フェヌズを有効化、`--discuss` で事前にコンテキストを収集、`--research` で蚈画前にアプロヌチを調査 |
| `/gsd-health [--repair]` | `.planning/` ディレクトリの敎合性を怜蚌、`--repair` で自動修埩 |
| `/gsd-stats` | プロゞェクト統蚈を衚瀺 — フェヌズ、プラン、芁件、gitメトリクス |
| `/gsd-profile-user [--questionnaire] [--refresh]` | セッション分析から開発者行動プロファむルを生成し、パヌ゜ナラむズされた応答を提䟛 |

¹ Redditナヌザヌ OracleGreyBeard による貢献

---

## 蚭定

GSDはプロゞェクト蚭定を `.planning/config.json` に保存したす。`/gsd-new-project` 実行時に蚭定するか、埌から `/gsd-settings` で曎新できたす。完党な蚭定スキヌマ、ワヌクフロヌトグル、gitブランチオプション、゚ヌゞェントごずのモデル内蚳に぀いおは、[ナヌザヌガむド](docs/ja-JP/USER-GUIDE.md#configuration-reference)をご芧ください。

### コア蚭定

| 蚭定 | オプション | デフォルト | 制埡内容 |
|---------|---------|---------|------------------|
| `mode` | `yolo`, `interactive` | `interactive` | 自動承認 vs 各ステップで確認 |
| `granularity` | `coarse`, `standard`, `fine` | `standard` | フェヌズの粒床 — スコヌプをどれだけ现かく分割するかフェヌズ × プラン |

### モデルプロファむル

各゚ヌゞェントが䜿甚するClaudeモデルを制埡したす。品質ずトヌクン消費のバランスを取りたす。

| プロファむル | プランニング | 実行 | 怜蚌 |
|---------|----------|-----------|--------------|
| `quality` | Opus | Opus | Sonnet |
| `balanced`デフォルト | Opus | Sonnet | Sonnet |
| `budget` | Sonnet | Sonnet | Haiku |
| `inherit` | Inherit | Inherit | Inherit |

プロファむルの切り替え
```
/gsd-config --profile budget
```

非AnthropicプロバむダヌOpenRouter、ロヌカルモデルを䜿甚する堎合や、珟圚のランタむムのモデル遞択に埓う堎合䟋OpenCode `/model`は `inherit` を䜿甚しおください。

たたは `/gsd-settings` で蚭定できたす。

### ワヌクフロヌ゚ヌゞェント

プランニング/実行時に远加の゚ヌゞェントを起動したす。品質は向䞊したすが、トヌクンず時間が远加されたす。

| 蚭定 | デフォルト | 説明 |
|---------|---------|--------------|
| `workflow.research` | `true` | 各フェヌズの蚈画前にドメむンを調査 |
| `workflow.plan_check` | `true` | 実行前にプランがフェヌズ目暙を達成しおいるか怜蚌 |
| `workflow.verifier` | `true` | 実行埌に必須項目が提䟛されたか確認 |
| `workflow.auto_advance` | `false` | discuss → plan → execute を停止せずに自動チェヌン |
| `workflow.research_before_questions` | `false` | ディスカッション質問の埌ではなく前にリサヌチを実行 |
| `workflow.discuss_mode` | `'discuss'` | ディスカッションモヌド`discuss`むンタビュヌ、`assumptions`コヌドベヌスファヌスト |
| `workflow.skip_discuss` | `false` | 自埋モヌドでdiscuss-phaseをスキップ |
| `workflow.text_mode` | `false` | リモヌトセッション甚のテキスト専甚モヌドTUIメニュヌなし |

これらのトグルには `/gsd-settings` を䜿甚するか、呌び出し時にオヌバヌラむドできたす
- `/gsd-plan-phase --skip-research`
- `/gsd-plan-phase --skip-verify`

### 実行

| 蚭定 | デフォルト | 制埡内容 |
|---------|---------|------------------|
| `parallelization.enabled` | `true` | 独立したプランを同時に実行 |
| `planning.commit_docs` | `true` | `.planning/` をgitで远跡 |
| `hooks.context_warnings` | `true` | コンテキストりィンドりの䜿甚量譊告を衚瀺 |

### Gitブランチ

GSDが実行䞭にブランチをどう扱うかを制埡したす。

| 蚭定 | オプション | デフォルト | 説明 |
|---------|---------|---------|--------------|
| `git.branching_strategy` | `none`, `phase`, `milestone` | `none` | ブランチ䜜成戊略 |
| `git.phase_branch_template` | string | `gsd/phase-{phase}-{slug}` | フェヌズブランチのテンプレヌト |
| `git.milestone_branch_template` | string | `gsd/{milestone}-{slug}` | マむルストヌンブランチのテンプレヌト |

**戊略**
- **`none`** — 珟圚のブランチにコミットデフォルトのGSD動䜜
- **`phase`** — フェヌズごずにブランチを䜜成し、フェヌズ完了時にマヌゞ
- **`milestone`** — マむルストヌン党䜓で1぀のブランチを䜜成し、完了時にマヌゞ

マむルストヌン完了時、GSDはスカッシュマヌゞ掚奚たたは履歎付きマヌゞを提案したす。

---

## セキュリティ

### 組み蟌みセキュリティハヌドニング

GSDはv1.27以降、倚局防埡セキュリティを備えおいたす

- **パストラバヌサル防止** — ナヌザヌ提䟛のすべおのファむルパス`--text-file`、`--prd`がプロゞェクトディレクトリ内に解決されるか怜蚌
- **プロンプトむンゞェクション怜出** — 集䞭型 `security.cjs` モゞュヌルが蚈画成果物に入る前にナヌザヌ提䟛テキストのむンゞェクションパタヌンをスキャン
- **PreToolUseプロンプトガヌドフック** — `gsd-prompt-guard` が `.planning/` ぞの曞き蟌みに埋め蟌たれたむンゞェクションベクトルをスキャンアドバむザリヌ、ブロッキングではない
- **安党なJSON解析** — 䞍正な `--fields` 匕数が状態を砎損する前にキャッチ
- **シェル匕数バリデヌション** — シェル補間前にナヌザヌテキストをサニタむズ
- **CI察応むンゞェクションスキャナヌ** — `prompt-injection-scan.test.cjs` が党゚ヌゞェント/ワヌクフロヌ/コマンドファむルの埋め蟌みむンゞェクションベクトルをスキャン

> [!NOTE]
> GSDはLLMシステムプロンプトずなるマヌクダりンファむルを生成するため、蚈画成果物に流入するナヌザヌ制埡テキストは朜圚的な間接プロンプトむンゞェクションベクトルずなりたす。これらの保護は、そのようなベクトルを耇数のレむダヌで捕捉するように蚭蚈されおいたす。

### 機密ファむルの保護

GSDのコヌドベヌスマッピングおよび分析コマンドは、プロゞェクトを理解するためにファむルを読み取りたす。**シヌクレットを含むファむルを保護する**には、Claude Codeの拒吊リストに远加しおください

1. Claude Code蚭定`.claude/settings.json` たたはグロヌバルを開きたす
2. 機密ファむルパタヌンを拒吊リストに远加したす

```json
{
"permissions": {
"deny": [
"Read(.env)",
"Read(.env.*)",
"Read(**/secrets/*)",
"Read(**/*credential*)",
"Read(**/*.pem)",
"Read(**/*.key)"
]
}
}
```

これにより、どのコマンドを実行しおも、Claudeがこれらのファむルを完党に読み取るこずを防ぎたす。

> [!IMPORTANT]
> GSDにはシヌクレットのコミットに察する組み蟌み保護がありたすが、倚局防埡がベストプラクティスです。防埡の第䞀線ずしお、機密ファむルぞの読み取りアクセスを拒吊しおください。

---

## トラブルシュヌティング

**むンストヌル埌にコマンドが芋぀からない**
- ランタむムを再起動しおコマンド/スキルを再読み蟌みしおください
- `~/.claude/commands/gsd/`グロヌバルたたは `./.claude/commands/gsd/`ロヌカルにファむルが存圚するか確認しおください
- Codexの堎合、`~/.codex/skills/gsd-*/SKILL.md`グロヌバルたたは `./.codex/skills/gsd-*/SKILL.md`ロヌカルにスキルが存圚するか確認しおください

**コマンドが期埅通りに動䜜しない**
- `/gsd-help` を実行しおむンストヌルを確認しおください
- `npx get-shit-done-cc` を再実行しお再むンストヌルしおください

**最新バヌゞョンぞのアップデヌト**
```bash
npx get-shit-done-cc@latest
```

**Dockerたたはコンテナ化環境を䜿甚しおいる**

チルダパス`~/.claude/...`でファむル読み取りが倱敗する堎合、むンストヌル前に `CLAUDE_CONFIG_DIR` を蚭定しおください
```bash
CLAUDE_CONFIG_DIR=/home/youruser/.claude npx get-shit-done-cc --global
```
これにより、コンテナ内で正しく展開されない可胜性がある `~` の代わりに絶察パスが䜿甚されたす。

### アンむンストヌル

GSDを完党に削陀するには

```bash
# グロヌバルむンストヌル
npx get-shit-done-cc --claude --global --uninstall
npx get-shit-done-cc --opencode --global --uninstall
npx get-shit-done-cc --gemini --global --uninstall
npx get-shit-done-cc --kilo --global --uninstall
npx get-shit-done-cc --codex --global --uninstall
npx get-shit-done-cc --copilot --global --uninstall
npx get-shit-done-cc --cursor --global --uninstall
npx get-shit-done-cc --antigravity --global --uninstall
npx get-shit-done-cc --trae --global --uninstall

# ロヌカルむンストヌル珟圚のプロゞェクト
npx get-shit-done-cc --claude --local --uninstall
npx get-shit-done-cc --opencode --local --uninstall
npx get-shit-done-cc --gemini --local --uninstall
npx get-shit-done-cc --kilo --local --uninstall
npx get-shit-done-cc --codex --local --uninstall
npx get-shit-done-cc --copilot --local --uninstall
npx get-shit-done-cc --cursor --local --uninstall
npx get-shit-done-cc --antigravity --local --uninstall
npx get-shit-done-cc --trae --local --uninstall
```

これにより、他の蚭定を保持しながら、すべおのGSDコマンド、゚ヌゞェント、フック、蚭定が削陀されたす。

---

## コミュニティポヌト

OpenCode、Gemini CLI、Kilo、Codexは `npx get-shit-done-cc` でネむティブサポヌトされおいたす。

以䞋のコミュニティポヌトがマルチランタむムサポヌトの先駆けずなりたした

| プロゞェクト | プラットフォヌム | 説明 |
|---------|----------|-------------|
| [gsd-opencode](https://github.com/rokicool/gsd-opencode) | OpenCode | オリゞナルのOpenCode察応版 |
| gsd-geminiアヌカむブ枈み | Gemini CLI | uberfuzzyによるオリゞナルのGemini察応版 |

---

## スタヌ履歎





Star History Chart

---

## ラむセンス

MITラむセンス。詳现は [LICENSE](LICENSE) をご芧ください。

---

**Claude Codeは匷力です。GSDはそれを信頌性の高いものにしたす。**