Skip to content

Commit 410126b

Browse files
authored
fix: make all skills self-contained for BMAD-METHOD #2182 (#23)
* fix: make all skills self-contained by removing _bmad/wds/ path dependencies - Duplicate referenced innards into wds-0-project-setup/resources/ (templates from wds-1, wds-2, wds-4, wds-7 and freya agent guides) - Duplicate project-brief template into saga agent-guide resources - Update folder-guide template refs to use local ./resources/ paths - Change cross-skill invocations to skill:<name> syntax - Replace dead _bmad/wds/docs/method/ refs with skill invocation hints - Preserve config.yaml refs (module-level, handled by installer) Supports bmad-code-org/BMAD-METHOD#2182 which stops copying skill content into _bmad/ at install time. * fix: update broken relative paths in duplicated resource files Fix ../../workflows/ references in copied agent guides that were valid at their original location but broke after duplication into wds-0-project-setup/resources/. Replaced with skill:<name> syntax.
1 parent 6fb7b21 commit 410126b

46 files changed

Lines changed: 5449 additions & 30 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

src/data/agent-guides/freya/content-creation.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@
6969
- Content is complex
7070

7171
**Process:**
72-
Load: `{project-root}/_bmad/wds/workflows/wds-6-asset-generation/`
72+
Load: `skill:wds-6-asset-generation`
7373

7474
**6-Step Framework:**
7575
1. Define purpose & success criteria
@@ -256,7 +256,7 @@ Features (WHAT): 10K templates, smart pricing, e-signatures
256256

257257
## Related Resources
258258

259-
- **Asset Generation:** `{project-root}/_bmad/wds/workflows/wds-6-asset-generation/`
259+
- **Asset Generation:** `skill:wds-6-asset-generation`
260260
- **Content Purpose Guide:** `../../docs/method/content-purpose-guide.md`
261261
- **Tone of Voice Guide:** `../../docs/method/tone-of-voice-guide.md`
262262
- **Customer Awareness Cycle:** `../../docs/models/customer-awareness-cycle.md`
Lines changed: 187 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,187 @@
1+
# Project Brief: {{project_name}}
2+
3+
> Complete Strategic Foundation
4+
5+
**Created:** {{date}}
6+
**Author:** {{user_name}}
7+
**Brief Type:** Complete
8+
9+
---
10+
11+
## Vision
12+
13+
{{vision}}
14+
15+
---
16+
17+
## Positioning Statement
18+
19+
{{positioning_statement}}
20+
21+
**Breakdown:**
22+
23+
- **Target Customer:** {{target_customer}}
24+
- **Need/Opportunity:** {{need_opportunity}}
25+
- **Category:** {{category}}
26+
- **Key Benefit:** {{key_benefit}}
27+
- **Differentiator:** {{differentiator}}
28+
29+
---
30+
31+
## Business Model
32+
33+
**Type:** {{business_model}}
34+
35+
## {{#if business_model_b2b}}
36+
37+
## Business Customer Profile (B2B)
38+
39+
{{business_customer_profile}}
40+
41+
### Buying Roles
42+
43+
| Role | Description |
44+
| ------------ | ----------------- |
45+
| **Buyer** | {{buyer_role}} |
46+
| **Champion** | {{champion_role}} |
47+
| **User** | {{user_role}} |
48+
49+
{{/if}}
50+
51+
---
52+
53+
## {{#if business_model_b2b}}User Profile (within Business){{else}}Ideal Customer Profile (ICP){{/if}}
54+
55+
{{ideal_user_profile}}
56+
57+
### Secondary Users
58+
59+
{{secondary_users}}
60+
61+
---
62+
63+
## Success Criteria
64+
65+
{{success_criteria}}
66+
67+
---
68+
69+
## Competitive Landscape
70+
71+
{{competitive_landscape}}
72+
73+
### Our Unfair Advantage
74+
75+
{{unfair_advantage}}
76+
77+
---
78+
79+
## Constraints
80+
81+
{{constraints}}
82+
83+
---
84+
85+
## Platform & Device Strategy
86+
87+
**Primary Platform:** {{primary_platform}}
88+
89+
**Supported Devices:**
90+
{{supported_devices}}
91+
92+
**Device Priority:** {{device_priority}}
93+
94+
**Interaction Models:**
95+
{{interaction_models}}
96+
97+
**Technical Requirements:**
98+
- **Offline Functionality:** {{offline_requirements}}
99+
- **Native Features:** {{native_features_needed}}
100+
101+
**Platform Rationale:**
102+
{{platform_rationale}}
103+
104+
**Future Platform Plans:**
105+
{{future_platform_plans}}
106+
107+
**Design Implications:**
108+
{{design_implications}}
109+
110+
**Development Implications:**
111+
{{development_implications}}
112+
113+
---
114+
115+
## Tone of Voice
116+
117+
**For UI Microcopy & System Messages**
118+
119+
### Tone Attributes
120+
121+
1. **{{tone_attribute_1}}**: {{tone_description_1}}
122+
2. **{{tone_attribute_2}}**: {{tone_description_2}}
123+
3. **{{tone_attribute_3}}**: {{tone_description_3}}
124+
{{#if tone_attribute_4}}4. **{{tone_attribute_4}}**: {{tone_description_4}}{{/if}}
125+
{{#if tone_attribute_5}}5. **{{tone_attribute_5}}**: {{tone_description_5}}{{/if}}
126+
127+
### Examples
128+
129+
**Error Messages:**
130+
- ✅ {{tone_example_error_good}}
131+
- ❌ {{tone_example_error_bad}}
132+
133+
**Button Text:**
134+
- ✅ {{tone_example_button_good}}
135+
- ❌ {{tone_example_button_bad}}
136+
137+
**Empty States:**
138+
- ✅ {{tone_example_empty_good}}
139+
- ❌ {{tone_example_empty_bad}}
140+
141+
**Success Messages:**
142+
- ✅ {{tone_example_success_good}}
143+
- ❌ {{tone_example_success_bad}}
144+
145+
### Guidelines
146+
147+
**Do:**
148+
{{tone_do_guidelines}}
149+
150+
**Don't:**
151+
{{tone_dont_guidelines}}
152+
153+
---
154+
155+
*Note: Tone of Voice applies to UI microcopy (labels, buttons, errors, system messages). Strategic content (headlines, feature descriptions, value propositions) uses the Content Creation Workshop based on page-specific purpose and context.*
156+
157+
---
158+
159+
## Additional Context
160+
161+
{{additional_context}}
162+
163+
---
164+
165+
## Business Context
166+
167+
- **Primary Goal:** {{business_goal}}
168+
- **Solution:** {{solution}}
169+
- **Target Users:** {{target_users}}
170+
171+
*Full strategic analysis (business goals, personas, driving forces) is developed in [Phase 2: Trigger Mapping](../B-Trigger-Map/).*
172+
173+
---
174+
175+
## Next Steps
176+
177+
This complete brief provides strategic foundation for all design work:
178+
179+
- [ ] **Phase 2: Trigger Mapping** - Map user psychology to business goals
180+
- [ ] **Phase 3: PRD Platform** - Define technical foundation
181+
- [ ] **Phase 4: UX Design** - Begin sketching and specifications
182+
- [ ] **Phase 5: Design System** - If enabled, build components
183+
- [ ] **Phase 6: PRD Finalization** - Compile for development handoff
184+
185+
---
186+
187+
_Generated by Whiteport Design Studio_

src/data/agent-guides/saga/strategic-documentation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -213,7 +213,7 @@ Extracted from the Trigger Map to provide strategic grounding:
213213
214214
Generate complete Product Brief document using template.
215215
216-
**See:** `{project-root}/_bmad/wds/templates/wds-1-project-brief/project-brief.template.md`
216+
**See:** `./resources/project-brief.template.md`
217217

218218
---
219219

src/skills/freya.activation.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -174,9 +174,9 @@ tangible experiences. Sees design as storytelling — every screen tells part of
174174
## Pattern References
175175

176176
**Load these patterns when working:**
177-
- `_bmad/wds/docs/method/trigger-map-initiation.md` — How to create scenarios from Trigger Map
178-
- `_bmad/wds/docs/method/scenario-conversation-pattern.md` — How to walk through scenarios
179-
- `_bmad/wds/docs/method/ux-design-workflow.md` — How to create wireframes and designs
177+
- `trigger-map-initiation` — How to create scenarios from Trigger Map (via `skill:wds-3-scenarios`)
178+
- `scenario-conversation-pattern` — How to walk through scenarios (via `skill:wds-3-scenarios`)
179+
- `ux-design-workflow` — How to create wireframes and designs (via `skill:wds-4-ux-design`)
180180

181181
---
182182

src/skills/saga.activation.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -156,7 +156,7 @@ excited by clues, thrilled by patterns. Builds understanding through conversatio
156156
## Pattern References
157157

158158
**Load these patterns when working:**
159-
- `_bmad/wds/docs/method/discovery-conversation.md`
160-
- `_bmad/wds/docs/method/trigger-mapping.md`
161-
- `_bmad/wds/docs/method/strategic-documentation.md`
162-
- `_bmad/wds/docs/method/dream-up-approach.md`
159+
- `discovery-conversation` — via `skill:wds-1-project-brief`
160+
- `trigger-mapping` — via `skill:wds-2-trigger-mapping`
161+
- `strategic-documentation` — via `skill:wds-1-project-brief`
162+
- `dream-up-approach` — via `skill:wds-1-project-brief`

src/workflows/wds-0-alignment-signoff/steps-c/step-05l-finalize-contract.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ Finalize the contract document, review it with the user, present it for signing,
7878
- Ready to proceed to Project Brief
7979

8080
**Next**: Full Project Brief workflow
81-
`{project-root}/_bmad/wds/workflows/wds-1-project-brief/workflow.md`
81+
`skill:wds-1-project-brief`
8282

8383
### 3. Update State
8484

src/workflows/wds-0-alignment-signoff/steps-c/step-06b-finalize-signoff.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ Finalize the signoff document, present it to the user, guide through the approva
7777
- Ready to proceed to Project Brief
7878

7979
**Next**: Full Project Brief workflow
80-
`{project-root}/_bmad/wds/workflows/wds-1-project-brief/workflow.md`
80+
`skill:wds-1-project-brief`
8181

8282
### 3. Update State
8383

src/workflows/wds-0-alignment-signoff/workflow.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -143,4 +143,4 @@ Explore 10 alignment document sections (flexible order):
143143

144144
1. Update design log
145145
2. Proceed to Project Brief workflow:
146-
`{project-root}/_bmad/wds/workflows/wds-1-project-brief/workflow.md`
146+
`skill:wds-1-project-brief`

0 commit comments

Comments
 (0)