bmad 6.11
This commit is contained in:
@@ -0,0 +1,44 @@
|
||||
# Structure Models
|
||||
|
||||
Reference shapes for the structure pass. Pick the one matching the document's purpose and evaluate the document against its rules; a document that fits none cleanly is judged against the closest model, with the mismatch itself noted as a finding when the shape fights the purpose.
|
||||
|
||||
## Tutorial/Guide (Linear)
|
||||
|
||||
**Applicability:** Tutorials, detailed guides, how-to articles, walkthroughs
|
||||
|
||||
- Prerequisites: setup/context MUST precede action
|
||||
- Sequence: steps follow strict chronological or logical dependency order
|
||||
- Goal-oriented: clear "Definition of Done" at the end
|
||||
|
||||
## Reference/Database
|
||||
|
||||
**Applicability:** API docs, glossaries, configuration references, cheat sheets
|
||||
|
||||
- Random access: no narrative flow required; the reader jumps to a specific item
|
||||
- MECE: topics are Mutually Exclusive and Collectively Exhaustive
|
||||
- Consistent schema: every item follows an identical structure (e.g., Signature → Params → Returns)
|
||||
|
||||
## Explanation (Conceptual)
|
||||
|
||||
**Applicability:** Deep dives, architecture overviews, conceptual guides, whitepapers, project context
|
||||
|
||||
- Abstract to concrete: Definition → Context → Implementation/Example
|
||||
- Scaffolding: complex ideas built on established foundations
|
||||
|
||||
## Prompt/Task Definition (Functional)
|
||||
|
||||
**Applicability:** BMad skills and workflows, prompts, system instructions, agent definitions
|
||||
|
||||
- Meta-first: inputs, usage constraints, and context defined before instructions
|
||||
- Separation of concerns: instructions (logic) separate from data (content)
|
||||
- Explicit flow: execution order is stated, never implied
|
||||
|
||||
## Strategic/Context (Pyramid)
|
||||
|
||||
**Applicability:** PRDs, research reports, proposals, decision records
|
||||
|
||||
- Top-down: conclusion/status/recommendation starts the document
|
||||
- Grouping: supporting context grouped logically below the headline
|
||||
- Ordering: most critical information first
|
||||
- MECE: arguments/groups are Mutually Exclusive and Collectively Exhaustive
|
||||
- Evidence: data supports arguments, never leads
|
||||
Reference in New Issue
Block a user