sddx-workflow 0.7.0 → 0.8.0

package/dist/cli.js

@@ -107,6 +107,34 @@ 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" }
+    ]
   }
 };
 var ALL_PROVIDER_IDS = Object.keys(PROVIDERS);
@@ -141,6 +169,7 @@ async function initCommand(options) {
     }
   }
   const claudeExisted = import_fs2.default.existsSync(import_path2.default.join(cwd, "CLAUDE.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);
   }
@@ -160,6 +189,13 @@ async function initCommand(options) {
   } else {
     console.log("  2. CLAUDE.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");
+    }
+  }
   console.log(`  3. Slash commands are ready in: ${providerNames}. Type / to see them.
 `);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sddx-workflow",
-  "version": "0.7.0",
+  "version": "0.8.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.