bmad-method 4.39.0 → 4.39.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (101) hide show
  1. package/dist/agents/bmad-orchestrator.txt +0 -5
  2. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +0 -5
  3. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +0 -5
  4. package/dist/expansion-packs/bmad-creative-writing/agents/beta-reader.txt +78 -47
  5. package/dist/expansion-packs/bmad-creative-writing/agents/book-critic.txt +7 -4
  6. package/dist/expansion-packs/bmad-creative-writing/agents/character-psychologist.txt +67 -37
  7. package/dist/expansion-packs/bmad-creative-writing/agents/dialog-specialist.txt +44 -17
  8. package/dist/expansion-packs/bmad-creative-writing/agents/editor.txt +73 -49
  9. package/dist/expansion-packs/bmad-creative-writing/agents/genre-specialist.txt +88 -47
  10. package/dist/expansion-packs/bmad-creative-writing/agents/narrative-designer.txt +57 -28
  11. package/dist/expansion-packs/bmad-creative-writing/agents/plot-architect.txt +38 -9
  12. package/dist/expansion-packs/bmad-creative-writing/agents/world-builder.txt +79 -48
  13. package/dist/expansion-packs/bmad-creative-writing/teams/agent-team.txt +1211 -810
  14. package/dist/teams/team-all.txt +0 -5
  15. package/dist/teams/team-fullstack.txt +0 -5
  16. package/dist/teams/team-ide-minimal.txt +0 -5
  17. package/dist/teams/team-no-ui.txt +0 -5
  18. package/docs/versioning-and-releases.md +1 -1
  19. package/expansion-packs/bmad-creative-writing/README.md +15 -1
  20. package/expansion-packs/bmad-creative-writing/agent-teams/agent-team.yaml +1 -1
  21. package/expansion-packs/bmad-creative-writing/agents/beta-reader.md +12 -11
  22. package/expansion-packs/bmad-creative-writing/agents/book-critic.md +5 -2
  23. package/expansion-packs/bmad-creative-writing/agents/character-psychologist.md +12 -11
  24. package/expansion-packs/bmad-creative-writing/agents/cover-designer.md +3 -0
  25. package/expansion-packs/bmad-creative-writing/agents/dialog-specialist.md +12 -11
  26. package/expansion-packs/bmad-creative-writing/agents/editor.md +12 -11
  27. package/expansion-packs/bmad-creative-writing/agents/genre-specialist.md +13 -12
  28. package/expansion-packs/bmad-creative-writing/agents/narrative-designer.md +12 -11
  29. package/expansion-packs/bmad-creative-writing/agents/plot-architect.md +12 -11
  30. package/expansion-packs/bmad-creative-writing/agents/world-builder.md +12 -11
  31. package/expansion-packs/bmad-creative-writing/checklists/beta-feedback-closure-checklist.md +15 -10
  32. package/expansion-packs/bmad-creative-writing/checklists/character-consistency-checklist.md +15 -10
  33. package/expansion-packs/bmad-creative-writing/checklists/comedic-timing-checklist.md +15 -10
  34. package/expansion-packs/bmad-creative-writing/checklists/cyberpunk-aesthetic-checklist.md +15 -10
  35. package/expansion-packs/bmad-creative-writing/checklists/ebook-formatting-checklist.md +14 -10
  36. package/expansion-packs/bmad-creative-writing/checklists/epic-poetry-meter-checklist.md +15 -10
  37. package/expansion-packs/bmad-creative-writing/checklists/fantasy-magic-system-checklist.md +15 -10
  38. package/expansion-packs/bmad-creative-writing/checklists/foreshadowing-payoff-checklist.md +14 -9
  39. package/expansion-packs/bmad-creative-writing/checklists/genre-tropes-checklist.md +14 -9
  40. package/expansion-packs/bmad-creative-writing/checklists/historical-accuracy-checklist.md +15 -10
  41. package/expansion-packs/bmad-creative-writing/checklists/horror-suspense-checklist.md +15 -10
  42. package/expansion-packs/bmad-creative-writing/checklists/kdp-cover-ready-checklist.md +17 -12
  43. package/expansion-packs/bmad-creative-writing/checklists/line-edit-quality-checklist.md +15 -10
  44. package/expansion-packs/bmad-creative-writing/checklists/marketing-copy-checklist.md +15 -10
  45. package/expansion-packs/bmad-creative-writing/checklists/mystery-clue-trail-checklist.md +15 -10
  46. package/expansion-packs/bmad-creative-writing/checklists/orbital-mechanics-checklist.md +15 -10
  47. package/expansion-packs/bmad-creative-writing/checklists/plot-structure-checklist.md +10 -2
  48. package/expansion-packs/bmad-creative-writing/checklists/publication-readiness-checklist.md +15 -10
  49. package/expansion-packs/bmad-creative-writing/checklists/romance-emotional-beats-checklist.md +15 -10
  50. package/expansion-packs/bmad-creative-writing/checklists/scene-quality-checklist.md +15 -10
  51. package/expansion-packs/bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md +14 -9
  52. package/expansion-packs/bmad-creative-writing/checklists/sensitivity-representation-checklist.md +15 -10
  53. package/expansion-packs/bmad-creative-writing/checklists/steampunk-gadget-checklist.md +15 -10
  54. package/expansion-packs/bmad-creative-writing/checklists/thriller-pacing-stakes-checklist.md +15 -10
  55. package/expansion-packs/bmad-creative-writing/checklists/timeline-continuity-checklist.md +15 -10
  56. package/expansion-packs/bmad-creative-writing/checklists/world-building-continuity-checklist.md +15 -10
  57. package/expansion-packs/bmad-creative-writing/checklists/ya-appropriateness-checklist.md +15 -10
  58. package/expansion-packs/bmad-creative-writing/config.yaml +2 -2
  59. package/expansion-packs/bmad-creative-writing/data/bmad-kb.md +11 -1
  60. package/expansion-packs/bmad-creative-writing/data/story-structures.md +8 -1
  61. package/expansion-packs/bmad-creative-writing/docs/brief.md +28 -1
  62. package/expansion-packs/bmad-creative-writing/tasks/advanced-elicitation.md +1 -1
  63. package/expansion-packs/bmad-creative-writing/tasks/analyze-reader-feedback.md +15 -10
  64. package/expansion-packs/bmad-creative-writing/tasks/analyze-story-structure.md +12 -2
  65. package/expansion-packs/bmad-creative-writing/tasks/assemble-kdp-package.md +21 -16
  66. package/expansion-packs/bmad-creative-writing/tasks/brainstorm-premise.md +15 -10
  67. package/expansion-packs/bmad-creative-writing/tasks/build-world.md +16 -11
  68. package/expansion-packs/bmad-creative-writing/tasks/character-depth-pass.md +14 -9
  69. package/expansion-packs/bmad-creative-writing/tasks/create-doc.md +1 -1
  70. package/expansion-packs/bmad-creative-writing/tasks/create-draft-section.md +17 -12
  71. package/expansion-packs/bmad-creative-writing/tasks/critical-review.md +18 -13
  72. package/expansion-packs/bmad-creative-writing/tasks/develop-character.md +16 -11
  73. package/expansion-packs/bmad-creative-writing/tasks/execute-checklist.md +1 -8
  74. package/expansion-packs/bmad-creative-writing/tasks/expand-premise.md +15 -10
  75. package/expansion-packs/bmad-creative-writing/tasks/expand-synopsis.md +15 -10
  76. package/expansion-packs/bmad-creative-writing/tasks/final-polish.md +15 -10
  77. package/expansion-packs/bmad-creative-writing/tasks/generate-cover-brief.md +17 -12
  78. package/expansion-packs/bmad-creative-writing/tasks/generate-cover-prompts.md +18 -13
  79. package/expansion-packs/bmad-creative-writing/tasks/generate-scene-list.md +15 -10
  80. package/expansion-packs/bmad-creative-writing/tasks/incorporate-feedback.md +17 -12
  81. package/expansion-packs/bmad-creative-writing/tasks/outline-scenes.md +15 -10
  82. package/expansion-packs/bmad-creative-writing/tasks/provide-feedback.md +16 -11
  83. package/expansion-packs/bmad-creative-writing/tasks/publish-chapter.md +15 -10
  84. package/expansion-packs/bmad-creative-writing/tasks/quick-feedback.md +14 -9
  85. package/expansion-packs/bmad-creative-writing/tasks/select-next-arc.md +15 -10
  86. package/expansion-packs/bmad-creative-writing/tasks/workshop-dialog.md +12 -1
  87. package/expansion-packs/bmad-creative-writing/templates/character-profile-tmpl.yaml +0 -1
  88. package/expansion-packs/bmad-creative-writing/templates/story-outline-tmpl.yaml +0 -1
  89. package/expansion-packs/bmad-creative-writing/workflows/book-cover-design-workflow.md +105 -65
  90. package/expansion-packs/bmad-creative-writing/workflows/novel-greenfield-workflow.yaml +0 -3
  91. package/expansion-packs/bmad-creative-writing/workflows/novel-serial-workflow.yaml +0 -2
  92. package/expansion-packs/bmad-creative-writing/workflows/novel-snowflake-workflow.yaml +1 -2
  93. package/expansion-packs/bmad-creative-writing/workflows/novel-writing.yaml +0 -2
  94. package/expansion-packs/bmad-creative-writing/workflows/screenplay-development.yaml +0 -2
  95. package/expansion-packs/bmad-creative-writing/workflows/series-planning.yaml +0 -2
  96. package/expansion-packs/bmad-creative-writing/workflows/short-story-creation.yaml +0 -2
  97. package/package.json +1 -1
  98. package/release_notes.md +21 -0
  99. package/tools/installer/bin/bmad.js +1 -1
  100. package/tools/installer/package.json +1 -1
  101. /package/{sync-version.sh → tools/sync-version.sh} +0 -0
@@ -103,8 +103,9 @@ dependencies:
103
103
  You are the Genre Specialist, guardian of reader satisfaction and genre innovation. You understand that genres are contracts with readers, promising specific experiences.
104
104
 
105
105
  Navigate:
106
+
106
107
  - **Core requirements** that define the genre
107
- - **Optional conventions** that enhance familiarity
108
+ - **Optional conventions** that enhance familiarity
108
109
  - **Trope subversion** opportunities
109
110
  - **Cross-genre elements** that add freshness
110
111
  - **Market positioning** for maximum appeal
@@ -223,13 +224,15 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
223
224
  # Analyze Story Structure
224
225
 
225
226
  ## Purpose
227
+
226
228
  Perform comprehensive structural analysis of a narrative work to identify strengths, weaknesses, and improvement opportunities.
227
229
 
228
230
  ## Process
229
231
 
230
232
  ### 1. Identify Structure Type
233
+
231
234
  - Three-act structure
232
- - Five-act structure
235
+ - Five-act structure
233
236
  - Hero's Journey
234
237
  - Save the Cat beats
235
238
  - Freytag's Pyramid
@@ -238,6 +241,7 @@ Perform comprehensive structural analysis of a narrative work to identify streng
238
241
  - Non-linear/experimental
239
242
 
240
243
  ### 2. Map Key Points
244
+
241
245
  - **Opening**: Hook, world establishment, character introduction
242
246
  - **Inciting Incident**: What disrupts the status quo?
243
247
  - **Plot Point 1**: What locks in the conflict?
@@ -245,7 +249,9 @@ Perform comprehensive structural analysis of a narrative work to identify streng
245
249
  - **Plot Point 2**: What raises stakes to maximum?
246
250
  - **Climax**: How does central conflict resolve?
247
251
  - **Resolution**: What new equilibrium emerges?
252
+
248
253
  ### 3. Analyze Pacing
254
+
249
255
  - Scene length distribution
250
256
  - Tension escalation curve
251
257
  - Breather moment placement
@@ -253,6 +259,7 @@ Perform comprehensive structural analysis of a narrative work to identify streng
253
259
  - Chapter break effectiveness
254
260
 
255
261
  ### 4. Evaluate Setup/Payoff
262
+
256
263
  - Track all setups (promises to reader)
257
264
  - Verify each has satisfying payoff
258
265
  - Identify orphaned setups
@@ -260,13 +267,16 @@ Perform comprehensive structural analysis of a narrative work to identify streng
260
267
  - Check Chekhov's guns
261
268
 
262
269
  ### 5. Assess Subplot Integration
270
+
263
271
  - List all subplots
264
272
  - Track intersection with main plot
265
273
  - Evaluate resolution satisfaction
266
274
  - Check thematic reinforcement
267
275
 
268
276
  ### 6. Generate Report
277
+
269
278
  Create structural report including:
279
+
270
280
  - Structure diagram
271
281
  - Pacing chart
272
282
  - Problem areas
@@ -274,6 +284,7 @@ Create structural report including:
274
284
  - Alternative structures
275
285
 
276
286
  ## Output
287
+
277
288
  Comprehensive structural analysis with actionable recommendations
278
289
  ==================== END: .bmad-creative-writing/tasks/analyze-story-structure.md ====================
279
290
 
@@ -289,7 +300,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
289
300
  ## Instructions
290
301
 
291
302
  1. **Initial Assessment**
292
-
293
303
  - If user or the task being run provides a checklist name:
294
304
  - Try fuzzy matching (e.g. "plot checklist" -> "plot-structure-checklist")
295
305
  - If multiple matches found, ask user to clarify
@@ -302,14 +312,12 @@ If the user asks or does not specify a specific checklist, list the checklists a
302
312
  - All at once (YOLO mode - recommended for checklists, there will be a summary of sections at the end to discuss)
303
313
 
304
314
  2. **Document and Artifact Gathering**
305
-
306
315
  - Each checklist will specify its required documents/artifacts at the beginning
307
316
  - Follow the checklist's specific instructions for what to gather, generally a file can be resolved in the docs folder, if not or unsure, halt and ask or confirm with the user.
308
317
 
309
318
  3. **Checklist Processing**
310
319
 
311
320
  If in interactive mode:
312
-
313
321
  - Work through each section of the checklist one at a time
314
322
  - For each section:
315
323
  - Review all items in the section following instructions for that section embedded in the checklist
@@ -318,7 +326,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
318
326
  - Get user confirmation before proceeding to next section or if any thing major do we need to halt and take corrective action
319
327
 
320
328
  If in YOLO mode:
321
-
322
329
  - Process all sections at once
323
330
  - Create a comprehensive report of all findings
324
331
  - Present the complete analysis to the user
@@ -326,7 +333,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
326
333
  4. **Validation Approach**
327
334
 
328
335
  For each checklist item:
329
-
330
336
  - Read and understand the requirement
331
337
  - Look for evidence in the documentation that satisfies the requirement
332
338
  - Consider both explicit mentions and implicit coverage
@@ -340,7 +346,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
340
346
  5. **Section Analysis**
341
347
 
342
348
  For each section:
343
-
344
349
  - think step by step to calculate pass rate
345
350
  - Identify common themes in failed items
346
351
  - Provide specific recommendations for improvement
@@ -350,7 +355,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
350
355
  6. **Final Report**
351
356
 
352
357
  Prepare a summary that includes:
353
-
354
358
  - Overall checklist completion status
355
359
  - Pass rates by section
356
360
  - List of failed items with context
@@ -593,76 +597,96 @@ sections:
593
597
 
594
598
  ==================== START: .bmad-creative-writing/checklists/genre-tropes-checklist.md ====================
595
599
  # ------------------------------------------------------------
600
+
596
601
  # 10. Genre Tropes Checklist (General)
602
+
597
603
  # ------------------------------------------------------------
604
+
598
605
  ---
606
+
599
607
  checklist:
600
- id: genre-tropes-checklist
601
- name: Genre Tropes Checklist
602
- description: Confirm expected reader promises for chosen genre are addressed or subverted intentionally.
608
+ id: genre-tropes-checklist
609
+ name: Genre Tropes Checklist
610
+ description: Confirm expected reader promises for chosen genre are addressed or subverted intentionally.
603
611
  items:
604
- - "[ ] Core genre conventions present (e.g., mystery has a solvable puzzle)"
605
- - "[ ] Audience‑favored tropes used or consciously averted"
606
- - "[ ] Genre pacing beats hit (e.g., romance meet‑cute by 15%)"
607
- - "[ ] Satisfying genreappropriate climax"
608
- - "[ ] Reader expectations subversions signposted to avoid disappointment"
609
- ...
612
+
613
+ - "[ ] Core genre conventions present (e.g., mystery has a solvable puzzle)"
614
+ - "[ ] Audience‑favored tropes used or consciously averted"
615
+ - "[ ] Genre pacing beats hit (e.g., romance meetcute by 15%)"
616
+ - "[ ] Satisfying genreappropriate climax"
617
+ - "[ ] Reader expectations subversions sign‑posted to avoid disappointment"
618
+ ...
610
619
  ==================== END: .bmad-creative-writing/checklists/genre-tropes-checklist.md ====================
611
620
 
612
621
  ==================== START: .bmad-creative-writing/checklists/fantasy-magic-system-checklist.md ====================
613
622
  # ------------------------------------------------------------
623
+
614
624
  # 17. Fantasy Magic System Consistency Checklist
625
+
615
626
  # ------------------------------------------------------------
627
+
616
628
  ---
629
+
617
630
  checklist:
618
- id: fantasy-magic-system-checklist
619
- name: Fantasy Magic System Consistency Checklist
620
- description: Keep magical rules, costs, and exceptions coherent.
631
+ id: fantasy-magic-system-checklist
632
+ name: Fantasy Magic System Consistency Checklist
633
+ description: Keep magical rules, costs, and exceptions coherent.
621
634
  items:
622
- - "[ ] Core source and rules defined"
623
- - "[ ] Limitations create plot obstacles"
624
- - "[ ] Costs or risks for using magic stated"
625
- - "[ ] No last‑minute power with no foreshadowing"
626
- - "[ ] Societal impact of magic reflected in setting"
627
- - "[ ] Rule exceptions justified and rare"
628
- ...
635
+
636
+ - "[ ] Core source and rules defined"
637
+ - "[ ] Limitations create plot obstacles"
638
+ - "[ ] Costs or risks for using magic stated"
639
+ - "[ ] No last‑minute power with no foreshadowing"
640
+ - "[ ] Societal impact of magic reflected in setting"
641
+ - "[ ] Rule exceptions justified and rare"
642
+ ...
629
643
  ==================== END: .bmad-creative-writing/checklists/fantasy-magic-system-checklist.md ====================
630
644
 
631
645
  ==================== START: .bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md ====================
632
646
  # ------------------------------------------------------------
647
+
633
648
  # 15. Sci‑Fi Technology Plausibility Checklist
649
+
634
650
  # ------------------------------------------------------------
651
+
635
652
  ---
653
+
636
654
  checklist:
637
- id: scifi-technology-plausibility-checklist
638
- name: Sci‑Fi Technology Plausibility Checklist
639
- description: Ensure advanced technologies feel believable and internally consistent.
655
+ id: scifi-technology-plausibility-checklist
656
+ name: Sci‑Fi Technology Plausibility Checklist
657
+ description: Ensure advanced technologies feel believable and internally consistent.
640
658
  items:
641
- - "[ ] Technology built on clear scientific principles or hand‑waved consistently"
642
- - "[ ] Limits and costs of tech established"
643
- - "[ ] Tech capabilities applied consistently to plot"
644
- - "[ ] No forgotten tech that would solve earlier conflicts"
645
- - "[ ] Terminology explained or intuitively clear"
646
- ...
659
+
660
+ - "[ ] Technology built on clear scientific principles or hand‑waved consistently"
661
+ - "[ ] Limits and costs of tech established"
662
+ - "[ ] Tech capabilities applied consistently to plot"
663
+ - "[ ] No forgotten tech that would solve earlier conflicts"
664
+ - "[ ] Terminology explained or intuitively clear"
665
+ ...
647
666
  ==================== END: .bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md ====================
648
667
 
649
668
  ==================== START: .bmad-creative-writing/checklists/romance-emotional-beats-checklist.md ====================
650
669
  # ------------------------------------------------------------
670
+
651
671
  # 12. Romance Emotional Beats Checklist
672
+
652
673
  # ------------------------------------------------------------
674
+
653
675
  ---
676
+
654
677
  checklist:
655
- id: romance-emotional-beats-checklist
656
- name: Romance Emotional Beats Checklist
657
- description: Track essential emotional beats in romance arcs.
678
+ id: romance-emotional-beats-checklist
679
+ name: Romance Emotional Beats Checklist
680
+ description: Track essential emotional beats in romance arcs.
658
681
  items:
659
- - "[ ] Meet‑cute / inciting attraction"
660
- - "[ ] Growing intimacy montage"
661
- - "[ ] Midpoint commitment or confession moment"
662
- - "[ ] Dark night of the soul / breakup"
663
- - "[ ] Grand gesture or reconciliation"
664
- - "[ ] HEA or HFN ending clear"
665
- ...
682
+
683
+ - "[ ] Meet‑cute / inciting attraction"
684
+ - "[ ] Growing intimacy montage"
685
+ - "[ ] Midpoint commitment or confession moment"
686
+ - "[ ] Dark night of the soul / breakup"
687
+ - "[ ] Grand gesture or reconciliation"
688
+ - "[ ] HEA or HFN ending clear"
689
+ ...
666
690
  ==================== END: .bmad-creative-writing/checklists/romance-emotional-beats-checklist.md ====================
667
691
 
668
692
  ==================== START: .bmad-creative-writing/data/bmad-kb.md ====================
@@ -771,24 +795,28 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating
771
795
  ## Templates & Tools
772
796
 
773
797
  ### Character Development
798
+
774
799
  - Comprehensive character profiles
775
800
  - Backstory builders
776
801
  - Voice and dialogue patterns
777
802
  - Relationship mapping
778
803
 
779
804
  ### Story Structure
805
+
780
806
  - Three-act outlines
781
807
  - Save the Cat beat sheets
782
808
  - Hero's Journey mapping
783
809
  - Scene-by-scene breakdowns
784
810
 
785
811
  ### World Building
812
+
786
813
  - Setting documentation
787
814
  - Magic/technology systems
788
815
  - Cultural development
789
816
  - Timeline tracking
790
817
 
791
818
  ### Publishing Support
819
+
792
820
  - KDP formatting guidelines
793
821
  - Cover design briefs
794
822
  - Marketing copy templates
@@ -797,6 +825,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating
797
825
  ## Genre Support
798
826
 
799
827
  ### Built-in Genre Checklists
828
+
800
829
  - Fantasy & Sci-Fi
801
830
  - Romance & Thriller
802
831
  - Mystery & Horror
@@ -804,6 +833,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating
804
833
  - Young Adult
805
834
 
806
835
  Each genre includes:
836
+
807
837
  - Trope management
808
838
  - Reader expectations
809
839
  - Market positioning
@@ -812,24 +842,28 @@ Each genre includes:
812
842
  ## Best Practices
813
843
 
814
844
  ### Character Development
845
+
815
846
  1. Start with internal conflict
816
847
  2. Build from wound/lie/want/need
817
848
  3. Create unique voice patterns
818
849
  4. Track arc progression
819
850
 
820
851
  ### Plot Construction
852
+
821
853
  1. Begin with clear story question
822
854
  2. Escalate stakes progressively
823
855
  3. Plant setup/payoff pairs
824
856
  4. Balance pacing with character moments
825
857
 
826
858
  ### World Building
859
+
827
860
  1. Maintain internal consistency
828
861
  2. Show through character experience
829
862
  3. Build only what serves story
830
863
  4. Track all established rules
831
864
 
832
865
  ### Revision Process
866
+
833
867
  1. Complete draft before major edits
834
868
  2. Address structure before prose
835
869
  3. Read dialogue aloud
@@ -869,11 +903,13 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
869
903
  # Story Structure Patterns
870
904
 
871
905
  ## Three-Act Structure
906
+
872
907
  - **Act 1 (25%)**: Setup, inciting incident
873
908
  - **Act 2 (50%)**: Confrontation, complications
874
909
  - **Act 3 (25%)**: Resolution
875
910
 
876
911
  ## Save the Cat Beats
912
+
877
913
  1. Opening Image (0-1%)
878
914
  2. Setup (1-10%)
879
915
  3. Theme Stated (5%)
@@ -889,7 +925,9 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
889
925
  13. Break into Three (80%)
890
926
  14. Finale (80-99%)
891
927
  15. Final Image (99-100%)
928
+
892
929
  ## Hero's Journey
930
+
893
931
  1. Ordinary World
894
932
  2. Call to Adventure
895
933
  3. Refusal of Call
@@ -904,6 +942,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
904
942
  12. Return with Elixir
905
943
 
906
944
  ## Seven-Point Structure
945
+
907
946
  1. Hook
908
947
  2. Plot Turn 1
909
948
  3. Pinch Point 1
@@ -913,6 +952,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
913
952
  7. Resolution
914
953
 
915
954
  ## Freytag's Pyramid
955
+
916
956
  1. Exposition
917
957
  2. Rising Action
918
958
  3. Climax
@@ -920,6 +960,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
920
960
  5. Denouement
921
961
 
922
962
  ## Kishōtenketsu (Japanese)
963
+
923
964
  - **Ki**: Introduction
924
965
  - **Shō**: Development
925
966
  - **Ten**: Twist
@@ -101,6 +101,7 @@ dependencies:
101
101
  You are the Narrative Designer, architect of stories that respond to reader/player choices. You balance authorial vision with participant agency.
102
102
 
103
103
  Design for:
104
+
104
105
  - **Meaningful choices** not false dilemmas
105
106
  - **Consequence chains** that feel logical
106
107
  - **Emotional investment** in decisions
@@ -219,40 +220,50 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
219
220
 
220
221
  ==================== START: .bmad-creative-writing/tasks/outline-scenes.md ====================
221
222
  # ------------------------------------------------------------
223
+
222
224
  # 11. Outline Scenes
225
+
223
226
  # ------------------------------------------------------------
227
+
224
228
  ---
229
+
225
230
  task:
226
- id: outline-scenes
227
- name: Outline Scenes
228
- description: Group scene list into chapters with act structure.
229
- persona_default: plot-architect
231
+ id: outline-scenes
232
+ name: Outline Scenes
233
+ description: Group scene list into chapters with act structure.
234
+ persona_default: plot-architect
230
235
  inputs:
231
- - scene-list.md
232
- steps:
233
- - Assign scenes to chapters.
234
- - Produce snowflake-outline.md with headings per chapter.
235
- output: snowflake-outline.md
236
- ...
236
+
237
+ - scene-list.md
238
+ steps:
239
+ - Assign scenes to chapters.
240
+ - Produce snowflake-outline.md with headings per chapter.
241
+ output: snowflake-outline.md
242
+ ...
237
243
  ==================== END: .bmad-creative-writing/tasks/outline-scenes.md ====================
238
244
 
239
245
  ==================== START: .bmad-creative-writing/tasks/generate-scene-list.md ====================
240
246
  # ------------------------------------------------------------
247
+
241
248
  # 10. Generate Scene List
249
+
242
250
  # ------------------------------------------------------------
251
+
243
252
  ---
253
+
244
254
  task:
245
- id: generate-scene-list
246
- name: Generate Scene List
247
- description: Break synopsis into a numbered list of scenes.
248
- persona_default: plot-architect
255
+ id: generate-scene-list
256
+ name: Generate Scene List
257
+ description: Break synopsis into a numbered list of scenes.
258
+ persona_default: plot-architect
249
259
  inputs:
250
- - synopsis.md | story-outline.md
251
- steps:
252
- - Identify key beats.
253
- - Fill scene-list-tmpl table.
254
- output: scene-list.md
255
- ...
260
+
261
+ - synopsis.md | story-outline.md
262
+ steps:
263
+ - Identify key beats.
264
+ - Fill scene-list-tmpl table.
265
+ output: scene-list.md
266
+ ...
256
267
  ==================== END: .bmad-creative-writing/tasks/generate-scene-list.md ====================
257
268
 
258
269
  ==================== START: .bmad-creative-writing/tasks/execute-checklist.md ====================
@@ -267,7 +278,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
267
278
  ## Instructions
268
279
 
269
280
  1. **Initial Assessment**
270
-
271
281
  - If user or the task being run provides a checklist name:
272
282
  - Try fuzzy matching (e.g. "plot checklist" -> "plot-structure-checklist")
273
283
  - If multiple matches found, ask user to clarify
@@ -280,14 +290,12 @@ If the user asks or does not specify a specific checklist, list the checklists a
280
290
  - All at once (YOLO mode - recommended for checklists, there will be a summary of sections at the end to discuss)
281
291
 
282
292
  2. **Document and Artifact Gathering**
283
-
284
293
  - Each checklist will specify its required documents/artifacts at the beginning
285
294
  - Follow the checklist's specific instructions for what to gather, generally a file can be resolved in the docs folder, if not or unsure, halt and ask or confirm with the user.
286
295
 
287
296
  3. **Checklist Processing**
288
297
 
289
298
  If in interactive mode:
290
-
291
299
  - Work through each section of the checklist one at a time
292
300
  - For each section:
293
301
  - Review all items in the section following instructions for that section embedded in the checklist
@@ -296,7 +304,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
296
304
  - Get user confirmation before proceeding to next section or if any thing major do we need to halt and take corrective action
297
305
 
298
306
  If in YOLO mode:
299
-
300
307
  - Process all sections at once
301
308
  - Create a comprehensive report of all findings
302
309
  - Present the complete analysis to the user
@@ -304,7 +311,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
304
311
  4. **Validation Approach**
305
312
 
306
313
  For each checklist item:
307
-
308
314
  - Read and understand the requirement
309
315
  - Look for evidence in the documentation that satisfies the requirement
310
316
  - Consider both explicit mentions and implicit coverage
@@ -318,7 +324,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
318
324
  5. **Section Analysis**
319
325
 
320
326
  For each section:
321
-
322
327
  - think step by step to calculate pass rate
323
328
  - Identify common themes in failed items
324
329
  - Provide specific recommendations for improvement
@@ -328,7 +333,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
328
333
  6. **Final Report**
329
334
 
330
335
  Prepare a summary that includes:
331
-
332
336
  - Overall checklist completion status
333
337
  - Pass rates by section
334
338
  - List of failed items with context
@@ -532,6 +536,7 @@ sections:
532
536
  # Plot Structure Checklist
533
537
 
534
538
  ## Opening
539
+
535
540
  - [ ] Hook engages within first page
536
541
  - [ ] Genre/tone established early
537
542
  - [ ] World rules clear
@@ -539,6 +544,7 @@ sections:
539
544
  - [ ] Status quo established before disruption
540
545
 
541
546
  ## Structure Fundamentals
547
+
542
548
  - [ ] Inciting incident by 10-15% mark
543
549
  - [ ] Clear story question posed
544
550
  - [ ] Stakes established and clear
@@ -546,19 +552,23 @@ sections:
546
552
  - [ ] B-story provides thematic counterpoint
547
553
 
548
554
  ## Rising Action
555
+
549
556
  - [ ] Complications escalate logically
550
557
  - [ ] Try-fail cycles build tension
551
558
  - [ ] Subplots weave with main plot
552
559
  - [ ] False victories/defeats included
553
560
  - [ ] Character growth parallels plot
561
+
554
562
  ## Midpoint
563
+
555
564
  - [ ] Major reversal or revelation
556
- - [ ] Stakes raised significantly
565
+ - [ ] Stakes raised significantly
557
566
  - [ ] Protagonist approach shifts
558
567
  - [ ] Time pressure introduced/increased
559
568
  - [ ] Point of no return crossed
560
569
 
561
570
  ## Crisis Building
571
+
562
572
  - [ ] Bad guys close in (internal/external)
563
573
  - [ ] Protagonist plans fail
564
574
  - [ ] Allies fall away/betray
@@ -566,6 +576,7 @@ sections:
566
576
  - [ ] Dark night of soul (character lowest)
567
577
 
568
578
  ## Climax
579
+
569
580
  - [ ] Protagonist must act (no rescue)
570
581
  - [ ] Uses lessons learned
571
582
  - [ ] Internal/external conflicts merge
@@ -573,6 +584,7 @@ sections:
573
584
  - [ ] Clear win/loss/transformation
574
585
 
575
586
  ## Resolution
587
+
576
588
  - [ ] New equilibrium established
577
589
  - [ ] Loose threads tied
578
590
  - [ ] Character growth demonstrated
@@ -686,24 +698,28 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating
686
698
  ## Templates & Tools
687
699
 
688
700
  ### Character Development
701
+
689
702
  - Comprehensive character profiles
690
703
  - Backstory builders
691
704
  - Voice and dialogue patterns
692
705
  - Relationship mapping
693
706
 
694
707
  ### Story Structure
708
+
695
709
  - Three-act outlines
696
710
  - Save the Cat beat sheets
697
711
  - Hero's Journey mapping
698
712
  - Scene-by-scene breakdowns
699
713
 
700
714
  ### World Building
715
+
701
716
  - Setting documentation
702
717
  - Magic/technology systems
703
718
  - Cultural development
704
719
  - Timeline tracking
705
720
 
706
721
  ### Publishing Support
722
+
707
723
  - KDP formatting guidelines
708
724
  - Cover design briefs
709
725
  - Marketing copy templates
@@ -712,6 +728,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating
712
728
  ## Genre Support
713
729
 
714
730
  ### Built-in Genre Checklists
731
+
715
732
  - Fantasy & Sci-Fi
716
733
  - Romance & Thriller
717
734
  - Mystery & Horror
@@ -719,6 +736,7 @@ BMad Creative Writing transforms you into a "Creative Director" - orchestrating
719
736
  - Young Adult
720
737
 
721
738
  Each genre includes:
739
+
722
740
  - Trope management
723
741
  - Reader expectations
724
742
  - Market positioning
@@ -727,24 +745,28 @@ Each genre includes:
727
745
  ## Best Practices
728
746
 
729
747
  ### Character Development
748
+
730
749
  1. Start with internal conflict
731
750
  2. Build from wound/lie/want/need
732
751
  3. Create unique voice patterns
733
752
  4. Track arc progression
734
753
 
735
754
  ### Plot Construction
755
+
736
756
  1. Begin with clear story question
737
757
  2. Escalate stakes progressively
738
758
  3. Plant setup/payoff pairs
739
759
  4. Balance pacing with character moments
740
760
 
741
761
  ### World Building
762
+
742
763
  1. Maintain internal consistency
743
764
  2. Show through character experience
744
765
  3. Build only what serves story
745
766
  4. Track all established rules
746
767
 
747
768
  ### Revision Process
769
+
748
770
  1. Complete draft before major edits
749
771
  2. Address structure before prose
750
772
  3. Read dialogue aloud
@@ -784,11 +806,13 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
784
806
  # Story Structure Patterns
785
807
 
786
808
  ## Three-Act Structure
809
+
787
810
  - **Act 1 (25%)**: Setup, inciting incident
788
811
  - **Act 2 (50%)**: Confrontation, complications
789
812
  - **Act 3 (25%)**: Resolution
790
813
 
791
814
  ## Save the Cat Beats
815
+
792
816
  1. Opening Image (0-1%)
793
817
  2. Setup (1-10%)
794
818
  3. Theme Stated (5%)
@@ -804,7 +828,9 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
804
828
  13. Break into Three (80%)
805
829
  14. Finale (80-99%)
806
830
  15. Final Image (99-100%)
831
+
807
832
  ## Hero's Journey
833
+
808
834
  1. Ordinary World
809
835
  2. Call to Adventure
810
836
  3. Refusal of Call
@@ -819,6 +845,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
819
845
  12. Return with Elixir
820
846
 
821
847
  ## Seven-Point Structure
848
+
822
849
  1. Hook
823
850
  2. Plot Turn 1
824
851
  3. Pinch Point 1
@@ -828,6 +855,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
828
855
  7. Resolution
829
856
 
830
857
  ## Freytag's Pyramid
858
+
831
859
  1. Exposition
832
860
  2. Rising Action
833
861
  3. Climax
@@ -835,6 +863,7 @@ Remember: BMad Creative Writing provides structure to liberate creativity, not c
835
863
  5. Denouement
836
864
 
837
865
  ## Kishōtenketsu (Japanese)
866
+
838
867
  - **Ki**: Introduction
839
868
  - **Shō**: Development
840
869
  - **Ten**: Twist