bmad-plus 0.12.0 → 0.12.2

package/src/bmad-plus/packs/pack-dev-studio/shared/module-help.csv

@@ -1,32 +1,32 @@
-module,skill,display-name,menu-code,description,action,args,phase,preceded-by,followed-by,required,output-location,outputs
-BMad Method,_meta,,,,,,,,,false,https://docs.bmad-method.org/llms.txt,
-BMad Method,bmad-document-project,Document Project,DP,Analyze an existing project to produce useful documentation.,,,anytime,,,false,project-knowledge,*
-BMad Method,bmad-generate-project-context,Generate Project Context,GPC,Scan existing codebase to generate a lean LLM-optimized project-context.md. Essential for brownfield projects.,,,anytime,,,false,output_folder,project context
-BMad Method,bmad-quick-dev,Quick Dev,QQ,Unified intent-in code-out workflow: clarify plan implement review and present.,,,anytime,,,false,implementation_artifacts,spec and project implementation
-BMad Method,bmad-correct-course,Correct Course,CC,Navigate significant changes. May recommend start over update PRD redo architecture sprint planning or correct epics and stories.,,,anytime,,,false,planning_artifacts,change proposal
-BMad Method,bmad-agent-tech-writer,Write Document,WD,"Describe in detail what you want, and the agent will follow documentation best practices. Multi-turn conversation with subprocess for research/review.",write,,anytime,,,false,project-knowledge,document
-BMad Method,bmad-agent-tech-writer,Update Standards,US,Update agent memory documentation-standards.md with your specific preferences if you discover missing document conventions.,update-standards,,anytime,,,false,_bmad/_memory/tech-writer-sidecar,standards
-BMad Method,bmad-agent-tech-writer,Mermaid Generate,MG,Create a Mermaid diagram based on user description. Will suggest diagram types if not specified.,mermaid,,anytime,,,false,planning_artifacts,mermaid diagram
-BMad Method,bmad-agent-tech-writer,Validate Document,VD,Review the specified document against documentation standards and best practices. Returns specific actionable improvement suggestions organized by priority.,validate,[path],anytime,,,false,planning_artifacts,validation report
-BMad Method,bmad-agent-tech-writer,Explain Concept,EC,Create clear technical explanations with examples and diagrams for complex concepts.,explain,[topic],anytime,,,false,project_knowledge,explanation
-BMad Method,bmad-brainstorming,Brainstorm Project,BP,Expert guided facilitation through a single or multiple techniques.,,,1-analysis,,,false,planning_artifacts,brainstorming session
-BMad Method,bmad-market-research,Market Research,MR,Market analysis competitive landscape customer needs and trends.,,,1-analysis,,,false,planning_artifacts|project-knowledge,research documents
-BMad Method,bmad-domain-research,Domain Research,DR,Industry domain deep dive subject matter expertise and terminology.,,,1-analysis,,,false,planning_artifacts|project_knowledge,research documents
-BMad Method,bmad-technical-research,Technical Research,TR,Technical feasibility architecture options and implementation approaches.,,,1-analysis,,,false,planning_artifacts|project_knowledge,research documents
-BMad Method,bmad-product-brief,Create Brief,CB,An expert guided experience to nail down your product idea in a brief. a gentler approach than PRFAQ when you are already sure of your concept and nothing will sway you.,,-A,1-analysis,,,false,planning_artifacts,product brief
-BMad Method,bmad-prfaq,PRFAQ Challenge,WB,Working Backwards guided experience to forge and stress-test your product concept to ensure you have a great product that users will love and need through the PRFAQ gauntlet to determine feasibility and alignment with user needs. alternative to product brief.,,-H,1-analysis,,,false,planning_artifacts,prfaq document
-BMad Method,bmad-prd,Create Edit and Review PRD,PRD,"Facilitated PRD workflow — create a new PRD via coached discovery, update an existing one against a change signal, or validate a finished PRD against a checklist with an HTML findings report.",,,2-planning,bmad-product-brief,,true,planning_artifacts,prd
-BMad Method,bmad-create-ux-design,Create UX,CU,"Guidance through realizing the plan for your UX, strongly recommended if a UI is a primary piece of the proposed project.",,,2-planning,bmad-prd,,false,planning_artifacts,ux design
-BMad Method,bmad-create-architecture,Create Architecture,CA,Guided workflow to document technical decisions.,,,3-solutioning,,,true,planning_artifacts,architecture
-BMad Method,bmad-create-epics-and-stories,Create Epics and Stories,CE,,,,3-solutioning,bmad-create-architecture,,true,planning_artifacts,epics and stories
-BMad Method,bmad-check-implementation-readiness,Check Implementation Readiness,IR,Ensure PRD UX Architecture and Epics Stories are aligned.,,,3-solutioning,bmad-create-epics-and-stories,,true,planning_artifacts,readiness report
-BMad Method,bmad-sprint-planning,Sprint Planning,SP,Kicks off implementation by producing a plan the implementation agents will follow in sequence for every story.,,,4-implementation,,,true,implementation_artifacts,sprint status
-BMad Method,bmad-sprint-status,Sprint Status,SS,Anytime: Summarize sprint status and route to next workflow.,,,4-implementation,bmad-sprint-planning,,false,,
-BMad Method,bmad-create-story,Create Story,CS,Story cycle start: Prepare first found story in the sprint plan that is next or a specific epic/story designation.,create,,4-implementation,bmad-sprint-planning,bmad-create-story:validate,true,implementation_artifacts,story
-BMad Method,bmad-create-story,Validate Story,VS,Validates story readiness and completeness before development work begins.,validate,,4-implementation,bmad-create-story:create,bmad-dev-story,false,implementation_artifacts,story validation report
-BMad Method,bmad-dev-story,Dev Story,DS,Story cycle: Execute story implementation tasks and tests then CR then back to DS if fixes needed.,,,4-implementation,bmad-create-story:validate,,true,,
-BMad Method,bmad-code-review,Code Review,CR,Story cycle: If issues back to DS if approved then next CS or ER if epic complete.,,,4-implementation,bmad-dev-story,,false,,
-BMad Method,bmad-checkpoint-preview,Checkpoint,CK,Guided walkthrough of a change from purpose and context into details. Use for human review of commits branches or PRs.,,,4-implementation,,,false,,
-BMad Method,bmad-qa-generate-e2e-tests,QA Automation Test,QA,Generate automated API and E2E tests for implemented code. NOT for code review or story validation — use CR for that.,,,4-implementation,bmad-dev-story,,false,implementation_artifacts,test suite
-BMad Method,bmad-retrospective,Retrospective,ER,Optional at epic end: Review completed work lessons learned and next epic or if major issues consider CC.,,,4-implementation,bmad-code-review,,false,implementation_artifacts,retrospective
-BMad Method,bmad-investigate,Investigate,IN,Forensic case investigation calibrated to the input. Evidence-graded analysis with hypothesis tracking. Produces a structured case file.,,4-implementation,,,false,implementation_artifacts,investigation report
+module,skill,display-name,menu-code,description,action,args,phase,preceded-by,followed-by,required,output-location,outputs
+BMad Method,_meta,,,,,,,,,false,https://docs.bmad-method.org/llms.txt,
+BMad Method,bmad-document-project,Document Project,DP,Analyze an existing project to produce useful documentation.,,,anytime,,,false,project-knowledge,*
+BMad Method,bmad-generate-project-context,Generate Project Context,GPC,Scan existing codebase to generate a lean LLM-optimized project-context.md. Essential for brownfield projects.,,,anytime,,,false,output_folder,project context
+BMad Method,bmad-quick-dev,Quick Dev,QQ,Unified intent-in code-out workflow: clarify plan implement review and present.,,,anytime,,,false,implementation_artifacts,spec and project implementation
+BMad Method,bmad-correct-course,Correct Course,CC,Navigate significant changes. May recommend start over update PRD redo architecture sprint planning or correct epics and stories.,,,anytime,,,false,planning_artifacts,change proposal
+BMad Method,bmad-agent-tech-writer,Write Document,WD,"Describe in detail what you want, and the agent will follow documentation best practices. Multi-turn conversation with subprocess for research/review.",write,,anytime,,,false,project-knowledge,document
+BMad Method,bmad-agent-tech-writer,Update Standards,US,Update agent memory documentation-standards.md with your specific preferences if you discover missing document conventions.,update-standards,,anytime,,,false,_bmad/_memory/tech-writer-sidecar,standards
+BMad Method,bmad-agent-tech-writer,Mermaid Generate,MG,Create a Mermaid diagram based on user description. Will suggest diagram types if not specified.,mermaid,,anytime,,,false,planning_artifacts,mermaid diagram
+BMad Method,bmad-agent-tech-writer,Validate Document,VD,Review the specified document against documentation standards and best practices. Returns specific actionable improvement suggestions organized by priority.,validate,[path],anytime,,,false,planning_artifacts,validation report
+BMad Method,bmad-agent-tech-writer,Explain Concept,EC,Create clear technical explanations with examples and diagrams for complex concepts.,explain,[topic],anytime,,,false,project_knowledge,explanation
+BMad Method,bmad-brainstorming,Brainstorm Project,BP,Expert guided facilitation through a single or multiple techniques.,,,1-analysis,,,false,planning_artifacts,brainstorming session
+BMad Method,bmad-market-research,Market Research,MR,Market analysis competitive landscape customer needs and trends.,,,1-analysis,,,false,planning_artifacts|project-knowledge,research documents
+BMad Method,bmad-domain-research,Domain Research,DR,Industry domain deep dive subject matter expertise and terminology.,,,1-analysis,,,false,planning_artifacts|project_knowledge,research documents
+BMad Method,bmad-technical-research,Technical Research,TR,Technical feasibility architecture options and implementation approaches.,,,1-analysis,,,false,planning_artifacts|project_knowledge,research documents
+BMad Method,bmad-product-brief,Create Brief,CB,An expert guided experience to nail down your product idea in a brief. a gentler approach than PRFAQ when you are already sure of your concept and nothing will sway you.,,-A,1-analysis,,,false,planning_artifacts,product brief
+BMad Method,bmad-prfaq,PRFAQ Challenge,WB,Working Backwards guided experience to forge and stress-test your product concept to ensure you have a great product that users will love and need through the PRFAQ gauntlet to determine feasibility and alignment with user needs. alternative to product brief.,,-H,1-analysis,,,false,planning_artifacts,prfaq document
+BMad Method,bmad-prd,Create Edit and Review PRD,PRD,"Facilitated PRD workflow — create a new PRD via coached discovery, update an existing one against a change signal, or validate a finished PRD against a checklist with an HTML findings report.",,,2-planning,bmad-product-brief,,true,planning_artifacts,prd
+BMad Method,bmad-create-ux-design,Create UX,CU,"Guidance through realizing the plan for your UX, strongly recommended if a UI is a primary piece of the proposed project.",,,2-planning,bmad-prd,,false,planning_artifacts,ux design
+BMad Method,bmad-create-architecture,Create Architecture,CA,Guided workflow to document technical decisions.,,,3-solutioning,,,true,planning_artifacts,architecture
+BMad Method,bmad-create-epics-and-stories,Create Epics and Stories,CE,,,,3-solutioning,bmad-create-architecture,,true,planning_artifacts,epics and stories
+BMad Method,bmad-check-implementation-readiness,Check Implementation Readiness,IR,Ensure PRD UX Architecture and Epics Stories are aligned.,,,3-solutioning,bmad-create-epics-and-stories,,true,planning_artifacts,readiness report
+BMad Method,bmad-sprint-planning,Sprint Planning,SP,Kicks off implementation by producing a plan the implementation agents will follow in sequence for every story.,,,4-implementation,,,true,implementation_artifacts,sprint status
+BMad Method,bmad-sprint-status,Sprint Status,SS,Anytime: Summarize sprint status and route to next workflow.,,,4-implementation,bmad-sprint-planning,,false,,
+BMad Method,bmad-create-story,Create Story,CS,Story cycle start: Prepare first found story in the sprint plan that is next or a specific epic/story designation.,create,,4-implementation,bmad-sprint-planning,bmad-create-story:validate,true,implementation_artifacts,story
+BMad Method,bmad-create-story,Validate Story,VS,Validates story readiness and completeness before development work begins.,validate,,4-implementation,bmad-create-story:create,bmad-dev-story,false,implementation_artifacts,story validation report
+BMad Method,bmad-dev-story,Dev Story,DS,Story cycle: Execute story implementation tasks and tests then CR then back to DS if fixes needed.,,,4-implementation,bmad-create-story:validate,,true,,
+BMad Method,bmad-code-review,Code Review,CR,Story cycle: If issues back to DS if approved then next CS or ER if epic complete.,,,4-implementation,bmad-dev-story,,false,,
+BMad Method,bmad-checkpoint-preview,Checkpoint,CK,Guided walkthrough of a change from purpose and context into details. Use for human review of commits branches or PRs.,,,4-implementation,,,false,,
+BMad Method,bmad-qa-generate-e2e-tests,QA Automation Test,QA,Generate automated API and E2E tests for implemented code. NOT for code review or story validation — use CR for that.,,,4-implementation,bmad-dev-story,,false,implementation_artifacts,test suite
+BMad Method,bmad-retrospective,Retrospective,ER,Optional at epic end: Review completed work lessons learned and next epic or if major issues consider CC.,,,4-implementation,bmad-code-review,,false,implementation_artifacts,retrospective
+BMad Method,bmad-investigate,Investigate,IN,Forensic case investigation calibrated to the input. Evidence-graded analysis with hypothesis tracking. Produces a structured case file.,,4-implementation,,,false,implementation_artifacts,investigation report

package/src/bmad-plus/packs/pack-dev-studio/upstream-sync.yaml

@@ -1,81 +1,81 @@
-# Pack Dev Studio — upstream-sync.yaml
-# Tracks the source commit and version from BMAD-METHOD for future updates
-
-upstream:
-  repository: https://github.com/bmad-code-org/BMAD-METHOD
-  version: "6.6.0"
-  commit: "0f852a38ac7c0ac30340b3aedc3aba4505b7c14a"
-  synced_at: "2026-05-17"
-  license: MIT
-
-adaptations:
-  format: "BMAD+ BWML (Workflow Markup Language)"
-  personas:
-    Mary: Miriam (מרים)
-    Paige: Huldah (חולדה)
-    John: Yosef (יוסף)
-    Sally: Rachel (רחל)
-    Winston: Bezalel (בצלאל)
-    Amelia: Oholiab (אהליאב)
-  removed_dependencies:
-    - customize.toml (3-layer TOML config system)
-    - resolve_customization.py (Python variable resolver)
-    - resolve_config.py (Python config merger)
-    - analyze_sources.py (Python source analyzer)
-    - config.yaml (per-project config)
-  added:
-    - BWML specification (shared/bwml-spec.md)
-    - Dev Studio orchestrator
-    - Specialized persona naming
-    - BMAD+ pack integration (module.yaml, CLI, i18n)
-
-source_mapping:
-  categories/analysis:
-    - src/bmm-skills/1-analysis/bmad-agent-analyst → analyst-agent.md
-    - src/bmm-skills/1-analysis/bmad-agent-tech-writer → tech-writer-agent.md
-    - src/bmm-skills/1-analysis/bmad-product-brief → product-brief.md
-    - src/bmm-skills/1-analysis/bmad-prfaq → prfaq.md
-    - src/bmm-skills/1-analysis/bmad-document-project → document-project.md
-    - src/bmm-skills/1-analysis/research/bmad-market-research → market-research.md
-    - src/bmm-skills/1-analysis/research/bmad-domain-research → domain-research.md
-    - src/bmm-skills/1-analysis/research/bmad-technical-research → technical-research.md
-  categories/planning:
-    - src/bmm-skills/2-plan-workflows/bmad-agent-pm → pm-agent.md
-    - src/bmm-skills/2-plan-workflows/bmad-agent-ux-designer → ux-designer-agent.md
-    - src/bmm-skills/2-plan-workflows/bmad-create-prd → create-prd.md
-    - src/bmm-skills/2-plan-workflows/bmad-create-ux-design → create-ux-design.md
-    - src/bmm-skills/2-plan-workflows/bmad-edit-prd → edit-prd.md
-    - src/bmm-skills/2-plan-workflows/bmad-prd → prd.md
-    - src/bmm-skills/2-plan-workflows/bmad-validate-prd → validate-prd.md
-  categories/architecture:
-    - src/bmm-skills/3-solutioning/bmad-agent-architect → architect-agent.md
-    - src/bmm-skills/3-solutioning/bmad-create-architecture → create-architecture.md + steps/
-    - src/bmm-skills/3-solutioning/bmad-create-epics-and-stories → create-epics-stories.md
-    - src/bmm-skills/3-solutioning/bmad-check-implementation-readiness → implementation-readiness.md
-    - src/bmm-skills/3-solutioning/bmad-generate-project-context → generate-project-context.md
-  categories/implementation:
-    - src/bmm-skills/4-implementation/bmad-agent-dev → dev-agent.md
-    - src/bmm-skills/4-implementation/bmad-dev-story → dev-story.md + checklist
-    - src/bmm-skills/4-implementation/bmad-create-story → create-story.md
-    - src/bmm-skills/4-implementation/bmad-sprint-planning → sprint-planning.md
-    - src/bmm-skills/4-implementation/bmad-sprint-status → sprint-status.md
-    - src/bmm-skills/4-implementation/bmad-code-review → code-review.md + steps/
-    - src/bmm-skills/4-implementation/bmad-quick-dev → quick-dev.md
-    - src/bmm-skills/4-implementation/bmad-correct-course → correct-course.md
-    - src/bmm-skills/4-implementation/bmad-checkpoint-preview → checkpoint-preview.md
-    - src/bmm-skills/4-implementation/bmad-investigate → investigate.md
-    - src/bmm-skills/4-implementation/bmad-qa-generate-e2e-tests → qa-e2e-tests.md
-    - src/bmm-skills/4-implementation/bmad-retrospective → retrospective.md
-  categories/utilities:
-    - src/core-skills/bmad-distillator → distillator.md
-    - src/core-skills/bmad-party-mode → party-mode.md
-    - src/core-skills/bmad-brainstorming → brainstorming.md
-    - src/core-skills/bmad-editorial-review-prose → editorial-review-prose.md
-    - src/core-skills/bmad-editorial-review-structure → editorial-review-structure.md
-    - src/core-skills/bmad-review-adversarial-general → adversarial-review.md
-    - src/core-skills/bmad-review-edge-case-hunter → edge-case-hunter.md
-    - src/core-skills/bmad-advanced-elicitation → advanced-elicitation.md
-    - src/core-skills/bmad-shard-doc → shard-doc.md
-    - src/core-skills/bmad-index-docs → index-docs.md
-    - src/core-skills/bmad-help → bmad-help.md
-    - src/core-skills/bmad-customize → customize.md
+# Pack Dev Studio — upstream-sync.yaml
+# Tracks the source commit and version from BMAD-METHOD for future updates
+
+upstream:
+  repository: https://github.com/bmad-code-org/BMAD-METHOD
+  version: "6.6.0"
+  commit: "0f852a38ac7c0ac30340b3aedc3aba4505b7c14a"
+  synced_at: "2026-05-17"
+  license: MIT
+
+adaptations:
+  format: "BMAD+ BWML (Workflow Markup Language)"
+  personas:
+    Mary: Miriam (מרים)
+    Paige: Huldah (חולדה)
+    John: Yosef (יוסף)
+    Sally: Rachel (רחל)
+    Winston: Bezalel (בצלאל)
+    Amelia: Oholiab (אהליאב)
+  removed_dependencies:
+    - customize.toml (3-layer TOML config system)
+    - resolve_customization.py (Python variable resolver)
+    - resolve_config.py (Python config merger)
+    - analyze_sources.py (Python source analyzer)
+    - config.yaml (per-project config)
+  added:
+    - BWML specification (shared/bwml-spec.md)
+    - Dev Studio orchestrator
+    - Specialized persona naming
+    - BMAD+ pack integration (module.yaml, CLI, i18n)
+
+source_mapping:
+  categories/analysis:
+    - src/bmm-skills/1-analysis/bmad-agent-analyst → analyst-agent.md
+    - src/bmm-skills/1-analysis/bmad-agent-tech-writer → tech-writer-agent.md
+    - src/bmm-skills/1-analysis/bmad-product-brief → product-brief.md
+    - src/bmm-skills/1-analysis/bmad-prfaq → prfaq.md
+    - src/bmm-skills/1-analysis/bmad-document-project → document-project.md
+    - src/bmm-skills/1-analysis/research/bmad-market-research → market-research.md
+    - src/bmm-skills/1-analysis/research/bmad-domain-research → domain-research.md
+    - src/bmm-skills/1-analysis/research/bmad-technical-research → technical-research.md
+  categories/planning:
+    - src/bmm-skills/2-plan-workflows/bmad-agent-pm → pm-agent.md
+    - src/bmm-skills/2-plan-workflows/bmad-agent-ux-designer → ux-designer-agent.md
+    - src/bmm-skills/2-plan-workflows/bmad-create-prd → create-prd.md
+    - src/bmm-skills/2-plan-workflows/bmad-create-ux-design → create-ux-design.md
+    - src/bmm-skills/2-plan-workflows/bmad-edit-prd → edit-prd.md
+    - src/bmm-skills/2-plan-workflows/bmad-prd → prd.md
+    - src/bmm-skills/2-plan-workflows/bmad-validate-prd → validate-prd.md
+  categories/architecture:
+    - src/bmm-skills/3-solutioning/bmad-agent-architect → architect-agent.md
+    - src/bmm-skills/3-solutioning/bmad-create-architecture → create-architecture.md + steps/
+    - src/bmm-skills/3-solutioning/bmad-create-epics-and-stories → create-epics-stories.md
+    - src/bmm-skills/3-solutioning/bmad-check-implementation-readiness → implementation-readiness.md
+    - src/bmm-skills/3-solutioning/bmad-generate-project-context → generate-project-context.md
+  categories/implementation:
+    - src/bmm-skills/4-implementation/bmad-agent-dev → dev-agent.md
+    - src/bmm-skills/4-implementation/bmad-dev-story → dev-story.md + checklist
+    - src/bmm-skills/4-implementation/bmad-create-story → create-story.md
+    - src/bmm-skills/4-implementation/bmad-sprint-planning → sprint-planning.md
+    - src/bmm-skills/4-implementation/bmad-sprint-status → sprint-status.md
+    - src/bmm-skills/4-implementation/bmad-code-review → code-review.md + steps/
+    - src/bmm-skills/4-implementation/bmad-quick-dev → quick-dev.md
+    - src/bmm-skills/4-implementation/bmad-correct-course → correct-course.md
+    - src/bmm-skills/4-implementation/bmad-checkpoint-preview → checkpoint-preview.md
+    - src/bmm-skills/4-implementation/bmad-investigate → investigate.md
+    - src/bmm-skills/4-implementation/bmad-qa-generate-e2e-tests → qa-e2e-tests.md
+    - src/bmm-skills/4-implementation/bmad-retrospective → retrospective.md
+  categories/utilities:
+    - src/core-skills/bmad-distillator → distillator.md
+    - src/core-skills/bmad-party-mode → party-mode.md
+    - src/core-skills/bmad-brainstorming → brainstorming.md
+    - src/core-skills/bmad-editorial-review-prose → editorial-review-prose.md
+    - src/core-skills/bmad-editorial-review-structure → editorial-review-structure.md
+    - src/core-skills/bmad-review-adversarial-general → adversarial-review.md
+    - src/core-skills/bmad-review-edge-case-hunter → edge-case-hunter.md
+    - src/core-skills/bmad-advanced-elicitation → advanced-elicitation.md
+    - src/core-skills/bmad-shard-doc → shard-doc.md
+    - src/core-skills/bmad-index-docs → index-docs.md
+    - src/core-skills/bmad-help → bmad-help.md
+    - src/core-skills/bmad-customize → customize.md

package/src/bmad-plus/packs/pack-memory/shared/memory-protocol.md

@@ -29,6 +29,20 @@
     └── <hash>.yaml     ← Per-project metadata
 ```
 
+### Portfolio Brain (workspace-level, takes precedence)
+
+If a `_brain/` directory exists in the project directory or any ancestor (e.g. `D:\workspace\_brain\` above `D:\workspace\clients\my-project\`), install links the project to it instead of `~/.bmad-plus/brain`. The `BMAD_PLUS_BRAIN` env var overrides all auto-detection.
+
+The kind of brain that was linked is recorded in `.brain-link`:
+
+```json
+{ "linked_brain": "D:\\workspace\\_brain", "brain_type": "portfolio", "linked_at": "…" }
+```
+
+`brain_type` values: `portfolio` (workspace `_brain/` or env var) · `bmad-global` (`~/.bmad-plus/brain`) · `claude-memory` (`~/.claude/memory`).
+
+**Rule for agents**: a portfolio brain has its **own** conventions and layout — read its entry point (`README.md` / `AGENTS.md` / `HOT.md`) first and follow them. Do NOT assume the BMAD+ global layout above; in particular do not create `identity.yaml` or `projects/` inside a portfolio brain uninvited.
+
 ---
 
 ## Protocol: Session Start (READ)

package/src/bmad-plus/packs/pack-seo/SKILL.md

@@ -1,171 +1,171 @@
----
-name: seo-engine
-description: >
-  BMAD+ SEO Engine v2.1 — Complete SEO audit engine with 3 multi-role agents,
-  6-phase workflow, Python toolkit, Google API integration, and PageSpeed
-  perfection loop. Use when user says /seo or any SEO-related command.
----
-
-# SEO Engine — Orchestrator
-
-> By Laurent Rochetta | BMAD+ SEO Engine v2.1
-
-## Quick Start
-
-This skill orchestrates 3 specialized agents through a structured workflow.
-Load the full agent files only when activating that agent's phase.
-
-## Command Router
-
-When the user issues a `/seo` command, route as follows:
-
-| Command | Agent(s) | Action |
-|---------|----------|--------|
-| `/seo full <url>` | Scout → Judge → Chief | Run all 6 phases |
-| `/seo quick <url>` | Scout → Judge → Chief | Run phases 1–4 only |
-| `/seo technical <url>` | Scout (Inspector) | Phase 2 technical only |
-| `/seo content <url>` | Judge (Content Expert) | Phase 2 content only |
-| `/seo geo <url>` | Judge (GEO Analyst) | Phase 3 only |
-| `/seo schema <url>` | Judge (Schema Master) | Schema detection + validation |
-| `/seo images <url>` | Judge (Content Expert) | Image audit subset |
-| `/seo hreflang <url>` | Scout (Inspector) | Hreflang audit, ref: `ref/hreflang-rules.md` |
-| `/seo pagespeed <url>` | Scout + Chief | PageSpeed perfection loop |
-| `/seo plan <type>` | Chief (Strategist) | Strategic plan by industry |
-| `/seo fix` | Chief (Strategist) | Auto-generate fixes from last audit |
-| `/seo history` | Chief (Reporter) | Show score history |
-| `/seo compare` | Chief (Reporter) | Compare with previous audit |
-| `/seo competitor <url1> <url2>` | Scout + Judge + Chief | Benchmark two sites |
-| `/seo api <url>` | (script) | Run Google APIs (PSI + CrUX + Rich Results) |
-
-## Full Audit Orchestration (`/seo full`)
-
-### Phase 1 — Reconnaissance
-**Agent**: Scout (Crawler role)
-**Load**: `agent/seo-scout.md`
-
-1. Run `scripts/seo_fetch.py <url> --json` to fetch homepage
-2. Run `scripts/seo_crawl.py <url> --depth 2 --max 25 --json` to discover structure
-3. Detect business type from content analysis:
-   - **SaaS**: pricing page, features page, signup CTA
-   - **E-commerce**: product pages, cart, categories
-   - **Local business**: address, phone, map, opening hours
-   - **Publisher**: articles, blog, news, RSS feed
-   - **Agency**: services, portfolio, case studies
-4. Check for `/robots.txt`, `/sitemap.xml`, `/llms.txt`
-
-**Checkpoint**: Report discovery summary, ask "Continue with full audit?"
-
-### Phase 2 — Deep Scan (PARALLEL)
-**Agents**: Scout (Inspector) + Judge (Content Expert + Schema Master)
-**Load**: `agent/seo-scout.md` + `agent/seo-judge.md`
-
-Run Scout and Judge **simultaneously** on each discovered page:
-
-**Scout checks** (9 categories — see `agent/seo-scout.md`):
-- Crawlability, Indexability, Security, URL Structure, Mobile
-- Core Web Vitals, Structured Data detection, JS Rendering, IndexNow
-
-**Judge checks** (see `agent/seo-judge.md`):
-- E-E-A-T evaluation (ref: `ref/eeat-criteria.md`)
-- Content quality (ref: `ref/quality-gates.md`)
-- Schema validation (ref: `ref/schema-catalog.md`)
-- Image audit
-- Internal/external link analysis
-
-**Optional**: Run `scripts/seo_apis.py --all <url>` for live PageSpeed + CrUX data.
-
-Use `scripts/seo_parse.py <file> --url <url> --json` on fetched HTML.
-Use `scripts/seo_screenshot.py <url> --viewport mobile` for visual audit.
-
-### Phase 3 — AI Readiness & GEO
-**Agent**: Judge (GEO Analyst role)
-**Reference**: `ref/geo-signals.md`
-
-- Check AI crawler access (GPTBot, ClaudeBot, PerplexityBot)
-- Verify llms.txt compliance
-- Score passage citability (134–167 word blocks)
-- Compute AI Readiness Score (0–100)
-
-### Phase 4 — Scoring
-**Agent**: Chief (Scorer role)
-**Load**: `agent/seo-chief.md`
-
-Compute SEO Health Score (0–100):
-
-| Category | Weight |
-|----------|--------|
-| Technical SEO | 20% |
-| Content & E-E-A-T | 22% |
-| On-Page SEO | 18% |
-| Schema | 10% |
-| Performance (CWV) | 12% |
-| AI Readiness (GEO) | 12% |
-| Images | 6% |
-
-### Phase 5 — Action Plan
-**Agent**: Chief (Strategist role)
-
-1. Classify issues: 🔴 Critical → 🟠 High → 🟡 Medium → 🟢 Low
-2. Identify quick wins (highest impact/effort ratio)
-3. Generate 30/60/90-day roadmap
-4. Auto-generate code fixes (meta tags, schema JSON-LD, robots.txt, llms.txt)
-
-**Checkpoint**: "Here's the plan. Apply fixes automatically?"
-
-### Phase 5b — PageSpeed Perfection Loop
-**Agents**: Scout + Chief
-**Reference**: `pagespeed-playbook.md` + `checklist.md`
-
-Use `scripts/seo_apis.py --pagespeed <url>` for live scores.
-Loop: fix one issue → re-test → verify improvement → next issue.
-Target: 100% on all 4 categories (Performance, Accessibility, Best Practices, SEO).
-
-### Phase 6 — Monitoring (optional)
-**Agent**: Scout (Crawler role)
-
-Save results to `.bmad-seo/history/<domain>-<date>.json`.
-On re-audit: compare with previous, show deltas.
-
----
-
-## Python Toolkit
-
-| Script | Usage | Dependencies |
-|--------|-------|-------------|
-| `seo_fetch.py` | `python scripts/seo_fetch.py <url> [--ua googlebot] [--json]` | requests |
-| `seo_parse.py` | `python scripts/seo_parse.py <file> --url <url> --json` | beautifulsoup4, lxml |
-| `seo_crawl.py` | `python scripts/seo_crawl.py <url> --depth 2 --max 25 --json` | requests |
-| `seo_screenshot.py` | `python scripts/seo_screenshot.py <url> --viewport mobile` | playwright |
-| `seo_apis.py` | `python scripts/seo_apis.py --pagespeed <url>` | requests |
-
-**Install dependencies**: `pip install -r requirements.txt`
-
-**Environment**: Set `GOOGLE_API_KEY` for Google API access (free, no OAuth).
-
----
-
-## Reference Files (lazy-load)
-
-Only load these when the relevant agent needs them:
-- `ref/cwv-thresholds.md` — Core Web Vitals 2026
-- `ref/schema-catalog.md` — Schema.org v29.4 types
-- `ref/eeat-criteria.md` — E-E-A-T scoring grid
-- `ref/geo-signals.md` — AI search signals
-- `ref/quality-gates.md` — Content thresholds
-- `ref/schema-templates.json` — 14 JSON-LD templates
-
----
-
-## Industry-Specific Plans (`/seo plan <type>`)
-
-| Type | Focus |
-|------|-------|
-| `saas` | Pricing pages, feature comparison, trial CTAs, documentation SEO |
-| `ecommerce` | Product schema, category pages, faceted navigation, review markup |
-| `local` | LocalBusiness schema, Google Business Profile, location pages, NAP consistency |
-| `publisher` | Article schema, author E-E-A-T, news sitemap, pagination |
-| `agency` | Service schema, portfolio, case studies, city-specific landing pages |
-
----
-
-*BMAD+ SEO Engine v2.1 — By Laurent Rochetta*
+---
+name: seo-engine
+description: >
+  BMAD+ SEO Engine v2.1 — Complete SEO audit engine with 3 multi-role agents,
+  6-phase workflow, Python toolkit, Google API integration, and PageSpeed
+  perfection loop. Use when user says /seo or any SEO-related command.
+---
+
+# SEO Engine — Orchestrator
+
+> By Laurent Rochetta | BMAD+ SEO Engine v2.1
+
+## Quick Start
+
+This skill orchestrates 3 specialized agents through a structured workflow.
+Load the full agent files only when activating that agent's phase.
+
+## Command Router
+
+When the user issues a `/seo` command, route as follows:
+
+| Command | Agent(s) | Action |
+|---------|----------|--------|
+| `/seo full <url>` | Scout → Judge → Chief | Run all 6 phases |
+| `/seo quick <url>` | Scout → Judge → Chief | Run phases 1–4 only |
+| `/seo technical <url>` | Scout (Inspector) | Phase 2 technical only |
+| `/seo content <url>` | Judge (Content Expert) | Phase 2 content only |
+| `/seo geo <url>` | Judge (GEO Analyst) | Phase 3 only |
+| `/seo schema <url>` | Judge (Schema Master) | Schema detection + validation |
+| `/seo images <url>` | Judge (Content Expert) | Image audit subset |
+| `/seo hreflang <url>` | Scout (Inspector) | Hreflang audit, ref: `ref/hreflang-rules.md` |
+| `/seo pagespeed <url>` | Scout + Chief | PageSpeed perfection loop |
+| `/seo plan <type>` | Chief (Strategist) | Strategic plan by industry |
+| `/seo fix` | Chief (Strategist) | Auto-generate fixes from last audit |
+| `/seo history` | Chief (Reporter) | Show score history |
+| `/seo compare` | Chief (Reporter) | Compare with previous audit |
+| `/seo competitor <url1> <url2>` | Scout + Judge + Chief | Benchmark two sites |
+| `/seo api <url>` | (script) | Run Google APIs (PSI + CrUX + Rich Results) |
+
+## Full Audit Orchestration (`/seo full`)
+
+### Phase 1 — Reconnaissance
+**Agent**: Scout (Crawler role)
+**Load**: `seo-scout.md`
+
+1. Run `scripts/seo_fetch.py <url> --json` to fetch homepage
+2. Run `scripts/seo_crawl.py <url> --depth 2 --max 25 --json` to discover structure
+3. Detect business type from content analysis:
+   - **SaaS**: pricing page, features page, signup CTA
+   - **E-commerce**: product pages, cart, categories
+   - **Local business**: address, phone, map, opening hours
+   - **Publisher**: articles, blog, news, RSS feed
+   - **Agency**: services, portfolio, case studies
+4. Check for `/robots.txt`, `/sitemap.xml`, `/llms.txt`
+
+**Checkpoint**: Report discovery summary, ask "Continue with full audit?"
+
+### Phase 2 — Deep Scan (PARALLEL)
+**Agents**: Scout (Inspector) + Judge (Content Expert + Schema Master)
+**Load**: `seo-scout.md` + `seo-judge.md`
+
+Run Scout and Judge **simultaneously** on each discovered page:
+
+**Scout checks** (9 categories — see `seo-scout.md`):
+- Crawlability, Indexability, Security, URL Structure, Mobile
+- Core Web Vitals, Structured Data detection, JS Rendering, IndexNow
+
+**Judge checks** (see `seo-judge.md`):
+- E-E-A-T evaluation (ref: `ref/eeat-criteria.md`)
+- Content quality (ref: `ref/quality-gates.md`)
+- Schema validation (ref: `ref/schema-catalog.md`)
+- Image audit
+- Internal/external link analysis
+
+**Optional**: Run `scripts/seo_apis.py --all <url>` for live PageSpeed + CrUX data.
+
+Use `scripts/seo_parse.py <file> --url <url> --json` on fetched HTML.
+Use `scripts/seo_screenshot.py <url> --viewport mobile` for visual audit.
+
+### Phase 3 — AI Readiness & GEO
+**Agent**: Judge (GEO Analyst role)
+**Reference**: `ref/geo-signals.md`
+
+- Check AI crawler access (GPTBot, ClaudeBot, PerplexityBot)
+- Verify llms.txt compliance
+- Score passage citability (134–167 word blocks)
+- Compute AI Readiness Score (0–100)
+
+### Phase 4 — Scoring
+**Agent**: Chief (Scorer role)
+**Load**: `seo-chief.md`
+
+Compute SEO Health Score (0–100):
+
+| Category | Weight |
+|----------|--------|
+| Technical SEO | 20% |
+| Content & E-E-A-T | 22% |
+| On-Page SEO | 18% |
+| Schema | 10% |
+| Performance (CWV) | 12% |
+| AI Readiness (GEO) | 12% |
+| Images | 6% |
+
+### Phase 5 — Action Plan
+**Agent**: Chief (Strategist role)
+
+1. Classify issues: 🔴 Critical → 🟠 High → 🟡 Medium → 🟢 Low
+2. Identify quick wins (highest impact/effort ratio)
+3. Generate 30/60/90-day roadmap
+4. Auto-generate code fixes (meta tags, schema JSON-LD, robots.txt, llms.txt)
+
+**Checkpoint**: "Here's the plan. Apply fixes automatically?"
+
+### Phase 5b — PageSpeed Perfection Loop
+**Agents**: Scout + Chief
+**Reference**: `pagespeed-playbook.md` + `checklist.md`
+
+Use `scripts/seo_apis.py --pagespeed <url>` for live scores.
+Loop: fix one issue → re-test → verify improvement → next issue.
+Target: 100% on all 4 categories (Performance, Accessibility, Best Practices, SEO).
+
+### Phase 6 — Monitoring (optional)
+**Agent**: Scout (Crawler role)
+
+Save results to `.bmad-seo/history/<domain>-<date>.json`.
+On re-audit: compare with previous, show deltas.
+
+---
+
+## Python Toolkit
+
+| Script | Usage | Dependencies |
+|--------|-------|-------------|
+| `seo_fetch.py` | `python scripts/seo_fetch.py <url> [--ua googlebot] [--json]` | requests |
+| `seo_parse.py` | `python scripts/seo_parse.py <file> --url <url> --json` | beautifulsoup4, lxml |
+| `seo_crawl.py` | `python scripts/seo_crawl.py <url> --depth 2 --max 25 --json` | requests |
+| `seo_screenshot.py` | `python scripts/seo_screenshot.py <url> --viewport mobile` | playwright |
+| `seo_apis.py` | `python scripts/seo_apis.py --pagespeed <url>` | requests |
+
+**Install dependencies**: `pip install -r requirements.txt`
+
+**Environment**: Set `GOOGLE_API_KEY` for Google API access (free, no OAuth).
+
+---
+
+## Reference Files (lazy-load)
+
+Only load these when the relevant agent needs them:
+- `ref/cwv-thresholds.md` — Core Web Vitals 2026
+- `ref/schema-catalog.md` — Schema.org v29.4 types
+- `ref/eeat-criteria.md` — E-E-A-T scoring grid
+- `ref/geo-signals.md` — AI search signals
+- `ref/quality-gates.md` — Content thresholds
+- `ref/schema-templates.json` — 14 JSON-LD templates
+
+---
+
+## Industry-Specific Plans (`/seo plan <type>`)
+
+| Type | Focus |
+|------|-------|
+| `saas` | Pricing pages, feature comparison, trial CTAs, documentation SEO |
+| `ecommerce` | Product schema, category pages, faceted navigation, review markup |
+| `local` | LocalBusiness schema, Google Business Profile, location pages, NAP consistency |
+| `publisher` | Article schema, author E-E-A-T, news sitemap, pagination |
+| `agency` | Service schema, portfolio, case studies, city-specific landing pages |
+
+---
+
+*BMAD+ SEO Engine v2.1 — By Laurent Rochetta*