The 'This is Fine' Guide to Building Software

The room is on fire. You have coffee. Build anyway — on purpose.
What’s Inside
Section titled “What’s Inside”1. Stance
2. Lifecycle — how work flows
Discover → Deliver → Operate → Maintain → Retire
- Discover — discovery, fidelity, spec altitude
- Deliver — build, integrate, ship plays
- Operate — ops, observability, feedback
- Maintain — refactor, buy/vendor, LLM-era cost
- Retire — deprecate, transition, archive
3. Architecture — when you need a bet
Architecture hub — shape → language → framework → what runs where → compute hosts
- Project shapes — website → CLI → package → monorepo
- Language selection
- Web framework selection
- Quality regimes · Bugs & debt · Quality trace
4. Reference deck (draw cards as the flow or shape says)
Introduction
Section titled “Introduction”Software is always somewhat on fire: half-finished branches, flaky CI, a prod mystery, an agent rewriting the same file, a vision nobody wrote down. The meme is not denial. This is fine means I will not add more fire while I drink this coffee. You survey the room, name what’s burning, pick one achievable move that serves why the project exists, then act with a named skill — not vibes, not a bigger swarm.
This handbook is the field guide for that stance. It sits on the DecisionNerd/dev-skills pack and points outward to DocSlime, ProductFeeling, Impeccable, and whatever is vendored in your repo. The skills are the named cuts; the vision is the dish; evidence is how you taste as you go — quality regimes say which tasting method fits, and the quality trace keeps documentation and proof on the same plate.
New here? Read How work flows, then open Architecture only when shape/stack/placement is the fire. Don’t alphabetize the practice deck on day one.
How to use this handbook
Section titled “How to use this handbook”One reading order
Section titled “One reading order”- Orient — Why it Works + Orientation (coffee, not panic).
- Lifecycle — Discover → … → Retire. Know where you are in the life of the system.
- Architecture — Architecture when you must choose shape, language, framework, placement, or host.
- Reference — strategies / practices / skills as a modular deck; the flow and shape pages say which cards to draw.
flowchart TD Stance[Stance] --> Life[Lifecycle] Life --> Arch[Architecture] Arch --> Deck[Reference deck] Life -->|feedback| LifeSkills quick map (when you have DecisionNerd skills)
Section titled “Skills quick map (when you have DecisionNerd skills)”| To… | Run |
|---|---|
| Don’t know what to do next | idk-now / idk-now quick |
| “Is this overcomplicated?” | kiss |
| Repo / CI / ESC secrets | repos |
| Tactical scout | recon / recon issue |
| Track work | issues · milestones · pulls |
| Diagnose / repair | troubleshoot-app · diagnose-bug · fix-it |
| Harden | test-it · observe-it · document-it · research-it · refactor-it |
| Ship | check-readiness · merge-it · stage-it · ship-it |
| Agent thrash | agents slap |
| Clutter | tidy-up scan |
| Companions | ProductFeeling · Impeccable · DocSlime |
The coffee test
Section titled “The coffee test”Before spawning another agent or opening another PR: Does this put out a real fire, or just rearrange the smoke? If you can’t answer, run Orientation or idk-now — don’t pour accelerant. If you’re loading monorepo/K8s tools onto a simple website, run kiss first.