ma-agents 3.4.8 → 3.5.0

package/_bmad-output/implementation-artifacts/done/15-2-restructure-extension-module.md

@@ -0,0 +1,174 @@
+# Story 15.2: Restructure Extension Module for 6.2.0 Conventions
+
+Status: done
+
+## Story
+
+As a **Chief Architect**,
+I want the extension module restructured to follow the BMAD 6.2.0 module pattern (verified from CIS module source),
+So that `--custom-content` deployment works correctly and the module integrates natively with BMAD's module system.
+
+## Acceptance Criteria
+
+1. `lib/bmad-extension/module.yaml` contains `code: ma-skills`, `name`, `description`, and `extends-module: bmm`
+2. `--custom-content lib/bmad-extension/` passes bmad-method 6.2.1's validation (requires `module.yaml` with `code` field)
+3. `lib/bmad-extension/skills/` directory is created as the root for all skill folders
+4. `lib/bmad-extension/module-help.csv` is updated to register all 36 skills (4 agents + 32 workflows)
+5. Old `lib/bmad-extension/agents/` and `lib/bmad-extension/workflows/` directories are NOT removed yet (Stories 15.3-15.6 need them)
+6. Content from old directories is migrated into `skills/` in subsequent stories (15.3-15.5) — this story creates the scaffolding only
+
+## Tasks / Subtasks
+
+- [x] Task 1: Update module.yaml (AC: #1, #2)
+  - [x] 1.1 Update `lib/bmad-extension/module.yaml` to add `code: ma-skills` field
+  - [x] 1.2 Update `name` to `"MA-Agents Skills & Agents"`
+  - [x] 1.3 Update `description` to `"Enterprise methodology enforcement, specialized agents, and operational workflows"`
+  - [x] 1.4 Keep `extends-module: bmm`
+  - [x] 1.5 Add `default_selected: false`
+  - [x] 1.6 Verify `--custom-content lib/bmad-extension/` passes 6.2.1 validation (verified: `code` field present, matching CIS module pattern from bmad-cache)
+
+- [x] Task 2: Create skills directory structure (AC: #3)
+  - [x] 2.1 Create `lib/bmad-extension/skills/` directory
+  - [x] 2.2 Create placeholder directories for all 36 actual skill folders (not 42 as architecture claimed):
+    - Agent skills (4): `bmad-ma-agent-sre/`, `bmad-ma-agent-devops/`, `bmad-ma-agent-cyber/`, `bmad-ma-agent-mil498/`
+    - MIL-498 skills (7): `mil498-sss/`, `mil498-ssdd/`, `mil498-ocd/`, `mil498-sdp/`, `mil498-srs/`, `mil498-sdd/`, `mil498-std/`
+    - SRE skills (7): `sre-check-deployment-status/`, `sre-check-secrets/`, `sre-check-system-status/`, `sre-day-2-ops/`, `sre-deployment-strategies/`, `sre-fix-deployments/`, `sre-gitops-status/`
+    - DevOps skills (5): `devops-configure-infrastructure/`, `devops-disconnected-deployment/`, `devops-docker-compose-setup/`, `devops-manage-helm/`, `devops-sign-docker-image/`
+    - Cyber skills (7): `cyber-generate-certs/`, `cyber-immunity-estimation/`, `cyber-security-audit/`, `cyber-vault-secrets/`, `cyber-verify-docker-users/`, `cyber-verify-image-signature/`, `cyber-vulnerability-scan/`
+    - Extension workflows (6): `create-bug-story/`, `add-sprint/`, `modify-sprint/`, `add-to-sprint/`, `project-context-expansion/`, `sprint-status-view/`
+
+- [x] Task 3: Update module-help.csv (AC: #4)
+  - [x] 3.1 Read existing `lib/bmad-extension/module-help.csv` to understand current format
+  - [x] 3.2 Rewrite to list all 36 actual skills with type, trigger, and descriptions
+  - [x] 3.3 Ensure CSV format matches bmad-method module-help.csv convention (verified against CIS and BMB modules in bmad-cache)
+
+- [x] Task 4: Preserve old directories (AC: #5, #6)
+  - [x] 4.1 Verified `lib/bmad-extension/agents/` preserved in place (12 customize.yaml files)
+  - [x] 4.2 Verified `lib/bmad-extension/workflows/` preserved in place (6 workflow subdirs)
+  - [x] 4.3 Old directories NOT removed — required as source material for Stories 15.3-15.6
+
+## Dev Notes
+
+### Critical: Do NOT Delete Source Material
+
+Stories 15.3-15.6 need the CURRENT content from `agents/` and `workflows/` as source material for conversion. This story creates the NEW structure but must preserve the old files for the conversion stories. Options:
+1. **Recommended:** Create `skills/` alongside existing `agents/` and `workflows/`, then remove old dirs only after 15.3-15.6 complete
+2. **Alternative:** Git history preserves old content, so conversion stories can reference specific commits
+
+### Current module.yaml (to be replaced)
+
+```yaml
+extends-module: bmm
+name: ma-agents-skills
+description: MA-Agents skill enforcement extension for BMM agents
+```
+
+### Target module.yaml (per architecture P2-9)
+
+```yaml
+code: ma-skills
+name: "MA-Agents Skills & Agents"
+description: "Enterprise methodology enforcement, specialized agents, and operational workflows"
+extends-module: bmm
+default_selected: false
+```
+
+### Current Extension Module Structure
+
+```
+lib/bmad-extension/
+├── module.yaml
+├── module-help.csv
+├── agents/           <- 12 .customize.yaml files (4 custom + 8 built-in)
+└── workflows/        <- 6 workflow.md files
+```
+
+### Target Extension Module Structure (after Epic 15 complete)
+
+```
+lib/bmad-extension/
+├── module.yaml       <- code: ma-skills
+├── module-help.csv   <- 36 skills registered
+└── skills/           <- 36 skill folders
+    ├── bmad-ma-agent-sre/
+    ├── bmad-ma-agent-devops/
+    ├── bmad-ma-agent-cyber/
+    ├── bmad-ma-agent-mil498/
+    ├── mil498-sss/ through mil498-std/ (7 skills)
+    ├── sre-*/ (7 skills)
+    ├── devops-*/ (5 skills)
+    ├── cyber-*/ (7 skills)
+    └── extension workflow skills (6 skills)
+```
+
+### Skill Count Reconciliation
+
+Architecture says 42 skills (4+11+9+6+8+4). Actual count from codebase:
+- 4 custom agents: SRE, DevOps, Cyber, MIL-498
+- 7 MIL-498 workflows (only 7 exist in `lib/bmad-workflows/mil498/`: sss, ssdd, ocd, sdp, srs, sdd, std) -- epics list 11 (adding str, idd, irs, hrs). **Verify which actually exist before creating placeholders.**
+- 7 SRE workflows (from `lib/bmad-workflows/sre/`) -- epics say 9 but only 7 exist (no health-check or performance-opt workflow files, though agent menu references them)
+- 5 DevOps workflows (from `lib/bmad-workflows/devops/`) -- epics say 6. **No optimize-pipelines file exists** (though agent menu references it)
+- 7 Cyber workflows (from `lib/bmad-workflows/cyber/`) -- epics say 8. **No threat-modeling file exists** (though agent menu references it)
+- 6 extension workflows (from `lib/bmad-extension/workflows/`)
+
+**CRITICAL: Count the ACTUAL files, not what the epics claim. Create skill folders only for workflows that actually exist. Note discrepancies in completion notes.**
+
+### Architecture Compliance
+
+- Module MUST have `code` field for `--custom-content` deployment [P2-9]
+- `extends-module: bmm` is retained [P2-9]
+- All skills go under `skills/` directory [CIS module pattern]
+- `module-help.csv` must register all skills [P2-9]
+
+### Files to Touch
+
+| File | Change |
+|------|--------|
+| `lib/bmad-extension/module.yaml` | Add `code: ma-skills`, update name/description |
+| `lib/bmad-extension/module-help.csv` | Rewrite with 36 skill entries |
+| `lib/bmad-extension/skills/` | Create directory + all skill subdirectories |
+| `lib/bmad-extension/agents/` | Preserve content, plan for removal |
+| `lib/bmad-extension/workflows/` | Preserve content, plan for removal |
+
+### References
+
+- [Source: _bmad-output/planning-artifacts/architecture.md -- P2-9, extension module structure]
+- [Source: _bmad-output/planning-artifacts/epics.md -- Story 15.2]
+- [Source: lib/bmad-extension/module.yaml -- current state]
+- [Source: lib/bmad-extension/module-help.csv -- current format]
+
+## Dev Agent Record
+
+### Agent Model Used
+Claude Opus 4.6 (1M context)
+
+### Debug Log References
+None required -- all tests pass on first run.
+
+### Completion Notes List
+1. **Skill count discrepancy:** Architecture/epics claimed 42 skills, actual codebase has 36. Missing from codebase:
+   - MIL-498: str, idd, irs, hrs (4 planned but not yet created)
+   - SRE: health-check, performance-opt (referenced in agent menu but no workflow files exist)
+   - DevOps: optimize-pipelines (referenced in agent menu but no workflow file exists)
+   - Cyber: threat-modeling (referenced in agent menu but no workflow file exists)
+   Total missing: 6 skills = 42 planned - 36 actual
+2. **Old directories preserved:** `agents/` and `workflows/` directories left intact for Stories 15.3-15.6 to use as source material during conversion.
+3. **CSV format:** Aligned with CIS/BMB module-help.csv conventions from bmad-cache (module,phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs).
+4. **module.yaml validated:** Structure matches CIS module pattern from bmad-cache (`code`, `name`, `description`, `default_selected` fields confirmed).
+5. **Test coverage:** 31 tests in `test/extension-module-restructure.test.js` covering all 4 tasks and acceptance criteria.
+
+### File List
+| File | Action |
+|------|--------|
+| `lib/bmad-extension/module.yaml` | Modified -- added code, updated name/description, added default_selected |
+| `lib/bmad-extension/module-help.csv` | Modified -- rewritten with 36 skill entries in BMAD module format |
+| `lib/bmad-extension/skills/` | Created -- 36 subdirectories with .gitkeep files |
+| `test/extension-module-restructure.test.js` | Created -- 31 tests for module restructure validation |
+| `package.json` | Modified -- added extension-module-restructure test to test script |
+| `_bmad-output/implementation-artifacts/15-2-restructure-extension-module.md` | Modified -- updated status, tasks, dev agent record |
+
+## Change Log
+
+| Date | Change | Author |
+|------|--------|--------|
+| 2026-03-27 | Initial implementation: module.yaml updated, skills/ scaffolding created (36 dirs), module-help.csv rewritten, 31 tests added | Claude Opus 4.6 |

package/_bmad-output/implementation-artifacts/done/15-3-convert-custom-agents-to-skill-folders.md

@@ -0,0 +1,183 @@
+# Story 15.3: Convert 4 Custom Agents to Skill Folders
+
+Status: done
+
+## Story
+
+As a **Chief Architect**,
+I want the 4 custom agents (SRE, DevOps, Cyber, MIL-498) converted from `.customize.yaml` files to BMAD 6.2.0 agent skill folders,
+So that they are delivered as native module agents following the verified CIS pattern.
+
+## Acceptance Criteria
+
+1. Each custom agent has a skill folder at `lib/bmad-extension/skills/bmad-ma-agent-{role}/` containing `SKILL.md` and `bmad-skill-manifest.yaml`
+2. Each `SKILL.md` contains the complete agent definition: persona, menu items with trigger phrases, activation sequence, and critical_actions
+3. Each `bmad-skill-manifest.yaml` has `type: agent`, `name`, `displayName`, `role`, `identity`, `communicationStyle`, `principles`, `module: ma-skills`
+4. SRE agent (Alex) SKILL.md contains all 9 menu items referencing SRE workflow skills by new skill names (e.g., `sre-health-check`)
+5. Same complete conversion for DevOps (Amit), Cyber (Yael), and MIL-498 (Joseph)
+6. Deployed agents behave identically to pre-conversion: same persona, same menu, same workflows (NFR30)
+
+## Tasks / Subtasks
+
+- [x] Task 1: Consolidate SRE agent source material (AC: #1, #2, #4)
+  - [x] 1.1 Read `lib/bmad-customizations/bmm-sre.customize.yaml` (base config)
+  - [x] 1.2 Read `lib/bmad-extension/agents/bmm-sre.customize.yaml` (extended config with critical_actions)
+  - [x] 1.3 Read `lib/bmad-customizations/sre.md` (full agent persona/menu XML definition)
+  - [x] 1.4 Merge all three sources into unified agent definition
+  - [x] 1.5 Create `lib/bmad-extension/skills/bmad-ma-agent-sre/SKILL.md` with complete definition
+  - [x] 1.6 Create `lib/bmad-extension/skills/bmad-ma-agent-sre/bmad-skill-manifest.yaml`
+  - [x] 1.7 Update menu item references from old workflow paths to new skill names (e.g., `sre-health-check`, `sre-fix-deployments`, etc.)
+
+- [x] Task 2: Consolidate DevOps agent (AC: #1, #2, #5)
+  - [x] 2.1 Read `lib/bmad-customizations/bmm-devops.customize.yaml`
+  - [x] 2.2 Read `lib/bmad-extension/agents/bmm-devops.customize.yaml`
+  - [x] 2.3 Read `lib/bmad-customizations/devops.md`
+  - [x] 2.4 Create `lib/bmad-extension/skills/bmad-ma-agent-devops/SKILL.md`
+  - [x] 2.5 Create `lib/bmad-extension/skills/bmad-ma-agent-devops/bmad-skill-manifest.yaml`
+
+- [x] Task 3: Consolidate Cyber agent (AC: #1, #2, #5)
+  - [x] 3.1 Read `lib/bmad-customizations/bmm-cyber.customize.yaml`
+  - [x] 3.2 Read `lib/bmad-extension/agents/bmm-cyber.customize.yaml`
+  - [x] 3.3 Read `lib/bmad-customizations/cyber.md`
+  - [x] 3.4 Create `lib/bmad-extension/skills/bmad-ma-agent-cyber/SKILL.md`
+  - [x] 3.5 Create `lib/bmad-extension/skills/bmad-ma-agent-cyber/bmad-skill-manifest.yaml`
+
+- [x] Task 4: Consolidate MIL-498 agent (AC: #1, #2, #5)
+  - [x] 4.1 Read `lib/bmad-customizations/bmm-mil498.customize.yaml`
+  - [x] 4.2 Read `lib/bmad-extension/agents/bmm-mil498.customize.yaml`
+  - [x] 4.3 Read `lib/bmad-customizations/mil498.md`
+  - [x] 4.4 Create `lib/bmad-extension/skills/bmad-ma-agent-mil498/SKILL.md`
+  - [x] 4.5 Create `lib/bmad-extension/skills/bmad-ma-agent-mil498/bmad-skill-manifest.yaml`
+
+- [x] Task 5: Verify behavioral equivalence (AC: #6)
+  - [x] 5.1 Compare each SKILL.md against its source files — ensure NO persona, menu item, or critical_action is lost
+  - [x] 5.2 Verify all workflow references in menus use the new skill names
+
+## Dev Notes
+
+### Three-Source Consolidation Pattern
+
+Each custom agent has THREE source files that must be merged into ONE SKILL.md:
+
+| Source | Location | Contains |
+|--------|----------|----------|
+| Base customize | `lib/bmad-customizations/bmm-{agent}.customize.yaml` | Basic persona fields, menu items |
+| Extension customize | `lib/bmad-extension/agents/bmm-{agent}.customize.yaml` | critical_actions, additional overrides |
+| Agent definition | `lib/bmad-customizations/{agent}.md` | Full XML agent definition (persona, detailed menu, activation) |
+
+**Merge priority:** The `.md` file is the authoritative source for persona and menu. The extension `.customize.yaml` is authoritative for `critical_actions`. The base `.customize.yaml` provides fallback fields.
+
+### SKILL.md Format (from CIS module pattern)
+
+```markdown
+# Agent: {DisplayName} — {Title}
+
+## Persona
+- **Role:** {role}
+- **Identity:** {identity}
+- **Communication Style:** {style}
+- **Principles:** {principles}
+
+## Activation Sequence
+1. Greet the user as {DisplayName}
+2. Load skills from MANIFEST.yaml (always_load: true)
+3. Present menu
+
+## Menu
+| # | Action | Trigger | Skill |
+|---|--------|---------|-------|
+| 1 | Health Check | "check health", "system status" | sre-health-check |
+| 2 | Fix Deployments | "fix deploy", "deployment issue" | sre-fix-deployments |
+...
+
+## Critical Actions
+- Read the skills MANIFEST at {project-root}/skills/MANIFEST.yaml
+- For each skill marked always_load: true, read the skill file completely
+- If _bmad-output/project-context.md exists, read it completely
+```
+
+### bmad-skill-manifest.yaml Pattern (Agent Type)
+
+```yaml
+type: agent
+name: bmad-ma-agent-sre
+displayName: Alex
+title: Site Reliability Engineer
+icon: "wrench-emoji"
+capabilities: "system availability, Kubernetes ops, SLO/SLA management"
+role: "Site Reliability Engineer"
+identity: "Experienced SRE focused on system reliability"
+communicationStyle: "Direct, data-driven, alert to risks"
+principles: "Reliability first. Automate everything. Measure what matters."
+module: ma-skills
+```
+
+### Menu Item -> Skill Name Mapping
+
+Map old workflow references to new skill names:
+- SRE agent menus -> `sre-*` skill names
+- DevOps agent menus -> `devops-*` skill names
+- Cyber agent menus -> `cyber-*` skill names
+- MIL-498 agent menus -> `mil498-*` skill names
+
+### Anti-Patterns to Avoid
+
+- DO NOT invent new persona details — copy exactly from source files
+- DO NOT change menu item order or trigger phrases — functional equivalence (NFR30)
+- DO NOT add new critical_actions beyond what exists — preserve behavior exactly
+- DO NOT reference old file paths in menu items — update ALL to new skill names
+
+### Files to Touch
+
+| File | Change |
+|------|--------|
+| `lib/bmad-extension/skills/bmad-ma-agent-sre/SKILL.md` | NEW — consolidated SRE agent |
+| `lib/bmad-extension/skills/bmad-ma-agent-sre/bmad-skill-manifest.yaml` | NEW |
+| `lib/bmad-extension/skills/bmad-ma-agent-devops/SKILL.md` | NEW — consolidated DevOps agent |
+| `lib/bmad-extension/skills/bmad-ma-agent-devops/bmad-skill-manifest.yaml` | NEW |
+| `lib/bmad-extension/skills/bmad-ma-agent-cyber/SKILL.md` | NEW — consolidated Cyber agent |
+| `lib/bmad-extension/skills/bmad-ma-agent-cyber/bmad-skill-manifest.yaml` | NEW |
+| `lib/bmad-extension/skills/bmad-ma-agent-mil498/SKILL.md` | NEW — consolidated MIL-498 agent |
+| `lib/bmad-extension/skills/bmad-ma-agent-mil498/bmad-skill-manifest.yaml` | NEW |
+
+### Source Files to Read (DO NOT MODIFY — these are input only)
+
+- `lib/bmad-customizations/bmm-sre.customize.yaml`, `bmm-devops.customize.yaml`, `bmm-cyber.customize.yaml`, `bmm-mil498.customize.yaml`
+- `lib/bmad-customizations/sre.md`, `devops.md`, `cyber.md`, `mil498.md`
+- `lib/bmad-extension/agents/bmm-sre.customize.yaml`, `bmm-devops.customize.yaml`, `bmm-cyber.customize.yaml`, `bmm-mil498.customize.yaml`
+
+### References
+
+- [Source: _bmad-output/planning-artifacts/architecture.md — P2-9, agent SKILL.md content, bmad-skill-manifest.yaml patterns]
+- [Source: _bmad-output/planning-artifacts/epics.md — Story 15.3]
+- [Source: lib/bmad-customizations/ — 4 base configs + 4 persona .md files]
+- [Source: lib/bmad-extension/agents/ — 4 extension customize files]
+
+## Dev Agent Record
+
+### Agent Model Used
+Claude Opus 4.6 (1M context)
+
+### Debug Log References
+N/A
+
+### Completion Notes List
+- Consolidated all 4 agents (SRE/Alex, DevOps/Amit, Cyber/Yael, MIL-498/Joseph) from 3 source files each into BMAD 6.2.0 skill folders
+- Each agent has SKILL.md (persona, activation sequence, menu, critical actions) and bmad-skill-manifest.yaml (type: agent, all required fields, module: ma-skills)
+- All menu items reference new skill names (sre-*, devops-*, cyber-*, mil498-*) — no old workflow paths remain
+- Persona text copied verbatim from authoritative .md source files; critical_actions copied from extension .customize.yaml files
+- Test file (test/convert-agents-to-skills.test.js) validates all 136 assertions across file existence, content sections, manifest fields, skill name references, and no-old-path regression
+- Test added to package.json test script
+
+### File List
+- `lib/bmad-extension/skills/bmad-ma-agent-sre/SKILL.md` — NEW
+- `lib/bmad-extension/skills/bmad-ma-agent-sre/bmad-skill-manifest.yaml` — NEW
+- `lib/bmad-extension/skills/bmad-ma-agent-devops/SKILL.md` — NEW
+- `lib/bmad-extension/skills/bmad-ma-agent-devops/bmad-skill-manifest.yaml` — NEW
+- `lib/bmad-extension/skills/bmad-ma-agent-cyber/SKILL.md` — NEW
+- `lib/bmad-extension/skills/bmad-ma-agent-cyber/bmad-skill-manifest.yaml` — NEW
+- `lib/bmad-extension/skills/bmad-ma-agent-mil498/SKILL.md` — NEW
+- `lib/bmad-extension/skills/bmad-ma-agent-mil498/bmad-skill-manifest.yaml` — NEW
+- `test/convert-agents-to-skills.test.js` — NEW
+- `package.json` — MODIFIED (added test to test script)
+- `_bmad-output/implementation-artifacts/15-3-convert-custom-agents-to-skill-folders.md` — MODIFIED (status: review, all tasks checked)

package/_bmad-output/implementation-artifacts/done/15-4-convert-mil498-workflows-to-skill-md.md

@@ -0,0 +1,252 @@
+# Story 15.4: Convert MIL-498 Workflows to SKILL.md Packages
+
+Status: done
+
+## Story
+
+As a **MIL-STD-498 expert**,
+I want all MIL-498 DID workflows converted from legacy YAML format to BMAD 6.2.0 SKILL.md packages,
+So that they function without the removed legacy workflow engine.
+
+## Acceptance Criteria
+
+1. Each MIL-498 workflow has a skill folder at `lib/bmad-extension/skills/mil498-{did}/` containing `SKILL.md`, `bmad-skill-manifest.yaml`, `template.md`, and `prompts/` directory
+2. Each step in the original `instructions.md` becomes a separate file in `prompts/` (Layer 4 progressive disclosure)
+3. Step files preserve the exact same sequence and content as the original instructions
+4. Template output checkpoints (previously `<template-output>` XML tags) become explicit user confirmation gates in step files
+5. All converted DID workflows produce the same document output as before conversion (NFR32)
+6. The pause-and-confirm behavior for document section approval is preserved
+
+## Tasks / Subtasks
+
+- [x] Task 1: Convert SSS workflow (AC: #1-#4)
+  - [x] 1.1 Read `lib/bmad-workflows/mil498/sss/workflow.yaml` — extract metadata and variables
+  - [x] 1.2 Read `lib/bmad-workflows/mil498/sss/instructions.md` — map all steps
+  - [x] 1.3 Create `lib/bmad-extension/skills/mil498-sss/SKILL.md` — workflow entrypoint with routing logic
+  - [x] 1.4 Create `lib/bmad-extension/skills/mil498-sss/bmad-skill-manifest.yaml` — `type: skill, name: mil498-sss, module: ma-skills`
+  - [x] 1.5 Copy template to `lib/bmad-extension/skills/mil498-sss/template.md`
+  - [x] 1.6 Split instructions into `prompts/01-*.md`, `02-*.md`, etc. — one file per logical step
+  - [x] 1.7 Add user confirmation gates at each `<template-output>` boundary
+
+- [x] Task 2: Convert SSDD workflow (AC: #1-#4)
+  - [x] 2.1-2.7 Same pattern as Task 1 for `lib/bmad-workflows/mil498/ssdd/`
+
+- [x] Task 3: Convert OCD workflow (AC: #1-#4)
+  - [x] 3.1-3.7 Same pattern for `lib/bmad-workflows/mil498/ocd/`
+
+- [x] Task 4: Convert SDP workflow (AC: #1-#4)
+  - [x] 4.1-4.7 Same pattern for `lib/bmad-workflows/mil498/sdp/`
+
+- [x] Task 5: Convert SRS workflow (AC: #1-#4)
+  - [x] 5.1-5.7 Same pattern for `lib/bmad-workflows/mil498/srs/`
+
+- [x] Task 6: Convert SDD workflow (AC: #1-#4)
+  - [x] 6.1-6.7 Same pattern for `lib/bmad-workflows/mil498/sdd/`
+
+- [x] Task 7: Convert STD workflow (AC: #1-#4)
+  - [x] 7.1-7.7 Same pattern for `lib/bmad-workflows/mil498/std/`
+
+- [x] Task 8: Verify missing DID workflows (AC: #5)
+  - [x] 8.1 Check if STR, IDD, IRS, HRS exist in `lib/bmad-workflows/mil498/` — confirmed NOT FOUND
+  - [x] 8.2 If they don't exist, document which are missing and note in completion log
+  - [x] 8.3 No placeholder skill folders created per anti-pattern guidance (DO NOT create DID workflows that don't exist in source)
+
+- [x] Task 9: Verify output equivalence (AC: #5, #6)
+  - [x] 9.1 For each converted workflow, compare template content — all 7 templates byte-identical to original
+  - [x] 9.2 Verify step count and order matches original instructions — all 7 match (SSS:6, SSDD:7, OCD:6, SDP:6, SRS:6, SDD:6, STD:6)
+  - [x] 9.3 Verify user confirmation gates exist at all template-output boundaries — all 43 prompt files have CONFIRMATION GATE
+
+## Dev Notes
+
+### Existing MIL-498 Workflow Structure (Source)
+
+```
+lib/bmad-workflows/mil498/
+├── ocd/
+│   ├── instructions.md    ← Sequential steps with <template-output> checkpoints
+│   └── workflow.yaml      ← Metadata, variables, config references
+├── sdd/
+│   ├── instructions.md
+│   └── workflow.yaml
+├── sdp/
+│   ├── instructions.md
+│   └── workflow.yaml
+├── srs/
+│   ├── instructions.md
+│   └── workflow.yaml
+├── ssdd/
+│   ├── instructions.md
+│   └── workflow.yaml
+├── sss/
+│   ├── instructions.md
+│   └── workflow.yaml
+└── std/
+    ├── instructions.md
+    └── workflow.yaml
+```
+
+**Only 7 DIDs exist, not 11.** Missing: STR, IDD, IRS, HRS.
+
+### Target Skill Folder Structure (per architecture P2-9)
+
+```
+lib/bmad-extension/skills/mil498-sss/
+├── SKILL.md                    ← Workflow entrypoint with frontmatter
+├── bmad-skill-manifest.yaml    ← type: skill, name: mil498-sss, module: ma-skills
+├── template.md                 ← DID output template (copied verbatim)
+└── prompts/
+    ├── 01-discovery.md         ← First step
+    ├── 02-requirements.md      ← Second step
+    └── ...                     ← One file per logical step
+```
+
+### Conversion Rules
+
+1. **workflow.yaml** → Extract metadata into `SKILL.md` frontmatter and `bmad-skill-manifest.yaml`
+2. **instructions.md** → Split at step boundaries into `prompts/NN-name.md` files
+3. **template** → Copy verbatim to `template.md` (if exists in workflow.yaml template field)
+4. **`<template-output>` tags** → Convert to explicit user confirmation prompts at end of each step file
+5. **Step file naming:** `01-discovery.md`, `02-requirements.md`, etc. (zero-padded, kebab-case)
+6. **Preserve EXACT step sequence** — compliance-critical for MIL-STD-498
+
+### SKILL.md Entrypoint Pattern
+
+```markdown
+---
+name: mil498-sss
+description: Generate MIL-STD-498 System/Subsystem Specification (SSS)
+type: complex-workflow
+triggers:
+  - "generate SSS"
+  - "create system specification"
+---
+
+# MIL-498: System/Subsystem Specification (SSS)
+
+## Workflow
+This workflow generates a MIL-STD-498 SSS document through progressive steps.
+
+### Steps
+1. [Discovery](prompts/01-discovery.md)
+2. [Requirements](prompts/02-requirements.md)
+...
+
+### Template
+Output template: [template.md](template.md)
+```
+
+### Anti-Patterns to Avoid
+
+- DO NOT modify template content — verbatim copy only (NFR32)
+- DO NOT reorder steps — MIL-STD-498 compliance requires exact sequence
+- DO NOT merge steps — each `<template-output>` boundary = separate file
+- DO NOT skip user confirmation gates — they exist for compliance approval
+- DO NOT create DID workflows that don't exist in source (STR, IDD, IRS, HRS) unless explicitly instructed
+
+### Files to Touch
+
+| File | Change |
+|------|--------|
+| `lib/bmad-extension/skills/mil498-{did}/SKILL.md` | NEW — 7 workflow entrypoints |
+| `lib/bmad-extension/skills/mil498-{did}/bmad-skill-manifest.yaml` | NEW — 7 manifests |
+| `lib/bmad-extension/skills/mil498-{did}/template.md` | NEW — 7 template copies |
+| `lib/bmad-extension/skills/mil498-{did}/prompts/*.md` | NEW — step files per workflow |
+
+### References
+
+- [Source: _bmad-output/planning-artifacts/architecture.md — P2-9, MIL-498 conversion detail]
+- [Source: _bmad-output/planning-artifacts/epics.md — Story 15.4]
+- [Source: lib/bmad-workflows/mil498/ — 7 existing DID workflow directories]
+
+## Dev Agent Record
+
+### Agent Model Used
+Claude Opus 4.6 (1M context)
+
+### Debug Log References
+None required — clean implementation with no errors.
+
+### Completion Notes List
+- All 7 MIL-498 DID workflows (SSS, SSDD, OCD, SDP, SRS, SDD, STD) converted from legacy YAML/instructions format to BMAD 6.2.0 SKILL.md packages
+- Templates located at `lib/mil498-templates/{DID}.md`, copied verbatim to each skill folder as `template.md`
+- Original instructions.md files did not use `<template-output>` XML tags; step boundaries identified by `## Step N` headings. Confirmation gates added as `**CONFIRMATION GATE**` blocks at the end of each prompt file
+- SSDD has 7 steps (extra CSCI Discovery Interview step); all others have 6 steps
+- SDD workflow.yaml references the SSDD template (not a separate SDD template), which is correct per MIL-STD-498 (SDD uses same DID structure as SSDD adapted for CSCI-level)
+- Missing DIDs (STR, IDD, IRS, HRS) confirmed not present in source — no placeholders created per anti-pattern guidance
+- All 7 template copies verified byte-identical to originals
+- All 43 prompt files across 7 skills contain user confirmation gates
+
+### Change Log
+| Date | Change |
+|------|--------|
+| 2026-03-27 | Initial implementation: 7 MIL-498 DID workflows converted to SKILL.md packages |
+
+### File List
+| File | Change |
+|------|--------|
+| `lib/bmad-extension/skills/mil498-sss/SKILL.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sss/bmad-skill-manifest.yaml` | NEW |
+| `lib/bmad-extension/skills/mil498-sss/template.md` | NEW (verbatim copy) |
+| `lib/bmad-extension/skills/mil498-sss/prompts/01-discover-project-artifacts.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sss/prompts/02-load-template.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sss/prompts/03-generate-document.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sss/prompts/04-validate.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sss/prompts/05-review.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sss/prompts/06-save.md` | NEW |
+| `lib/bmad-extension/skills/mil498-ssdd/SKILL.md` | NEW |
+| `lib/bmad-extension/skills/mil498-ssdd/bmad-skill-manifest.yaml` | NEW |
+| `lib/bmad-extension/skills/mil498-ssdd/template.md` | NEW (verbatim copy) |
+| `lib/bmad-extension/skills/mil498-ssdd/prompts/01-discover-project-artifacts.md` | NEW |
+| `lib/bmad-extension/skills/mil498-ssdd/prompts/02-load-template.md` | NEW |
+| `lib/bmad-extension/skills/mil498-ssdd/prompts/03-csci-discovery-interview.md` | NEW |
+| `lib/bmad-extension/skills/mil498-ssdd/prompts/04-generate-document.md` | NEW |
+| `lib/bmad-extension/skills/mil498-ssdd/prompts/05-validate.md` | NEW |
+| `lib/bmad-extension/skills/mil498-ssdd/prompts/06-review.md` | NEW |
+| `lib/bmad-extension/skills/mil498-ssdd/prompts/07-save.md` | NEW |
+| `lib/bmad-extension/skills/mil498-ocd/SKILL.md` | NEW |
+| `lib/bmad-extension/skills/mil498-ocd/bmad-skill-manifest.yaml` | NEW |
+| `lib/bmad-extension/skills/mil498-ocd/template.md` | NEW (verbatim copy) |
+| `lib/bmad-extension/skills/mil498-ocd/prompts/01-discover-project-artifacts.md` | NEW |
+| `lib/bmad-extension/skills/mil498-ocd/prompts/02-load-template.md` | NEW |
+| `lib/bmad-extension/skills/mil498-ocd/prompts/03-generate-document.md` | NEW |
+| `lib/bmad-extension/skills/mil498-ocd/prompts/04-validate.md` | NEW |
+| `lib/bmad-extension/skills/mil498-ocd/prompts/05-review.md` | NEW |
+| `lib/bmad-extension/skills/mil498-ocd/prompts/06-save.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sdp/SKILL.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sdp/bmad-skill-manifest.yaml` | NEW |
+| `lib/bmad-extension/skills/mil498-sdp/template.md` | NEW (verbatim copy) |
+| `lib/bmad-extension/skills/mil498-sdp/prompts/01-discover-project-artifacts.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sdp/prompts/02-load-template.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sdp/prompts/03-generate-document.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sdp/prompts/04-validate.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sdp/prompts/05-review.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sdp/prompts/06-save.md` | NEW |
+| `lib/bmad-extension/skills/mil498-srs/SKILL.md` | NEW |
+| `lib/bmad-extension/skills/mil498-srs/bmad-skill-manifest.yaml` | NEW |
+| `lib/bmad-extension/skills/mil498-srs/template.md` | NEW (verbatim copy) |
+| `lib/bmad-extension/skills/mil498-srs/prompts/01-discover-project-artifacts.md` | NEW |
+| `lib/bmad-extension/skills/mil498-srs/prompts/02-load-template.md` | NEW |
+| `lib/bmad-extension/skills/mil498-srs/prompts/03-generate-document.md` | NEW |
+| `lib/bmad-extension/skills/mil498-srs/prompts/04-validate.md` | NEW |
+| `lib/bmad-extension/skills/mil498-srs/prompts/05-review.md` | NEW |
+| `lib/bmad-extension/skills/mil498-srs/prompts/06-save.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sdd/SKILL.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sdd/bmad-skill-manifest.yaml` | NEW |
+| `lib/bmad-extension/skills/mil498-sdd/template.md` | NEW (verbatim copy) |
+| `lib/bmad-extension/skills/mil498-sdd/prompts/01-discover-project-artifacts.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sdd/prompts/02-load-template.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sdd/prompts/03-generate-document.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sdd/prompts/04-validate.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sdd/prompts/05-review.md` | NEW |
+| `lib/bmad-extension/skills/mil498-sdd/prompts/06-save.md` | NEW |
+| `lib/bmad-extension/skills/mil498-std/SKILL.md` | NEW |
+| `lib/bmad-extension/skills/mil498-std/bmad-skill-manifest.yaml` | NEW |
+| `lib/bmad-extension/skills/mil498-std/template.md` | NEW (verbatim copy) |
+| `lib/bmad-extension/skills/mil498-std/prompts/01-discover-project-artifacts.md` | NEW |
+| `lib/bmad-extension/skills/mil498-std/prompts/02-load-template.md` | NEW |
+| `lib/bmad-extension/skills/mil498-std/prompts/03-generate-document.md` | NEW |
+| `lib/bmad-extension/skills/mil498-std/prompts/04-validate.md` | NEW |
+| `lib/bmad-extension/skills/mil498-std/prompts/05-review.md` | NEW |
+| `lib/bmad-extension/skills/mil498-std/prompts/06-save.md` | NEW |
+| `_bmad-output/implementation-artifacts/15-4-convert-mil498-workflows-to-skill-md.md` | UPDATED |
+| `_bmad-output/implementation-artifacts/sprint-status.yaml` | UPDATED |