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.
- agents/__init__.py +2 -0
- agents/coder/__init__.py +0 -0
- agents/coder/agent.json +4 -0
- agents/coder/api-integration.md +2150 -0
- agents/coder/cli-pretty.md +765 -0
- agents/coder/code-review.md +1092 -0
- agents/coder/database-design.md +1525 -0
- agents/coder/debugging.md +1102 -0
- agents/coder/dependency-management.md +1397 -0
- agents/coder/git-workflow.md +1099 -0
- agents/coder/refactoring.md +1454 -0
- agents/coder/security-hardening.md +1732 -0
- agents/coder/system_prompt.md +1448 -0
- agents/coder/tdd.md +1367 -0
- agents/creative-writer/__init__.py +0 -0
- agents/creative-writer/agent.json +4 -0
- agents/creative-writer/character-development.md +1852 -0
- agents/creative-writer/dialogue-craft.md +1122 -0
- agents/creative-writer/plot-structure.md +1073 -0
- agents/creative-writer/revision-editing.md +1484 -0
- agents/creative-writer/system_prompt.md +690 -0
- agents/creative-writer/worldbuilding.md +2049 -0
- agents/data-analyst/__init__.py +30 -0
- agents/data-analyst/agent.json +4 -0
- agents/data-analyst/data-visualization.md +992 -0
- agents/data-analyst/exploratory-data-analysis.md +1110 -0
- agents/data-analyst/pandas-data-manipulation.md +1081 -0
- agents/data-analyst/sql-query-optimization.md +881 -0
- agents/data-analyst/statistical-analysis.md +1118 -0
- agents/data-analyst/system_prompt.md +928 -0
- agents/default/__init__.py +0 -0
- agents/default/agent.json +4 -0
- agents/default/dead-code.md +794 -0
- agents/default/explore-agent-system.md +585 -0
- agents/default/system_prompt.md +1448 -0
- agents/kollabor/__init__.py +0 -0
- agents/kollabor/analyze-plugin-lifecycle.md +175 -0
- agents/kollabor/analyze-terminal-rendering.md +388 -0
- agents/kollabor/code-review.md +1092 -0
- agents/kollabor/debug-mcp-integration.md +521 -0
- agents/kollabor/debug-plugin-hooks.md +547 -0
- agents/kollabor/debugging.md +1102 -0
- agents/kollabor/dependency-management.md +1397 -0
- agents/kollabor/git-workflow.md +1099 -0
- agents/kollabor/inspect-llm-conversation.md +148 -0
- agents/kollabor/monitor-event-bus.md +558 -0
- agents/kollabor/profile-performance.md +576 -0
- agents/kollabor/refactoring.md +1454 -0
- agents/kollabor/system_prompt copy.md +1448 -0
- agents/kollabor/system_prompt.md +757 -0
- agents/kollabor/trace-command-execution.md +178 -0
- agents/kollabor/validate-config.md +879 -0
- agents/research/__init__.py +0 -0
- agents/research/agent.json +4 -0
- agents/research/architecture-mapping.md +1099 -0
- agents/research/codebase-analysis.md +1077 -0
- agents/research/dependency-audit.md +1027 -0
- agents/research/performance-profiling.md +1047 -0
- agents/research/security-review.md +1359 -0
- agents/research/system_prompt.md +492 -0
- agents/technical-writer/__init__.py +0 -0
- agents/technical-writer/agent.json +4 -0
- agents/technical-writer/api-documentation.md +2328 -0
- agents/technical-writer/changelog-management.md +1181 -0
- agents/technical-writer/readme-writing.md +1360 -0
- agents/technical-writer/style-guide.md +1410 -0
- agents/technical-writer/system_prompt.md +653 -0
- agents/technical-writer/tutorial-creation.md +1448 -0
- core/__init__.py +0 -2
- core/application.py +343 -88
- core/cli.py +229 -10
- core/commands/menu_renderer.py +463 -59
- core/commands/registry.py +14 -9
- core/commands/system_commands.py +2461 -14
- core/config/loader.py +151 -37
- core/config/service.py +18 -6
- core/events/bus.py +29 -9
- core/events/executor.py +205 -75
- core/events/models.py +27 -8
- core/fullscreen/command_integration.py +20 -24
- core/fullscreen/components/__init__.py +10 -1
- core/fullscreen/components/matrix_components.py +1 -2
- core/fullscreen/components/space_shooter_components.py +654 -0
- core/fullscreen/plugin.py +5 -0
- core/fullscreen/renderer.py +52 -13
- core/fullscreen/session.py +52 -15
- core/io/__init__.py +29 -5
- core/io/buffer_manager.py +6 -1
- core/io/config_status_view.py +7 -29
- core/io/core_status_views.py +267 -347
- core/io/input/__init__.py +25 -0
- core/io/input/command_mode_handler.py +711 -0
- core/io/input/display_controller.py +128 -0
- core/io/input/hook_registrar.py +286 -0
- core/io/input/input_loop_manager.py +421 -0
- core/io/input/key_press_handler.py +502 -0
- core/io/input/modal_controller.py +1011 -0
- core/io/input/paste_processor.py +339 -0
- core/io/input/status_modal_renderer.py +184 -0
- core/io/input_errors.py +5 -1
- core/io/input_handler.py +211 -2452
- core/io/key_parser.py +7 -0
- core/io/layout.py +15 -3
- core/io/message_coordinator.py +111 -2
- core/io/message_renderer.py +129 -4
- core/io/status_renderer.py +147 -607
- core/io/terminal_renderer.py +97 -51
- core/io/terminal_state.py +21 -4
- core/io/visual_effects.py +816 -165
- core/llm/agent_manager.py +1063 -0
- core/llm/api_adapters/__init__.py +44 -0
- core/llm/api_adapters/anthropic_adapter.py +432 -0
- core/llm/api_adapters/base.py +241 -0
- core/llm/api_adapters/openai_adapter.py +326 -0
- core/llm/api_communication_service.py +167 -113
- core/llm/conversation_logger.py +322 -16
- core/llm/conversation_manager.py +556 -30
- core/llm/file_operations_executor.py +84 -32
- core/llm/llm_service.py +934 -103
- core/llm/mcp_integration.py +541 -57
- core/llm/message_display_service.py +135 -18
- core/llm/plugin_sdk.py +1 -2
- core/llm/profile_manager.py +1183 -0
- core/llm/response_parser.py +274 -56
- core/llm/response_processor.py +16 -3
- core/llm/tool_executor.py +6 -1
- core/logging/__init__.py +2 -0
- core/logging/setup.py +34 -6
- core/models/resume.py +54 -0
- core/plugins/__init__.py +4 -2
- core/plugins/base.py +127 -0
- core/plugins/collector.py +23 -161
- core/plugins/discovery.py +37 -3
- core/plugins/factory.py +6 -12
- core/plugins/registry.py +5 -17
- core/ui/config_widgets.py +128 -28
- core/ui/live_modal_renderer.py +2 -1
- core/ui/modal_actions.py +5 -0
- core/ui/modal_overlay_renderer.py +0 -60
- core/ui/modal_renderer.py +268 -7
- core/ui/modal_state_manager.py +29 -4
- core/ui/widgets/base_widget.py +7 -0
- core/updates/__init__.py +10 -0
- core/updates/version_check_service.py +348 -0
- core/updates/version_comparator.py +103 -0
- core/utils/config_utils.py +685 -526
- core/utils/plugin_utils.py +1 -1
- core/utils/session_naming.py +111 -0
- fonts/LICENSE +21 -0
- fonts/README.md +46 -0
- fonts/SymbolsNerdFont-Regular.ttf +0 -0
- fonts/SymbolsNerdFontMono-Regular.ttf +0 -0
- fonts/__init__.py +44 -0
- {kollabor-0.4.9.dist-info → kollabor-0.4.15.dist-info}/METADATA +54 -4
- kollabor-0.4.15.dist-info/RECORD +228 -0
- {kollabor-0.4.9.dist-info → kollabor-0.4.15.dist-info}/top_level.txt +2 -0
- plugins/agent_orchestrator/__init__.py +39 -0
- plugins/agent_orchestrator/activity_monitor.py +181 -0
- plugins/agent_orchestrator/file_attacher.py +77 -0
- plugins/agent_orchestrator/message_injector.py +135 -0
- plugins/agent_orchestrator/models.py +48 -0
- plugins/agent_orchestrator/orchestrator.py +403 -0
- plugins/agent_orchestrator/plugin.py +976 -0
- plugins/agent_orchestrator/xml_parser.py +191 -0
- plugins/agent_orchestrator_plugin.py +9 -0
- plugins/enhanced_input/box_styles.py +1 -0
- plugins/enhanced_input/color_engine.py +19 -4
- plugins/enhanced_input/config.py +2 -2
- plugins/enhanced_input_plugin.py +61 -11
- plugins/fullscreen/__init__.py +6 -2
- plugins/fullscreen/example_plugin.py +1035 -222
- plugins/fullscreen/setup_wizard_plugin.py +592 -0
- plugins/fullscreen/space_shooter_plugin.py +131 -0
- plugins/hook_monitoring_plugin.py +436 -78
- plugins/query_enhancer_plugin.py +66 -30
- plugins/resume_conversation_plugin.py +1494 -0
- plugins/save_conversation_plugin.py +98 -32
- plugins/system_commands_plugin.py +70 -56
- plugins/tmux_plugin.py +154 -78
- plugins/workflow_enforcement_plugin.py +94 -92
- system_prompt/default.md +952 -886
- core/io/input_mode_manager.py +0 -402
- core/io/modal_interaction_handler.py +0 -315
- core/io/raw_input_processor.py +0 -946
- core/storage/__init__.py +0 -5
- core/storage/state_manager.py +0 -84
- core/ui/widget_integration.py +0 -222
- core/utils/key_reader.py +0 -171
- kollabor-0.4.9.dist-info/RECORD +0 -128
- {kollabor-0.4.9.dist-info → kollabor-0.4.15.dist-info}/WHEEL +0 -0
- {kollabor-0.4.9.dist-info → kollabor-0.4.15.dist-info}/entry_points.txt +0 -0
- {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.
|