diff --git a/docs/cs/reference/workflow-map.md b/docs/cs/reference/workflow-map.md index 4dd67dd83..7abbae330 100644 --- a/docs/cs/reference/workflow-map.md +++ b/docs/cs/reference/workflow-map.md @@ -37,7 +37,7 @@ Definujte, co budovat a pro koho. | Workflow | Účel | Produkuje | | --------------------------- | ---------------------------------------- | ------------ | | `bmad-create-prd` | Definice požadavků (FR/NFR) | `PRD.md` | -| `bmad-create-ux-design` | Návrh uživatelského zážitku (když záleží na UX) | `ux-spec.md` | +| `bmad-ux` | Návrh uživatelského zážitku (když záleží na UX) | `DESIGN.md`, `EXPERIENCE.md` | ## Fáze 3: Solutioning diff --git a/docs/cs/tutorials/getting-started.md b/docs/cs/tutorials/getting-started.md index 4aab934b9..f52f17c7e 100644 --- a/docs/cs/tutorials/getting-started.md +++ b/docs/cs/tutorials/getting-started.md @@ -150,7 +150,7 @@ Všechny workflow v této fázi jsou volitelné: - Spusťte `bmad-quick-dev` — zvládne plánování i implementaci v jednom workflow, přeskočte k implementaci :::note[UX Design (volitelné)] -Pokud má váš projekt uživatelské rozhraní, vyvolejte **UX-Designer agenta** (`bmad-agent-ux-designer`) a spusťte UX design workflow (`bmad-create-ux-design`) po vytvoření PRD. +Pokud má váš projekt uživatelské rozhraní, vyvolejte **UX-Designer agenta** (`bmad-agent-ux-designer`) a spusťte UX design workflow (`bmad-ux`) po vytvoření PRD. ::: ### Fáze 3: Solutioning (BMad Method/Enterprise) diff --git a/docs/fr/reference/workflow-map.md b/docs/fr/reference/workflow-map.md index 857cde03f..c3c4156ce 100644 --- a/docs/fr/reference/workflow-map.md +++ b/docs/fr/reference/workflow-map.md @@ -48,7 +48,7 @@ Définissez ce qu'il faut construire et pour qui. | Workflow | Objectif | Produit | |-------------------------|---------------------------------------------------------|--------------| | `bmad-create-prd` | Définissez les exigences (FRs/NFRs)[^1] | `PRD.md`[^2] | -| `bmad-create-ux-design` | Concevez l'expérience utilisateur (lorsque l'UX compte) | `ux-spec.md` | +| `bmad-ux` | Concevez l'expérience utilisateur (lorsque l'UX compte) | `DESIGN.md`, `EXPERIENCE.md` | ## Phase 3 : Solutioning diff --git a/docs/fr/tutorials/getting-started.md b/docs/fr/tutorials/getting-started.md index 8d98a5cb6..75a4f08f3 100644 --- a/docs/fr/tutorials/getting-started.md +++ b/docs/fr/tutorials/getting-started.md @@ -150,7 +150,7 @@ Tous les workflows de cette phase sont optionnels. [**Pas sûr de quel outil uti - Exécutez `bmad-quick-dev` — il gère la planification et l'implémentation dans un seul workflow, passez directement à l'implémentation :::note[Design UX (Optionnel)] -Si votre projet a une interface utilisateur, invoquez l'**agent Designer UX** (`bmad-agent-ux-designer`) et exécutez le workflow de design UX (`bmad-create-ux-design`) après avoir créé votre PRD. +Si votre projet a une interface utilisateur, invoquez l'**agent Designer UX** (`bmad-agent-ux-designer`) et exécutez le workflow de design UX (`bmad-ux`) après avoir créé votre PRD. ::: ### Phase 3 : Solutioning (méthode BMad/Enterprise) diff --git a/docs/reference/workflow-map.md b/docs/reference/workflow-map.md index e3368c7d4..6d71a3a1f 100644 --- a/docs/reference/workflow-map.md +++ b/docs/reference/workflow-map.md @@ -47,7 +47,7 @@ Define what to build and for whom. | Workflow | Purpose | Produces | |-------------------------|-------------------------------------------------------------------------------------|---------------------------------------------------| | `bmad-prd` | Create, update, or validate a PRD — facilitated discovery, three intents in one skill | Create/Update: `prd.md`, `addendum.md`, `decision-log.md`; Validate: `validation-report.html` + `.md` | -| `bmad-create-ux-design` | Design user experience (when UX matters) | `ux-spec.md` | +| `bmad-ux` | Design user experience (when UX matters) — DESIGN.md (visual) + EXPERIENCE.md (behavioral) spine pair | `DESIGN.md`, `EXPERIENCE.md`, `.decision-log.md` | :::tip[Three intents in one skill] `bmad-prd` handles the full PRD lifecycle. State your intent when invoking or the skill will ask: diff --git a/docs/tutorials/getting-started.md b/docs/tutorials/getting-started.md index 3806d28a6..869de2529 100644 --- a/docs/tutorials/getting-started.md +++ b/docs/tutorials/getting-started.md @@ -162,7 +162,7 @@ All workflows in this phase are optional. [**Not sure which to use?**](../explan - Run `bmad-quick-dev` — it handles planning and implementation in a single workflow, skip to implementation :::note[UX Design (Optional)] -If your project has a user interface, invoke the **UX-Designer agent** (`bmad-agent-ux-designer`) and run the UX design workflow (`bmad-create-ux-design`) after creating your PRD. +If your project has a user interface, invoke the **UX-Designer agent** (`bmad-agent-ux-designer`) and run the UX design workflow (`bmad-ux`) after creating your PRD. ::: ### Phase 3: Solutioning (BMad Method/Enterprise) diff --git a/docs/vi-vn/reference/workflow-map.md b/docs/vi-vn/reference/workflow-map.md index c4023e481..109b88cad 100644 --- a/docs/vi-vn/reference/workflow-map.md +++ b/docs/vi-vn/reference/workflow-map.md @@ -37,7 +37,7 @@ Xác định cần xây gì và xây cho ai. | Quy trình | Mục đích | Tạo ra | | --------------------------- | ---------------------------------------- | ------------ | | `bmad-create-prd` | Xác định yêu cầu (FR/NFR) | `PRD.md` | -| `bmad-create-ux-design` | Thiết kế trải nghiệm người dùng khi UX là yếu tố quan trọng | `ux-spec.md` | +| `bmad-ux` | Thiết kế trải nghiệm người dùng khi UX là yếu tố quan trọng | `DESIGN.md`, `EXPERIENCE.md` | ## Giai đoạn 3: Định hình giải pháp diff --git a/docs/vi-vn/tutorials/getting-started.md b/docs/vi-vn/tutorials/getting-started.md index 6a33a6e0a..af1dacf12 100644 --- a/docs/vi-vn/tutorials/getting-started.md +++ b/docs/vi-vn/tutorials/getting-started.md @@ -150,7 +150,7 @@ Tất cả workflow trong phase này đều là tùy chọn. [**Chưa chắc nê - Chạy `bmad-quick-dev` — workflow này gộp cả planning và implementation trong một lần, nên bạn có thể chuyển thẳng sang triển khai :::note[Thiết kế UX (Tùy chọn)] -Nếu dự án của bạn có giao diện người dùng, hãy gọi **UX-Designer agent** (`bmad-agent-ux-designer`) và chạy workflow thiết kế UX (`bmad-create-ux-design`) sau khi tạo PRD. +Nếu dự án của bạn có giao diện người dùng, hãy gọi **UX-Designer agent** (`bmad-agent-ux-designer`) và chạy workflow thiết kế UX (`bmad-ux`) sau khi tạo PRD. ::: ### Phase 3: Solutioning (BMad Method/Enterprise) diff --git a/docs/zh-cn/reference/workflow-map.md b/docs/zh-cn/reference/workflow-map.md index 75c23a2b4..be997ddf2 100644 --- a/docs/zh-cn/reference/workflow-map.md +++ b/docs/zh-cn/reference/workflow-map.md @@ -32,7 +32,7 @@ BMad Method（BMM）通过分阶段 workflow 逐步构建上下文，让智能 | Workflow | 目的 | 产出 | | --- | --- | --- | | `bmad-create-prd` | 明确 FR/NFR 与范围边界 | `PRD.md` | -| `bmad-create-ux-design` | 在 UX 复杂场景下补齐交互与体验方案 | `ux-spec.md` | +| `bmad-ux` | 在 UX 复杂场景下补齐交互与体验方案 | `DESIGN.md`, `EXPERIENCE.md` | ## 阶段 3：解决方案设计（Solutioning） diff --git a/docs/zh-cn/tutorials/getting-started.md b/docs/zh-cn/tutorials/getting-started.md index 2b37408cf..87db3c9d5 100644 --- a/docs/zh-cn/tutorials/getting-started.md +++ b/docs/zh-cn/tutorials/getting-started.md @@ -149,7 +149,7 @@ BMad-Help 将检测你已完成的内容，并准确推荐下一步该做什么 - 运行 `bmad-quick-dev` —— 它会在一个工作流里同时处理规划与实现，可直接进入实现阶段 :::note[UX 设计（可选）] -如果你的项目有用户界面，在创建 PRD 后调用 **UX-Designer 智能体**（`bmad-agent-ux-designer`），然后运行 UX 设计工作流（`bmad-create-ux-design`）。 +如果你的项目有用户界面，在创建 PRD 后调用 **UX-Designer 智能体**（`bmad-agent-ux-designer`），然后运行 UX 设计工作流（`bmad-ux`）。 ::: ### 阶段 3：解决方案设计（BMad Method/Enterprise） diff --git a/src/bmm-skills/2-plan-workflows/bmad-agent-ux-designer/customize.toml b/src/bmm-skills/2-plan-workflows/bmad-agent-ux-designer/customize.toml index 80d2ed319..8554e06c3 100644 --- a/src/bmm-skills/2-plan-workflows/bmad-agent-ux-designer/customize.toml +++ b/src/bmm-skills/2-plan-workflows/bmad-agent-ux-designer/customize.toml @@ -57,4 +57,4 @@ principles = [ [[agent.menu]] code = "CU" description = "Guidance through realizing the plan for your UX to inform architecture and implementation" -skill = "bmad-create-ux-design" +skill = "bmad-ux" diff --git a/src/bmm-skills/2-plan-workflows/bmad-prd/SKILL.md b/src/bmm-skills/2-plan-workflows/bmad-prd/SKILL.md index 0b636da43..2f29da936 100644 --- a/src/bmm-skills/2-plan-workflows/bmad-prd/SKILL.md +++ b/src/bmm-skills/2-plan-workflows/bmad-prd/SKILL.md @@ -85,5 +85,5 @@ Tell the user the sequence in one sentence, then walk it. Polish goes last so it 4. **Triage open items.** All Open Questions, `[ASSUMPTION]` tags, `[NOTE FOR PM]` callouts. Phase-blockers (would make the PRD unsafe for UX/architecture/epics) surfaced one at a time and resolved; non-blockers deferred with owner + revisit condition logged to `.decision-log.md`. If phase-blocker count is high, flag it. 5. **Polish.** Apply `{workflow.doc_standards}` to `prd.md` and `addendum.md` in declared order (structural passes before prose — prose should not polish soon-to-be-cut text). Parallelize across documents, sequential within. 6. **External handoffs.** Execute `{workflow.external_handoffs}`; surface returned URLs/IDs. Skip and flag unavailable tools. -7. **Close.** Set `prd.md` frontmatter `status: final` and `updated` to `{date}` so future invocations distinguish this PRD from in-progress drafts. Record finalization to `.decision-log.md`. Share artifact paths. Common next: `bmad-create-ux-design`, `bmad-create-architecture`, `bmad-create-epics-and-stories`; invoke `bmad-help` for authoritative routing. +7. **Close.** Set `prd.md` frontmatter `status: final` and `updated` to `{date}` so future invocations distinguish this PRD from in-progress drafts. Record finalization to `.decision-log.md`. Share artifact paths. Common next: `bmad-ux`, `bmad-create-architecture`, `bmad-create-epics-and-stories`; invoke `bmad-help` for authoritative routing. 8. Run `{workflow.on_complete}` if non-empty. diff --git a/src/bmm-skills/2-plan-workflows/bmad-ux/assets/validation-report-template.html b/src/bmm-skills/2-plan-workflows/bmad-ux/assets/validation-report-template.html index ef8e5371a..a5d39be8c 100644 --- a/src/bmm-skills/2-plan-workflows/bmad-ux/assets/validation-report-template.html +++ b/src/bmm-skills/2-plan-workflows/bmad-ux/assets/validation-report-template.html @@ -16,7 +16,7 @@ - The container width, the color tokens, the typography. - One dimension = one collapsible
. - Verdict pill uses the verdict-* class matching its judgment. - - Severity badge uses the sev-* class matching its level. + - Severity badge uses the badge-sev-* class matching its level. - Each extra reviewer (accessibility, adversarial, etc.) gets its own collapsible section below the rubric dimensions. - The footer always shows the artifact paths and timestamp. diff --git a/src/bmm-skills/2-plan-workflows/bmad-ux/references/validate.md b/src/bmm-skills/2-plan-workflows/bmad-ux/references/validate.md index 70466fcb8..48fc230cf 100644 --- a/src/bmm-skills/2-plan-workflows/bmad-ux/references/validate.md +++ b/src/bmm-skills/2-plan-workflows/bmad-ux/references/validate.md @@ -68,7 +68,7 @@ Under Validate intent, after every reviewer returns, render one consolidated rep 1. Read every `{doc_workspace}/review-*.md`. 2. Fill `{workflow.validation_report_template}`. No overall grade — the per-category verdicts and severity counts already say what's true. Synthesis paragraph lifts the rubric's overall verdict; add a second if extra reviewers shift the picture. One section per rubric category (open if thin / broken), one per extra reviewer (closed, adversarial voice preserved). 3. Write `{doc_workspace}/validation-report.html`. -4. Write the markdown twin `{doc_workspace}/validation-report.md` — same content grouped by severity. +4. Write the Markdown twin `{doc_workspace}/validation-report.md` — same content grouped by severity. 5. Open HTML: `python3 -c "import webbrowser, pathlib; webbrowser.open(pathlib.Path('{doc_workspace}/validation-report.html').resolve().as_uri())"`. Skip headless. Re-running overwrites the consolidated report; individual `review-*.md` files persist. diff --git a/src/bmm-skills/module-help.csv b/src/bmm-skills/module-help.csv index 82674cb5c..eb2d51c1c 100644 --- a/src/bmm-skills/module-help.csv +++ b/src/bmm-skills/module-help.csv @@ -16,7 +16,7 @@ BMad Method,bmad-technical-research,Technical Research,TR,Technical feasibility 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-ux,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