@opengsd/gsd-core 1.4.0-rc.1 → 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": "open-gsd",
+    "url": "https://github.com/open-gsd"
+  },
+  "homepage": "https://github.com/open-gsd/gsd-core",
+  "repository": "https://github.com/open-gsd/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/open-gsd/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/open-gsd/gsd-core>

package/agents/gsd-ai-researcher.md

@@ -2,7 +2,7 @@
 name: gsd-ai-researcher
 description: Researches a chosen AI framework's official docs to produce implementation-ready guidance — best practices, syntax, core patterns, and pitfalls distilled for the specific use case. Writes the Framework Quick Reference and Implementation Guidance sections of AI-SPEC.md. Spawned by /gsd:ai-integration-phase orchestrator.
 tools: Read, Write, Edit, Bash, Grep, Glob, WebFetch, WebSearch, mcp__context7__*
-color: "#34D399"
+color: green
 # hooks:
 #   PostToolUse:
 #     - matcher: "Write|Edit"

package/agents/gsd-code-fixer.md

@@ -2,7 +2,7 @@
 name: gsd-code-fixer
 description: Applies fixes to code review findings from REVIEW.md. Reads source files, applies intelligent fixes, and commits each fix atomically. Spawned by /gsd:code-review --fix.
 tools: Read, Edit, Write, Bash, Grep, Glob
-color: "#10B981"
+color: green
 # hooks:
 #   - before_write
 ---

package/agents/gsd-code-reviewer.md

@@ -2,7 +2,7 @@
 name: gsd-code-reviewer
 description: Reviews source files for bugs, security issues, and code quality problems. Produces structured REVIEW.md with severity-classified findings. Spawned by /gsd:code-review.
 tools: Read, Write, Bash, Grep, Glob
-color: "#F59E0B"
+color: orange
 # hooks:
 #   - before_write
 ---

package/agents/gsd-domain-researcher.md

@@ -2,7 +2,7 @@
 name: gsd-domain-researcher
 description: Researches the business domain and real-world application context of the AI system being built. Surfaces domain expert evaluation criteria, industry-specific failure modes, regulatory context, and what "good" looks like for practitioners in this field — before the eval-planner turns it into measurable rubrics. Spawned by /gsd:ai-integration-phase orchestrator.
 tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*
-color: "#A78BFA"
+color: purple
 # hooks:
 #   PostToolUse:
 #     - matcher: "Write|Edit"

package/agents/gsd-eval-auditor.md

@@ -2,7 +2,7 @@
 name: gsd-eval-auditor
 description: Retroactive audit of an implemented AI phase's evaluation coverage. Checks implementation against the AI-SPEC.md evaluation plan. Scores each eval dimension as COVERED/PARTIAL/MISSING. Produces a scored EVAL-REVIEW.md with findings, gaps, and remediation guidance. Spawned by /gsd:eval-review orchestrator.
 tools: Read, Write, Bash, Grep, Glob
-color: "#EF4444"
+color: red
 # hooks:
 #   PostToolUse:
 #     - matcher: "Write|Edit"

package/agents/gsd-eval-planner.md

@@ -2,7 +2,7 @@
 name: gsd-eval-planner
 description: Designs a structured evaluation strategy for an AI phase. Identifies critical failure modes, selects eval dimensions with rubrics, recommends tooling, and specifies the reference dataset. Writes the Evaluation Strategy, Guardrails, and Production Monitoring sections of AI-SPEC.md. Spawned by /gsd:ai-integration-phase orchestrator.
 tools: Read, Write, Edit, Bash, Grep, Glob, AskUserQuestion
-color: "#F59E0B"
+color: orange
 # hooks:
 #   PostToolUse:
 #     - matcher: "Write|Edit"

package/agents/gsd-framework-selector.md

@@ -2,7 +2,7 @@
 name: gsd-framework-selector
 description: Presents an interactive decision matrix to surface the right AI/LLM framework for the user's specific use case. Produces a scored recommendation with rationale. Spawned by /gsd:ai-integration-phase and /gsd-select-framework orchestrators.
 tools: Read, Bash, Grep, Glob, WebSearch, AskUserQuestion
-color: "#38BDF8"
+color: cyan
 ---
 
 <role>

package/agents/gsd-nyquist-auditor.md

@@ -8,7 +8,7 @@ tools:
   - Bash
   - Glob
   - Grep
-color: "#8B5CF6"
+color: purple
 ---
 
 <role>

package/agents/gsd-pattern-mapper.md

@@ -2,7 +2,7 @@
 name: gsd-pattern-mapper
 description: Analyzes codebase for existing patterns and produces PATTERNS.md mapping new files to closest analogs. Read-only codebase analysis spawned by /gsd:plan-phase orchestrator before planning.
 tools: Read, Bash, Glob, Grep, Write
-color: magenta
+color: purple
 # hooks:
 #   PostToolUse:
 #     - matcher: "Write|Edit"

package/agents/gsd-security-auditor.md

@@ -8,7 +8,7 @@ tools:
   - Bash
   - Glob
   - Grep
-color: "#EF4444"
+color: red
 ---
 
 <role>

package/agents/gsd-ui-auditor.md

@@ -2,7 +2,7 @@
 name: gsd-ui-auditor
 description: Retroactive 6-pillar visual audit of implemented frontend code. Produces scored UI-REVIEW.md. Spawned by /gsd:ui-review orchestrator.
 tools: Read, Write, Bash, Grep, Glob
-color: "#F472B6"
+color: pink
 # hooks:
 #   PostToolUse:
 #     - matcher: "Write|Edit"

package/agents/gsd-ui-checker.md

@@ -2,7 +2,7 @@
 name: gsd-ui-checker
 description: Validates UI-SPEC.md design contracts against 6 quality dimensions. Produces BLOCK/FLAG/PASS verdicts. Spawned by /gsd:ui-phase orchestrator.
 tools: Read, Bash, Glob, Grep
-color: "#22D3EE"
+color: cyan
 ---
 
 <role>

package/agents/gsd-ui-researcher.md

@@ -2,7 +2,7 @@
 name: gsd-ui-researcher
 description: Produces UI-SPEC.md design contract for frontend phases. Reads upstream artifacts, detects design system state, asks only unanswered questions. Spawned by /gsd:ui-phase orchestrator.
 tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*, mcp__firecrawl__*, mcp__exa__*, mcp__tavily__*, mcp__ref__*, mcp__jina__*
-color: "#E879F9"
+color: purple
 # hooks:
 #   PostToolUse:
 #     - matcher: "Write|Edit"

package/agents/gsd-user-profiler.md

@@ -2,7 +2,7 @@
 name: gsd-user-profiler
 description: Analyzes extracted session messages across 8 behavioral dimensions to produce a scored developer profile with confidence levels and evidence. Spawned by profile orchestration workflows.
 tools: Read
-color: magenta
+color: purple
 ---
 
 <role>