Practices

Contemplative Coding

Stop at the exact place your understanding stops.

Proposed form Not a report of established or tested use.

  • Time needed Twenty to thirty minutes
  • Alone Can be practiced on your own

The sequence

  1. Choose one safe, reachable system

    A small script, a form, a documented process, or an object you know how to examine safely. Do not open or alter equipment beyond your competence.

  2. Trace one behavior

    Follow a single action to its result. Note where you have evidence and where you are guessing.

  3. Notice an assumption

    What does the arrangement expect of a person's time, language, body or knowledge? Who must compensate if that expectation is wrong?

  4. Leave a useful trace

    Write one explanation, question or correction for the next keeper. Keep uncertainty visible rather than supplying a tidy account you cannot support.

Programming is one way to do this. Understanding a request that disappears between two offices can be another. The size of the system is not the measure of the attention given.

The exercise ends even if the system remains partly opaque. Record the limit. An honest question can be a better inheritance than an elegant explanation.