sdlc-workflow 1.0.1 → 1.0.2

package/README.md

@@ -1,6 +1,6 @@
 # sdlc-workflow
 
-Scaffold SDLC workflow docs and templates into your project. Works with **Cursor** and **Claude**.
+Scaffold SDLC workflow docs and templates into your project. Works with **Cursor**, **Claude**, **Antigravity**, and **Codex**.
 
 ## Flow
 
@@ -22,10 +22,17 @@ npx sdlc-workflow init
 
 This creates:
 
+**Project:**
 - `docs/sdlc/` — SDLC docs, templates, and phase folders
-- `.cursor/rules/sdlc-workflow.mdc` — Cursor rule for this project
-- `~/.cursor/skills/sdlc-workflow/` — Cursor skill (global, applies to all projects)
-- `.claude/CLAUDE.md` — Claude Code instructions (project-level)
+- `AGENTS.md` — Antigravity, Codex (universal project guidance)
+- `.agents/skills/sdlc-workflow/` — Codex repo skill
+- `.cursor/rules/sdlc-workflow.mdc` — Cursor rule
+- `.claude/CLAUDE.md` — Claude Code instructions
+
+**Global (user home):**
+- `~/.cursor/skills/sdlc-workflow/` — Cursor skill
+- `~/.codex/AGENTS.md` — Codex global instructions
+- `~/.agents/skills/sdlc-workflow/` — Codex global skill
 
 ## Generated Structure
 
@@ -58,16 +65,28 @@ docs/sdlc/
 
 .cursor/rules/
 └── sdlc-workflow.mdc         # Cursor rule
+
+AGENTS.md                     # Antigravity, Codex (universal)
+.agents/skills/sdlc-workflow/ # Codex repo skill
 ```
 
+## Use with Cursor
+
+The rule `.cursor/rules/sdlc-workflow.mdc` activates when working with `docs/sdlc/**` or `*.md`. Global skill: `~/.cursor/skills/sdlc-workflow/`.
+
 ## Use with Claude
 
-- **Claude Code** (project): `.claude/CLAUDE.md` is created by init — Claude loads it automatically when you open this project.
-- **Claude.ai** (web): Copy `docs/sdlc/SDLC-WORKFLOW.md` into Custom Instructions or @ mention it in chat.
+- **Claude Code** (project): `.claude/CLAUDE.md` — Claude loads it when you open this project.
+- **Claude.ai** (web): Copy `docs/sdlc/SDLC-WORKFLOW.md` into Custom Instructions or @ mention it.
 
-## Use with Cursor
+## Use with Antigravity
+
+`AGENTS.md` at project root — Antigravity reads it (priority: AGENTS.md → GEMINI.md). Universal format, works across agentic IDEs.
+
+## Use with Codex
 
-The rule `.cursor/rules/sdlc-workflow.mdc` activates when working with `docs/sdlc/**` or `*.md`.
+- **Project**: `AGENTS.md` + `.agents/skills/sdlc-workflow/`
+- **Global**: `~/.codex/AGENTS.md` + `~/.agents/skills/sdlc-workflow/`
 
 ## Release
 

package/bin/cli.js

@@ -18,7 +18,7 @@ async function main() {
   if (command !== "init") {
     console.log("Usage: npx sdlc-workflow init");
     console.log("  Scaffolds SDLC docs and templates into current project.");
-    console.log("  Installs Cursor skill (global) and Claude instructions (project).");
+    console.log("  Installs for: Cursor, Claude, Antigravity, Codex.");
     process.exit(1);
   }
 
@@ -29,9 +29,12 @@ async function main() {
     await scaffold(cwd);
     await installCursorSkill(home);
     await installClaudeSkill(cwd);
+    await installAgentsMd(cwd);
+    await installCodexSkill(home);
     console.log("\nDone.");
-    console.log("  - Project: docs/sdlc/, .cursor/rules/, .claude/");
-    console.log("  - Cursor skill: ~/.cursor/skills/sdlc-workflow/ (global)");
+    console.log("  - Project: docs/sdlc/, .cursor/rules/, .claude/, AGENTS.md, .agents/skills/");
+    console.log("  - Cursor: ~/.cursor/skills/sdlc-workflow/");
+    console.log("  - Codex: ~/.codex/AGENTS.md, ~/.agents/skills/sdlc-workflow/");
   } catch (err) {
     console.error("Error:", err.message);
     process.exit(1);
@@ -69,6 +72,57 @@ async function installClaudeSkill(cwd) {
   console.log("  + .claude/CLAUDE.md (Claude instructions)");
 }
 
+async function installAgentsMd(cwd) {
+  const agentsPath = join(cwd, "AGENTS.md");
+  const content = AGENTS_MD_CONTENT;
+  if (existsSync(agentsPath)) {
+    const existing = await readFile(agentsPath, "utf8");
+    if (existing.includes("## SDLC Workflow")) {
+      console.log("  + AGENTS.md (SDLC section already present)");
+      return;
+    }
+    await writeFile(agentsPath, existing.trimEnd() + "\n\n" + content, "utf8");
+  } else {
+    await writeFile(agentsPath, content, "utf8");
+  }
+  console.log("  + AGENTS.md (Antigravity, Codex project)");
+
+  const codexSkillDir = join(cwd, ".agents", "skills", "sdlc-workflow");
+  await mkdir(codexSkillDir, { recursive: true });
+  await writeFile(join(codexSkillDir, "SKILL.md"), CURSOR_SKILL_MD, "utf8");
+  await writeFile(join(codexSkillDir, "reference.md"), CURSOR_REFERENCE_MD, "utf8");
+  console.log("  + .agents/skills/sdlc-workflow/ (Codex repo skill)");
+}
+
+async function installCodexSkill(home) {
+  const codexDir = join(home, ".codex");
+  const codexAgentsPath = join(codexDir, "AGENTS.md");
+  const sdlcContent = CLAUDE_SDLC_CONTENT;
+  await mkdir(codexDir, { recursive: true });
+  if (existsSync(codexAgentsPath)) {
+    const existing = await readFile(codexAgentsPath, "utf8");
+    if (existing.includes("## SDLC Workflow")) {
+      console.log("  + ~/.codex/AGENTS.md (SDLC section already present)");
+    } else {
+      await writeFile(
+        codexAgentsPath,
+        existing.trimEnd() + "\n\n" + sdlcContent,
+        "utf8"
+      );
+      console.log("  + ~/.codex/AGENTS.md (Codex global)");
+    }
+  } else {
+    await writeFile(codexAgentsPath, sdlcContent, "utf8");
+    console.log("  + ~/.codex/AGENTS.md (Codex global)");
+  }
+
+  const agentsSkillDir = join(home, ".agents", "skills", "sdlc-workflow");
+  await mkdir(agentsSkillDir, { recursive: true });
+  await writeFile(join(agentsSkillDir, "SKILL.md"), CURSOR_SKILL_MD, "utf8");
+  await writeFile(join(agentsSkillDir, "reference.md"), CURSOR_REFERENCE_MD, "utf8");
+  console.log("  + ~/.agents/skills/sdlc-workflow/ (Codex global skill)");
+}
+
 async function scaffold(cwd) {
   const templates = join(TEMPLATES_DIR, "project");
   if (!existsSync(templates)) {
@@ -264,6 +318,23 @@ TC-001: [Scenario] — Precondition, Steps, Expected, Links to AC
 - Senior Dev (10+ yrs): implement, Unit Test ≥90% → docs/sdlc/dev/senior-developer/
 `;
 
+const AGENTS_MD_CONTENT = `## SDLC Workflow
+
+When working on requirements, features, or handoffs, follow these phases:
+
+1. **PO** — PRD, user stories → docs/sdlc/po/
+2. **Business BA** — FRS, process flows → docs/sdlc/ba/business/
+3. **Architect** — ADRs, diagrams → docs/sdlc/architecture/
+4. **Technical BA** — API specs, team breakdown → docs/sdlc/ba/technical/
+5. **QE (docs)** — Test plan, test cases → docs/sdlc/qe/
+6. **Dev** — After QE docs: Tech Lead (15+ yrs, tech stack, review & merge) + Senior Dev (10+ yrs, implement, Unit Test ≥90%) → docs/sdlc/dev/{role}/
+7. **QE (testing)** — After Dev unit tests: automation + manual, sign-off
+8. **Deploy** — Release, monitor
+
+Flow: ... → Technical BA → QE docs → Dev → QE testing → Deploy
+Ask "Which phase are we in?" if unclear.
+`;
+
 const CLAUDE_SDLC_CONTENT = `## SDLC Workflow
 
 1. **PO** — PRD, user stories → docs/sdlc/po/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdlc-workflow",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Scaffold SDLC workflow docs and templates for Cursor, Claude, and dev teams",
   "type": "module",
   "bin": {