โ Hand-drawn figures: correcting or adding a figure on paper¶
Status: how-to.
Written for an author who would rather mark a figure with a pen
than describe the change in words: a correction on a printed page, a
figure redrawn by hand, or a sketch of a figure the draft does not have
yet. Assumed: you have a draft under content/drafts/ in a topic
directory of its own, and an agent whose model can view images.
Not covered here: what the figure-drawer skill does once it knows
what to draw, which is FIGURE-DRAWER.md; what a
good figure looks like, which is TIKZ-STYLE.md; and
the two-file contract every figure follows, which is
WRITING-STANDARDS.md ยง10.
๐งญ Table of contents¶
- Three things a photo can be
- What to hand over
- The read-back
- Correcting a printed figure
- Redrawing a figure by hand
- Adding a new figure from a sketch
- Marking a page so it reads the first time
- What it never does
- When something goes wrong
๐ Three things a photo can be¶
| You photograph | It is treated as | What changes in the draft |
|---|---|---|
| a printed figure of the draft with pen marks on it | a correction | the existing figures/<name>.tex and .txt, only where you marked |
| a figure of the draft redrawn by hand | a redraw | the same pair, rebuilt under the same name |
| a sketch of a figure the draft does not have | a new figure | a new pair, a marker and a caption in the draft |
A photograph or a scan both work. The image is an instruction, like a sentence typed in chat. It is never copied into the draft.
๐จ What to hand over¶
Give the image and say which draft it belongs to. For a correction or a redraw that is enough, as long as the page shows which figure it is:
1 2 | |
A new figure needs three more things: where in the draft it goes, what it shows in one sentence, and what any abbreviation in it stands for.
1 2 3 | |
You never name a skill. draft-reviser takes the request, hands the
drawing to figure-drawer, and takes the draft back afterwards.
๐ The read-back¶
Before any file changes, you get your marks read back, one row per mark:
| Field | What it holds |
|---|---|
now: |
the label or arrow as the figure has it today, or none for something you added |
mark: |
what you drew or wrote, transcribed as written |
edit: |
what will be done: reword, delete, add a box, add an arrow, add a group, move |
For a redraw or a new sketch the rows are its boxes, arrows and groups.
Some marks cannot be tied to an instruction. They go on a separate unclear list, each with a question:
- a word beside the figure with no arrow or strike joining it to anything;
- a bracket, an underline or a wavy line with no word saying what to do;
- a word written and then struck through;
- an abbreviation the draft does not define;
- handwriting that reads two ways.
A proof page carries notes to yourself as well as corrections, and the two look alike. So an unclear mark is never applied on a guess.
What happens next depends on that list:
- Nothing unclear: the rows are posted and the edit goes ahead.
- Anything unclear: nothing is applied until you answer, the clear rows included, because one answer often changes the row beside it.
- Nobody to ask (an unattended run): the clear rows are applied and the unclear list comes back unapplied.
The rows you confirmed are recorded in the dossier's steering.md, as
the instruction that prompted the change.
๐ Correcting a printed figure¶
- Print the page and mark the figure.
- Photograph or scan it and hand it over with the draft's path.
- Read the read-back and answer any question on the unclear list.
- The existing pair is edited in place. Only what you marked changes: a label you did not touch keeps its wording, and the layout stays.
- The figure is checked and rendered, and the render is compared with your photo row by row.
- A reworded label is carried into the rest of the draft. If you
renamed a box, the caption, the prose, the glossary and
math.mdare brought into line with it. - The change is logged in
revisions.md, and the draft is gated and rendered.
If your marks add so much that the figure no longer fits its layout, or it now argues something else, you are told so and it is handled as a redraw.
๐ Redrawing a figure by hand¶
Draw the whole figure the way you want it and photograph the sheet. Write "Fig N" on it so the pair it replaces is not in doubt.
Your sketch supplies the boxes, the arrows and the grouping. It does not supply the positions: you drew to fit the paper, and the figure has to fit the page. The layout comes from the house scaffolds (FIGURE-DRAWER.md), keeping your reading direction and your groups.
The existing pair is edited under its own name, so the draft's marker and every reference to the figure still resolve. Anything the old figure had that your sketch leaves out comes back as a question, not as a silent deletion.
โ Adding a new figure from a sketch¶
- Sketch the figure and photograph it. Keep one figure to a photo.
- Hand it over with the draft, the section, a one-sentence statement of what it shows, and the meaning of any abbreviation.
- Read the read-back. Here it lists every box, arrow and group.
- A new pair is written beside the draft:
figures/<name>.texin TikZ andfigures/<name>.txtin ASCII. - The draft gets
<!-- figure: figures/<name> -->on a line of its own with a caption below it, and<!-- figureref: <name> -->where the prose points at the figure. A thesis chapter gets afigurefloat instead (FIGURE-DRAWER.md). Nobody writes "Figure 3" by hand; the renderer numbers it. - The change is logged in
revisions.md, and the draft is gated and rendered. You see the page with the figure on it.
The skill may suggest dropping or merging a box. On a sketch of yours that is a question to you, never a cut it makes on its own.
๐ก Marking a page so it reads the first time¶
- Name the figure. Leave the printed caption in the photo, or write "Fig N" on the sheet.
- Strike and replace. Strike what goes, and write what replaces it beside the strike.
- Tie a new word to its place. Draw an arrow from it to the box or the arrow it belongs to.
- Keep notes to yourself apart. Circle them, or keep them off the page.
- Spell out abbreviations the draft has not defined yet.
- Write the way the figure reads. A label is set as you wrote it, apart from the capitalisation the figure already uses.
๐ซ What it never does¶
- It never copies or traces the photo into the draft.
- It never changes a label you did not mark.
- It never applies a mark it could not tie to an instruction.
- It never redraws a figure from a paper or a book. A printed figure that is not one of the draft's own is treated as a source figure, which may be looked at and never reproduced (WRITING-STANDARDS.md ยง10).
- It never puts a citekey inside a figure file.
๐ฉน When something goes wrong¶
| What you see | Why | What to do |
|---|---|---|
| "I cannot view images" | the agent's model has no vision | type the corrections, or use a model that can view images |
| It asks which figure the photo is | no caption or "Fig N" in the photo, or two figures share the labels it could read | name the figure |
| A long unclear list | notes and corrections are mixed on the page | answer the questions; next time, circle the notes |
| The redrawn figure is not laid out like your sketch | positions come from the house layout | say what must sit where, and why, as a follow-up revision |
| It asks to move the draft first | a flat draft has no topic directory to hold figures/ |
agree to the move, or drop the figure |
| It refuses a figure in a deep-research report | that genre takes no figures | put the figure in another draft |