sddx-workflow 0.7.0 → 0.9.0

package/dist/cli.js

@@ -107,6 +107,48 @@ var PROVIDERS = {
       { src: "copilot-prompts/finish.prompt.md", dest: ".github/prompts/finish.prompt.md" },
       { src: "copilot-instructions.md", dest: ".github/copilot-instructions.md" }
     ]
+  },
+  codex: {
+    name: "OpenAI Codex",
+    dirs: [
+      ".agents/skills/bootstrap",
+      ".agents/skills/ask",
+      ".agents/skills/assume",
+      ".agents/skills/bugfix",
+      ".agents/skills/refactor",
+      ".agents/skills/spec-new",
+      ".agents/skills/spec-plan",
+      ".agents/skills/spec-tasks",
+      ".agents/skills/review",
+      ".agents/skills/finish"
+    ],
+    files: [
+      { src: "AGENTS.md", dest: "AGENTS.md" },
+      { src: "codex-skills/bootstrap/SKILL.md", dest: ".agents/skills/bootstrap/SKILL.md" },
+      { src: "codex-skills/ask/SKILL.md", dest: ".agents/skills/ask/SKILL.md" },
+      { src: "codex-skills/assume/SKILL.md", dest: ".agents/skills/assume/SKILL.md" },
+      { src: "codex-skills/bugfix/SKILL.md", dest: ".agents/skills/bugfix/SKILL.md" },
+      { src: "codex-skills/refactor/SKILL.md", dest: ".agents/skills/refactor/SKILL.md" },
+      { src: "codex-skills/spec-new/SKILL.md", dest: ".agents/skills/spec-new/SKILL.md" },
+      { src: "codex-skills/spec-plan/SKILL.md", dest: ".agents/skills/spec-plan/SKILL.md" },
+      { src: "codex-skills/spec-tasks/SKILL.md", dest: ".agents/skills/spec-tasks/SKILL.md" },
+      { 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);
@@ -141,6 +183,8 @@ 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);
   }
@@ -149,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("");
@@ -160,8 +203,33 @@ async function initCommand(options) {
   } else {
     console.log("  2. CLAUDE.md already exists \u2014 add a reference to .sdd/ files manually");
   }
-  console.log(`  3. Slash commands are ready in: ${providerNames}. Type / to see them.
-`);
+  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");
+    } else {
+      console.log("     AGENTS.md already exists \u2014 add a reference to .sdd/ files manually");
+    }
+  }
+  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
@@ -221,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.7.0",
+  "version": "0.9.0",
   "description": "Spec-Driven Development CLI — installs an SDD system in any project",
   "keywords": [
     "sdd",

package/templates/AGENTS.md

@@ -0,0 +1,37 @@
+# Codex — 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
+
+## Available Skills
+
+Type `/skills` or `$skill-name` to invoke. Skills are defined in `.agents/skills/`.
+
+| Intent | Skill |
+|---|---|
+| 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` |
+
+## 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/codex-skills/ask/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: ask
+description: Research and exploration only — no code changes. Use when understanding a system, gathering context, analyzing options, or investigating a bug without touching files.
+---
+
+Execute the /ask command defined in .sdd/workflow.md.
+
+Research and exploration only — no code changes. Read files, analyze, and summarize findings with explicit options or recommendations.

package/templates/codex-skills/assume/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: assume
+description: Surface all assumptions before acting on a task. Use before spec-plan, before complex diagnosis, or any time an unstated guess is being made about requirements or codebase state.
+---
+
+Execute the /assume command defined in .sdd/workflow.md.
+
+List every assumption being made about the task, codebase state, and technical decisions.
+For each: what you're assuming, why, and what changes if it's wrong.
+Stop and wait for confirmation before proceeding.

package/templates/codex-skills/bootstrap/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: bootstrap
+description: Populate .sdd/project-overview.md and .sdd/conventions.md with real project context. Use when initializing a new project or onboarding to an existing codebase.
+---
+
+Execute the /bootstrap command defined in .sdd/workflow.md.
+
+Populate .sdd/project-overview.md and .sdd/conventions.md with real project context.
+If the request contains --scan, analyze the existing codebase first before asking questions.
+Present the full draft for approval before writing any file.

package/templates/codex-skills/bugfix/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: bugfix
+description: Lightweight flow for confirmed bugs. Use when fixing a known bug that fits within ~1 file or ~50 lines. Follows Reproduce → Diagnose → Fix → Validate stages.
+---
+
+Execute the /bugfix command defined in .sdd/workflow.md.
+
+Follow the stages in order: Reproduce → Diagnose → Fix → Validate.
+Do not skip stages. Stop after Reproduce if the bug cannot be confirmed.

package/templates/codex-skills/finish/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: finish
+description: Stage changed files and produce a conventional commit message for approval. Use after completing any unit of work — bug fix, refactor, or feature tasks.
+---
+
+Execute the /finish command defined in .sdd/workflow.md.
+
+Run git status and git diff. Stage all relevant files. Determine the commit type.
+Draft a conventional commit message following the format in workflow.md.
+Stop and present the staged files and commit message for approval before committing.

package/templates/codex-skills/refactor/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: refactor
+description: Restructure code without changing external behavior. Use when cleaning up internals while keeping all observable behavior identical. Requires a green test baseline first.
+---
+
+Execute the /refactor command defined in .sdd/workflow.md.
+
+Restructure code without changing external behavior. Establish a green test baseline first.
+Every observable behavior before the refactor must be identical after it.

package/templates/codex-skills/review/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: review
+description: Final audit before closing a spec or merging. Use after all spec tasks are complete to verify goals are met, tests pass, and no scope creep was introduced.
+---
+
+Execute the /review command defined in .sdd/workflow.md.
+
+Audit the spec before closing. Verify all goals (G1, G2…) are satisfied, every acceptance scenario has a passing test, no out-of-scope changes were introduced, and the implementation is the simplest that meets requirements.

package/templates/codex-skills/spec-new/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: spec-new
+description: Scaffold a spec folder for a new feature or significant change. Use at the start of any feature work to create the requirements, plan, and tasks files.
+---
+
+Execute the /spec-new command defined in .sdd/workflow.md.
+
+Create a specs/<name>/ folder by copying the three template files from specs/_template/.
+Replace <Feature Name> in each file title with the actual feature name.

package/templates/codex-skills/spec-plan/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: spec-plan
+description: Generate a technical plan from an approved requirements doc. Use after filling out 1-requirements.md. Stops for explicit approval before any code is written.
+---
+
+Execute the /spec-plan command defined in .sdd/workflow.md.
+
+Read specs/<name>/1-requirements.md, run /assume, then draft the technical plan in specs/<name>/2-plan.md.
+Stop for explicit approval before writing any implementation code.

package/templates/codex-skills/spec-tasks/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: spec-tasks
+description: Execute an approved technical plan as atomic tasks, one at a time. Use after spec-plan is approved. Follows TDD: write test first (red), implement until green, run full suite.
+---
+
+Execute the /spec-tasks command defined in .sdd/workflow.md.
+
+Read the approved specs/<name>/2-plan.md and execute tasks one at a time.
+Write the test first (red), implement until green, run the full suite, then move to the next task.
+Stop if tests fail or if a task reveals new scope.

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/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`.