sddx-workflow 0.8.0 → 0.9.1

package/dist/cli.js

@@ -135,6 +135,20 @@ var PROVIDERS = {
       { src: "codex-skills/review/SKILL.md", dest: ".agents/skills/review/SKILL.md" },
       { src: "codex-skills/finish/SKILL.md", dest: ".agents/skills/finish/SKILL.md" }
     ]
+  },
+  gemini: {
+    name: "Gemini CLI",
+    dirs: [],
+    files: [
+      { src: "gemini.md", dest: "GEMINI.md" }
+    ]
+  },
+  zed: {
+    name: "Zed",
+    dirs: [],
+    files: [
+      { src: "zed-rules/sddx-workflow.md", dest: ".rules" }
+    ]
   }
 };
 var ALL_PROVIDER_IDS = Object.keys(PROVIDERS);
@@ -169,6 +183,7 @@ async function initCommand(options) {
     }
   }
   const claudeExisted = import_fs2.default.existsSync(import_path2.default.join(cwd, "CLAUDE.md"));
+  const geminiExisted = import_fs2.default.existsSync(import_path2.default.join(cwd, "GEMINI.md"));
   const agentsExisted = import_fs2.default.existsSync(import_path2.default.join(cwd, "AGENTS.md"));
   for (const file of CORE_FILES) {
     copyTemplate(file.src, import_path2.default.join(cwd, file.dest), force);
@@ -178,7 +193,6 @@ async function initCommand(options) {
       copyTemplate(file.src, import_path2.default.join(cwd, file.dest), force);
     }
   }
-  const providerNames = selectedProviders.map((id) => PROVIDERS[id].name).join(", ");
   console.log("");
   console.log("  Done. Next steps:");
   console.log("");
@@ -189,6 +203,13 @@ async function initCommand(options) {
   } else {
     console.log("  2. CLAUDE.md already exists \u2014 add a reference to .sdd/ files manually");
   }
+  if (selectedProviders.includes("gemini")) {
+    if (!geminiExisted) {
+      console.log("     GEMINI.md was created \u2014 Gemini CLI will read it automatically");
+    } else {
+      console.log("     GEMINI.md already exists \u2014 add a reference to .sdd/ files manually");
+    }
+  }
   if (selectedProviders.includes("codex")) {
     if (!agentsExisted) {
       console.log("     AGENTS.md was created \u2014 Codex will read it automatically");
@@ -196,8 +217,19 @@ async function initCommand(options) {
       console.log("     AGENTS.md already exists \u2014 add a reference to .sdd/ files manually");
     }
   }
-  console.log(`  3. Slash commands are ready in: ${providerNames}. Type / to see them.
-`);
+  const commandProviders = ["claude-code", "copilot", "codex"];
+  const withCommands = selectedProviders.filter((id) => commandProviders.includes(id));
+  const rulesOnly = selectedProviders.filter((id) => !commandProviders.includes(id));
+  if (withCommands.length > 0) {
+    const names = withCommands.map((id) => PROVIDERS[id].name).join(", ");
+    console.log(`  3. Slash commands ready in: ${names}. Type / to see them.`);
+  }
+  if (rulesOnly.length > 0) {
+    const names = rulesOnly.map((id) => PROVIDERS[id].name).join(", ");
+    const step = withCommands.length === 0 ? "3." : "   ";
+    console.log(`  ${step} Context rules installed for: ${names}. The agent reads workflow.md on every task.`);
+  }
+  console.log("");
 }
 
 // src/commands/add.ts
@@ -257,7 +289,8 @@ var WORKFLOW_FILES = [
   { src: "copilot-prompts/spec-tasks.prompt.md", dest: ".github/prompts/spec-tasks.prompt.md" },
   { src: "copilot-prompts/review.prompt.md", dest: ".github/prompts/review.prompt.md" },
   { src: "copilot-prompts/finish.prompt.md", dest: ".github/prompts/finish.prompt.md" },
-  { src: "copilot-instructions.md", dest: ".github/copilot-instructions.md" }
+  { src: "copilot-instructions.md", dest: ".github/copilot-instructions.md" },
+  { src: "zed-rules/sddx-workflow.md", dest: ".rules" }
 ];
 function updateCommand() {
   const cwd = process.cwd();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sddx-workflow",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "Spec-Driven Development CLI — installs an SDD system in any project",
   "keywords": [
     "sdd",

package/templates/gemini.md

@@ -0,0 +1,38 @@
+# Gemini — Project Context
+
+This project uses the SDD Protocol. Read these files before starting any task:
+
+1. **[.sdd/workflow.md](.sdd/workflow.md)** — commands, ceremony levels, and stop points
+2. **[.sdd/project-overview.md](.sdd/project-overview.md)** — what this app is, its non-goals, domains, and definition of done
+3. **[.sdd/conventions.md](.sdd/conventions.md)** — project-specific conventions and patterns
+
+## Quick Reference
+
+| Intent | Workflow |
+|---|---|
+| Initialize project context | `bootstrap` (new) · `bootstrap --scan` (existing) |
+| Explore / research | `ask` |
+| Surface and validate assumptions | `assume` |
+| Fix a confirmed bug | `bugfix` → `finish` |
+| Restructure without behavior change | `refactor` → `finish` |
+| New feature | `spec-new` → `spec-plan` → `spec-tasks` → `review` → `finish` |
+| Stage + commit after any work | `finish` |
+
+Invoke any workflow by name (e.g., "run bootstrap", "start spec-new for auth-refresh").
+Full definitions are in `.sdd/workflow.md`.
+
+## Active Specs
+
+<!-- List specs currently in progress — completed specs live in specs/_done/ and are not active context.
+- specs/auth-refresh/ — in spec-tasks (task 3 of 5)
+- specs/payments-v2/ — plan pending approval
+-->
+
+## Domain Files
+
+Relevant domain context lives in `.sdd/domains/`. Read the relevant domain file before working in that area.
+
+<!-- List domains present in this project, e.g.:
+- [.sdd/domains/auth.md](.sdd/domains/auth.md)
+- [.sdd/domains/payments.md](.sdd/domains/payments.md)
+-->

package/templates/specs/_template/1-requirements.md

@@ -1,5 +1,10 @@
 # Requirements: <Feature Name>
 
+> **Decisions and trade-offs only — no implementation.** Code snippets are allowed
+> only when they reduce ambiguity (e.g. a function signature, an example input/output,
+> a concrete error shape). If a snippet is doing anything more than that, it belongs
+> in `2-plan.md`, not here.
+
 ## Status
 
 - [ ] Draft
@@ -70,6 +75,24 @@ Scenario: <add one scenario per distinct behavior>
      Business:   "Must ship before the Q2 demo on May 15."
      UX:         "Must match the existing row layout in the info modal — no redesign." -->
 
+## Assumptions
+
+<!-- What this document is taking as given about users, business rules, or scope.
+     Different from Constraints (hard rules from outside) and Open Questions (unresolved).
+     Each assumption must be **falsifiable** — something the reader could correct.
+     Generic filler ("users want a good experience") is not an assumption.
+
+     Format: what + why we're assuming it + what changes if it's wrong.
+
+     Example:
+     1. **Users only need the most recent open timestamp, not a history.** — based on
+        the original feature request; nobody asked for history.
+        If wrong: the data model needs an access_log table, not a single column.
+
+     2. **"Opening" means clicking into the file viewer, not previewing in a list.** —
+        list previews are passive, not deliberate access.
+        If wrong: the trigger surface expands and we'd record many more events. -->
+
 ## Open Questions
 
 <!-- Mark each question by whether it blocks planning or can be decided during it.

package/templates/workflow.md

@@ -101,10 +101,10 @@ Rules:
 **Purpose:** Lightweight flow for confirmed bugs.
 
 Stages (in order, no skipping):
-1. **Reproduce** — confirm the bug with a test or minimal repro case
-2. **Diagnose** — identify root cause, not just symptoms; state any assumptions about the cause
-3. **Fix** — minimal targeted change; do not refactor surrounding code
-4. **Validate** — run tests, confirm the fix doesn't regress anything
+1. **Reproduce** — if the repo has a test suite, write a failing test that captures the bug before doing anything else. If no suite exists or a test is not feasible, document a deterministic minimal repro (exact steps, inputs, observed vs. expected output) and state explicitly why a test isn't viable. If the bug cannot be reproduced at all, STOP and report — do not guess at a fix.
+2. **Diagnose** — identify the root cause, not the symptom. State the root cause in one sentence before proposing any fix. If you cannot, run /assume and surface what's missing.
+3. **Fix** — the minimum change that addresses the stated root cause. Do not refactor surrounding code, rename adjacent symbols, tidy formatting, or fix unrelated issues you notice along the way (note them, don't fix them).
+4. **Validate** — the failing test from Reproduce now passes, and the full suite is green. If Reproduce used a manual repro, walk it again and confirm the original symptom is gone.
 
 Stop points:
 - After Reproduce: if unable to reproduce, STOP and report

package/templates/zed-rules/sddx-workflow.md

@@ -0,0 +1,23 @@
+This project uses the SDD Protocol. Before starting any task, read:
+
+1. `.sdd/workflow.md` — all commands, ceremony levels, and stop points
+2. `.sdd/project-overview.md` — what this app is, its non-goals, and domains
+3. `.sdd/conventions.md` — project-specific conventions and patterns
+
+## Workflows
+
+| Workflow | Purpose |
+|---|---|
+| `bootstrap` | Populate project context — interview or codebase scan |
+| `ask` | Research only — no code changes |
+| `assume` | List assumptions and stop for confirmation |
+| `bugfix` | Reproduce → diagnose → fix → validate |
+| `refactor` | Restructure without behavior change |
+| `spec-new` | Scaffold a spec folder |
+| `spec-plan` | Generate technical plan — stop for approval |
+| `spec-tasks` | Execute plan one task at a time, TDD-first |
+| `review` | Final audit before closing |
+| `finish` | Stage files and generate commit message |
+
+Invoke by name (e.g., "run bootstrap", "start spec-new for auth-refresh").
+Full definitions are in `.sdd/workflow.md`.