kollabor 0.4.9__py3-none-any.whl → 0.4.15__py3-none-any.whl

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 (192) hide show
  1. agents/__init__.py +2 -0
  2. agents/coder/__init__.py +0 -0
  3. agents/coder/agent.json +4 -0
  4. agents/coder/api-integration.md +2150 -0
  5. agents/coder/cli-pretty.md +765 -0
  6. agents/coder/code-review.md +1092 -0
  7. agents/coder/database-design.md +1525 -0
  8. agents/coder/debugging.md +1102 -0
  9. agents/coder/dependency-management.md +1397 -0
  10. agents/coder/git-workflow.md +1099 -0
  11. agents/coder/refactoring.md +1454 -0
  12. agents/coder/security-hardening.md +1732 -0
  13. agents/coder/system_prompt.md +1448 -0
  14. agents/coder/tdd.md +1367 -0
  15. agents/creative-writer/__init__.py +0 -0
  16. agents/creative-writer/agent.json +4 -0
  17. agents/creative-writer/character-development.md +1852 -0
  18. agents/creative-writer/dialogue-craft.md +1122 -0
  19. agents/creative-writer/plot-structure.md +1073 -0
  20. agents/creative-writer/revision-editing.md +1484 -0
  21. agents/creative-writer/system_prompt.md +690 -0
  22. agents/creative-writer/worldbuilding.md +2049 -0
  23. agents/data-analyst/__init__.py +30 -0
  24. agents/data-analyst/agent.json +4 -0
  25. agents/data-analyst/data-visualization.md +992 -0
  26. agents/data-analyst/exploratory-data-analysis.md +1110 -0
  27. agents/data-analyst/pandas-data-manipulation.md +1081 -0
  28. agents/data-analyst/sql-query-optimization.md +881 -0
  29. agents/data-analyst/statistical-analysis.md +1118 -0
  30. agents/data-analyst/system_prompt.md +928 -0
  31. agents/default/__init__.py +0 -0
  32. agents/default/agent.json +4 -0
  33. agents/default/dead-code.md +794 -0
  34. agents/default/explore-agent-system.md +585 -0
  35. agents/default/system_prompt.md +1448 -0
  36. agents/kollabor/__init__.py +0 -0
  37. agents/kollabor/analyze-plugin-lifecycle.md +175 -0
  38. agents/kollabor/analyze-terminal-rendering.md +388 -0
  39. agents/kollabor/code-review.md +1092 -0
  40. agents/kollabor/debug-mcp-integration.md +521 -0
  41. agents/kollabor/debug-plugin-hooks.md +547 -0
  42. agents/kollabor/debugging.md +1102 -0
  43. agents/kollabor/dependency-management.md +1397 -0
  44. agents/kollabor/git-workflow.md +1099 -0
  45. agents/kollabor/inspect-llm-conversation.md +148 -0
  46. agents/kollabor/monitor-event-bus.md +558 -0
  47. agents/kollabor/profile-performance.md +576 -0
  48. agents/kollabor/refactoring.md +1454 -0
  49. agents/kollabor/system_prompt copy.md +1448 -0
  50. agents/kollabor/system_prompt.md +757 -0
  51. agents/kollabor/trace-command-execution.md +178 -0
  52. agents/kollabor/validate-config.md +879 -0
  53. agents/research/__init__.py +0 -0
  54. agents/research/agent.json +4 -0
  55. agents/research/architecture-mapping.md +1099 -0
  56. agents/research/codebase-analysis.md +1077 -0
  57. agents/research/dependency-audit.md +1027 -0
  58. agents/research/performance-profiling.md +1047 -0
  59. agents/research/security-review.md +1359 -0
  60. agents/research/system_prompt.md +492 -0
  61. agents/technical-writer/__init__.py +0 -0
  62. agents/technical-writer/agent.json +4 -0
  63. agents/technical-writer/api-documentation.md +2328 -0
  64. agents/technical-writer/changelog-management.md +1181 -0
  65. agents/technical-writer/readme-writing.md +1360 -0
  66. agents/technical-writer/style-guide.md +1410 -0
  67. agents/technical-writer/system_prompt.md +653 -0
  68. agents/technical-writer/tutorial-creation.md +1448 -0
  69. core/__init__.py +0 -2
  70. core/application.py +343 -88
  71. core/cli.py +229 -10
  72. core/commands/menu_renderer.py +463 -59
  73. core/commands/registry.py +14 -9
  74. core/commands/system_commands.py +2461 -14
  75. core/config/loader.py +151 -37
  76. core/config/service.py +18 -6
  77. core/events/bus.py +29 -9
  78. core/events/executor.py +205 -75
  79. core/events/models.py +27 -8
  80. core/fullscreen/command_integration.py +20 -24
  81. core/fullscreen/components/__init__.py +10 -1
  82. core/fullscreen/components/matrix_components.py +1 -2
  83. core/fullscreen/components/space_shooter_components.py +654 -0
  84. core/fullscreen/plugin.py +5 -0
  85. core/fullscreen/renderer.py +52 -13
  86. core/fullscreen/session.py +52 -15
  87. core/io/__init__.py +29 -5
  88. core/io/buffer_manager.py +6 -1
  89. core/io/config_status_view.py +7 -29
  90. core/io/core_status_views.py +267 -347
  91. core/io/input/__init__.py +25 -0
  92. core/io/input/command_mode_handler.py +711 -0
  93. core/io/input/display_controller.py +128 -0
  94. core/io/input/hook_registrar.py +286 -0
  95. core/io/input/input_loop_manager.py +421 -0
  96. core/io/input/key_press_handler.py +502 -0
  97. core/io/input/modal_controller.py +1011 -0
  98. core/io/input/paste_processor.py +339 -0
  99. core/io/input/status_modal_renderer.py +184 -0
  100. core/io/input_errors.py +5 -1
  101. core/io/input_handler.py +211 -2452
  102. core/io/key_parser.py +7 -0
  103. core/io/layout.py +15 -3
  104. core/io/message_coordinator.py +111 -2
  105. core/io/message_renderer.py +129 -4
  106. core/io/status_renderer.py +147 -607
  107. core/io/terminal_renderer.py +97 -51
  108. core/io/terminal_state.py +21 -4
  109. core/io/visual_effects.py +816 -165
  110. core/llm/agent_manager.py +1063 -0
  111. core/llm/api_adapters/__init__.py +44 -0
  112. core/llm/api_adapters/anthropic_adapter.py +432 -0
  113. core/llm/api_adapters/base.py +241 -0
  114. core/llm/api_adapters/openai_adapter.py +326 -0
  115. core/llm/api_communication_service.py +167 -113
  116. core/llm/conversation_logger.py +322 -16
  117. core/llm/conversation_manager.py +556 -30
  118. core/llm/file_operations_executor.py +84 -32
  119. core/llm/llm_service.py +934 -103
  120. core/llm/mcp_integration.py +541 -57
  121. core/llm/message_display_service.py +135 -18
  122. core/llm/plugin_sdk.py +1 -2
  123. core/llm/profile_manager.py +1183 -0
  124. core/llm/response_parser.py +274 -56
  125. core/llm/response_processor.py +16 -3
  126. core/llm/tool_executor.py +6 -1
  127. core/logging/__init__.py +2 -0
  128. core/logging/setup.py +34 -6
  129. core/models/resume.py +54 -0
  130. core/plugins/__init__.py +4 -2
  131. core/plugins/base.py +127 -0
  132. core/plugins/collector.py +23 -161
  133. core/plugins/discovery.py +37 -3
  134. core/plugins/factory.py +6 -12
  135. core/plugins/registry.py +5 -17
  136. core/ui/config_widgets.py +128 -28
  137. core/ui/live_modal_renderer.py +2 -1
  138. core/ui/modal_actions.py +5 -0
  139. core/ui/modal_overlay_renderer.py +0 -60
  140. core/ui/modal_renderer.py +268 -7
  141. core/ui/modal_state_manager.py +29 -4
  142. core/ui/widgets/base_widget.py +7 -0
  143. core/updates/__init__.py +10 -0
  144. core/updates/version_check_service.py +348 -0
  145. core/updates/version_comparator.py +103 -0
  146. core/utils/config_utils.py +685 -526
  147. core/utils/plugin_utils.py +1 -1
  148. core/utils/session_naming.py +111 -0
  149. fonts/LICENSE +21 -0
  150. fonts/README.md +46 -0
  151. fonts/SymbolsNerdFont-Regular.ttf +0 -0
  152. fonts/SymbolsNerdFontMono-Regular.ttf +0 -0
  153. fonts/__init__.py +44 -0
  154. {kollabor-0.4.9.dist-info → kollabor-0.4.15.dist-info}/METADATA +54 -4
  155. kollabor-0.4.15.dist-info/RECORD +228 -0
  156. {kollabor-0.4.9.dist-info → kollabor-0.4.15.dist-info}/top_level.txt +2 -0
  157. plugins/agent_orchestrator/__init__.py +39 -0
  158. plugins/agent_orchestrator/activity_monitor.py +181 -0
  159. plugins/agent_orchestrator/file_attacher.py +77 -0
  160. plugins/agent_orchestrator/message_injector.py +135 -0
  161. plugins/agent_orchestrator/models.py +48 -0
  162. plugins/agent_orchestrator/orchestrator.py +403 -0
  163. plugins/agent_orchestrator/plugin.py +976 -0
  164. plugins/agent_orchestrator/xml_parser.py +191 -0
  165. plugins/agent_orchestrator_plugin.py +9 -0
  166. plugins/enhanced_input/box_styles.py +1 -0
  167. plugins/enhanced_input/color_engine.py +19 -4
  168. plugins/enhanced_input/config.py +2 -2
  169. plugins/enhanced_input_plugin.py +61 -11
  170. plugins/fullscreen/__init__.py +6 -2
  171. plugins/fullscreen/example_plugin.py +1035 -222
  172. plugins/fullscreen/setup_wizard_plugin.py +592 -0
  173. plugins/fullscreen/space_shooter_plugin.py +131 -0
  174. plugins/hook_monitoring_plugin.py +436 -78
  175. plugins/query_enhancer_plugin.py +66 -30
  176. plugins/resume_conversation_plugin.py +1494 -0
  177. plugins/save_conversation_plugin.py +98 -32
  178. plugins/system_commands_plugin.py +70 -56
  179. plugins/tmux_plugin.py +154 -78
  180. plugins/workflow_enforcement_plugin.py +94 -92
  181. system_prompt/default.md +952 -886
  182. core/io/input_mode_manager.py +0 -402
  183. core/io/modal_interaction_handler.py +0 -315
  184. core/io/raw_input_processor.py +0 -946
  185. core/storage/__init__.py +0 -5
  186. core/storage/state_manager.py +0 -84
  187. core/ui/widget_integration.py +0 -222
  188. core/utils/key_reader.py +0 -171
  189. kollabor-0.4.9.dist-info/RECORD +0 -128
  190. {kollabor-0.4.9.dist-info → kollabor-0.4.15.dist-info}/WHEEL +0 -0
  191. {kollabor-0.4.9.dist-info → kollabor-0.4.15.dist-info}/entry_points.txt +0 -0
  192. {kollabor-0.4.9.dist-info → kollabor-0.4.15.dist-info}/licenses/LICENSE +0 -0
@@ -0,0 +1,2049 @@
1
+ <!-- Worldbuilding skill - creating consistent, immersive fictional worlds -->
2
+
3
+ worldbuilding mode: WORLDS FIRST, DETAILS SECOND
4
+
5
+ when this skill is active, you follow systematic worldbuilding.
6
+ this is a comprehensive guide to building believable fictional worlds.
7
+
8
+
9
+ PHASE 0: EXISTING WORLD VERIFICATION
10
+
11
+ before building ANY new world element, check what already exists.
12
+
13
+
14
+ check for existing world notes
15
+
16
+ <read>file:world/</read>
17
+
18
+ if no world directory:
19
+ <create>
20
+ <file>world/README.md</file>
21
+ <content>
22
+ Worldbuilding Database
23
+
24
+ This directory contains all worldbuilding notes and development work.
25
+
26
+ Structure:
27
+ - world_bible.md - master world reference
28
+ - geography.md - maps, locations, physical world
29
+ - history.md - timeline, past events, background
30
+ - cultures/ - cultural notes for each society
31
+ - magic_system.md (if applicable) - rules of magic/tech
32
+ - politics.md - governments, laws, conflicts
33
+ - economy.md - trade, resources, currency
34
+ - creatures.md (if applicable) - fauna and beings
35
+ - language.md - linguistic notes, naming conventions
36
+ </content>
37
+ </create>
38
+
39
+
40
+ check for world bible
41
+
42
+ <read>file:world/world_bible.md</read>
43
+
44
+ if no world bible exists, create one:
45
+ <create>
46
+ <file>world/world_bible.md</file>
47
+ <content>
48
+ World Bible
49
+
50
+ Story Title: [YOUR STORY HERE]
51
+
52
+ Last Updated: [DATE]
53
+
54
+ World Overview:
55
+ [One-paragraph description of the world]
56
+
57
+ World Type: [primary/secondary/constructed]
58
+ - Primary: fictional version of real world
59
+ - Secondary: completely invented world
60
+ - Constructed: detailed invented world with its own rules
61
+
62
+ Key Elements:
63
+ [ ] Magic system: [yes/no - if yes, reference file]
64
+ [ ] Multiple cultures: [yes/no - if yes, list]
65
+ [ ] Non-human species: [yes/no - if yes, list]
66
+ [ ] Special technology: [yes/no - describe]
67
+ [ ] Unique geography: [yes/no - describe]
68
+
69
+ Consistency Notes:
70
+ [Track established rules that must be maintained]
71
+
72
+ Questions for Future Development:
73
+ [List aspects that need development]
74
+ </content>
75
+ </create>
76
+
77
+
78
+ check for existing story context
79
+
80
+ <read>file:story/premise.md</read>
81
+ <read>file:story/outline.md</read>
82
+
83
+ understand the story before building the world.
84
+ the world exists to SERVE the story, not replace it.
85
+
86
+
87
+ verify consistency tracking
88
+
89
+ <read>file:world/consistency_log.md</read>
90
+
91
+ if no consistency log exists:
92
+ <create>
93
+ <file>world/consistency_log.md</file>
94
+ <content>
95
+ Worldbuilding Consistency Log
96
+
97
+ Use this log to track world rules and maintain consistency.
98
+
99
+ Format for each entry:
100
+ DATE - CATEGORY - Rule established - Location
101
+
102
+ Example:
103
+ 2024-01-15 - MAGIC - Fire spells require spoken words - Chapter 3
104
+ 2024-01-16 - GEOGRAPHY - River flows north (unusual) - Chapter 5
105
+
106
+ Quick Reference:
107
+
108
+ Magic Rules:
109
+ [Establish what magic can and cannot do]
110
+
111
+ Technology Level:
112
+ [Define tech capabilities and limitations]
113
+
114
+ Geography Facts:
115
+ [Note any unusual geographical features]
116
+
117
+ Cultural Norms:
118
+ [Track established cultural behaviors]
119
+
120
+ Timeline:
121
+ [Key dates and events in order]
122
+ </content>
123
+ </create>
124
+
125
+
126
+ PHASE 1: THE WORLD FOUNDATION
127
+
128
+
129
+ the story-world relationship
130
+
131
+ worldbuilding serves the story, never the reverse.
132
+
133
+ build ONLY what the story needs:
134
+ [ ] what settings are required for plot events?
135
+ [ ] what cultures are needed for characters?
136
+ [ ] what rules (magic/tech) affect the plot?
137
+ [ ] what history created the current situation?
138
+
139
+ extra worldbuilding is wasted effort.
140
+ readers won't see 90% of what you create.
141
+
142
+
143
+ the iceberg principle in worldbuilding
144
+
145
+ show 10%, know 90%.
146
+
147
+ what readers see:
148
+ - immediate setting of each scene
149
+ - cultural details relevant to current action
150
+ - rules as they affect plot/characters
151
+ - history that explains present situations
152
+
153
+ what you must know:
154
+ - full geography and how it shapes cultures
155
+ - complete history that created current situation
156
+ - all rules and their implications
157
+ - how everything connects and affects each other
158
+
159
+ knowing the 90% creates consistency.
160
+ showing only 10% keeps story moving.
161
+
162
+
163
+ determining world scope
164
+
165
+ world scope matches story scale.
166
+
167
+ intimate story (small scale):
168
+ - few locations, deeply detailed
169
+ - one culture focus
170
+ - limited historical scope
171
+ - example: room-based drama, small town story
172
+
173
+ regional story (medium scale):
174
+ - multiple connected locations
175
+ - 2-3 cultures in contact
176
+ - regional history relevant to plot
177
+ - example: fantasy quest, political thriller
178
+
179
+ epic story (large scale):
180
+ - many diverse locations
181
+ - multiple cultures interacting
182
+ - world-spanning history
183
+ - example: war stories, empire sagas
184
+
185
+ match scope to story needs.
186
+ bigger is not always better.
187
+
188
+
189
+ exercise: scope definition
190
+
191
+ for your story, define the scope:
192
+
193
+ story scale: [intimate/regional/epic]
194
+
195
+ required locations:
196
+ [ ] [list only what's needed for plot]
197
+
198
+ required cultures:
199
+ [ ] [list only what's needed for characters]
200
+
201
+ required history:
202
+ [ ] [list only past events relevant to current story]
203
+
204
+ <create>
205
+ <file>world/scope.md</file>
206
+ <content>
207
+ # World Scope for [STORY NAME]
208
+
209
+ ## Story Scale
210
+ Type: [intimate/regional/epic]
211
+ Reason: [why this scope serves the story]
212
+
213
+ ## Required Locations
214
+ Primary settings:
215
+ - [name]: [function in story]
216
+ - [name]: [function in story]
217
+
218
+ Secondary settings:
219
+ - [name]: [function in story]
220
+ - [name]: [function in story]
221
+
222
+ ## Required Cultures
223
+ Primary culture:
224
+ - [name]: [connection to protagonist/plot]
225
+
226
+ Secondary cultures:
227
+ - [name]: [relationship to primary]
228
+ - [name]: [relationship to primary]
229
+
230
+ ## Required History
231
+ Relevant past events:
232
+ - [event]: [how it affects current story]
233
+ - [event]: [how it affects current story]
234
+ </content>
235
+ </create>
236
+
237
+
238
+ PHASE 2: GEOGRAPHY AND PHYSICAL WORLD
239
+
240
+
241
+ geography as story foundation
242
+
243
+ geography shapes everything else:
244
+ - cultures develop based on available resources
245
+ - politics emerge from geographical boundaries
246
+ - history flows from geographical conflict
247
+
248
+ build geography FIRST, then let it shape the rest.
249
+
250
+
251
+ essential geographical elements
252
+
253
+ [1] terrain type
254
+ - mountains, plains, deserts, forests, islands, etc.
255
+ - each terrain type creates specific cultural adaptations
256
+
257
+ [2] water features
258
+ - oceans, seas, rivers, lakes
259
+ - water = civilization (trade, food, travel)
260
+
261
+ [3] climate
262
+ - temperature, rainfall, seasons
263
+ - determines agriculture, architecture, clothing
264
+
265
+ [4] resources
266
+ - what's available? what's scarce?
267
+ - scarcity drives trade and conflict
268
+
269
+ [5] natural barriers
270
+ - mountains, deserts, oceans
271
+ - create isolation, cultural difference, political boundaries
272
+
273
+
274
+ realism in geography
275
+
276
+ even fantasy worlds should feel geographically plausible.
277
+
278
+ principles:
279
+
280
+ [1] rivers flow downhill (toward oceans/lakes)
281
+ [2] mountains form in ranges, not randomly
282
+ [3] climate varies by latitude and altitude
283
+ [4] deserts often exist on one side of mountain ranges
284
+ [5] civilizations cluster near water
285
+ [6] borders follow natural features
286
+
287
+ fantasy can break these rules, but should have reasons.
288
+ "magic did it" is a weak reason.
289
+ "the gods created this mountain as a barrier" is better.
290
+
291
+
292
+ exercise: map sketching
293
+
294
+ sketch your world's geography:
295
+
296
+ [ ] draw rough outline of landmasses
297
+ [ ] mark mountain ranges
298
+ [ ] draw major rivers
299
+ [ ] mark seas/oceans
300
+ [ ] note climate zones
301
+ [ ] mark resource locations
302
+ [ ] identify where civilizations would naturally form
303
+
304
+ you don't need artistic skill.
305
+ stick figures and labels work fine.
306
+ the goal is understanding, not presentation.
307
+
308
+
309
+ the map narrative
310
+
311
+ write a paragraph describing travel from point A to point B.
312
+
313
+ this forces you to think about:
314
+ - distance and travel time
315
+ - terrain difficulties
316
+ - what travelers would see
317
+ - how geography connects locations
318
+
319
+ <create>
320
+ <file>world/geography/travel_[a]_to_[b].md</file>
321
+ <content>
322
+ # Travel Narrative: [LOCATION A] to [LOCATION B]
323
+
324
+ Distance: [approximately how far]
325
+ Method of travel: [how people make this journey]
326
+ Typical travel time: [how long it takes]
327
+
328
+ Route Description:
329
+ [write a paragraph describing what a traveler sees and experiences
330
+ along the way - terrain, landmarks, dangers, stops]
331
+
332
+ Seasonal Variations:
333
+ [how does this journey change in different seasons?]
334
+
335
+ Dangers:
336
+ [what makes this journey risky?]
337
+ </content>
338
+ </create>
339
+
340
+
341
+ PHASE 3: HISTORY AND TIMELINE
342
+
343
+
344
+ history as current story foundation
345
+
346
+ history explains WHY the world is as it is.
347
+
348
+ current situations have historical causes:
349
+ - a war created current political boundaries
350
+ - a past atrocity fuels current hatred
351
+ - an old agreement created current alliances
352
+ - a past disaster shaped current culture
353
+
354
+ don't invent history for its own sake.
355
+ invent history to explain the present.
356
+
357
+
358
+ building a timeline
359
+
360
+ create a timeline that serves the story.
361
+
362
+ structure:
363
+
364
+ [1] deep past - creation myths, ancient history
365
+ [what do people believe about the beginning?]
366
+
367
+ [2] major events - empire rises/falls, great wars, discoveries
368
+ [what large events shaped the world?]
369
+
370
+ [3] recent past - living memory, current generation
371
+ [what happened that people currently remember?]
372
+
373
+ [4] immediate past - what led to current situation
374
+ [what directly created the story's starting point?]
375
+
376
+ focus most attention on [3] and [4].
377
+ these affect characters directly.
378
+
379
+
380
+ timeline depth guide
381
+
382
+ how much history do you need?
383
+
384
+ deep past (1000+ years ago):
385
+ - creation myths
386
+ - founding of major institutions
387
+ - ancient wars that are legendary
388
+ - only what affects current beliefs
389
+
390
+ major events (100-1000 years ago):
391
+ - political boundaries established
392
+ - current cultures emerged
393
+ - major conflicts that still resonate
394
+ - only what explains current tensions
395
+
396
+ recent past (0-100 years ago):
397
+ - characters' childhoods
398
+ - events parents experienced
399
+ - forming of current alliances
400
+ - anything that affects character motivations
401
+
402
+ immediate past (0-10 years ago):
403
+ - directly caused current situation
404
+ - relevant to protagonist's backstory
405
+ - created current conflicts
406
+ - detailed and specific
407
+
408
+
409
+ exercise: timeline creation
410
+
411
+ create a timeline for your world:
412
+
413
+ <create>
414
+ <file>world/history/timeline.md</file>
415
+ <content>
416
+ # World Timeline: [WORLD NAME]
417
+
418
+ ## Deep Past (Myth/Ancient)
419
+ [Year/ Era] - [Event]: [Significance to current world]
420
+
421
+ ## Major Events
422
+ [Year] - [Event]: [Significance to current world]
423
+ [Year] - [Event]: [Significance to current world]
424
+ [Year] - [Event]: [Significance to current world]
425
+
426
+ ## Recent Past (Living Memory)
427
+ [Year] - [Event]: [Who remembers this? How does it affect them?]
428
+ [Year] - [Event]: [Who remembers this? How does it affect them?]
429
+
430
+ ## Immediate Past (Pre-Story)
431
+ [Year] - [Event]: [Direct connection to story beginning]
432
+ [Year] - [Event]: [Direct connection to story beginning]
433
+
434
+ ## The Event That Started Everything
435
+ [Year] - [Event]: [This is what kicks off your story]
436
+ </content>
437
+ </create>
438
+
439
+
440
+ history through objects
441
+
442
+ show history through physical things:
443
+
444
+ [1] ruined monuments - what happened here?
445
+ [2] old battlefield - what was this conflict?
446
+ [3] abandoned buildings - why did people leave?
447
+ [4] cultural artifacts - what does this object mean?
448
+ [5] place names - who was this person/place?
449
+ [6] scars on the land - what caused this?
450
+
451
+ exercise: historical artifact
452
+
453
+ pick a location in your world. create an artifact
454
+ that implies history without exposition.
455
+
456
+ artifact: [describe the object]
457
+ location: [where is it found?]
458
+ condition: [what state is it in?]
459
+ implied history: [what does this suggest about the past?]
460
+
461
+ write a scene where a character encounters this artifact.
462
+ show their reaction. reveal history through interaction.
463
+
464
+
465
+ PHASE 4: CULTURE CREATION
466
+
467
+
468
+ culture as character writ large
469
+
470
+ cultures are collective characters.
471
+ they have personalities, flaws, virtues, conflicts.
472
+
473
+ culture components:
474
+
475
+ [1] values - what matters most?
476
+ [2] norms - what behaviors are expected?
477
+ [3] taboos - what's forbidden?
478
+ [4] rituals - what behaviors are performed?
479
+ [5] institutions - what structures organize society?
480
+ [6] arts - what do they create?
481
+ [7] beliefs - what do they hold true?
482
+
483
+
484
+ values foundation
485
+
486
+ every culture is built on values.
487
+
488
+ value questions:
489
+
490
+ [ ] what is this culture's highest good?
491
+ (honor? freedom? order? harmony? strength?)
492
+
493
+ [ ] what is this culture's greatest fear?
494
+ (chaos? weakness? shame? impurity? death?)
495
+
496
+ [ ] what do they admire in others?
497
+ (bravery? wisdom? beauty? wealth? piety?)
498
+
499
+ [ ] what do they despise?
500
+ (cowardice? stupidity? ugliness? poverty? impiety?)
501
+
502
+ [ ] what makes someone a good member of this culture?
503
+ (what virtues do they teach their children?)
504
+
505
+ values create behaviors.
506
+ behaviors reveal values.
507
+
508
+
509
+ norms and behaviors
510
+
511
+ norms are how values show up in daily life.
512
+
513
+ norm categories:
514
+
515
+ [1] social norms
516
+ - greetings and farewells
517
+ - personal space
518
+ - eye contact
519
+ - touching behavior
520
+ - queuing/waiting
521
+ - gift giving
522
+
523
+ [2] communication norms
524
+ - direct vs indirect speech
525
+ - interrupting or listening
526
+ - emotion display
527
+ - volume and tone
528
+ - silence meaning
529
+
530
+ [3] work norms
531
+ - punctuality expectations
532
+ - effort vs result
533
+ - hierarchy respect
534
+ - collaboration style
535
+
536
+ [4] gender norms (if applicable)
537
+ - roles and expectations
538
+ - dress and behavior
539
+ - power dynamics
540
+ - flexibility or rigidity
541
+
542
+
543
+ taboos
544
+
545
+ taboos are strong prohibitions.
546
+
547
+ every culture has lines you don't cross.
548
+
549
+ taboo levels:
550
+
551
+ [1] mild taboos - social disapproval
552
+ "you don't talk about money at dinner"
553
+
554
+ [2] strong taboos - social punishment
555
+ "adultery destroys your marriage prospects"
556
+
557
+ [3] absolute taboos - expulsion or death
558
+ "murder of a guest is punishable by execution"
559
+
560
+ taboos reveal what a culture sacredly protects.
561
+ they're excellent sources of conflict.
562
+
563
+
564
+ exercise: culture profile
565
+
566
+ create a profile for one culture:
567
+
568
+ <create>
569
+ <file>world/cultures/[culture_name].md</file>
570
+ <content>
571
+ # Culture Profile: [NAME]
572
+
573
+ ## Basics
574
+ Location: [where do they live?]
575
+ Population: [approximate size]
576
+ Neighbors: [who do they interact with?]
577
+
578
+ ## Values
579
+ Highest good: [what matters most]
580
+ Greatest fear: [what they most fear]
581
+ Admired traits: [what they value in people]
582
+ Despised traits: [what they hate]
583
+
584
+ ## Norms
585
+ Greeting: [how do they greet each other?]
586
+ Personal space: [close or distant?]
587
+ Eye contact: [direct or averted?]
588
+ Communication: [direct or indirect?]
589
+ Time: [precise or flexible?]
590
+
591
+ ## Taboos
592
+ Mild: [what causes social disapproval?]
593
+ Strong: [what causes real punishment?]
594
+ Absolute: [what is absolutely forbidden?]
595
+
596
+ ## Institutions
597
+ Government: [how are they ruled?]
598
+ Family structure: [how are families organized?]
599
+ Education: [how do they learn?]
600
+ Economy: [how do they get resources?]
601
+
602
+ ## Arts and Expression
603
+ What they create: [art, music, literature, etc.]
604
+ Aesthetic preferences: [what do they find beautiful?]
605
+ Storytelling traditions: [what stories do they tell?]
606
+ </content>
607
+ </create>
608
+
609
+
610
+ PHASE 5: POLITICAL SYSTEMS
611
+
612
+
613
+ politics as conflict engine
614
+
615
+ political systems create story conflicts.
616
+
617
+ [1] power struggles - who rules? who wants to?
618
+ [2] ideological conflicts - different visions of society
619
+ [3] resource conflicts - who gets what?
620
+ [4] succession crises - what happens when power changes?
621
+ [5] foreign relations - war, alliances, trade
622
+
623
+
624
+ government types
625
+
626
+ consider how your society is governed:
627
+
628
+ [1] monarchy - rule by one (hereditary)
629
+ - strength: stability, clarity
630
+ - weakness: depends on single ruler's quality
631
+ - conflict source: succession, bad rulers
632
+
633
+ [2] aristocracy - rule by few (elite)
634
+ - strength: expertise, continuity
635
+ - weakness: protects elite interests
636
+ - conflict source: exclusion, resentment
637
+
638
+ [3] democracy - rule by many (citizens)
639
+ - strength: representation, adaptability
640
+ - weakness: slow, factional
641
+ - conflict source: polarization, demagoguery
642
+
643
+ [4] theocracy - rule by religious authority
644
+ - strength: unified values
645
+ - weakness: inflexibility, persecution
646
+ - conflict source: heresy, interpretation disputes
647
+
648
+ [5] magocracy/technocracy - rule by magic/tech users
649
+ - strength: competence in domain
650
+ - weakness: power inequality
651
+ - conflict source: resource access, resentment
652
+
653
+
654
+ power distribution
655
+
656
+ how is power actually held and exercised?
657
+
658
+ [1] centralized - power concentrated at top
659
+ - efficient, coordinated
660
+ - vulnerable to single point failure
661
+ - creates distance between rulers and ruled
662
+
663
+ [2] decentralized - power distributed
664
+ - resilient, adaptable
665
+ - can be inefficient
666
+ - multiple power centers create competition
667
+
668
+ [3] federated - regional autonomy with central authority
669
+ - balance of local and central
670
+ - constant tension between levels
671
+
672
+ [4] anarchic - no formal government
673
+ - freedom, chaos
674
+ - power goes to those who can take it
675
+
676
+
677
+ law and justice
678
+
679
+ how does the society maintain order?
680
+
681
+ [ ] what behaviors are illegal?
682
+ [ ] who makes the laws?
683
+ [ ] who enforces the laws?
684
+ [ ] how are crimes punished?
685
+ [ ] how are disputes resolved?
686
+ [ ] is justice equal or stratified?
687
+
688
+ exercise: crime and punishment
689
+
690
+ for your culture, define:
691
+
692
+ crime: [specific act]
693
+ punishment: [what happens?]
694
+ reasoning: [why this punishment?]
695
+
696
+ example:
697
+ crime: theft of food
698
+ punishment: repayment + public shaming
699
+ reasoning: theft shows need, not malice; shame maintains order
700
+
701
+ create three such examples showing the culture's values.
702
+
703
+
704
+ PHASE 6: ECONOMICS AND RESOURCES
705
+
706
+
707
+ economics as world foundation
708
+
709
+ economics shapes:
710
+ - what cultures can afford (war, art, technology)
711
+ - where power lies (who controls resources)
712
+ - how people live (poverty, luxury, work)
713
+ - what conflicts emerge (resource competition)
714
+
715
+
716
+ resource mapping
717
+
718
+ what does your world have?
719
+
720
+ [1] abundant resources
721
+ - what's plentiful?
722
+ - who controls it?
723
+ - how does this create wealth/power?
724
+
725
+ [2] scarce resources
726
+ - what's rare?
727
+ - who needs it?
728
+ - how does this create conflict/innovation?
729
+
730
+ [3] unique resources
731
+ - what exists only in one place?
732
+ - why is it valuable?
733
+ - who fights to control it?
734
+
735
+ resources aren't just material.
736
+ knowledge, magic, technology can be resources too.
737
+
738
+
739
+ trade and exchange
740
+
741
+ how do goods and services move?
742
+
743
+ [1] trade routes
744
+ - what paths connect cultures?
745
+ - what goods travel these routes?
746
+ - what dangers do traders face?
747
+
748
+ [2] trade centers
749
+ - where do cultures meet and exchange?
750
+ - what makes these locations ideal?
751
+ - who controls these hubs?
752
+
753
+ [3] currencies
754
+ - what do people use for exchange?
755
+ - coins? barter? favors? reputation?
756
+ - what gives it value?
757
+
758
+ [4] trade relationships
759
+ - who trades with whom?
760
+ - who's dependent on whom?
761
+ - what creates leverage?
762
+
763
+
764
+ wealth distribution
765
+
766
+ how is wealth shared?
767
+
768
+ [1] equal - minimal inequality
769
+ - often small, homogeneous cultures
770
+ - may limit individual achievement
771
+ - requires strong social cohesion
772
+
773
+ [2] stratified - significant inequality
774
+ - common in large, complex societies
775
+ - creates social tension
776
+ - justifications vary (divine right, merit, etc.)
777
+
778
+ [3] highly unequal - extreme wealth gap
779
+ - small elite, large underclass
780
+ - unstable without force
781
+ - source of conflict and revolution
782
+
783
+ exercise: economic snapshot
784
+
785
+ create an economic profile:
786
+
787
+ <create>
788
+ <file>world/economy/[culture_name]_economy.md</file>
789
+ <content>
790
+ # Economic Profile: [CULTURE NAME]
791
+
792
+ ## Resources
793
+ Abundant:
794
+ - [resource]: [who benefits?]
795
+ Scarce:
796
+ - [resource]: [who needs it?]
797
+ Unique:
798
+ - [resource]: [why is it special?]
799
+
800
+ ## Trade
801
+ Major routes: [where do goods flow?]
802
+ Key goods: [what's traded?]
803
+ Trade partners: [who do they exchange with?]
804
+ Currency: [what do they use for exchange?]
805
+
806
+ ## Wealth Distribution
807
+ Level: [equal/stratified/highly unequal]
808
+ Justification: [how is this explained/defended?]
809
+ Tension: [is this stable? what conflicts exist?]
810
+
811
+ ## Economic Activities
812
+ Primary: [how do they get resources?]
813
+ Secondary: [how do they process them?]
814
+ Tertiary: [what services exist?]
815
+ </content>
816
+ </create>
817
+
818
+
819
+ PHASE 7: MAGIC OR TECHNOLOGY SYSTEMS
820
+
821
+
822
+ magic/tech as rules-based systems
823
+
824
+ whether magic or advanced technology, create clear rules.
825
+
826
+ systems need:
827
+ [1] source - where does it come from?
828
+ [2] cost - what does using it require?
829
+ [3] limits - what can't it do?
830
+ [4] consequences - what happens when used?
831
+ [5] availability - who can access it?
832
+
833
+
834
+ magic system design
835
+
836
+ hard magic (explicit rules):
837
+ - defined capabilities and limits
838
+ - consistent costs
839
+ - can be used strategically by characters
840
+ - example: brandon sanderson's systems
841
+
842
+ soft magic (mysterious):
843
+ - undefined capabilities
844
+ - unpredictable effects
845
+ - serves as wonder/problem, not solution
846
+ - example: tolkien's magic
847
+
848
+ most stories use both:
849
+ hard magic for protagonists (solve problems)
850
+ soft magic for antagonists (create mystery)
851
+
852
+
853
+ magic system questionnaire
854
+
855
+ [ ] source
856
+ - where does magic come from?
857
+ - is it inherent, learned, granted, found?
858
+
859
+ [ ] access
860
+ - who can use magic?
861
+ - is it common, rare, unique?
862
+ - how do people gain access?
863
+
864
+ [ ] cost
865
+ - what does using magic cost?
866
+ - energy, health, sanity, materials?
867
+ - can the cost kill you?
868
+
869
+ [ ] limits
870
+ - what can magic NOT do?
871
+ - are there immutable rules?
872
+ - what happens when rules are broken?
873
+
874
+ [ ] types
875
+ - are there different kinds of magic?
876
+ - do they interact or conflict?
877
+ - can they be combined?
878
+
879
+ [ ] social position
880
+ - how does society treat magic users?
881
+ - honored? feared? hunted? controlled?
882
+ - how does this shape the world?
883
+
884
+
885
+ technology levels
886
+
887
+ define what technology exists in your world.
888
+
889
+ tech continuum:
890
+ [1] pre-technical - stone tools, hunter-gatherer
891
+ [2] agricultural - farming, basic settlements
892
+ [3] pre-industrial - craft specialization, simple machines
893
+ [4] industrial - mass production, mechanization
894
+ [5] modern - information age, digital technology
895
+ [6] advanced - AI, space travel, post-scarcity
896
+ [7] futuristic - beyond current understanding
897
+
898
+ fantasy worlds often have mixed tech:
899
+ - medieval weapons + advanced medicine
900
+ - pre-industrial transport + magical communication
901
+ - ancient society + lost high-tech past
902
+
903
+ whatever you choose, be consistent.
904
+
905
+
906
+ exercise: magic/tech system profile
907
+
908
+ define your system:
909
+
910
+ <create>
911
+ <file>world/[magic_tech]_system.md</file>
912
+ <content>
913
+ # [Magic/Technology] System: [WORLD NAME]
914
+
915
+ ## Type
916
+ Category: [hard/soft system]
917
+ Source: [where does it come from?]
918
+
919
+ ## Access
920
+ Who can use it: [anyone/some/few/unique]
921
+ How gained: [born with/learned/granted/etc]
922
+ Training required: [years of study/days/none]
923
+
924
+ ## Capabilities
925
+ What it CAN do:
926
+ - [capability 1]: [specific example]
927
+ - [capability 2]: [specific example]
928
+ - [capability 3]: [specific example]
929
+
930
+ What it CANNOT do (hard limits):
931
+ - [limitation 1]: [why?]
932
+ - [limitation 2]: [why?]
933
+ - [limitation 3]: [why?]
934
+
935
+ ## Cost
936
+ Price of use: [energy/material/sanity/etc]
937
+ Short-term consequence: [what happens immediately?]
938
+ Long-term consequence: [what happens with repeated use?]
939
+ Can it kill you? [how?]
940
+
941
+ ## Society
942
+ Public attitude: [how do people feel about it?]
943
+ Legal status: [is it regulated/banned/etc?]
944
+ Social position of users: [honored/fear/hunted/etc]
945
+ Institutions: [what organizations control it?]
946
+
947
+ ## Plot Integration
948
+ How it creates conflict: [ ]
949
+ How it solves problems: [ ]
950
+ How it shapes the world: [ ]
951
+ </content>
952
+ </create>
953
+
954
+
955
+ PHASE 8: CULTURAL DIVERSITY AND CONTACT
956
+
957
+
958
+ multiple cultures
959
+
960
+ most stories involve more than one culture.
961
+
962
+ create diversity through:
963
+ [1] different values - what matters varies
964
+ [2] different norms - behaviors differ
965
+ [3] different resources - environments shape cultures
966
+ [4] different histories - past events created differences
967
+ [5] different adaptations - similar problems, different solutions
968
+
969
+
970
+ cultural contact zones
971
+
972
+ cultures interact in predictable ways:
973
+
974
+ [1] trade cities - where goods and ideas exchange
975
+ - cultural mixing
976
+ - hybrid cultures emerge
977
+ - tolerance and tension
978
+
979
+ [2] borderlands - where cultures meet and clash
980
+ - military presence
981
+ - cultural blending or conflict
982
+ - identity complexity
983
+
984
+ [3] conquest zones - one culture dominates another
985
+ - power inequality
986
+ - resistance and adaptation
987
+ - cultural trauma
988
+
989
+ [4] diaspora communities - dispersed cultures
990
+ - preserving identity
991
+ - assimilation pressures
992
+ - cultural evolution
993
+
994
+
995
+ cultural differences as conflict
996
+
997
+ culture clash creates story conflict:
998
+
999
+ [1] value conflicts
1000
+ - what's good in one culture is bad in another
1001
+ - example: individualism vs collectivism
1002
+
1003
+ [2] norm conflicts
1004
+ - polite in one culture is rude in another
1005
+ - example: direct vs indirect communication
1006
+
1007
+ [3] resource conflicts
1008
+ - cultures want the same things
1009
+ - example: competing claims to land
1010
+
1011
+ [4] religious conflicts
1012
+ - different beliefs about ultimate questions
1013
+ - example: different gods, different rules
1014
+
1015
+ [5] historical conflicts
1016
+ - past wrongs, remembered grievances
1017
+ - example: old wars, old atrocities
1018
+
1019
+
1020
+ avoiding monocultures
1021
+
1022
+ no culture is uniform.
1023
+
1024
+ within any culture, you find:
1025
+ [1] subcultures - regional, class,职业 variations
1026
+ [2] counter-cultures - groups rejecting mainstream
1027
+ [3] individual variation - not everyone conforms
1028
+ [4] change over time - cultures aren't static
1029
+ [5] internal conflict - cultures argue with themselves
1030
+
1031
+ exercise: cultural diversity
1032
+
1033
+ pick your main culture. create internal variation:
1034
+
1035
+ subculture 1:
1036
+ - how do they differ from mainstream?
1037
+ - where are they located?
1038
+ - how are they viewed?
1039
+
1040
+ subculture 2:
1041
+ - how do they differ from mainstream?
1042
+ - where are they located?
1043
+ - how are they viewed?
1044
+
1045
+ counter-culture:
1046
+ - what do they reject?
1047
+ - what do they offer instead?
1048
+ - how does the mainstream view them?
1049
+
1050
+
1051
+ PHASE 9: LANGUAGE AND NAMES
1052
+
1053
+
1054
+ language basics
1055
+
1056
+ you don't need to create a full language.
1057
+ you need naming consistency and linguistic flavor.
1058
+
1059
+ language components to consider:
1060
+
1061
+ [1] phonemes - what sounds exist?
1062
+ - harsh consonants vs flowing vowels
1063
+ - click sounds, tones, etc.
1064
+ - creates cultural "feel"
1065
+
1066
+ [2] syntax - how are sentences built?
1067
+ - word order patterns
1068
+ - simple or complex structure
1069
+ - influences translation style
1070
+
1071
+ [3] vocabulary - what concepts exist?
1072
+ - words for things important to the culture
1073
+ - no words for concepts they don't have
1074
+ - reveals cultural priorities
1075
+
1076
+ [4] idioms - figurative expressions
1077
+ - reveal cultural worldview
1078
+ - add authenticity
1079
+ - create immersion
1080
+
1081
+
1082
+ naming conventions
1083
+
1084
+ consistent naming creates believable worlds.
1085
+
1086
+ consider:
1087
+
1088
+ [1] name structure
1089
+ - given name + family name?
1090
+ - given name + clan name + given name?
1091
+ - name changes over life?
1092
+ - religious/secular names?
1093
+
1094
+ [2] name meanings
1095
+ - do names have meanings?
1096
+ - are meanings significant?
1097
+ - how are names chosen?
1098
+
1099
+ [3] name sources
1100
+ - nature? ancestors? virtues?
1101
+ - random? divined? purchased?
1102
+
1103
+ [4] foreign names
1104
+ - how do they adapt names from other cultures?
1105
+ - translate? transliterate? avoid?
1106
+
1107
+
1108
+ exercise: naming guide
1109
+
1110
+ create a naming guide for one culture:
1111
+
1112
+ <create>
1113
+ <file>world/language/[culture]_naming.md</file>
1114
+ <content>
1115
+ # Naming Guide: [CULTURE NAME]
1116
+
1117
+ ## Structure
1118
+ Full name format: [explain how names are structured]
1119
+ Example: [give an example name breakdown]
1120
+
1121
+ ## Given Names
1122
+ Source: [where do given names come from?]
1123
+ Meanings: [do names have meanings?]
1124
+ Gender: [are names gendered?]
1125
+ Examples:
1126
+ - Male: [list 5-10 examples]
1127
+ - Female: [list 5-10 examples]
1128
+ - Neutral: [list 5-10 examples]
1129
+
1130
+ ## Family Names
1131
+ Source: [where do family names come from?]
1132
+ Inheritance: [how are they passed down?]
1133
+ Examples: [list 10 common family names]
1134
+
1135
+ ## Special Names
1136
+ Honorifics: [titles and respect forms]
1137
+ Religious names: [if applicable]
1138
+ Outsider names: [how are foreign names handled?]
1139
+
1140
+ ## Sound Patterns
1141
+ Common sounds: [what phonemes are frequent?]
1142
+ Forbidden sounds: [what sounds don't occur?]
1143
+ Rhythm: [stressed/unstressed patterns]
1144
+ Length: [typical name length]
1145
+ </content>
1146
+ </create>
1147
+
1148
+
1149
+ creating foreign flavor
1150
+
1151
+ add linguistic flavor without full conlangs:
1152
+
1153
+ [1] recurring foreign words
1154
+ - concepts that don't translate
1155
+ - terms of address
1156
+ - cultural-specific ideas
1157
+
1158
+ [2] names and titles
1159
+ - use character names from the culture
1160
+ - show respect forms
1161
+ - reveal hierarchy
1162
+
1163
+ [3] translated idioms
1164
+ - "may your road be smooth"
1165
+ - "the wolf at the door"
1166
+ - reveal cultural worldview
1167
+
1168
+ [4] speech patterns in translation
1169
+ - formal vs casual grammar
1170
+ - direct vs indirect communication
1171
+ - shows cultural approach
1172
+
1173
+
1174
+ PHASE 10: RELIGION AND BELIEF SYSTEMS
1175
+
1176
+
1177
+ religion as culture foundation
1178
+
1179
+ beliefs shape:
1180
+ - what people value (morality)
1181
+ - how they behave (norms, taboos)
1182
+ - how they explain the world (cosmology)
1183
+ - how they organize (institutions)
1184
+ - what they hope for (eschatology)
1185
+
1186
+
1187
+ belief system components
1188
+
1189
+ [1] cosmology - what is the universe?
1190
+ - creation story
1191
+ - structure of reality
1192
+ - place of humans in the universe
1193
+
1194
+ [2] theology - what are the gods/powers?
1195
+ - number and nature of deities
1196
+ - their powers and domains
1197
+ - their relationships to each other and humans
1198
+
1199
+ [3] eschatology - what happens after death?
1200
+ - afterlife (or not)
1201
+ - judgment, reward, punishment
1202
+ - ultimate fate of the world
1203
+
1204
+ [4] praxis - what do believers do?
1205
+ - rituals, prayers, practices
1206
+ - holy days, festivals
1207
+ - life cycle events (birth, marriage, death)
1208
+
1209
+ [5] morality - how should believers live?
1210
+ - commandments, virtues, sins
1211
+ - guidance for daily life
1212
+ - resolution of moral dilemmas
1213
+
1214
+
1215
+ religious diversity
1216
+
1217
+ worlds rarely have single beliefs.
1218
+
1219
+ within-culture diversity:
1220
+ - different interpretations
1221
+ - different sects/denominations
1222
+ - orthodox vs heterodox
1223
+ - believers vs non-believers
1224
+
1225
+ between-culture diversity:
1226
+ - different religions
1227
+ - syncretic blending
1228
+ - proselytizing and conversion
1229
+ - religious conflict
1230
+
1231
+
1232
+ religion and story
1233
+
1234
+ religion can:
1235
+ [1] motivate characters - true believers act on faith
1236
+ [2] create conflict - religious disagreements
1237
+ [3] explain world - beliefs shape behavior
1238
+ [4] provide symbolism - ritual, metaphor
1239
+ [5] offer resolution - spiritual answers
1240
+
1241
+ exercise: belief system profile
1242
+
1243
+ <create>
1244
+ <file>world/religions/[belief_name].md</file>
1245
+ <content>
1246
+ # Belief System: [NAME]
1247
+
1248
+ ## Basics
1249
+ Type: [monotheism/polytheism/animism/philosophy/etc]
1250
+ Followers: [who believes this?]
1251
+ Distribution: [where is it believed?]
1252
+
1253
+ ## Cosmology
1254
+ Creation: [how did the universe begin?]
1255
+ Structure: [what is the universe like?]
1256
+ Humanity's place: [where do humans fit?]
1257
+
1258
+ ## Theology
1259
+ Deities/Forces: [what powers exist?]
1260
+ Domains: [what do they control?]
1261
+ Relationships: [how do they relate to each other? to humans?]
1262
+ Intervention: [do they act in the world? how?]
1263
+
1264
+ ## Eschatology
1265
+ Afterlife: [what happens after death?]
1266
+ Judgment: [is there judgment? criteria?]
1267
+ Ultimate fate: [where is everything going?]
1268
+
1269
+ ## Praxis
1270
+ Daily practices: [what do believers do daily?]
1271
+ Weekly rituals: [what happens regularly?]
1272
+ Annual festivals: [what special days exist?]
1273
+ Life events: [birth, marriage, death rituals]
1274
+
1275
+ ## Morality
1276
+ Virtues: [what is good?]
1277
+ Sins: [what is evil?]
1278
+ Guidance: [how do believers know what to do?]
1279
+
1280
+ ## Institutions
1281
+ Organization: [how is belief organized?]
1282
+ Leadership: [who leads? how are they chosen?]
1283
+ Spaces: [where do believers gather?]
1284
+ Relationship to state: [how does power interact with belief?]
1285
+ </content>
1286
+ </create>
1287
+
1288
+
1289
+ PHASE 11: DAILY LIFE AND MATERIAL CULTURE
1290
+
1291
+
1292
+ daily life creates immersion
1293
+
1294
+ readers connect with daily details:
1295
+ - what people eat
1296
+ - how they dress
1297
+ - where they live
1298
+ - how they travel
1299
+ - what they do for fun
1300
+
1301
+ these details make the world feel real.
1302
+
1303
+
1304
+ food and drink
1305
+
1306
+ food culture reveals:
1307
+ - geography (what's available)
1308
+ - wealth (what can they afford?)
1309
+ - values (hospitality, status, etc.)
1310
+ - technology (cooking methods, preservation)
1311
+
1312
+ consider:
1313
+ [ ] staples - what do people eat daily?
1314
+ [ ] delicacies - what's special or rare?
1315
+ [ ] taboos - what won't they eat?
1316
+ [ ] meals - how many and when?
1317
+ [ ] dining - who eats together? how?
1318
+ [ ] drink - what do they drink? alcohol? water?
1319
+
1320
+
1321
+ clothing and appearance
1322
+
1323
+ clothing communicates:
1324
+ - status (wealth, rank)
1325
+ - identity (culture, profession)
1326
+ - values (modesty, display, etc.)
1327
+ - practicality (climate, activity)
1328
+
1329
+ consider:
1330
+ [ ] materials - what fabrics are available?
1331
+ [ ] styles - what do people wear?
1332
+ [ ] variation - by class, gender, profession?
1333
+ [ ] symbolism - do clothes have meaning?
1334
+ [ ] taboo - what's not worn?
1335
+
1336
+
1337
+ housing and architecture
1338
+
1339
+ buildings show:
1340
+ - technology (what can they build?)
1341
+ - wealth (what can they afford?)
1342
+ - values (privacy, community, etc.)
1343
+ - environment (adaptation to climate)
1344
+
1345
+ consider:
1346
+ [ ] materials - stone, wood, brick, etc.
1347
+ [ ] layout - how are spaces arranged?
1348
+ [ ] density - cities or villages?
1349
+ [ ] public spaces - what do they build together?
1350
+ [ ] defensive features - walls, forts, etc?
1351
+
1352
+
1353
+ transport and communication
1354
+
1355
+ how do people and information move?
1356
+
1357
+ transport:
1358
+ [ ] what methods exist? (walking, riding, vehicles, etc.)
1359
+ [ ] how long does travel take?
1360
+ [ ] who can travel? (everyone, elite, merchants?)
1361
+ [ ] what infrastructure exists? (roads, ports, etc.)
1362
+
1363
+ communication:
1364
+ [ ] how do messages travel?
1365
+ [ ] how fast is communication?
1366
+ [ ] who has access to information?
1367
+ [ ] how is information controlled?
1368
+
1369
+
1370
+ exercise: daily life scene
1371
+
1372
+ write a scene showing daily life in your world.
1373
+
1374
+ follow one character through:
1375
+ [ ] waking up - what's their home like?
1376
+ [ ] breakfast - what do they eat?
1377
+ [ ] work - what do they do?
1378
+ [ ] lunch - break routine
1379
+ [ ] evening - what do they do for fun?
1380
+ [ ] sleep - how does the day end?
1381
+
1382
+ focus on sensory details:
1383
+ - smells, tastes, sounds
1384
+ - textures, temperatures
1385
+ - what's seen, heard, felt
1386
+
1387
+
1388
+ PHASE 12: REVEALING WORLD THROUGH STORY
1389
+
1390
+
1391
+ the iceberg in practice
1392
+
1393
+ you know 90% of the world.
1394
+ show only 10%.
1395
+
1396
+ principles of revelation:
1397
+
1398
+ [1] relevance first
1399
+ - show what's relevant to current scene
1400
+ - explain only when necessary for understanding
1401
+ - trust readers to infer
1402
+
1403
+ [2] action over exposition
1404
+ - show the world in motion
1405
+ - let behavior reveal culture
1406
+ - demonstrate rules through consequences
1407
+
1408
+ [3] character perspective
1409
+ - reveal what the character notices
1410
+ - what's strange to them is strange to us
1411
+ - what's normal to them becomes normal to us
1412
+
1413
+ [4] conflict-driven
1414
+ - reveal world through problems
1415
+ - cultural clashes reveal differences
1416
+ - rule violations show what's forbidden
1417
+
1418
+
1419
+ avoiding info-dumps
1420
+
1421
+ info-dump: large block of worldbuilding explanation.
1422
+
1423
+ problems:
1424
+ - stops story momentum
1425
+ - feels like lecture
1426
+ - readers skim and forget
1427
+
1428
+ alternatives:
1429
+
1430
+ [1] weave into action
1431
+ instead of explaining the political system,
1432
+ show a character navigating it
1433
+
1434
+ [2] dialogue
1435
+ have characters explain what they already know
1436
+ to someone who doesn't (fish out of water)
1437
+
1438
+ [3] triggered memory
1439
+ current event reminds character of past
1440
+ reveal through association
1441
+
1442
+ [4] demonstration
1443
+ show the rule/concept in action
1444
+ let readers infer the explanation
1445
+
1446
+
1447
+ the stranger guide
1448
+
1449
+ classic technique: stranger arrives in new world.
1450
+
1451
+ why it works:
1452
+ - stranger needs explanations (justifies exposition)
1453
+ - stranger notices what locals take for granted
1454
+ - reader learns with stranger
1455
+ - culture shock creates natural conflict
1456
+
1457
+ pitfalls:
1458
+ - don't overuse
1459
+ - stranger needs own arc (not just tour guide)
1460
+ - locals shouldn't be stupid
1461
+ - balance curiosity with urgency
1462
+
1463
+
1464
+ exercise: world introduction
1465
+
1466
+ write a scene introducing your world.
1467
+
1468
+ requirements:
1469
+ [ ] establish setting through action
1470
+ [ ] reveal one cultural norm through behavior
1471
+ [ ] hint at one rule (magic/tech/social)
1472
+ [ ] create a question in the reader's mind
1473
+ [ ] no direct exposition longer than 2 sentences
1474
+
1475
+ <create>
1476
+ <file>world/world_introduction_scene.md</file>
1477
+ <content>
1478
+ # World Introduction Scene
1479
+
1480
+ Draft:
1481
+ [write your scene here]
1482
+
1483
+ Checklist:
1484
+ [ ] setting established through action
1485
+ [ ] cultural norm revealed through behavior
1486
+ [ ] world rule hinted at
1487
+ [ ] reader questions created
1488
+ [ ] exposition limited
1489
+
1490
+ Revision Notes:
1491
+ [what works? what needs improvement?]
1492
+ </content>
1493
+ </create>
1494
+
1495
+
1496
+ PHASE 12: WORLD CONSISTENCY SYSTEMS
1497
+
1498
+
1499
+ consistency is immersion
1500
+
1501
+ inconsistency breaks the world spell.
1502
+ readers stop believing when rules contradict themselves.
1503
+
1504
+ consistency systems:
1505
+
1506
+ [1] rule documentation
1507
+ - write down every rule you establish
1508
+ - update when rules are revealed
1509
+ - check before contradicting
1510
+
1511
+ [2] consequence tracking
1512
+ - actions have consistent effects
1513
+ - if X happens, Y always results
1514
+ - readers learn the world's logic
1515
+
1516
+ [3] cultural coherence
1517
+ - values connect to behaviors
1518
+ - geography influences culture
1519
+ - history explains present
1520
+
1521
+ [4] cause and effect
1522
+ - everything has a reason
1523
+ - nothing happens "just because"
1524
+ - world operates on logic
1525
+
1526
+
1527
+ the world bible
1528
+
1529
+ maintain a master reference document.
1530
+
1531
+ sections:
1532
+ [ ] physical rules - geography, physics
1533
+ [ ] magic/tech rules - systems and limits
1534
+ [ ] cultural rules - norms, taboos, values
1535
+ [ ] political rules - government, laws
1536
+ [ ] economic rules - resources, trade
1537
+ [ ] linguistic rules - names, language patterns
1538
+ [ ] historical timeline - events and their consequences
1539
+
1540
+ update as you write.
1541
+ refer to when planning scenes.
1542
+
1543
+
1544
+ tracking systems
1545
+
1546
+ for ongoing consistency:
1547
+
1548
+ [ ] rule log
1549
+ date | category | rule established | location
1550
+ 2024-01-15 | magic | fire requires gesture | ch3
1551
+ 2024-01-16 | culture | shoes removed indoors | ch5
1552
+
1553
+ [ ] location register
1554
+ name | description | connections | first appearance
1555
+ tavern | meeting place, neutral ground | connected to thieves | ch1
1556
+
1557
+ [ ] character register
1558
+ name | culture | role | relationships
1559
+ kira | northern | protagonist | sister to joren
1560
+
1561
+ [ ] terminology guide
1562
+ term | meaning | first use | notes
1563
+ flow | magical energy | ch1 | can be dangerous
1564
+
1565
+
1566
+ PHASE 13: WORLDBUILDING CHECKLISTS
1567
+
1568
+
1569
+ comprehensive world checklist
1570
+
1571
+ for complete worlds, verify:
1572
+
1573
+ geography:
1574
+ [ ] map created (even if rough)
1575
+ [ ] climate zones established
1576
+ [ ] resources identified
1577
+ [ ] travel times calculated
1578
+ [ ] natural barriers noted
1579
+
1580
+ history:
1581
+ [ ] timeline created
1582
+ [ ] major events established
1583
+ [ ] recent past detailed
1584
+ [ ] connection to current story clear
1585
+
1586
+ cultures:
1587
+ [ ] values defined for each culture
1588
+ [ ] norms established
1589
+ [ ] taboos identified
1590
+ [ ] institutions described
1591
+ [ ] variation within cultures noted
1592
+
1593
+ politics:
1594
+ [ ] government type defined
1595
+ [ ] power structure clear
1596
+ [ ] laws and consequences established
1597
+ [ ] international relationships defined
1598
+
1599
+ economics:
1600
+ [ ] resources mapped
1601
+ [ ] trade routes established
1602
+ [ ] wealth distribution defined
1603
+ [ ] currency/exchange system clear
1604
+
1605
+ magic/tech (if applicable):
1606
+ [ ] rules established
1607
+ [ ] costs defined
1608
+ [ ] limits identified
1609
+ [ ] social position determined
1610
+
1611
+ language:
1612
+ [ ] naming conventions created
1613
+ [ ] foreign words documented
1614
+ [ ] speech patterns defined
1615
+
1616
+
1617
+ scene-level world checklist
1618
+
1619
+ before writing each scene, verify:
1620
+
1621
+ [ ] where is this scene? (specific location)
1622
+ [ ] what's the environment like? (sensory details)
1623
+ [ ] what cultural norms apply? (behavior expectations)
1624
+ [ ] what world rules affect this scene? (magic/tech/law)
1625
+ [ ] what history is relevant? (context)
1626
+
1627
+ after writing each scene, verify:
1628
+
1629
+ [ ] is the setting clear?
1630
+ [ ] are cultural behaviors consistent?
1631
+ [ ] are world rules followed?
1632
+ [ ] is the world revealed through action?
1633
+ [ ] are there any contradictions to established material?
1634
+
1635
+
1636
+ consistency checking
1637
+
1638
+ after drafting, do a world pass:
1639
+
1640
+ read for world consistency:
1641
+ [ ] are all rules followed?
1642
+ [ ] are all locations consistent?
1643
+ [ ] are all cultural behaviors consistent?
1644
+ [ ] are there any contradictions?
1645
+
1646
+ check causality:
1647
+ [ ] does everything have a reason?
1648
+ [ ] do consequences follow actions?
1649
+ [ ] does the world make logical sense?
1650
+
1651
+ check revelation:
1652
+ [ ] is the world revealed gradually?
1653
+ [ ] is info-dumping avoided?
1654
+ [ ] is exposition balanced with action?
1655
+
1656
+
1657
+ PHASE 14: AVOIDING COMMON WORLDBUILDING PITFALLS
1658
+
1659
+
1660
+ pitfall: overbuilding
1661
+
1662
+ problem: creating more world than the story needs.
1663
+
1664
+ symptoms:
1665
+ - encyclopedic detail no reader sees
1666
+ - worldbuilding replaces actual story
1667
+ - scenes become tours, not narratives
1668
+
1669
+ solution:
1670
+ - build only what the story requires
1671
+ - add details only when relevant to scene
1672
+ - remember: world serves story, not vice versa
1673
+
1674
+
1675
+ pitfall: underbuilding
1676
+
1677
+ problem: discovering contradictions mid-draft.
1678
+
1679
+ symptoms:
1680
+ - realizing a location doesn't make sense
1681
+ - forgetting previously established rules
1682
+ - cultures changing arbitrarily
1683
+
1684
+ solution:
1685
+ - build foundation before drafting
1686
+ - document rules as established
1687
+ - maintain consistency log
1688
+
1689
+
1690
+ pitfall: monocultural worlds
1691
+
1692
+ problem: entire fantasy world speaks with one voice.
1693
+
1694
+ symptoms:
1695
+ - every culture thinks alike
1696
+ - no cultural conflict or difference
1697
+ - foreign cultures are just costume changes
1698
+
1699
+ solution:
1700
+ - give each culture distinct values
1701
+ - create meaningful cultural differences
1702
+ - show variation within cultures
1703
+
1704
+
1705
+ pitfall: exoticism
1706
+
1707
+ problem: treating cultures as curiosities.
1708
+
1709
+ symptoms:
1710
+ - describing cultures as "strange" or "exotic"
1711
+ - reducing real cultures to stereotypes
1712
+ - treating cultural difference as spectacle
1713
+
1714
+ solution:
1715
+ - present cultures from within, not from outside
1716
+ - show the reasons behind cultural differences
1717
+ - treat all cultures with equal respect
1718
+
1719
+
1720
+ pitfall: static worlds
1721
+
1722
+ problem: worlds don't change or have history.
1723
+
1724
+ symptoms:
1725
+ - cultures feel like museum exhibits
1726
+ - no sense of historical development
1727
+ - no current tensions or changes
1728
+
1729
+ solution:
1730
+ - show culture in flux
1731
+ - include reform movements, generational change
1732
+ - let world evolve during story
1733
+
1734
+
1735
+ pitfall: arbitrary rules
1736
+
1737
+ problem: rules that exist only because author said so.
1738
+
1739
+ symptoms:
1740
+ - magic/tech rules feel random
1741
+ - cultural behaviors have no rationale
1742
+ - readers can't predict consequences
1743
+
1744
+ solution:
1745
+ - give every rule a reason
1746
+ - connect rules to each other
1747
+ - ensure internal logic
1748
+
1749
+
1750
+ PHASE 15: WORLD EXERCISES AND PROMPTS
1751
+
1752
+
1753
+ world development exercises
1754
+
1755
+ exercise 1: the travelogue
1756
+
1757
+ write about a journey across your world.
1758
+
1759
+ from: [starting location]
1760
+ to: [destination]
1761
+
1762
+ describe:
1763
+ - what landscapes are crossed?
1764
+ - what cultures are encountered?
1765
+ - what dangers exist?
1766
+ - how long does it take?
1767
+ - what does a traveler need?
1768
+
1769
+ this forces you to think about connections between locations.
1770
+
1771
+
1772
+ exercise 2: the artifact
1773
+
1774
+ create an object that implies world history.
1775
+
1776
+ object: [describe it]
1777
+ location: [where is it found?]
1778
+ condition: [what state is it in?]
1779
+
1780
+ what does it imply about:
1781
+ - who made it?
1782
+ - when was it made?
1783
+ - what was it used for?
1784
+ - why is it here now?
1785
+
1786
+ write a scene where someone discovers this artifact
1787
+ and what they learn from it.
1788
+
1789
+
1790
+ exercise 3: the menu
1791
+
1792
+ create a meal from your world.
1793
+
1794
+ culture: [who's eating?]
1795
+ occasion: [why is this meal special?]
1796
+
1797
+ list:
1798
+ - main dish: [what and why?]
1799
+ - side dishes: [what and why?]
1800
+ - drink: [what and why?]
1801
+ - dessert: [what and why?]
1802
+
1803
+ explain:
1804
+ - what does this meal reveal about the culture?
1805
+ - what ingredients show geography/wealth?
1806
+ - what preparations show technology?
1807
+ - what customs show values?
1808
+
1809
+
1810
+ exercise 4: the conflict
1811
+
1812
+ create a conflict based on worldbuilding.
1813
+
1814
+ type: [resource/ideological/territorial/cultural/etc]
1815
+
1816
+ sides:
1817
+ - culture A: [what do they want? why?]
1818
+ - culture B: [what do they want? why?]
1819
+
1820
+ history:
1821
+ - when did this start?
1822
+ - what previous events led to this?
1823
+
1824
+ current situation:
1825
+ - what's happening now?
1826
+ - what could resolve this?
1827
+
1828
+ this exercise connects worldbuilding to story conflict.
1829
+
1830
+
1831
+ exercise 5: the news
1832
+
1833
+ write a news report from your world.
1834
+
1835
+ format: [written/broadcast/sung/etc]
1836
+
1837
+ event: [what happened?]
1838
+
1839
+ perspective: [who's reporting? what's their bias?]
1840
+
1841
+ what does this report reveal about:
1842
+ - the world's technology?
1843
+ - the world's politics?
1844
+ - the world's values?
1845
+ - the world's problems?
1846
+
1847
+
1848
+ exercise 6: the conversation
1849
+
1850
+ write a conversation between two people from different
1851
+ cultures in your world.
1852
+
1853
+ characters:
1854
+ - person from culture A: [who are they?]
1855
+ - person from culture B: [who are they?]
1856
+
1857
+ topic: [what are they discussing?]
1858
+
1859
+ show through dialogue:
1860
+ - different values
1861
+ - different assumptions
1862
+ - different communication styles
1863
+ - different references/knowledge
1864
+
1865
+ avoid explanation.
1866
+ let differences emerge naturally.
1867
+
1868
+
1869
+ PHASE 16: WORLDBUILDING RULES (STRICT MODE)
1870
+
1871
+
1872
+ while this skill is active, these rules are MANDATORY:
1873
+
1874
+ [1] BUILD only what the story needs
1875
+ extra worldbuilding is wasted effort
1876
+ if it doesn't serve plot/character/theme, cut it
1877
+
1878
+ [2] ESTABLISH rules and FOLLOW them
1879
+ readers learn your world's logic
1880
+ breaking logic breaks trust
1881
+ if you must break a rule, show the breaking
1882
+
1883
+ [3] REVEAL world through ACTION, not exposition
1884
+ show cultures behaving, not descriptions of behavior
1885
+ show rules in use, not explanations of rules
1886
+ show history's effects, not summaries of events
1887
+
1888
+ [4] CREATE cultures with INTERNAL VARIATION
1889
+ no culture is uniform
1890
+ show subcultures, counter-cultures, individual variation
1891
+ cultures should argue with themselves
1892
+
1893
+ [5] MAKE geography SHAPE culture
1894
+ environment affects resources, economy, values
1895
+ cultures don't exist in vacuum
1896
+ show the connection between place and people
1897
+
1898
+ [6] GIVE every cultural element a REASON
1899
+ why do they believe this?
1900
+ why do they do this?
1901
+ why is this taboo?
1902
+ if you can't explain why, revise
1903
+
1904
+ [7] MAINTAIN CONSISTENCY once established
1905
+ document rules as you create them
1906
+ check before changing anything
1907
+ contradictions must be explained
1908
+
1909
+ [8] TREAT all cultures with RESPECT
1910
+ no "good" or "bad" cultures
1911
+ everyone thinks they're right
1912
+ show the reasons behind differences
1913
+
1914
+ [9] REMEMBER that WORLD serves STORY
1915
+ the world is the stage, not the play
1916
+ readers connect to characters, not maps
1917
+ don't let worldbuilding overwhelm narrative
1918
+
1919
+ [10] SHOW 10%, KNOW 90%
1920
+ reveal gradually through story
1921
+ trust readers to infer
1922
+ maintain depth without overwhelming
1923
+
1924
+
1925
+ PHASE 17: WORLDBUILDING SESSION CHECKLIST
1926
+
1927
+
1928
+ before starting a story:
1929
+
1930
+ [ ] world scope defined
1931
+ [ ] world bible created
1932
+ [ ] geography mapped (at minimum)
1933
+ [ ] timeline established
1934
+ [ ] primary culture(s) developed
1935
+ [ ] political system defined
1936
+ [ ] economic system outlined
1937
+ [ ] magic/tech rules established (if applicable)
1938
+ [ ] naming conventions created
1939
+ [ ] consistency log ready
1940
+
1941
+
1942
+ for each location created:
1943
+
1944
+ [ ] position on map established
1945
+ [ ] climate defined
1946
+ [ ] resources identified
1947
+ [ ] culture adapted to environment
1948
+ [ ] connections to other locations mapped
1949
+ [ ] travel times calculated
1950
+
1951
+
1952
+ for each culture created:
1953
+
1954
+ [ ] values identified
1955
+ [ ] norms established
1956
+ [ ] taboos defined
1957
+ [ ] institutions described
1958
+ [ ] history connected to present
1959
+ [ ] language/naming patterns created
1960
+ [ ] variation within culture noted
1961
+
1962
+
1963
+ for each rule established:
1964
+
1965
+ [ ] documented in world bible
1966
+ [ ] consequences defined
1967
+ [ ] limits identified
1968
+ [ ] logged for consistency
1969
+ [ ] integrated with story
1970
+
1971
+
1972
+ after completing a draft:
1973
+
1974
+ [ ] do a world consistency pass
1975
+ [ ] verify all rules are followed
1976
+ [ ] check for contradictions
1977
+ [ ] reduce info-dumping
1978
+ [ ] ensure world serves story
1979
+ [ ] document any new rules established
1980
+
1981
+
1982
+ FINAL REMINDERS
1983
+
1984
+
1985
+ worldbuilding is stage design
1986
+
1987
+ your world is where the story happens.
1988
+ it's not the story itself.
1989
+
1990
+ readers don't fall in love with worlds.
1991
+ readers fall in love with characters.
1992
+ the world gives those characters somewhere to stand.
1993
+
1994
+
1995
+ specificity creates authenticity
1996
+
1997
+ the more specific your world, the more real it feels.
1998
+
1999
+ not "they had a feudal government"
2000
+ but "the high king sat on the throne of spears,
2001
+ each spear taken from a defeated enemy,
2002
+ the oldest black with age, the newest still
2003
+ stained with the blood of its owner."
2004
+
2005
+ specific details. universal emotions.
2006
+
2007
+
2008
+ consistency is magic
2009
+
2010
+ readers will believe impossible things.
2011
+ they won't believe inconsistent things.
2012
+
2013
+ once you establish a rule, follow it.
2014
+ once you create a culture, keep it consistent.
2015
+ once you define a place, don't move it.
2016
+
2017
+ consistency creates the illusion of reality.
2018
+
2019
+
2020
+ less is more
2021
+
2022
+ you can create a world that feels vast
2023
+ while showing very little.
2024
+
2025
+ a few carefully chosen details
2026
+ imply a world beyond the page.
2027
+
2028
+ trust readers to imagine.
2029
+ their imagination is more powerful
2030
+ than any description you could write.
2031
+
2032
+
2033
+ when in doubt
2034
+
2035
+ go deeper, not wider.
2036
+
2037
+ better to know one culture deeply
2038
+ than ten superficially.
2039
+
2040
+ better to understand one location completely
2041
+ than to sketch a hundred.
2042
+
2043
+ depth creates believability.
2044
+ breadth creates tourism.
2045
+
2046
+ focus on what matters to the story.
2047
+ let the rest remain shadow.
2048
+
2049
+ now go build a world worth visiting.