diff --git a/.gitignore b/.gitignore index b89f1dc83..959684d22 100644 --- a/.gitignore +++ b/.gitignore @@ -66,3 +66,4 @@ vendor/ .cache/ tmp/ .worktrees +.envrc diff --git a/README.ja-JP.md b/README.ja-JP.md index be1e58fed..afc520b0e 100644 --- a/README.ja-JP.md +++ b/README.ja-JP.md @@ -80,7 +80,7 @@ GSDはそれを解決します。Claude Codeを信頼性の高いものにする 完全なリストは [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-edit-phase`** — `ROADMAP.md` 上の既存フェーズの任意フィールドをその場で編集(番号や位置は変更されない)。`--force` で確認 diff をスキップ、`depends_on` の参照を検証し、書き込み時に `STATE.md` も更新。 +- **`/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` を指定するとルート値を上書き可能。 @@ -565,9 +565,9 @@ lmn012o feat(08-02): create registration endpoint | コマンド | 説明 | |---------|--------------| -| `/gsd-new-workspace` | リポジトリのコピー(worktreeまたはクローン)で隔離されたワークスペースを作成 | -| `/gsd-list-workspaces` | すべてのGSDワークスペースとそのステータスを表示 | -| `/gsd-remove-workspace` | ワークスペースを削除しworktreeをクリーンアップ | +| `/gsd-workspace --new` | リポジトリのコピー(worktreeまたはクローン)で隔離されたワークスペースを作成 | +| `/gsd-workspace --list` | すべてのGSDワークスペースとそのステータスを表示 | +| `/gsd-workspace --remove` | ワークスペースを削除しworktreeをクリーンアップ | ### UIデザイン @@ -584,7 +584,7 @@ lmn012o feat(08-02): create registration endpoint | `/gsd-progress --next` | 状態を自動検出し次のステップを実行 | | `/gsd-help` | 全コマンドと使い方ガイドを表示 | | `/gsd-update` | チェンジログプレビュー付きでGSDをアップデート | -| `/gsd-join-discord` | GSD Discordコミュニティに参加 | +| `/gsd-help` | GSD Discordコミュニティに参加 | | `/gsd-manager` | 複数フェーズ管理用のインタラクティブコマンドセンター | ### ブラウンフィールド @@ -597,12 +597,12 @@ lmn012o feat(08-02): create registration endpoint | コマンド | 説明 | |---------|--------------| -| `/gsd-add-phase` | ロードマップにフェーズを追加 | -| `/gsd-insert-phase [N]` | フェーズ間に緊急作業を挿入 | -| `/gsd-edit-phase [N] [--force]` | 既存フェーズの任意フィールドをその場で編集 — 番号と位置は変更されない | -| `/gsd-remove-phase [N]` | 将来のフェーズを削除し番号を振り直し | -| `/gsd-list-phase-assumptions [N]` | 計画前にClaudeの意図するアプローチを確認 | -| `/gsd-plan-milestone-gaps` | 監査で見つかったギャップを埋めるフェーズを作成 | +| `/gsd-phase` | ロードマップにフェーズを追加 | +| `/gsd-phase --insert [N]` | フェーズ間に緊急作業を挿入 | +| `/gsd-phase --edit [N] [--force]` | 既存フェーズの任意フィールドをその場で編集 — 番号と位置は変更されない | +| `/gsd-phase --remove [N]` | 将来のフェーズを削除し番号を振り直し | +| `/gsd-discuss-phase --assumptions [N]` | 計画前にClaudeの意図するアプローチを確認 | +| `/gsd-audit-milestone` | 監査で見つかったギャップを埋めるフェーズを作成 | ### セッション @@ -610,7 +610,7 @@ lmn012o feat(08-02): create registration endpoint |---------|--------------| | `/gsd-pause-work` | フェーズ途中で停止する際の引き継ぎを作成(HANDOFF.jsonを書き込み) | | `/gsd-resume-work` | 前回のセッションから復元 | -| `/gsd-session-report` | 実行した作業と結果のセッションサマリーを生成 | +| `/gsd-pause-work --report` | 実行した作業と結果のセッションサマリーを生成 | ### ワークストリーム @@ -630,8 +630,8 @@ lmn012o feat(08-02): create registration endpoint | コマンド | 説明 | |---------|--------------| -| `/gsd-plant-seed ` | トリガー条件付きの将来志向のアイデアをキャプチャ — 適切なマイルストーンで浮上 | -| `/gsd-add-backlog ` | バックログのパーキングロットにアイデアを追加(999.xナンバリング、アクティブシーケンス外) | +| `/gsd-capture --seed ` | トリガー条件付きの将来志向のアイデアをキャプチャ — 適切なマイルストーンで浮上 | +| `/gsd-capture --backlog ` | バックログのパーキングロットにアイデアを追加(999.xナンバリング、アクティブシーケンス外) | | `/gsd-review-backlog` | バックログ項目をレビューし、アクティブマイルストーンに昇格またはstaleエントリを削除 | | `/gsd-thread [name]` | 永続コンテキストスレッド — 複数セッションにまたがる作業用の軽量クロスセッション知識 | @@ -640,9 +640,9 @@ lmn012o feat(08-02): create registration endpoint | コマンド | 説明 | |---------|--------------| | `/gsd-settings` | モデルプロファイルとワークフローエージェントを設定 | -| `/gsd-set-profile ` | モデルプロファイルを切り替え(quality/balanced/budget/inherit) | -| `/gsd-add-todo [desc]` | 後で取り組むアイデアをキャプチャ | -| `/gsd-check-todos` | 保留中のtodoを一覧表示 | +| `/gsd-config --profile ` | モデルプロファイルを切り替え(quality/balanced/budget/inherit) | +| `/gsd-capture [desc]` | 後で取り組むアイデアをキャプチャ | +| `/gsd-capture --list` | 保留中のtodoを一覧表示 | | `/gsd-debug [desc]` | 永続状態を持つ体系的デバッグ | | `/gsd-do ` | フリーフォームテキストを適切なGSDコマンドに自動ルーティング | | `/gsd-note ` | ゼロフリクションのアイデアキャプチャ — ノートの追加、一覧、todoへの昇格 | @@ -679,7 +679,7 @@ GSDはプロジェクト設定を `.planning/config.json` に保存します。` プロファイルの切り替え: ``` -/gsd-set-profile budget +/gsd-config --profile budget ``` 非Anthropicプロバイダー(OpenRouter、ローカルモデル)を使用する場合や、現在のランタイムのモデル選択に従う場合(例:OpenCode `/model`)は `inherit` を使用してください。 diff --git a/README.ko-KR.md b/README.ko-KR.md index 965a5c58b..e97758d75 100644 --- a/README.ko-KR.md +++ b/README.ko-KR.md @@ -80,7 +80,7 @@ GSD가 그걸 고칩니다. Claude Code를 신뢰할 수 있게 만드는 컨텍 전체 목록은 [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-edit-phase`** — `ROADMAP.md`에 있는 기존 단계의 임의 필드를 그 자리에서 수정(번호와 위치는 변경되지 않음). `--force`는 확인 diff를 건너뛰고, `depends_on` 참조를 검증하며 쓰기 시 `STATE.md`도 갱신. +- **`/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`은 루트 값을 덮어씀. @@ -562,9 +562,9 @@ lmn012o feat(08-02): create registration endpoint | 명령어 | 역할 | |---------|------------| -| `/gsd-new-workspace` | 저장소 복사본으로 격리된 워크스페이스 생성 (worktrees 또는 clones) | -| `/gsd-list-workspaces` | 모든 GSD 워크스페이스와 상태 표시 | -| `/gsd-remove-workspace` | 워크스페이스 제거 및 worktree 정리 | +| `/gsd-workspace --new` | 저장소 복사본으로 격리된 워크스페이스 생성 (worktrees 또는 clones) | +| `/gsd-workspace --list` | 모든 GSD 워크스페이스와 상태 표시 | +| `/gsd-workspace --remove` | 워크스페이스 제거 및 worktree 정리 | ### UI 디자인 @@ -581,7 +581,7 @@ lmn012o feat(08-02): create registration endpoint | `/gsd-progress --next` | 상태 자동 감지 및 다음 단계 실행 | | `/gsd-help` | 모든 명령어와 사용 가이드 표시 | | `/gsd-update` | 변경 로그 미리보기와 함께 GSD 업데이트 | -| `/gsd-join-discord` | GSD Discord 커뮤니티 참여 | +| `/gsd-help` | GSD Discord 커뮤니티 참여 | | `/gsd-manager` | 여러 단계 관리를 위한 대화형 커맨드 센터 | ### 브라운필드 @@ -594,12 +594,12 @@ lmn012o feat(08-02): create registration endpoint | 명령어 | 역할 | |---------|------------| -| `/gsd-add-phase` | 로드맵에 단계 추가 | -| `/gsd-insert-phase [N]` | 단계 사이에 긴급 작업 삽입 | -| `/gsd-edit-phase [N] [--force]` | 기존 단계의 임의 필드를 그 자리에서 수정 — 번호와 위치는 그대로 | -| `/gsd-remove-phase [N]` | 미래 단계 제거, 번호 재정렬 | -| `/gsd-list-phase-assumptions [N]` | 기획 전 Claude의 의도된 접근 방식 확인 | -| `/gsd-plan-milestone-gaps` | 감사에서 발견된 갭을 해소하기 위한 단계 생성 | +| `/gsd-phase` | 로드맵에 단계 추가 | +| `/gsd-phase --insert [N]` | 단계 사이에 긴급 작업 삽입 | +| `/gsd-phase --edit [N] [--force]` | 기존 단계의 임의 필드를 그 자리에서 수정 — 번호와 위치는 그대로 | +| `/gsd-phase --remove [N]` | 미래 단계 제거, 번호 재정렬 | +| `/gsd-discuss-phase --assumptions [N]` | 기획 전 Claude의 의도된 접근 방식 확인 | +| `/gsd-audit-milestone` | 감사에서 발견된 갭을 해소하기 위한 단계 생성 | ### 세션 @@ -607,7 +607,7 @@ lmn012o feat(08-02): create registration endpoint |---------|------------| | `/gsd-pause-work` | 단계 중간에 멈출 때 핸드오프 생성 (HANDOFF.json 작성) | | `/gsd-resume-work` | 마지막 세션에서 복원 | -| `/gsd-session-report` | 수행한 작업과 결과가 담긴 세션 요약 생성 | +| `/gsd-pause-work --report` | 수행한 작업과 결과가 담긴 세션 요약 생성 | ### 코드 품질 @@ -621,8 +621,8 @@ lmn012o feat(08-02): create registration endpoint | 명령어 | 역할 | |---------|------------| -| `/gsd-plant-seed ` | 트리거 조건이 있는 아이디어 저장 — 때가 되면 알아서 올라옴 | -| `/gsd-add-backlog ` | 백로그 파킹 롯에 아이디어 추가 (999.x 번호 지정, 활성 시퀀스 외부) | +| `/gsd-capture --seed ` | 트리거 조건이 있는 아이디어 저장 — 때가 되면 알아서 올라옴 | +| `/gsd-capture --backlog ` | 백로그 파킹 롯에 아이디어 추가 (999.x 번호 지정, 활성 시퀀스 외부) | | `/gsd-review-backlog` | 백로그 항목 리뷰 및 활성 마일스톤으로 승격하거나 오래된 항목 제거 | | `/gsd-thread [name]` | 지속적 컨텍스트 스레드 — 여러 세션에 걸친 작업을 위한 가벼운 크로스 세션 지식 | @@ -631,9 +631,9 @@ lmn012o feat(08-02): create registration endpoint | 명령어 | 역할 | |---------|------------| | `/gsd-settings` | 모델 프로필 및 워크플로우 에이전트 설정 | -| `/gsd-set-profile ` | 모델 프로필 전환 (quality/balanced/budget/inherit) | -| `/gsd-add-todo [desc]` | 나중을 위한 아이디어 캡처 | -| `/gsd-check-todos` | 대기 중인 할 일 목록 | +| `/gsd-config --profile ` | 모델 프로필 전환 (quality/balanced/budget/inherit) | +| `/gsd-capture [desc]` | 나중을 위한 아이디어 캡처 | +| `/gsd-capture --list` | 대기 중인 할 일 목록 | | `/gsd-debug [desc]` | 지속적 상태를 이용한 체계적 디버깅 | | `/gsd-do ` | 자유 형식 텍스트를 적절한 GSD 명령어로 자동 라우팅 | | `/gsd-note ` | 마찰 없는 아이디어 캡처 — 추가, 목록, 또는 할 일로 승격 | @@ -670,7 +670,7 @@ GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd- 프로필 전환: ``` -/gsd-set-profile budget +/gsd-config --profile budget ``` 비-Anthropic 제공업체 (OpenRouter, 로컬 모델) 사용 시 또는 현재 런타임 모델 선택을 따를 때 (예: OpenCode `/model`) `inherit`를 사용하세요. diff --git a/README.md b/README.md index df71ec971..161a0b5b7 100644 --- a/README.md +++ b/README.md @@ -94,7 +94,7 @@ Built-in quality gates catch real problems: schema drift detection flags ORM cha See the [v1.39.0 release notes](https://github.com/gsd-build/get-shit-done/releases/tag/v1.39.0) for the full list. - **`--minimal` install profile** — alias `--core-only`, writes only the six main-loop skills (`new-project`, `discuss-phase`, `plan-phase`, `execute-phase`, `help`, `update`) and zero `gsd-*` subagents. Cuts cold-start system-prompt overhead from ~12k tokens to ~700 (≥94% reduction). Useful for local LLMs with 32K–128K context and token-billed APIs. -- **`/gsd-edit-phase`** — modify any field of an existing phase in `ROADMAP.md` in place, without changing its number or position. `--force` skips the confirmation diff; `depends_on` references are validated and `STATE.md` is updated on write. +- **`/gsd-phase --edit`** — modify any field of an existing phase in `ROADMAP.md` in place, without changing its number or position. `--force` skips the confirmation diff; `depends_on` references are validated and `STATE.md` is updated on write. - **Post-merge build & test gate** — `execute-phase` step 5.6 now auto-detects the build command from `workflow.build_command`, then falls back to Xcode (`.xcodeproj`), Makefile, Justfile, Cargo, Go, Python, or npm. Xcode/iOS projects get `xcodebuild build` + `xcodebuild test` automatically. Runs in both parallel and serial mode. - **Per-runtime review-model selection** — `review.models.` lets each external review CLI (codex, gemini, etc.) pick its own model independently of the planner/executor profile. - **Workstream config inheritance** — when `GSD_WORKSTREAM` is set, the root `.planning/config.json` is loaded first and deep-merged with the workstream config (workstream wins on conflict). Explicit `null` in a workstream config now correctly overrides a root value. @@ -652,8 +652,8 @@ You're never locked in. The system adapts. | Command | What it does | |---------|--------------| | `/gsd-workspace --new` | Create isolated workspace with repo copies (worktrees or clones) | -| `/gsd-list-workspaces` | Show all GSD workspaces and their status | -| `/gsd-remove-workspace` | Remove workspace and clean up worktrees | +| `/gsd-workspace --list` | Show all GSD workspaces and their status | +| `/gsd-workspace --remove` | Remove workspace and clean up worktrees | ### Spiking & Sketching @@ -661,8 +661,8 @@ You're never locked in. The system adapts. |---------|--------------| | `/gsd-spike [idea] [--quick]` | Throwaway experiments to validate feasibility before planning — no project init required | | `/gsd-sketch [idea] [--quick]` | Throwaway HTML mockups with multi-variant exploration — no project init required | -| `/gsd-spike-wrap-up` | Package spike findings into a project-local skill for future build conversations | -| `/gsd-sketch-wrap-up` | Package sketch design findings into a project-local skill for future builds | +| `/gsd-spike --wrap-up` | Package spike findings into a project-local skill for future build conversations | +| `/gsd-sketch --wrap-up` | Package sketch design findings into a project-local skill for future builds | ### UI Design @@ -679,7 +679,7 @@ You're never locked in. The system adapts. | `/gsd-progress --next` | Auto-detect state and run the next step | | `/gsd-help` | Show all commands and usage guide | | `/gsd-update` | Update GSD with changelog preview | -| `/gsd-join-discord` | Join the GSD Discord community | +| `/gsd-help` | Join the GSD Discord community | | `/gsd-manager` | Interactive command center for managing multiple phases | ### Brownfield @@ -693,11 +693,11 @@ You're never locked in. The system adapts. | Command | What it does | |---------|--------------| -| `/gsd-add-phase` | Append phase to roadmap | -| `/gsd-insert-phase [N]` | Insert urgent work between phases | -| `/gsd-edit-phase [N] [--force]` | Modify any field of an existing phase in place — number and position unchanged | -| `/gsd-remove-phase [N]` | Remove future phase, renumber | -| `/gsd-list-phase-assumptions [N]` | See Claude's intended approach before planning | +| `/gsd-phase` | Append phase to roadmap | +| `/gsd-phase --insert [N]` | Insert urgent work between phases | +| `/gsd-phase --edit [N] [--force]` | Modify any field of an existing phase in place — number and position unchanged | +| `/gsd-phase --remove [N]` | Remove future phase, renumber | +| `/gsd-discuss-phase --assumptions [N]` | See Claude's intended approach before planning | ### Session @@ -705,7 +705,7 @@ You're never locked in. The system adapts. |---------|--------------| | `/gsd-pause-work` | Create handoff when stopping mid-phase (writes HANDOFF.json) | | `/gsd-resume-work` | Restore from last session | -| `/gsd-session-report` | Generate session summary with work performed and outcomes | +| `/gsd-pause-work --report` | Generate session summary with work performed and outcomes | ### Workstreams @@ -727,8 +727,8 @@ You're never locked in. The system adapts. | Command | What it does | |---------|--------------| -| `/gsd-plant-seed ` | Capture forward-looking ideas with trigger conditions — surfaces at the right milestone | -| `/gsd-add-backlog ` | Add idea to backlog parking lot (999.x numbering, outside active sequence) | +| `/gsd-capture --seed ` | Capture forward-looking ideas with trigger conditions — surfaces at the right milestone | +| `/gsd-capture --backlog ` | Add idea to backlog parking lot (999.x numbering, outside active sequence) | | `/gsd-review-backlog` | Review and promote backlog items to active milestone or remove stale entries | | `/gsd-thread [name]` | Persistent context threads — lightweight cross-session knowledge for work spanning multiple sessions | @@ -737,8 +737,8 @@ You're never locked in. The system adapts. | Command | What it does | |---------|--------------| | `/gsd-settings` | Configure model profile and workflow agents | -| `/gsd-set-profile ` | Switch model profile (quality/balanced/budget/inherit) | -| `/gsd-add-todo [desc]` | Capture idea for later | +| `/gsd-config --profile ` | Switch model profile (quality/balanced/budget/inherit) | +| `/gsd-capture [desc]` | Capture idea for later | | `/gsd-capture --list` | List pending todos | | `/gsd-debug [desc]` | Systematic debugging with persistent state | | `/gsd-do ` | Route freeform text to the right GSD command automatically | @@ -779,7 +779,7 @@ Control which Claude model each agent uses. Balance quality vs token spend. Switch profiles: ``` -/gsd-set-profile budget +/gsd-config --profile budget ``` Use `inherit` when using non-Anthropic providers (OpenRouter, local models) or to follow the current runtime model selection (e.g. OpenCode `/model`). diff --git a/README.pt-BR.md b/README.pt-BR.md index 8fcca6652..72f317b72 100644 --- a/README.pt-BR.md +++ b/README.pt-BR.md @@ -78,7 +78,7 @@ Quality gates embutidos capturam problemas reais: detecção de schema drift sin Lista completa nas [notas de release v1.39.0](https://github.com/gsd-build/get-shit-done/releases/tag/v1.39.0). - **Perfil de instalação `--minimal`** — alias `--core-only`. Instala apenas os 6 skills do loop principal (`new-project`, `discuss-phase`, `plan-phase`, `execute-phase`, `help`, `update`) e nenhum subagente `gsd-*`. Reduz o overhead do system prompt no cold-start de ~12k para ~700 tokens (≥94% de redução). Útil para LLMs locais com contexto de 32K–128K e APIs cobradas por token. -- **`/gsd-edit-phase`** — edita qualquer campo de uma fase existente em `ROADMAP.md` no lugar, sem alterar o número ou a posição. `--force` pula o diff de confirmação; referências em `depends_on` são validadas e o `STATE.md` é atualizado na escrita. +- **`/gsd-phase --edit`** — edita qualquer campo de uma fase existente em `ROADMAP.md` no lugar, sem alterar o número ou a posição. `--force` pula o diff de confirmação; referências em `depends_on` são validadas e o `STATE.md` é atualizado na escrita. - **Build & test gate pós-merge** — o passo 5.6 de `execute-phase` agora detecta automaticamente o comando de build em `workflow.build_command`, com fallback para Xcode (`.xcodeproj`), Makefile, Justfile, Cargo, Go, Python ou npm. Projetos Xcode/iOS rodam `xcodebuild build` e `xcodebuild test` automaticamente. Funciona em modo paralelo e serial. - **Modelo de review por runtime** — `review.models.` permite que cada CLI externa de review (codex, gemini, etc.) escolha seu próprio modelo, independente do perfil de planner/executor. - **Herança de configuração de workstream** — quando `GSD_WORKSTREAM` está definido, o `.planning/config.json` raiz é carregado primeiro e merge-deep com o config da workstream (workstream vence em conflito). Um `null` explícito no config da workstream sobrescreve corretamente o valor raiz. @@ -339,7 +339,7 @@ Cada tarefa gera commit próprio, facilitando `git bisect`, rollback e rastreabi | `/gsd-review` | Peer review com múltiplas IAs | | `/gsd-pr-branch` | Cria branch limpa para PR | | `/gsd-settings` | Configura perfis e agentes | -| `/gsd-set-profile ` | Troca perfil (quality/balanced/budget/inherit) | +| `/gsd-config --profile ` | Troca perfil (quality/balanced/budget/inherit) | | `/gsd-quick [--full] [--discuss] [--research]` | Execução rápida com garantias do GSD (`--full` ativa todas as etapas, `--validate` ativa apenas verificação) | | `/gsd-health [--repair]` | Verifica e repara `.planning/` | @@ -370,7 +370,7 @@ Você pode configurar no `/gsd-new-project` ou ajustar depois com `/gsd-settings Troca rápida: ``` -/gsd-set-profile budget +/gsd-config --profile budget ``` --- diff --git a/README.zh-CN.md b/README.zh-CN.md index 8a925a53e..1915032c6 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -78,7 +78,7 @@ GSD 解决的就是这个问题。它是让 Claude Code 变得可靠的上下文 完整列表请参阅 [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 token 降至 ~700 token(≥94% 减少)。适合 32K–128K 上下文的本地 LLM 和按 token 计费的 API。 -- **`/gsd-edit-phase`** — 就地修改 `ROADMAP.md` 中已有阶段的任意字段,不改变其编号或位置。`--force` 跳过确认 diff,验证 `depends_on` 引用,并在写入时更新 `STATE.md`。 +- **`/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` 会覆盖根值。 @@ -558,9 +558,9 @@ lmn012o feat(08-02): create registration endpoint | 命令 | 作用 | |------|------| -| `/gsd-new-workspace` | 创建隔离工作区,包含仓库副本(worktree 或 clone) | -| `/gsd-list-workspaces` | 显示所有 GSD 工作区及其状态 | -| `/gsd-remove-workspace` | 移除工作区并清理 worktree | +| `/gsd-workspace --new` | 创建隔离工作区,包含仓库副本(worktree 或 clone) | +| `/gsd-workspace --list` | 显示所有 GSD 工作区及其状态 | +| `/gsd-workspace --remove` | 移除工作区并清理 worktree | ### UI 设计 @@ -577,7 +577,7 @@ lmn012o feat(08-02): create registration endpoint | `/gsd-progress --next` | 自动检测状态并执行下一步 | | `/gsd-help` | 显示全部命令和使用指南 | | `/gsd-update` | 更新 GSD,并预览变更日志 | -| `/gsd-join-discord` | 加入 GSD Discord 社区 | +| `/gsd-help` | 加入 GSD Discord 社区 | ### Brownfield @@ -589,12 +589,12 @@ lmn012o feat(08-02): create registration endpoint | 命令 | 作用 | |------|------| -| `/gsd-add-phase` | 在路线图末尾追加 phase | -| `/gsd-insert-phase [N]` | 在 phase 之间插入紧急工作 | -| `/gsd-edit-phase [N] [--force]` | 就地修改已有 phase 的任意字段 — 编号与位置保持不变 | -| `/gsd-remove-phase [N]` | 删除未来 phase,并重编号 | -| `/gsd-list-phase-assumptions [N]` | 在规划前查看 Claude 打算采用的方案 | -| `/gsd-plan-milestone-gaps` | 为 audit 发现的缺口创建 phase | +| `/gsd-phase` | 在路线图末尾追加 phase | +| `/gsd-phase --insert [N]` | 在 phase 之间插入紧急工作 | +| `/gsd-phase --edit [N] [--force]` | 就地修改已有 phase 的任意字段 — 编号与位置保持不变 | +| `/gsd-phase --remove [N]` | 删除未来 phase,并重编号 | +| `/gsd-discuss-phase --assumptions [N]` | 在规划前查看 Claude 打算采用的方案 | +| `/gsd-audit-milestone` | 为 audit 发现的缺口创建 phase | ### 代码质量 @@ -608,7 +608,7 @@ lmn012o feat(08-02): create registration endpoint | 命令 | 作用 | |------|------| -| `/gsd-plant-seed ` | 将想法存入积压停车场,留待未来里程碑 | +| `/gsd-capture --seed ` | 将想法存入积压停车场,留待未来里程碑 | ### 会话 @@ -616,16 +616,16 @@ lmn012o feat(08-02): create registration endpoint |------|------| | `/gsd-pause-work` | 在中途暂停时创建交接上下文(写入 HANDOFF.json) | | `/gsd-resume-work` | 从上一次会话恢复 | -| `/gsd-session-report` | 生成会话摘要,包含已完成工作和结果 | +| `/gsd-pause-work --report` | 生成会话摘要,包含已完成工作和结果 | ### 工具 | 命令 | 作用 | |------|------| | `/gsd-settings` | 配置模型 profile 和工作流代理 | -| `/gsd-set-profile ` | 切换模型 profile(quality / balanced / budget / inherit) | -| `/gsd-add-todo [desc]` | 记录一个待办想法 | -| `/gsd-check-todos` | 查看待办列表 | +| `/gsd-config --profile ` | 切换模型 profile(quality / balanced / budget / inherit) | +| `/gsd-capture [desc]` | 记录一个待办想法 | +| `/gsd-capture --list` | 查看待办列表 | | `/gsd-debug [desc]` | 使用持久状态进行系统化调试 | | `/gsd-do ` | 将自由文本自动路由到正确的 GSD 命令 | | `/gsd-note ` | 零摩擦想法捕捉——追加、列出或提升为待办 | @@ -662,7 +662,7 @@ GSD 将项目设置保存在 `.planning/config.json`。你可以在 `/gsd-new-pr 切换方式: ``` -/gsd-set-profile budget +/gsd-config --profile budget ``` 使用非 Anthropic 提供商(OpenRouter、本地模型)时,或想跟随当前运行时的模型选择时(如 OpenCode 的 `/model`),可用 `inherit`。 diff --git a/docs/AGENTS.md b/docs/AGENTS.md index 3c6ef03d6..4c3479b14 100644 --- a/docs/AGENTS.md +++ b/docs/AGENTS.md @@ -480,7 +480,7 @@ Communication style, decision patterns, debugging approach, UX preferences, vend ## Advanced and Specialized Agents -Twelve additional agents ship under `agents/gsd-*.md` and are used by specialty workflows (`/gsd-ai-integration-phase`, `/gsd-eval-review`, `/gsd-code-review`, `/gsd-code-review --fix`, `/gsd-debug`, `/gsd-intel`, `/gsd-select-framework`, `/gsd-ingest-docs`) and by the planner pipeline. Each carries full frontmatter in its agent file; the stubs below are concise by design. The authoritative roster (with spawner and primary-doc status per agent) lives in [`docs/INVENTORY.md`](INVENTORY.md). +Twelve additional agents ship under `agents/gsd-*.md` and are used by specialty workflows (`/gsd-ai-integration-phase`, `/gsd-eval-review`, `/gsd-code-review`, `/gsd-code-review --fix`, `/gsd-debug`, `/gsd-map-codebase --query`, `/gsd-select-framework`, `/gsd-ingest-docs`) and by the planner pipeline. Each carries full frontmatter in its agent file; the stubs below are concise by design. The authoritative roster (with spawner and primary-doc status per agent) lives in [`docs/INVENTORY.md`](INVENTORY.md). ### gsd-pattern-mapper @@ -669,7 +669,7 @@ Twelve additional agents ship under `agents/gsd-*.md` and are used by specialty | Property | Value | |----------|-------| -| **Spawned by** | `/gsd-intel` (refresh / update flows) | +| **Spawned by** | `/gsd-map-codebase --query` (refresh / update flows) | | **Parallelism** | Single instance | | **Tools** | Read, Write, Bash, Glob, Grep | | **Model (balanced)** | Sonnet | diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 19c1441ec..6268a4a9c 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -535,7 +535,7 @@ Equivalent paths for other runtimes: │ ├── pending/ # Captured ideas │ └── done/ # Completed todos ├── threads/ # Persistent context threads (from /gsd-thread) -├── seeds/ # Forward-looking ideas (from /gsd-plant-seed) +├── seeds/ # Forward-looking ideas (from /gsd-capture --seed) ├── debug/ # Active debug sessions │ ├── *.md # Active sessions │ ├── resolved/ # Archived sessions diff --git a/docs/CLI-TOOLS.md b/docs/CLI-TOOLS.md index bd8fad590..b5d09cdd0 100644 --- a/docs/CLI-TOOLS.md +++ b/docs/CLI-TOOLS.md @@ -479,7 +479,7 @@ User-facing entry point: `/gsd-graphify` (see [Command Reference](COMMANDS.md#gs | Learnings | `lib/learnings.cjs` | Extract learnings from phases/SUMMARY artifacts (backs `/gsd-extract-learnings`) | | Audit | `lib/audit.cjs` | Phase/milestone audit queue handlers; `audit-open` helper | | GSD2 Import | `lib/gsd2-import.cjs` | Reverse-migration importer from GSD-2 projects (backs `/gsd-from-gsd2`) | -| Intel | `lib/intel.cjs` | Queryable codebase intelligence index (backs `/gsd-intel`) | +| Intel | `lib/intel.cjs` | Queryable codebase intelligence index (backs `/gsd-map-codebase --query`) | --- diff --git a/docs/COMMANDS.md b/docs/COMMANDS.md index 89b2fd5cd..a6ea9a9fd 100644 --- a/docs/COMMANDS.md +++ b/docs/COMMANDS.md @@ -97,6 +97,7 @@ Gather phase context through adaptive questioning before planning. | `--batch` | Group questions for batch intake instead of one-by-one | | `--analyze` | Add trade-off analysis during discussion | | `--power` | File-based bulk question answering from a prepared answers file | +| `--assumptions` | Surface Claude's implementation assumptions about the phase without an interactive session | **Prerequisites:** `.planning/ROADMAP.md` exists **Produces:** `{phase}-CONTEXT.md`, `{phase}-DISCUSSION-LOG.md` (audit trail) @@ -108,6 +109,7 @@ Gather phase context through adaptive questioning before planning. /gsd-discuss-phase --batch # Batch mode for current phase /gsd-discuss-phase 2 --analyze # Discussion with trade-off analysis /gsd-discuss-phase 1 --power # Bulk answers from file +/gsd-discuss-phase 3 --assumptions # Surface Claude's assumptions before planning ``` --- @@ -462,8 +464,13 @@ Restore full context from last session. Save context handoff when stopping mid-phase. +| Flag | Description | +|------|-------------| +| `--report` | Generate a post-session summary in `.planning/reports/` capturing commits, file changes, and phase progress | + ```bash /gsd-pause-work # Creates continue-here.md +/gsd-pause-work --report # Creates continue-here.md + session report ``` ### `/gsd-manager` @@ -480,6 +487,7 @@ Interactive command center for managing multiple phases from one terminal. ```bash /gsd-manager # Open command center dashboard +/gsd-manager --analyze-deps # Scan ROADMAP phases for dependency relationships before parallel execution ``` **Checkpoint Heartbeats (#2410):** @@ -570,13 +578,15 @@ Safe git revert — roll back GSD phase or plan commits using the phase manifest Ingest an external plan file into the GSD planning system with conflict detection against `PROJECT.md` decisions before writing anything. | Flag | Required | Description | -|------|----------|-------------| -| `--from ` | **Yes** | Path to the external plan file to import | +|------|----------|--------------| +| `--from ` | Yes (or `--from-gsd2`) | Path to the external plan file to import | +| `--from-gsd2` | Yes (or `--from`) | Reverse-migrate a GSD-2 (`.gsd/`) project back to GSD v1 (`.planning/`) format | **Process:** Detects conflicts → prompts for resolution → writes as GSD PLAN.md → validates via `gsd-plan-checker` ```bash /gsd-import --from /tmp/team-plan.md # Import and validate an external plan +/gsd-import --from-gsd2 # Migrate from GSD-2 back to v1 ``` --- diff --git a/docs/CONFIGURATION.md b/docs/CONFIGURATION.md index 1a2d5dd97..9e3bf53f6 100644 --- a/docs/CONFIGURATION.md +++ b/docs/CONFIGURATION.md @@ -352,7 +352,7 @@ Toggle optional capabilities via the `features.*` config namespace. Feature flag | `features.thinking_partner` | boolean | `false` | Enable thinking partner analysis at workflow decision points | | `features.global_learnings` | boolean | `false` | Enable cross-project learnings pipeline (auto-copy at phase completion, planner injection) | | `learnings.max_inject` | number | `10` | Maximum number of cross-project learnings injected into each planner prompt. Lower values reduce prompt size; higher values provide broader historical context | -| `intel.enabled` | boolean | `false` | Enable queryable codebase intelligence system. When `true`, `/gsd-intel` commands build and query a JSON index in `.planning/intel/`. Added in v1.34 | +| `intel.enabled` | boolean | `false` | Enable queryable codebase intelligence system. When `true`, `/gsd-map-codebase --query` commands build and query a JSON index in `.planning/intel/`. Added in v1.34 | ### Graphify Settings diff --git a/docs/FEATURES.md b/docs/FEATURES.md index 309805727..2947f399e 100644 --- a/docs/FEATURES.md +++ b/docs/FEATURES.md @@ -461,7 +461,7 @@ ### 9. Phase Management -**Commands:** `/gsd-add-phase`, `/gsd-insert-phase [N]`, `/gsd-remove-phase [N]` +**Commands:** `/gsd-phase`, `/gsd-phase --insert [N]`, `/gsd-phase --remove [N]` **Purpose:** Dynamic roadmap modification during development. @@ -709,7 +709,7 @@ ### 24. Session Reporting -**Command:** `/gsd-session-report` +**Command:** `/gsd-pause-work --report` **Purpose:** Generate a structured post-session summary document capturing work performed, outcomes achieved, and estimated resource usage. @@ -748,7 +748,7 @@ ### 26. Model Profiles -**Command:** `/gsd-set-profile ` +**Command:** `/gsd-config --profile ` **Purpose:** Control which AI model each agent uses, balancing quality vs cost. @@ -869,7 +869,7 @@ continues. Drift detection cannot fail verification. ### 29. Todo Management -**Commands:** `/gsd-add-todo [desc]`, `/gsd-capture --list` +**Commands:** `/gsd-capture [desc]`, `/gsd-capture --list` **Purpose:** Capture ideas and tasks during sessions for later work. @@ -1185,7 +1185,7 @@ When verification returns `human_needed`, items are persisted as a trackable HUM ### 43. Backlog Parking Lot -**Commands:** `/gsd-add-backlog `, `/gsd-review-backlog`, `/gsd-plant-seed ` +**Commands:** `/gsd-capture --backlog `, `/gsd-review-backlog`, `/gsd-capture --seed ` **Purpose:** Capture ideas that aren't ready for active planning. Backlog items use 999.x numbering to stay outside the active phase sequence. Seeds are forward-looking ideas with trigger conditions that surface automatically at the right milestone. @@ -1845,7 +1845,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject ### 77. Phase Dependency Analysis -**Command:** `/gsd-analyze-dependencies` +**Command:** `/gsd-manager --analyze-deps` **Purpose:** Detect phase dependencies and suggest `Depends on` entries for ROADMAP.md before running `/gsd-manager`. @@ -2266,7 +2266,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject **Requirements:** - REQ-ADAPTIVE-01: `adaptive` preset MUST assign model tiers based on agent role (planner → quality tier, executor → balanced tier, etc.) -- REQ-ADAPTIVE-02: `adaptive` MUST be selectable via `/gsd-set-profile adaptive` +- REQ-ADAPTIVE-02: `adaptive` MUST be selectable via `/gsd-config --profile adaptive` --- @@ -2531,7 +2531,7 @@ Users who run a memory / knowledge-base MCP server (for example, ExoCortex-style **Command:** `/gsd-spike [idea] [--quick]` -**Purpose:** Run 2–5 focused feasibility experiments before committing to an implementation approach. Each experiment uses Given/When/Then framing, produces executable code, and returns a VALIDATED / INVALIDATED / PARTIAL verdict. Companion `/gsd-spike-wrap-up` packages findings into a project-local skill. +**Purpose:** Run 2–5 focused feasibility experiments before committing to an implementation approach. Each experiment uses Given/When/Then framing, produces executable code, and returns a VALIDATED / INVALIDATED / PARTIAL verdict. Companion `/gsd-spike --wrap-up` packages findings into a project-local skill. **Requirements:** - REQ-SPIKE-01: Each experiment MUST produce a Given/When/Then hypothesis before any code is written @@ -2539,14 +2539,14 @@ Users who run a memory / knowledge-base MCP server (for example, ExoCortex-style - REQ-SPIKE-03: Each experiment MUST return one of: VALIDATED, INVALIDATED, or PARTIAL verdict with evidence - REQ-SPIKE-04: Results MUST be stored in `.planning/spikes/NNN-experiment-name/` with a README and MANIFEST.md - REQ-SPIKE-05: `--quick` flag skips intake conversation and uses the argument text as the experiment direction -- REQ-SPIKE-06: `/gsd-spike-wrap-up` MUST package findings into `.claude/skills/spike-findings-[project]/` +- REQ-SPIKE-06: `/gsd-spike --wrap-up` MUST package findings into `.claude/skills/spike-findings-[project]/` **Produces:** | Artifact | Description | |----------|-------------| | `.planning/spikes/NNN-name/README.md` | Hypothesis, experiment code, verdict, and evidence | | `.planning/spikes/MANIFEST.md` | Index of all spikes with verdicts | -| `.claude/skills/spike-findings-[project]/` | Packaged findings (via `/gsd-spike-wrap-up`) | +| `.claude/skills/spike-findings-[project]/` | Packaged findings (via `/gsd-spike --wrap-up`) | --- @@ -2554,7 +2554,7 @@ Users who run a memory / knowledge-base MCP server (for example, ExoCortex-style **Command:** `/gsd-sketch [idea] [--quick] [--text]` -**Purpose:** Explore design directions through throwaway HTML mockups before committing to implementation. Produces 2–3 interactive variants per design question, all viewable directly in a browser with no build step. Companion `/gsd-sketch-wrap-up` packages winning decisions into a project-local skill. +**Purpose:** Explore design directions through throwaway HTML mockups before committing to implementation. Produces 2–3 interactive variants per design question, all viewable directly in a browser with no build step. Companion `/gsd-sketch --wrap-up` packages winning decisions into a project-local skill. **Requirements:** - REQ-SKETCH-01: Each sketch MUST answer one specific visual design question @@ -2564,7 +2564,7 @@ Users who run a memory / knowledge-base MCP server (for example, ExoCortex-style - REQ-SKETCH-05: A shared `themes/default.css` MUST provide CSS variables adapted to the agreed aesthetic - REQ-SKETCH-06: `--quick` flag skips mood intake; `--text` flag replaces `AskUserQuestion` with numbered lists for non-Claude runtimes - REQ-SKETCH-07: The winning variant MUST be marked in the README frontmatter and with a ★ in the HTML tab -- REQ-SKETCH-08: `/gsd-sketch-wrap-up` MUST package winning decisions into `.claude/skills/sketch-findings-[project]/` +- REQ-SKETCH-08: `/gsd-sketch --wrap-up` MUST package winning decisions into `.claude/skills/sketch-findings-[project]/` **Produces:** | Artifact | Description | @@ -2573,7 +2573,7 @@ Users who run a memory / knowledge-base MCP server (for example, ExoCortex-style | `.planning/sketches/NNN-name/README.md` | Design question, variants, winner, what to look for | | `.planning/sketches/themes/default.css` | Shared CSS theme variables | | `.planning/sketches/MANIFEST.md` | Index of all sketches with winners | -| `.claude/skills/sketch-findings-[project]/` | Packaged decisions (via `/gsd-sketch-wrap-up`) | +| `.claude/skills/sketch-findings-[project]/` | Packaged decisions (via `/gsd-sketch --wrap-up`) | --- diff --git a/docs/INVENTORY.md b/docs/INVENTORY.md index 0cb3c6ad6..e13bacaeb 100644 --- a/docs/INVENTORY.md +++ b/docs/INVENTORY.md @@ -172,7 +172,7 @@ Full roster at `get-shit-done/workflows/*.md`. Workflows are thin orchestrators | `add-tests.md` | Generate unit and E2E tests for a completed phase based on its artifacts. | `/gsd-add-tests` | | `add-todo.md` | Capture an idea or task that surfaces during a session as a structured todo. | `/gsd-capture` (default), `/gsd-capture --backlog` | | `ai-integration-phase.md` | Orchestrate framework selection → AI research → domain research → eval planning into AI-SPEC.md. | `/gsd-ai-integration-phase` | -| `analyze-dependencies.md` | Analyze ROADMAP.md phases for file overlap and semantic dependencies; suggest `Depends on` edges. | `/gsd-analyze-dependencies` | +| `analyze-dependencies.md` | Analyze ROADMAP.md phases for file overlap and semantic dependencies; suggest `Depends on` edges. | `/gsd-manager --analyze-deps` | | `audit-fix.md` | Autonomous audit-to-fix pipeline — run audit, parse, classify, fix, test, commit. | `/gsd-audit-fix` | | `audit-milestone.md` | Verify milestone met its definition of done by aggregating phase verifications. | `/gsd-audit-milestone` | | `audit-uat.md` | Cross-phase audit of UAT and verification files; produces prioritized outstanding-items list. | `/gsd-audit-uat` | @@ -204,7 +204,7 @@ Full roster at `get-shit-done/workflows/*.md`. Workflows are thin orchestrators | `inbox.md` | Triage open GitHub issues and PRs against project contribution templates. | `/gsd-inbox` | | `ingest-docs.md` | Scan a repo for mixed planning docs; classify, synthesize, and bootstrap or merge into `.planning/` with a conflicts report. | `/gsd-ingest-docs` | | `insert-phase.md` | Insert a decimal phase for urgent work discovered mid-milestone. | `/gsd-phase --insert` | -| `list-phase-assumptions.md` | Surface Claude's assumptions about a phase before planning. | `/gsd-list-phase-assumptions` | +| `list-phase-assumptions.md` | Surface Claude's assumptions about a phase before planning. | `/gsd-discuss-phase --assumptions` | | `list-workspaces.md` | List all GSD workspaces found in `~/gsd-workspaces/` with their status. | `/gsd-workspace --list` | | `manager.md` | Interactive milestone command center — dashboard, inline discuss, background plan/execute. | `/gsd-manager` | | `map-codebase.md` | Orchestrate parallel codebase mapper agents to produce `.planning/codebase/` docs. | `/gsd-map-codebase` | @@ -230,7 +230,7 @@ Full roster at `get-shit-done/workflows/*.md`. Workflows are thin orchestrators | `review.md` | Cross-AI plan review via external CLIs; produces REVIEWS.md. | `/gsd-review` | | `scan.md` | Rapid single-focus codebase scan — lightweight alternative to map-codebase. | `/gsd-scan` | | `secure-phase.md` | Retroactive threat-mitigation audit for a completed phase. | `/gsd-secure-phase` | -| `session-report.md` | Session report — token usage, work summary, outcomes. | `/gsd-session-report` | +| `session-report.md` | Session report — token usage, work summary, outcomes. | `/gsd-pause-work --report` | | `settings.md` | Configure GSD workflow toggles and model profile. | `/gsd-settings`, `/gsd-config --profile` | | `settings-advanced.md` | Configure GSD power-user knobs — plan bounce, timeouts, branch templates, cross-AI execution, runtime knobs. | `/gsd-config --advanced` | | `settings-integrations.md` | Configure third-party API keys (Brave/Firecrawl/Exa), `review.models.` CLI routing, and `agent_skills.` injection with masked (`****`) display. | `/gsd-config --integrations` | diff --git a/docs/USER-GUIDE.md b/docs/USER-GUIDE.md index 0c91a21ac..05516788a 100644 --- a/docs/USER-GUIDE.md +++ b/docs/USER-GUIDE.md @@ -874,7 +874,7 @@ claude --dangerously-skip-permissions ... /gsd-audit-milestone # Check everything shipped /gsd-complete-milestone # Archive, tag, done -/gsd-session-report # Generate session summary +/gsd-pause-work --report # Generate session summary ``` ### New Project from Existing Document @@ -1020,7 +1020,7 @@ Clear your context window between major commands: `/clear` in Claude Code. GSD i ### Plans Seem Wrong or Misaligned -Run `/gsd-discuss-phase [N]` before planning. Most plan quality issues come from Claude making assumptions that `CONTEXT.md` would have prevented. You can also run `/gsd-list-phase-assumptions [N]` to see what Claude intends to do before committing to a plan. +Run `/gsd-discuss-phase [N]` before planning. Most plan quality issues come from Claude making assumptions that `CONTEXT.md` would have prevented. You can also run `/gsd-discuss-phase --assumptions [N]` to see what Claude intends to do before committing to a plan. ### Discuss-Phase Uses Technical Jargon I Don't Understand @@ -1393,7 +1393,7 @@ If the installer crashes with `EPERM: operation not permitted, scandir` on Windo | Plan doesn't match your vision | `/gsd-discuss-phase [N]` then re-plan | | Costs running high | `/gsd-config --profile budget` and `/gsd-settings` to toggle agents off | | Update broke local changes | `/gsd-update --reapply` | -| Want session summary for stakeholder | `/gsd-session-report` | +| Want session summary for stakeholder | `/gsd-pause-work --report` | | Don't know what step is next | `/gsd-progress --next` | | Parallel execution build errors | Update GSD or set `parallelization.enabled: false` | @@ -1414,7 +1414,7 @@ For reference, here is what GSD creates in your project: MILESTONES.md # Completed milestone archive HANDOFF.json # Structured session handoff (from /gsd-pause-work) research/ # Domain research from /gsd-new-project - reports/ # Session reports (from /gsd-session-report) + reports/ # Session reports (from /gsd-pause-work --report) todos/ pending/ # Captured ideas awaiting work done/ # Completed todos diff --git a/docs/issue-driven-orchestration.md b/docs/issue-driven-orchestration.md index b01788a7c..a14592dcc 100644 --- a/docs/issue-driven-orchestration.md +++ b/docs/issue-driven-orchestration.md @@ -53,7 +53,7 @@ Symphony docs, blog posts, or third-party orchestration write-ups. | Proof-of-work / test evidence | `/gsd-verify-work` (UAT.md persisted across `/clear`) | | Adversarial review | `/gsd-review` (cross-AI peer review of plans) | | Human merge gate | `/gsd-ship` (creates PR, optional code review, prepares merge) | -| Follow-up capture | `/gsd-note`, `/gsd-plant-seed`, `/gsd-new-milestone`, or a manually opened tracker issue | +| Follow-up capture | `/gsd-note`, `/gsd-capture --seed`, `/gsd-new-milestone`, or a manually opened tracker issue | | Concurrency control | Manager / background-agent semantics (no always-on poller) | The mapping is one-way: GSD owns the safety gates (verification, human @@ -72,8 +72,8 @@ tracker issue end-to-end. Replace bracketed placeholders before running. dependencies that block execution. 2. **Map to a GSD phase.** If the issue maps onto an existing phase in `ROADMAP.md`, select it. If not, run `/gsd-new-milestone` (for a new - milestone of related issues) or open a phase via `/gsd-add-phase` / - `/gsd-insert-phase`. Capture the tracker issue URL in the phase's + milestone of related issues) or open a phase via `/gsd-phase` / + `/gsd-phase --insert`. Capture the tracker issue URL in the phase's `CONTEXT.md` so traceability survives compaction. 3. **Create an isolated workspace.** Run `/gsd-workspace --new --strategy worktree ` to spin up a git @@ -98,7 +98,7 @@ tracker issue end-to-end. Replace bracketed placeholders before running. rich body assembled from the planning artifacts. Both gates require a human decision before anything reaches the remote. 7. **Capture follow-up work explicitly.** Use `/gsd-note` for inline - notes, `/gsd-plant-seed` for ideas worth a future phase, or + notes, `/gsd-capture --seed` for ideas worth a future phase, or `/gsd-new-milestone` for a coherent group of follow-ups. Creating a tracker issue from a discovered follow-up requires explicit user confirmation — GSD does not post to remote trackers automatically. @@ -165,7 +165,7 @@ approved-enhancement could later add a *minimal* tracker bridge: - Importing one GitHub or Linear issue into a GSD workspace / phase. - Exporting `UAT.md` evidence as a comment on the source issue. -- Generating follow-up tracker issues from `/gsd-plant-seed` output. +- Generating follow-up tracker issues from `/gsd-capture --seed` output. Each of those would be its own enhancement proposal because each adds integration surface and ongoing maintenance burden. They are out of diff --git a/docs/ja-JP/COMMANDS.md b/docs/ja-JP/COMMANDS.md index ffb378ced..6b4bba568 100644 --- a/docs/ja-JP/COMMANDS.md +++ b/docs/ja-JP/COMMANDS.md @@ -217,7 +217,7 @@ --- -### `/gsd-session-report` +### `/gsd-pause-work --report` 作業サマリー、成果、推定リソース使用量を含むセッションレポートを生成します。 @@ -225,7 +225,7 @@ **生成物:** `.planning/reports/SESSION_REPORT.md` ```bash -/gsd-session-report # セッション後のサマリーを生成 +/gsd-pause-work --report # セッション後のサマリーを生成 ``` **レポートに含まれる内容:** @@ -400,7 +400,7 @@ /gsd-phase --remove 7 # フェーズ7を削除、8→7、9→8等に番号振り直し ``` -### `/gsd-list-phase-assumptions` +### `/gsd-discuss-phase --assumptions` 計画前にClaudeの意図するアプローチをプレビューします。 @@ -409,7 +409,7 @@ | `N` | いいえ | フェーズ番号 | ```bash -/gsd-list-phase-assumptions 2 # フェーズ2の前提を確認 +/gsd-discuss-phase --assumptions 2 # フェーズ2の前提を確認 ``` @@ -482,7 +482,7 @@ --- -### `/gsd-analyze-dependencies` +### `/gsd-manager --analyze-deps` フェーズ依存関係を検出し、ROADMAP.md に `Depends on` エントリを提案します。(v1.32) @@ -491,7 +491,7 @@ **動作:** 依存関係提案テーブルを表示し、ユーザー確認後に ROADMAP.md の `Depends on` フィールドを更新します。 ```bash -/gsd-analyze-dependencies # 依存関係の分析と提案 +/gsd-manager --analyze-deps # 依存関係の分析と提案 ``` --- @@ -948,10 +948,10 @@ GSDアップデート後にローカルの変更を復元します。 ## コミュニティコマンド -### `/gsd-join-discord` +### `/gsd-help` Discordコミュニティの招待を開きます。 ```bash -/gsd-join-discord +/gsd-help ``` diff --git a/docs/ja-JP/FEATURES.md b/docs/ja-JP/FEATURES.md index 7bc9e0dfc..0506b304d 100644 --- a/docs/ja-JP/FEATURES.md +++ b/docs/ja-JP/FEATURES.md @@ -641,7 +641,7 @@ ### 24. セッションレポート -**コマンド:** `/gsd-session-report` +**コマンド:** `/gsd-pause-work --report` **目的:** 実施した作業、達成した成果、推定リソース使用量をキャプチャした、構造化されたセッション後のサマリードキュメントを生成します。 @@ -1725,7 +1725,7 @@ Claude が GSD ワークフローコンテキスト外でファイル編集を ### 77. フェーズ依存関係分析 -**コマンド:** `/gsd-analyze-dependencies` +**コマンド:** `/gsd-manager --analyze-deps` **目的:** フェーズ依存関係を検出し、`/gsd-manager` 実行前に ROADMAP.md への `Depends on` エントリを提案します。 diff --git a/docs/ja-JP/USER-GUIDE.md b/docs/ja-JP/USER-GUIDE.md index b16f0e679..88ecfd57a 100644 --- a/docs/ja-JP/USER-GUIDE.md +++ b/docs/ja-JP/USER-GUIDE.md @@ -404,10 +404,10 @@ GSD はマークダウンファイルを生成し、それが LLM のシステ | `/gsd-progress` | 状態と次のステップを表示 | いつでも -- 「今どこにいる?」 | | `/gsd-resume-work` | 前回のセッションからフルコンテキストを復元 | 新しいセッションの開始時 | | `/gsd-pause-work` | 構造化されたハンドオフを保存(HANDOFF.json + continue-here.md) | フェーズの途中で作業を中断する時 | -| `/gsd-session-report` | 作業内容と成果を含むセッションサマリーを生成 | セッション終了時、ステークホルダーへの共有時 | +| `/gsd-pause-work --report` | 作業内容と成果を含むセッションサマリーを生成 | セッション終了時、ステークホルダーへの共有時 | | `/gsd-help` | すべてのコマンドを表示 | クイックリファレンス | | `/gsd-update` | 変更履歴プレビュー付きで GSD を更新 | 新バージョンの確認時 | -| `/gsd-join-discord` | Discord コミュニティの招待リンクを開く | 質問やコミュニティ参加時 | +| `/gsd-help` | Discord コミュニティの招待リンクを開く | 質問やコミュニティ参加時 | ### フェーズ管理 @@ -416,7 +416,7 @@ GSD はマークダウンファイルを生成し、それが LLM のシステ | `/gsd-phase` | ロードマップに新しいフェーズを追加 | 初期プランニング後にスコープが拡大した場合 | | `/gsd-phase --insert [N]` | 緊急作業を挿入(小数番号) | マイルストーン中の緊急修正 | | `/gsd-phase --remove [N]` | 将来のフェーズを削除して番号を振り直す | 機能のスコープ縮小 | -| `/gsd-list-phase-assumptions [N]` | Claude の意図するアプローチをプレビュー | プランニング前に方向性を確認 | +| `/gsd-discuss-phase --assumptions [N]` | Claude の意図するアプローチをプレビュー | プランニング前に方向性を確認 | | `/gsd-plan-phase --research-phase [N]` | エコシステムの深いリサーチのみ | 複雑または不慣れなドメイン | ### ブラウンフィールドとユーティリティ @@ -603,7 +603,7 @@ claude --dangerously-skip-permissions ... /gsd-audit-milestone # すべて出荷されたか確認 /gsd-complete-milestone # アーカイブ、タグ付け、完了 -/gsd-session-report # セッションサマリーを生成 +/gsd-pause-work --report # セッションサマリーを生成 ``` ### 既存ドキュメントからの新規プロジェクト @@ -703,7 +703,7 @@ cd ~/gsd-workspaces/feature-b ### プランが誤っている、または方向性がずれている -プランニング前に `/gsd-discuss-phase [N]` を実行してください。プランの品質問題のほとんどは、CONTEXT.md があれば防げたはずの前提を Claude が置いてしまうことに起因します。`/gsd-list-phase-assumptions [N]` を使用して、プランにコミットする前に Claude の意図を確認することもできます。 +プランニング前に `/gsd-discuss-phase [N]` を実行してください。プランの品質問題のほとんどは、CONTEXT.md があれば防げたはずの前提を Claude が置いてしまうことに起因します。`/gsd-discuss-phase --assumptions [N]` を使用して、プランにコミットする前に Claude の意図を確認することもできます。 ### 実行が失敗する、またはスタブが生成される @@ -799,7 +799,7 @@ Windows でインストーラーが `EPERM: operation not permitted, scandir` | プランがビジョンに合わない | `/gsd-discuss-phase [N]` で再プランニング | | コストが高い | `/gsd-config --profile budget` と `/gsd-settings` でエージェントをオフ | | アップデートがローカル変更を壊した | `/gsd-update --reapply` | -| ステークホルダー向けセッションサマリーが欲しい | `/gsd-session-report` | +| ステークホルダー向けセッションサマリーが欲しい | `/gsd-pause-work --report` | | 次のステップがわからない | `/gsd-progress --next` | | 並列実行でビルドエラー | GSD を更新するか `parallelization.enabled: false` を設定 | @@ -819,7 +819,7 @@ Windows でインストーラーが `EPERM: operation not permitted, scandir` MILESTONES.md # 完了したマイルストーンのアーカイブ HANDOFF.json # 構造化セッション引き継ぎ(/gsd-pause-work から) research/ # /gsd-new-project からのドメインリサーチ - reports/ # セッションレポート(/gsd-session-report から) + reports/ # セッションレポート(/gsd-pause-work --report から) todos/ pending/ # 作業待ちのキャプチャされたアイデア done/ # 完了した TODO diff --git a/docs/ko-KR/COMMANDS.md b/docs/ko-KR/COMMANDS.md index b53e178a6..9a5cb94c6 100644 --- a/docs/ko-KR/COMMANDS.md +++ b/docs/ko-KR/COMMANDS.md @@ -217,7 +217,7 @@ --- -### `/gsd-session-report` +### `/gsd-pause-work --report` 작업 요약, 결과, 예상 리소스 사용량을 포함한 세션 보고서를 생성합니다. @@ -225,7 +225,7 @@ **생성 파일:** `.planning/reports/SESSION_REPORT.md` ```bash -/gsd-session-report # 세션 종료 후 요약 생성 +/gsd-pause-work --report # 세션 종료 후 요약 생성 ``` **보고서 포함 내용.** @@ -400,7 +400,7 @@ /gsd-phase --remove 7 # 페이즈 7 제거, 8→7, 9→8 등으로 재번호 ``` -### `/gsd-list-phase-assumptions` +### `/gsd-discuss-phase --assumptions` 계획 수립 전 Claude의 예상 접근 방식을 미리 확인합니다. @@ -409,7 +409,7 @@ | `N` | 아니오 | 페이즈 번호 | ```bash -/gsd-list-phase-assumptions 2 # 페이즈 2 가정 사항 확인 +/gsd-discuss-phase --assumptions 2 # 페이즈 2 가정 사항 확인 ``` @@ -482,7 +482,7 @@ Nyquist 검증 갭을 소급하여 감사하고 보완합니다. --- -### `/gsd-analyze-dependencies` +### `/gsd-manager --analyze-deps` 페이즈 의존성을 감지하고 ROADMAP.md에 `Depends on` 항목을 제안합니다. (v1.32) @@ -491,7 +491,7 @@ Nyquist 검증 갭을 소급하여 감사하고 보완합니다. **동작 방식:** 의존성 제안 테이블을 표시하고 사용자 확인 후 ROADMAP.md의 `Depends on` 필드를 업데이트합니다. ```bash -/gsd-analyze-dependencies # 의존성 분석 및 제안 +/gsd-manager --analyze-deps # 의존성 분석 및 제안 ``` --- @@ -948,10 +948,10 @@ GSD 업데이트 후 로컬 수정사항을 복원합니다. ## 커뮤니티 명령어 -### `/gsd-join-discord` +### `/gsd-help` Discord 커뮤니티 초대 링크를 엽니다. ```bash -/gsd-join-discord +/gsd-help ``` diff --git a/docs/ko-KR/FEATURES.md b/docs/ko-KR/FEATURES.md index 17eedf672..2c4d2b4b5 100644 --- a/docs/ko-KR/FEATURES.md +++ b/docs/ko-KR/FEATURES.md @@ -641,7 +641,7 @@ ### 24. Session Reporting -**명령어:** `/gsd-session-report` +**명령어:** `/gsd-pause-work --report` **목적:** 수행된 작업, 달성된 결과, 예상 리소스 사용량을 캡처하는 구조화된 세션 후 요약 문서를 생성합니다. @@ -1725,7 +1725,7 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하 ### 77. 페이즈 의존성 분석 -**명령어:** `/gsd-analyze-dependencies` +**명령어:** `/gsd-manager --analyze-deps` **목적:** 페이즈 의존성을 감지하고 `/gsd-manager` 실행 전 ROADMAP.md에 `Depends on` 항목을 제안합니다. diff --git a/docs/ko-KR/USER-GUIDE.md b/docs/ko-KR/USER-GUIDE.md index 99efd9bbf..796fe6898 100644 --- a/docs/ko-KR/USER-GUIDE.md +++ b/docs/ko-KR/USER-GUIDE.md @@ -404,10 +404,10 @@ GSD는 LLM 시스템 프롬프트가 되는 마크다운 파일을 생성합니 | `/gsd-progress` | 상태 및 다음 단계 표시 | 언제든 -- "지금 어디 있나?" | | `/gsd-resume-work` | 마지막 세션의 전체 컨텍스트 복원 | 새 세션 시작 시 | | `/gsd-pause-work` | 구조화된 핸드오프 저장 (HANDOFF.json + continue-here.md) | 페이즈 중간에 중단할 때 | -| `/gsd-session-report` | 작업 및 결과가 포함된 세션 요약 생성 | 세션 종료 시, 이해관계자 공유 시 | +| `/gsd-pause-work --report` | 작업 및 결과가 포함된 세션 요약 생성 | 세션 종료 시, 이해관계자 공유 시 | | `/gsd-help` | 모든 명령어 표시 | 빠른 레퍼런스 | | `/gsd-update` | 변경 로그 미리보기와 함께 GSD 업데이트 | 새 버전 확인 시 | -| `/gsd-join-discord` | Discord 커뮤니티 초대 링크 열기 | 질문이나 커뮤니티 참여 시 | +| `/gsd-help` | Discord 커뮤니티 초대 링크 열기 | 질문이나 커뮤니티 참여 시 | ### 페이즈 관리 @@ -416,7 +416,7 @@ GSD는 LLM 시스템 프롬프트가 되는 마크다운 파일을 생성합니 | `/gsd-phase` | 로드맵에 새 페이즈 추가 | 초기 계획 후 범위가 늘어날 때 | | `/gsd-phase --insert [N]` | 긴급 작업 삽입 (소수점 번호 체계) | 마일스톤 중간의 긴급 수정 시 | | `/gsd-phase --remove [N]` | 미래 페이즈 제거 및 재번호 | 기능 범위 축소 시 | -| `/gsd-list-phase-assumptions [N]` | Claude의 예상 접근 방식 미리 확인 | 계획 전 방향 검증 시 | +| `/gsd-discuss-phase --assumptions [N]` | Claude의 예상 접근 방식 미리 확인 | 계획 전 방향 검증 시 | | `/gsd-plan-phase --research-phase [N]` | 심층 에코시스템 조사만 수행 | 복잡하거나 익숙하지 않은 도메인 | ### 브라운필드 및 유틸리티 @@ -603,7 +603,7 @@ claude --dangerously-skip-permissions ... /gsd-audit-milestone # Check everything shipped /gsd-complete-milestone # Archive, tag, done -/gsd-session-report # Generate session summary +/gsd-pause-work --report # Generate session summary ``` ### 기존 문서로 새 프로젝트 시작 @@ -703,7 +703,7 @@ cd ~/gsd-workspaces/feature-b ### 계획이 잘못되거나 맞지 않는 경우 -계획 전에 `/gsd-discuss-phase [N]`을 실행하세요. 대부분의 계획 품질 문제는 `CONTEXT.md`가 있었다면 방지할 수 있었던 가정을 Claude가 세우기 때문에 발생합니다. `/gsd-list-phase-assumptions [N]`을 실행하여 계획에 동의하기 전에 Claude가 무엇을 하려는지 확인할 수도 있습니다. +계획 전에 `/gsd-discuss-phase [N]`을 실행하세요. 대부분의 계획 품질 문제는 `CONTEXT.md`가 있었다면 방지할 수 있었던 가정을 Claude가 세우기 때문에 발생합니다. `/gsd-discuss-phase --assumptions [N]`을 실행하여 계획에 동의하기 전에 Claude가 무엇을 하려는지 확인할 수도 있습니다. ### 실행이 실패하거나 스텁을 생성하는 경우 @@ -799,7 +799,7 @@ Windows에서 설치 프로그램이 `EPERM: operation not permitted, scandir` | 계획이 비전과 맞지 않음 | `/gsd-discuss-phase [N]` 후 재계획 | | 비용이 높아짐 | `/gsd-config --profile budget` 및 `/gsd-settings`에서 에이전트 비활성화 | | 업데이트가 로컬 변경사항 파괴 | `/gsd-update --reapply` | -| 이해관계자를 위한 세션 요약 필요 | `/gsd-session-report` | +| 이해관계자를 위한 세션 요약 필요 | `/gsd-pause-work --report` | | 다음 단계를 모르겠음 | `/gsd-progress --next` | | 병렬 실행 빌드 오류 | GSD 업데이트 또는 `parallelization.enabled: false` 설정 | @@ -819,7 +819,7 @@ Windows에서 설치 프로그램이 `EPERM: operation not permitted, scandir` MILESTONES.md # Completed milestone archive HANDOFF.json # Structured session handoff (from /gsd-pause-work) research/ # Domain research from /gsd-new-project - reports/ # Session reports (from /gsd-session-report) + reports/ # Session reports (from /gsd-pause-work --report) todos/ pending/ # Captured ideas awaiting work done/ # Completed todos diff --git a/docs/pt-BR/COMMANDS.md b/docs/pt-BR/COMMANDS.md index 62065f076..543e798a2 100644 --- a/docs/pt-BR/COMMANDS.md +++ b/docs/pt-BR/COMMANDS.md @@ -26,7 +26,7 @@ Para detalhes completos de flags avançadas e mudanças recentes, consulte tamb | `/gsd-progress` | Mostra status atual e próximos passos | | `/gsd-resume-work` | Retoma contexto da sessão anterior | | `/gsd-pause-work` | Salva handoff estruturado | -| `/gsd-session-report` | Gera resumo da sessão | +| `/gsd-pause-work --report` | Gera resumo da sessão | | `/gsd-autonomous` | Executa todas as fases restantes de forma autônoma (`--from N`, `--to N`, `--only N`) | | `/gsd-help` | Lista comandos e uso | | `/gsd-update` | Atualiza o GSD | @@ -38,7 +38,7 @@ Para detalhes completos de flags avançadas e mudanças recentes, consulte tamb | `/gsd-phase` | Adiciona fase no roadmap | | `/gsd-phase --insert [N]` | Insere trabalho urgente entre fases | | `/gsd-phase --remove [N]` | Remove fase futura e reenumera | -| `/gsd-list-phase-assumptions [N]` | Mostra abordagem assumida pelo Claude | +| `/gsd-discuss-phase --assumptions [N]` | Mostra abordagem assumida pelo Claude | ## Brownfield e Utilidades @@ -47,7 +47,7 @@ Para detalhes completos de flags avançadas e mudanças recentes, consulte tamb | `/gsd-map-codebase` | Mapeia base existente antes de novo projeto | | `/gsd-quick` | Tarefas ad-hoc com garantias do GSD | | `/gsd-debug [desc]` | Debug sistemático com estado persistente (`--diagnose` para modo diagnóstico) | -| `/gsd-analyze-dependencies` | Detecta dependências entre fases e sugere `Depends on` no ROADMAP.md (v1.32) | +| `/gsd-manager --analyze-deps` | Detecta dependências entre fases e sugere `Depends on` no ROADMAP.md (v1.32) | | `/gsd-forensics` | Diagnóstico de falhas no workflow | | `/gsd-settings` | Configuração de agentes, perfil e toggles | | `/gsd-config --profile ` | Troca rápida de perfil de modelo | diff --git a/docs/pt-BR/FEATURES.md b/docs/pt-BR/FEATURES.md index 26665716a..186d504a8 100644 --- a/docs/pt-BR/FEATURES.md +++ b/docs/pt-BR/FEATURES.md @@ -37,7 +37,7 @@ Para catálogo completo e detalhamento exaustivo, consulte [FEATURES.md em ingl - **Perfis de modelo** (`quality`, `balanced`, `budget`, `inherit`) - **Ajuste por toggles** para custo/qualidade/velocidade - **Diagnóstico forense** com `/gsd-forensics` -- **Relatório de sessão** com `/gsd-session-report` +- **Relatório de sessão** com `/gsd-pause-work --report` ## Novidades v1.31--v1.32 @@ -55,7 +55,7 @@ Para catálogo completo e detalhamento exaustivo, consulte [FEATURES.md em ingl - **Context reduction** — truncamento de markdown e ordenação cache-friendly (v1.32) - **`--power` flag** — respostas em batch via arquivo para discuss-phase (v1.32) - **`--diagnose` flag** — modo diagnóstico sem modificações no `/gsd-debug` (v1.32) -- **`/gsd-analyze-dependencies`** — detecta dependências entre fases (v1.32) +- **`/gsd-manager --analyze-deps`** — detecta dependências entre fases (v1.32) - **Response language config** — `response_language` para saída consistente em idioma (v1.32) - **Novos runtimes** — Trae IDE, Cline, Augment Code (v1.32) - **Manual update** — procedimento de atualização sem npm (v1.32) diff --git a/docs/pt-BR/USER-GUIDE.md b/docs/pt-BR/USER-GUIDE.md index 86c410d3d..e69be8ce0 100644 --- a/docs/pt-BR/USER-GUIDE.md +++ b/docs/pt-BR/USER-GUIDE.md @@ -171,7 +171,7 @@ Para arquivos sensíveis, use deny list no Claude Code. | `/gsd-progress` | Ver status atual | | `/gsd-resume-work` | Retomar sessão | | `/gsd-pause-work` | Pausar com handoff | -| `/gsd-session-report` | Resumo da sessão | +| `/gsd-pause-work --report` | Resumo da sessão | | `/gsd-quick` | Tarefa ad-hoc com garantias GSD | | `/gsd-debug [desc]` | Debug sistemático | | `/gsd-forensics` | Diagnóstico de workflow quebrado | @@ -268,7 +268,7 @@ Use `/clear` entre etapas grandes e retome com `/gsd-resume-work` ou `/gsd-progr ### Plano desalinhado -Rode `/gsd-discuss-phase [N]` antes do plano e valide suposições com `/gsd-list-phase-assumptions [N]`. +Rode `/gsd-discuss-phase [N]` antes do plano e valide suposições com `/gsd-discuss-phase --assumptions [N]`. ### Execução falhou ou saiu com stubs diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.md index 20f7472af..d82ea1281 100644 --- a/docs/zh-CN/README.md +++ b/docs/zh-CN/README.md @@ -499,7 +499,7 @@ lmn012o feat(08-02): 创建注册端点 | `/gsd-progress` | 我在哪?接下来做什么? | | `/gsd-help` | 显示所有命令和使用指南 | | `/gsd-update` | 更新 GSD 并预览变更日志 | -| `/gsd-join-discord` | 加入 GSD Discord 社区 | +| `/gsd-help` | 加入 GSD Discord 社区 | ### 现有代码库 @@ -514,9 +514,9 @@ lmn012o feat(08-02): 创建注册端点 | `/gsd-phase` | 向路线图追加阶段 | | `/gsd-phase --insert [N]` | 在阶段之间插入紧急工作 | | `/gsd-phase --remove [N]` | 删除未来阶段,重新编号 | -| `/gsd-list-phase-assumptions [N]` | 规划前查看 Claude 的预期方法 | +| `/gsd-discuss-phase --assumptions [N]` | 规划前查看 Claude 的预期方法 | | `/gsd-autonomous [--from N] [--to N] [--only N]` | 自主执行所有剩余阶段(`--to N` 执行到阶段 N 停止,`--only N` 只执行单个阶段) | -| `/gsd-analyze-dependencies` | 检测阶段间依赖关系并建议 ROADMAP.md 的 `Depends on` 条目 | +| `/gsd-manager --analyze-deps` | 检测阶段间依赖关系并建议 ROADMAP.md 的 `Depends on` 条目 | ### 会话 diff --git a/docs/zh-CN/USER-GUIDE.md b/docs/zh-CN/USER-GUIDE.md index 57a064a73..5c38792f1 100644 --- a/docs/zh-CN/USER-GUIDE.md +++ b/docs/zh-CN/USER-GUIDE.md @@ -199,7 +199,7 @@ | `/gsd-pause-work` | 保存上下文交接 | 阶段中途停止 | | `/gsd-help` | 显示所有命令 | 快速参考 | | `/gsd-update` | 更新 GSD 并预览变更日志 | 检查新版本 | -| `/gsd-join-discord` | 打开 Discord 社区邀请 | 问题或社区 | +| `/gsd-help` | 打开 Discord 社区邀请 | 问题或社区 | ### 阶段管理 @@ -208,10 +208,10 @@ | `/gsd-phase` | 向路线图追加新阶段 | 初始规划后范围增长 | | `/gsd-phase --insert [N]` | 插入紧急工作(小数编号) | 里程碑中途紧急修复 | | `/gsd-phase --remove [N]` | 删除未来阶段并重新编号 | 移除某个功能 | -| `/gsd-list-phase-assumptions [N]` | 预览 Claude 的预期方法 | 规划前,验证方向 | +| `/gsd-discuss-phase --assumptions [N]` | 预览 Claude 的预期方法 | 规划前,验证方向 | | `/gsd-plan-phase --research-phase [N]` | 仅深度生态研究 | 复杂或不熟悉的领域 | | `/gsd-autonomous [--from N] [--to N] [--only N]` | 自主执行剩余阶段(`--to N` 到阶段 N 停止) | 批量自动处理 | -| `/gsd-analyze-dependencies` | 检测阶段间依赖关系 | `/gsd-manager` 前分析 | +| `/gsd-manager --analyze-deps` | 检测阶段间依赖关系 | `/gsd-manager` 前分析 | ### 状态管理 @@ -424,7 +424,7 @@ claude --dangerously-skip-permissions ### 计划看起来错误或不一致 -在规划前运行 `/gsd-discuss-phase [N]`。大多数计划质量问题来自 Claude 做出了 `CONTEXT.md` 本可以防止的假设。你也可以运行 `/gsd-list-phase-assumptions [N]` 在提交计划前查看 Claude 打算做什么。 +在规划前运行 `/gsd-discuss-phase [N]`。大多数计划质量问题来自 Claude 做出了 `CONTEXT.md` 本可以防止的假设。你也可以运行 `/gsd-discuss-phase --assumptions [N]` 在提交计划前查看 Claude 打算做什么。 ### 执行失败或产生存根 diff --git a/docs/zh-CN/references/continuation-format.md b/docs/zh-CN/references/continuation-format.md index 06ff48325..cccb3b291 100644 --- a/docs/zh-CN/references/continuation-format.md +++ b/docs/zh-CN/references/continuation-format.md @@ -52,7 +52,7 @@ **也可选:** - 执行前审查计划 -- `/gsd-list-phase-assumptions 2` — 检查假设 +- `/gsd-discuss-phase --assumptions 2` — 检查假设 --- ```