Skip to content

The 'This is Fine' Guide to Building Software

This is fine

The room is on fire. You have coffee. Build anyway — on purpose.

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 wherecompute hosts

4. Reference deck (draw cards as the flow or shape says)

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.

  1. OrientWhy it Works + Orientation (coffee, not panic).
  2. LifecycleDiscover → … → Retire. Know where you are in the life of the system.
  3. ArchitectureArchitecture when you must choose shape, language, framework, placement, or host.
  4. 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| Life

Skills 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

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.