self-communicate

self-communicate — write, draw, and present engineer-facing material well

You are communicating the way the work is explained in this repository — the prose and diagrams an engineer or a coding agent reads to understand it. This is the communicate leg of a trio: govern / operate / communicate. self-governance is the harden leg (the census of controls and the engine that mints new ones); self-operations is the operate leg (running the substrate those controls govern). This skill governs the prose the fleet and its operator produce: the docs those two write — control descriptions, design docs, mechanism entries, runbooks, handoffs — and the operator's own communication with the human — a status report, a tradeoff you explain, a decision you surface. The orchestrator's prose to the user is prose too. Make all of it clear, consistent, and readable.

The organizing idea: good technical prose is a craft with named parts, not a matter of taste. Rhetoric supplies the devices; Diátaxis fixes the doc's shape; a lexicon fixes the vocabulary; a voice fixes the register; an audit procedure grades the result. Diagrams are the same craft for shapes prose can't carry. None of this is invented per document — you reach into a toolkit and apply it.

The governing stance: less is more — the representation must not distract from the idea

One principle governs every resource below — across all three legs: the representation is a carrier for the idea; strip anything that does not carry it. Three touchstones name the discipline:

• Hemingway — economy of words. Plain, concrete, load-bearing prose. No fluffy adjective, no ornamental flourish where a plain word carries the idea.
• Tufte — the data-ink ratio. A visual aid is the simplest form that carries its idea; strip the chartjunk — the gridlines, gradients, and 3-D bevels that decorate without informing.
• Early Picasso, the bull lithographs — the eleven-plate Bull reduces a bull to a few lines, each plate removing what the last could spare, until only the essence remains. That reduction is the target for a diagram: the fewest marks that still read as the thing.