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,1484 @@
1
+ <!-- Revision and Editing skill - self-editing techniques for fiction prose -->
2
+
3
+ revision-editing mode: DRAFT COMPLETE, NOW THE REAL WORK BEGINS
4
+
5
+ when this skill is active, you follow systematic revision discipline.
6
+ this is a comprehensive guide to self-editing fiction with precision.
7
+
8
+
9
+ PHASE 0: PREREQUISITES VERIFICATION
10
+
11
+ before beginning ANY revision, verify the draft is truly complete.
12
+
13
+
14
+ check: draft status
15
+
16
+ is your first draft FINISHED?
17
+
18
+ definition of finished draft:
19
+ [ ] beginning, middle, and end exist
20
+ [ ] main character arc is complete
21
+ [ ] central conflict is resolved
22
+ [ ] all scenes are written (even placeholders like "scene goes here")
23
+ [ ] word count meets minimum target (if you have one)
24
+
25
+ if not finished:
26
+ DO NOT EDIT YET
27
+ finish the draft first
28
+ editing while drafting kills momentum
29
+ return when draft is complete
30
+
31
+ the golden rule: draft and edit are separate modes
32
+ drafting = creative, expansive, messy
33
+ editing = analytical, critical, precise
34
+ never do both at once
35
+
36
+
37
+ check: emotional distance
38
+
39
+ have you stepped away from the draft?
40
+
41
+ recommended cooling period:
42
+ short story (1k-5k words): 1-3 days
43
+ novella (5k-40k words): 1-2 weeks
44
+ novel (40k+ words): 2-4 weeks
45
+
46
+ why distance matters:
47
+ fresh eyes see problems
48
+ you forget what you "meant" to write
49
+ you see what you actually wrote
50
+ emotional attachment weakens
51
+
52
+ if you just typed "the end":
53
+ put the draft away
54
+ do not open it
55
+ wait the recommended period
56
+ start something new
57
+ return when you can surprise yourself
58
+
59
+ verification test:
60
+ open to a random page
61
+ read without cringing
62
+ if you see only genius: too soon, wait more
63
+ if you see only garbage: too raw, wait more
64
+ if you see both: ready to edit
65
+
66
+
67
+ check: tools ready
68
+
69
+ do you have your editing tools prepared?
70
+
71
+ physical environment:
72
+ [ ] quiet space for focused work
73
+ [ ] comfortable seating for long sessions
74
+ [ ] printed copy (recommended for first pass)
75
+ [ ] red pen or highlighter
76
+ [ ] notebook for revision notes
77
+
78
+ digital environment:
79
+ [ ] backup of original draft (never edit without backup)
80
+ [ ] version control or dated copies
81
+ [ ] distraction-free writing mode
82
+ [ ] spell check temporarily disabled
83
+ [ ] grammar check temporarily disabled
84
+
85
+ why disable automated checks:
86
+ spell check misses contextual errors
87
+ grammar check misses style choices
88
+ you need to see patterns yourself
89
+ learn from your own mistakes
90
+ automated checks come LAST
91
+
92
+ backup command:
93
+ <copy>
94
+ file: draft-final-v1.docx
95
+ to: draft-final-v1-backup-YYYY-MM-DD.docx
96
+ </copy>
97
+
98
+ work on copies, never originals
99
+
100
+
101
+ PHASE 1: THE READ-THROUGH
102
+
103
+
104
+ first read: the story vacation
105
+
106
+ purpose: experience the story as a reader
107
+
108
+ rules for first read:
109
+ [ ] do not fix anything
110
+ [ ] do not take notes
111
+ [ ] do not judge yourself
112
+ [ ] read at normal pace
113
+ [ ] finish the whole thing
114
+
115
+ this is NOT an editing pass
116
+ this IS a reader experience
117
+
118
+ what to notice (mental notes only):
119
+ where did you get bored?
120
+ where did you get confused?
121
+ where did you stop believing?
122
+ where did you want to quit?
123
+ where were you delighted?
124
+ where did you cry?
125
+ where did you laugh?
126
+
127
+ emotional map (mental only):
128
+ high engagement zones: note them
129
+ low engagement zones: note them
130
+ confusion zones: note them
131
+ belief-breaking moments: note them
132
+
133
+ finish before making any changes.
134
+ the forest before the trees.
135
+
136
+
137
+ second read: the big picture log
138
+
139
+ purpose: identify structural issues
140
+
141
+ create a scene list:
142
+ <read>
143
+ for each scene:
144
+ - scene number
145
+ - POV character
146
+ - location
147
+ - what happens
148
+ - what changes
149
+ - word count
150
+ </read>
151
+
152
+ scene list example:
153
+ scene 1: maya arrives at airport, POV maya, discovers luggage lost, 1200 words
154
+ scene 2: maya at customer service, POV maya, meets love interest, 2500 words
155
+ scene 3: love perspective of same interaction, POV james, 1800 words
156
+ ...
157
+
158
+ analyze the scene list:
159
+ [ ] does every scene earn its place?
160
+ [ ] are scenes in the right order?
161
+ [ ] are there missing scenes?
162
+ [ ] are there duplicate scenes?
163
+ [ ] does tension increase?
164
+ [ ] does each scene change something?
165
+
166
+ if scene cannot answer "what changes":
167
+ cut it or merge it
168
+ or identify what it should change
169
+
170
+
171
+ PHASE 2: DEVELOPMENTAL EDITING
172
+
173
+
174
+ what is developmental editing?
175
+
176
+ big picture revision.
177
+ story structure.
178
+ character arcs.
179
+ theme integration.
180
+ pacing and flow.
181
+ NOT spelling, grammar, or word choice yet.
182
+
183
+ developmental editing questions:
184
+
185
+ the story promise:
186
+ [ ] what genre is this?
187
+ [ ] what promises does the opening make?
188
+ [ ] does the ending deliver those promises?
189
+ [ ] if promises change, is the new promise set up?
190
+
191
+ example broken promise:
192
+ thriller opening promises suspense
193
+ middle becomes romance
194
+ ending is family drama
195
+ reader feels betrayed
196
+
197
+ example kept promise:
198
+ thriller opening promises murder mystery
199
+ middle builds suspense and clues
200
+ ending reveals killer in action sequence
201
+ reader satisfied
202
+
203
+
204
+ the character questions:
205
+
206
+ protagonist:
207
+ [ ] what does the protagonist want?
208
+ [ ] why do they want it?
209
+ [ ] what stops them from getting it?
210
+ [ ] what do they learn by the end?
211
+ [ ] are they different at the end?
212
+
213
+ character arc test:
214
+ beginning state: identify in 3 words
215
+ inciting incident: how does it disrupt their world?
216
+ midpoint: what do they believe now?
217
+ low point: what have they lost?
218
+ climax: what must they sacrifice?
219
+ ending state: identify in 3 words
220
+
221
+ if beginning state = ending state:
222
+ no arc exists
223
+ character stayed static
224
+ reader may feel unfulfilled
225
+
226
+ exception: static characters can work if:
227
+ the world changes around them
228
+ they reveal hidden depths
229
+ their stasis is the point
230
+ this is intentional, not accidental
231
+
232
+
233
+ antagonist:
234
+ [ ] what does the antagonist want?
235
+ [ ] why do they want it?
236
+ [ ] why is their goal incompatible with protagonist's?
237
+ [ ] are they more than just "evil"?
238
+
239
+ antagonist strength test:
240
+ if antagonist tried harder, would they win?
241
+ if yes, they're too weak
242
+ antagonist should be formidable
243
+ protagonist should earn victory
244
+
245
+ antagonist motivation test:
246
+ can you explain why they're right (from their view)?
247
+ if no, they're not developed enough
248
+ villains are heroes of their own stories
249
+
250
+
251
+ supporting characters:
252
+ [ ] what purpose does each serve?
253
+ [ ] are any characters redundant?
254
+ [ ] do any have the same voice?
255
+ [ ] could any be combined?
256
+
257
+ character combination example:
258
+ character A: best friend who gives advice
259
+ character B: mentor who gives advice
260
+ combination: best friend is also former mentor
261
+ deeper relationship, fewer characters
262
+
263
+
264
+ the structure questions:
265
+
266
+ checkpoints:
267
+ [ ] inciting incident: does it disrupt the status quo?
268
+ [ ] plot point 1: does it launch the real story?
269
+ [ ] midpoint: does it shift the context?
270
+ [ ] plot point 2: does it start the final battle?
271
+ [ ] climax: does it resolve the central conflict?
272
+ [ ] resolution: does it show the new world?
273
+
274
+ timing test:
275
+ inciting incident: typically by 10% of story
276
+ plot point 1: typically by 25% of story
277
+ midpoint: exactly 50% of story
278
+ plot point 2: typically by 75% of story
279
+ climax: typically by 90% of story
280
+
281
+ these are guidelines, not rules.
282
+ but significant deviation should be intentional.
283
+
284
+
285
+ the pacing questions:
286
+
287
+ tension tracking:
288
+ map tension level for each scene (1-10)
289
+ [ ] does tension generally increase?
290
+ [ ] are there tension valleys?
291
+ [ ] do valleys come after peaks (breathers)?
292
+ [ ] is any section flat for too long?
293
+
294
+ pacing problems:
295
+ saggy middle: scenes repeat the same conflict
296
+ rushed ending: climax doesn't earn its weight
297
+ slow start: too much backstory before story begins
298
+ uneven rhythm: no variation in scene length
299
+
300
+ pacing fixes:
301
+ saggy middle: raise stakes or cut scenes
302
+ rushed ending: add complications
303
+ slow start: start closer to action
304
+ uneven: vary scene lengths intentionally
305
+
306
+
307
+ the POV questions:
308
+
309
+ POV consistency:
310
+ [ ] is POV clear in every scene?
311
+ [ ] are there accidental head-hops?
312
+ [ ] is POV choice serving the story?
313
+
314
+ head-hopping example (bad):
315
+ "jane felt sad. john noticed her sadness and felt guilty.
316
+ mary wondered why john looked guilty. steve watched them all."
317
+
318
+ head-hopping fix:
319
+ pick one POV per scene
320
+ stay in one head
321
+ let dialogue/action show others' feelings
322
+
323
+ POV selection test:
324
+ which character has the most at stake?
325
+ which character's perception changes?
326
+ which character has the most to lose?
327
+ that character gets the POV
328
+
329
+
330
+ PHASE 3: THE CUTTING PASS
331
+
332
+
333
+ why cut?
334
+
335
+ everything should earn its place.
336
+ every word, sentence, scene, chapter.
337
+ readers have limited attention.
338
+ respect their time.
339
+
340
+ signs something should go:
341
+ [ ] you skip it when rereading
342
+ [ ] you forgot you wrote it
343
+ [ ] nothing changes during it
344
+ [ ] it explains what readers already know
345
+ [ ] you feel attached but can't explain why
346
+ [ ] it's "worldbuilding" with no story connection
347
+
348
+ cutting targets:
349
+
350
+
351
+ target 1: throat-clearing
352
+
353
+ opening throat-clearing examples:
354
+ - waking up and getting ready (unless the story happens there)
355
+ - weather descriptions (unless weather is the antagonist)
356
+ - character looking in mirror to describe themselves
357
+ - character thinking about their backstory
358
+ - "this all started when..."
359
+
360
+ opening throat-clearing fix:
361
+ start where the trouble starts
362
+ start where the change happens
363
+ start with action that matters
364
+ backstory can be revealed later
365
+
366
+
367
+ target 2: false starts
368
+
369
+ scene false starts:
370
+ - character walking/driving to location before real scene
371
+ - character greeting someone before real conversation
372
+ - character thinking about what they're about to do
373
+ - phone calls/doors/etc. before real interaction
374
+
375
+ false start fix:
376
+ start scene in the middle
377
+ "they were already fighting when i walked in"
378
+
379
+
380
+ target 3: redundancy
381
+
382
+ same information twice:
383
+ - character thinks something
384
+ - then says the same thing
385
+ - narrator explains it too
386
+
387
+ redundancy fix:
388
+ pick ONE way to convey
389
+ trust your reader
390
+ show, don't tell (then tell, then stop)
391
+
392
+
393
+ target 4: your darlings
394
+
395
+ what is a darling?
396
+ a scene you love
397
+ that doesn't serve the story
398
+ you keep finding ways to "save it"
399
+ but it doesn't fit
400
+
401
+ darling test:
402
+ would a reader miss it?
403
+ be honest.
404
+ would the story break without it?
405
+ if the answer is "no"
406
+ cut it.
407
+
408
+ darling coping strategy:
409
+ save it in a "cut scenes" file
410
+ maybe it becomes another story
411
+ maybe it was just practice
412
+ either way, it's not in THIS story
413
+
414
+
415
+ cutting exercise:
416
+
417
+ the black marker method:
418
+ 1. print your story
419
+ 2. use black marker to cross out
420
+ 3. cross out everything not essential
421
+ 4. read what remains
422
+ 5. does story still work?
423
+
424
+ if yes:
425
+ good cuts
426
+ story is stronger
427
+ prose is tighter
428
+
429
+ if no:
430
+ you cut too much
431
+ restore some essentials
432
+ error on side of cutting
433
+
434
+
435
+ PHASE 4: SCENE-LEVEL REVISION
436
+
437
+
438
+ scene anatomy:
439
+
440
+ every scene needs:
441
+ [ ] a goal (what does POV character want?)
442
+ [ ] a conflict (what stops them?)
443
+ [ ] a disaster (how do they fail?)
444
+ [ ] a change (how is the world different?)
445
+
446
+ scene test:
447
+ can you answer these questions for each scene?
448
+ if you can't
449
+ the scene needs work
450
+
451
+ scene revision checklist:
452
+
453
+ scene openings:
454
+ [ ] does it start in the moment?
455
+ [ ] is the POV clear immediately?
456
+ [ ] is the goal established early?
457
+ [ ] is the reader anchored in place/time?
458
+
459
+ weak openings:
460
+ - "it was a dark and stormy night"
461
+ - "jane was a tall woman with..."
462
+ - "little did she know that..."
463
+ - backstory summary
464
+ - nothing happening
465
+
466
+ strong openings:
467
+ - character doing something
468
+ - tension already present
469
+ - something at stake
470
+ - change occurring
471
+
472
+
473
+ scene middles:
474
+ [ ] is there active conflict?
475
+ [ ] does the character try and fail?
476
+ [ ] do tactics change?
477
+ [ ] does tension increase?
478
+
479
+ weak middles:
480
+ - characters talking about problems
481
+ - characters thinking about problems
482
+ - characters walking around
483
+ - nothing meaningful happening
484
+
485
+ strong middles:
486
+ - action with consequences
487
+ - dialogue that reveals and advances
488
+ - complications arising
489
+ - stakes increasing
490
+
491
+
492
+ scene endings:
493
+ [ ] does something change?
494
+ [ ] does character have new goal?
495
+ [ ] is there a hook to next scene?
496
+ [ ] is there emotion to carry forward?
497
+
498
+ weak endings:
499
+ - "and then they went to sleep"
500
+ - "and then they went to next place"
501
+ - scene just fading out
502
+ - no consequence
503
+
504
+ strong endings:
505
+ - disaster leaves character with no good options
506
+ - revelation changes everything
507
+ - decision that will cause trouble
508
+ - emotion that demands resolution
509
+
510
+
511
+ PHASE 5: LINE EDITING
512
+
513
+
514
+ what is line editing?
515
+
516
+ paragraph-level and sentence-level revision.
517
+ focus on clarity, flow, and impact.
518
+ not grammar yet.
519
+ word choice, sentence rhythm, paragraph variety.
520
+
521
+
522
+ line editing targets:
523
+
524
+
525
+ target 1: weak verbs
526
+
527
+ weak verb: to be (is, are, was, were, been)
528
+ weak verb: to go (go, went, gone)
529
+ weak verb: to do (do, did, done)
530
+
531
+ weak verb examples:
532
+ "she was angry." (tells)
533
+ "he went to the door." (bland)
534
+ "they did a dance." (vague)
535
+
536
+ strong verb replacements:
537
+ "she slammed her fist on the table." (shows)
538
+ "he stalked to the door." (specific)
539
+ "they waltzed across the floor." (specific)
540
+
541
+ verb strengthening exercise:
542
+ <search>
543
+ "was [adverb]"
544
+ "were [adverb]"
545
+ </search>
546
+
547
+ replace with:
548
+ specific action verb
549
+ that shows the same thing
550
+
551
+ warning:
552
+ don't eliminate "to be" completely
553
+ sometimes it's the right choice
554
+ but make it a choice, not a default
555
+
556
+
557
+ target 2: filter words
558
+
559
+ filter words: words that filter experience through description
560
+
561
+ common filter words:
562
+ saw, heard, felt, smelled, tasted
563
+ noticed, watched, observed
564
+ wondered, thought, realized
565
+ knew, believed, understood
566
+
567
+ filter word examples:
568
+ "she saw the car approaching."
569
+ "he heard the clock ticking."
570
+ "i felt a sudden pain."
571
+
572
+ remove the filter:
573
+ "the car approached."
574
+ "the clock ticked."
575
+ "pain shot through my arm."
576
+
577
+ why this matters:
578
+ puts reader directly in experience
579
+ removes distance between reader and story
580
+ creates stronger immersion
581
+
582
+ exception:
583
+ use filter words when:
584
+ - the act of perception is the point
585
+ - character is doubting their senses
586
+ - you want to create distance
587
+
588
+
589
+ target 3: adverbs and adjectives
590
+
591
+ not all adverbs are evil.
592
+ not all adjectives are unnecessary.
593
+ but most can be cut.
594
+
595
+ adverb test:
596
+ "she walked quickly."
597
+ why quickly?
598
+ is she running? then say "she ran."
599
+ is she hurrying? then say "she hurried."
600
+ is there a better verb?
601
+
602
+ adjective test:
603
+ "the dark, scary night."
604
+ what does "scary" night look like?
605
+ show us scary, don't tell us.
606
+
607
+ specific is better than modified:
608
+ instead of: "very large"
609
+ use: "enormous" or "gigantic" or better, the actual size
610
+
611
+ instead of: "very angry"
612
+ use: "furious" or show what they do
613
+
614
+ adjective/adverb pileup:
615
+ "the incredibly loud, extremely bright,
616
+ very sudden, truly shocking explosion"
617
+
618
+ revision:
619
+ "the explosion shattered every window
620
+ for three blocks"
621
+
622
+
623
+ target 4: sentence variety
624
+
625
+ sentence length variation:
626
+ [ ] are there multiple short sentences in a row?
627
+ [ ] are there multiple long sentences in a row?
628
+ [ ] is there rhythm and flow?
629
+
630
+ variety creates music:
631
+ short-short-short-long
632
+ creates emphasis
633
+ builds momentum
634
+
635
+ long-long-long-short
636
+ creates contrast
637
+ delivers punch
638
+
639
+ read aloud.
640
+ your ear will hear the problems.
641
+ your eyes will miss them.
642
+
643
+
644
+ target 5: paragraph breaks
645
+
646
+ paragraph purpose:
647
+ organize information
648
+ create visual rhythm
649
+ control reading pace
650
+
651
+ paragraph rules:
652
+ [ ] one topic per paragraph
653
+ [ ] new speaker = new paragraph
654
+ [ ] shift in time/place = new paragraph
655
+ [ ] shift in focus = new paragraph
656
+
657
+ paragraph variety:
658
+ vary paragraph length
659
+ short paragraphs speed pace
660
+ long paragraphs slow pace
661
+ use intentionally
662
+
663
+
664
+ PHASE 6: DIALOGUE POLISH
665
+
666
+
667
+ dialogue revision questions:
668
+
669
+ purpose:
670
+ [ ] does each line have a purpose?
671
+ [ ] does it reveal character?
672
+ [ ] does it advance plot?
673
+ [ ] does it increase tension?
674
+
675
+ if a line does none of these:
676
+ cut it
677
+
678
+ character voice:
679
+ [ ] could you tell who speaks without tags?
680
+ [ ] does each character sound distinct?
681
+ [ ] do they use different vocabulary?
682
+ [ ] do they use different sentence structures?
683
+
684
+ voice differentiation example:
685
+ professor: precise words, complex sentences, references
686
+ teenager: slang, fragments, contractions
687
+ non-native speaker: formal, careful, occasional errors
688
+ child: simple words, literal thinking
689
+
690
+ subtext:
691
+ [ ] do characters say what they mean?
692
+ [ ] or do they talk around the truth?
693
+ [ ] what is NOT being said?
694
+
695
+ subtext example (no subtext):
696
+ "i am angry at you."
697
+ "i am sorry i made you mad."
698
+
699
+ subtext example (with subtext):
700
+ "you're home early."
701
+ "meeting ended early."
702
+ "that's convenient."
703
+ "what's that supposed to mean?"
704
+ "nothing."
705
+
706
+ readers enjoy figuring it out.
707
+ don't spell out everything.
708
+
709
+
710
+ dialogue tag cleanup:
711
+
712
+ tag problems:
713
+ [ ] tags other than "said" or "asked"
714
+ [ ] adverbs in tags
715
+ [ ] tags that tell what's obvious
716
+ [ ] unnecessary tags
717
+
718
+ weak tags:
719
+ "i hate you," he said angrily.
720
+ "that's great," she exclaimed happily.
721
+ "watch out," he warned urgently.
722
+ "really?" she questioned curiously.
723
+
724
+ the principle:
725
+ the dialogue should carry the emotion.
726
+ if you need the tag, rewrite the dialogue.
727
+
728
+ revision:
729
+ "i hate you." he threw the glass against the wall.
730
+ "that's great." her voice was flat.
731
+ "look out!" he grabbed her arm.
732
+ "really?" she leaned forward.
733
+
734
+ when to use tags:
735
+ use "said" when necessary for clarity
736
+ use "asked" for questions when needed
737
+ otherwise use action beats
738
+
739
+ action beats:
740
+ "i can't do this." she backed away.
741
+ "yes you can." he stepped closer.
742
+ "you don't understand."
743
+ "then explain it."
744
+
745
+ no tags needed.
746
+ speakers are clear.
747
+ action is also doing work.
748
+
749
+
750
+ PHASE 7: COPY EDITING
751
+
752
+
753
+ what is copy editing?
754
+
755
+ sentence-level technical revision.
756
+ grammar, punctuation, consistency.
757
+ clarity and correctness.
758
+ this is where the rules matter.
759
+
760
+
761
+ copy editing targets:
762
+
763
+
764
+ target 1: comma usage
765
+
766
+ common comma errors:
767
+ [ ] comma splices (joining two sentences)
768
+ [ ] missing commas before quotes
769
+ [ ] missing commas in compound sentences
770
+ [ ] unnecessary commas
771
+
772
+ comma splice:
773
+ wrong: "she left, he stayed."
774
+ right: "she left. he stayed."
775
+ right: "she left, and he stayed."
776
+
777
+ dialogue commas:
778
+ wrong: "hello" she said.
779
+ right: "hello," she said.
780
+
781
+ compound sentence:
782
+ wrong: "she ran and he walked."
783
+ right: "she ran, and he walked."
784
+ (if both are independent clauses)
785
+
786
+
787
+ target 2: pronoun reference
788
+
789
+ pronoun problems:
790
+ [ ] unclear antecedents
791
+ [ ] shifting pronouns within sentences
792
+ [ ] pronoun pileups
793
+
794
+ unclear pronoun:
795
+ "jane told mary she was wrong."
796
+
797
+ who was wrong? jane or mary?
798
+
799
+ revision:
800
+ "jane told mary that mary was wrong."
801
+ "you're wrong," jane told mary.
802
+
803
+
804
+ target 3: subject-verb agreement
805
+
806
+ common errors:
807
+ [ ] collective nouns (band, team, family)
808
+ [ ] phrases between subject and verb
809
+ [ ] neither/nor constructions
810
+
811
+ collective noun:
812
+ "the band is playing" (singular unit)
813
+ "the band are fighting" (members doing something separately)
814
+
815
+ separation:
816
+ "the box of chocolates is empty"
817
+ not "are empty"
818
+ (chocolates doesn't determine verb)
819
+
820
+
821
+ target 4: consistency checks
822
+
823
+ time consistency:
824
+ [ ] does time flow logically?
825
+ [ ] are days of week consistent?
826
+ [ ] do distances match travel times?
827
+
828
+ character consistency:
829
+ [ ] do eyes stay same color?
830
+ [ ] do names stay spelled the same?
831
+ [ ] do ages match timeline?
832
+ [ ] do skills/abilities match backstory?
833
+
834
+ location consistency:
835
+ [ ] do rooms stay arranged the same?
836
+ [ ] do distances make sense?
837
+ [ ] does geography work?
838
+
839
+ world consistency:
840
+ [ ] do rules stay the same?
841
+ [ ] do names match across mentions?
842
+ [ ] do tech levels match era?
843
+
844
+ create a style sheet:
845
+ character names with spellings
846
+ place names with spellings
847
+ significant details (eye color, etc.)
848
+ world rules
849
+ reference during revision
850
+
851
+
852
+ target 5: show don't tell (final pass)
853
+
854
+ telling examples:
855
+ "she was beautiful."
856
+ "he was angry."
857
+ "it was scary."
858
+ "they were in love."
859
+
860
+ showing revision:
861
+ "she entered the room and conversation stopped."
862
+ "his face flushed, fists clenched at his sides."
863
+ "my hands shook as i reached for the doorknob."
864
+ "he'd sell his car before he'd miss her birthday."
865
+
866
+ the tell then show technique:
867
+ sometimes tell for clarity
868
+ then show for impact
869
+ then trust the reader
870
+
871
+ example:
872
+ "she was terrified. her breath came in shallow
873
+ gasps, and she couldn't stop shaking."
874
+
875
+ the tell ("she was terrified") creates clarity.
876
+ the show provides the experience.
877
+
878
+
879
+ PHASE 8: PROOFREADING
880
+
881
+
882
+ what is proofreading?
883
+
884
+ final polish.
885
+ catching errors.
886
+ technical correctness.
887
+ spelling, punctuation, formatting.
888
+
889
+ this is the LAST pass.
890
+ do nothing else during proofreading.
891
+ do not revise content.
892
+ only fix errors.
893
+
894
+
895
+ proofreading technique:
896
+
897
+ change the format:
898
+ print in different font
899
+ change font size
900
+ read on different device
901
+ change margins
902
+
903
+ why this works:
904
+ your brain memorized the layout
905
+ format changes break the pattern
906
+ you see what's actually there
907
+
908
+
909
+ read backward:
910
+
911
+ sentence by sentence:
912
+ read last sentence first
913
+ then second-to-last
914
+ work backward to beginning
915
+
916
+ why this works:
917
+ you see each sentence in isolation
918
+ you can't skim for story
919
+ you focus on the words
920
+
921
+
922
+ read aloud:
923
+
924
+ slow reading:
925
+ read every word
926
+ enunciate clearly
927
+ don't rush
928
+
929
+ what you'll catch:
930
+ missing words
931
+ repeated words
932
+ awkward phrasing
933
+ punctuation that doesn't match breath
934
+
935
+
936
+ proofreading checklist:
937
+
938
+ spelling:
939
+ [ ] spell check run
940
+ [ ] proper nouns checked
941
+ [ ] homophones verified (their/there/they're)
942
+ [ ] commonly confused words checked
943
+
944
+ commonly confused:
945
+ its/it's
946
+ your/you're
947
+ whose/who's
948
+ affect/effect
949
+ lay/lie
950
+ farther/further
951
+ compliment/complement
952
+ stationary/stationery
953
+ principal/principle
954
+
955
+ punctuation:
956
+ [ ] periods at sentence ends
957
+ [ ] question marks on questions
958
+ [ ] quotation marks closed
959
+ [ ] em dashes correct (or consistent)
960
+ [ ] apostrophes on possessives
961
+
962
+ formatting:
963
+ [ ] paragraph breaks consistent
964
+ [ ] dialogue formatting correct
965
+ [ ] section breaks marked
966
+ [ ] chapter headers consistent
967
+
968
+
969
+ PHASE 9: THE KILL YOUR DARLINGS PASS
970
+
971
+
972
+ the hardest revision.
973
+
974
+ what is a darling?
975
+
976
+ something you love
977
+ that doesn't serve the story
978
+ that you keep defending
979
+ that you're scared to cut
980
+
981
+ darling examples:
982
+ a beautiful description
983
+ a clever line of dialogue
984
+ a whole character you love
985
+ a subplot you enjoyed writing
986
+ a scene that was fun to write
987
+ a voice you enjoyed using
988
+
989
+ how to identify darlings:
990
+
991
+ your defense radar:
992
+ when someone critiques a part
993
+ and you immediately defend it
994
+ it's probably a darling
995
+
996
+ when critique comes:
997
+ "this scene doesn't seem to fit"
998
+ your reaction: "but it establishes character!"
999
+
1000
+ you're defending a darling.
1001
+ the story might be better without it.
1002
+
1003
+
1004
+ the darling test:
1005
+
1006
+ question 1:
1007
+ if i cut this, does the story break?
1008
+
1009
+ if yes: not a darling (it's earning its place)
1010
+ if no: proceed to question 2
1011
+
1012
+ question 2:
1013
+ if i cut this, is the story actually better?
1014
+
1015
+ be honest.
1016
+ does the story move faster?
1017
+ is the focus clearer?
1018
+ is the theme stronger?
1019
+
1020
+ question 3:
1021
+ why do i want to keep this?
1022
+
1023
+ "because i like it" = darling, consider cutting
1024
+ "because it's needed" = not a darling, keep it
1025
+
1026
+
1027
+ the darling funeral:
1028
+
1029
+ how to let go:
1030
+
1031
+ step 1: acknowledge
1032
+ "this is my darling."
1033
+ "i love it but it doesn't serve the story."
1034
+
1035
+ step 2: save
1036
+ copy to "cut scenes" file
1037
+ you never know when it might fit
1038
+ somewhere else
1039
+
1040
+ step 3: cut
1041
+ remove it from the manuscript
1042
+ don't look back
1043
+
1044
+ step 4: read
1045
+ read the scene around the cut
1046
+ does the story flow better?
1047
+ most times, yes
1048
+
1049
+ step 5: grieve
1050
+ it's okay to be sad about good writing
1051
+ that doesn't mean it belonged in THIS story
1052
+ maybe it's its own story
1053
+ maybe it was just practice
1054
+
1055
+
1056
+ darling types and solutions:
1057
+
1058
+ darling character:
1059
+ character you love who doesn't drive plot
1060
+
1061
+ solutions:
1062
+ - give them a real role in story
1063
+ - merge them with a character who has a role
1064
+ - cut them entirely
1065
+ - make them protagonist of their own story
1066
+
1067
+ darling subplot:
1068
+ story thread you enjoyed that goes nowhere
1069
+
1070
+ solutions:
1071
+ - tie it to main plot
1072
+ - cut it
1073
+ - save it for sequel
1074
+
1075
+ darling scene:
1076
+ scene you wrote beautifully that serves no purpose
1077
+
1078
+ solutions:
1079
+ - identify what purpose it COULD serve
1080
+ - rewrite to serve that purpose
1081
+ - cut it
1082
+
1083
+ darling voice:
1084
+ style or voice that doesn't fit rest of story
1085
+
1086
+ solutions:
1087
+ - commit to that voice throughout
1088
+ - rewrite to match rest of story
1089
+ - cut the section
1090
+
1091
+
1092
+ PHASE 10: PACING FIXES
1093
+
1094
+
1095
+ pacing problems and solutions:
1096
+
1097
+
1098
+ problem: slow opening
1099
+
1100
+ symptoms:
1101
+ readers say "it gets good after chapter 3"
1102
+ critique: "took too long to get into"
1103
+
1104
+ causes:
1105
+ - starting before the story starts
1106
+ - too much backstory
1107
+ - introducing too many characters
1108
+ - worldbuilding before plot
1109
+
1110
+ solutions:
1111
+ start closer to inciting incident
1112
+ cut first three chapters (try it)
1113
+ weave backstory in later
1114
+ reduce number of characters introduced
1115
+ trust reader to follow
1116
+
1117
+
1118
+ problem: saggy middle
1119
+
1120
+ symptoms:
1121
+ - middle scenes feel repetitive
1122
+ - tension stays same
1123
+ - scenes could be reordered without impact
1124
+ - reader gets bored around 50%
1125
+
1126
+ causes:
1127
+ - protagonist not active enough
1128
+ - stakes not raising
1129
+ - scenes revisit same conflict
1130
+ - lack of complications
1131
+
1132
+ solutions:
1133
+ raise stakes: what's the worst that could happen?
1134
+ add complication: make situation worse
1135
+ cut repetitive scenes
1136
+ add midpoint twist that changes context
1137
+ give character new goal at midpoint
1138
+
1139
+
1140
+ problem: rushed ending
1141
+
1142
+ symptoms:
1143
+ - climax feels unearned
1144
+ - resolution too quick
1145
+ - loose ends barely addressed
1146
+ - reader feels cheated
1147
+
1148
+ causes:
1149
+ - spent too much time on beginning
1150
+ - didn't plan enough space for ending
1151
+ - tired of writing by the end
1152
+ - too many threads to resolve
1153
+
1154
+ solutions:
1155
+ expand climax scenes
1156
+ add complications to final battle
1157
+ give more space to resolution
1158
+ cut earlier material to make room
1159
+ address each subplot properly
1160
+
1161
+
1162
+ problem: uneven rhythm
1163
+
1164
+ symptoms:
1165
+ - fast-fast-fast-slow-fast
1166
+ - tension spikes randomly
1167
+ - reader exhausted then bored
1168
+
1169
+ solutions:
1170
+ map tension levels scene by scene
1171
+ ensure gradual increase overall
1172
+ place breathers after peaks
1173
+ don't let multiple climaxes blur together
1174
+ build to final climax, not multiple equal ones
1175
+
1176
+
1177
+ PHASE 11: CONSISTENCY PASS
1178
+
1179
+
1180
+ the continuity check.
1181
+
1182
+ timeline:
1183
+ [ ] does time flow logically?
1184
+ [ ] do days of week match?
1185
+ [ ] do seasons match events?
1186
+ [ ] do ages match story timeframe?
1187
+
1188
+ create timeline:
1189
+ day 1: events
1190
+ day 2: events
1191
+ day 3: events
1192
+ ...
1193
+
1194
+ verify distances:
1195
+ if characters travel from a to b
1196
+ how long does it take?
1197
+ does your timeline match reality?
1198
+
1199
+ character continuity:
1200
+ [ ] names spelled consistently?
1201
+ [ ] descriptions consistent?
1202
+ [ ] abilities consistent?
1203
+ [ ] knowledge consistent?
1204
+
1205
+ knowledge tracking:
1206
+ what does each character know, when?
1207
+ if character learns something in chapter 5
1208
+ they can't know it in chapter 3
1209
+
1210
+ world continuity:
1211
+ [ ] rules of magic/tech consistent?
1212
+ [ ] political situation consistent?
1213
+ [ ] geography consistent?
1214
+ [ ] history consistent?
1215
+
1216
+ create world bible:
1217
+ rules
1218
+ locations
1219
+ characters
1220
+ history
1221
+ check this during revision
1222
+
1223
+
1224
+ PHASE 12: FINAL POLISH CHECKLIST
1225
+
1226
+
1227
+ the final questions:
1228
+
1229
+ story level:
1230
+ [ ] does story fulfill its promises?
1231
+ [ ] does protagonist change?
1232
+ [ ] is ending earned?
1233
+ [ ] is theme clear without being preached?
1234
+ [ ] would reader want to read this again?
1235
+
1236
+ character level:
1237
+ [ ] are characters distinct?
1238
+ [ ] are motivations clear?
1239
+ [ ] is dialogue unique to each?
1240
+ [ ] do characters make decisions (not just react)?
1241
+ [ ] do readers care what happens?
1242
+
1243
+ scene level:
1244
+ [ ] does every scene earn its place?
1245
+ [ ] does every scene have conflict?
1246
+ [ ] does every scene change something?
1247
+ [ ] do scenes flow logically?
1248
+ [ ] is scene variety sufficient?
1249
+
1250
+ sentence level:
1251
+ [ ] is word choice precise?
1252
+ [ ] is sentence structure varied?
1253
+ [ ] is paragraphing purposeful?
1254
+ [ ] are filters removed?
1255
+ [ ] are weak verbs strengthened?
1256
+
1257
+ mechanics level:
1258
+ [ ] is spelling correct?
1259
+ [ ] is punctuation correct?
1260
+ [ ] is grammar correct?
1261
+ [ ] is formatting consistent?
1262
+ [ ] are proper nouns consistent?
1263
+
1264
+
1265
+ the read-aloud test:
1266
+
1267
+ read your entire manuscript aloud.
1268
+
1269
+ this is the best test.
1270
+ your ear catches what your eye misses.
1271
+
1272
+ what you'll hear:
1273
+ awkward phrasing
1274
+ repetitive words
1275
+ missing words
1276
+ wrong words
1277
+ rhythm problems
1278
+ dialogue that doesn't sound real
1279
+
1280
+ read slowly.
1281
+ read every word.
1282
+ mark problems.
1283
+ fix them all.
1284
+
1285
+
1286
+ PHASE 13: BETA READ PREPARATION
1287
+
1288
+
1289
+ your work is done.
1290
+ now you need fresh eyes.
1291
+
1292
+ before sending to readers:
1293
+
1294
+ [ ] complete all revision passes
1295
+ [ ] run spell check (final)
1296
+ [ ] proofread thoroughly
1297
+ [ ] save final version
1298
+ [ ] create backup
1299
+
1300
+ what to ask beta readers:
1301
+
1302
+ specific questions:
1303
+ - where did you get bored?
1304
+ - where did you get confused?
1305
+ - where did you stop believing?
1306
+ - what did you want more of?
1307
+ - what did you want less of?
1308
+ - who was your favorite character?
1309
+ - who did you not like?
1310
+ - did the ending satisfy?
1311
+
1312
+ NOT questions:
1313
+ - "did you like it?"
1314
+ (not useful)
1315
+ - "is it good?"
1316
+ (too vague)
1317
+
1318
+ you want specific feedback.
1319
+ you want to know where to focus next revision.
1320
+
1321
+
1322
+ receive feedback gracefully:
1323
+
1324
+ rule:
1325
+ listen to everything.
1326
+ take notes.
1327
+ don't defend.
1328
+ don't explain.
1329
+
1330
+ when feedback stings:
1331
+ remember: they're trying to help
1332
+ remember: you don't have to use everything
1333
+ remember: if one person says it, it's their opinion
1334
+ remember: if three people say it, it's a problem
1335
+
1336
+ after feedback:
1337
+ organize by type
1338
+ organize by frequency
1339
+ make revision plan
1340
+ repeat revision process
1341
+
1342
+
1343
+ PHASE 14: WHEN ARE YOU DONE?
1344
+
1345
+ the revision trap:
1346
+
1347
+ can you revise forever?
1348
+ yes.
1349
+ should you?
1350
+ no.
1351
+
1352
+ signs you might be done:
1353
+
1354
+ [ ] beta feedback is minor
1355
+ [ ] you're making changes that undo previous changes
1356
+ [ ] you're revisiting solved problems
1357
+ [ ] you're changing things back and forth
1358
+ [ ] you're bored with your own story
1359
+
1360
+ the perfect is the enemy of the good:
1361
+
1362
+ at some point:
1363
+ declare victory
1364
+ submit/publish
1365
+ move to next project
1366
+
1367
+ you'll be a better writer
1368
+ by the time you finish next project
1369
+ you can't fix everything in one story.
1370
+
1371
+ every story is a stepping stone.
1372
+ learn from it.
1373
+ move forward.
1374
+
1375
+
1376
+ PHASE 15: REVISION RULES (STRICT MODE)
1377
+
1378
+
1379
+ while this skill is active, these rules are MANDATORY:
1380
+
1381
+ [1] NEVER edit while drafting
1382
+ drafting is creative
1383
+ editing is analytical
1384
+ they don't mix
1385
+ finish draft first
1386
+
1387
+ [2] WAIT before editing
1388
+ let draft rest
1389
+ minimum 1 week for short work
1390
+ minimum 2 weeks for novel
1391
+ fresh eyes see more
1392
+
1393
+ [3] BIG picture first
1394
+ fix structure before sentences
1395
+ fix character arc before dialogue
1396
+ fix pacing before word choice
1397
+ wrong structure + perfect sentences = still broken
1398
+
1399
+ [4] BACKUP before changing
1400
+ save original
1401
+ work on copies
1402
+ never lose your starting point
1403
+
1404
+ [5] CUT without mercy
1405
+ if it doesn't serve the story
1406
+ cut it
1407
+ save to separate file if needed
1408
+ but remove it from the story
1409
+
1410
+ [6] READ aloud
1411
+ at least once
1412
+ more is better
1413
+ your ear catches what eyes miss
1414
+
1415
+ [7] TRUST beta readers
1416
+ if multiple people say the same thing
1417
+ they're right
1418
+ don't defend
1419
+ fix it
1420
+
1421
+ [8] KNOW when to stop
1422
+ revision can continue forever
1423
+ at some point: declare done
1424
+ ship the work
1425
+ start the next one
1426
+
1427
+
1428
+ FINAL REMINDERS
1429
+
1430
+
1431
+ revision is where stories become good.
1432
+
1433
+ first drafts are messy.
1434
+ that's okay.
1435
+ that's necessary.
1436
+ you can't fix a blank page.
1437
+
1438
+ revision is the real work.
1439
+ revision is where craft meets art.
1440
+ revision is the difference between
1441
+ "i wrote a novel" and
1442
+ "i wrote a GOOD novel."
1443
+
1444
+
1445
+ your darlings will die.
1446
+
1447
+ you will cut beautiful things.
1448
+ you will kill characters you love.
1449
+ you will remove scenes you labored over.
1450
+
1451
+ this is not failure.
1452
+ this is serving the story.
1453
+
1454
+ the story is more important
1455
+ than any part of it.
1456
+
1457
+
1458
+ the goal is the reader's experience.
1459
+
1460
+ every revision decision should answer:
1461
+ does this make the story better
1462
+ for the reader?
1463
+
1464
+ not: do i like this?
1465
+ but: does it serve the story?
1466
+
1467
+ your ego is not your friend here.
1468
+ the story is king.
1469
+
1470
+
1471
+ revision is discipline.
1472
+
1473
+ it is hard work.
1474
+ it is tedious work.
1475
+ it is necessary work.
1476
+
1477
+ anyone can write a first draft.
1478
+ few can revise a draft into a story.
1479
+
1480
+ be one of the few.
1481
+
1482
+
1483
+ now go finish that draft.
1484
+ then start the real work.