From 61d185e654a4b70e90af64f058a482e91cf1b041 Mon Sep 17 00:00:00 2001 From: Tom Boucher Date: Sun, 31 May 2026 10:48:27 -0400 Subject: [PATCH 1/3] docs: promote README/branding fixes from next to main (#540) * fix(#526): include README assets in package (cherry picked from commit 9bee1cab7fba00a8c0dec32d286913d36615f5bd) * docs(#528): correct GSD Core tagline punctuation (cherry picked from commit 09cb6d79b2b3945ff83c8a7591f5f21752bb4c7e) * docs(#530): streamline README brand header (cherry picked from commit ec8a08f2d2ab184540731d135251e8145c7ea960) * docs(#532): remove README continuity section (cherry picked from commit 7eaa14f48f7e060b3c70152e6da3483deb833b8a) --------- Co-authored-by: Jeremy McSpadden --- README.ja-JP.md | 2 +- README.ko-KR.md | 2 +- README.md | 39 +------------------ README.pt-BR.md | 2 +- README.zh-CN.md | 2 +- assets/terminal.svg | 2 +- bin/install.js | 6 +-- docs/README.md | 2 +- docs/ja-JP/README.md | 2 +- docs/ko-KR/README.md | 2 +- docs/pt-BR/ARCHITECTURE.md | 2 +- docs/pt-BR/README.md | 2 +- docs/zh-CN/README.md | 2 +- get-shit-done/workflows/help/modes/default.md | 2 +- get-shit-done/workflows/help/modes/full.md | 2 +- package.json | 1 + 16 files changed, 18 insertions(+), 54 deletions(-) diff --git a/README.ja-JP.md b/README.ja-JP.md index b8fb22fcb..20dbfd071 100644 --- a/README.ja-JP.md +++ b/README.ja-JP.md @@ -4,7 +4,7 @@ # GSD Core -**Git Ship. Done.** +**Git. Ship. Done.** [English](README.md) · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md) · **日本語** diff --git a/README.ko-KR.md b/README.ko-KR.md index 2e8dc019e..15d0f26e7 100644 --- a/README.ko-KR.md +++ b/README.ko-KR.md @@ -4,7 +4,7 @@ # GSD Core -**Git Ship. Done.** +**Git. Ship. Done.** [English](README.md) · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · **한국어** diff --git a/README.md b/README.md index a53a4c87f..3d3944604 100644 --- a/README.md +++ b/README.md @@ -1,33 +1,8 @@ -> # Project Continuity Notice -> -> GSD Core is maintained by the **open-gsd** team at: -> **`open-gsd/gsd-core`** -> -> Use only these package names: -> -> - npm (main): `@opengsd/gsd-core` -> - npm (sdk): `@opengsd/gsd-sdk` -> -> The legacy upstream is outside open-gsd control. Based on public transition announcements and repository ownership reality, we strongly recommend removing legacy packages and migrating to `@opengsd/*`. -> -> Security status: -> -> - maintainers completed an internal security audit -> - maintainers report an independent review pass -> - no known active exploit was found in tracked source during those passes -> -> See: -> -> - continuity announcement: https://github.com/open-gsd/gsd-core/discussions/109 -> - audit transparency report: https://github.com/open-gsd/gsd-core/discussions/119 -> -> --- -
# GSD Core -**Git Ship. Done.** +**Git. Ship. Done.** **English** · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md) @@ -77,18 +52,6 @@ npx @opengsd/gsd-core@latest --- -## Why We Continue Building GSD Core - -GSD Core exists to help solo builders and small teams ship reliably with AI: clear specs, controlled context, and verification before release. - -In May 2026, maintainers published a continuity announcement and migrated active development to `open-gsd/gsd-core` after trust and ownership concerns around the former upstream, including a meme-coin rug-pull incident publicly associated with that ecosystem. - -The former creator and legacy lineage are no longer part of this program. This repository is the maintained continuation under open-gsd governance. - -The current team continues release operations, triage, and security hardening in public. Audit status and follow-up security work are documented in Discussion #119 and linked issues. - ---- - ## How It Works The loop is six commands. Each one does exactly one thing. diff --git a/README.pt-BR.md b/README.pt-BR.md index 9b6b00b32..787fb8cf3 100644 --- a/README.pt-BR.md +++ b/README.pt-BR.md @@ -4,7 +4,7 @@ # GSD Core -**Git Ship. Done.** +**Git. Ship. Done.** [English](README.md) · **Português** · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) diff --git a/README.zh-CN.md b/README.zh-CN.md index cbaa31242..8f81f35bd 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -4,7 +4,7 @@ # GSD Core -**Git Ship. Done.** +**Git. Ship. Done.** [English](README.md) · [Português](README.pt-BR.md) · **简体中文** · [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md) diff --git a/assets/terminal.svg b/assets/terminal.svg index b70f4f62c..6ec9c1da2 100644 --- a/assets/terminal.svg +++ b/assets/terminal.svg @@ -50,7 +50,7 @@ GSD Core v1.2.0 - Git Ship. Done. + Git. Ship. Done. Meta-prompting, context engineering, and spec-driven workflows. diff --git a/bin/install.js b/bin/install.js index 2ddb2609b..4be6edd57 100755 --- a/bin/install.js +++ b/bin/install.js @@ -614,7 +614,7 @@ const banner = '\n' + ' ╚═════╝ ╚══════╝╚═════╝' + reset + '\n' + '\n' + ' GSD Core ' + dim + 'v' + pkg.version + reset + '\n' + - ' Git Ship. Done.\n' + + ' Git. Ship. Done.\n' + ' A meta-prompting, context engineering and spec-driven\n' + ' development workflows for Claude Code, OpenCode, Gemini, Kilo, Codex, Copilot, Antigravity, Cursor, Windsurf, Augment, Trae, Qwen Code, Hermes Agent, Cline and CodeBuddy.\n'; @@ -6002,7 +6002,7 @@ function writeHermesCategoryDescription(categoryDir) { '---', 'name: gsd', `version: ${pkg.version}`, - 'description: GSD Core — Git Ship. Done. Disciplined planning, execution, and shipping workflows. Use any gsd-* skill in this category to drive a project through new-project → discuss-phase → plan-phase → execute-phase → ship.', + 'description: GSD Core — Git. Ship. Done. Disciplined planning, execution, and shipping workflows. Use any gsd-* skill in this category to drive a project through new-project → discuss-phase → plan-phase → execute-phase → ship.', '---', '', '# GSD Core', @@ -9548,7 +9548,7 @@ function install(isGlobal, runtime = 'claude', options = {}) { // Cline uses .clinerules — generate a rules file with GSD system instructions const clinerulesDest = path.join(targetDir, '.clinerules'); const clinerules = [ - '# GSD Core — Git Ship. Done.', + '# GSD Core — Git. Ship. Done.', '', '- GSD workflows live in `get-shit-done/workflows/`. Load the relevant workflow when', ' the user runs a `/gsd-*` command.', diff --git a/docs/README.md b/docs/README.md index 453badd6d..08305e29a 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,6 +1,6 @@ # GSD Core Documentation -Comprehensive documentation for GSD Core (Git Ship. Done.) — a meta-prompting, context engineering, and spec-driven development system for AI coding agents. +Comprehensive documentation for GSD Core (Git. Ship. Done.) — a meta-prompting, context engineering, and spec-driven development system for AI coding agents. Language versions: [English](README.md) · [Português (pt-BR)](pt-BR/README.md) · [日本語](ja-JP/README.md) · [简体中文](zh-CN/README.md) diff --git a/docs/ja-JP/README.md b/docs/ja-JP/README.md index dfae88ce4..18e05cab1 100644 --- a/docs/ja-JP/README.md +++ b/docs/ja-JP/README.md @@ -1,6 +1,6 @@ # GSD Core ドキュメント -GSD Core（Git Ship. Done.）の包括的なドキュメントです。GSD Core は、AI コーディングエージェント向けのメタプロンプティング、コンテキストエンジニアリング、仕様駆動開発システムです。 +GSD Core（Git. Ship. Done.）の包括的なドキュメントです。GSD Core は、AI コーディングエージェント向けのメタプロンプティング、コンテキストエンジニアリング、仕様駆動開発システムです。 ## ドキュメント一覧 diff --git a/docs/ko-KR/README.md b/docs/ko-KR/README.md index a190c5b19..65a0f716f 100644 --- a/docs/ko-KR/README.md +++ b/docs/ko-KR/README.md @@ -1,6 +1,6 @@ # GSD Core 문서 -GSD Core (Git Ship. Done.) 문서입니다. GSD Core는 AI 코딩 에이전트를 위한 메타 프롬프팅, 컨텍스트 엔지니어링, 스펙 기반 개발 시스템입니다. +GSD Core (Git. Ship. Done.) 문서입니다. GSD Core는 AI 코딩 에이전트를 위한 메타 프롬프팅, 컨텍스트 엔지니어링, 스펙 기반 개발 시스템입니다. 언어 버전: [English](README.md) · [Português (pt-BR)](pt-BR/README.md) · [日本語](ja-JP/README.md) · [简体中文](zh-CN/README.md) · [한국어](ko-KR/README.md) diff --git a/docs/pt-BR/ARCHITECTURE.md b/docs/pt-BR/ARCHITECTURE.md index 9c1273214..14cc3b78f 100644 --- a/docs/pt-BR/ARCHITECTURE.md +++ b/docs/pt-BR/ARCHITECTURE.md @@ -1,6 +1,6 @@ # Arquitetura do GSD Core -Visão arquitetural do GSD Core (Git Ship. Done.) em Português. +Visão arquitetural do GSD Core (Git. Ship. Done.) em Português. Para detalhes de implementação linha a linha, consulte [ARCHITECTURE.md em inglês](../ARCHITECTURE.md). --- diff --git a/docs/pt-BR/README.md b/docs/pt-BR/README.md index c24715b5a..0721e225d 100644 --- a/docs/pt-BR/README.md +++ b/docs/pt-BR/README.md @@ -1,6 +1,6 @@ # Documentação do GSD Core -Documentação abrangente do GSD Core (Git Ship. Done.) — um sistema de meta-prompting, engenharia de contexto e desenvolvimento orientado por especificações para agentes de IA. +Documentação abrangente do GSD Core (Git. Ship. Done.) — um sistema de meta-prompting, engenharia de contexto e desenvolvimento orientado por especificações para agentes de IA. ## Índice da documentação diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.md index a0e75ce8d..3742214c7 100644 --- a/docs/zh-CN/README.md +++ b/docs/zh-CN/README.md @@ -2,7 +2,7 @@ # GSD Core -**Git Ship. Done.** +**Git. Ship. Done.** **一个轻量级且强大的元提示、上下文工程和规格驱动开发系统，支持 Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf、Antigravity、Augment、Trae 和 Cline。** diff --git a/get-shit-done/workflows/help/modes/default.md b/get-shit-done/workflows/help/modes/default.md index a42ce0632..866f1d7dd 100644 --- a/get-shit-done/workflows/help/modes/default.md +++ b/get-shit-done/workflows/help/modes/default.md @@ -3,7 +3,7 @@ One-page newcomer-oriented tour of GSD Core. Output ONLY the `` conte -# GSD Core — Git Ship. Done. +# GSD Core — Git. Ship. Done. Plan-driven development for solo agentic work with Claude Code. GSD Core turns a vague idea into a hierarchical plan, then executes it phase by phase with state tracking and atomic commits. diff --git a/get-shit-done/workflows/help/modes/full.md b/get-shit-done/workflows/help/modes/full.md index b904d8565..f2158bc31 100644 --- a/get-shit-done/workflows/help/modes/full.md +++ b/get-shit-done/workflows/help/modes/full.md @@ -5,7 +5,7 @@ Display the complete GSD Core command reference. Output ONLY the reference conte # GSD Core Command Reference -**GSD Core** (Git Ship. Done.) creates hierarchical project plans optimized for solo agentic development with Claude Code. +**GSD Core** (Git. Ship. Done.) creates hierarchical project plans optimized for solo agentic development with Claude Code. ## Quick Start diff --git a/package.json b/package.json index a0c4db991..81acb962b 100644 --- a/package.json +++ b/package.json @@ -10,6 +10,7 @@ "bin", "commands", "get-shit-done", + "assets", "agents", "hooks", "scripts" From 9ee5631c06600df98b66aea2a4279ff5a707099b Mon Sep 17 00:00:00 2001 From: Jeremy McSpadden Date: Sun, 31 May 2026 10:31:26 -0500 Subject: [PATCH 2/3] docs(#542): align README version source of truth --- README.ja-JP.md | 5 ++--- README.ko-KR.md | 5 ++--- README.md | 6 +++--- README.pt-BR.md | 5 ++--- README.zh-CN.md | 5 ++--- docs/README.md | 10 ++++------ 6 files changed, 15 insertions(+), 21 deletions(-) diff --git a/README.ja-JP.md b/README.ja-JP.md index 20dbfd071..0a9a8683c 100644 --- a/README.ja-JP.md +++ b/README.ja-JP.md @@ -77,16 +77,15 @@ GSDはそれを解決します。Claude Codeを信頼性の高いものにする ビルトインの品質ゲートが本当の問題を検出します：スキーマドリフト検出はマイグレーション漏れのORM変更をフラグし、セキュリティ強制は検証を脅威モデルに紐付け、スコープ削減検出はプランナーが要件を暗黙的に落とすのを防止します。 -### v1.39.0 ハイライト +### 機能ハイライト -完全なリストは [v1.39.0 リリースノート](https://github.com/open-gsd/gsd-core/releases/tag/v1.39.0) を参照してください。 +正規のバージョンは npm に公開された `@opengsd/gsd-core` のバージョンと `package.json` です。`docs/` の古いリリースノートは継続性の履歴として残しているだけで、現在の GSD Core パッケージバージョンではありません。 - **`--minimal` インストールプロファイル** — エイリアス `--core-only`。メインループの6スキル（`new-project`、`discuss-phase`、`plan-phase`、`execute-phase`、`help`、`update`）のみをインストールし、`gsd-*` サブエージェントはゼロ。コールドスタート時のシステムプロンプトのオーバーヘッドを ~12kトークンから ~700トークンへ削減（≥94%減）。32K〜128Kコンテキストのローカル LLM やトークン課金 API に有効。 - **`/gsd-phase --edit`** — `ROADMAP.md` 上の既存フェーズの任意フィールドをその場で編集（番号や位置は変更されない）。`--force` で確認 diff をスキップ、`depends_on` の参照を検証し、書き込み時に `STATE.md` も更新。 - **マージ後ビルド & テストゲート** — `execute-phase` のステップ 5.6 が `workflow.build_command` の設定を自動検出し、無ければ Xcode（`.xcodeproj`）、Makefile、Justfile、Cargo、Go、Python、npm の順にフォールバック。Xcode/iOS プロジェクトでは `xcodebuild build` と `xcodebuild test` を自動実行。並列・直列両モードで動作。 - **ランタイム別レビューモデル選択** — `review.models.` で各外部レビュー CLI（codex、gemini など）が使うモデルをプランナー/実行プロファイルとは独立に指定可能。 - **ワークストリーム設定の継承** — `GSD_WORKSTREAM` が設定されている場合、ルートの `.planning/config.json` を先に読み込み、ワークストリーム設定をディープマージ（衝突時はワークストリーム側が優先）。ワークストリーム設定で明示的に `null` を指定するとルート値を上書き可能。 -- **手動カナリアリリースワークフロー** — `.github/workflows/canary.yml` が `workflow_dispatch` 経由で `dev` ブランチから `{base}-canary.{N}` ビルドを `@canary` dist-tag に手動公開（`@opengsd/gsd-core` と `@opengsd/gsd-sdk`）。 - **スキルの統合：86 → 59** — 4つの新しいグループ化スキル（`capture`、`phase`、`config`、`workspace`）が31のマイクロスキルを吸収。既存の親スキル6つはラップアップやサブ操作をフラグ化：`update --sync/--reapply`、`sketch --wrap-up`、`spike --wrap-up`、`map-codebase --fast/--query`、`code-review --fix`、`progress --do/--next`。機能の欠損なし。 --- diff --git a/README.ko-KR.md b/README.ko-KR.md index 15d0f26e7..3fc66d306 100644 --- a/README.ko-KR.md +++ b/README.ko-KR.md @@ -77,16 +77,15 @@ GSD가 그걸 고칩니다. Claude Code를 신뢰할 수 있게 만드는 컨텍 내장 품질 게이트가 실제 문제를 잡아냅니다: 스키마 드리프트 감지는 마이그레이션 누락된 ORM 변경을 플래그하고, 보안 강제는 검증을 위협 모델에 고정시키고, 스코프 축소 감지는 플래너가 요구사항을 몰래 빠뜨리는 걸 방지합니다. -### v1.39.0 하이라이트 +### 기능 하이라이트 -전체 목록은 [v1.39.0 릴리스 노트](https://github.com/open-gsd/gsd-core/releases/tag/v1.39.0)를 참고하세요. +정식 버전은 npm에 게시된 `@opengsd/gsd-core` 버전과 `package.json`을 기준으로 합니다. `docs/`의 예전 릴리스 노트는 연속성 기록으로만 보관되며, 현재 GSD Core 패키지 버전으로 사용하지 않습니다. - **`--minimal` 설치 프로파일** — 별칭 `--core-only`. 메인 루프 6개 스킬(`new-project`, `discuss-phase`, `plan-phase`, `execute-phase`, `help`, `update`)만 설치하고 `gsd-*` 서브에이전트는 설치하지 않음. 콜드 스타트 시스템 프롬프트 오버헤드를 ~12k 토큰에서 ~700 토큰으로 축소(≥94% 감소). 32K–128K 컨텍스트의 로컬 LLM이나 토큰 과금 API에 유용. - **`/gsd-phase --edit`** — `ROADMAP.md`에 있는 기존 단계의 임의 필드를 그 자리에서 수정(번호와 위치는 변경되지 않음). `--force`는 확인 diff를 건너뛰고, `depends_on` 참조를 검증하며 쓰기 시 `STATE.md`도 갱신. - **머지 후 빌드 & 테스트 게이트** — `execute-phase` 5.6 단계가 `workflow.build_command` 설정을 우선 자동 감지하고, 없으면 Xcode(`.xcodeproj`), Makefile, Justfile, Cargo, Go, Python, npm 순으로 폴백. Xcode/iOS 프로젝트는 `xcodebuild build` 및 `xcodebuild test`를 자동 실행. 병렬·직렬 모드 모두에서 동작. - **런타임별 리뷰 모델 선택** — `review.models.`로 각 외부 리뷰 CLI(codex, gemini 등)가 플래너/실행 프로파일과 독립적으로 자체 모델을 선택할 수 있음. - **워크스트림 설정 상속** — `GSD_WORKSTREAM`이 설정되면 루트 `.planning/config.json`을 먼저 로드한 뒤 워크스트림 설정을 딥 머지(충돌 시 워크스트림 우선). 워크스트림 설정에서 명시적 `null`은 루트 값을 덮어씀. -- **수동 카나리 릴리스 워크플로** — `.github/workflows/canary.yml`이 `workflow_dispatch`로 `dev` 브랜치에서 `{base}-canary.{N}` 빌드를 `@canary` dist-tag로 수동 게시(`@opengsd/gsd-core`와 `@opengsd/gsd-sdk`). - **스킬 통합: 86 → 59** — 4개의 새로운 그룹 스킬(`capture`, `phase`, `config`, `workspace`)이 31개의 마이크로 스킬을 흡수. 기존 6개의 부모 스킬은 래퍼업/하위 동작을 플래그로 흡수: `update --sync/--reapply`, `sketch --wrap-up`, `spike --wrap-up`, `map-codebase --fast/--query`, `code-review --fix`, `progress --do/--next`. 기능 손실 없음. --- diff --git a/README.md b/README.md index 3d3944604..0703f5440 100644 --- a/README.md +++ b/README.md @@ -48,7 +48,7 @@ npx @opengsd/gsd-core@latest > [!IMPORTANT] > **Returning to GSD Core?** > -> Run `/gsd-map-codebase` to re-index your codebase, then `/gsd-new-project` to rebuild GSD's planning context. Your code is fine — GSD just needs its context rebuilt. See the [CHANGELOG](CHANGELOG.md) for what's new. +> Run `/gsd-map-codebase` to re-index your codebase, then `/gsd-new-project` to rebuild GSD's planning context. Your code is fine — GSD just needs its context rebuilt. Use `@opengsd/gsd-core@latest` for the current package line. --- @@ -130,7 +130,7 @@ GSD Core is built for frictionless automation. Skip-permissions is how it's inte Install only the skills you need with `--profile=core` (six core-loop skills), `--profile=standard` (core + phase management), or the default full install. Profiles compose: `--profile=core,audit`. `--minimal` is an alias for `--profile=core`. See **[docs/USER-GUIDE.md](docs/USER-GUIDE.md)** for the full walkthrough, non-interactive install flags for all 15 runtimes, and permissions configuration. See [ADR-0011](docs/adr/0011-skill-surface-budget-module.md) for the profile model and runtime surface control. -Current release highlights are in [docs/RELEASE-v1.42.1.md](docs/RELEASE-v1.42.1.md): package legitimacy checks, safer installer migrations, runtime surface control, custom ship PR sections, reviewer defaults, fallow structural review, and quota-aware execution recovery. +The canonical release version is the `@opengsd/gsd-core` version published on npm and mirrored in `package.json`. Older release-note files under `docs/` are retained as legacy continuity notes; do not use archived release-note numbers as the current GSD Core package version. ### Cross-runtime compatibility: installer required @@ -208,7 +208,7 @@ For the full configuration reference — all settings, git branching strategies, | [Architecture](docs/ARCHITECTURE.md) | How the multi-agent orchestration works | | [CLI Tools](docs/CLI-TOOLS.md) | `gsd-sdk query` and programmatic SDK dispatch seams | | [Features](docs/FEATURES.md) | Complete feature index | -| [Changelog](CHANGELOG.md) | What changed in each release | +| [Changelog](CHANGELOG.md) | Release history, including archived legacy continuity notes | --- diff --git a/README.pt-BR.md b/README.pt-BR.md index 787fb8cf3..1ceb4037e 100644 --- a/README.pt-BR.md +++ b/README.pt-BR.md @@ -75,16 +75,15 @@ Para quem quer descrever o que precisa e receber isso construído do jeito certo Quality gates embutidos capturam problemas reais: detecção de schema drift sinaliza mudanças ORM sem migrations, segurança ancora verificação a modelos de ameaça, e detecção de redução de escopo impede o planner de descartar requisitos silenciosamente. -### Destaques v1.39.0 +### Destaques de recursos -Lista completa nas [notas de release v1.39.0](https://github.com/open-gsd/gsd-core/releases/tag/v1.39.0). +A versão canônica é a versão de `@opengsd/gsd-core` publicada no npm e espelhada em `package.json`. Arquivos antigos de release notes em `docs/` ficam apenas como histórico de continuidade; não use números arquivados como a versão atual do GSD Core. - **Perfil de instalação `--minimal`** — alias `--core-only`. Instala apenas os 6 skills do loop principal (`new-project`, `discuss-phase`, `plan-phase`, `execute-phase`, `help`, `update`) e nenhum subagente `gsd-*`. Reduz o overhead do system prompt no cold-start de ~12k para ~700 tokens (≥94% de redução). Útil para LLMs locais com contexto de 32K–128K e APIs cobradas por token. - **`/gsd-phase --edit`** — edita qualquer campo de uma fase existente em `ROADMAP.md` no lugar, sem alterar o número ou a posição. `--force` pula o diff de confirmação; referências em `depends_on` são validadas e o `STATE.md` é atualizado na escrita. - **Build & test gate pós-merge** — o passo 5.6 de `execute-phase` agora detecta automaticamente o comando de build em `workflow.build_command`, com fallback para Xcode (`.xcodeproj`), Makefile, Justfile, Cargo, Go, Python ou npm. Projetos Xcode/iOS rodam `xcodebuild build` e `xcodebuild test` automaticamente. Funciona em modo paralelo e serial. - **Modelo de review por runtime** — `review.models.` permite que cada CLI externa de review (codex, gemini, etc.) escolha seu próprio modelo, independente do perfil de planner/executor. - **Herança de configuração de workstream** — quando `GSD_WORKSTREAM` está definido, o `.planning/config.json` raiz é carregado primeiro e merge-deep com o config da workstream (workstream vence em conflito). Um `null` explícito no config da workstream sobrescreve corretamente o valor raiz. -- **Workflow manual de canary release** — `.github/workflows/canary.yml` publica builds `{base}-canary.{N}` de `@opengsd/gsd-core` e `@opengsd/gsd-sdk` na dist-tag `@canary` a partir de `dev`, sob demanda via `workflow_dispatch`. - **Consolidação de skills: 86 → 59** — 4 novos skills agrupados (`capture`, `phase`, `config`, `workspace`) absorvem 31 micro-skills. 6 skills pais existentes absorvem wrap-up e sub-operações como flags: `update --sync/--reapply`, `sketch --wrap-up`, `spike --wrap-up`, `map-codebase --fast/--query`, `code-review --fix`, `progress --do/--next`. Sem perda funcional. --- diff --git a/README.zh-CN.md b/README.zh-CN.md index 8f81f35bd..e106fb14d 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -75,16 +75,15 @@ GSD 解决的就是这个问题。它是让 Claude Code 变得可靠的上下文 适合那些想把自己的需求说明白，然后让系统正确构建出来的人，而不是假装自己在运营一个 50 人工程组织的人。 -### v1.39.0 亮点 +### 功能亮点 -完整列表请参阅 [v1.39.0 发行说明](https://github.com/open-gsd/gsd-core/releases/tag/v1.39.0)。 +规范版本以 npm 上发布的 `@opengsd/gsd-core` 版本以及 `package.json` 为准。`docs/` 中旧的发行说明文件仅作为连续性历史保留；不要把归档编号当作当前 GSD Core 包版本。 - **`--minimal` 安装档** — 别名 `--core-only`。仅安装主循环的 6 个核心技能（`new-project`、`discuss-phase`、`plan-phase`、`execute-phase`、`help`、`update`），不安装任何 `gsd-*` 子代理。将冷启动系统提示开销从 ~12k token 降至 ~700 token（≥94% 减少）。适合 32K–128K 上下文的本地 LLM 和按 token 计费的 API。 - **`/gsd-phase --edit`** — 就地修改 `ROADMAP.md` 中已有阶段的任意字段，不改变其编号或位置。`--force` 跳过确认 diff，验证 `depends_on` 引用，并在写入时更新 `STATE.md`。 - **合并后构建与测试门** — `execute-phase` 步骤 5.6 优先自动检测 `workflow.build_command` 配置，否则按 Xcode（`.xcodeproj`）、Makefile、Justfile、Cargo、Go、Python、npm 顺序回退。Xcode/iOS 项目自动运行 `xcodebuild build` 和 `xcodebuild test`。在并行与串行模式下均生效。 - **每运行时评审模型选择** — `review.models.` 让每个外部评审 CLI（codex、gemini 等）独立于规划/执行档选择自己的模型。 - **工作流设置继承** — 设置 `GSD_WORKSTREAM` 后，先加载根 `.planning/config.json`，再与该工作流的配置进行深合并（冲突时工作流优先）。工作流配置中显式 `null` 会覆盖根值。 -- **手动 canary 发布工作流** — `.github/workflows/canary.yml` 通过 `workflow_dispatch` 从 `dev` 分支按需将 `{base}-canary.{N}` 构建（`@opengsd/gsd-core` 与 `@opengsd/gsd-sdk`）发布到 `@canary` dist-tag。 - **技能整合：86 → 59** — 4 个新分组技能（`capture`、`phase`、`config`、`workspace`）吸收了 31 个微技能。6 个已有父技能将收尾与子操作合并为标志：`update --sync/--reapply`、`sketch --wrap-up`、`spike --wrap-up`、`map-codebase --fast/--query`、`code-review --fix`、`progress --do/--next`。功能无损失。 --- diff --git a/docs/README.md b/docs/README.md index 08305e29a..e005bcc84 100644 --- a/docs/README.md +++ b/docs/README.md @@ -10,9 +10,7 @@ Language versions: [English](README.md) · [Português (pt-BR)](pt-BR/README.md) |----------|----------|-------------| | [Architecture](ARCHITECTURE.md) | Contributors, advanced users | System architecture, agent model, data flow, and internal design | | [Installer Migrations](installer-migrations.md) | Contributors | Architecture for safe install-time migrations, cleanup, preservation, dry-run planning, and rollback | -| [Feature Reference](FEATURES.md) | All users | Feature narratives and requirements for released features (see [CHANGELOG](../CHANGELOG.md) for latest additions) | -| [v1.42.3 Release Notes](RELEASE-v1.42.3.md) | All users | Hotfix release notes for 1.42.3 — Codex CLI 0.130.0 install routability and 11 other fixes | -| [v1.42.1 Release Notes](RELEASE-v1.42.1.md) | All users | Stable release notes for the 1.42.1 release | +| [Feature Reference](FEATURES.md) | All users | Feature narratives and requirements for released features | | [Command Reference](COMMANDS.md) | All users | Stable commands with syntax, flags, options, and examples | | [Configuration Reference](CONFIGURATION.md) | All users | Full config schema, workflow toggles, model profiles, git branching | | [Custom PR Body Sections](ship-pr-body-sections.md) | All users | How to append project-specific PRD sections to `/gsd-ship` PR bodies | @@ -23,12 +21,12 @@ Language versions: [English](README.md) · [Português (pt-BR)](pt-BR/README.md) | [Issue-Driven Orchestration](issue-driven-orchestration.md) | All users | Recipe for driving GSD from a tracker issue (GitHub / Linear / Jira) using existing primitives — no new commands or daemon | | [Context Monitor](context-monitor.md) | All users | Context window monitoring hook architecture | | [Discuss Mode](workflow-discuss-mode.md) | All users | Assumptions vs interview mode for discuss-phase | -| [Canary Stream](CANARY.md) | Contributors, early adopters | `dev` → `@canary` dist-tag policy, when to install, rollback path | +| [Canary Stream](CANARY.md) | Maintainers | Archived stream notes; current public npm tags are `latest` and `next` | ## Quick Links -- **What's new:** see [v1.42.3 Release Notes](RELEASE-v1.42.3.md) (latest hotfix), [v1.42.1 Release Notes](RELEASE-v1.42.1.md), [CHANGELOG](../CHANGELOG.md), and upstream [README](../README.md) for release highlights -- **Canary preview:** [`docs/CANARY.md`](CANARY.md) — opt into the early-preview stream from `dev`. Active cut: [`v1.50.0-canary.1`](RELEASE-v1.50.0-canary.1.md) +- **What's new:** install `@opengsd/gsd-core@latest` and use the npm/package version as the current source of truth; older release-note files are archived continuity notes +- **Preview streams:** current public npm tags are `latest` and `next`; older canary notes are archived in [Canary Stream](CANARY.md) - **Getting started:** [README](../README.md) → install → `/gsd-new-project` - **Full workflow walkthrough:** [User Guide](USER-GUIDE.md) - **All commands at a glance:** [Command Reference](COMMANDS.md) From 75e3fa79fb095deb422bbf0c3b541b23e6e50a32 Mon Sep 17 00:00:00 2001 From: Jeremy McSpadden Date: Sun, 31 May 2026 10:56:48 -0500 Subject: [PATCH 3/3] docs(#546): update changelog for 1.2.0 --- .changeset/546-changelog-1-2-0.md | 5 ++++ CHANGELOG.md | 38 ++++++++++++++++++++++++++++--- 2 files changed, 40 insertions(+), 3 deletions(-) create mode 100644 .changeset/546-changelog-1-2-0.md diff --git a/.changeset/546-changelog-1-2-0.md b/.changeset/546-changelog-1-2-0.md new file mode 100644 index 000000000..7e4ecc5b9 --- /dev/null +++ b/.changeset/546-changelog-1-2-0.md @@ -0,0 +1,5 @@ +--- +type: Fixed +pr: 547 +--- +**Changelog now reflects the current `@opengsd/gsd-core@1.2.0` release line** — the visible top section documents the current package version and features, while the old `get-shit-done-redux` version stream is marked as legacy history. diff --git a/CHANGELOG.md b/CHANGELOG.md index 91c7c1c18..0b27a6495 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,7 +4,39 @@ All notable changes to GSD will be documented in this file. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). -## [Unreleased](https://github.com/open-gsd/get-shit-done-redux/compare/v1.42.1...HEAD) +## [Unreleased] + +### Fixed + +- **README version guidance now uses npm/package metadata as the source of truth** — README, localized READMEs, and the docs index no longer present archived release-note or canary-stream numbers as the current GSD Core package version. (#545) + +## [1.2.0](https://www.npmjs.com/package/@opengsd/gsd-core/v/1.2.0) - 2026-05-31 + +`1.2.0` is the current stable `@opengsd/gsd-core` release. It resumes the public package line after the release-version validation recovery documented in [ADR 218](docs/adr/218-release-version-validation.md) and makes `@opengsd/gsd-core` / `gsd-core` the canonical package and CLI identity. + +### Added + +- **Plan-vs-codebase drift guard** — plan review can verify generated plans against live source symbols before execution so hallucinated files, APIs, or commands are caught earlier. (#487) +- **Single Package Identity seam** — package name, CLI identity, update checks, and installer identity are centralized so `@opengsd/gsd-core` stays consistent across runtime surfaces. (#499, #517, #521) +- **Cross-provider effort controls and fast-mode-aware routing** — model-effort selection works across providers and can adjust routing for faster workflows. (#463) +- **Current public docs and install identity** — README/docs now advertise GSD Core, `@opengsd/gsd-core`, and the `gsd-core` binary as the canonical user-facing surface. (#519, #523, #540) + +### Changed + +- **SDK shim retired from installer/runtime docs** — workflows now route through `gsd-tools`; dead SDK-shim verification and stale SDK-generated banners were removed. (#522, #515, #510) +- **Release numbering recovered at `1.2.0`** — leading-zero release inputs are invalid and duplicate-version checks fail early before publish work begins. See [ADR 218](docs/adr/218-release-version-validation.md). +- **CI/test selection is more precise** — affected-test selection now widens docs/test-impact correctly and avoids under-testing relevant PRs. (#495) + +### Fixed + +- **Planning writes are more reliable** — phase completion writes are transactional and no longer corrupt milestone progress counters. (#465, #514) +- **Roadmap and milestone parsing no longer leak stale phase details into active milestone state.** (#513) +- **`/gsd:update` detects local Antigravity `.agent` installs and repo-local Claude installs correctly.** (#512, #476) +- **Package identity registration no longer regresses update/runtime detection.** (#521) + +## Legacy Release History + +The entries below were carried forward from the pre-`@opengsd/gsd-core` package lineage for continuity. They are archived history, not the current package version line; the legacy archive may reuse version numbers that now belong to `@opengsd/gsd-core`. ## [1.42.1](https://github.com/open-gsd/get-shit-done-redux/compare/v1.41.0...v1.42.1) - 2026-05-15 @@ -2633,7 +2665,7 @@ Technical implementation details for Phase 2 appear in the **Changed** section b - AskUserQuestion restored for decision gate in questioning flow -## [1.2.0](https://github.com/open-gsd/get-shit-done-redux/releases/tag/v1.2.0) - 2025-12-15 +## [1.2.0 legacy](https://github.com/open-gsd/get-shit-done-redux/releases/tag/v1.2.0) - 2025-12-15 ### Changed @@ -2748,7 +2780,7 @@ Technical implementation details for Phase 2 appear in the **Changed** section b - YOLO mode for autonomous execution - Interactive mode with checkpoints -[Unreleased]: https://github.com/open-gsd/get-shit-done-redux/compare/v1.42.1...HEAD +[Unreleased]: https://github.com/open-gsd/gsd-core/compare/main...HEAD [1.42.1]: https://github.com/open-gsd/get-shit-done-redux/compare/v1.41.0...v1.42.1 [1.38.4]: https://github.com/open-gsd/get-shit-done-redux/compare/v1.38.2...v1.38.4 [1.38.2]: https://github.com/open-gsd/get-shit-done-redux/compare/v1.37.1...v1.38.2