sdlc-workflow 1.0.0 → 1.0.2

package/README.md

@@ -1,13 +1,17 @@
 # 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
 
 ```
-User Request → PO → Business BA → Architect → Technical BA → Dev Teams → QE → Deploy
+User Request → PO → Business BA → Architect → Technical BA → QE (docs) → Dev → QE (testing) → Deploy
 ```
 
+- **QE (docs)**: Test plan, test cases — before Dev implements
+- **Dev**: Tech Lead (review, merge) + Senior Dev (implement, Unit Test ≥90%)
+- **QE (testing)**: After Dev unit tests — automation + manual, sign-off
+
 ## Usage
 
 In your project directory:
@@ -18,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
 
@@ -43,22 +54,39 @@ docs/sdlc/
 ├── architecture/             # Architect
 │   ├── adr.template.md
 │   └── README.md
-└── qe/                       # QE
-    ├── test-case.template.md
-    └── README.md
+├── qe/                       # QE (docs + testing)
+│   ├── test-case.template.md
+│   └── README.md
+└── dev/                      # Dev team (per role)
+    ├── tech-lead/            # Tech Lead 15+ yrs: tech stack, review & merge
+    │   └── README.md
+    └── senior-developer/     # Senior Dev 10+ yrs: implement, Unit Test ≥90%
+        └── README.md
 
 .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)) {
@@ -95,6 +149,8 @@ async function generateFromInline(cwd) {
     join(base, "ba", "technical"),
     join(base, "architecture"),
     join(base, "qe"),
+    join(base, "dev", "tech-lead"),
+    join(base, "dev", "senior-developer"),
   ];
 
   for (const d of dirs) {
@@ -115,6 +171,8 @@ async function generateFromInline(cwd) {
     ["architecture/README.md", ARCH_README],
     ["qe/test-case.template.md", QE_TC_TEMPLATE],
     ["qe/README.md", QE_README],
+    ["dev/tech-lead/README.md", DEV_TECH_LEAD_README],
+    ["dev/senior-developer/README.md", DEV_SENIOR_README],
   ];
 
   for (const [rel, content] of files) {
@@ -125,21 +183,21 @@ async function generateFromInline(cwd) {
 }
 
 const CURSOR_RULE_CONTENT = `---
-description: SDLC multi-role workflow (PO → BA → Architect → Tech BA → Dev → QE)
+description: SDLC multi-role workflow (PO → BA → Architect → Tech BA → QE docs → Dev → QE testing)
 alwaysApply: false
 globs: docs/sdlc/**/*, **/*.md
 ---
 
 # SDLC Workflow
 
-When working on requirements or docs, follow the SDLC 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. **Dev Teams** — Implementation
-6. **QE** — Test plan, test cases → docs/sdlc/qe/
+5. **QE (docs)** — Test plan, test cases → docs/sdlc/qe/
+6. **Dev** — Tech Lead (review, merge) + Senior Dev (implement, ≥90% unit test) → docs/sdlc/dev/{role}/
+7. **QE (testing)** — Automation + manual tests, sign-off
+8. **Deploy** — Release, monitor
 
 Full workflow: docs/sdlc/SDLC-WORKFLOW.md
 `;
@@ -156,7 +214,7 @@ Sequential workflow for approaching user requirements. Each phase produces docs/
 ## Flow Overview
 
 \`\`\`
-User Request → PO → Business BA → Architect → Technical BA → Dev Teams → QE → Deploy
+User Request → PO → Business BA → Architect → Technical BA → QE (docs) → Dev → QE (testing) → Deploy
 \`\`\`
 
 **Determine current phase** before acting. If unsure, ask: "Which phase are we in?"
@@ -190,17 +248,30 @@ User Request → PO → Business BA → Architect → Technical BA → Dev Teams
 
 **Role**: Translate business + architecture into implementable specs.
 **Deliverables**: API specs, DB schema, team breakdown, acceptance criteria per ticket.
-**Output**: \`docs/sdlc/ba/technical/\` — **Handoff to Dev Teams.**
+**Output**: \`docs/sdlc/ba/technical/\` — **Handoff to QE + Dev.**
+
+## Phase 5a: QE (Docs phase)
 
-## Phase 5: Dev Teams
+**Role**: Create test plan, test cases before Dev implements.
+**Deliverables**: Test plan, test cases.
+**Output**: \`docs/sdlc/qe/\` — Ready for Dev to start implementation.
 
-**Role**: Implement. Backend | Frontend | Mobile | Data / DevOps.
-**Output**: Code + tests. **Handoff to QE.**
+## Phase 5b: Dev Teams
 
-## Phase 6: QE (Quality Engineering)
+**Trigger**: After QE docs complete. **Start implementation.**
 
-**Role**: Test against acceptance criteria; ensure quality.
-**Deliverables**: Test plan, test cases, sign-off.
+**Roles**:
+- **Tech Lead (15+ yrs)**: Decide tech stack, libraries; review & merge code. Docs: \`docs/sdlc/dev/tech-lead/\`
+- **Senior Developer (10+ yrs)**: Implement features per spec. Docs: \`docs/sdlc/dev/senior-developer/\`
+
+**Requirements**: Unit Test coverage **≥ 90%**.
+
+**Output**: Code + unit tests. **Handoff to QE (testing).**
+
+## Phase 6: QE (Testing phase)
+
+**Trigger**: After Dev completes unit tests.
+**Role**: Run tests, include **automation tests**, sign-off.
 **Output**: Test report. **Handoff to Deploy.**
 
 ## Phase 7: Deploy & Maintenance
@@ -216,8 +287,9 @@ User Request → PO → Business BA → Architect → Technical BA → Dev Teams
 | 2 | Business BA | FRS, process flows |
 | 3 | Architect | ADRs, system diagrams |
 | 4 | Technical BA | API specs, tech breakdown |
-| 5 | Dev Teams | Code, tests |
-| 6 | QE | Test plan, sign-off |
+| 5a | QE (docs) | Test plan, test cases |
+| 5b | Dev | Code, unit tests (≥90%) |
+| 6 | QE (testing) | Automation + manual, sign-off |
 | 7 | Ops | Deploy, monitor |
 
 See reference.md for templates.
@@ -240,9 +312,13 @@ POST /api/v1/[resource] — Purpose, Request, Response, Contract
 
 ## QE: Test Case
 TC-001: [Scenario] — Precondition, Steps, Expected, Links to AC
+
+## Dev Team
+- Tech Lead (15+ yrs): tech stack, libraries, review & merge → docs/sdlc/dev/tech-lead/
+- Senior Dev (10+ yrs): implement, Unit Test ≥90% → docs/sdlc/dev/senior-developer/
 `;
 
-const CLAUDE_SDLC_CONTENT = `## SDLC Workflow
+const AGENTS_MD_CONTENT = `## SDLC Workflow
 
 When working on requirements, features, or handoffs, follow these phases:
 
@@ -250,11 +326,27 @@ When working on requirements, features, or handoffs, follow these phases:
 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. **Dev Teams** — Implementation (Backend, Frontend, Mobile)
-6. **QE** — Test plan, test cases → docs/sdlc/qe/
-7. **Deploy** — Release, monitor
+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: User Request → PO → Business BA → Architect → Technical BA → Dev Teams → QE → Deploy
+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/
+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.
 `;
 
@@ -266,7 +358,7 @@ For Cursor, see .cursor/rules/sdlc-workflow.mdc
 ## Flow
 
 \`\`\`
-User Request → PO → Business BA → Architect → Technical BA → Dev Teams → QE → Deploy
+User Request → PO → Business BA → Architect → Technical BA → QE (docs) → Dev → QE (testing) → Deploy
 \`\`\`
 
 ## Phase Checklist
@@ -278,8 +370,9 @@ User Request → PO → Business BA → Architect → Technical BA → Dev Teams
 | 2 | Business BA | FRS, process flows |
 | 3 | Architect | ADRs, system diagrams |
 | 4 | Technical BA | API specs, tech breakdown |
-| 5 | Dev Teams | Code, tests |
-| 6 | QE | Test plan, sign-off |
+| 5a | QE (docs) | Test plan, test cases |
+| 5b | Dev | Code, unit tests (≥90%) |
+| 6 | QE (testing) | Automation + manual, sign-off |
 | 7 | Ops | Deploy, monitor |
 
 ## Phase Details
@@ -300,12 +393,22 @@ User Request → PO → Business BA → Architect → Technical BA → Dev Teams
 - API specs, DB schema, team breakdown
 - Output: \`docs/sdlc/ba/technical/\`
 
-### Phase 5: Dev Teams
-- Backend, Frontend, Mobile — implement per spec
-
-### Phase 6: QE
-- Test plan, test cases, sign-off
+### Phase 5a: QE (Docs)
+- Test plan, test cases — **before Dev implements**
 - Output: \`docs/sdlc/qe/\`
+- **Then**: Dev team starts implementation
+
+### Phase 5b: Dev Teams
+- **Tech Lead (15+ yrs)**: Tech stack, libraries; review & merge. Output: \`docs/sdlc/dev/tech-lead/\`
+- **Senior Developer (10+ yrs)**: Implement features. Output: \`docs/sdlc/dev/senior-developer/\`
+- **Requirement**: Unit Test coverage **≥ 90%**
+- **Then**: QE starts testing phase
+
+### Phase 6: QE (Testing)
+- After Dev unit tests complete: automation tests + manual tests, sign-off
+
+### Phase 7: Deploy
+- Release, monitor
 
 See [reference.md](./reference.md) for templates.
 `;
@@ -433,8 +536,31 @@ const QE_TC_TEMPLATE = `## TC-001: [Scenario]
 
 const QE_README = `# QE (Quality Engineering)
 
-Test plan, test cases, sign-off checklist.
+Two phases:
+1. **Docs phase** — Test plan, test cases (before Dev implements). Output ready for Dev team.
+2. **Testing phase** — After Dev completes unit tests: run tests, include automation tests, sign-off.
+
 Use test-case.template.md for test cases.
 `;
 
+const DEV_TECH_LEAD_README = `# Tech Lead (15+ years exp)
+
+**Responsibilities**:
+- Decide tech stack, frameworks, libraries
+- Review and merge code
+- Ensure architecture alignment
+
+**Docs**: ADRs, tech decisions, review checklist.
+`;
+
+const DEV_SENIOR_README = `# Senior Developer (10+ years exp)
+
+**Responsibilities**:
+- Implement features per Technical BA spec
+- Write code with Unit Test coverage **≥ 90%**
+- Follow Tech Lead's tech decisions
+
+**Docs**: Implementation notes, API usage.
+`;
+
 main();

package/package.json

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