SD003フレームワークを新規プロジェクトに展開。 Use when: ユーザーが「SD003導入」「フレームワーク展開」「deploy」と言及した場合。
SD003フレームワーク(v2.14.0)を新規プロジェクトに展開する。 ディレクトリ単位の動的コピーにより、ファイル追加時にスクリプト修正は不要。
| 種別 | ファイル | 動作 |
|---|---|---|
| ルール(上書き) | CLAUDE.md, gemini.md, settings.json, rules/, commands/, hooks/, skills/ | 常に最新版で上書き |
| データ(SKIP+テンプレート) | session-current.md, TIMELINE.md, registry.json, handoff-log.json | 存在しなければテンプレートから生成 |
| 仕様書等 | .sd/specs/, .sessions/ 履歴 | 触らない |
新規ファイル生成時は必ずテンプレートフォルダを確認すること。インラインでheredoc生成は禁止。
| テンプレート | 場所 |
|---|
| セッション関連 | .sessions/templates/ |
| deploy生成ファイル | .claude/skills/sd-deploy/templates/ |
テンプレートにないファイルを新規追加する場合: まずテンプレートファイルを作成してからdeploy.ps1に追加。
/sd:deploy <target-project-path>
powershell -ExecutionPolicy Bypass -File .claude/skills/sd-deploy/deploy.ps1 <target-project-path>
bash .claude/skills/sd-deploy/deploy.sh <target-project-path>
| Phase | 内容 |
|---|---|
| 1 | ターゲット存在確認 |
| 2 | 既存設定のバックアップ |
| 3 | ディレクトリ構造作成 |
| 4 | 動的コピー(ディレクトリ単位、ハードコードなし) |
| 5 | 生成ファイル作成(CLAUDE.md, gemini.md, session等) |
| 6 | 検証(ソースvsターゲットのファイル数比較) |
| 7 | レポート出力 |
| # | ソース | コピー方式 |
|---|---|---|
| 1 | .claude/commands/*.md | フラットコピー |
| 2 | .claude/commands/sd/*.md | フラットコピー |
| 3 | .claude/rules/ | ツリーコピー |
| 4 | .claude/skills/ | ツリーコピー |
| 5 | .claude/hooks/ | ツリーコピー |
| 6 | .gemini/commands/*.toml | フラットコピー |
| 7 | .antigravity/ | ツリーコピー |
| 8 | .sd/settings/ | ツリーコピー |
| 9 | .sessions/session-template.md | 単体コピー |
| 10 | .sd/ai-coordination/workflow/{README,CODEX_GUIDE,templates/} | 選択コピー |
| 11 | docs/troubleshooting/ | ツリーコピー |
| 12 | docs/quality-gates.md | 単体コピー |
| 13 | .handoff/ | ツリーコピー |
| 14 | scripts/sync-gemini-features.js | 単体コピー |
| 16 | AGENTS.md | 単体コピー |
| 17 | .sd/ralph/ | ツリーコピー |
| 18 | .sd/steering/ | ツリーコピー |
| 19 | .sd/refactor/config.json | 単体コピー |
| 20 | tests/gas-fakes/setup.ts | 単体コピー |
| 21 | .git/hooks/ | templates/git-hooks/ からコピー(自動push + .sd/自動ステージ) |
ターゲットプロジェクトの package.json に以下を自動注入。package.json が存在しない場合は自動作成してから注入する:
| 追加内容 | 値 |
|---|---|
| devDependencies | "@mcpher/gas-fakes": "^1.2.0" |
| scripts | "test:gas-fakes": "jest --testPathPatterns=tests/gas-fakes/ --setupFiles=./tests/gas-fakes/setup.ts --passWithNoTests" |
注意: @mcpher/gas-fakes が既に存在する場合はスキップ。
| ファイル | 生成方法 |
|---|---|
CLAUDE.md | テンプレートから生成 |
gemini.md | テンプレートから生成 |
.sessions/session-current.md | 新規生成 |
.sessions/TIMELINE.md | 新規生成 |
.claude/settings.json | OS検出して生成 |
.sd/ids/registry.json | 新規生成 |
.sd/ai-coordination/handoff/handoff-log.json | 新規生成 |
~/.claude/CLAUDE.md | テンプレートから初期配置(既存時スキップ) |
デプロイ先で以下の設定を追加する(スクリプトが自動生成):
.claude/settings.local.json
{
"env": {
"ENABLE_TOOL_SEARCH": "true"
}
}
スクリプトがPhase 6で自動検証を実行する。手動確認する場合:
# ファイル数確認
(Get-ChildItem .claude/commands/*.md).Count # Commands直下
(Get-ChildItem .claude/commands/sd/*.md).Count # Commands/sd
(Get-ChildItem .claude/rules -Recurse -Filter *.md).Count # Rules
(Get-ChildItem .claude/skills -Recurse -File).Count # Skills
(Get-ChildItem .claude/hooks -Recurse -File).Count # Hooks
ls -1 .claude/commands/*.md | wc -l # Commands直下
ls -1 .claude/commands/sd/*.md | wc -l # Commands/sd
find .claude/rules -name '*.md' | wc -l # Rules
find .claude/skills -type f | wc -l # Skills
find .claude/hooks -type f | wc -l # Hooks
v3.0.0の最大の改善点: ファイルを追加しても deploy スクリプトの修正は不要。
| 追加先 | 必要な操作 |
|---|---|
.claude/commands/ | ファイルを置くだけ |
.claude/commands/sd/ | ファイルを置くだけ |
.claude/rules/ | ファイルを置くだけ |
.claude/skills/ | ディレクトリ+ファイルを作成するだけ |
.claude/hooks/ | ファイルを置くだけ |
.gemini/commands/ | ファイルを置くだけ |
README.md を参照。