ma-agents 3.3.0 → 3.4.1

package/.roo/skills/.ma-agents.json

@@ -8,233 +8,233 @@
   "skills": {
     "ai-audit-trail": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:38.321Z",
-      "updatedAt": "2026-03-31T04:59:38.321Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:11.312Z",
+      "updatedAt": "2026-04-01T00:01:11.312Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "auto-bug-detection": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:38.538Z",
-      "updatedAt": "2026-03-31T04:59:38.538Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:11.590Z",
+      "updatedAt": "2026-04-01T00:01:11.590Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "cmake-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:38.737Z",
-      "updatedAt": "2026-03-31T04:59:38.737Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:12.128Z",
+      "updatedAt": "2026-04-01T00:01:12.128Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "code-documentation": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:39.021Z",
-      "updatedAt": "2026-03-31T04:59:39.021Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:12.920Z",
+      "updatedAt": "2026-04-01T00:01:12.920Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "code-review": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:39.389Z",
-      "updatedAt": "2026-03-31T04:59:39.389Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:13.463Z",
+      "updatedAt": "2026-04-01T00:01:13.463Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "commit-message": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:39.758Z",
-      "updatedAt": "2026-03-31T04:59:39.758Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:14.003Z",
+      "updatedAt": "2026-04-01T00:01:14.003Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "cpp-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:40.200Z",
-      "updatedAt": "2026-03-31T04:59:40.200Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:14.423Z",
+      "updatedAt": "2026-04-01T00:01:14.423Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "cpp-concurrency-safety": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:40.582Z",
-      "updatedAt": "2026-03-31T04:59:40.582Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:14.811Z",
+      "updatedAt": "2026-04-01T00:01:14.811Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "cpp-const-correctness": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:41.383Z",
-      "updatedAt": "2026-03-31T04:59:41.383Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:15.441Z",
+      "updatedAt": "2026-04-01T00:01:15.441Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "cpp-memory-handling": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:41.992Z",
-      "updatedAt": "2026-03-31T04:59:41.992Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:15.865Z",
+      "updatedAt": "2026-04-01T00:01:15.865Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "cpp-modern-composition": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:42.546Z",
-      "updatedAt": "2026-03-31T04:59:42.546Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:16.357Z",
+      "updatedAt": "2026-04-01T00:01:16.357Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "cpp-robust-interfaces": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:42.947Z",
-      "updatedAt": "2026-03-31T04:59:42.947Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:16.727Z",
+      "updatedAt": "2026-04-01T00:01:16.727Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "create-hardened-docker-skill": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:43.655Z",
-      "updatedAt": "2026-03-31T04:59:43.655Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:17.395Z",
+      "updatedAt": "2026-04-01T00:01:17.395Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "csharp-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:44.871Z",
-      "updatedAt": "2026-03-31T04:59:44.871Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:17.797Z",
+      "updatedAt": "2026-04-01T00:01:17.797Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "docker-hardening-verification": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:45.468Z",
-      "updatedAt": "2026-03-31T04:59:45.468Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:18.332Z",
+      "updatedAt": "2026-04-01T00:01:18.332Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "docker-image-signing": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:46.686Z",
-      "updatedAt": "2026-03-31T04:59:46.686Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:18.647Z",
+      "updatedAt": "2026-04-01T00:01:18.647Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "document-revision-history": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:47.392Z",
-      "updatedAt": "2026-03-31T04:59:47.392Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:19.047Z",
+      "updatedAt": "2026-04-01T00:01:19.047Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "git-workflow-skill": {
       "version": "2.1.0",
-      "installedAt": "2026-03-31T04:59:50.392Z",
-      "updatedAt": "2026-03-31T04:59:50.392Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:19.709Z",
+      "updatedAt": "2026-04-01T00:01:19.709Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "js-ts-dependency-mgmt": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:50.853Z",
-      "updatedAt": "2026-03-31T04:59:50.853Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:20.361Z",
+      "updatedAt": "2026-04-01T00:01:20.361Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "js-ts-security-skill": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:51.253Z",
-      "updatedAt": "2026-03-31T04:59:51.253Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:20.763Z",
+      "updatedAt": "2026-04-01T00:01:20.763Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "logging-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:51.673Z",
-      "updatedAt": "2026-03-31T04:59:51.673Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:21.709Z",
+      "updatedAt": "2026-04-01T00:01:21.709Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "open-presentation": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:52.139Z",
-      "updatedAt": "2026-03-31T04:59:52.139Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:22.109Z",
+      "updatedAt": "2026-04-01T00:01:22.109Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "opentelemetry-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:52.669Z",
-      "updatedAt": "2026-03-31T04:59:52.669Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:22.865Z",
+      "updatedAt": "2026-04-01T00:01:22.865Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "python-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:53.080Z",
-      "updatedAt": "2026-03-31T04:59:53.080Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:23.509Z",
+      "updatedAt": "2026-04-01T00:01:23.509Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "python-dependency-mgmt": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:53.448Z",
-      "updatedAt": "2026-03-31T04:59:53.448Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:24.237Z",
+      "updatedAt": "2026-04-01T00:01:24.237Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "python-security-skill": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:53.982Z",
-      "updatedAt": "2026-03-31T04:59:53.982Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:24.673Z",
+      "updatedAt": "2026-04-01T00:01:24.673Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "self-signed-cert": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:54.434Z",
-      "updatedAt": "2026-03-31T04:59:54.434Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:25.122Z",
+      "updatedAt": "2026-04-01T00:01:25.122Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "skill-creator": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:55.062Z",
-      "updatedAt": "2026-03-31T04:59:55.062Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:26.240Z",
+      "updatedAt": "2026-04-01T00:01:26.240Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "story-status-lookup": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:55.976Z",
-      "updatedAt": "2026-03-31T04:59:55.976Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:26.744Z",
+      "updatedAt": "2026-04-01T00:01:26.744Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "test-accompanied-development": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:56.427Z",
-      "updatedAt": "2026-03-31T04:59:56.427Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:27.143Z",
+      "updatedAt": "2026-04-01T00:01:27.143Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "test-generator": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:56.704Z",
-      "updatedAt": "2026-03-31T04:59:56.704Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:27.682Z",
+      "updatedAt": "2026-04-01T00:01:27.682Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "vercel-react-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:57.025Z",
-      "updatedAt": "2026-03-31T04:59:57.025Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:28.371Z",
+      "updatedAt": "2026-04-01T00:01:28.371Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     },
     "verify-hardened-docker-skill": {
       "version": "1.0.0",
-      "installedAt": "2026-03-31T04:59:57.550Z",
-      "updatedAt": "2026-03-31T04:59:57.550Z",
-      "installerVersion": "3.2.0",
+      "installedAt": "2026-04-01T00:01:28.928Z",
+      "updatedAt": "2026-04-01T00:01:28.928Z",
+      "installerVersion": "3.4.0",
       "agentVersion": "1.0.0"
     }
   }

package/README.md

@@ -105,10 +105,12 @@ The file is version-controlled as part of `_bmad-output/` project knowledge. Com
 
 ---
 
-## Supported Agents
+## Supported Coding Tools
 
-| Agent | Project Path | Template | Instruction File |
-|-------|-------------|----------|------------------|
+Skills can be installed into any of these AI coding agents:
+
+| Tool | Project Path | Template | Instruction File |
+|------|-------------|----------|------------------|
 | Claude Code | `.claude/skills/` | `claude-code` | `.claude/CLAUDE.md` |
 | Google Gemini | `.gemini/skills/` | `generic` | `.gemini/gemini.md` |
 | GitHub Copilot | `.github/copilot/skills/` | `generic` | `.github/copilot/copilot.md` |
@@ -116,13 +118,26 @@ The file is version-controlled as part of `_bmad-output/` project knowledge. Com
 | Kilocode | `.kilocode/skills/` | `generic` | `.kilocode/kilocode.md` |
 | Cline | `.cline/skills/` | `cline` | `.cline/clinerules.md` |
 | Roo Code | `.roo/skills/` | `generic` | `.roo/rules/00-ma-agents.md` |
-| SRE Agent (Alex) | `_bmad/skills/` | `generic` | `_bmad/bmm/agents/sre.md` |
-| DevOps Agent (Amit) | `_bmad/skills/` | `generic` | `_bmad/bmm/agents/devops.md` |
-| Cyber Analyst (Yael) | `_bmad/skills/` | `generic` | `_bmad/bmm/agents/cyber.md` |
-| Joseph (MIL-STD-498) | `_bmad/skills/` | `generic` | `_bmad/bmm/agents/mil498.md` |
 | Antigravity | `_bmad/skills/` | `generic` | `_bmad/bmm/agents/antigravity.md` |
+| OpenCode | `.opencode/skills/` | `generic` | `opencode.json` |
+
+## Specialized BMAD Agents
+
+These domain-expert agents are installed alongside BMAD-METHOD and provide guided workflows through their agent menus:
+
+| Agent | Persona | Skills Path | Instruction File |
+|-------|---------|-------------|------------------|
+| SRE Agent | Alex | `_bmad/skills/sre/` | `_bmad/bmm/agents/sre.md` |
+| DevOps Agent | Amit | `_bmad/skills/devops/` | `_bmad/bmm/agents/devops.md` |
+| Cyber Analyst | Yael | `_bmad/skills/cyber/` | `_bmad/bmm/agents/cyber.md` |
+| MIL-STD-498 Expert | Joseph | `_bmad/skills/mil498/` | `_bmad/bmm/agents/mil498.md` |
+| ML Scientist | Demerzel | `_bmad/skills/demerzel/` | `_bmad/bmm/agents/demerzel.md` |
+
+## Available Skills
 
-## Available Skills (34)
+### General-Purpose Skills (34)
+
+These skills are installed into your coding tool of choice and provide reusable best-practice guidance:
 
 | Skill ID | Domain | Description |
 | :--- | :--- | :--- |
@@ -159,13 +174,33 @@ The file is version-controlled as part of `_bmad-output/` project knowledge. Com
 | `self-signed-cert` | Security | Automated Root CA and self-signed certificate generation |
 | `docker-image-signing` | Security | Automated cryptographic signing for Docker images |
 | `docker-hardening-verification` | Security | Audits images for least-privilege and OpenShift compatibility |
+
+### Agent Workflows (18)
+
+These workflows are installed as part of the BMAD agent system and are invoked through the agent's menu (not installed individually):
+
+| Workflow | Agent | Description |
+| :--- | :--- | :--- |
+| **Machine Learning (Demerzel)** | | |
+| `ml-ideation` | ML Scientist | Frame ML research problem, produce Research Thesis and PRD |
+| `ml-eda` | ML Scientist | Exploratory Data Analysis, establish baselines, produce EDA report |
+| `ml-architecture` | ML Scientist | Model architecture, stack, and experiment tracking strategy |
+| `ml-detailed-design` | ML Scientist | Implementation task breakdown (INF-* and EXP-* namespaces) |
+| `ml-techspec` | ML Scientist | Lock experiment parameters and performance tiers before training |
+| `ml-infra` | ML Scientist | Build ML infrastructure, manage dependencies, run smoke tests |
+| `ml-experiment` | ML Scientist | Execute training experiments against locked TechSpec, log metrics |
+| `ml-analysis` | ML Scientist | Evaluate experiment outcomes against TechSpec success tiers |
+| `ml-hparam` | ML Scientist | Automated hyperparameter optimization (Optuna, W&B Sweeps, Ray Tune) |
+| `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 |
 | **Sprint Management** | | |
-| `add-sprint` | Agile | Create sprint entities with capacity, ISO dates, and structured YAML schema |
-| `generate-backlog` | Agile | Generate or refresh a flat prioritized backlog from epics and bug stories |
-| `add-to-sprint` | Agile | Assign backlog items to a sprint with capacity enforcement |
-| `remove-from-sprint` | Agile | Remove items from a sprint and return to unassigned backlog |
-| `cleanup-done` | Agile | Archive done items to `done/` and remove from sprint/backlog tracking |
-| `prioritize-backlog` | Agile | Reprioritize backlog using severity, value, dependencies, and type |
+| `add-sprint` | Scrum Master | Create sprint entities with capacity, ISO dates, and structured YAML schema |
+| `generate-backlog` | Scrum Master | Generate or refresh a flat prioritized backlog from epics and bug stories |
+| `add-to-sprint` | Scrum Master | Assign backlog items to a sprint with capacity enforcement |
+| `remove-from-sprint` | Scrum Master | Remove items from a sprint and return to unassigned backlog |
+| `cleanup-done` | Scrum Master | Archive done items to `done/` and remove from sprint/backlog tracking |
+| `prioritize-backlog` | Scrum Master | Reprioritize backlog using severity, value, dependencies, and type |
 
 ## Automated Skill Discovery
 
@@ -191,6 +226,7 @@ npx ma-agents                              # Launch interactive wizard
 npx ma-agents install                      # Interactive install wizard
 npx ma-agents install --yes                # Non-interactive, use defaults (CI/CD)
 npx ma-agents install --yes --agent <id>   # Non-interactive, target one agent
+npx ma-agents install --log                # Log all output to install_<datetime>.log
 npx ma-agents status                       # Show installed skills and paths
 npx ma-agents list                         # List all available skills
 npx ma-agents agents                       # List supported agents
@@ -207,7 +243,7 @@ Running `ma-agents` on a project where skills are already installed triggers the
    - Updates BMAD-METHOD personas and workflows to the latest versions if detected.
 
 ### BMAD-METHOD Integration
-`ma-agents` features first-class integration with [BMAD-METHOD](https://docs.bmad-method.org/) to provide advanced orchestration and specialized personas.
+`ma-agents` bundles [BMAD-METHOD](https://docs.bmad-method.org/) **v6.2.2** to provide advanced orchestration and specialized personas.
 
 #### Core Features
 - **Auto-Detection**: Recognizes existing BMAD installations and prompts for silent updates.
@@ -246,6 +282,10 @@ npx ma-agents install --yes    # fully offline BMAD install — no network neede
    - **Focus**: Technical standards compliance and military document generation.
    - **Capabilities**: Document Data Descriptions (DIDs), requirements traceability, and complex specification writing.
    - **Workflows**: SRS, SSS, and SSDD generation with strict structural validation.
+5. **Demerzel (ML Scientist)**:
+   - **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.
 
 #### Operational Workflows
 The integration includes a suite of specialized playbooks:
@@ -314,6 +354,7 @@ npx ma-agents install code-review claude-code --force
 | `--force` | Skip upgrade prompts, always overwrite existing installations. |
 | `--global` | Install to global/user-level paths instead of project-level. |
 | `--path <dir>` | Custom installation directory. |
+| `--log` | Log all console output to `install_<datetime>.log` in the current directory. |
 
 ## Requirements
 

package/bin/cli.js

@@ -13,6 +13,46 @@ const PKG = require('../package.json');
 const NAME = PKG.name;
 const VERSION = PKG.version;
 
+/**
+ * Set up logging to tee all stdout/stderr output to a file.
+ * Returns a cleanup function to close the file descriptor.
+ *
+ * @param {string} logFilePath - Path to the log file
+ * @returns {Function} cleanup function
+ */
+function setupLogging(logFilePath) {
+  const logFd = fs.openSync(logFilePath, 'w');
+  const header = `[${new Date().toISOString()}] ${NAME} v${VERSION} — log started\n`;
+  fs.writeSync(logFd, header);
+
+  const origStdoutWrite = process.stdout.write.bind(process.stdout);
+  const origStderrWrite = process.stderr.write.bind(process.stderr);
+
+  process.stdout.write = function (chunk, encoding, callback) {
+    const str = typeof chunk === 'string' ? chunk : chunk.toString();
+    try { fs.writeSync(logFd, str); } catch { /* ignore write errors */ }
+    return origStdoutWrite(chunk, encoding, callback);
+  };
+
+  process.stderr.write = function (chunk, encoding, callback) {
+    const str = typeof chunk === 'string' ? chunk : chunk.toString();
+    try { fs.writeSync(logFd, str); } catch { /* ignore write errors */ }
+    return origStderrWrite(chunk, encoding, callback);
+  };
+
+  // Store log fd globally so bmad.js can use pipe mode
+  process.env.MA_AGENTS_LOG_ACTIVE = '1';
+
+  return function cleanup() {
+    process.stdout.write = origStdoutWrite;
+    process.stderr.write = origStderrWrite;
+    const footer = `\n[${new Date().toISOString()}] log ended\n`;
+    try { fs.writeSync(logFd, footer); } catch { /* ignore */ }
+    try { fs.closeSync(logFd); } catch { /* ignore */ }
+    delete process.env.MA_AGENTS_LOG_ACTIVE;
+  };
+}
+
 function showHelp() {
   console.log(`
 ${chalk.bold.cyan(NAME)} ${chalk.gray(`v${VERSION}`)}
@@ -40,6 +80,7 @@ ${chalk.bold('Install options:')}
   ${chalk.cyan('--force')}           Skip upgrade prompts, always overwrite
   ${chalk.cyan('--yes')}             Skip all prompts, use defaults (for CI/CD)
   ${chalk.cyan('--agent <name>')}    Target a specific agent (skip agent selection)
+  ${chalk.cyan('--log')}              Log all console output to install_<datetime>.log
 
 ${chalk.bold('Examples:')}
   npx ${NAME} install
@@ -830,11 +871,11 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath, fo
       if (yesFlag) {
         console.log(chalk.cyan('\n Installing BMAD-METHOD...'));
         const bmadTools = selectedAgentIds.filter(id => bmadToolsFilter.includes(id));
-        const success = await bmad.installBmad(['bmm', 'bmb'], bmadTools);
+        const success = await bmad.installBmad(['bmm'], bmadTools);
         if (success) {
           console.log(chalk.green(' BMAD-METHOD installed successfully!'));
           console.log(chalk.cyan(' Applying ma-agents customizations...'));
-          await bmad.applyCustomizations(process.cwd(), ['bmm', 'bmb'], bmadTools, selectedAgentIds);
+          await bmad.applyCustomizations(process.cwd(), ['bmm'], bmadTools, selectedAgentIds);
         }
       } else {
         const { installBmad } = await prompts({
@@ -847,11 +888,11 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath, fo
         if (installBmad) {
           console.log(chalk.cyan('\n Installing BMAD-METHOD...'));
           const bmadTools = selectedAgentIds.filter(id => bmadToolsFilter.includes(id));
-          const success = await bmad.installBmad(['bmm', 'bmb'], bmadTools);
+          const success = await bmad.installBmad(['bmm'], bmadTools);
           if (success) {
             console.log(chalk.green(' BMAD-METHOD installed successfully!'));
             console.log(chalk.cyan(' Applying ma-agents customizations...'));
-            await bmad.applyCustomizations(process.cwd(), ['bmm', 'bmb'], bmadTools, selectedAgentIds);
+            await bmad.applyCustomizations(process.cwd(), ['bmm'], bmadTools, selectedAgentIds);
           }
         }
       }
@@ -859,11 +900,11 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath, fo
       if (yesFlag) {
         console.log(chalk.cyan('\n Updating BMAD-METHOD...'));
         const bmadTools = selectedAgentIds.filter(id => bmadToolsFilter.includes(id));
-        const success = await bmad.updateBmad(['bmm', 'bmb'], bmadTools);
+        const success = await bmad.updateBmad(['bmm'], bmadTools);
         if (success) {
           console.log(chalk.green(' BMAD-METHOD updated successfully!'));
           console.log(chalk.cyan(' Re-applying ma-agents customizations...'));
-          await bmad.applyCustomizations(process.cwd(), ['bmm', 'bmb'], bmadTools, selectedAgentIds);
+          await bmad.applyCustomizations(process.cwd(), ['bmm'], bmadTools, selectedAgentIds);
         }
       } else {
         const { updateBmad } = await prompts({
@@ -876,11 +917,11 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath, fo
         if (updateBmad) {
           console.log(chalk.cyan('\n Updating BMAD-METHOD...'));
           const bmadTools = selectedAgentIds.filter(id => bmadToolsFilter.includes(id));
-          const success = await bmad.updateBmad(['bmm', 'bmb'], bmadTools);
+          const success = await bmad.updateBmad(['bmm'], bmadTools);
           if (success) {
             console.log(chalk.green(' BMAD-METHOD updated successfully!'));
             console.log(chalk.cyan(' Re-applying ma-agents customizations...'));
-            await bmad.applyCustomizations(process.cwd(), ['bmm', 'bmb'], bmadTools, selectedAgentIds);
+            await bmad.applyCustomizations(process.cwd(), ['bmm'], bmadTools, selectedAgentIds);
           }
         }
       }
@@ -1164,6 +1205,18 @@ async function interactiveMode() {
 
 async function main() {
   const args = process.argv.slice(2);
+
+  // Handle --log flag globally (before command routing)
+  let cleanupLog = null;
+  const logIdx = args.indexOf('--log');
+  if (logIdx !== -1) {
+    const ts = new Date().toISOString().replace(/[:.]/g, '-').replace('T', '_').replace('Z', '');
+    const logFile = `install_${ts}.log`;
+    cleanupLog = setupLogging(logFile);
+    console.log(chalk.gray(`  Logging to ${logFile}`));
+    args.splice(logIdx, 1);
+  }
+
   const command = args[0];
 
   switch (command) {
@@ -1223,6 +1276,8 @@ async function main() {
       await interactiveMode();
       break;
   }
+
+  if (cleanupLog) cleanupLog();
 }
 
 if (require.main === module) {

package/lib/agents.js

@@ -318,6 +318,29 @@ const agents = [
     template: 'generic',
     instructionFiles: ['_bmad/bmm/agents/mil498.md'],
     injectionStrategy: { position: 'top', skipPatterns: ['---'] }
+  },
+  {
+    id: 'bmm-demerzel',
+    name: 'ML Scientist (Demerzel)',
+    version: '1.0.0',
+    category: 'bmad',
+    description: 'Machine Learning Lifecycle Agent (Demerzel)',
+    skillsDir: '_bmad/skills/demerzel',
+    getProjectPath: () => path.join(process.cwd(), '_bmad', 'skills', 'demerzel'),
+    getGlobalPath: () => {
+      const platform = os.platform();
+      if (platform === 'win32') {
+        return path.join(os.homedir(), 'AppData', 'Roaming', 'Demerzel', 'skills');
+      } else if (platform === 'darwin') {
+        return path.join(os.homedir(), 'Library', 'Application Support', 'Demerzel', 'skills');
+      } else {
+        return path.join(os.homedir(), '.config', 'demerzel', 'skills');
+      }
+    },
+    fileExtension: '.md',
+    template: 'generic',
+    instructionFiles: ['_bmad/bmm/agents/demerzel.md'],
+    injectionStrategy: { position: 'top', skipPatterns: ['---'] }
   }
 ];
 

package/lib/bmad-cache/cache-manifest.json

@@ -1,6 +1,6 @@
 {
   "generated": "2026-03-28T12:59:06.172Z",
-  "bmadMethodVersion": "6.2.1",
+  "bmadMethodVersion": "6.2.2",
   "modules": {
     "bmb": {
       "url": "https://github.com/bmad-code-org/bmad-builder",