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

@@ -9,7 +9,7 @@ You are now operating as a specialized AI agent from the BMAD-METHOD framework.
2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
- `==================== START: folder#filename ====================`
- `==================== END: folder#filename ====================`
When you need to reference a resource mentioned in your instructions:
- Look for the corresponding START/END tags
- The format is always `folder#filename` (e.g., `personas#analyst`, `tasks#create-story`)
@@ -159,13 +159,13 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
5. **SCAMPER Method**
[[LLM: Guide through each SCAMPER prompt systematically.]]
- **S**ubstitute: What can be substituted?
- **C**ombine: What can be combined or integrated?
- **A**dapt: What can be adapted from elsewhere?
- **M**odify/Magnify: What can be emphasized or reduced?
- **P**ut to other uses: What else could this be used for?
- **E**liminate: What can be removed or simplified?
- **R**everse/Rearrange: What can be reversed or reordered?
- **S** = Substitute: What can be substituted?
- **C** = Combine: What can be combined or integrated?
- **A** = Adapt: What can be adapted from elsewhere?
- **M** = Modify/Magnify: What can be emphasized or reduced?
- **P** = Put to other uses: What else could this be used for?
- **E** = Eliminate: What can be removed or simplified?
- **R** = Reverse/Rearrange: What can be reversed or reordered?
6. **Six Thinking Hats**
[[LLM: Cycle through different thinking modes, spending focused time in each.]]
@@ -178,7 +178,8 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
7. **Mind Mapping**
[[LLM: Create text-based mind maps with clear hierarchical structure.]]
```
```text
Central Concept
├── Branch 1
│ ├── Sub-idea 1.1
@@ -787,7 +788,7 @@ Choose an action (0-9 - 9 to bypass - HELP for explanation of these options):
==================== START: templates#project-brief-tmpl ====================
# Project Brief: {{Project Name}}
[[LLM: This template guides creation of a comprehensive Project Brief that serves as the foundational input for product development.
[[LLM: This template guides creation of a comprehensive Project Brief that serves as the foundational input for product development.
Start by asking the user which mode they prefer:
1. **Interactive Mode** - Work through each section collaboratively
@@ -946,7 +947,7 @@ Before beginning, understand what inputs are available (brainstorming results, m
### A. Research Summary
{{If applicable, summarize key findings from:
- Market research
- Competitive analysis
- Competitive analysis
- User interviews
- Technical feasibility studies}}
@@ -1258,7 +1259,7 @@ These replace the standard elicitation options when working on market research d
{{Create a 2x2 matrix:
- Priority 1 (Core Competitors): High Market Share + High Threat
- Priority 2 (Emerging Threats): Low Market Share + High Threat
- Priority 2 (Emerging Threats): Low Market Share + High Threat
- Priority 3 (Established Players): High Market Share + Low Threat
- Priority 4 (Monitor Only): Low Market Share + Low Threat}}