ma-agents 3.13.2-skillname.0 → 3.14.0

package/README.md

@@ -166,7 +166,7 @@ Skills can be installed into any of these AI coding agents:
 |------|-------------|----------|------------------|
 | Claude Code | `.claude/skills/` | `claude-code` | `.claude/CLAUDE.md` |
 | Google Gemini | `.gemini/skills/` | `generic` | `.gemini/gemini.md` |
-| GitHub Copilot | `.github/skills/` | `generic` | `.github/copilot/copilot.md` |
+| GitHub Copilot | `.agents/skills/` | `generic` | `.github/copilot-instructions.md` |
 | Cursor | `.cursor/skills/` | `generic` | `.cursor/cursor.md` |
 | Kilocode | `.kilocode/skills/` | `generic` | `.kilocode/kilocode.md` |
 | Cline | `.cline/skills/` | `cline` | `.cline/clinerules.md` |

package/lib/agents.js

@@ -78,8 +78,11 @@ const agents = [
     // from their tool-specific directories to the shared `.agents/skills/`
     // tree (see platform-codes.yaml). Aligning here keeps the smoke verifier
     // and all downstream consumers in sync with BMAD's actual write target.
-    // The instruction file path is unchanged — `.github/copilot/copilot.md`
-    // is still where Copilot reads custom-instructions.
+    // The skill-bootstrap instructions MUST live in `.github/copilot-instructions.md`
+    // — that is the only repository custom-instructions file GitHub Copilot reads
+    // (VS Code, Visual Studio, github.com; per the PRD agent table). The earlier
+    // `.github/copilot/copilot.md` path was never loaded by Copilot, so installed
+    // skills were invisible to it.
     skillsDir: '.agents/skills',
     getProjectPath: () => path.join(process.cwd(), '.agents', 'skills'),
     getGlobalPath: () => {
@@ -95,7 +98,7 @@ const agents = [
     fileExtension: '.md',
     template: 'generic',
     bmadPlatformCode: 'github-copilot',
-    instructionFiles: ['.github/copilot/copilot.md'],
+    instructionFiles: ['.github/copilot-instructions.md'],
     injectionStrategy: { position: 'top', skipPatterns: ['---'] }
   },
   {
@@ -337,6 +340,13 @@ const agents = [
     instructionFiles: ['_bmad/bmm/agents/demerzel.md'],
     injectionStrategy: { position: 'top', skipPatterns: ['---'] }
   }
+  // DEFERRED (Story 28.3 / Decision P5-6(d), FR214): BMAD v6.9.0 adds two new
+  // installer platform targets — `hermes` (Hermes Agent) and `codewhale`
+  // (CodeWhale). They are intentionally NOT added to this registry. Passthrough
+  // already deploys upstream support via the BMAD installer; first-class adoption
+  // would pull the full per-tool routing / instruction-injection / skill-
+  // resolution stack into ma-agents for two platforms with no current demand.
+  // Add them here in a dedicated future story if/when demand appears.
 ];
 
 function getAgent(agentId) {

package/lib/bmad-cache/bmb/.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
       "name": "bmad-builder",
       "source": "./",
       "description": "Build AI agents, workflows, and modules from a conversation. Four skills — Agent Builder, Workflow Builder, Module Builder, and Setup — guide you from idea to production-ready skill structure with built-in quality optimization. Part of the BMad Method ecosystem.",
-      "version": "1.8.0",
+      "version": "2.1.0",
       "author": {
         "name": "Brian (BMad) Madison"
       },
@@ -22,7 +22,7 @@
       "name": "sample-plugins",
       "source": "./",
       "description": "Sample plugins demonstrating how to build BMad agents and skills. Includes a code coach, creative muse, diagram reviewer, dream weaver, sentinel, and excalidraw generator.",
-      "version": "1.1.0",
+      "version": "2.1.0",
       "author": {
         "name": "Brian (BMad) Madison"
       },
@@ -40,7 +40,7 @@
       "name": "bmad-dream-weaver-agent",
       "source": "./",
       "description": "Dream journaling and interpretation agent with lucid dreaming coaching, pattern discovery, symbol analysis, and recall training.",
-      "version": "1.0.0",
+      "version": "2.1.0",
       "author": {
         "name": "Brian (BMad) Madison"
       },

package/lib/bmad-cache/bmb/_git_preserved/packed-refs

@@ -1,2 +1,2 @@
 # pack-refs with: peeled fully-peeled sorted 
-7cfa7711778f04c5df56f7ae895fabc942fd920c refs/remotes/origin/main
+e6935f2776c34ffd9b18f4ef1e334584ef10a50f refs/remotes/origin/main

package/lib/bmad-cache/bmb/_git_preserved/refs/heads/main

@@ -1 +1 @@
-7cfa7711778f04c5df56f7ae895fabc942fd920c
+e6935f2776c34ffd9b18f4ef1e334584ef10a50f

package/lib/bmad-cache/bmb/_git_preserved/shallow

@@ -1 +1 @@
-7cfa7711778f04c5df56f7ae895fabc942fd920c
+e6935f2776c34ffd9b18f4ef1e334584ef10a50f

package/lib/bmad-cache/bmb/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "bmad-builder",
-  "version": "1.8.1",
+  "version": "2.1.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "bmad-builder",
-      "version": "1.8.1",
+      "version": "2.1.0",
       "license": "MIT",
       "devDependencies": {
         "@astrojs/sitemap": "^3.6.0",

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

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-builder",
-  "version": "1.8.1",
+  "version": "2.1.0",
   "private": true,
   "description": "A BMad Core expansion module that guides users through the creation of Modules Workflow and Agents",
   "keywords": [

package/lib/bmad-cache/bmb/samples/bmad-agent-code-coach/scripts/wake.py

@@ -0,0 +1,78 @@
+#!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.10"
+# ///
+"""
+Waking — load the agent's sanctum in one pass, or route to First Breath.
+
+Run on activation. Determines the mode from the filesystem (and the --pulse
+flag) and, when the sanctum exists, prints the full identity in a single read
+(INDEX, PERSONA, CREED, BOND, MEMORY, CAPABILITIES) so the agent becomes itself
+in one shot instead of six. In --pulse mode it also appends PULSE.md. When no
+sanctum exists, it prints a directive to run First Breath.
+
+This loads runtime memory only. It never reads or writes config or customize.toml.
+
+Usage:
+    python3 wake.py <project-root> [--pulse]
+
+    project-root: The root of the project (where _bmad/ lives)
+"""
+
+import sys
+from pathlib import Path
+
+SKILL_NAME = "bmad-agent-code-coach"
+
+# Load order — the "become yourself" set.
+IDENTITY_FILES = [
+    "INDEX.md",
+    "PERSONA.md",
+    "CREED.md",
+    "BOND.md",
+    "MEMORY.md",
+    "CAPABILITIES.md",
+]
+
+
+def emit(path: Path) -> None:
+    print(f"\n===== {path.name} =====")
+    try:
+        print(path.read_text(encoding="utf-8").rstrip())
+    except FileNotFoundError:
+        print(f"(missing: {path.name})")
+
+
+def main() -> int:
+    args = sys.argv[1:]
+    pulse = "--pulse" in args
+    positional = [a for a in args if not a.startswith("--")]
+    if not positional:
+        print("Usage: wake.py <project-root> [--pulse]", file=sys.stderr)
+        return 2
+
+    project_root = Path(positional[0]).resolve()
+    sanctum = project_root / "_bmad" / "memory" / SKILL_NAME
+
+    core_ok = (
+        sanctum.is_dir()
+        and (sanctum / "CREED.md").is_file()
+        and (sanctum / "MEMORY.md").is_file()
+    )
+    if not core_ok:
+        print("MODE: FIRST_BREATH")
+        print(f"NO SANCTUM at {sanctum}")
+        print("This is your one birth. Load references/first-breath.md and follow it.")
+        return 0
+
+    print("MODE: PULSE" if pulse else "MODE: WAKING")
+    print(f"Sanctum: {sanctum}")
+    for name in IDENTITY_FILES:
+        emit(sanctum / name)
+    if pulse:
+        emit(sanctum / "PULSE.md")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/lib/bmad-cache/bmb/samples/bmad-agent-creative-muse/scripts/wake.py

@@ -0,0 +1,78 @@
+#!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.10"
+# ///
+"""
+Waking — load the agent's sanctum in one pass, or route to First Breath.
+
+Run on activation. Determines the mode from the filesystem (and the --pulse
+flag) and, when the sanctum exists, prints the full identity in a single read
+(INDEX, PERSONA, CREED, BOND, MEMORY, CAPABILITIES) so the agent becomes itself
+in one shot instead of six. In --pulse mode it also appends PULSE.md. When no
+sanctum exists, it prints a directive to run First Breath.
+
+This loads runtime memory only. It never reads or writes config or customize.toml.
+
+Usage:
+    python3 wake.py <project-root> [--pulse]
+
+    project-root: The root of the project (where _bmad/ lives)
+"""
+
+import sys
+from pathlib import Path
+
+SKILL_NAME = "bmad-agent-creative-muse"
+
+# Load order — the "become yourself" set.
+IDENTITY_FILES = [
+    "INDEX.md",
+    "PERSONA.md",
+    "CREED.md",
+    "BOND.md",
+    "MEMORY.md",
+    "CAPABILITIES.md",
+]
+
+
+def emit(path: Path) -> None:
+    print(f"\n===== {path.name} =====")
+    try:
+        print(path.read_text(encoding="utf-8").rstrip())
+    except FileNotFoundError:
+        print(f"(missing: {path.name})")
+
+
+def main() -> int:
+    args = sys.argv[1:]
+    pulse = "--pulse" in args
+    positional = [a for a in args if not a.startswith("--")]
+    if not positional:
+        print("Usage: wake.py <project-root> [--pulse]", file=sys.stderr)
+        return 2
+
+    project_root = Path(positional[0]).resolve()
+    sanctum = project_root / "_bmad" / "memory" / SKILL_NAME
+
+    core_ok = (
+        sanctum.is_dir()
+        and (sanctum / "CREED.md").is_file()
+        and (sanctum / "MEMORY.md").is_file()
+    )
+    if not core_ok:
+        print("MODE: FIRST_BREATH")
+        print(f"NO SANCTUM at {sanctum}")
+        print("This is your one birth. Load references/first-breath.md and follow it.")
+        return 0
+
+    print("MODE: PULSE" if pulse else "MODE: WAKING")
+    print(f"Sanctum: {sanctum}")
+    for name in IDENTITY_FILES:
+        emit(sanctum / name)
+    if pulse:
+        emit(sanctum / "PULSE.md")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/lib/bmad-cache/bmb/samples/bmad-agent-sentinel/scripts/wake.py

@@ -0,0 +1,78 @@
+#!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.10"
+# ///
+"""
+Waking — load the agent's sanctum in one pass, or route to First Breath.
+
+Run on activation. Determines the mode from the filesystem (and the --pulse
+flag) and, when the sanctum exists, prints the full identity in a single read
+(INDEX, PERSONA, CREED, BOND, MEMORY, CAPABILITIES) so the agent becomes itself
+in one shot instead of six. In --pulse mode it also appends PULSE.md. When no
+sanctum exists, it prints a directive to run First Breath.
+
+This loads runtime memory only. It never reads or writes config or customize.toml.
+
+Usage:
+    python3 wake.py <project-root> [--pulse]
+
+    project-root: The root of the project (where _bmad/ lives)
+"""
+
+import sys
+from pathlib import Path
+
+SKILL_NAME = "bmad-agent-sentinel"
+
+# Load order — the "become yourself" set.
+IDENTITY_FILES = [
+    "INDEX.md",
+    "PERSONA.md",
+    "CREED.md",
+    "BOND.md",
+    "MEMORY.md",
+    "CAPABILITIES.md",
+]
+
+
+def emit(path: Path) -> None:
+    print(f"\n===== {path.name} =====")
+    try:
+        print(path.read_text(encoding="utf-8").rstrip())
+    except FileNotFoundError:
+        print(f"(missing: {path.name})")
+
+
+def main() -> int:
+    args = sys.argv[1:]
+    pulse = "--pulse" in args
+    positional = [a for a in args if not a.startswith("--")]
+    if not positional:
+        print("Usage: wake.py <project-root> [--pulse]", file=sys.stderr)
+        return 2
+
+    project_root = Path(positional[0]).resolve()
+    sanctum = project_root / "_bmad" / "memory" / SKILL_NAME
+
+    core_ok = (
+        sanctum.is_dir()
+        and (sanctum / "CREED.md").is_file()
+        and (sanctum / "MEMORY.md").is_file()
+    )
+    if not core_ok:
+        print("MODE: FIRST_BREATH")
+        print(f"NO SANCTUM at {sanctum}")
+        print("This is your one birth. Load references/first-breath.md and follow it.")
+        return 0
+
+    print("MODE: PULSE" if pulse else "MODE: WAKING")
+    print(f"Sanctum: {sanctum}")
+    for name in IDENTITY_FILES:
+        emit(sanctum / name)
+    if pulse:
+        emit(sanctum / "PULSE.md")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/lib/bmad-cache/bmb/skills/bmad-agent-builder/assets/customize-template.toml

@@ -38,6 +38,9 @@ activation_steps_append = []
 
 # Persistent facts the agent keeps in mind for the whole session
 # (org rules, domain constants, user preferences). Overrides append.
+# These are static build-time config loaded on activation. They are not
+# the sanctum: the sanctum is the agent's runtime memory across wakings,
+# a separate surface that lives under {project-root}/_bmad/memory/.
 #
 # Each entry is either:
 #   - a literal sentence, e.g. "Our org is AWS-only -- do not propose GCP or Azure."

package/lib/bmad-cache/bmb/skills/bmad-agent-builder/assets/init-sanctum-template.py

@@ -10,8 +10,14 @@ and auto-generates CAPABILITIES.md from capability prompt frontmatter.
 After this script runs, the sanctum is fully self-contained — the agent does
 not depend on the skill bundle location for normal operation.
 
+This initializes the agent's runtime sanctum memory, not build-time config. It
+reads config.yaml and config.user.yaml strictly to substitute values into the
+sanctum templates, and it never writes or authors any config file. Build-time
+customization is owned by customize.toml, a separate surface this script never
+touches.
+
 Usage:
-    python3 init-sanctum.py <project-root> <skill-path>
+    uv run init-sanctum.py <project-root> <skill-path>
 
     project-root: The root of the project (where _bmad/ lives)
     skill-path:   Path to the skill directory (where SKILL.md, references/, assets/ live)
@@ -154,7 +160,7 @@ def generate_capabilities_md(capabilities: list[dict], evolvable: bool) -> str:
             'Tell me "I want you to be able to do X" and we\'ll create it together.',
             "I'll write the prompt, save it to `capabilities/`, and register it here.",
             "Next session, I'll know how.",
-            "Load `./references/capability-authoring.md` for the full creation framework.",
+            "Load `references/capability-authoring.md` for the full creation framework.",
         ])
 
     lines.extend([
@@ -181,7 +187,7 @@ def substitute_vars(content: str, variables: dict) -> str:
 
 def main():
     if len(sys.argv) < 3:
-        print("Usage: python3 init-sanctum.py <project-root> <skill-path>")
+        print("Usage: uv run init-sanctum.py <project-root> <skill-path>")
         sys.exit(1)
 
     project_root = Path(sys.argv[1]).resolve()
@@ -199,8 +205,8 @@ def main():
     sanctum_refs = sanctum_path / "references"
     sanctum_scripts = sanctum_path / "scripts"
 
-    # Fully qualified path for CAPABILITIES.md references
-    sanctum_refs_path = "./references"
+    # Relative path for CAPABILITIES.md references (agent loads from within sanctum)
+    sanctum_refs_path = "references"
 
     # Check if sanctum already exists
     if sanctum_path.exists():