refactor: standardize formatting and improve readability across core documents (#211)

### CHANGES

- Add newlines and spacing for improved readability
- Standardize instructional text for consistency
- Renumber lists within tasks for better clarity
- Add language identifiers to various code blocks
- Update placeholder text for improved consistency
- Adjust descriptions and wording in multiple files
- Update VS Code settings and dictionary words
This commit is contained in:
Kayvan Sylvan
2025-06-14 06:33:59 -07:00
committed by GitHub
parent 726c3d35b6
commit 009c77f0f5
35 changed files with 515 additions and 349 deletions

View File

@@ -39,7 +39,7 @@ Request from the user:
#### 1.3 Create Planning Document
**STOP HERE AND CREATE PLAN FIRST**
IMPORTANT: STOP HERE AND CREATE PLAN FIRST
Create `expansion-packs/{pack-name}/plan.md` with:
@@ -85,7 +85,7 @@ Create `expansion-packs/{pack-name}/plan.md` with:
User approval received: [ ] Yes
```
**Wait for user approval before proceeding to Phase 2**
Important: Wait for user approval before proceeding to Phase 2
### Phase 2: Component Design
@@ -142,7 +142,7 @@ For each checklist:
### Phase 3: Implementation
**Only proceed after plan.md is approved**
IMPORTANT: Only proceed after plan.md is approved
#### 3.1 Create Directory Structure
@@ -227,7 +227,7 @@ post_install_message: |
### Phase 4: Content Creation
**Work through plan.md checklist systematically**
IMPORTANT: Work through plan.md checklist systematically!
#### 4.1 Create Orchestrator First
@@ -308,12 +308,6 @@ For each required data file:
- **Example**:
```
{sample content}
```
```
## Example: Healthcare Expansion Pack
```text
@@ -362,38 +356,38 @@ Required user data files:
### Planning Phase
6. "Here's the proposed plan. Please review and approve before we continue."
1. "Here's the proposed plan. Please review and approve before we continue."
### Orchestrator Design
7. "What key commands should the {pack-name} orchestrator support?"
8. "What's the typical workflow from start to finish?"
9. "How should it integrate with core BMAD agents?"
1. "What key commands should the {pack-name} orchestrator support?"
2. "What's the typical workflow from start to finish?"
3. "How should it integrate with core BMAD agents?"
### Agent Planning
10. "For agent '{name}', what is their specific expertise?"
11. "What tasks will this agent reference? (I'll create them)"
12. "What templates will this agent use? (I'll create them)"
13. "What data files will this agent need? (You'll provide these)"
1. "For agent '{name}', what is their specific expertise?"
2. "What tasks will this agent reference? (I'll create them)"
3. "What templates will this agent use? (I'll create them)"
4. "What data files will this agent need? (You'll provide these)"
### Task Design
14. "Describe the '{task}' process step-by-step"
15. "What information is needed to complete this task?"
16. "What should the output look like?"
1. "Describe the '{task}' process step-by-step"
2. "What information is needed to complete this task?"
3. "What should the output look like?"
### Template Creation
17. "What sections should the '{template}' document have?"
18. "Are there any required formats or standards?"
19. "Can you provide an example of a completed document?"
1. "What sections should the '{template}' document have?"
2. "Are there any required formats or standards?"
3. "Can you provide an example of a completed document?"
### Data Requirements
20. "For {data-file}, what information should it contain?"
21. "What format should this data be in?"
22. "Can you provide a sample?"
1. "For {data-file}, what information should it contain?"
2. "What format should this data be in?"
3. "Can you provide a sample?"
## Important Considerations