@therocketcode/gsd-core 1.4.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,23 @@
+{
+  "name": "gsd-core",
+  "displayName": "GSD Core",
+  "version": "1.4.0",
+  "description": "GSD Core is a meta-prompting, context engineering, and spec-driven development system for AI coding agents.",
+  "author": {
+    "name": "TheRocketCodeMX",
+    "url": "https://github.com/TheRocketCodeMX"
+  },
+  "homepage": "https://github.com/TheRocketCodeMX/gsd-core",
+  "repository": "https://github.com/TheRocketCodeMX/gsd-core",
+  "license": "MIT",
+  "keywords": [
+    "spec-driven-development",
+    "planning",
+    "workflow",
+    "context-engineering",
+    "claude-code",
+    "gsd"
+  ],
+  "commands": "./commands/gsd/",
+  "hooks": "./hooks/hooks.json"
+}

package/GEMINI.md

@@ -0,0 +1,53 @@
+# GSD Core — Gemini CLI context
+
+This context is loaded by the **gsd-core Gemini CLI extension**. It gives Gemini
+the operating context for [GSD Core](https://github.com/TheRocketCodeMX/gsd-core), a
+meta-prompting, context-engineering, and spec-driven development system for AI
+coding agents.
+
+## What GSD is
+
+GSD turns a vague goal into shipped software through an explicit,
+resumable workflow: **explore → plan → execute → verify → ship**. Work is
+organised into milestones and phases under a `.planning/` directory, with each
+phase carrying a SPEC, a PLAN, and verification criteria. The system favours
+small, atomic, test-backed commits and keeps durable context in version-tracked
+files rather than in the conversation.
+
+## The slash commands (installed separately)
+
+> **This extension ships only the context above — not the slash commands.** It
+> loads gsd's operating context into your Gemini sessions and is managed through
+> `gemini extensions list / update / uninstall`. To install the `/gsd:*` command
+> set, agents, and hooks into `~/.gemini/`, run the dedicated installer:
+>
+> ```bash
+> npx gsd-core --gemini --global
+> ```
+>
+> The two paths are complementary and the manual installer remains fully
+> supported. The commands below are available only once that installer has run.
+
+If you have installed the gsd commands, the workflow is driven by these `/gsd:*`
+slash commands (Gemini registers gsd's commands under the `gsd` namespace, so the
+colon form is canonical):
+
+- `/gsd:new-project` — initialise a project and gather deep context.
+- `/gsd:progress` — the unified situational command: check progress, advance the
+  workflow, or dispatch a freeform intent.
+- `/gsd:plan-phase <N>` — produce a detailed phase plan with a verification loop.
+- `/gsd:execute-phase <N>` — execute a phase's plans with wave-based parallelism.
+- `/gsd:verify-work` — validate built features through conversational UAT.
+- `/gsd:ship` — open a PR, run review, and prepare for merge.
+- `/gsd:help` — list every available command.
+
+## Working with GSD
+
+- Treat `.planning/` as the source of truth for project state — read it before
+  acting, and keep it current as work progresses.
+- Prefer the smallest change that satisfies the phase's verification criteria.
+- Run the project's tests and linters before declaring a phase done.
+- When unsure what to do next, and the gsd commands are installed, `/gsd:progress`
+  is the situational entry point.
+
+Learn more: <https://github.com/TheRocketCodeMX/gsd-core>

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Lex Christopherson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja-JP.md

@@ -0,0 +1,125 @@
+<div align="center">
+
+# GSD Core
+
+**Git. Ship. Done.**
+
+[English](README.md) · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md) · **日本語** · [한국어](README.ko-KR.md)
+
+**Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf などに対応した、軽量なメタプロンプティング・コンテキストエンジニアリング・仕様駆動開発システムです。**
+
+[![npm version](https://img.shields.io/npm/v/%40opengsd%2Fgsd-core?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@therocketcode/gsd-core)
+[![npm downloads](https://img.shields.io/npm/dm/%40opengsd%2Fgsd-core?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@therocketcode/gsd-core)
+[![Tests](https://img.shields.io/github/actions/workflow/status/TheRocketCodeMX/gsd-core/test.yml?branch=main&style=for-the-badge&logo=github&label=Tests)](https://github.com/TheRocketCodeMX/gsd-core/actions/workflows/test.yml)
+[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/mYgfVNfA2r)
+[![GitHub stars](https://img.shields.io/github/stars/TheRocketCodeMX/gsd-core?style=for-the-badge&logo=github&color=181717)](https://github.com/TheRocketCodeMX/gsd-core)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
+
+</div>
+
+---
+
+## GSD Core とは
+
+GSD Core は、コンテキストエンジニアリングと仕様駆動開発のフレームワークです。AI コーディングエージェント（Claude Code、Codex、Gemini CLI、Copilot、Cursor など）を規律あるフェーズループで動かします。[コンテキストの腐敗](docs/ja-JP/explanation/context-engineering.md)—AI がコンテキストウィンドウを埋めるにつれて出力品質が低下する問題—を解決するために、重いリサーチ・計画・実行作業をすべて新鮮なコンテキストのサブエージェントで実行し、メインセッションをスリムに保ちます。
+
+---
+
+## 動作原理
+
+各マイルストーンは同じ 5 ステップのループを、1 フェーズずつ繰り返します。
+
+1. **Discuss（議論）** — 計画を立てる前に実装上の決定事項を記録する
+2. **Plan（計画）** — リサーチし、タスクを分解し、計画が新鮮なコンテキストウィンドウに収まることを確認する
+3. **Execute（実行）** — 並列ウェーブで計画を実行する。各エグゼキューターはクリーンな 200k トークンのコンテキストから開始する
+4. **Verify（検証）** — 構築されたものを確認し、完了を宣言する前に診断・修正する
+5. **Ship（出荷）** — PR を作成し、フェーズをアーカイブし、次のフェーズに進む
+
+---
+
+## クイックスタート
+
+```bash
+npx @therocketcode/gsd-core@latest
+```
+
+インストーラーはランタイム（Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf など）とグローバルインストールかローカルインストールかを尋ねます。クロスランタイム互換性のためにインストーラーが必要です。`agents/` や `commands/` からファイルを直接コピーしないでください。
+
+別のランタイムをお使いの場合や Node.js がない場合は [ランタイムへのインストール](docs/ja-JP/how-to/install-on-your-runtime.md) を参照してください。
+
+インストール後、最初のプロジェクトを開始します。
+
+```bash
+/gsd-new-project
+```
+
+初めての方は [はじめてのプロジェクト](docs/ja-JP/tutorials/your-first-project.md) で、インストールから最初のフェーズ出荷までのガイド付きチュートリアルをご覧ください。
+
+---
+
+## ドキュメント
+
+**チュートリアル** — 実践で学ぶ:
+- [はじめてのプロジェクト](docs/ja-JP/tutorials/your-first-project.md)
+- [既存コードベースのオンボーディング](docs/ja-JP/tutorials/onboarding-an-existing-codebase.md)
+
+**ハウツーガイド** — タスク別レシピ:
+- [ランタイムへのインストール](docs/ja-JP/how-to/install-on-your-runtime.md)
+- [フェーズを計画する](docs/ja-JP/how-to/plan-a-phase.md)
+- [検証と出荷](docs/ja-JP/how-to/verify-and-ship.md)
+- … [すべてのハウツーガイドを見る](docs/ja-JP/README.md#how-to-guides)
+
+**リファレンス** — 信頼できる情報:
+- [コマンド](docs/ja-JP/COMMANDS.md)
+- [設定](docs/ja-JP/CONFIGURATION.md)
+- [CLI ツール](docs/ja-JP/CLI-TOOLS.md)
+
+**解説** — コンセプトと設計上の決定:
+- [コンテキストエンジニアリング](docs/ja-JP/explanation/context-engineering.md)
+- [フェーズループ](docs/ja-JP/explanation/the-phase-loop.md)
+- [アーキテクチャ](docs/ja-JP/ARCHITECTURE.md)
+
+全インデックス: [docs/ja-JP/README.md](docs/ja-JP/README.md)。他の言語: [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md) · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md)。
+
+---
+
+## なぜ機能するのか
+
+多くの AI コーディング環境は、コンテキストの膨張が出力品質を静かに低下させ、セッション間に共有メモリがなく、コードが実際に動作するかを検証するものがないため、大規模では失敗します。GSD Core はこの 3 つすべてを解決します。重い作業は新鮮なサブエージェントで実行され、`STATE.md` や `CONTEXT.md` などの構造化アーティファクトがセッション境界を越えて保存され、検証ステップが構築されたものを確認してフェーズを完了と宣言する前に修正計画を生成します。詳細な理由については [docs/ja-JP/explanation/context-engineering.md](docs/ja-JP/explanation/context-engineering.md) を参照してください。
+
+トラブルシューティングは [docs/ja-JP/how-to/recover-and-troubleshoot.md](docs/ja-JP/how-to/recover-and-troubleshoot.md) を参照してください。
+
+---
+
+## コミュニティ
+
+| プロジェクト | プラットフォーム |
+|---------|----------|
+| [gsd-opencode](https://github.com/rokicool/gsd-opencode) | オリジナル OpenCode ポート |
+| [Discord](https://discord.gg/mYgfVNfA2r) | コミュニティサポート |
+
+---
+
+## スター履歴
+
+<a href="https://star-history.com/#TheRocketCodeMX/gsd-core&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=TheRocketCodeMX/gsd-core&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=TheRocketCodeMX/gsd-core&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=TheRocketCodeMX/gsd-core&type=Date" />
+ </picture>
+</a>
+
+---
+
+## ライセンス
+
+MIT ライセンス。詳細は [LICENSE](LICENSE) を参照してください。
+
+---
+
+<div align="center">
+
+**Claude Code は強力です。GSD Core はそれを信頼できるものにします。**
+
+</div>

package/README.ko-KR.md

@@ -0,0 +1,125 @@
+<div align="center">
+
+# GSD Core
+
+**Git. Ship. Done.**
+
+[English](README.md) · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · **한국어**
+
+**Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf 등을 위한 경량 메타 프롬프팅, 컨텍스트 엔지니어링, 스펙 기반 개발 시스템.**
+
+[![npm version](https://img.shields.io/npm/v/%40opengsd%2Fgsd-core?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@therocketcode/gsd-core)
+[![npm downloads](https://img.shields.io/npm/dm/%40opengsd%2Fgsd-core?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@therocketcode/gsd-core)
+[![Tests](https://img.shields.io/github/actions/workflow/status/TheRocketCodeMX/gsd-core/test.yml?branch=main&style=for-the-badge&logo=github&label=Tests)](https://github.com/TheRocketCodeMX/gsd-core/actions/workflows/test.yml)
+[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/mYgfVNfA2r)
+[![GitHub stars](https://img.shields.io/github/stars/TheRocketCodeMX/gsd-core?style=for-the-badge&logo=github&color=181717)](https://github.com/TheRocketCodeMX/gsd-core)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
+
+</div>
+
+---
+
+## GSD Core란
+
+GSD Core는 컨텍스트 엔지니어링 및 스펙 기반 개발 프레임워크로, AI 코딩 에이전트(Claude Code, Codex, Gemini CLI, Copilot, Cursor 등)를 엄격한 단계 루프로 운용합니다. AI가 컨텍스트 창을 채워 나가면서 발생하는 품질 저하인 [컨텍스트 rot](docs/ko-KR/explanation/context-engineering.md) 문제를 해결합니다. 무거운 리서치, 기획, 실행 작업은 새로운 컨텍스트의 서브에이전트에서 처리하고, 메인 세션은 가볍게 유지됩니다.
+
+---
+
+## 작동 방식
+
+각 마일스톤은 동일한 다섯 단계 루프를 반복합니다:
+
+1. **논의(Discuss)** — 기획 전에 구현 결정 사항을 미리 정리
+2. **기획(Plan)** — 리서치, 분해, 그리고 플랜이 새 컨텍스트 창에 맞는지 검증
+3. **실행(Execute)** — 병렬 웨이브로 플랜 실행; 각 실행기는 20만 토큰의 깨끗한 컨텍스트로 시작
+4. **검증(Verify)** — 구현 결과를 검토하고, 완료 선언 전 문제 진단 및 수정
+5. **출시(Ship)** — PR 생성, 단계 아카이브, 다음 단계 반복
+
+---
+
+## 빠른 시작
+
+```bash
+npx @therocketcode/gsd-core@latest
+```
+
+설치 프로그램이 런타임(Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf 등)과 전역/로컬 설치 여부를 묻습니다. 크로스 런타임 호환성을 위해 설치 프로그램을 사용해야 합니다 — `agents/` 또는 `commands/`에서 파일을 직접 복사하지 마세요.
+
+다른 런타임이나 Node.js가 없는 환경은 [런타임에 설치하기](docs/ko-KR/how-to/install-on-your-runtime.md)를 참조하세요.
+
+설치 후 첫 번째 프로젝트를 시작합니다:
+
+```bash
+/gsd-new-project
+```
+
+처음 사용하시나요? [첫 번째 프로젝트](docs/ko-KR/tutorials/your-first-project.md)를 따라 설치부터 첫 단계 출시까지 안내받으세요.
+
+---
+
+## 문서
+
+**튜토리얼** — 직접 해보며 배우기:
+- [첫 번째 프로젝트](docs/ko-KR/tutorials/your-first-project.md)
+- [기존 코드베이스 온보딩](docs/ko-KR/tutorials/onboarding-an-existing-codebase.md)
+
+**How-to 가이드** — 작업별 레시피:
+- [런타임에 설치하기](docs/ko-KR/how-to/install-on-your-runtime.md)
+- [단계 기획하기](docs/ko-KR/how-to/plan-a-phase.md)
+- [검증 및 출시](docs/ko-KR/how-to/verify-and-ship.md)
+- … [모든 how-to 가이드 보기](docs/ko-KR/README.md#how-to-guides)
+
+**레퍼런스** — 권위 있는 사실:
+- [명령어](docs/ko-KR/COMMANDS.md)
+- [설정](docs/ko-KR/CONFIGURATION.md)
+- [CLI 도구](docs/ko-KR/CLI-TOOLS.md)
+
+**설명** — 개념 및 설계 결정:
+- [컨텍스트 엔지니어링](docs/ko-KR/explanation/context-engineering.md)
+- [단계 루프](docs/ko-KR/explanation/the-phase-loop.md)
+- [아키텍처](docs/ko-KR/ARCHITECTURE.md)
+
+전체 색인: [docs/ko-KR/README.md](docs/ko-KR/README.md). 다른 언어: [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md) · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md).
+
+---
+
+## 왜 효과적인가
+
+대부분의 AI 코딩 환경은 규모가 커지면 실패합니다. 컨텍스트 비대화로 출력 품질이 조용히 저하되고, 세션 간 공유 메모리가 없으며, 코드가 실제로 동작하는지 검증하는 것이 없기 때문입니다. GSD Core는 이 세 가지를 모두 해결합니다. 무거운 작업은 새 서브에이전트에서 실행되고, `STATE.md`와 `CONTEXT.md` 같은 구조화된 아티팩트가 세션 경계를 넘어 유지되며, 검증 단계가 구현 결과를 검토하고 단계 완료 선언 전 수정 계획을 생성합니다. 자세한 내용은 [docs/ko-KR/explanation/context-engineering.md](docs/ko-KR/explanation/context-engineering.md)를 참조하세요.
+
+문제가 발생했나요? [docs/ko-KR/how-to/recover-and-troubleshoot.md](docs/ko-KR/how-to/recover-and-troubleshoot.md)를 확인하세요.
+
+---
+
+## 커뮤니티
+
+| 프로젝트 | 플랫폼 |
+|---------|----------|
+| [gsd-opencode](https://github.com/rokicool/gsd-opencode) | 최초 OpenCode 포트 |
+| [Discord](https://discord.gg/mYgfVNfA2r) | 커뮤니티 지원 |
+
+---
+
+## 스타 히스토리
+
+<a href="https://star-history.com/#TheRocketCodeMX/gsd-core&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=TheRocketCodeMX/gsd-core&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=TheRocketCodeMX/gsd-core&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=TheRocketCodeMX/gsd-core&type=Date" />
+ </picture>
+</a>
+
+---
+
+## 라이선스
+
+MIT 라이선스. 자세한 내용은 [LICENSE](LICENSE)를 참조하세요.
+
+---
+
+<div align="center">
+
+**Claude Code는 강력합니다. GSD Core가 그걸 신뢰할 수 있게 만듭니다.**
+
+</div>

package/README.md

@@ -0,0 +1,144 @@
+<div align="center">
+
+# GSD Core
+
+**Git. Ship. Done.**
+
+**English** · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md)
+
+**A light-weight meta-prompting, context engineering, and spec-driven development system for Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf, and more.**
+
+[![npm version](https://img.shields.io/npm/v/%40therocketcode%2Fgsd-core?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@therocketcode/gsd-core)
+[![npm downloads](https://img.shields.io/npm/dm/%40therocketcode%2Fgsd-core?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@therocketcode/gsd-core)
+[![Tests](https://img.shields.io/github/actions/workflow/status/TheRocketCodeMX/gsd-core/test.yml?branch=main&style=for-the-badge&logo=github&label=Tests)](https://github.com/TheRocketCodeMX/gsd-core/actions/workflows/test.yml)
+[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/mYgfVNfA2r)
+[![GitHub stars](https://img.shields.io/github/stars/TheRocketCodeMX/gsd-core?style=for-the-badge&logo=github&color=181717)](https://github.com/TheRocketCodeMX/gsd-core)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
+
+</div>
+
+---
+
+## What is GSD Core
+
+GSD Core is a context-engineering and spec-driven development framework that drives AI coding agents (Claude Code, Codex, Gemini CLI, Copilot, Cursor, and more) through a disciplined phase loop. It solves [context rot](docs/explanation/context-engineering.md) — the quality degradation that accumulates as an AI fills its context window — by running all heavy research, planning, and execution work in fresh-context subagents while keeping your main session lean.
+
+> **This is a fork** of [`open-gsd/gsd-core`](https://github.com/open-gsd/gsd-core) (MIT), maintained by TheRocketCode and published as **`@therocketcode/gsd-core`**. It keeps everything upstream offers and adds the greenfield **discovery** spine and **testing methodology** described below.
+
+---
+
+## What this fork adds
+
+On top of gsd-core's phase loop, this fork adds a connected **product → domain → architecture → tests** discovery spine, plus concrete test-infrastructure know-how.
+
+**Greenfield discovery — each step feeds the next:**
+
+- **`/gsd:discover-product`** — define *what to build and why*: real demand vs. interest, the narrowest wedge, the four product risks, outcome-framed → `PRODUCT-BRIEF.md`
+- **`/gsd:model-domain`** — lightweight DDD: ubiquitous language + core/supporting/generic subdomain distillation → `DOMAIN-MODEL.md`
+- **`/gsd:recommend-architecture`** — a two-axis recommendation (domain-logic ladder × deployment topology) that avoids over- *and* under-engineering, captured as an ADR → `ADR-NNNN.md`
+- **`/gsd:testing-strategy`** — derives the **test shape from the architecture** (rich core → unit tests; CRUD-over-DB → integration tests), with coverage-as-floor + mutation testing → `TEST-STRATEGY.md`
+
+**Testing know-how** the agent consults while writing tests: Testcontainers, parallel-safe DB isolation, authenticate-once / multi-role auth, synthetic test data, E2E tiering, and flaky-test avoidance.
+
+The payoff: **one complexity assessment** made during discovery parameterizes both the architecture *and* the test strategy — a single thread from "what are we building" to "how do we test it."
+
+---
+
+## How it works
+
+Each milestone repeats the same five-step loop, one phase at a time:
+
+1. **Discuss** — capture implementation decisions before anything is planned
+2. **Plan** — research, decompose, and verify the plan fits a fresh context window
+3. **Execute** — run plans in parallel waves; each executor starts with a clean 200k-token context
+4. **Verify** — walk through what was built; diagnose and fix before declaring done
+5. **Ship** — create the PR, archive the phase, repeat for the next one
+
+---
+
+## Quickstart
+
+```bash
+npx @therocketcode/gsd-core@latest
+```
+
+The installer prompts for your runtime (Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf, and more) and whether to install globally or locally. The installer is required for cross-runtime compatibility — do not copy files from `agents/` or `commands/` directly.
+
+On another runtime or without Node.js? See [Install on your runtime](docs/how-to/install-on-your-runtime.md).
+
+Once installed, start your first project:
+
+```bash
+/gsd-new-project
+```
+
+New here? Follow [Your first project](docs/tutorials/your-first-project.md) for a guided walkthrough from install to first shipped phase.
+
+---
+
+## Documentation
+
+**Tutorials** — learning by doing:
+- [Your first project](docs/tutorials/your-first-project.md)
+- [Onboarding an existing codebase](docs/tutorials/onboarding-an-existing-codebase.md)
+
+**How-to guides** — task-focused recipes:
+- [Install on your runtime](docs/how-to/install-on-your-runtime.md)
+- [Plan a phase](docs/how-to/plan-a-phase.md)
+- [Verify and ship](docs/how-to/verify-and-ship.md)
+- … [see all how-to guides](docs/README.md#how-to-guides)
+
+**Reference** — authoritative facts:
+- [Commands](docs/COMMANDS.md)
+- [Configuration](docs/CONFIGURATION.md)
+- [CLI tools](docs/CLI-TOOLS.md)
+
+**Explanation** — concepts and design decisions:
+- [Context engineering](docs/explanation/context-engineering.md)
+- [The phase loop](docs/explanation/the-phase-loop.md)
+- [Architecture](docs/ARCHITECTURE.md)
+
+Full index: [docs/README.md](docs/README.md). Other languages: [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md) · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md).
+
+---
+
+## Why it works
+
+Most AI-coding setups fail at scale because context bloat silently degrades output quality, there is no shared memory between sessions, and nothing verifies that code actually works. GSD Core solves all three: heavy work runs in fresh subagents, structured artifacts like `STATE.md` and `CONTEXT.md` survive session boundaries, and the verify step walks through what was built and generates fix plans before a phase is declared done. See [docs/explanation/context-engineering.md](docs/explanation/context-engineering.md) for the full reasoning.
+
+Troubleshooting? See [docs/how-to/recover-and-troubleshoot.md](docs/how-to/recover-and-troubleshoot.md).
+
+---
+
+## Community
+
+| Project | Platform |
+|---------|----------|
+| [gsd-opencode](https://github.com/rokicool/gsd-opencode) | Original OpenCode port |
+| [Discord](https://discord.gg/mYgfVNfA2r) | Community support |
+
+---
+
+## Star History
+
+<a href="https://star-history.com/#TheRocketCodeMX/gsd-core&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=TheRocketCodeMX/gsd-core&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=TheRocketCodeMX/gsd-core&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=TheRocketCodeMX/gsd-core&type=Date" />
+ </picture>
+</a>
+
+---
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+
+---
+
+<div align="center">
+
+**Claude Code is powerful. GSD Core makes it reliable.**
+
+</div>

package/README.pt-BR.md

@@ -0,0 +1,125 @@
+<div align="center">
+
+# GSD Core
+
+**Git. Ship. Done.**
+
+[English](README.md) · **Português** · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md)
+
+**Um sistema leve de meta-prompting, engenharia de contexto e desenvolvimento orientado a especificações para Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf e muito mais.**
+
+[![npm version](https://img.shields.io/npm/v/%40opengsd%2Fgsd-core?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@therocketcode/gsd-core)
+[![npm downloads](https://img.shields.io/npm/dm/%40opengsd%2Fgsd-core?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@therocketcode/gsd-core)
+[![Tests](https://img.shields.io/github/actions/workflow/status/TheRocketCodeMX/gsd-core/test.yml?branch=main&style=for-the-badge&logo=github&label=Tests)](https://github.com/TheRocketCodeMX/gsd-core/actions/workflows/test.yml)
+[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/mYgfVNfA2r)
+[![GitHub stars](https://img.shields.io/github/stars/TheRocketCodeMX/gsd-core?style=for-the-badge&logo=github&color=181717)](https://github.com/TheRocketCodeMX/gsd-core)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
+
+</div>
+
+---
+
+## O que é o GSD Core
+
+GSD Core é um framework de engenharia de contexto e desenvolvimento orientado a especificações que conduz agentes de codificação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor e mais) por meio de um ciclo de fases disciplinado. Ele resolve o [context rot](docs/pt-BR/explanation/context-engineering.md) — a degradação de qualidade que se acumula à medida que uma IA preenche sua janela de contexto — executando todo o trabalho pesado de pesquisa, planejamento e execução em subagentes com contexto limpo, mantendo sua sessão principal enxuta.
+
+---
+
+## Como funciona
+
+Cada marco repete o mesmo ciclo de cinco etapas, uma fase por vez:
+
+1. **Discuss** — capturar decisões de implementação antes de qualquer planejamento
+2. **Plan** — pesquisar, decompor e verificar se o plano cabe em uma janela de contexto limpa
+3. **Execute** — executar planos em ondas paralelas; cada executor começa com um contexto limpo de 200k tokens
+4. **Verify** — percorrer o que foi construído; diagnosticar e corrigir antes de declarar conclusão
+5. **Ship** — criar o PR, arquivar a fase e repetir para a próxima
+
+---
+
+## Início rápido
+
+```bash
+npx @therocketcode/gsd-core@latest
+```
+
+O instalador solicita seu ambiente de execução (Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf e mais) e se deseja instalar globalmente ou localmente. O instalador é necessário para compatibilidade entre runtimes — não copie arquivos diretamente de `agents/` ou `commands/`.
+
+Em outro runtime ou sem Node.js? Consulte [Instalar no seu runtime](docs/pt-BR/how-to/install-on-your-runtime.md).
+
+Após a instalação, inicie seu primeiro projeto:
+
+```bash
+/gsd-new-project
+```
+
+É a primeira vez? Siga [Seu primeiro projeto](docs/pt-BR/tutorials/your-first-project.md) para um passo a passo guiado, desde a instalação até a primeira fase entregue.
+
+---
+
+## Documentação
+
+**Tutoriais** — aprendendo na prática:
+- [Seu primeiro projeto](docs/pt-BR/tutorials/your-first-project.md)
+- [Integrar uma base de código existente](docs/pt-BR/tutorials/onboarding-an-existing-codebase.md)
+
+**Guias práticos** — receitas orientadas a tarefas:
+- [Instalar no seu runtime](docs/pt-BR/how-to/install-on-your-runtime.md)
+- [Planejar uma fase](docs/pt-BR/how-to/plan-a-phase.md)
+- [Verificar e entregar](docs/pt-BR/how-to/verify-and-ship.md)
+- … [ver todos os guias práticos](docs/pt-BR/README.md#how-to-guides)
+
+**Referência** — informações autoritativas:
+- [Comandos](docs/pt-BR/COMMANDS.md)
+- [Configuração](docs/pt-BR/CONFIGURATION.md)
+- [Ferramentas CLI](docs/pt-BR/CLI-TOOLS.md)
+
+**Explicação** — conceitos e decisões de design:
+- [Engenharia de contexto](docs/pt-BR/explanation/context-engineering.md)
+- [O ciclo de fases](docs/pt-BR/explanation/the-phase-loop.md)
+- [Arquitetura](docs/pt-BR/ARCHITECTURE.md)
+
+Índice completo: [docs/pt-BR/README.md](docs/pt-BR/README.md). Outros idiomas: [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md) · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md).
+
+---
+
+## Por que funciona
+
+A maioria das configurações de codificação com IA falha em escala porque o inchaço de contexto degrada silenciosamente a qualidade da saída, não há memória compartilhada entre sessões e nada verifica se o código realmente funciona. O GSD Core resolve os três problemas: o trabalho pesado é executado em subagentes com contexto limpo, artefatos estruturados como `STATE.md` e `CONTEXT.md` sobrevivem às fronteiras de sessão, e a etapa de verificação percorre o que foi construído e gera planos de correção antes de uma fase ser declarada concluída. Consulte [docs/pt-BR/explanation/context-engineering.md](docs/pt-BR/explanation/context-engineering.md) para o raciocínio completo.
+
+Problemas? Consulte [docs/pt-BR/how-to/recover-and-troubleshoot.md](docs/pt-BR/how-to/recover-and-troubleshoot.md).
+
+---
+
+## Comunidade
+
+| Projeto | Plataforma |
+|---------|----------|
+| [gsd-opencode](https://github.com/rokicool/gsd-opencode) | Port original para OpenCode |
+| [Discord](https://discord.gg/mYgfVNfA2r) | Suporte da comunidade |
+
+---
+
+## Histórico de estrelas
+
+<a href="https://star-history.com/#TheRocketCodeMX/gsd-core&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=TheRocketCodeMX/gsd-core&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=TheRocketCodeMX/gsd-core&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=TheRocketCodeMX/gsd-core&type=Date" />
+ </picture>
+</a>
+
+---
+
+## Licença
+
+Licença MIT. Consulte [LICENSE](LICENSE) para detalhes.
+
+---
+
+<div align="center">
+
+**Claude Code é poderoso. GSD Core o torna confiável.**
+
+</div>