The General Specification Method
PART THREE: THE GENERAL METHOD
For situations the Field Guide doesn’t cover. Once you know the nine strategies and have seen them applied, this part shows you how to apply any of them to any situation this book doesn’t address. The Five-Part Frame is a spec template. The calibration question is a verification tool. The refinement loop runs until the output is usable.
“A common mistake that people make when trying to design something completely foolproof is to underestimate the ingenuity of complete fools.” — [Douglas Adams](https://en.wikipedia.org/wiki/MostlyHarmless), Mostly Harmless, 1992_
epigraph-general-method-fool.png
A padlock being opened by a bent paperclip inserted in the keyhole.
A padlock in 8-bit pixel art, approximately 40x48 pixels scaled up. Three-quarter view, hasp closed, body rendered with the weight and specificity of a real Master Lock. A bent paper clip is inserted into the keyhole at the angle of someone who has done this before. 4-color palette drawn from the master palette: Charcoal for the lock body, Warm Gray for the shackle and paperclip, Black for the keyhole and outlines, Recycled for a single highlight catching the shackle's curve. Colored in ballpoint pen and pencil per the inline-graphics style. **True pixel grid --- non-negotiable.** Actual 8-bit pixel art, not a blocky illustration. Render on a literal uniform grid of axis-aligned square pixels, as if captured from an NES framebuffer and enlarged with nearest-neighbor scaling. Every pixel the same size, every pixel a single flat color from the palette. Hard edges between colors, no anti-aliasing, no smooth curves, no airbrush, no sub-pixel detail. Diagonals are stair-stepped. The viewer should be able to count pixels along an edge. **No meta-elements --- non-negotiable.** The illustration contains only the padlock and paperclip. No color swatches, palettes, legends, keys, hex codes, callouts, arrows, sidebar text, or any UI explaining the colors or technique. No caption text inside the image. **Background: pure white, `#FFFFFF`, flat.** Not gray, not off-white, not cream, not paper texture. The build removes white to create transparency, so any gray will show as a halo in the ePub. **Watch out for:** - NO hand holding the paperclip --- object-focused, not figure-focused - NO keyhole light glow or dramatic shading beyond flat palette fills - NO padlock brand logo or readable text - NO speech bubble, thought bubble, or dialogue text
Every problem in this book is a variation on a general skill: turning a confusing or overwhelming situation into a clear, specific request. Once you have that skill, you do not need this book to cover your situation. You can handle anything.
Here is the framework in its most general form.
The Five-Part Problem Frame
1. Who you are in this situation
Not your name. Your role in the specific situation. Are you the tenant or the landlord? The parent or the child? The employee or the employer? The buyer or the seller? Your Agent needs to know whose perspective it is helping, and what constraints that role carries.
I am a first-generation homeowner who has never dealt with a homeowner’s association before…
2. What happened
The facts, as specifically as possible. Dates matter. Amounts matter. What was said or written matters. If you have a document — a letter, a contract, a bill — paste the relevant section directly into the conversation.
…I received a letter dated October 3 stating that my fence is in violation of HOA guidelines, with a fine of $150 per day starting October 17. I was not aware of any fence height restrictions when I purchased the home…
3. What you want
The actual outcome you are trying to achieve. Not “help” — a specific result. Do you want to understand your options? Do you want a draft letter? Do you want to know if you have grounds to dispute this? Say exactly what you want.
…I want to understand whether I have grounds to dispute this fine, and if so, what my first step should be.
4. What you want to avoid
The failure modes that matter to you. What does a bad outcome look like? What do you not want to say or do? This information shapes your Agent’s answer away from generic advice and toward your specific constraints.
…I want to avoid escalating this into a legal dispute if possible, because I plan to stay in this neighborhood long-term.
5. What format you need
A list, a letter, an explanation, a set of options, a yes/no answer, a step-by-step plan. If you do not specify a format, your Agent will default to prose, which is sometimes not what you need.
…Please give me a plain-language explanation of my rights and a numbered list of my options, from least to most confrontational.
The Complete Spec
Assembled, the example looks like this:
I am a first-generation homeowner who has never dealt with a homeowner’s association before. I received a letter dated October 3 stating that my fence is in violation of HOA guidelines, with a fine of $150 per day starting October 17. I was not aware of any fence height restrictions when I purchased the home.
I want to understand whether I have grounds to dispute this fine, and if so, what my first step should be. I want to avoid escalating this into a legal dispute if possible, because I plan to stay in this neighborhood long-term.
Please give me a plain-language explanation of my rights and a numbered list of my options, from least to most confrontational.
This spec will produce a genuinely useful response for a situation this book does not specifically cover. The same frame works for a zoning dispute, a workers’ compensation question, a complicated family business conflict, or anything else you bring to it.
-
[1] Pennebaker, J.W. (1997). Opening Up: The Healing Power of Expressing Emotions. Guilford Press. See also: Klein, K. & Boals, A. (2001). “Expressive writing can increase working memory capacity.” Journal of Experimental Psychology: General, 130(3), 520–533.↩