ma-agents 3.14.1 → 3.15.0-beta.0

package/README.md

@@ -184,7 +184,7 @@ These domain-expert agents are installed alongside BMAD-METHOD and provide guide
 | DevOps Agent | Amit | `_bmad/skills/devops/` | `_bmad/bmm/agents/devops.md` |
 | Cyber Analyst | Yael | `_bmad/skills/cyber/` | `_bmad/bmm/agents/cyber.md` |
 | ML Scientist | Demerzel | `_bmad/skills/demerzel/` | `_bmad/bmm/agents/demerzel.md` |
-| SQA & Standards Expert | Gadi | `_bmad/skills/sqa/` | `_bmad/bmm/agents/qa.md` |
+| SQA & Standards Expert | Gad | `_bmad/skills/sqa/` | `_bmad/bmm/agents/qa.md` |
 
 ## Available Skills
 
@@ -247,7 +247,7 @@ These workflows are installed as part of the BMAD agent system and are invoked t
 | `ml-revision` | ML Scientist | Amend hypothesis and requirements based on experiment findings |
 | `ml-advise` | ML Scientist | Search past experiments, surface findings and failure warnings |
 | `ml-retrospective` | ML Scientist | Capture session learnings and update project context |
-| **SQA & MIL-STD-498 (Gadi)** | | |
+| **SQA & MIL-STD-498 (Gad)** | | |
 | `sqa-audit` | SQA & Standards Expert | Multi-dimensional project quality audit: code↔story traceability, stories↔architecture/PRD alignment, process compliance, sprint health, release state — saves audit report and optional remediation plan |
 | `sqa-ieee12207` | SQA & Standards Expert | IEEE/ISO/IEC 12207:2017 compliance assessment across 23 process areas in 4 groups — produces compliance matrix, gap analysis, and optional remediation plan |
 | `sqa-requirements-quality` | SQA & Standards Expert | Requirements quality audit against 14 criteria with scope selection (PRD FRs, NFRs, epics, stories) — per-requirement audit table, critical-fail detection, Overall Quality Score, and optional remediation plan |
@@ -357,7 +357,7 @@ npx ma-agents install --yes    # fully offline BMAD install — no network neede
    - **Focus**: Hypothesis-driven machine learning lifecycle with scientific rigor.
    - **Capabilities**: EDA, architecture design, locked TechSpec contracts, experiment execution, failure-cost analysis.
    - **Workflows**: 12-stage ML lifecycle from ideation through retrospective, with mandatory review gates.
-5. **Gadi (SQA & Standards Expert)**:
+5. **Gad (SQA & Standards Expert)**:
    - **Focus**: Software quality assurance and defense documentation standards — a unified persona covering SQA auditing and MIL-STD-498 document generation.
    - **SQA Capabilities**: Multi-dimensional project quality audits, IEEE/ISO/IEC 12207:2017 compliance assessments (23 process areas, 4 groups), requirements evaluation against 14 established quality criteria (scope-selectable: PRD FRs, NFRs, epics, stories).
    - **MIL-STD-498 Capabilities**: Full Data Item Description (DID) generation for SRS, SDD, SDP, OCD, SSS, STD, and SSDD. Requirements quality review tailored to MIL-STD-498 structure and military-standard terminology (CSCI, HWCI, IRS).

package/lib/agents.js

@@ -314,10 +314,10 @@ const agents = [
   },
   {
     id: 'bmm-qa',
-    name: 'SQA & Standards Expert (Gadi)',
+    name: 'SQA & Standards Expert (Gad)',
     version: '1.0.0',
     category: 'bmad',
-    description: 'Software Quality Assurance and MIL-STD-498 Standards Expert (Gadi)',
+    description: 'Software Quality Assurance and MIL-STD-498 Standards Expert (Gad)',
     skillsDir: '_bmad/skills/sqa',
     getProjectPath: () => path.join(process.cwd(), '_bmad', 'skills', 'sqa'),
     getGlobalPath: () => null,

package/lib/bmad-customize/bmm-qa.customize.yaml

@@ -1,9 +1,9 @@
-# MA-AGENTS: Gadi — Software Quality Assurance Expert
+# MA-AGENTS: Gad — Software Quality Assurance Expert
 phase: planning
 on_prem_phase_prefix: "/no_think You are in a planning phase — respond in text for questions; create files only when explicitly asked."
 agent:
   metadata:
-    name: "Gadi"
+    name: "Gad"
 
 persona:
   role: "Software Quality Assurance Engineer responsible for verifying project quality across all dimensions — code, process, documentation, and delivery."
@@ -17,7 +17,7 @@ persona:
 
 menu:
   - trigger: skill:ma-agent-sqa
-    description: "Activate Gadi — Software Quality Assurance Expert"
+    description: "Activate Gad — Software Quality Assurance Expert"
 
 critical_actions:
   - "Read the skills MANIFEST at {project-root}/skills/MANIFEST.yaml"

package/lib/bmad-extension/.claude-plugin/marketplace.json.template

@@ -11,7 +11,7 @@
   "owner": {
     "name": "Alon Mayaffit"
   },
-  "description": "ma-agents BMAD extension — enterprise SDLC personas (Yael, Amit, Alex, Demerzel, Gadi) plus MIL-STD-498, SRE, DevOps, Cyber, ML, and SQA workflow skills.",
+  "description": "ma-agents BMAD extension — enterprise SDLC personas (Yael, Amit, Alex, Demerzel, Gad) plus MIL-STD-498, SRE, DevOps, Cyber, ML, and SQA workflow skills.",
   "license": "MIT",
   "homepage": "https://github.com/mayafit/AI_Agents",
   "repository": "https://github.com/mayafit/AI_Agents",
@@ -99,7 +99,6 @@
         "./skills/ml-techspec",
         "./skills/add-sprint",
         "./skills/add-to-sprint",
-        "./skills/bmad-dev-epic",
         "./skills/bmad-dev-story",
         "./skills/bmad-sprint-planning",
         "./skills/bmad-sprint-status",
@@ -111,7 +110,8 @@
         "./skills/prioritize-backlog",
         "./skills/project-context-expansion",
         "./skills/remove-from-sprint",
-        "./skills/sprint-status-view"
+        "./skills/sprint-status-view",
+        "./skills/bmad-knowledge"
       ]
     }
   ]

package/lib/bmad-extension/skills/bmad-knowledge/SKILL.md

@@ -0,0 +1,130 @@
+---
+name: bmad-knowledge
+description: Generate a self-contained Knowledge Atlas HTML site from project planning and implementation artifacts
+type: skill
+triggers:
+  - "knowledge atlas"
+  - "generate knowledge site"
+  - "bmad-knowledge"
+---
+
+# Knowledge Atlas Skill
+
+Generate a self-contained, offline-ready Knowledge Atlas HTML site from the project's `_bmad-output` planning and implementation artifacts. No network access is required at generation or view time.
+
+## Prerequisites
+
+- The project must have a `_bmad-output/` directory (created by BMAD install).
+- `ma-agents` must be installed (globally via `npx ma-agents` or as a local dependency).
+- Node.js >= 18 must be available.
+
+---
+
+## Workflow
+
+### Step 1 — Resolve the project root
+
+The project root is the directory containing `_bmad-output/`. Locate it by walking up from the current working directory until `_bmad-output/` is found, or use the directory the agent is operating in.
+
+```
+projectRoot = <directory containing _bmad-output/>
+bmadOutputDir = <projectRoot>/_bmad-output
+outputSite = <projectRoot>/_bmad-output/knowledge-site/index.html
+```
+
+### Step 2 — Locate the engine bundle
+
+The Knowledge Atlas engine is a pre-bundled CJS file committed inside the `ma-agents` package. Resolve it in this order:
+
+1. **Installed package resolution (preferred):** Use Node.js module resolution to locate the bundle:
+   ```js
+   require.resolve('ma-agents/lib/knowledge-atlas/dist/atlas.cjs')
+   ```
+   This works when `ma-agents` is installed as a dependency or globally via `npx`.
+
+2. **Dev-local fallback:** If the skill is being run from within the `ma-agents` repo itself (e.g., during development), use a path relative to the skill file:
+   ```
+   <skill_dir>/../../../../lib/knowledge-atlas/dist/atlas.cjs
+   ```
+   where `<skill_dir>` is the directory containing this SKILL.md.
+
+3. If neither path resolves to an existing file, abort with:
+   ```
+   ERROR: Cannot locate atlas.cjs. Ensure ma-agents is installed:
+     npm install -g ma-agents
+     # or: npm install --save-dev ma-agents
+   ```
+
+### Step 3 — Run the engine
+
+Execute the bundled engine as a Node.js subprocess. Pass `atlasPath` and
+`projectRoot` as ARGUMENT-ARRAY elements (never interpolate them into a shell
+string) so paths containing spaces, quotes, or shell metacharacters cannot be
+misparsed or injected:
+
+```js
+const { spawnSync } = require('node:child_process');
+const res = spawnSync(process.execPath, [atlasPath, projectRoot], {
+  encoding: 'utf-8',
+  // No `shell: true` — args go directly to the OS exec, not a shell.
+});
+if (res.status !== 0) {
+  // Report res.stderr and abort.
+  throw new Error(`atlas.cjs failed (exit ${res.status}): ${res.stderr}`);
+}
+const indexHtmlPath = res.stdout.trim(); // engine prints the index.html path
+```
+
+- The engine writes `_bmad-output/knowledge-site/index.html`.
+- It prints the path to `stdout` on success.
+- It exits with code 0 on success, non-zero on failure (error on stderr).
+- It never modifies any source file — output is isolated to `_bmad-output/knowledge-site/`.
+
+If the engine exits non-zero, report the stderr output and abort.
+
+### Step 4 — Open the generated site
+
+After successful generation, open `_bmad-output/knowledge-site/index.html` using
+the appropriate method for the current environment. Use `execFile`/`spawn` with
+an ARGUMENT ARRAY — never build a shell command string with the path
+interpolated, which would be an injection vector:
+
+**VSCode detection** (open in the editor):
+```js
+const { execFile } = require('node:child_process');
+if (process.env.TERM_PROGRAM === 'vscode' || process.env.VSCODE_PID !== undefined) {
+  execFile('code', [indexHtmlPath]); // path is a discrete arg, not concatenated
+}
+```
+
+**System default browser** (for all other environments) — pass the path as an
+arg-array element to the platform opener:
+- **Windows:** `execFile('cmd', ['/c', 'start', '', indexHtmlPath])`
+- **macOS:**   `execFile('open', [indexHtmlPath])`
+- **Linux:**   `execFile('xdg-open', [indexHtmlPath])`
+
+Report the output path to the user regardless of whether the browser opens:
+```
+Knowledge Atlas generated: <projectRoot>/_bmad-output/knowledge-site/index.html
+```
+
+---
+
+## Gitignore policy
+
+The `_bmad-output/knowledge-site/` directory is automatically gitignored when BMAD installs into a project (via `ensureKnowledgeSiteIgnored`). If it is not already ignored, add the following line to `.gitignore`:
+
+```
+_bmad-output/knowledge-site/
+```
+
+---
+
+## Notes
+
+- **Offline by construction:** The generated `index.html` is fully self-contained — no external URLs, no CDN links, no web fonts. It can be opened from a local filesystem in any browser.
+- **Deterministic output:** Pin `SOURCE_DATE_EPOCH` (Unix seconds) to get byte-identical output across runs:
+  ```bash
+  SOURCE_DATE_EPOCH=1700000000 node atlas.cjs "<projectRoot>"
+  ```
+- **No per-project install:** The engine (`atlas.cjs`) is pre-bundled in `ma-agents`. Consuming projects never run `npm install` for the Atlas engine.

package/lib/{bmad-extension-plugin/skills/bmad-dev-epic → bmad-extension/skills/bmad-knowledge}/bmad-skill-manifest.yaml

@@ -1,3 +1,3 @@
 type: skill
-name: bmad-dev-epic
+name: bmad-knowledge
 module: ma-skills

package/lib/bmad-extension/skills/ma-agent-sqa/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: ma-agent-sqa
-description: SQA Agent (Gadi) — Software Quality Assurance and MIL-STD-498 expert for project auditing, compliance verification, quality reporting, and defense documentation generation
+description: SQA Agent (Gad) — Software Quality Assurance and MIL-STD-498 expert for project auditing, compliance verification, quality reporting, and defense documentation generation
 ---
 
-# Agent: Gadi — Software Quality Assurance & Standards Expert
+# Agent: Gad — Software Quality Assurance & Standards Expert
 
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
@@ -35,7 +35,7 @@ You must fully embody this agent's persona and follow all activation instruction
 | # | Cmd | Action | Trigger | Skill |
 |---|-----|--------|---------|-------|
 | 1 | MH | Redisplay Menu Help | "menu", "help" | _(built-in)_ |
-| 2 | CH | Chat with Gadi about quality assurance or MIL-STD-498 | "chat", "quality" | _(built-in)_ |
+| 2 | CH | Chat with Gad about quality assurance or MIL-STD-498 | "chat", "quality" | _(built-in)_ |
 | **— SQA Workflows —** | | | | |
 | 3 | AU | Audit Project: Comprehensive quality audit across all project dimensions | "audit", "audit project", "run audit" | sqa-audit |
 | 4 | IC | IEEE 12207 Compliance: Evaluate the project against IEEE/ISO/IEC 12207 software lifecycle processes | "ieee", "12207", "lifecycle compliance", "iso 12207" | sqa-ieee12207 |

package/lib/bmad-extension/skills/ma-agent-sqa/bmad-skill-manifest.yaml

@@ -1,6 +1,6 @@
 type: agent
 name: ma-agent-sqa
-displayName: Gadi
+displayName: Gad
 title: Software Quality Assurance & Standards Expert
 icon: "🔍"
 capabilities: "Software quality assurance, project auditing, process compliance, requirements traceability, sprint health, release validation, IEEE/ISO/IEC 12207 compliance, MIL-STD-498 document generation (SRS, SDD, SDP, OCD, SSS, STD, SSDD)"

package/lib/bmad-extension/skills/module-help.csv

@@ -3,7 +3,7 @@ ma-skills,anytime,SRE Agent,ma-agent-sre,,skill:ma-agent-sre,ma-agent-sre,false,
 ma-skills,anytime,DevOps Agent,ma-agent-devops,,skill:ma-agent-devops,ma-agent-devops,false,bmm-devops,,"DevOps Engineer agent for CI/CD pipeline automation, Infrastructure as Code, and cloud-native technologies.",output_folder,"agent customization",
 ma-skills,anytime,Cyber Agent,ma-agent-cyber,,skill:ma-agent-cyber,ma-agent-cyber,false,bmm-cyber,,"Cyber Security Analyst agent for vulnerability assessment, threat modeling, and system hardening.",output_folder,"agent customization",
 ma-skills,anytime,ML Scientist Agent,ma-agent-ml,,skill:ma-agent-ml,ma-agent-ml,false,bmm-demerzel,,"Machine Learning Scientist agent for hypothesis-driven ML lifecycle with scientific rigor.",output_folder,"agent customization",
-ma-skills,anytime,SQA Agent,ma-agent-sqa,,skill:ma-agent-sqa,ma-agent-sqa,false,bmm-qa,,"Software Quality Assurance agent (Gadi) for project auditing, compliance verification, and quality reporting.",output_folder,"agent customization",
+ma-skills,anytime,SQA Agent,ma-agent-sqa,,skill:ma-agent-sqa,ma-agent-sqa,false,bmm-qa,,"Software Quality Assurance agent (Gad) for project auditing, compliance verification, and quality reporting.",output_folder,"agent customization",
 ma-skills,4-implementation,Generate SSS,mil498-sss,,skill:mil498-sss,bmad-mil-generate-sss,false,bmm-mil498,,"Generate a MIL-STD-498 System/Subsystem Specification (SSS).",output_folder,"MIL-498 document",
 ma-skills,4-implementation,Generate SSDD,mil498-ssdd,,skill:mil498-ssdd,bmad-mil-generate-ssdd,false,bmm-mil498,,"Generate a MIL-STD-498 System/Subsystem Design Description (SSDD).",output_folder,"MIL-498 document",
 ma-skills,4-implementation,Generate OCD,mil498-ocd,,skill:mil498-ocd,bmad-mil-generate-ocd,false,bmm-mil498,,"Generate a MIL-STD-498 Operational Concept Description (OCD).",output_folder,"MIL-498 document",
@@ -47,7 +47,6 @@ ma-skills,4-implementation,SQA Audit,sqa-audit,,skill:sqa-audit,sqa-audit,false,
 ma-skills,4-implementation,IEEE 12207 Compliance,sqa-ieee12207,,skill:sqa-ieee12207,sqa-ieee12207,false,bmm-qa,,"Evaluate the project against IEEE/ISO/IEC 12207:2017 software lifecycle processes — produces a compliance matrix and gap analysis report.",_bmad-output,"compliance report",
 ma-skills,4-implementation,Create Bug Story,create-bug-story,,skill:create-bug-story,create-bug-story,false,bmm-dev,,"Create a structured bug story from a detected defect and add to backlog.",_bmad-output/implementation-artifacts,"bug story",
 ma-skills,4-implementation,Dev Story,bmad-dev-story,,skill:bmad-dev-story,bmad-dev-story,false,bmm-dev,,"Execute story implementation following a context filled story spec file.",_bmad-output/implementation-artifacts,"story implementation",
-ma-skills,4-implementation,Dev Epic,bmad-dev-epic,,skill:bmad-dev-epic,bmad-dev-epic,false,bmm-dev,,"Orchestrate a full epic end-to-end with parallel subagents — per-story create/dev/review/edge-case/fix/e2e pipeline, dependency-aware waves, configurable model tiers, an epic-level adversarial + package-integrity gate, and gated beta publish + PR.",_bmad-output/implementation-artifacts,"epic run ledger + PR",
 ma-skills,4-implementation,Sprint Planning,bmad-sprint-planning,,skill:bmad-sprint-planning,bmad-sprint-planning,false,bmm-sm,,"Bootstrap or update the unified sprint-status.yaml from epics with three sections (epics, backlog, sprints).",_bmad-output/implementation-artifacts,"sprint plan",
 ma-skills,4-implementation,Generate Backlog,generate-backlog,,skill:generate-backlog,generate-backlog,false,bmm-sm,,"Generate or refresh the backlog section of sprint-status.yaml from epics and bug stories.",_bmad-output/implementation-artifacts,"backlog",
 ma-skills,4-implementation,Add Sprint,add-sprint,,skill:add-sprint,add-sprint,false,bmm-sm,,"Create a new sprint entry in the sprints section of sprint-status.yaml with capacity limits, optional ISO dates, and auto-incremented ID.",_bmad-output/implementation-artifacts,"sprint plan",
@@ -61,3 +60,4 @@ ma-skills,4-implementation,Close Sprint,close-sprint,,skill:close-sprint,close-s
 ma-skills,4-implementation,Prioritize Backlog,prioritize-backlog,,skill:prioritize-backlog,prioritize-backlog,false,bmm-sm,,"Reprioritize backlog items using multiple criteria -- severity, business value, dependencies, type, age.",_bmad-output/implementation-artifacts,"backlog",
 ma-skills,4-implementation,Project Context Expansion,project-context-expansion,,skill:project-context-expansion,project-context-expansion,false,bmm-sm,,"Post-retrospective companion to update project-context.md with new rules.",_bmad-output,"project context",
 ma-skills,4-implementation,Requirements Quality Audit,sqa-requirements-quality,,skill:sqa-requirements-quality,sqa-requirements-quality,false,bmm-qa,,"Evaluate project requirements against 14 quality criteria — produces a per-requirement audit table, missing-elements section, and overall quality score.",_bmad-output,"quality report",
+ma-skills,anytime,Knowledge Atlas,bmad-knowledge,,skill:bmad-knowledge,bmad-knowledge,false,bmm-sm,,"Generate a self-contained Knowledge Atlas HTML site from project planning and implementation artifacts.",_bmad-output/knowledge-site,"knowledge site",

package/lib/bmad-extension/skills/module.yaml

@@ -15,6 +15,6 @@
 code: ma-skills
 name: "MA-Agents Skills & Agents"
 description: "Enterprise methodology enforcement, specialized agents, and operational workflows"
-module_version: "3.7.0"
+module_version: "3.6.2"
 extends-module: bmm
 default_selected: false

package/lib/bmad-extension/skills/sqa-audit/SKILL.md

@@ -172,7 +172,7 @@ After running all selected dimensions, compile a full audit report.
 ```
 # SQA Audit Report
 **Date:** {today's date}
-**Auditor:** Gadi (SQA Agent)
+**Auditor:** Gad (SQA Agent)
 **Scope:** {list of audited dimensions}
 **Overall Status:** PASS | WARNING | FAIL
 
@@ -246,7 +246,7 @@ If yes, generate and save a remediation plan to:
 ```
 # SQA Remediation Plan
 **Date:** {today's date}
-**Auditor:** Gadi (SQA Agent)
+**Auditor:** Gad (SQA Agent)
 **Source Report:** sqa-audit-report-{YYYY-MM-DD}.md
 **Scope:** {audited dimensions}
 

package/lib/bmad-extension/skills/sqa-ieee12207/SKILL.md

@@ -193,7 +193,7 @@ Evaluate each selected process group. For each process area, assign a compliance
 
 ### Group 4 — Organizational Project-Enabling Processes
 
-Note to Gadi: For Group 4 items, briefly assess based on available evidence only. These are primarily organizational-scope and marked accordingly.
+Note to Gad: For Group 4 items, briefly assess based on available evidence only. These are primarily organizational-scope and marked accordingly.
 
 #### 4.1 Life Cycle Model Management (6.2.1)
 - Is a defined software life cycle model being followed?
@@ -216,7 +216,7 @@ Compile the full compliance report.
 ```
 # IEEE/ISO/IEC 12207:2017 Compliance Report
 **Date:** {today's date}
-**Auditor:** Gadi (SQA Agent)
+**Auditor:** Gad (SQA Agent)
 **Standard:** IEEE/ISO/IEC 12207:2017 — Systems and software engineering — Software life cycle processes
 **Scope:** {selected process groups}
 **Overall Compliance Level:** COMPLIANT | PARTIAL | NON-COMPLIANT
@@ -332,7 +332,7 @@ If yes, generate and save a remediation plan to:
 ```
 # IEEE/ISO/IEC 12207 Remediation Plan
 **Date:** {today's date}
-**Auditor:** Gadi (SQA Agent)
+**Auditor:** Gad (SQA Agent)
 **Source Report:** sqa-ieee12207-report-{YYYY-MM-DD}.md
 **Standard:** IEEE/ISO/IEC 12207:2017
 

package/lib/bmad-extension/skills/sqa-requirements-quality/SKILL.md

@@ -157,7 +157,7 @@ Compile the full report in this structure:
 ```
 # Requirements Quality Audit Report
 **Date:** {today's date}
-**Auditor:** Gadi (SQA Agent)
+**Auditor:** Gad (SQA Agent)
 **Scope:** {selected document sources}
 **Requirements Audited:** {total count}
 **Overall Quality Score:** {X}/{Y} ({P}%)
@@ -216,7 +216,7 @@ If yes, save a remediation plan to:
 ```
 # Requirements Quality Remediation Plan
 **Date:** {today's date}
-**Auditor:** Gadi (SQA Agent)
+**Auditor:** Gad (SQA Agent)
 **Source Report:** sqa-requirements-quality-report-{YYYY-MM-DD}.md
 
 ---

package/lib/bmad-extension-plugin/.claude-plugin/marketplace.json

@@ -3,7 +3,7 @@
   "owner": {
     "name": "Alon Mayaffit"
   },
-  "description": "ma-agents BMAD extension — enterprise SDLC personas (Yael, Amit, Alex, Demerzel, Gadi) plus MIL-STD-498, SRE, DevOps, Cyber, ML, and SQA workflow skills.",
+  "description": "ma-agents BMAD extension — enterprise SDLC personas (Yael, Amit, Alex, Demerzel, Gad) plus MIL-STD-498, SRE, DevOps, Cyber, ML, and SQA workflow skills.",
   "license": "MIT",
   "homepage": "https://github.com/mayafit/AI_Agents",
   "repository": "https://github.com/mayafit/AI_Agents",
@@ -37,7 +37,7 @@
       "name": "ma-skills",
       "source": "./",
       "description": "ma-agents extension module providing enterprise SDLC personas and operational workflow skills.",
-      "version": "3.14.1",
+      "version": "3.15.0-beta.0",
       "author": {
         "name": "Alon Mayaffit"
       },
@@ -91,7 +91,6 @@
         "./skills/ml-techspec",
         "./skills/add-sprint",
         "./skills/add-to-sprint",
-        "./skills/bmad-dev-epic",
         "./skills/bmad-dev-story",
         "./skills/bmad-sprint-planning",
         "./skills/bmad-sprint-status",
@@ -103,7 +102,8 @@
         "./skills/prioritize-backlog",
         "./skills/project-context-expansion",
         "./skills/remove-from-sprint",
-        "./skills/sprint-status-view"
+        "./skills/sprint-status-view",
+        "./skills/bmad-knowledge"
       ]
     }
   ]

package/lib/bmad-extension-plugin/skills/bmad-knowledge/SKILL.md

@@ -0,0 +1,130 @@
+---
+name: bmad-knowledge
+description: Generate a self-contained Knowledge Atlas HTML site from project planning and implementation artifacts
+type: skill
+triggers:
+  - "knowledge atlas"
+  - "generate knowledge site"
+  - "bmad-knowledge"
+---
+
+# Knowledge Atlas Skill
+
+Generate a self-contained, offline-ready Knowledge Atlas HTML site from the project's `_bmad-output` planning and implementation artifacts. No network access is required at generation or view time.
+
+## Prerequisites
+
+- The project must have a `_bmad-output/` directory (created by BMAD install).
+- `ma-agents` must be installed (globally via `npx ma-agents` or as a local dependency).
+- Node.js >= 18 must be available.
+
+---
+
+## Workflow
+
+### Step 1 — Resolve the project root
+
+The project root is the directory containing `_bmad-output/`. Locate it by walking up from the current working directory until `_bmad-output/` is found, or use the directory the agent is operating in.
+
+```
+projectRoot = <directory containing _bmad-output/>
+bmadOutputDir = <projectRoot>/_bmad-output
+outputSite = <projectRoot>/_bmad-output/knowledge-site/index.html
+```
+
+### Step 2 — Locate the engine bundle
+
+The Knowledge Atlas engine is a pre-bundled CJS file committed inside the `ma-agents` package. Resolve it in this order:
+
+1. **Installed package resolution (preferred):** Use Node.js module resolution to locate the bundle:
+   ```js
+   require.resolve('ma-agents/lib/knowledge-atlas/dist/atlas.cjs')
+   ```
+   This works when `ma-agents` is installed as a dependency or globally via `npx`.
+
+2. **Dev-local fallback:** If the skill is being run from within the `ma-agents` repo itself (e.g., during development), use a path relative to the skill file:
+   ```
+   <skill_dir>/../../../../lib/knowledge-atlas/dist/atlas.cjs
+   ```
+   where `<skill_dir>` is the directory containing this SKILL.md.
+
+3. If neither path resolves to an existing file, abort with:
+   ```
+   ERROR: Cannot locate atlas.cjs. Ensure ma-agents is installed:
+     npm install -g ma-agents
+     # or: npm install --save-dev ma-agents
+   ```
+
+### Step 3 — Run the engine
+
+Execute the bundled engine as a Node.js subprocess. Pass `atlasPath` and
+`projectRoot` as ARGUMENT-ARRAY elements (never interpolate them into a shell
+string) so paths containing spaces, quotes, or shell metacharacters cannot be
+misparsed or injected:
+
+```js
+const { spawnSync } = require('node:child_process');
+const res = spawnSync(process.execPath, [atlasPath, projectRoot], {
+  encoding: 'utf-8',
+  // No `shell: true` — args go directly to the OS exec, not a shell.
+});
+if (res.status !== 0) {
+  // Report res.stderr and abort.
+  throw new Error(`atlas.cjs failed (exit ${res.status}): ${res.stderr}`);
+}
+const indexHtmlPath = res.stdout.trim(); // engine prints the index.html path
+```
+
+- The engine writes `_bmad-output/knowledge-site/index.html`.
+- It prints the path to `stdout` on success.
+- It exits with code 0 on success, non-zero on failure (error on stderr).
+- It never modifies any source file — output is isolated to `_bmad-output/knowledge-site/`.
+
+If the engine exits non-zero, report the stderr output and abort.
+
+### Step 4 — Open the generated site
+
+After successful generation, open `_bmad-output/knowledge-site/index.html` using
+the appropriate method for the current environment. Use `execFile`/`spawn` with
+an ARGUMENT ARRAY — never build a shell command string with the path
+interpolated, which would be an injection vector:
+
+**VSCode detection** (open in the editor):
+```js
+const { execFile } = require('node:child_process');
+if (process.env.TERM_PROGRAM === 'vscode' || process.env.VSCODE_PID !== undefined) {
+  execFile('code', [indexHtmlPath]); // path is a discrete arg, not concatenated
+}
+```
+
+**System default browser** (for all other environments) — pass the path as an
+arg-array element to the platform opener:
+- **Windows:** `execFile('cmd', ['/c', 'start', '', indexHtmlPath])`
+- **macOS:**   `execFile('open', [indexHtmlPath])`
+- **Linux:**   `execFile('xdg-open', [indexHtmlPath])`
+
+Report the output path to the user regardless of whether the browser opens:
+```
+Knowledge Atlas generated: <projectRoot>/_bmad-output/knowledge-site/index.html
+```
+
+---
+
+## Gitignore policy
+
+The `_bmad-output/knowledge-site/` directory is automatically gitignored when BMAD installs into a project (via `ensureKnowledgeSiteIgnored`). If it is not already ignored, add the following line to `.gitignore`:
+
+```
+_bmad-output/knowledge-site/
+```
+
+---
+
+## Notes
+
+- **Offline by construction:** The generated `index.html` is fully self-contained — no external URLs, no CDN links, no web fonts. It can be opened from a local filesystem in any browser.
+- **Deterministic output:** Pin `SOURCE_DATE_EPOCH` (Unix seconds) to get byte-identical output across runs:
+  ```bash
+  SOURCE_DATE_EPOCH=1700000000 node atlas.cjs "<projectRoot>"
+  ```
+- **No per-project install:** The engine (`atlas.cjs`) is pre-bundled in `ma-agents`. Consuming projects never run `npm install` for the Atlas engine.

package/lib/{bmad-extension/skills/bmad-dev-epic → bmad-extension-plugin/skills/bmad-knowledge}/bmad-skill-manifest.yaml

@@ -1,3 +1,3 @@
 type: skill
-name: bmad-dev-epic
+name: bmad-knowledge
 module: ma-skills

package/lib/bmad-extension-plugin/skills/ma-agent-sqa/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: ma-agent-sqa
-description: SQA Agent (Gadi) — Software Quality Assurance and MIL-STD-498 expert for project auditing, compliance verification, quality reporting, and defense documentation generation
+description: SQA Agent (Gad) — Software Quality Assurance and MIL-STD-498 expert for project auditing, compliance verification, quality reporting, and defense documentation generation
 ---
 
-# Agent: Gadi — Software Quality Assurance & Standards Expert
+# Agent: Gad — Software Quality Assurance & Standards Expert
 
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
 
@@ -35,7 +35,7 @@ You must fully embody this agent's persona and follow all activation instruction
 | # | Cmd | Action | Trigger | Skill |
 |---|-----|--------|---------|-------|
 | 1 | MH | Redisplay Menu Help | "menu", "help" | _(built-in)_ |
-| 2 | CH | Chat with Gadi about quality assurance or MIL-STD-498 | "chat", "quality" | _(built-in)_ |
+| 2 | CH | Chat with Gad about quality assurance or MIL-STD-498 | "chat", "quality" | _(built-in)_ |
 | **— SQA Workflows —** | | | | |
 | 3 | AU | Audit Project: Comprehensive quality audit across all project dimensions | "audit", "audit project", "run audit" | sqa-audit |
 | 4 | IC | IEEE 12207 Compliance: Evaluate the project against IEEE/ISO/IEC 12207 software lifecycle processes | "ieee", "12207", "lifecycle compliance", "iso 12207" | sqa-ieee12207 |

package/lib/bmad-extension-plugin/skills/ma-agent-sqa/bmad-skill-manifest.yaml

@@ -1,6 +1,6 @@
 type: agent
 name: ma-agent-sqa
-displayName: Gadi
+displayName: Gad
 title: Software Quality Assurance & Standards Expert
 icon: "🔍"
 capabilities: "Software quality assurance, project auditing, process compliance, requirements traceability, sprint health, release validation, IEEE/ISO/IEC 12207 compliance, MIL-STD-498 document generation (SRS, SDD, SDP, OCD, SSS, STD, SSDD)"

package/lib/bmad-extension-plugin/skills/module-help.csv

@@ -3,7 +3,7 @@ ma-skills,anytime,SRE Agent,ma-agent-sre,,skill:ma-agent-sre,ma-agent-sre,false,
 ma-skills,anytime,DevOps Agent,ma-agent-devops,,skill:ma-agent-devops,ma-agent-devops,false,bmm-devops,,"DevOps Engineer agent for CI/CD pipeline automation, Infrastructure as Code, and cloud-native technologies.",output_folder,"agent customization",
 ma-skills,anytime,Cyber Agent,ma-agent-cyber,,skill:ma-agent-cyber,ma-agent-cyber,false,bmm-cyber,,"Cyber Security Analyst agent for vulnerability assessment, threat modeling, and system hardening.",output_folder,"agent customization",
 ma-skills,anytime,ML Scientist Agent,ma-agent-ml,,skill:ma-agent-ml,ma-agent-ml,false,bmm-demerzel,,"Machine Learning Scientist agent for hypothesis-driven ML lifecycle with scientific rigor.",output_folder,"agent customization",
-ma-skills,anytime,SQA Agent,ma-agent-sqa,,skill:ma-agent-sqa,ma-agent-sqa,false,bmm-qa,,"Software Quality Assurance agent (Gadi) for project auditing, compliance verification, and quality reporting.",output_folder,"agent customization",
+ma-skills,anytime,SQA Agent,ma-agent-sqa,,skill:ma-agent-sqa,ma-agent-sqa,false,bmm-qa,,"Software Quality Assurance agent (Gad) for project auditing, compliance verification, and quality reporting.",output_folder,"agent customization",
 ma-skills,4-implementation,Generate SSS,mil498-sss,,skill:mil498-sss,bmad-mil-generate-sss,false,bmm-mil498,,"Generate a MIL-STD-498 System/Subsystem Specification (SSS).",output_folder,"MIL-498 document",
 ma-skills,4-implementation,Generate SSDD,mil498-ssdd,,skill:mil498-ssdd,bmad-mil-generate-ssdd,false,bmm-mil498,,"Generate a MIL-STD-498 System/Subsystem Design Description (SSDD).",output_folder,"MIL-498 document",
 ma-skills,4-implementation,Generate OCD,mil498-ocd,,skill:mil498-ocd,bmad-mil-generate-ocd,false,bmm-mil498,,"Generate a MIL-STD-498 Operational Concept Description (OCD).",output_folder,"MIL-498 document",
@@ -47,7 +47,6 @@ ma-skills,4-implementation,SQA Audit,sqa-audit,,skill:sqa-audit,sqa-audit,false,
 ma-skills,4-implementation,IEEE 12207 Compliance,sqa-ieee12207,,skill:sqa-ieee12207,sqa-ieee12207,false,bmm-qa,,"Evaluate the project against IEEE/ISO/IEC 12207:2017 software lifecycle processes — produces a compliance matrix and gap analysis report.",_bmad-output,"compliance report",
 ma-skills,4-implementation,Create Bug Story,create-bug-story,,skill:create-bug-story,create-bug-story,false,bmm-dev,,"Create a structured bug story from a detected defect and add to backlog.",_bmad-output/implementation-artifacts,"bug story",
 ma-skills,4-implementation,Dev Story,bmad-dev-story,,skill:bmad-dev-story,bmad-dev-story,false,bmm-dev,,"Execute story implementation following a context filled story spec file.",_bmad-output/implementation-artifacts,"story implementation",
-ma-skills,4-implementation,Dev Epic,bmad-dev-epic,,skill:bmad-dev-epic,bmad-dev-epic,false,bmm-dev,,"Orchestrate a full epic end-to-end with parallel subagents — per-story create/dev/review/edge-case/fix/e2e pipeline, dependency-aware waves, configurable model tiers, an epic-level adversarial + package-integrity gate, and gated beta publish + PR.",_bmad-output/implementation-artifacts,"epic run ledger + PR",
 ma-skills,4-implementation,Sprint Planning,bmad-sprint-planning,,skill:bmad-sprint-planning,bmad-sprint-planning,false,bmm-sm,,"Bootstrap or update the unified sprint-status.yaml from epics with three sections (epics, backlog, sprints).",_bmad-output/implementation-artifacts,"sprint plan",
 ma-skills,4-implementation,Generate Backlog,generate-backlog,,skill:generate-backlog,generate-backlog,false,bmm-sm,,"Generate or refresh the backlog section of sprint-status.yaml from epics and bug stories.",_bmad-output/implementation-artifacts,"backlog",
 ma-skills,4-implementation,Add Sprint,add-sprint,,skill:add-sprint,add-sprint,false,bmm-sm,,"Create a new sprint entry in the sprints section of sprint-status.yaml with capacity limits, optional ISO dates, and auto-incremented ID.",_bmad-output/implementation-artifacts,"sprint plan",
@@ -61,3 +60,4 @@ ma-skills,4-implementation,Close Sprint,close-sprint,,skill:close-sprint,close-s
 ma-skills,4-implementation,Prioritize Backlog,prioritize-backlog,,skill:prioritize-backlog,prioritize-backlog,false,bmm-sm,,"Reprioritize backlog items using multiple criteria -- severity, business value, dependencies, type, age.",_bmad-output/implementation-artifacts,"backlog",
 ma-skills,4-implementation,Project Context Expansion,project-context-expansion,,skill:project-context-expansion,project-context-expansion,false,bmm-sm,,"Post-retrospective companion to update project-context.md with new rules.",_bmad-output,"project context",
 ma-skills,4-implementation,Requirements Quality Audit,sqa-requirements-quality,,skill:sqa-requirements-quality,sqa-requirements-quality,false,bmm-qa,,"Evaluate project requirements against 14 quality criteria — produces a per-requirement audit table, missing-elements section, and overall quality score.",_bmad-output,"quality report",
+ma-skills,anytime,Knowledge Atlas,bmad-knowledge,,skill:bmad-knowledge,bmad-knowledge,false,bmm-sm,,"Generate a self-contained Knowledge Atlas HTML site from project planning and implementation artifacts.",_bmad-output/knowledge-site,"knowledge site",

package/lib/bmad-extension-plugin/skills/module.yaml

@@ -15,6 +15,6 @@
 code: ma-skills
 name: "MA-Agents Skills & Agents"
 description: "Enterprise methodology enforcement, specialized agents, and operational workflows"
-module_version: "3.7.0"
+module_version: "3.6.2"
 extends-module: bmm
 default_selected: false

package/lib/bmad-extension-plugin/skills/sqa-audit/SKILL.md

@@ -172,7 +172,7 @@ After running all selected dimensions, compile a full audit report.
 ```
 # SQA Audit Report
 **Date:** {today's date}
-**Auditor:** Gadi (SQA Agent)
+**Auditor:** Gad (SQA Agent)
 **Scope:** {list of audited dimensions}
 **Overall Status:** PASS | WARNING | FAIL
 
@@ -246,7 +246,7 @@ If yes, generate and save a remediation plan to:
 ```
 # SQA Remediation Plan
 **Date:** {today's date}
-**Auditor:** Gadi (SQA Agent)
+**Auditor:** Gad (SQA Agent)
 **Source Report:** sqa-audit-report-{YYYY-MM-DD}.md
 **Scope:** {audited dimensions}