From b2f4aa94356dc4859946f508965a2fa8e40bc93b Mon Sep 17 00:00:00 2001 From: Tom Boucher Date: Sat, 18 Jul 2026 23:11:15 -0400 Subject: [PATCH] docs(#2420): clean stale get-shit-done/ path refs in translated docs (#2421) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit After the package/repo rename in #604, the English docs were updated to use gsd-core/... paths, but the four translated doc trees (ja-JP, zh-CN, ko-KR, pt-BR) and .changeset/README.md were never updated and still referenced the pre-rename get-shit-done/ runtime directory, which no longer exists. This commit brings the translations in line with the English docs: - docs/{ja-JP,zh-CN,ko-KR,pt-BR}/**/*.md (57 files): get-shit-done/ -> gsd-core/ (path references) #references-get-shit-donereferencesmd -> #references-gsd-corereferencesmd (anchor in INVENTORY -> ARCHITECTURE links) - .changeset/README.md:9 issue URL: open-gsd/get-shit-done-redux -> open-gsd/gsd-core Legacy references intentionally preserved (historical record): - CHANGELOG.md, .changeset/archived/*, docs/RELEASE-NOTES-LEGACY.md - docs/cleanup-get-shit-done-cc.md, docs/adr/*, docs/research/* - docs/{ja-JP,ko-KR}/superpowers/plans/2026-03-18-* (developer's local paths) - docs/{INVENTORY,README,FEATURES,installer-migrations}.md (rename-history descriptions, some tagged ) - Code/tests implementing or testing legacy-cleanup logic (bin/install.js, gsd-core/bin/lib/legacy-cleanup.cjs, scripts/lint-legacy-dir-name.cjs, migration sources/tests) No source code changes — documentation only. Fixes #2420 --- .changeset/README.md | 2 +- docs/ja-JP/ARCHITECTURE.md | 20 +++++++++---------- docs/ja-JP/CLI-TOOLS.md | 8 ++++---- docs/ja-JP/COMMANDS.md | 2 +- docs/ja-JP/FEATURES.md | 4 ++-- docs/ja-JP/INVENTORY.md | 10 +++++----- docs/ja-JP/USER-GUIDE.md | 10 +++++----- docs/ja-JP/explanation/context-engineering.md | 2 +- .../explanation/multi-agent-orchestration.md | 2 +- docs/ja-JP/explanation/security-model.md | 2 +- docs/ja-JP/how-to/recover-and-troubleshoot.md | 6 +++--- docs/ja-JP/reference/context-md.md | 2 +- docs/ja-JP/reference/plan-md.md | 4 ++-- docs/ja-JP/reference/state-md.md | 6 +++--- ...6-03-20-multi-project-workspaces-design.md | 10 +++++----- docs/ko-KR/ARCHITECTURE.md | 20 +++++++++---------- docs/ko-KR/CLI-TOOLS.md | 8 ++++---- docs/ko-KR/COMMANDS.md | 2 +- docs/ko-KR/INVENTORY.md | 10 +++++----- docs/ko-KR/USER-GUIDE.md | 10 +++++----- docs/ko-KR/explanation/context-engineering.md | 2 +- .../explanation/multi-agent-orchestration.md | 2 +- docs/ko-KR/explanation/security-model.md | 2 +- docs/ko-KR/how-to/recover-and-troubleshoot.md | 6 +++--- docs/ko-KR/reference/context-md.md | 2 +- docs/ko-KR/reference/plan-md.md | 4 ++-- docs/ko-KR/reference/state-md.md | 6 +++--- ...6-03-20-multi-project-workspaces-design.md | 10 +++++----- docs/pt-BR/ARCHITECTURE.md | 20 +++++++++---------- docs/pt-BR/CLI-TOOLS.md | 8 ++++---- docs/pt-BR/COMMANDS.md | 2 +- docs/pt-BR/CONFIGURATION.md | 8 ++++---- docs/pt-BR/INVENTORY.md | 10 +++++----- docs/pt-BR/USER-GUIDE.md | 10 +++++----- docs/pt-BR/explanation/context-engineering.md | 2 +- .../explanation/multi-agent-orchestration.md | 2 +- docs/pt-BR/explanation/security-model.md | 2 +- docs/pt-BR/how-to/recover-and-troubleshoot.md | 6 +++--- docs/pt-BR/reference/context-md.md | 2 +- docs/pt-BR/reference/plan-md.md | 4 ++-- docs/pt-BR/reference/state-md.md | 6 +++--- docs/zh-CN/ARCHITECTURE.md | 20 +++++++++---------- docs/zh-CN/CLI-TOOLS.md | 8 ++++---- docs/zh-CN/COMMANDS.md | 2 +- docs/zh-CN/CONFIGURATION.md | 8 ++++---- docs/zh-CN/FEATURES.md | 4 ++-- docs/zh-CN/INVENTORY.md | 10 +++++----- docs/zh-CN/USER-GUIDE.md | 10 +++++----- docs/zh-CN/explanation/context-engineering.md | 2 +- .../explanation/multi-agent-orchestration.md | 2 +- docs/zh-CN/explanation/security-model.md | 2 +- docs/zh-CN/how-to/recover-and-troubleshoot.md | 6 +++--- docs/zh-CN/reference/context-md.md | 2 +- docs/zh-CN/reference/plan-md.md | 4 ++-- docs/zh-CN/reference/state-md.md | 6 +++--- .../references/model-profile-resolution.md | 2 +- .../references/phase-argument-parsing.md | 6 +++--- .../zh-CN/references/verification-patterns.md | 2 +- 58 files changed, 176 insertions(+), 176 deletions(-) diff --git a/.changeset/README.md b/.changeset/README.md index 94310153f..5c4fb54cd 100644 --- a/.changeset/README.md +++ b/.changeset/README.md @@ -6,7 +6,7 @@ This directory holds **per-PR CHANGELOG fragments**. Every PR with user-facing c Two PRs that both edit the `### Fixed` block of `CHANGELOG.md` always conflict on merge — git can't pick a serialization order without human input. Two PRs that each add a fresh `.changeset/.md` never conflict because they don't share lines. -See [#2975](https://github.com/open-gsd/get-shit-done-redux/issues/2975) for the full rationale. +See [#2975](https://github.com/open-gsd/gsd-core/issues/2975) for the full rationale. ## Adding a fragment diff --git a/docs/ja-JP/ARCHITECTURE.md b/docs/ja-JP/ARCHITECTURE.md index b35afae2a..08a475ef3 100644 --- a/docs/ja-JP/ARCHITECTURE.md +++ b/docs/ja-JP/ARCHITECTURE.md @@ -42,7 +42,7 @@ GSD Core は、ユーザーと AI コーディングエージェント（Claude │ ┌─────────────────────▼────────────────────────────────┐ │ WORKFLOW LAYER │ -│ get-shit-done/workflows/*.md — Orchestration logic │ +│ gsd-core/workflows/*.md — Orchestration logic │ │ (Reads references, spawns agents, manages state) │ └──────┬──────────────┬─────────────────┬──────────────┘ │ │ │ @@ -54,7 +54,7 @@ GSD Core は、ユーザーと AI コーディングエージェント（Claude │ │ │ ┌──────▼──────────────▼─────────────────▼──────────────┐ │ CLI TOOLS LAYER │ -│ get-shit-done/bin/gsd-tools.cjs │ +│ gsd-core/bin/gsd-tools.cjs │ │ (State, config, phase, roadmap, verify, templates) │ └──────────────────────┬───────────────────────────────┘ │ @@ -75,7 +75,7 @@ GSD Core は、ユーザーと AI コーディングエージェント（Claude ### 2. 軽量オーケストレーター -ワークフローファイル（`get-shit-done/workflows/*.md`）は重い処理を行いません。以下の役割に徹します： +ワークフローファイル（`gsd-core/workflows/*.md`）は重い処理を行いません。以下の役割に徹します： - `gsd-tools.cjs init ` でコンテキストを読み込む - 焦点を絞ったプロンプトで専門エージェントを起動する - 結果を収集し、次のステップにルーティングする @@ -125,7 +125,7 @@ eager なスキルリストのトークンコストを低く保つため、v1.40 eager なスキルリストはターンごとの 2 つの主要コストの一つです。もう一つは `.claude/settings.json` で有効化されている各 MCP サーバーが注入する MCP ツールスキーマです。重量級の MCP サーバー（ブラウザ/playwright、Mac ツール、Windows ツール）はそれぞれターンごとに 20k+ トークンかかる場合があり、多くの場合 `model_profile` のチューニングで節約できるものをはるかに上回ります。トグルは Claude Code ハーネスにあります（`.claude/settings.json` の `enabledMcpjsonServers` / `disabledMcpjsonServers`）で、GSD の懸念事項ではありません。 -### ワークフロー（`get-shit-done/workflows/*.md`） +### ワークフロー（`gsd-core/workflows/*.md`） コマンドが参照するオーケストレーションロジックです。以下を含むステップバイステップのプロセスが記述されています： @@ -158,7 +158,7 @@ eager なスキルリストはターンごとの 2 つの主要コストの一 **エージェント総数:** 33 -### リファレンス（`get-shit-done/references/*.md`） +### リファレンス（`gsd-core/references/*.md`） ワークフローとエージェントが `@-reference` で参照する共有知識ドキュメント（信頼できる数と完全なロスターについては [`docs/INVENTORY.md`](INVENTORY.md#references-41-shipped) を参照）： @@ -194,7 +194,7 @@ eager なスキルリストはターンごとの 2 つの主要コストの一 - `user-profiling.md` — ユーザー行動プロファイリングの方法論 - `thinking-partner.md` — 決定ポイントでの条件付きシンキングパートナー起動 -### テンプレート（`get-shit-done/templates/`） +### テンプレート（`gsd-core/templates/`） すべてのプランニングアーティファクト用のMarkdownテンプレートです。`gsd-tools.cjs template fill` および `scaffold` コマンドにより、事前構造化されたファイルを作成するために使用されます： - `project.md`、`requirements.md`、`roadmap.md`、`state.md` — コアプロジェクトファイル @@ -218,13 +218,13 @@ eager なスキルリストはターンごとの 2 つの主要コストの一 | `gsd-prompt-guard.js` | `PreToolUse` | `.planning/` への書き込みにプロンプトインジェクションパターンがないかスキャン（アドバイザリー） | | `gsd-workflow-guard.js` | `PreToolUse` | GSDワークフローコンテキスト外でのファイル編集を検出（アドバイザリー、`hooks.workflow_guard` によるオプトイン） | -### コマンドルーティングハブ（`get-shit-done/bin/lib/command-routing-hub.cjs`） +### コマンドルーティングハブ（`gsd-core/bin/lib/command-routing-hub.cjs`） CJS コマンドファミリールーターは `CommandRoutingHub` を通じてディスパッチします。ハブはノースロー純粋結果コントラクト（`hub.dispatch()` は内部例外をキャッチして `{ ok: false, kind, ...typedPayload }` を返す）とクローズドランタイムエラー分類（`UnknownCommand`、`InvalidArgs`、`HandlerRefusal`、`HandlerFailure`）を所有します。ルーターアダプターは薄い CLI トランスレーターのままです——ハブを構築し、`dispatch` を呼び出し、結果を `output()`/`error()` 呼び出しにマッピングします。`docs/adr/0174-retire-gsd-sdk-package-boundary.md` を参照。 -### CLI ツール（`get-shit-done/bin/`） +### CLI ツール（`gsd-core/bin/`） -`get-shit-done/bin/lib/` にドメインモジュールが分割された Node.js CLI ユーティリティ（`gsd-tools.cjs`）（信頼できるロスターについては [`docs/INVENTORY.md`](INVENTORY.md#cli-modules-33-shipped) を参照）： +`gsd-core/bin/lib/` にドメインモジュールが分割された Node.js CLI ユーティリティ（`gsd-tools.cjs`）（信頼できるロスターについては [`docs/INVENTORY.md`](INVENTORY.md#cli-modules-33-shipped) を参照）： | モジュール | 責務 | | ---------------------- | --------------------------------------------------------------------------------------------------- | @@ -428,7 +428,7 @@ UI-SPEC.md (per phase) ─────────────────── ~/.claude/ # Claude Code (global install) ├── skills/gsd-*/SKILL.md # Global skills (authoritative roster: docs/INVENTORY.md) ├── commands/gsd/*.md # Local Claude installs use slash commands instead of global skills -├── get-shit-done/ +├── gsd-core/ │ ├── bin/gsd-tools.cjs # CLI utility │ ├── bin/lib/*.cjs # Domain modules (authoritative roster: docs/INVENTORY.md) │ ├── workflows/*.md # Workflow definitions (authoritative roster: docs/INVENTORY.md) diff --git a/docs/ja-JP/CLI-TOOLS.md b/docs/ja-JP/CLI-TOOLS.md index 7f893f08b..46504c52f 100644 --- a/docs/ja-JP/CLI-TOOLS.md +++ b/docs/ja-JP/CLI-TOOLS.md @@ -1,6 +1,6 @@ # GSD CLI ツールリファレンス -> `gsd-tools` CLI（`get-shit-done/bin/gsd-tools.cjs`）のリファレンスです。スラッシュコマンドとユーザーフローについては [コマンドリファレンス](COMMANDS.md) を参照してください。[docs インデックス](README.md) に戻る。 +> `gsd-tools` CLI（`gsd-core/bin/gsd-tools.cjs`）のリファレンスです。スラッシュコマンドとユーザーフローについては [コマンドリファレンス](COMMANDS.md) を参照してください。[docs インデックス](README.md) に戻る。 --- @@ -11,8 +11,8 @@ | | | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| **配置パス** | `get-shit-done/bin/gsd-tools.cjs` | -| **実装** | `get-shit-done/bin/lib/` 配下の 20 個のドメインモジュール（ディレクトリが正式） | +| **配置パス** | `gsd-core/bin/gsd-tools.cjs` | +| **実装** | `gsd-core/bin/lib/` 配下の 20 個のドメインモジュール（ディレクトリが正式） | | **ステータス** | オーケストレーション・ワークフロー・自動化処理のための主要ランタイムコマンドサーフェス。 | @@ -488,7 +488,7 @@ node gsd-tools.cjs config-set review.models.claude "" # クリア — セッ ## シークレット処理 -`/gsd-settings` で設定された API キー（`brave_search`、`firecrawl`、`exa_search`）は `.planning/config.json` に平文で書き込まれますが、`config-set` / `config-get` のすべての出力、確認テーブル、インタラクティブプロンプトでは（`****` として）マスクされます。マスキングの実装は `get-shit-done/bin/lib/secrets.cjs` を参照してください。`config.json` ファイル自体がセキュリティ境界です — ファイルシステムのパーミッションで保護し、git には含めないようにしてください（`.planning/` はデフォルトで gitignore されます）。 +`/gsd-settings` で設定された API キー（`brave_search`、`firecrawl`、`exa_search`）は `.planning/config.json` に平文で書き込まれますが、`config-set` / `config-get` のすべての出力、確認テーブル、インタラクティブプロンプトでは（`****` として）マスクされます。マスキングの実装は `gsd-core/bin/lib/secrets.cjs` を参照してください。`config.json` ファイル自体がセキュリティ境界です — ファイルシステムのパーミッションで保護し、git には含めないようにしてください（`.planning/` はデフォルトで gitignore されます）。 --- diff --git a/docs/ja-JP/COMMANDS.md b/docs/ja-JP/COMMANDS.md index 9a2bb72f4..8a232972b 100644 --- a/docs/ja-JP/COMMANDS.md +++ b/docs/ja-JP/COMMANDS.md @@ -608,7 +608,7 @@ Nyquist 検証ギャップを事後的に監査して埋めます。 /gsd-help --brief # コンパクトなスコープ付きルックアップ — シグネチャ + 1行サマリー ``` -完全なエイリアステーブルについては `get-shit-done/workflows/help/modes/topic.md` を参照してください。不明なトピックは認識されたリストを表示します。 +完全なエイリアステーブルについては `gsd-core/workflows/help/modes/topic.md` を参照してください。不明なトピックは認識されたリストを表示します。 --- diff --git a/docs/ja-JP/FEATURES.md b/docs/ja-JP/FEATURES.md index f6f2619ad..499f8c7af 100644 --- a/docs/ja-JP/FEATURES.md +++ b/docs/ja-JP/FEATURES.md @@ -2079,7 +2079,7 @@ Claude が GSD ワークフローコンテキスト外でファイル編集を ### 92. ゲート分類法 -**参照:** `get-shit-done/references/gates.md` +**参照:** `gsd-core/references/gates.md` **エージェント:** plan-checker、verifier **目的:** すべてのワークフロー決定ポイントを構造化する 4 つの正規ゲートタイプを定義し、plan-checker と verifier エージェントが一貫したゲートロジックを適用できるようにします。 @@ -2928,7 +2928,7 @@ Source commit: abc1234 (3 commits behind HEAD) - REQ-HUMAN-VERIFY-02: 人間が必要な検証はフェーズ終了時のレビューが解決するまで保留のまま。 - REQ-HUMAN-VERIFY-03: キーのない設定は `"end-of-phase"` を使用しなければならない。 -**参照:** [チェックポイントリファレンス](../../get-shit-done/references/checkpoints.md) +**参照:** [チェックポイントリファレンス](../../gsd-core/references/checkpoints.md) --- diff --git a/docs/ja-JP/INVENTORY.md b/docs/ja-JP/INVENTORY.md index 506e18442..328f57378 100644 --- a/docs/ja-JP/INVENTORY.md +++ b/docs/ja-JP/INVENTORY.md @@ -169,7 +169,7 @@ ## ワークフロー (88 shipped) -完全な一覧は `get-shit-done/workflows/*.md` を参照してください。ワークフローはコマンドが内部で参照する薄いオーケストレーターです。ほとんどはエンドユーザーが直接読むものではありません。以下の行は各ワークフローファイルをその役割（`` ブロックから導出）と、該当する場合はそれを呼び出すコマンドにマッピングします。 +完全な一覧は `gsd-core/workflows/*.md` を参照してください。ワークフローはコマンドが内部で参照する薄いオーケストレーターです。ほとんどはエンドユーザーが直接読むものではありません。以下の行は各ワークフローファイルをその役割（`` ブロックから導出）と、該当する場合はそれを呼び出すコマンドにマッピングします。 | ワークフロー | 役割 | 呼び出し元 | |-------------|------|-----------| @@ -268,7 +268,7 @@ ## リファレンス (62 shipped) -完全な一覧は `get-shit-done/references/*.md` を参照してください。リファレンスはワークフローとエージェントが `@-reference` として参照する共有ナレッジドキュメントです。以下のグループ分けは [`docs/ARCHITECTURE.md`](../ARCHITECTURE.md#references-get-shit-donereferencesmd) に対応します — コア、ワークフロー、思考モデルクラスター、モジュラープランナー分解。 +完全な一覧は `gsd-core/references/*.md` を参照してください。リファレンスはワークフローとエージェントが `@-reference` として参照する共有ナレッジドキュメントです。以下のグループ分けは [`docs/ARCHITECTURE.md`](../ARCHITECTURE.md#references-gsd-corereferencesmd) に対応します — コア、ワークフロー、思考モデルクラスター、モジュラープランナー分解。 ### コアリファレンス @@ -363,13 +363,13 @@ | `user-story-template.md` | MVP 計画向けのユーザーストーリーフォーマット — "As a / I want to / So that" の構造化フィールド。 | | `spidr-splitting.md` | MVP モードで大きなユーザーストーリーを処理するための SPIDR 分割ルール。 | -> **サブディレクトリ:** `get-shit-done/references/few-shot-examples/` には、特定のエージェントから参照される追加のフューショット例（`plan-checker.md`、`verifier.md`）が含まれます。これらは 62 のトップレベルリファレンスにはカウントされません。 +> **サブディレクトリ:** `gsd-core/references/few-shot-examples/` には、特定のエージェントから参照される追加のフューショット例（`plan-checker.md`、`verifier.md`）が含まれます。これらは 62 のトップレベルリファレンスにはカウントされません。 --- ## CLI モジュール (81 shipped) -完全な一覧: `get-shit-done/bin/lib/*.cjs`。 +完全な一覧: `gsd-core/bin/lib/*.cjs`。 | モジュール | 責務 | |-----------|------| @@ -443,7 +443,7 @@ | `task-command-router.cjs` | `gsd-tools task` 向けの薄い CJS サブコマンドルーターアダプター | | `template.cjs` | 変数置換によるテンプレート選択と穴埋め | | `uat.cjs` | UAT ファイル解析、検証負債追跡、audit-uat サポート | -| `ui-safety-gate.cjs` | シェルフリーのワード境界 UI トークン検出器（#3706、#3718）。フェーズセクションテキストを標準入力から読み込み、0（UI 発見）または 1（UI なし）で終了。GSD インストーラーが `$RUNTIME_DIR` に配布するために `get-shit-done/bin/lib/` にもデプロイ（#448） | +| `ui-safety-gate.cjs` | シェルフリーのワード境界 UI トークン検出器（#3706、#3718）。フェーズセクションテキストを標準入力から読み込み、0（UI 発見）または 1（UI なし）で終了。GSD インストーラーが `$RUNTIME_DIR` に配布するために `gsd-core/bin/lib/` にもデプロイ（#448） | | `update-context.cjs` | `/gsd:update` 向けの純粋なインストールコンテキストリゾルバー — ランタイム/スコープ/設定ディレクトリ/バージョン検出（LOCAL/GLOBAL/UNKNOWN）。update.md bash からポート。`gsd-tools update-context` を支える（#498） | | `validate-command-router.cjs` | `gsd-tools validate` 向けの薄い CJS サブコマンドルーターアダプター | | `validate.cjs` | 純粋なフェーズバリアント正規化ヘルパー（`phaseVariants`、`buildRoadmapPhaseVariants`、`buildNotStartedPhaseVariants`）。`verify.cjs` の W006/W007 チェックで使用。I/O なし、非同期なし | diff --git a/docs/ja-JP/USER-GUIDE.md b/docs/ja-JP/USER-GUIDE.md index 15c4ee089..0159c3788 100644 --- a/docs/ja-JP/USER-GUIDE.md +++ b/docs/ja-JP/USER-GUIDE.md @@ -562,14 +562,14 @@ claude --dangerously-skip-permissions ### プログラマティック CLI（`gsd-tools query` vs `gsd-tools.cjs`） -自動化には、登録済みサブコマンドを使用する **`gsd-tools query`** を推奨します（[CLI-TOOLS.md — SDK とプログラマティックアクセス](CLI-TOOLS.md#sdk-and-programmatic-access) と QUERY-HANDLERS.md を参照）。レガシーの `node $HOME/.claude/get-shit-done/bin/gsd-tools.cjs` CLI は引き続きサポートされています。 +自動化には、登録済みサブコマンドを使用する **`gsd-tools query`** を推奨します（[CLI-TOOLS.md — SDK とプログラマティックアクセス](CLI-TOOLS.md#sdk-and-programmatic-access) と QUERY-HANDLERS.md を参照）。レガシーの `node $HOME/.claude/gsd-core/bin/gsd-tools.cjs` CLI は引き続きサポートされています。 ### STATE.md の同期ずれ ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state validate # Detect drift -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync --verify # Preview changes -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync # Reconstruct STATE.md +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state validate # Detect drift +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync --verify # Preview changes +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync # Reconstruct STATE.md ``` ### 「Spawning...」の後にコマンドがフリーズしているように見える @@ -667,7 +667,7 @@ budget プロファイルに切り替えてください: `/gsd-config --profile サーバーを無効にすると、以降のすべてのターンからそのスキーマが削除されます。MCP のトリミングは `model_profile` の調整と**複合効果があります** — 両方のレバーは相加的であり、MCP の節約はオーケストレーターが生成するすべてのサブエージェントにわたってすぐに現れます。 -完全な監査、ハーネスリファレンス、`model_profile` との組み合わせに関するノートは、バンドルされた `context-budget.md` リファレンスの [MCP ツールスキーマコスト](../../get-shit-done/references/context-budget.md#mcp-tool-schema-cost-harness-concern) を参照してください。 +完全な監査、ハーネスリファレンス、`model_profile` との組み合わせに関するノートは、バンドルされた `context-budget.md` リファレンスの [MCP ツールスキーマコスト](../../gsd-core/references/context-budget.md#mcp-tool-schema-cost-harness-concern) を参照してください。 ### 非 Claude ランタイムの使用（Codex、OpenCode、Gemini CLI、Kilo） diff --git a/docs/ja-JP/explanation/context-engineering.md b/docs/ja-JP/explanation/context-engineering.md index 8637e9e1d..1cf97dbaa 100644 --- a/docs/ja-JP/explanation/context-engineering.md +++ b/docs/ja-JP/explanation/context-engineering.md @@ -48,7 +48,7 @@ GSD Core の核心的な洞察は、コーディングセッションの作業 **仕様駆動開発** とは、すべてのフェーズが実行開始前に構造化されたアーティファクトを生成することを意味します。`CONTEXT.md` は Discuss ステップでの実装上の決定を記録します。`RESEARCH.md` は調査エージェントが見つけたものを記録します。`PLAN.md` は作業を独立した、依存関係の順序に従ったタスクに分解し、明確な受け入れ基準を持ちます。エグゼキューターエージェントがファイルに触れる時点では、長い会話の再解釈ではなく、正確な仕様から作業します。 -**メタプロンプティング** とは、エージェント定義自体が慎重に設計されたプロンプトであり、アドホックな指示ではないことを意味します。`get-shit-done/workflows/` および `agents/` 内のファイルは、タスクのスコープの決め方、何を検証するか、いつ人間のチェックポイントにエスカレートするかについての実践的な知識をエンコードしています。ユーザーはこの知識をセッションごとに再説明する必要はありません。それはシステム自身のプロンプトに組み込まれています。 +**メタプロンプティング** とは、エージェント定義自体が慎重に設計されたプロンプトであり、アドホックな指示ではないことを意味します。`gsd-core/workflows/` および `agents/` 内のファイルは、タスクのスコープの決め方、何を検証するか、いつ人間のチェックポイントにエスカレートするかについての実践的な知識をエンコードしています。ユーザーはこの知識をセッションごとに再説明する必要はありません。それはシステム自身のプロンプトに組み込まれています。 この組み合わせは意図的です。フレッシュコンテキストは各エージェントが明確に推論することを保証します。仕様駆動のアーティファクトは各エージェントが *正しい* ことについて推論することを保証します。メタプロンプティングは各エージェントが *うまく* 推論する方法を知っていることを保証します。 diff --git a/docs/ja-JP/explanation/multi-agent-orchestration.md b/docs/ja-JP/explanation/multi-agent-orchestration.md index 3a64ab961..a711806bd 100644 --- a/docs/ja-JP/explanation/multi-agent-orchestration.md +++ b/docs/ja-JP/explanation/multi-agent-orchestration.md @@ -14,7 +14,7 @@ GSD Core のマルチエージェント設計はその問題への直接的な ## オーケストレーター → エージェントパターン -`get-shit-done/workflows/` のすべてのワークフローは同じ形を持ちます： +`gsd-core/workflows/` のすべてのワークフローは同じ形を持ちます： ```text Orchestrator（ワークフロー .md ファイル） diff --git a/docs/ja-JP/explanation/security-model.md b/docs/ja-JP/explanation/security-model.md index be3014d07..34d6714ef 100644 --- a/docs/ja-JP/explanation/security-model.md +++ b/docs/ja-JP/explanation/security-model.md @@ -62,7 +62,7 @@ GSD Core は LLM システムプロンプトになる Markdown ファイルを GSD Core はプロンプトインジェクションを 3 つのレベルで対処します。 -**入力検証（`security.cjs`）。** `get-shit-done/bin/lib/security.cjs` モジュールは中心的なセキュリティユーティリティです。以下を提供します： +**入力検証（`security.cjs`）。** `gsd-core/bin/lib/security.cjs` モジュールは中心的なセキュリティユーティリティです。以下を提供します： - パストラバーサル防止：ユーザー提供のファイルパス（`--text-file`、`--prd`）はプロジェクトディレクトリ内で解決されることを検証し、macOS の `/var` → `/private/var` シンリンク解決を明示的に処理 - プロンプトインジェクション検出：既知のインジェクションパターン（ロールオーバーライド、指示バイパス、システムタグインジェクション）が計画アーティファクトに入る前にユーザー提供テキストをスキャン diff --git a/docs/ja-JP/how-to/recover-and-troubleshoot.md b/docs/ja-JP/how-to/recover-and-troubleshoot.md index c7bcf4d1d..3f8f267ef 100644 --- a/docs/ja-JP/how-to/recover-and-troubleshoot.md +++ b/docs/ja-JP/how-to/recover-and-troubleshoot.md @@ -89,19 +89,19 @@ GSD は新鮮なコンテキストを前提に設計されています。すべ これは警告 `W002` を生成します。状態 CLI を使って診断と修復を行います。 ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state validate +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state validate ``` 書き込まずに同期で何が変わるかをプレビューします。 ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync --verify +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync --verify ``` 同期を適用します。 ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync ``` これらのコマンドはディスク上の実際のプロジェクト状態から `STATE.md` を再構築します。手動での `STATE.md` 編集に代わるものです。 diff --git a/docs/ja-JP/reference/context-md.md b/docs/ja-JP/reference/context-md.md index 3070c4020..4ae7d116b 100644 --- a/docs/ja-JP/reference/context-md.md +++ b/docs/ja-JP/reference/context-md.md @@ -14,7 +14,7 @@ 例: `.planning/phases/03-post-feed/03-CONTEXT.md` -このファイルは `get-shit-done/workflows/discuss-phase.md` の `write_context`（または PRD / ADR インジェストのエクスプレスパス）によって生成されます。通常の運用中は手動で編集されません — discuss-phase ワークフローが書き込み、下流エージェントが封印された信頼できる情報源として読み取ります。 +このファイルは `gsd-core/workflows/discuss-phase.md` の `write_context`（または PRD / ADR インジェストのエクスプレスパス）によって生成されます。通常の運用中は手動で編集されません — discuss-phase ワークフローが書き込み、下流エージェントが封印された信頼できる情報源として読み取ります。 --- diff --git a/docs/ja-JP/reference/plan-md.md b/docs/ja-JP/reference/plan-md.md index 26cc3aeac..eac28b4b9 100644 --- a/docs/ja-JP/reference/plan-md.md +++ b/docs/ja-JP/reference/plan-md.md @@ -122,8 +122,8 @@ Output: PostFeed and PostCard components wired to /api/feed. ```xml -@~/.claude/get-shit-done/workflows/execute-plan.md -@~/.claude/get-shit-done/templates/summary.md +@~/.claude/gsd-core/workflows/execute-plan.md +@~/.claude/gsd-core/templates/summary.md ``` diff --git a/docs/ja-JP/reference/state-md.md b/docs/ja-JP/reference/state-md.md index 254c5c3a2..343dcd78b 100644 --- a/docs/ja-JP/reference/state-md.md +++ b/docs/ja-JP/reference/state-md.md @@ -77,7 +77,7 @@ paused_at: null ### ステータス値 -`get-shit-done/bin/lib/state-document.cjs` の `normalizeStateStatus()` が本文の生テキストを以下の正規値にマッピングします： +`gsd-core/bin/lib/state-document.cjs` の `normalizeStateStatus()` が本文の生テキストを以下の正規値にマッピングします： | 正規値 | マッチするテキスト（大文字小文字不問） | |---|---| @@ -133,7 +133,7 @@ paused_at: null ## Markdown 本文セクション -本文（末尾の `---` 以降のすべて）は `get-shit-done/templates/state.md` のテンプレートに従います。標準セクションは以下の通りです： +本文（末尾の `---` 以降のすべて）は `gsd-core/templates/state.md` のテンプレートに従います。標準セクションは以下の通りです： ### Project Reference @@ -153,7 +153,7 @@ paused_at: null | `Last activity:` | ハンドラー書き込み時は ISO 日付（`YYYY-MM-DD`）; エグゼキューター作成時はナラティブ文章 | | `Progress:` | ビジュアルバー。例: `[████░░░░░░] 40%` | -このセクションの `Status:` および `Last activity:` フィールドは、既存の値が既知のテンプレートデフォルト値の場合に GSD ハンドラーによって更新されます（クヌース不変式: エグゼキューター作成値は保存されます）。既知のハンドラーデフォルト値の完全なリストは `get-shit-done/bin/lib/state-document.cjs` の `KNOWN_TEMPLATE_DEFAULTS` に記載されています。 +このセクションの `Status:` および `Last activity:` フィールドは、既存の値が既知のテンプレートデフォルト値の場合に GSD ハンドラーによって更新されます（クヌース不変式: エグゼキューター作成値は保存されます）。既知のハンドラーデフォルト値の完全なリストは `gsd-core/bin/lib/state-document.cjs` の `KNOWN_TEMPLATE_DEFAULTS` に記載されています。 ### Performance Metrics diff --git a/docs/ja-JP/superpowers/specs/2026-03-20-multi-project-workspaces-design.md b/docs/ja-JP/superpowers/specs/2026-03-20-multi-project-workspaces-design.md index 91ad5462f..d0bd0641d 100644 --- a/docs/ja-JP/superpowers/specs/2026-03-20-multi-project-workspaces-design.md +++ b/docs/ja-JP/superpowers/specs/2026-03-20-multi-project-workspaces-design.md @@ -166,11 +166,11 @@ Strategy: worktree | コマンド: new-workspace | `commands/gsd/new-workspace.md` | | コマンド: list-workspaces | `commands/gsd/list-workspaces.md` | | コマンド: remove-workspace | `commands/gsd/remove-workspace.md` | -| ワークフロー: new-workspace | `get-shit-done/workflows/new-workspace.md` | -| ワークフロー: list-workspaces | `get-shit-done/workflows/list-workspaces.md` | -| ワークフロー: remove-workspace | `get-shit-done/workflows/remove-workspace.md` | -| Init 関数 | `get-shit-done/bin/lib/init.cjs`（`cmdInitNewWorkspace`、`cmdInitListWorkspaces`、`cmdInitRemoveWorkspace` を追加） | -| ルーティング | `get-shit-done/bin/gsd-tools.cjs`（init switch にケースを追加） | +| ワークフロー: new-workspace | `gsd-core/workflows/new-workspace.md` | +| ワークフロー: list-workspaces | `gsd-core/workflows/list-workspaces.md` | +| ワークフロー: remove-workspace | `gsd-core/workflows/remove-workspace.md` | +| Init 関数 | `gsd-core/bin/lib/init.cjs`（`cmdInitNewWorkspace`、`cmdInitListWorkspaces`、`cmdInitRemoveWorkspace` を追加） | +| ルーティング | `gsd-core/bin/gsd-tools.cjs`（init switch にケースを追加） | | テスト | `tests/workspace.test.cjs` | ## 設計上の決定 diff --git a/docs/ko-KR/ARCHITECTURE.md b/docs/ko-KR/ARCHITECTURE.md index 2e737c75c..7be7efe55 100644 --- a/docs/ko-KR/ARCHITECTURE.md +++ b/docs/ko-KR/ARCHITECTURE.md @@ -42,7 +42,7 @@ GSD Core는 사용자와 AI 코딩 에이전트(Claude Code, Gemini CLI, OpenCod │ ┌─────────────────────▼────────────────────────────────┐ │ WORKFLOW LAYER │ -│ get-shit-done/workflows/*.md — Orchestration logic │ +│ gsd-core/workflows/*.md — Orchestration logic │ │ (Reads references, spawns agents, manages state) │ └──────┬──────────────┬─────────────────┬──────────────┘ │ │ │ @@ -75,7 +75,7 @@ GSD Core는 사용자와 AI 코딩 에이전트(Claude Code, Gemini CLI, OpenCod ### 2. 얇은 오케스트레이터 -워크플로우 파일(`get-shit-done/workflows/*.md`)은 무거운 작업을 직접 수행하지 않는다. 오케스트레이터가 하는 것: +워크플로우 파일(`gsd-core/workflows/*.md`)은 무거운 작업을 직접 수행하지 않는다. 오케스트레이터가 하는 것: - `gsd-tools.cjs init `로 컨텍스트 로드 - 집중된 프롬프트로 전문화된 에이전트 생성 @@ -130,7 +130,7 @@ GSD Core는 사용자와 AI 코딩 에이전트(Claude Code, Gemini CLI, OpenCod 열망적 스킬 목록은 턴당 반복되는 두 가지 토큰 비용 중 하나이다. 다른 하나는 `.claude/settings.json`의 모든 활성화된 MCP 서버가 주입하는 MCP 도구 스키마이다. 무거운 MCP 서버(브라우저/playwright, Mac-tools, Windows-tools)는 각각 턴당 20k+ 토큰 비용이 들 수 있다 — 종종 `model_profile` 튜닝이 절약하는 것을 압도한다. 토글은 Claude Code 하니스(`.claude/settings.json`의 `enabledMcpjsonServers` / `disabledMcpjsonServers`)에 있으며 GSD 관심사가 아니다. 2단계 라우팅 계층(#2792)과 규율 있는 MCP 활성화를 함께 사용하는 것이 턴당 가장 큰 비용 레버이다. [`docs/USER-GUIDE.md`](USER-GUIDE.md)와 `references/context-budget.md`에서 감사 체크리스트를 참조하라. -### Workflows (`get-shit-done/workflows/*.md`) +### Workflows (`gsd-core/workflows/*.md`) 명령어가 참조하는 오케스트레이션 로직. 다음을 포함하는 단계별 프로세스를 담는다: @@ -152,7 +152,7 @@ GSD Core는 사용자와 AI 코딩 에이전트(Claude Code, Gemini CLI, OpenCod | `LARGE` | 1500 — 다단계 플래너 및 대형 기능 워크플로우 | | `DEFAULT` | 1000 — 집중된 단일 목적 워크플로우 (목표 등급) | -`workflows/discuss-phase.md`는 discuss-phase 바이트 예산(#717; discuss-phase/modes 분할로 ≈32000 바이트 유지)에 따라 더 엄격한 상한을 유지한다. 워크플로우가 등급을 초과하면 모드별 본문은 `workflows//modes/.md`로, 템플릿은 `workflows//templates/`로, 공유 지식은 `get-shit-done/references/`로 추출한다. 부모 파일은 현재 호출에 필요한 모드 및 템플릿 파일만 읽는 얇은 디스패처가 된다. +`workflows/discuss-phase.md`는 discuss-phase 바이트 예산(#717; discuss-phase/modes 분할로 ≈32000 바이트 유지)에 따라 더 엄격한 상한을 유지한다. 워크플로우가 등급을 초과하면 모드별 본문은 `workflows//modes/.md`로, 템플릿은 `workflows//templates/`로, 공유 지식은 `gsd-core/references/`로 추출한다. 부모 파일은 현재 호출에 필요한 모드 및 템플릿 파일만 읽는 얇은 디스패처가 된다. `workflows/discuss-phase/`가 이 패턴의 정규 예시이다 — 부모는 디스패치하고, modes/는 플래그별 동작(`power.md`, `all.md`, `auto.md`, `chain.md`, `text.md`, `batch.md`, `analyze.md`, `default.md`, `advisor.md`)을 담으며, templates/는 해당 출력 파일이 작성될 때만 읽히는 CONTEXT.md, DISCUSSION-LOG.md, checkpoint.json 스키마를 담는다. @@ -167,7 +167,7 @@ GSD Core는 사용자와 AI 코딩 에이전트(Claude Code, Gemini CLI, OpenCod **전체 에이전트 수:** 33개 -### References (`get-shit-done/references/*.md`) +### References (`gsd-core/references/*.md`) 워크플로우와 에이전트가 `@-reference`하는 공유 지식 문서([`docs/INVENTORY.md`](INVENTORY.md#references-41-shipped)에서 권위 있는 개수와 전체 목록 참조): @@ -221,7 +221,7 @@ GSD 워크플로우에 thinking 클래스 모델(o3, o4-mini, Gemini 2.5 Pro)을 - `planner-reviews.md` — 교차 AI 리뷰 통합 (`/gsd-review`의 REVIEWS.md 읽기) - `planner-revision.md` — 반복적 개선을 위한 계획 수정 패턴 -### Templates (`get-shit-done/templates/`) +### Templates (`gsd-core/templates/`) 모든 계획 결과물을 위한 마크다운 템플릿. `gsd-tools.cjs template fill` / `phase.scaffold`(와 최상위 `scaffold`)가 사전 구조화된 파일을 생성하는 데 사용: - `project.md`, `requirements.md`, `roadmap.md`, `state.md` — 핵심 프로젝트 파일 @@ -253,13 +253,13 @@ GSD 워크플로우에 thinking 클래스 모델(o3, o4-mini, Gemini 2.5 Pro)을 권위 있는 11개 훅 목록은 [`docs/INVENTORY.md`](INVENTORY.md#hooks-11-shipped)를 참조하라. -### Command Routing Hub (`get-shit-done/bin/lib/command-routing-hub.cjs`) +### Command Routing Hub (`gsd-core/bin/lib/command-routing-hub.cjs`) CJS 명령어 패밀리 라우터는 `CommandRoutingHub`를 통해 디스패치한다. 허브는 no-throw 순수 결과 계약(`hub.dispatch()`는 내부 예외를 잡아 `{ ok: false, kind, ...typedPayload }`를 반환)과 닫힌 런타임 오류 분류(`UnknownCommand`, `InvalidArgs`, `HandlerRefusal`, `HandlerFailure`)를 소유한다. 라우터 어댑터는 얇은 CLI 번역기로 유지된다 — 허브를 구축하고, `dispatch`를 호출하고, 결과를 `output()`/`error()` 호출에 매핑한다. 런타임은 단일 경로이다(이중 런타임 모드 선택 없음). `docs/adr/0174-retire-gsd-sdk-package-boundary.md` 참조. -### CLI Tools (`get-shit-done/bin/`) +### CLI Tools (`gsd-core/bin/`) -`get-shit-done/bin/lib/`에 걸쳐 분할된 도메인 모듈을 가진 Node.js CLI 유틸리티(`gsd-tools.cjs`)(권위 있는 목록은 [`docs/INVENTORY.md`](INVENTORY.md#cli-modules-33-shipped) 참조): +`gsd-core/bin/lib/`에 걸쳐 분할된 도메인 모듈을 가진 Node.js CLI 유틸리티(`gsd-tools.cjs`)(권위 있는 목록은 [`docs/INVENTORY.md`](INVENTORY.md#cli-modules-33-shipped) 참조): | 모듈 | 책임 | @@ -466,7 +466,7 @@ UI-SPEC.md (단계별) ─────────────────── ~/.claude/ # Claude Code (전역 설치) ├── skills/gsd-*/SKILL.md # 전역 스킬 (권위 있는 목록: docs/INVENTORY.md) ├── commands/gsd/*.md # 로컬 Claude 설치는 전역 스킬 대신 슬래시 명령어 사용 -├── get-shit-done/ +├── gsd-core/ │ ├── bin/gsd-tools.cjs # CLI 유틸리티 │ ├── bin/lib/*.cjs # 도메인 모듈 (권위 있는 목록: docs/INVENTORY.md) │ ├── workflows/*.md # 워크플로우 정의 (권위 있는 목록: docs/INVENTORY.md) diff --git a/docs/ko-KR/CLI-TOOLS.md b/docs/ko-KR/CLI-TOOLS.md index 7d9f76984..d272bd4be 100644 --- a/docs/ko-KR/CLI-TOOLS.md +++ b/docs/ko-KR/CLI-TOOLS.md @@ -1,6 +1,6 @@ # GSD CLI 도구 참조 -> `gsd-tools` CLI(`get-shit-done/bin/gsd-tools.cjs`)에 대한 참조입니다. 슬래시 명령 및 사용자 흐름은 [명령 참조](COMMANDS.md)를 확인하세요. [문서 인덱스](README.md)로 돌아가기. +> `gsd-tools` CLI(`gsd-core/bin/gsd-tools.cjs`)에 대한 참조입니다. 슬래시 명령 및 사용자 흐름은 [명령 참조](COMMANDS.md)를 확인하세요. [문서 인덱스](README.md)로 돌아가기. --- @@ -11,8 +11,8 @@ | | | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| **배포 경로** | `get-shit-done/bin/gsd-tools.cjs` | -| **구현** | `get-shit-done/bin/lib/` 아래 20개의 도메인 모듈 (해당 디렉토리가 기준) | +| **배포 경로** | `gsd-core/bin/gsd-tools.cjs` | +| **구현** | `gsd-core/bin/lib/` 아래 20개의 도메인 모듈 (해당 디렉토리가 기준) | | **상태** | 오케스트레이션, 워크플로우, 자동화를 위한 주요 런타임 명령 인터페이스. | @@ -488,7 +488,7 @@ node gsd-tools.cjs config-set review.models.claude "" # clear — fall back ## 시크릿 처리 -`/gsd-settings`(`brave_search`, `firecrawl`, `exa_search`)를 통해 설정된 API 키는 `.planning/config.json`에 일반 텍스트로 기록되지만 모든 `config-set` / `config-get` 출력, 확인 테이블, 대화형 프롬프트에서 마스킹(`****`)됩니다. 마스킹 구현은 `get-shit-done/bin/lib/secrets.cjs`를 참조하세요. `config.json` 파일 자체가 보안 경계입니다 — 파일시스템 권한으로 보호하고 git에서 제외하세요(`.planning/`는 기본적으로 gitignore됩니다). +`/gsd-settings`(`brave_search`, `firecrawl`, `exa_search`)를 통해 설정된 API 키는 `.planning/config.json`에 일반 텍스트로 기록되지만 모든 `config-set` / `config-get` 출력, 확인 테이블, 대화형 프롬프트에서 마스킹(`****`)됩니다. 마스킹 구현은 `gsd-core/bin/lib/secrets.cjs`를 참조하세요. `config.json` 파일 자체가 보안 경계입니다 — 파일시스템 권한으로 보호하고 git에서 제외하세요(`.planning/`는 기본적으로 gitignore됩니다). --- diff --git a/docs/ko-KR/COMMANDS.md b/docs/ko-KR/COMMANDS.md index 338bb91d9..8ed4b4758 100644 --- a/docs/ko-KR/COMMANDS.md +++ b/docs/ko-KR/COMMANDS.md @@ -612,7 +612,7 @@ Nyquist 검증 갭을 소급하여 감사하고 보완합니다. /gsd-help --brief # 압축된 범위 지정 조회 — 시그니처 + 한 줄 요약 ``` -전체 별칭 테이블은 `get-shit-done/workflows/help/modes/topic.md`를 참조하세요. 알 수 없는 주제는 인식된 목록을 출력합니다. +전체 별칭 테이블은 `gsd-core/workflows/help/modes/topic.md`를 참조하세요. 알 수 없는 주제는 인식된 목록을 출력합니다. --- diff --git a/docs/ko-KR/INVENTORY.md b/docs/ko-KR/INVENTORY.md index 83b0faf53..401eeeb38 100644 --- a/docs/ko-KR/INVENTORY.md +++ b/docs/ko-KR/INVENTORY.md @@ -169,7 +169,7 @@ ## 워크플로우 (88개 출시) -전체 목록은 `get-shit-done/workflows/*.md`에 있습니다. 워크플로우는 명령어가 내부적으로 참조하는 얇은 오케스트레이터입니다; 대부분은 최종 사용자가 직접 읽지 않습니다. 아래 행은 각 워크플로우 파일을 역할(`` 블록에서 도출)과, 해당하는 경우 호출 명령어에 매핑합니다. +전체 목록은 `gsd-core/workflows/*.md`에 있습니다. 워크플로우는 명령어가 내부적으로 참조하는 얇은 오케스트레이터입니다; 대부분은 최종 사용자가 직접 읽지 않습니다. 아래 행은 각 워크플로우 파일을 역할(`` 블록에서 도출)과, 해당하는 경우 호출 명령어에 매핑합니다. | 워크플로우 | 역할 | 호출자 | |----------|------|------------| @@ -268,7 +268,7 @@ ## 레퍼런스 (62개 출시) -전체 목록은 `get-shit-done/references/*.md`에 있습니다. 레퍼런스는 워크플로우와 에이전트가 `@-참조`하는 공유 지식 문서입니다. 아래 그룹화는 [`docs/ARCHITECTURE.md`](ARCHITECTURE.md#references-get-shit-donereferencesmd) — 코어, 워크플로우, 씽킹 모델 클러스터, 모듈식 플래너 분해에 일치합니다. +전체 목록은 `gsd-core/references/*.md`에 있습니다. 레퍼런스는 워크플로우와 에이전트가 `@-참조`하는 공유 지식 문서입니다. 아래 그룹화는 [`docs/ARCHITECTURE.md`](ARCHITECTURE.md#references-gsd-corereferencesmd) — 코어, 워크플로우, 씽킹 모델 클러스터, 모듈식 플래너 분해에 일치합니다. ### 코어 레퍼런스 @@ -363,13 +363,13 @@ | `user-story-template.md` | MVP 계획을 위한 사용자 스토리 형식 — "As a / I want to / So that" 구조화된 필드. | | `spidr-splitting.md` | MVP 모드에서 큰 사용자 스토리 처리를 위한 SPIDR 분할 분해 규칙. | -> **하위 디렉터리:** `get-shit-done/references/few-shot-examples/`에는 특정 에이전트에서 참조되는 추가 퓨샷 예시(`plan-checker.md`, `verifier.md`)가 포함되어 있습니다. 이들은 62개 최상위 레퍼런스 수에 포함되지 않습니다. +> **하위 디렉터리:** `gsd-core/references/few-shot-examples/`에는 특정 에이전트에서 참조되는 추가 퓨샷 예시(`plan-checker.md`, `verifier.md`)가 포함되어 있습니다. 이들은 62개 최상위 레퍼런스 수에 포함되지 않습니다. --- ## CLI 모듈 (81개 출시) -전체 목록: `get-shit-done/bin/lib/*.cjs`. +전체 목록: `gsd-core/bin/lib/*.cjs`. | 모듈 | 책임 | |--------|----------------| @@ -443,7 +443,7 @@ | `task-command-router.cjs` | `gsd-tools task`를 위한 얇은 CJS 하위 명령어 라우터 어댑터 | | `template.cjs` | 변수 치환을 통한 템플릿 선택 및 채우기 | | `uat.cjs` | UAT 파일 파싱, 검증 부채 추적, audit-uat 지원 | -| `ui-safety-gate.cjs` | 셸 없는 단어 경계 UI 토큰 감지기(#3706, #3718); stdin에서 단계 섹션 텍스트를 읽어 0(UI 발견) 또는 1(UI 없음) 종료; GSD 설치 프로그램이 `$RUNTIME_DIR`에 배포하도록 `get-shit-done/bin/lib/`에도 배포 | +| `ui-safety-gate.cjs` | 셸 없는 단어 경계 UI 토큰 감지기(#3706, #3718); stdin에서 단계 섹션 텍스트를 읽어 0(UI 발견) 또는 1(UI 없음) 종료; GSD 설치 프로그램이 `$RUNTIME_DIR`에 배포하도록 `gsd-core/bin/lib/`에도 배포 | | `update-context.cjs` | `/gsd:update`를 위한 순수 설치 컨텍스트 해석기 — update.md bash에서 포팅된 런타임/범위/설정 디렉터리/버전 감지(LOCAL/GLOBAL/UNKNOWN); `gsd-tools update-context` 지원(#498) | | `validate-command-router.cjs` | `gsd-tools validate`를 위한 얇은 CJS 하위 명령어 라우터 어댑터 | | `validate.cjs` | 순수 단계 변형 정규화 헬퍼(`phaseVariants`, `buildRoadmapPhaseVariants`, `buildNotStartedPhaseVariants`), W006/W007 확인을 위해 `verify.cjs`에서 사용; I/O 없음, 비동기 없음 | diff --git a/docs/ko-KR/USER-GUIDE.md b/docs/ko-KR/USER-GUIDE.md index 95cb95d9b..795cfd4de 100644 --- a/docs/ko-KR/USER-GUIDE.md +++ b/docs/ko-KR/USER-GUIDE.md @@ -562,14 +562,14 @@ claude --dangerously-skip-permissions ### 프로그래밍 방식 CLI (`gsd-tools query` vs `gsd-tools.cjs`) -자동화를 위해서는 등록된 서브명령어와 함께 **`gsd-tools query`**를 사용하세요([CLI-TOOLS.md — SDK 및 프로그래밍 방식 액세스](CLI-TOOLS.md#sdk-and-programmatic-access)와 QUERY-HANDLERS.md 참조). 레거시 `node $HOME/.claude/get-shit-done/bin/gsd-tools.cjs` CLI도 계속 지원됩니다. +자동화를 위해서는 등록된 서브명령어와 함께 **`gsd-tools query`**를 사용하세요([CLI-TOOLS.md — SDK 및 프로그래밍 방식 액세스](CLI-TOOLS.md#sdk-and-programmatic-access)와 QUERY-HANDLERS.md 참조). 레거시 `node $HOME/.claude/gsd-core/bin/gsd-tools.cjs` CLI도 계속 지원됩니다. ### STATE.md 동기화 오류 ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state validate # Detect drift -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync --verify # Preview changes -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync # Reconstruct STATE.md +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state validate # Detect drift +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync --verify # Preview changes +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync # Reconstruct STATE.md ``` ### "Spawning..." 이후 명령어가 멈춘 것처럼 보일 때 @@ -667,7 +667,7 @@ GSD 서브에이전트는 별도의 컨텍스트 창에서 실행됩니다 — 비활성화된 서버는 이후 모든 턴에서 스키마를 제거합니다. MCP 정리는 `model_profile` 조정과 **복합**됩니다 — 두 레버는 가산적이며, MCP 절약은 오케스트레이터가 생성하는 모든 서브에이전트에서 즉시 나타납니다. -전체 감사, 하네스 레퍼런스, `model_profile`과의 구성 노트는 번들된 `context-budget.md` 레퍼런스의 [MCP 도구 스키마 비용](../../get-shit-done/references/context-budget.md#mcp-tool-schema-cost-harness-concern)을 참조하세요. +전체 감사, 하네스 레퍼런스, `model_profile`과의 구성 노트는 번들된 `context-budget.md` 레퍼런스의 [MCP 도구 스키마 비용](../../gsd-core/references/context-budget.md#mcp-tool-schema-cost-harness-concern)을 참조하세요. ### 비 Claude 런타임 사용 (Codex, OpenCode, Gemini CLI, Kilo) diff --git a/docs/ko-KR/explanation/context-engineering.md b/docs/ko-KR/explanation/context-engineering.md index f7a6932fc..6512679c5 100644 --- a/docs/ko-KR/explanation/context-engineering.md +++ b/docs/ko-KR/explanation/context-engineering.md @@ -48,7 +48,7 @@ GSD Core의 핵심적인 통찰은 코딩 세션에서 이루어지는 작업의 **명세 주도 개발**은 모든 단계가 실행 전에 구조화된 결과물을 생성한다는 것을 의미한다. `CONTEXT.md`는 논의 단계의 구현 결정 사항들을 캡처한다. `RESEARCH.md`는 리서처가 발견한 내용을 기록한다. `PLAN.md`는 명시적인 수락 기준을 가진 개별적인 의존성 순서의 작업들로 작업을 분해한다. 실행 에이전트가 파일에 손을 대는 시점에는 긴 대화의 재해석이 아닌 정확한 명세를 가지고 있다. -**메타 프롬프팅**은 에이전트 정의 자체가 애드혹 지시 사항이 아닌 신중하게 설계된 프롬프트라는 것을 의미한다. `get-shit-done/workflows/`와 `agents/`의 파일들은 작업의 범위를 지정하는 방법, 무엇을 검증해야 하는지, 언제 사람에게 체크포인트를 요청해야 하는지에 대한 소중한 지식을 담고 있다. 사용자는 매 세션마다 이 지식을 다시 설명할 필요가 없다; 그것은 시스템 자체의 프롬프트에 이미 내장되어 있다. +**메타 프롬프팅**은 에이전트 정의 자체가 애드혹 지시 사항이 아닌 신중하게 설계된 프롬프트라는 것을 의미한다. `gsd-core/workflows/`와 `agents/`의 파일들은 작업의 범위를 지정하는 방법, 무엇을 검증해야 하는지, 언제 사람에게 체크포인트를 요청해야 하는지에 대한 소중한 지식을 담고 있다. 사용자는 매 세션마다 이 지식을 다시 설명할 필요가 없다; 그것은 시스템 자체의 프롬프트에 이미 내장되어 있다. 이 조합은 의도적이다. 신선한 컨텍스트는 각 에이전트가 명확하게 추론하도록 보장한다. 명세 주도 결과물은 각 에이전트가 *올바른* 것에 대해 추론하도록 보장한다. 메타 프롬프팅은 각 에이전트가 *어떻게* 잘 추론해야 하는지 알도록 보장한다. diff --git a/docs/ko-KR/explanation/multi-agent-orchestration.md b/docs/ko-KR/explanation/multi-agent-orchestration.md index c55e187ee..791d39aee 100644 --- a/docs/ko-KR/explanation/multi-agent-orchestration.md +++ b/docs/ko-KR/explanation/multi-agent-orchestration.md @@ -19,7 +19,7 @@ GSD Core의 다중 에이전트 설계는 그 문제에 대한 직접적인 대 ## 오케스트레이터 → 에이전트 패턴 -`get-shit-done/workflows/`의 모든 워크플로우는 동일한 형태를 따른다: +`gsd-core/workflows/`의 모든 워크플로우는 동일한 형태를 따른다: ```text 오케스트레이터 (워크플로우 .md 파일) diff --git a/docs/ko-KR/explanation/security-model.md b/docs/ko-KR/explanation/security-model.md index 4cbd1c2a6..fd2324bfb 100644 --- a/docs/ko-KR/explanation/security-model.md +++ b/docs/ko-KR/explanation/security-model.md @@ -68,7 +68,7 @@ GSD Core는 LLM 시스템 프롬프트가 되는 마크다운 파일을 생성 GSD Core는 세 가지 수준에서 프롬프트 인젝션을 다룬다. -**입력 유효성 검사(`security.cjs`).** `get-shit-done/bin/lib/security.cjs` 모듈은 중앙 보안 유틸리티이다. 다음을 제공한다: +**입력 유효성 검사(`security.cjs`).** `gsd-core/bin/lib/security.cjs` 모듈은 중앙 보안 유틸리티이다. 다음을 제공한다: - 경로 탐색 방지: 사용자가 제공한 파일 경로(`--text-file`, `--prd`)가 프로젝트 디렉터리 내에서 해결되도록 유효성이 검사되며, macOS의 `/var` → `/private/var` 심링크 해결이 명시적으로 처리된다 - 프롬프트 인젝션 탐지: 알려진 인젝션 패턴(역할 재정의, 지시 우회, 시스템 태그 인젝션)이 사용자가 제공한 텍스트에서 계획 결과물에 들어가기 전에 스캔된다 diff --git a/docs/ko-KR/how-to/recover-and-troubleshoot.md b/docs/ko-KR/how-to/recover-and-troubleshoot.md index eea0557a8..cf7e09edc 100644 --- a/docs/ko-KR/how-to/recover-and-troubleshoot.md +++ b/docs/ko-KR/how-to/recover-and-troubleshoot.md @@ -89,19 +89,19 @@ GSD는 새로운 컨텍스트를 중심으로 설계되었습니다. 모든 서 이것은 경고 `W002`를 생성합니다. 상태 CLI를 사용하여 진단하고 복구합니다: ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state validate +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state validate ``` 쓰기 없이 동기화가 변경할 내용 미리 보기: ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync --verify +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync --verify ``` 동기화 적용: ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync ``` 이 명령들은 디스크의 실제 프로젝트 상태에서 `STATE.md`를 재구성합니다. 수동 `STATE.md` 편집을 대체합니다. diff --git a/docs/ko-KR/reference/context-md.md b/docs/ko-KR/reference/context-md.md index e4ea74132..9b6a0eb11 100644 --- a/docs/ko-KR/reference/context-md.md +++ b/docs/ko-KR/reference/context-md.md @@ -14,7 +14,7 @@ 예: `.planning/phases/03-post-feed/03-CONTEXT.md`. -이 파일은 `get-shit-done/workflows/discuss-phase.md`의 `write_context`(또는 PRD / ADR 인제스트 익스프레스 경로)에 의해 생성됩니다. 일반적인 운영 중에는 절대로 수동으로 편집하지 않습니다 — discuss-phase 워크플로가 이 파일을 기록하고 다운스트림 에이전트는 이를 봉인된 진실의 원천으로 읽습니다. +이 파일은 `gsd-core/workflows/discuss-phase.md`의 `write_context`(또는 PRD / ADR 인제스트 익스프레스 경로)에 의해 생성됩니다. 일반적인 운영 중에는 절대로 수동으로 편집하지 않습니다 — discuss-phase 워크플로가 이 파일을 기록하고 다운스트림 에이전트는 이를 봉인된 진실의 원천으로 읽습니다. --- diff --git a/docs/ko-KR/reference/plan-md.md b/docs/ko-KR/reference/plan-md.md index 69c1d3b8c..1635caa20 100644 --- a/docs/ko-KR/reference/plan-md.md +++ b/docs/ko-KR/reference/plan-md.md @@ -122,8 +122,8 @@ Output: PostFeed and PostCard components wired to /api/feed. ```xml -@~/.claude/get-shit-done/workflows/execute-plan.md -@~/.claude/get-shit-done/templates/summary.md +@~/.claude/gsd-core/workflows/execute-plan.md +@~/.claude/gsd-core/templates/summary.md ``` diff --git a/docs/ko-KR/reference/state-md.md b/docs/ko-KR/reference/state-md.md index e13b266e7..141925431 100644 --- a/docs/ko-KR/reference/state-md.md +++ b/docs/ko-KR/reference/state-md.md @@ -77,7 +77,7 @@ paused_at: null ### 상태 값 -`get-shit-done/bin/lib/state-document.cjs`의 `normalizeStateStatus()`는 본문의 원시 텍스트를 다음 표준 값으로 매핑합니다: +`gsd-core/bin/lib/state-document.cjs`의 `normalizeStateStatus()`는 본문의 원시 텍스트를 다음 표준 값으로 매핑합니다: | 표준 값 | 매칭되는 텍스트 (대소문자 무관) | |---|---| @@ -133,7 +133,7 @@ paused_at: null ## Markdown 본문 섹션 -본문(닫는 `---` 이후의 모든 것)은 `get-shit-done/templates/state.md`의 템플릿을 따릅니다. 표준 섹션은 다음과 같습니다: +본문(닫는 `---` 이후의 모든 것)은 `gsd-core/templates/state.md`의 템플릿을 따릅니다. 표준 섹션은 다음과 같습니다: ### Project Reference @@ -153,7 +153,7 @@ paused_at: null | `Last activity:` | 핸들러가 기록할 때 ISO 날짜(`YYYY-MM-DD`); 실행기가 작성할 때 서술형 산문 | | `Progress:` | 시각적 막대, 예: `[████░░░░░░] 40%` | -이 섹션의 `Status:` 및 `Last activity:` 필드는 기존 값이 알려진 템플릿 기본값인 경우 GSD 핸들러에 의해 업데이트됩니다(크누스 불변량: 실행기가 작성한 값은 보존됩니다). 알려진 핸들러 기본값의 전체 목록은 `get-shit-done/bin/lib/state-document.cjs`의 `KNOWN_TEMPLATE_DEFAULTS`에 있습니다. +이 섹션의 `Status:` 및 `Last activity:` 필드는 기존 값이 알려진 템플릿 기본값인 경우 GSD 핸들러에 의해 업데이트됩니다(크누스 불변량: 실행기가 작성한 값은 보존됩니다). 알려진 핸들러 기본값의 전체 목록은 `gsd-core/bin/lib/state-document.cjs`의 `KNOWN_TEMPLATE_DEFAULTS`에 있습니다. ### Performance Metrics diff --git a/docs/ko-KR/superpowers/specs/2026-03-20-multi-project-workspaces-design.md b/docs/ko-KR/superpowers/specs/2026-03-20-multi-project-workspaces-design.md index bb8741589..b7530e041 100644 --- a/docs/ko-KR/superpowers/specs/2026-03-20-multi-project-workspaces-design.md +++ b/docs/ko-KR/superpowers/specs/2026-03-20-multi-project-workspaces-design.md @@ -166,11 +166,11 @@ Strategy: worktree | 명령어: new-workspace | `commands/gsd/new-workspace.md` | | 명령어: list-workspaces | `commands/gsd/list-workspaces.md` | | 명령어: remove-workspace | `commands/gsd/remove-workspace.md` | -| 워크플로우: new-workspace | `get-shit-done/workflows/new-workspace.md` | -| 워크플로우: list-workspaces | `get-shit-done/workflows/list-workspaces.md` | -| 워크플로우: remove-workspace | `get-shit-done/workflows/remove-workspace.md` | -| Init 함수 | `get-shit-done/bin/lib/init.cjs`(`cmdInitNewWorkspace`, `cmdInitListWorkspaces`, `cmdInitRemoveWorkspace` 추가) | -| 라우팅 | `get-shit-done/bin/gsd-tools.cjs`(init switch에 case 추가) | +| 워크플로우: new-workspace | `gsd-core/workflows/new-workspace.md` | +| 워크플로우: list-workspaces | `gsd-core/workflows/list-workspaces.md` | +| 워크플로우: remove-workspace | `gsd-core/workflows/remove-workspace.md` | +| Init 함수 | `gsd-core/bin/lib/init.cjs`(`cmdInitNewWorkspace`, `cmdInitListWorkspaces`, `cmdInitRemoveWorkspace` 추가) | +| 라우팅 | `gsd-core/bin/gsd-tools.cjs`(init switch에 case 추가) | | 테스트 | `tests/workspace.test.cjs` | ## 설계 결정 diff --git a/docs/pt-BR/ARCHITECTURE.md b/docs/pt-BR/ARCHITECTURE.md index 14ff90570..c705f6a74 100644 --- a/docs/pt-BR/ARCHITECTURE.md +++ b/docs/pt-BR/ARCHITECTURE.md @@ -43,7 +43,7 @@ O GSD Core é um **framework de meta-prompting** que fica entre o usuário e os │ ┌─────────────────────▼────────────────────────────────┐ │ CAMADA DE WORKFLOWS │ -│ get-shit-done/workflows/*.md — Lógica de │ +│ gsd-core/workflows/*.md — Lógica de │ │ orquestração │ │ (Lê referências, cria agentes, gerencia estado) │ └──────┬──────────────┬─────────────────┬──────────────┘ @@ -77,7 +77,7 @@ Cada agente criado por um orquestrador recebe uma janela de contexto limpa (até ### 2. Orquestradores Leves -Os arquivos de workflow (`get-shit-done/workflows/*.md`) nunca fazem trabalho pesado. Eles: +Os arquivos de workflow (`gsd-core/workflows/*.md`) nunca fazem trabalho pesado. Eles: - Carregam contexto via `gsd-tools.cjs init ` - Criam agentes especializados com prompts focados @@ -132,7 +132,7 @@ As descrições dos roteadores usam tags de palavras-chave separadas por pipe ( A listagem de skills antecipada é um dos dois custos recorrentes de tokens por turno. O outro é o schema de ferramenta MCP injetado por cada servidor MCP habilitado em `.claude/settings.json`. Servidores MCP pesados (browser/playwright, Mac-tools, Windows-tools) podem custar mais de 20 mil tokens por turno cada — muitas vezes eclipsando o que o ajuste do `model_profile` economiza. O controle fica no harness do Claude Code (`enabledMcpjsonServers` / `disabledMcpjsonServers` em `.claude/settings.json`) e **não** é uma preocupação do GSD. Juntos, a camada de roteamento em dois estágios (#2792) e o controle criterioso do MCP são as maiores alavancas de custo por turno. Consulte [`docs/USER-GUIDE.md`](USER-GUIDE.md) e `references/context-budget.md` para o checklist de auditoria. -### Workflows (`get-shit-done/workflows/*.md`) +### Workflows (`gsd-core/workflows/*.md`) Lógica de orquestração que os comandos referenciam. Contém o processo passo a passo, incluindo: @@ -161,7 +161,7 @@ espelha a convenção de orçamento de tamanho de agentes: o orçamento de bytes do discuss-phase (#717; a divisão discuss-phase/modes mantém ≈32000 bytes). Quando um workflow cresce além de seu tier, extraia os corpos por modo em `workflows//modes/.md`, templates em `workflows//templates/`, e conhecimento compartilhado em -`get-shit-done/references/`. O arquivo pai se torna um despachante leve que +`gsd-core/references/`. O arquivo pai se torna um despachante leve que lê apenas os arquivos de modo e template necessários para a invocação atual. `workflows/discuss-phase/` é o exemplo canônico deste padrão — @@ -182,7 +182,7 @@ Definições de agentes especializados com frontmatter especificando: **Total de agentes:** 33 -### Referências (`get-shit-done/references/*.md`) +### Referências (`gsd-core/references/*.md`) Documentos de conhecimento compartilhado que workflows e agentes `@-referenciam` (consulte [`docs/INVENTORY.md`](INVENTORY.md#references-41-shipped) para a contagem oficial e o roster completo): @@ -236,7 +236,7 @@ O agente planner (`agents/gsd-planner.md`) foi decomposto de um único arquivo m - `planner-reviews.md` — Integração de revisão entre IAs (lê REVIEWS.md do `/gsd-review`) - `planner-revision.md` — Padrões de revisão de plano para refinamento iterativo -### Templates (`get-shit-done/templates/`) +### Templates (`gsd-core/templates/`) Templates Markdown para todos os artefatos de planejamento. Usados por `gsd-tools.cjs template fill` / `phase.scaffold` (e `scaffold` de nível superior) para criar arquivos pré-estruturados: - `project.md`, `requirements.md`, `roadmap.md`, `state.md` — Arquivos principais do projeto @@ -268,13 +268,13 @@ Hooks de runtime que se integram ao agente de IA anfitrião: Consulte [`docs/INVENTORY.md`](INVENTORY.md#hooks-11-shipped) para o roster oficial de 11 hooks. -### Hub de Roteamento de Comandos (`get-shit-done/bin/lib/command-routing-hub.cjs`) +### Hub de Roteamento de Comandos (`gsd-core/bin/lib/command-routing-hub.cjs`) Os roteadores de família de comandos CJS despacham através do `CommandRoutingHub`. O hub possui o contrato de resultado puro sem lançamento de exceções (`hub.dispatch()` captura exceções internas e retorna `{ ok: false, kind, ...typedPayload }`) e a taxonomia fechada de erros de runtime (`UnknownCommand`, `InvalidArgs`, `HandlerRefusal`, `HandlerFailure`). Os adaptadores de roteador permanecem como tradutores CLI leves — eles constroem o hub, chamam `dispatch` e depois mapeiam o Result para chamadas `output()`/`error()`. O runtime é de caminho único (sem seleção de modo de runtime duplo). Consulte `docs/adr/0174-retire-gsd-sdk-package-boundary.md`. -### Ferramentas CLI (`get-shit-done/bin/`) +### Ferramentas CLI (`gsd-core/bin/`) -Utilitário CLI Node.js (`gsd-tools.cjs`) com módulos de domínio distribuídos em `get-shit-done/bin/lib/` (consulte [`docs/INVENTORY.md`](INVENTORY.md#cli-modules-33-shipped) para o roster oficial): +Utilitário CLI Node.js (`gsd-tools.cjs`) com módulos de domínio distribuídos em `gsd-core/bin/lib/` (consulte [`docs/INVENTORY.md`](INVENTORY.md#cli-modules-33-shipped) para o roster oficial): | Módulo | Responsabilidade | @@ -481,7 +481,7 @@ UI-SPEC.md (por fase) ─────────────────── ~/.claude/ # Claude Code (instalação global) ├── skills/gsd-*/SKILL.md # Skills globais (roster oficial: docs/INVENTORY.md) ├── commands/gsd/*.md # Instalações locais do Claude usam slash commands em vez de skills globais -├── get-shit-done/ +├── gsd-core/ │ ├── bin/gsd-tools.cjs # Utilitário CLI │ ├── bin/lib/*.cjs # Módulos de domínio (roster oficial: docs/INVENTORY.md) │ ├── workflows/*.md # Definições de workflow (roster oficial: docs/INVENTORY.md) diff --git a/docs/pt-BR/CLI-TOOLS.md b/docs/pt-BR/CLI-TOOLS.md index 107c3259a..928e66f8b 100644 --- a/docs/pt-BR/CLI-TOOLS.md +++ b/docs/pt-BR/CLI-TOOLS.md @@ -1,6 +1,6 @@ # Referência de Ferramentas CLI do GSD -> Referência para o CLI `gsd-tools` (`get-shit-done/bin/gsd-tools.cjs`). Para comandos slash e fluxos de usuário, consulte a [Referência de Comandos](COMMANDS.md). Voltar ao [índice de documentação](README.md). +> Referência para o CLI `gsd-tools` (`gsd-core/bin/gsd-tools.cjs`). Para comandos slash e fluxos de usuário, consulte a [Referência de Comandos](COMMANDS.md). Voltar ao [índice de documentação](README.md). --- @@ -11,8 +11,8 @@ | | | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| **Caminho instalado** | `get-shit-done/bin/gsd-tools.cjs` | -| **Implementação** | 20 módulos de domínio em `get-shit-done/bin/lib/` (o diretório é autoritativo) | +| **Caminho instalado** | `gsd-core/bin/gsd-tools.cjs` | +| **Implementação** | 20 módulos de domínio em `gsd-core/bin/lib/` (o diretório é autoritativo) | | **Status** | Principal superfície de comandos em tempo de execução para orquestração, fluxos de trabalho e automação. | @@ -491,7 +491,7 @@ Os slugs são validados contra `[a-zA-Z0-9_-]+`; slugs vazios ou contendo caminh ## Tratamento de Segredos -As chaves de API configuradas via `/gsd-settings` (`brave_search`, `firecrawl`, `exa_search`) são gravadas em texto simples em `.planning/config.json`, mas são mascaradas (`****`) em toda saída de `config-set` / `config-get`, tabela de confirmação e prompt interativo. Consulte `get-shit-done/bin/lib/secrets.cjs` para a implementação do mascaramento. O próprio arquivo `config.json` é o limite de segurança — proteja-o com permissões do sistema de arquivos e mantenha-o fora do git (`.planning/` está no gitignore por padrão). +As chaves de API configuradas via `/gsd-settings` (`brave_search`, `firecrawl`, `exa_search`) são gravadas em texto simples em `.planning/config.json`, mas são mascaradas (`****`) em toda saída de `config-set` / `config-get`, tabela de confirmação e prompt interativo. Consulte `gsd-core/bin/lib/secrets.cjs` para a implementação do mascaramento. O próprio arquivo `config.json` é o limite de segurança — proteja-o com permissões do sistema de arquivos e mantenha-o fora do git (`.planning/` está no gitignore por padrão). --- diff --git a/docs/pt-BR/COMMANDS.md b/docs/pt-BR/COMMANDS.md index dc7e978e1..b57685880 100644 --- a/docs/pt-BR/COMMANDS.md +++ b/docs/pt-BR/COMMANDS.md @@ -610,7 +610,7 @@ Exibe os comandos GSD no nível solicitado. O padrão cabe em uma tela; `--full` /gsd-help --brief # Consulta resumida com escopo — assinatura + resumo em uma linha ``` -Consulte `get-shit-done/workflows/help/modes/topic.md` para a tabela completa de aliases. Tópicos desconhecidos exibem a lista reconhecida. +Consulte `gsd-core/workflows/help/modes/topic.md` para a tabela completa de aliases. Tópicos desconhecidos exibem a lista reconhecida. --- diff --git a/docs/pt-BR/CONFIGURATION.md b/docs/pt-BR/CONFIGURATION.md index 6bad0e10f..c13b3ca6e 100644 --- a/docs/pt-BR/CONFIGURATION.md +++ b/docs/pt-BR/CONFIGURATION.md @@ -184,7 +184,7 @@ Os campos de chave de API aceitam um valor string (a própria chave). Também po | `firecrawl` | string \| boolean \| null | `null` | Chave de API Firecrawl para raspagem profunda. Mascarada na exibição | | `exa_search` | string \| boolean \| null | `null` | Chave de API Exa Search para busca semântica. Mascarada na exibição | -**Convenção de mascaramento (`get-shit-done/bin/lib/secrets.cjs`):** chaves com 8 ou mais caracteres são renderizadas como `****<últimos-4>`; chaves menores são renderizadas como `****`; `null`/vazio é renderizado como `(unset)`. O texto simples é escrito como está em `.planning/config.json` — esse arquivo é o limite de segurança — mas a CLI, tabelas de confirmação, logs e descrições de `AskUserQuestion` nunca exibem o texto simples. Isso se aplica à própria saída do comando `config-set`: `config-set brave_search ` retorna um payload JSON com o valor mascarado. +**Convenção de mascaramento (`gsd-core/bin/lib/secrets.cjs`):** chaves com 8 ou mais caracteres são renderizadas como `****<últimos-4>`; chaves menores são renderizadas como `****`; `null`/vazio é renderizado como `(unset)`. O texto simples é escrito como está em `.planning/config.json` — esse arquivo é o limite de segurança — mas a CLI, tabelas de confirmação, logs e descrições de `AskUserQuestion` nunca exibem o texto simples. Isso se aplica à própria saída do comando `config-set`: `config-set brave_search ` retorna um payload JSON com o valor mascarado. ### Roteamento de CLI para Revisão de Código @@ -256,7 +256,7 @@ Todos os controles de fluxo de trabalho seguem o padrão **ausente = habilitado* | `workflow.plan_chunked` | boolean | `false` | Habilita o modo de planejamento em chunks. Quando `true` (ou quando a flag `--chunked` é passada para `/gsd-plan-phase`), o orquestrador divide a única Task de planejamento de longa duração em uma Task curta de esboço seguida de N Tasks curtas por plano (~3-5 min cada). Cada plano é commitado individualmente para resiliência a falhas. Se uma Task travar e o terminal for forçado a fechar, reexecutar com `--chunked` retoma a partir do último plano concluído. Particularmente útil no Windows onde Tasks de longa duração podem travar em stdio. Adicionado na v1.38 | | `workflow.code_review_command` | string | (nenhum) | Comando shell para integração de revisão de código externa em `/gsd-ship`. Recebe caminhos de arquivos alterados via stdin. Saída diferente de zero bloqueia o fluxo de trabalho de ship. Adicionado na v1.36 | | `workflow.tdd_mode` | boolean | `false` | Habilita o pipeline TDD como modo de execução de primeira classe. Quando `true`, o planejador aplica agressivamente `type: tdd` a tarefas elegíveis (lógica de negócios, APIs, validações, algoritmos) e o executor impõe a sequência de gate RED/GREEN/REFACTOR. Um ponto de revisão colaborativa ao final da fase verifica a conformidade com o gate. Adicionado na v1.36 | -| `workflow.human_verify_mode` | string | `'end-of-phase'` | Controla os pontos de verificação humana. `'end-of-phase'` (padrão desde #3309) suprime as tasks `checkpoint:human-verify` e incorpora verificações nos blocos `` para revisão ao final da fase. `'mid-flight'` restaura as tasks de checkpoint bloqueantes. `checkpoint:decision` e `checkpoint:human-action` não são afetados. Consulte [Referência de Checkpoints](../../get-shit-done/references/checkpoints.md#checkpoint_types). | +| `workflow.human_verify_mode` | string | `'end-of-phase'` | Controla os pontos de verificação humana. `'end-of-phase'` (padrão desde #3309) suprime as tasks `checkpoint:human-verify` e incorpora verificações nos blocos `` para revisão ao final da fase. `'mid-flight'` restaura as tasks de checkpoint bloqueantes. `checkpoint:decision` e `checkpoint:human-action` não são afetados. Consulte [Referência de Checkpoints](../../gsd-core/references/checkpoints.md#checkpoint_types). | | `workflow.cross_ai_execution` | boolean | `false` | Delega a execução de fase para uma CLI de IA externa em vez de gerar agentes executores locais. Útil para aproveitar os pontos fortes de um modelo diferente para fases específicas. Adicionado na v1.36 | | `workflow.cross_ai_command` | string | (nenhum) | Template de comando shell para execução cross-AI. Recebe o prompt de fase via stdin. Deve produzir saída compatível com SUMMARY.md. Obrigatório quando `cross_ai_execution` é `true`. Adicionado na v1.36 | | `workflow.cross_ai_timeout` | number | `300` | Timeout em segundos para comandos de execução cross-AI. Previne processos externos que não terminam. Adicionado na v1.36 | @@ -285,7 +285,7 @@ O namespace `code_quality.*` controla ferramentas opcionais de análise estrutur ## Configurações de Ship -`ship.pr_body_sections` adiciona seções adicionais ao corpo do PR para conteúdo de PRD/corpo do PR específico do projeto em `/gsd-ship` sem editar `get-shit-done/workflows/ship.md`. +`ship.pr_body_sections` adiciona seções adicionais ao corpo do PR para conteúdo de PRD/corpo do PR específico do projeto em `/gsd-ship` sem editar `gsd-core/workflows/ship.md`. Para um guia do usuário com exemplos de integração e solução de problemas, consulte [Seções Personalizadas do Corpo do PR](../ship-pr-body-sections.md). @@ -779,7 +779,7 @@ Tokens de flag inválidos são sanitizados e registrados como avisos. Apenas fla | gsd-doc-writer | Opus | Sonnet | Haiku | Sonnet | Inherit | | gsd-doc-verifier | Sonnet | Sonnet | Haiku | Haiku | Inherit | -> **Todos os 33 agentes incluídos possuem atribuições explícitas de nível por perfil** no catálogo (`sdk/shared/model-catalog.json`). A tabela acima mostra um subconjunto representativo dos agentes mais usados. Para agentes não listados aqui, `model_overrides` aceita qualquer nome de agente incluído. Os dados autoritativos de perfil são derivados de `sdk/shared/model-catalog.json` via `get-shit-done/bin/lib/model-catalog.cjs` e `sdk/src/model-catalog.ts`. +> **Todos os 33 agentes incluídos possuem atribuições explícitas de nível por perfil** no catálogo (`sdk/shared/model-catalog.json`). A tabela acima mostra um subconjunto representativo dos agentes mais usados. Para agentes não listados aqui, `model_overrides` aceita qualquer nome de agente incluído. Os dados autoritativos de perfil são derivados de `sdk/shared/model-catalog.json` via `gsd-core/bin/lib/model-catalog.cjs` e `sdk/src/model-catalog.ts`. ### Substituições por Agente diff --git a/docs/pt-BR/INVENTORY.md b/docs/pt-BR/INVENTORY.md index 7be789824..bdaa6d034 100644 --- a/docs/pt-BR/INVENTORY.md +++ b/docs/pt-BR/INVENTORY.md @@ -169,7 +169,7 @@ Esses seis roteadores são entradas apenas descritivas que o modelo seleciona pr ## Workflows (88 entregues) -Registro completo em `get-shit-done/workflows/*.md`. Workflows são orquestradores enxutos que os comandos referenciam internamente; a maioria não é lida diretamente pelos usuários finais. As linhas abaixo mapeiam cada arquivo de workflow para sua função (derivada do bloco ``) e, quando aplicável, para o comando que o invoca. +Registro completo em `gsd-core/workflows/*.md`. Workflows são orquestradores enxutos que os comandos referenciam internamente; a maioria não é lida diretamente pelos usuários finais. As linhas abaixo mapeiam cada arquivo de workflow para sua função (derivada do bloco ``) e, quando aplicável, para o comando que o invoca. | Workflow | Função | Invocado por | |----------|--------|--------------| @@ -268,7 +268,7 @@ Registro completo em `get-shit-done/workflows/*.md`. Workflows são orquestrador ## Referências (62 entregues) -Registro completo em `get-shit-done/references/*.md`. Referências são documentos de conhecimento compartilhado que workflows e agentes `@-reference`. Os agrupamentos abaixo correspondem a [`docs/ARCHITECTURE.md`](ARCHITECTURE.md#references-get-shit-donereferencesmd) — clusters principais, de workflow, de modelo de raciocínio e a decomposição modular do planejador. +Registro completo em `gsd-core/references/*.md`. Referências são documentos de conhecimento compartilhado que workflows e agentes `@-reference`. Os agrupamentos abaixo correspondem a [`docs/ARCHITECTURE.md`](ARCHITECTURE.md#references-gsd-corereferencesmd) — clusters principais, de workflow, de modelo de raciocínio e a decomposição modular do planejador. ### Referências Principais @@ -363,13 +363,13 @@ O agente `gsd-planner` é decomposto em um agente principal mais módulos de ref | `user-story-template.md` | Formato de história de usuário para planejamento MVP — campos estruturados "Como / Quero / Para que". | | `spidr-splitting.md` | Regras de decomposição de divisão SPIDR para lidar com histórias de usuário grandes no modo MVP. | -> **Subdiretório:** `get-shit-done/references/few-shot-examples/` contém exemplos adicionais de few-shot (`plan-checker.md`, `verifier.md`) que são referenciados por agentes específicos. Estes não são contados nas 62 referências de nível superior. +> **Subdiretório:** `gsd-core/references/few-shot-examples/` contém exemplos adicionais de few-shot (`plan-checker.md`, `verifier.md`) que são referenciados por agentes específicos. Estes não são contados nas 62 referências de nível superior. --- ## Módulos de CLI (81 entregues) -Listagem completa: `get-shit-done/bin/lib/*.cjs`. +Listagem completa: `gsd-core/bin/lib/*.cjs`. | Módulo | Responsabilidade | |--------|-----------------| @@ -443,7 +443,7 @@ Listagem completa: `get-shit-done/bin/lib/*.cjs`. | `task-command-router.cjs` | Adaptador de roteador de subcomando CJS fino para `gsd-tools task` | | `template.cjs` | Seleção e preenchimento de template com substituição de variáveis | | `uat.cjs` | Análise de arquivo UAT, rastreamento de dívida de verificação, suporte audit-uat | -| `ui-safety-gate.cjs` | Detector de token de UI de limite de palavra sem shell (#3706, #3718); lê texto de seção de fase do stdin, sai com 0 (UI encontrada) ou 1 (sem UI); também implantado em `get-shit-done/bin/lib/` para que o instalador GSD o entregue em `$RUNTIME_DIR` (#448) | +| `ui-safety-gate.cjs` | Detector de token de UI de limite de palavra sem shell (#3706, #3718); lê texto de seção de fase do stdin, sai com 0 (UI encontrada) ou 1 (sem UI); também implantado em `gsd-core/bin/lib/` para que o instalador GSD o entregue em `$RUNTIME_DIR` (#448) | | `update-context.cjs` | Resolvedor de contexto de instalação puro para `/gsd:update` — detecção de runtime/escopo/config-dir/versão (LOCAL/GLOBAL/UNKNOWN) portada do bash de update.md; sustenta `gsd-tools update-context` (#498) | | `validate-command-router.cjs` | Adaptador de roteador de subcomando CJS fino para `gsd-tools validate` | | `validate.cjs` | Auxiliares de normalização de variante de fase puros (`phaseVariants`, `buildRoadmapPhaseVariants`, `buildNotStartedPhaseVariants`) usados por `verify.cjs` para verificações W006/W007; sem I/O, sem async | diff --git a/docs/pt-BR/USER-GUIDE.md b/docs/pt-BR/USER-GUIDE.md index c5f0a393b..fb3fdd806 100644 --- a/docs/pt-BR/USER-GUIDE.md +++ b/docs/pt-BR/USER-GUIDE.md @@ -562,14 +562,14 @@ Para um guia abrangente de solução de problemas, consulte [Recuperar e solucio ### CLI programática (`gsd-tools query` vs `gsd-tools.cjs`) -Para automação, prefira **`gsd-tools query`** com um subcomando registrado (consulte [CLI-TOOLS.md — SDK e acesso programático](CLI-TOOLS.md#sdk-and-programmatic-access) e QUERY-HANDLERS.md). O CLI legado `node $HOME/.claude/get-shit-done/bin/gsd-tools.cjs` continua sendo suportado. +Para automação, prefira **`gsd-tools query`** com um subcomando registrado (consulte [CLI-TOOLS.md — SDK e acesso programático](CLI-TOOLS.md#sdk-and-programmatic-access) e QUERY-HANDLERS.md). O CLI legado `node $HOME/.claude/gsd-core/bin/gsd-tools.cjs` continua sendo suportado. ### STATE.md fora de sincronia ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state validate # Detect drift -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync --verify # Preview changes -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync # Reconstruct STATE.md +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state validate # Detect drift +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync --verify # Preview changes +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync # Reconstruct STATE.md ``` ### Um comando parece congelado após "Spawning..." @@ -667,7 +667,7 @@ Auditoria rápida antes de uma fase longa: Cada servidor desabilitado remove seu esquema de cada turno subsequente. Reduzir MCPs **compõe** com o ajuste de `model_profile` — ambas as alavancas são aditivas, e as economias de MCP aparecem imediatamente em cada subagente que o orquestrador gera. -Para a auditoria completa, referência do harness e a nota de composição com `model_profile`, consulte [Custo de esquema de ferramentas MCP](../../get-shit-done/references/context-budget.md#mcp-tool-schema-cost-harness-concern) na referência `context-budget.md` incluída. +Para a auditoria completa, referência do harness e a nota de composição com `model_profile`, consulte [Custo de esquema de ferramentas MCP](../../gsd-core/references/context-budget.md#mcp-tool-schema-cost-harness-concern) na referência `context-budget.md` incluída. ### Usando runtimes não-Claude (Codex, OpenCode, Gemini CLI, Kilo) diff --git a/docs/pt-BR/explanation/context-engineering.md b/docs/pt-BR/explanation/context-engineering.md index ca5cb74e8..1a27e1005 100644 --- a/docs/pt-BR/explanation/context-engineering.md +++ b/docs/pt-BR/explanation/context-engineering.md @@ -48,7 +48,7 @@ A engenharia de contexto por si só não é suficiente. Se um agente começa do **Desenvolvimento orientado a especificações** significa que toda fase produz artefatos estruturados antes de a execução começar. Um `CONTEXT.md` captura as decisões de implementação da etapa Discuss. Um `RESEARCH.md` registra o que o pesquisador encontrou. Um `PLAN.md` divide o trabalho em tarefas discretas, ordenadas por dependência, com critérios de aceite explícitos. Quando um agente executor toca um arquivo, ele tem uma especificação precisa para seguir — não uma reinterpretação de uma conversa longa. -**Meta-prompting** significa que as próprias definições de agentes são prompts cuidadosamente engenheirados, não instruções ad-hoc. Os arquivos em `get-shit-done/workflows/` e `agents/` codificam conhecimento conquistado a duras penas sobre como delimitar tarefas, o que verificar e quando escalar para um checkpoint humano. O usuário não precisa reexplicar esse conhecimento a cada sessão; ele está integrado aos próprios prompts do sistema. +**Meta-prompting** significa que as próprias definições de agentes são prompts cuidadosamente engenheirados, não instruções ad-hoc. Os arquivos em `gsd-core/workflows/` e `agents/` codificam conhecimento conquistado a duras penas sobre como delimitar tarefas, o que verificar e quando escalar para um checkpoint humano. O usuário não precisa reexplicar esse conhecimento a cada sessão; ele está integrado aos próprios prompts do sistema. A combinação é deliberada. O contexto limpo garante que cada agente raciocine com clareza. Os artefatos orientados a especificações garantem que cada agente raciocine sobre a *coisa certa*. O meta-prompting garante que cada agente saiba *como* raciocinar bem sobre ela. diff --git a/docs/pt-BR/explanation/multi-agent-orchestration.md b/docs/pt-BR/explanation/multi-agent-orchestration.md index ac62fa1f1..2f7e6cef4 100644 --- a/docs/pt-BR/explanation/multi-agent-orchestration.md +++ b/docs/pt-BR/explanation/multi-agent-orchestration.md @@ -29,7 +29,7 @@ adequado, coleta o resultado e atualiza o estado compartilhado em `.planning/`. ## O padrão orquestrador → agente -Todos os workflows em `get-shit-done/workflows/` seguem a mesma estrutura: +Todos os workflows em `gsd-core/workflows/` seguem a mesma estrutura: ```text Orquestrador (arquivo .md de workflow) diff --git a/docs/pt-BR/explanation/security-model.md b/docs/pt-BR/explanation/security-model.md index 1b1308090..19305de42 100644 --- a/docs/pt-BR/explanation/security-model.md +++ b/docs/pt-BR/explanation/security-model.md @@ -136,7 +136,7 @@ substituir as instruções do agente ou exfiltrar informações. O GSD Core trata a injeção de prompt em três níveis. **Validação de entrada (`security.cjs`).** O módulo -`get-shit-done/bin/lib/security.cjs` é o utilitário central de segurança. +`gsd-core/bin/lib/security.cjs` é o utilitário central de segurança. Ele fornece: - Prevenção de path traversal: caminhos de arquivo fornecidos pelo usuário diff --git a/docs/pt-BR/how-to/recover-and-troubleshoot.md b/docs/pt-BR/how-to/recover-and-troubleshoot.md index d4158d91c..6e855ec94 100644 --- a/docs/pt-BR/how-to/recover-and-troubleshoot.md +++ b/docs/pt-BR/how-to/recover-and-troubleshoot.md @@ -89,19 +89,19 @@ Isso recria o `STATE.md` ausente, redefine um `config.json` corrompido para os p Isso gera o aviso `W002`. Use a CLI de estado para diagnosticar e reparar: ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state validate +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state validate ``` Visualize o que uma sincronização mudaria sem gravar: ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync --verify +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync --verify ``` Aplique a sincronização: ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync ``` Esses comandos reconstroem o `STATE.md` a partir do estado real do projeto em disco. Substituem a edição manual do `STATE.md`. diff --git a/docs/pt-BR/reference/context-md.md b/docs/pt-BR/reference/context-md.md index a6474a55b..b4a1ce186 100644 --- a/docs/pt-BR/reference/context-md.md +++ b/docs/pt-BR/reference/context-md.md @@ -14,7 +14,7 @@ Toda fase que passou pelo fluxo de trabalho de discussão produz um `CONTEXT.md` Por exemplo: `.planning/phases/03-post-feed/03-CONTEXT.md`. -O arquivo é produzido por `write_context` em `get-shit-done/workflows/discuss-phase.md` (ou seus caminhos expressos de ingestão de PRD / ADR). Ele nunca é editado manualmente durante a operação normal — o fluxo de trabalho discuss-phase o escreve e os agentes downstream o leem como uma fonte de verdade selada. +O arquivo é produzido por `write_context` em `gsd-core/workflows/discuss-phase.md` (ou seus caminhos expressos de ingestão de PRD / ADR). Ele nunca é editado manualmente durante a operação normal — o fluxo de trabalho discuss-phase o escreve e os agentes downstream o leem como uma fonte de verdade selada. --- diff --git a/docs/pt-BR/reference/plan-md.md b/docs/pt-BR/reference/plan-md.md index 848503904..014d37a19 100644 --- a/docs/pt-BR/reference/plan-md.md +++ b/docs/pt-BR/reference/plan-md.md @@ -122,8 +122,8 @@ Lista os arquivos de workflow que o executor lê antes de começar. Sempre inclu ```xml -@~/.claude/get-shit-done/workflows/execute-plan.md -@~/.claude/get-shit-done/templates/summary.md +@~/.claude/gsd-core/workflows/execute-plan.md +@~/.claude/gsd-core/templates/summary.md ``` diff --git a/docs/pt-BR/reference/state-md.md b/docs/pt-BR/reference/state-md.md index deb0db1af..7cb7f9492 100644 --- a/docs/pt-BR/reference/state-md.md +++ b/docs/pt-BR/reference/state-md.md @@ -77,7 +77,7 @@ paused_at: null ### Valores de status -`normalizeStateStatus()` em `get-shit-done/bin/lib/state-document.cjs` mapeia o texto bruto do corpo para estes valores canônicos: +`normalizeStateStatus()` em `gsd-core/bin/lib/state-document.cjs` mapeia o texto bruto do corpo para estes valores canônicos: | Valor canônico | Texto correspondente (sem diferenciação de maiúsculas/minúsculas) | |---|---| @@ -133,7 +133,7 @@ Se uma mudança futura substituir o analisador de regex por uma biblioteca YAML ## Seções do corpo Markdown -O corpo (tudo após o `---` de fechamento) segue o template em `get-shit-done/templates/state.md`. As seções padrão são: +O corpo (tudo após o `---` de fechamento) segue o template em `gsd-core/templates/state.md`. As seções padrão são: ### Referência do Projeto @@ -153,7 +153,7 @@ Onde o projeto está agora: | `Last activity:` | Data ISO (`YYYY-MM-DD`) quando escrito por handler; prosa narrativa quando elaborado pelo executor | | `Progress:` | Barra visual, ex.: `[████░░░░░░] 40%` | -Os campos `Status:` e `Last activity:` nesta seção são atualizados pelos handlers do GSD quando o valor existente é um padrão de template conhecido (invariante de Knuth: valores elaborados pelo executor são preservados). A lista completa de padrões de handler conhecidos está em `KNOWN_TEMPLATE_DEFAULTS` dentro de `get-shit-done/bin/lib/state-document.cjs`. +Os campos `Status:` e `Last activity:` nesta seção são atualizados pelos handlers do GSD quando o valor existente é um padrão de template conhecido (invariante de Knuth: valores elaborados pelo executor são preservados). A lista completa de padrões de handler conhecidos está em `KNOWN_TEMPLATE_DEFAULTS` dentro de `gsd-core/bin/lib/state-document.cjs`. ### Métricas de Desempenho diff --git a/docs/zh-CN/ARCHITECTURE.md b/docs/zh-CN/ARCHITECTURE.md index 6395b3733..a977d94d8 100644 --- a/docs/zh-CN/ARCHITECTURE.md +++ b/docs/zh-CN/ARCHITECTURE.md @@ -42,7 +42,7 @@ GSD Core 是一个**元提示框架**，位于用户与 AI 编码 Agent（Claude │ ┌─────────────────────▼────────────────────────────────┐ │ WORKFLOW LAYER │ -│ get-shit-done/workflows/*.md — Orchestration logic │ +│ gsd-core/workflows/*.md — Orchestration logic │ │ (Reads references, spawns agents, manages state) │ └──────┬──────────────┬─────────────────┬──────────────┘ │ │ │ @@ -75,7 +75,7 @@ GSD Core 是一个**元提示框架**，位于用户与 AI 编码 Agent（Claude ### 2. 轻量级编排器 -工作流文件（`get-shit-done/workflows/*.md`）不承担繁重工作。它们： +工作流文件（`gsd-core/workflows/*.md`）不承担繁重工作。它们： - 通过 `gsd-tools.cjs init ` 加载上下文 - 以聚焦的提示词派生专用 Agent @@ -130,7 +130,7 @@ GSD Core 是一个**元提示框架**，位于用户与 AI 编码 Agent（Claude 急于列举技能是每轮两种反复出现的 token 开销之一。另一种是 `.claude/settings.json` 中每个已启用 MCP 服务器注入的 MCP 工具 schema。重型 MCP 服务器（browser/playwright、Mac-tools、Windows-tools）每轮各自可消耗 20k+ token——通常远超 `model_profile` 调优所节省的量。该开关位于 Claude Code 框架中（`.claude/settings.json` 中的 `enabledMcpjsonServers` / `disabledMcpjsonServers`），**不属于** GSD 的关注范围。两阶段路由层（#2792）和严格的 MCP 启用管理是每轮最大的成本杠杆。请参阅 [`docs/USER-GUIDE.md`](USER-GUIDE.md) 和 `references/context-budget.md` 了解审计清单。 -### 工作流（`get-shit-done/workflows/*.md`） +### 工作流（`gsd-core/workflows/*.md`） 命令所引用的编排逻辑，包含逐步流程： @@ -152,7 +152,7 @@ GSD Core 是一个**元提示框架**，位于用户与 AI 编码 Agent（Claude | `LARGE` | 1500 — 多步骤规划器和大型功能工作流 | | `DEFAULT` | 1000 — 聚焦于单一目的的工作流（目标层级） | -根据 discuss-phase 字节预算（#717；discuss-phase/modes 分割使其保持在 ≈32000 字节），`workflows/discuss-phase.md` 须严格遵守更严格的上限。当工作流超出其层级时，应将各模式的主体提取到 `workflows//modes/.md`，将模板提取到 `workflows//templates/`，将共享知识提取到 `get-shit-done/references/`。父文件成为轻量级调度器，仅读取当前调用所需的模式和模板文件。 +根据 discuss-phase 字节预算（#717；discuss-phase/modes 分割使其保持在 ≈32000 字节），`workflows/discuss-phase.md` 须严格遵守更严格的上限。当工作流超出其层级时，应将各模式的主体提取到 `workflows//modes/.md`，将模板提取到 `workflows//templates/`，将共享知识提取到 `gsd-core/references/`。父文件成为轻量级调度器，仅读取当前调用所需的模式和模板文件。 `workflows/discuss-phase/` 是该模式的典型示例——父文件负责调度，`modes/` 存放各标志的行为（`power.md`、`all.md`、`auto.md`、`chain.md`、`text.md`、`batch.md`、`analyze.md`、`default.md`、`advisor.md`），`templates/` 存放 CONTEXT.md、DISCUSSION-LOG.md 以及仅在写入对应输出文件时才读取的 checkpoint.json schema。 @@ -167,7 +167,7 @@ GSD Core 是一个**元提示框架**，位于用户与 AI 编码 Agent（Claude **Agent 总数：** 33 -### 参考文档（`get-shit-done/references/*.md`） +### 参考文档（`gsd-core/references/*.md`） 工作流和 Agent 通过 `@-reference` 引用的共享知识文档（请参阅 [`docs/INVENTORY.md`](INVENTORY.md#references-41-shipped) 获取权威数量及完整列表）： @@ -221,7 +221,7 @@ GSD Core 是一个**元提示框架**，位于用户与 AI 编码 Agent（Claude - `planner-reviews.md` — 跨 AI 审查集成（从 `/gsd-review` 读取 REVIEWS.md） - `planner-revision.md` — 用于迭代细化的计划修订模式 -### 模板（`get-shit-done/templates/`） +### 模板（`gsd-core/templates/`） 所有规划产物的 Markdown 模板。由 `gsd-tools.cjs template fill` / `phase.scaffold`（以及顶级 `scaffold`）使用，以创建预结构化文件： - `project.md`、`requirements.md`、`roadmap.md`、`state.md` — 核心项目文件 @@ -253,13 +253,13 @@ GSD Core 是一个**元提示框架**，位于用户与 AI 编码 Agent（Claude 请参阅 [`docs/INVENTORY.md`](INVENTORY.md#hooks-11-shipped) 获取权威的 11 个 hook 列表。 -### 命令路由中枢（`get-shit-done/bin/lib/command-routing-hub.cjs`） +### 命令路由中枢（`gsd-core/bin/lib/command-routing-hub.cjs`） CJS 命令族路由器通过 `CommandRoutingHub` 进行调度。中枢拥有不抛出异常的纯结果契约（`hub.dispatch()` 捕获内部异常并返回 `{ ok: false, kind, ...typedPayload }`）以及封闭的运行时错误分类（`UnknownCommand`、`InvalidArgs`、`HandlerRefusal`、`HandlerFailure`）。路由器适配器保持为轻量级 CLI 转换器——它们构建中枢、调用 `dispatch`，然后将结果映射到 `output()`/`error()` 调用。运行时为单路径（无双运行时模式选择）。参见 `docs/adr/0174-retire-gsd-sdk-package-boundary.md`。 -### CLI 工具（`get-shit-done/bin/`） +### CLI 工具（`gsd-core/bin/`） -Node.js CLI 工具（`gsd-tools.cjs`），其领域模块分布在 `get-shit-done/bin/lib/` 中（请参阅 [`docs/INVENTORY.md`](INVENTORY.md#cli-modules-33-shipped) 获取权威列表）： +Node.js CLI 工具（`gsd-tools.cjs`），其领域模块分布在 `gsd-core/bin/lib/` 中（请参阅 [`docs/INVENTORY.md`](INVENTORY.md#cli-modules-33-shipped) 获取权威列表）： | 模块 | 职责 | @@ -466,7 +466,7 @@ UI-SPEC.md (per phase) ─────────────────── ~/.claude/ # Claude Code (global install) ├── skills/gsd-*/SKILL.md # Global skills (authoritative roster: docs/INVENTORY.md) ├── commands/gsd/*.md # Local Claude installs use slash commands instead of global skills -├── get-shit-done/ +├── gsd-core/ │ ├── bin/gsd-tools.cjs # CLI utility │ ├── bin/lib/*.cjs # Domain modules (authoritative roster: docs/INVENTORY.md) │ ├── workflows/*.md # Workflow definitions (authoritative roster: docs/INVENTORY.md) diff --git a/docs/zh-CN/CLI-TOOLS.md b/docs/zh-CN/CLI-TOOLS.md index b141cb17e..447a499a0 100644 --- a/docs/zh-CN/CLI-TOOLS.md +++ b/docs/zh-CN/CLI-TOOLS.md @@ -1,6 +1,6 @@ # GSD CLI 工具参考 -> `gsd-tools` CLI（`get-shit-done/bin/gsd-tools.cjs`）参考文档。斜杠命令与用户流程请参见[命令参考](COMMANDS.md)。返回[文档索引](README.md)。 +> `gsd-tools` CLI（`gsd-core/bin/gsd-tools.cjs`）参考文档。斜杠命令与用户流程请参见[命令参考](COMMANDS.md)。返回[文档索引](README.md)。 --- @@ -11,8 +11,8 @@ | | | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| **发布路径** | `get-shit-done/bin/gsd-tools.cjs` | -| **实现** | `get-shit-done/bin/lib/` 下的 20 个领域模块（以该目录为准） | +| **发布路径** | `gsd-core/bin/gsd-tools.cjs` | +| **实现** | `gsd-core/bin/lib/` 下的 20 个领域模块（以该目录为准） | | **状态** | 编排、工作流和自动化的主要运行时命令接口。 | @@ -488,7 +488,7 @@ Slug 将针对 `[a-zA-Z0-9_-]+` 进行验证；空或包含路径的 slug 将被 ## 密钥处理 -通过 `/gsd-settings` 配置的 API 密钥（`brave_search`、`firecrawl`、`exa_search`）以明文形式写入 `.planning/config.json`，但在所有 `config-set` / `config-get` 输出、确认表格和交互式提示中均会被遮蔽（`****`）。遮蔽实现请参见 `get-shit-done/bin/lib/secrets.cjs`。`config.json` 文件本身是安全边界——请通过文件系统权限保护它，并将其排除在 git 之外（`.planning/` 默认已被 gitignore）。 +通过 `/gsd-settings` 配置的 API 密钥（`brave_search`、`firecrawl`、`exa_search`）以明文形式写入 `.planning/config.json`，但在所有 `config-set` / `config-get` 输出、确认表格和交互式提示中均会被遮蔽（`****`）。遮蔽实现请参见 `gsd-core/bin/lib/secrets.cjs`。`config.json` 文件本身是安全边界——请通过文件系统权限保护它，并将其排除在 git 之外（`.planning/` 默认已被 gitignore）。 --- diff --git a/docs/zh-CN/COMMANDS.md b/docs/zh-CN/COMMANDS.md index 3985a0928..691e4d2d4 100644 --- a/docs/zh-CN/COMMANDS.md +++ b/docs/zh-CN/COMMANDS.md @@ -608,7 +608,7 @@ ROADMAP.md 中阶段的 CRUD 操作 — 通过单一合并命令添加、插入 /gsd-help --brief # 简洁的范围查找 — 签名 + 单行摘要 ``` -完整别名表请参阅 `get-shit-done/workflows/help/modes/topic.md`。未知主题将打印已识别的列表。 +完整别名表请参阅 `gsd-core/workflows/help/modes/topic.md`。未知主题将打印已识别的列表。 --- diff --git a/docs/zh-CN/CONFIGURATION.md b/docs/zh-CN/CONFIGURATION.md index b3b551723..d236615c1 100644 --- a/docs/zh-CN/CONFIGURATION.md +++ b/docs/zh-CN/CONFIGURATION.md @@ -184,7 +184,7 @@ API 密钥字段接受字符串值（密钥本身）。也可以设置为哨兵 | `firecrawl` | string \| boolean \| null | `null` | 用于深度抓取的 Firecrawl API 密钥。显示时已脱敏 | | `exa_search` | string \| boolean \| null | `null` | 用于语义搜索的 Exa Search API 密钥。显示时已脱敏 | -**脱敏规范（`get-shit-done/bin/lib/secrets.cjs`）：** 8 个字符及以上的密钥显示为 `****<末4位>`；较短的密钥显示为 `****`；`null`/空值显示为 `(unset)`。明文原样写入 `.planning/config.json`——该文件是安全边界——但 CLI、确认表格、日志和 `AskUserQuestion` 描述中不显示明文。这也适用于 `config-set` 命令本身的输出：`config-set brave_search ` 返回带脱敏值的 JSON 负载。 +**脱敏规范（`gsd-core/bin/lib/secrets.cjs`）：** 8 个字符及以上的密钥显示为 `****<末4位>`；较短的密钥显示为 `****`；`null`/空值显示为 `(unset)`。明文原样写入 `.planning/config.json`——该文件是安全边界——但 CLI、确认表格、日志和 `AskUserQuestion` 描述中不显示明文。这也适用于 `config-set` 命令本身的输出：`config-set brave_search ` 返回带脱敏值的 JSON 负载。 ### 代码审查 CLI 路由 @@ -256,7 +256,7 @@ API 密钥字段接受字符串值（密钥本身）。也可以设置为哨兵 | `workflow.plan_chunked` | boolean | `false` | 启用分块规划模式。为 `true`（或向 `/gsd-plan-phase` 传递 `--chunked` 标志）时，编排器将单个长期规划器任务拆分为一个简短的轮廓任务，后跟 N 个简短的按计划任务（每个约 3-5 分钟）。每个计划单独提交以具备崩溃韧性。如果任务挂起且终端被强制终止，使用 `--chunked` 重新运行将从最后完成的计划处恢复。在长期任务可能在 stdio 上挂起的 Windows 上特别有用。v1.38 新增 | | `workflow.code_review_command` | string | （无） | `/gsd-ship` 中外部代码审查集成的 shell 命令。通过 stdin 接收更改的文件路径。非零退出阻塞发布工作流。v1.36 新增 | | `workflow.tdd_mode` | boolean | `false` | 将 TDD 流水线作为一等执行模式启用。为 `true` 时，规划器积极地将 `type: tdd` 应用于符合条件的任务（业务逻辑、API、验证、算法），执行器强制执行 RED/GREEN/REFACTOR 门禁序列。阶段结束时的协作审查检查点验证门禁合规性。v1.36 新增 | -| `workflow.human_verify_mode` | string | `'end-of-phase'` | 控制人工验证检查点。`'end-of-phase'`（自 #3309 起为默认值）抑制 `checkpoint:human-verify` 任务，并将检查嵌入 `` 块以供阶段结束审查。`'mid-flight'` 恢复阻塞式检查点任务。`checkpoint:decision` 和 `checkpoint:human-action` 不受影响。参见[检查点参考](../../get-shit-done/references/checkpoints.md#checkpoint_types)。 | +| `workflow.human_verify_mode` | string | `'end-of-phase'` | 控制人工验证检查点。`'end-of-phase'`（自 #3309 起为默认值）抑制 `checkpoint:human-verify` 任务，并将检查嵌入 `` 块以供阶段结束审查。`'mid-flight'` 恢复阻塞式检查点任务。`checkpoint:decision` 和 `checkpoint:human-action` 不受影响。参见[检查点参考](../../gsd-core/references/checkpoints.md#checkpoint_types)。 | | `workflow.cross_ai_execution` | boolean | `false` | 将阶段执行委托给外部 AI CLI，而非派生本地执行器 agent。适用于利用不同模型在特定阶段的优势。v1.36 新增 | | `workflow.cross_ai_command` | string | （无） | 跨 AI 执行的 shell 命令模板。通过 stdin 接收阶段提示词。必须生成与 SUMMARY.md 兼容的输出。当 `cross_ai_execution` 为 `true` 时必需。v1.36 新增 | | `workflow.cross_ai_timeout` | number | `300` | 跨 AI 执行命令的超时秒数。防止失控的外部进程。v1.36 新增 | @@ -285,7 +285,7 @@ API 密钥字段接受字符串值（密钥本身）。也可以设置为哨兵 ## 发布设置 -`ship.pr_body_sections` 为 `/gsd-ship` 添加额外的 PR 正文节，用于项目特定的 PRD/PR 正文内容，而无需编辑 `get-shit-done/workflows/ship.md`。 +`ship.pr_body_sections` 为 `/gsd-ship` 添加额外的 PR 正文节，用于项目特定的 PRD/PR 正文内容，而无需编辑 `gsd-core/workflows/ship.md`。 有关入门示例和故障排除的用户指南，请参阅[自定义 PR 正文节](../ship-pr-body-sections.md)。 @@ -757,7 +757,7 @@ gsd-tools query config-set features.thinking_partner false | gsd-doc-writer | Opus | Sonnet | Haiku | Sonnet | Inherit | | gsd-doc-verifier | Sonnet | Sonnet | Haiku | Haiku | Inherit | -> **所有 33 个发布 agent 在目录（`sdk/shared/model-catalog.json`）中均有显式的按配置文件层级分配。** 上表显示最常用 agent 的代表性子集。对于此处未列出的 agent，`model_overrides` 接受任何已发布的 agent 名称。权威的配置文件数据通过 `get-shit-done/bin/lib/model-catalog.cjs` 和 `sdk/src/model-catalog.ts` 从 `sdk/shared/model-catalog.json` 导出。 +> **所有 33 个发布 agent 在目录（`sdk/shared/model-catalog.json`）中均有显式的按配置文件层级分配。** 上表显示最常用 agent 的代表性子集。对于此处未列出的 agent，`model_overrides` 接受任何已发布的 agent 名称。权威的配置文件数据通过 `gsd-core/bin/lib/model-catalog.cjs` 和 `sdk/src/model-catalog.ts` 从 `sdk/shared/model-catalog.json` 导出。 ### 按 Agent 覆盖 diff --git a/docs/zh-CN/FEATURES.md b/docs/zh-CN/FEATURES.md index cb8961f3f..96c641ed3 100644 --- a/docs/zh-CN/FEATURES.md +++ b/docs/zh-CN/FEATURES.md @@ -2095,7 +2095,7 @@ PreToolUse 钩子，检测 Claude 在 GSD 工作流上下文之外尝试文件 ### 92. 门控分类 -**参考：** `get-shit-done/references/gates.md` +**参考：** `gsd-core/references/gates.md` **智能体：** plan-checker、verifier **目的：** 定义构建所有工作流决策点的 4 种规范门控类型，使 plan-checker 和 verifier 智能体能够应用一致的门控逻辑。 @@ -2944,7 +2944,7 @@ explicit reviewer flags -> --all -> review.default_reviewers -> all detected rev - REQ-HUMAN-VERIFY-02：人工需要的验证必须保持待处理，直到阶段末审查解决。 - REQ-HUMAN-VERIFY-03：没有该键的配置必须使用 `"end-of-phase"`。 -**参考：** [检查点参考](../../get-shit-done/references/checkpoints.md) +**参考：** [检查点参考](../../gsd-core/references/checkpoints.md) --- diff --git a/docs/zh-CN/INVENTORY.md b/docs/zh-CN/INVENTORY.md index e1d295914..8fe1a9309 100644 --- a/docs/zh-CN/INVENTORY.md +++ b/docs/zh-CN/INVENTORY.md @@ -169,7 +169,7 @@ ## 工作流 (88 shipped) -完整清单位于 `get-shit-done/workflows/*.md`。工作流是命令在内部引用的轻量编排器；大多数不由最终用户直接阅读。以下行将每个工作流文件映射到其角色（来源于 `` 块），以及在适用情况下映射到调用它的命令。 +完整清单位于 `gsd-core/workflows/*.md`。工作流是命令在内部引用的轻量编排器；大多数不由最终用户直接阅读。以下行将每个工作流文件映射到其角色（来源于 `` 块），以及在适用情况下映射到调用它的命令。 | 工作流 | 角色 | 调用者 | |--------|------|--------| @@ -268,7 +268,7 @@ ## 参考资料 (62 shipped) -完整清单位于 `get-shit-done/references/*.md`。参考资料是工作流和代理 `@-reference` 的共享知识文档。以下分组与 [`docs/ARCHITECTURE.md`](ARCHITECTURE.md#references-get-shit-donereferencesmd) 一致 — 核心、工作流、思维模型集群和模块化规划器分解。 +完整清单位于 `gsd-core/references/*.md`。参考资料是工作流和代理 `@-reference` 的共享知识文档。以下分组与 [`docs/ARCHITECTURE.md`](ARCHITECTURE.md#references-gsd-corereferencesmd) 一致 — 核心、工作流、思维模型集群和模块化规划器分解。 ### 核心参考资料 @@ -363,13 +363,13 @@ | `user-story-template.md` | MVP 规划的用户故事格式 — "作为 / 我想要 / 以便" 结构化字段。 | | `spidr-splitting.md` | 用于在 MVP 模式下处理大型用户故事的 SPIDR 拆分分解规则。 | -> **子目录：** `get-shit-done/references/few-shot-examples/` 包含额外的少样本示例（`plan-checker.md`、`verifier.md`），这些示例从特定代理中引用。它们不计入 62 个顶级参考资料。 +> **子目录：** `gsd-core/references/few-shot-examples/` 包含额外的少样本示例（`plan-checker.md`、`verifier.md`），这些示例从特定代理中引用。它们不计入 62 个顶级参考资料。 --- ## CLI 模块 (81 shipped) -完整清单：`get-shit-done/bin/lib/*.cjs`。 +完整清单：`gsd-core/bin/lib/*.cjs`。 | 模块 | 职责 | |------|------| @@ -443,7 +443,7 @@ | `task-command-router.cjs` | `gsd-tools task` 的轻量 CJS 子命令路由适配器 | | `template.cjs` | 带变量替换的模板选择和填充 | | `uat.cjs` | UAT 文件解析、验证债务跟踪、audit-uat 支持 | -| `ui-safety-gate.cjs` | 无 shell 的词边界 UI 令牌检测器（#3706，#3718）；从 stdin 读取阶段章节文本，退出 0（找到 UI）或 1（未找到 UI）；也部署到 `get-shit-done/bin/lib/`，以便 GSD 安装程序将其传送到 `$RUNTIME_DIR`（#448） | +| `ui-safety-gate.cjs` | 无 shell 的词边界 UI 令牌检测器（#3706，#3718）；从 stdin 读取阶段章节文本，退出 0（找到 UI）或 1（未找到 UI）；也部署到 `gsd-core/bin/lib/`，以便 GSD 安装程序将其传送到 `$RUNTIME_DIR`（#448） | | `update-context.cjs` | `/gsd:update` 的纯安装上下文解析器 — 从 update.md bash 移植的运行时/范围/配置目录/版本检测（LOCAL/GLOBAL/UNKNOWN）；支持 `gsd-tools update-context`（#498） | | `validate-command-router.cjs` | `gsd-tools validate` 的轻量 CJS 子命令路由适配器 | | `validate.cjs` | 纯阶段变体规范化帮助器（`phaseVariants`、`buildRoadmapPhaseVariants`、`buildNotStartedPhaseVariants`），被 `verify.cjs` 用于 W006/W007 检查；无 I/O，无异步 | diff --git a/docs/zh-CN/USER-GUIDE.md b/docs/zh-CN/USER-GUIDE.md index 6462395f6..aa25f381e 100644 --- a/docs/zh-CN/USER-GUIDE.md +++ b/docs/zh-CN/USER-GUIDE.md @@ -561,14 +561,14 @@ claude --dangerously-skip-permissions ### 程序化 CLI（`gsd-tools query` 与 `gsd-tools.cjs`） -对于自动化，优先使用带有已注册子命令的 **`gsd-tools query`**（参见 [CLI-TOOLS.md — SDK 和程序化访问](CLI-TOOLS.md#sdk-and-programmatic-access) 及 QUERY-HANDLERS.md）。旧版 `node $HOME/.claude/get-shit-done/bin/gsd-tools.cjs` CLI 仍受支持。 +对于自动化，优先使用带有已注册子命令的 **`gsd-tools query`**（参见 [CLI-TOOLS.md — SDK 和程序化访问](CLI-TOOLS.md#sdk-and-programmatic-access) 及 QUERY-HANDLERS.md）。旧版 `node $HOME/.claude/gsd-core/bin/gsd-tools.cjs` CLI 仍受支持。 ### STATE.md 不同步 ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state validate # Detect drift -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync --verify # Preview changes -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync # Reconstruct STATE.md +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state validate # Detect drift +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync --verify # Preview changes +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync # Reconstruct STATE.md ``` ### 命令在"Spawning..."后似乎冻结 @@ -666,7 +666,7 @@ GSD 子 Agent 在单独的上下文窗口中运行——其工作在进行中对 每个被禁用的服务器都会从后续每次交互中移除其模式。精简 MCP **与** `model_profile` 调整形成叠加效果——两个杠杆是累加的，MCP 节省效果立即体现在编排器生成的每个子 Agent 上。 -完整审计、运行时参考及与 `model_profile` 的组合说明，请参阅捆绑的 `context-budget.md` 参考中的 [MCP 工具模式成本](../../get-shit-done/references/context-budget.md#mcp-tool-schema-cost-harness-concern)。 +完整审计、运行时参考及与 `model_profile` 的组合说明，请参阅捆绑的 `context-budget.md` 参考中的 [MCP 工具模式成本](../../gsd-core/references/context-budget.md#mcp-tool-schema-cost-harness-concern)。 ### 使用非 Claude 运行时（Codex、OpenCode、Gemini CLI、Kilo） diff --git a/docs/zh-CN/explanation/context-engineering.md b/docs/zh-CN/explanation/context-engineering.md index 1caf70a01..c206a96c1 100644 --- a/docs/zh-CN/explanation/context-engineering.md +++ b/docs/zh-CN/explanation/context-engineering.md @@ -48,7 +48,7 @@ GSD Core 的核心洞见是：编码会话中*大多数*工作根本无需在主 **规格驱动开发**意味着每个阶段在执行开始之前都会生成结构化产物。`CONTEXT.md` 捕获来自讨论步骤的实现决策。`RESEARCH.md` 记录研究智能体的发现。`PLAN.md` 将工作分解为离散的、按依赖关系排序的任务，并附有明确的验收标准。在执行器智能体接触文件之时，它已拥有一份精确的规格说明——而非对一段漫长对话的重新解读。 -**元提示**意味着智能体定义本身就是经过精心设计的提示，而非临时指令。`get-shit-done/workflows/` 和 `agents/` 中的文件编码了关于如何限定任务范围、需要验证什么，以及何时上报至人工检查点的宝贵经验。用户无需在每次会话中重新解释这些知识；它已内嵌于系统自身的提示中。 +**元提示**意味着智能体定义本身就是经过精心设计的提示，而非临时指令。`gsd-core/workflows/` 和 `agents/` 中的文件编码了关于如何限定任务范围、需要验证什么，以及何时上报至人工检查点的宝贵经验。用户无需在每次会话中重新解释这些知识；它已内嵌于系统自身的提示中。 这种组合是刻意为之的。全新上下文确保每个智能体清晰推理。规格驱动的产物确保每个智能体针对*正确的*事物进行推理。元提示确保每个智能体知道*如何*将其做好。 diff --git a/docs/zh-CN/explanation/multi-agent-orchestration.md b/docs/zh-CN/explanation/multi-agent-orchestration.md index 8a991da9c..df31fe924 100644 --- a/docs/zh-CN/explanation/multi-agent-orchestration.md +++ b/docs/zh-CN/explanation/multi-agent-orchestration.md @@ -24,7 +24,7 @@ GSD Core 的多智能体设计正是对这一问题的直接回应。与其让 ## 编排器 → 智能体模式 -`get-shit-done/workflows/` 中的每个工作流都遵循相同的结构： +`gsd-core/workflows/` 中的每个工作流都遵循相同的结构： ```text Orchestrator (workflow .md file) diff --git a/docs/zh-CN/explanation/security-model.md b/docs/zh-CN/explanation/security-model.md index cc7c0810a..3223d64c8 100644 --- a/docs/zh-CN/explanation/security-model.md +++ b/docs/zh-CN/explanation/security-model.md @@ -62,7 +62,7 @@ GSD Core 生成的 Markdown 文件会成为 LLM 系统提示。研究流水线 GSD Core 在三个层面应对提示注入。 -**输入验证（`security.cjs`）。** `get-shit-done/bin/lib/security.cjs` 模块是核心安全工具。它提供： +**输入验证（`security.cjs`）。** `gsd-core/bin/lib/security.cjs` 模块是核心安全工具。它提供： - 路径遍历防护：用户提供的文件路径（`--text-file`、`--prd`）经过验证，确保解析在项目目录内，并显式处理 macOS `/var` → `/private/var` 符号链接解析 - 提示注入检测：已知注入模式（角色覆盖、指令绕过、系统标签注入）在用户提供的文本进入任何规划产物之前进行扫描 diff --git a/docs/zh-CN/how-to/recover-and-troubleshoot.md b/docs/zh-CN/how-to/recover-and-troubleshoot.md index 1a5062c2d..87fa74fea 100644 --- a/docs/zh-CN/how-to/recover-and-troubleshoot.md +++ b/docs/zh-CN/how-to/recover-and-troubleshoot.md @@ -89,19 +89,19 @@ GSD 的设计围绕全新上下文展开。每个子代理已获得干净的 200 这会产生警告 `W002`。使用状态 CLI 进行诊断和修复： ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state validate +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state validate ``` 在不写入的情况下预览同步将更改的内容： ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync --verify +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync --verify ``` 应用同步： ```bash -node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync +node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync ``` 这些命令从磁盘上的实际项目状态重建 `STATE.md`，取代手动编辑 `STATE.md` 的操作。 diff --git a/docs/zh-CN/reference/context-md.md b/docs/zh-CN/reference/context-md.md index 349735ca8..67c9ea87c 100644 --- a/docs/zh-CN/reference/context-md.md +++ b/docs/zh-CN/reference/context-md.md @@ -14,7 +14,7 @@ 示例：`.planning/phases/03-post-feed/03-CONTEXT.md`。 -该文件由 `get-shit-done/workflows/discuss-phase.md` 中的 `write_context` 步骤生成（或通过 PRD/ADR 摄入快速路径生成）。在正常操作中，该文件不会被手动编辑——讨论阶段工作流负责写入，下游代理将其作为封闭的可信来源读取。 +该文件由 `gsd-core/workflows/discuss-phase.md` 中的 `write_context` 步骤生成（或通过 PRD/ADR 摄入快速路径生成）。在正常操作中，该文件不会被手动编辑——讨论阶段工作流负责写入，下游代理将其作为封闭的可信来源读取。 --- diff --git a/docs/zh-CN/reference/plan-md.md b/docs/zh-CN/reference/plan-md.md index 97643ce55..2bc8fe3d8 100644 --- a/docs/zh-CN/reference/plan-md.md +++ b/docs/zh-CN/reference/plan-md.md @@ -122,8 +122,8 @@ Output: PostFeed and PostCard components wired to /api/feed. ```xml -@~/.claude/get-shit-done/workflows/execute-plan.md -@~/.claude/get-shit-done/templates/summary.md +@~/.claude/gsd-core/workflows/execute-plan.md +@~/.claude/gsd-core/templates/summary.md ``` diff --git a/docs/zh-CN/reference/state-md.md b/docs/zh-CN/reference/state-md.md index b65b21be4..18562a16b 100644 --- a/docs/zh-CN/reference/state-md.md +++ b/docs/zh-CN/reference/state-md.md @@ -77,7 +77,7 @@ paused_at: null ### 状态值 -`get-shit-done/bin/lib/state-document.cjs` 中的 `normalizeStateStatus()` 将原始正文文本映射到以下规范值： +`gsd-core/bin/lib/state-document.cjs` 中的 `normalizeStateStatus()` 将原始正文文本映射到以下规范值： | 规范值 | 匹配文本（不区分大小写） | |---|---| @@ -133,7 +133,7 @@ paused_at: null ## Markdown 正文章节 -正文（结束 `---` 之后的所有内容）遵循 `get-shit-done/templates/state.md` 中的模板。标准章节为： +正文（结束 `---` 之后的所有内容）遵循 `gsd-core/templates/state.md` 中的模板。标准章节为： ### 项目参考 @@ -153,7 +153,7 @@ paused_at: null | `Last activity:` | 处理器写入时为 ISO 日期（`YYYY-MM-DD`）；执行器编写时为叙述性文本 | | `Progress:` | 可视化进度条，如 `[████░░░░░░] 40%` | -当现有值为已知模板默认值时，该章节中的 `Status:` 和 `Last activity:` 字段由 GSD 处理器更新（Knuth 不变式：执行器编写的值被保留）。已知处理器默认值的完整列表位于 `get-shit-done/bin/lib/state-document.cjs` 中的 `KNOWN_TEMPLATE_DEFAULTS`。 +当现有值为已知模板默认值时，该章节中的 `Status:` 和 `Last activity:` 字段由 GSD 处理器更新（Knuth 不变式：执行器编写的值被保留）。已知处理器默认值的完整列表位于 `gsd-core/bin/lib/state-document.cjs` 中的 `KNOWN_TEMPLATE_DEFAULTS`。 ### 性能指标 diff --git a/docs/zh-CN/references/model-profile-resolution.md b/docs/zh-CN/references/model-profile-resolution.md index 777a9a4b0..189f87ae7 100644 --- a/docs/zh-CN/references/model-profile-resolution.md +++ b/docs/zh-CN/references/model-profile-resolution.md @@ -12,7 +12,7 @@ MODEL_PROFILE=$(cat .planning/config.json 2>/dev/null | grep -o '"model_profile" ## 查找表 -@~/.claude/get-shit-done/references/model-profiles.md +@~/.claude/gsd-core/references/model-profiles.md 在表中查找已解析配置对应的代理。将 model 参数传递给 Task 调用： diff --git a/docs/zh-CN/references/phase-argument-parsing.md b/docs/zh-CN/references/phase-argument-parsing.md index 1434143bb..9472bbf04 100644 --- a/docs/zh-CN/references/phase-argument-parsing.md +++ b/docs/zh-CN/references/phase-argument-parsing.md @@ -14,7 +14,7 @@ `find-phase` 命令一步完成规范化和验证： ```bash -PHASE_INFO=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" find-phase "${PHASE}") +PHASE_INFO=$(node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" find-phase "${PHASE}") ``` 返回 JSON 包含： @@ -45,7 +45,7 @@ fi 使用 `roadmap get-phase` 验证阶段存在： ```bash -PHASE_CHECK=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" roadmap get-phase "${PHASE}") +PHASE_CHECK=$(node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" roadmap get-phase "${PHASE}") if [ "$(printf '%s\n' "$PHASE_CHECK" | jq -r '.found')" = "false" ]; then echo "ERROR: Phase ${PHASE} not found in roadmap" exit 1 @@ -57,5 +57,5 @@ fi 使用 `find-phase` 进行目录查找： ```bash -PHASE_DIR=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" find-phase "${PHASE}" --raw) +PHASE_DIR=$(node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" find-phase "${PHASE}" --raw) ``` \ No newline at end of file diff --git a/docs/zh-CN/references/verification-patterns.md b/docs/zh-CN/references/verification-patterns.md index cfeeb8dd0..d3987ecf1 100644 --- a/docs/zh-CN/references/verification-patterns.md +++ b/docs/zh-CN/references/verification-patterns.md @@ -600,7 +600,7 @@ check_substantive() { 关于自动化优先的检查点模式、服务器生命周期管理、CLI 安装处理和错误恢复协议，请参阅： -**@~/.claude/get-shit-done/references/checkpoints.md** → `` 部分 +**@~/.claude/gsd-core/references/checkpoints.md** → `` 部分 关键原则： - Claude 在呈现检查点**之前**设置验证环境