nilenso will use business decision records



This BDR is one-of-a-kind. It marks the end of "historical" decisions documented with BDRs. After this BDR, all future decisions will be documented shortly after they are made and will include a date, like the one above.


It has been hard to answer the question “what is nilenso?” Are we well described on our website? Can you get a sense of us from our Twitter account? Blog post? Talks? Publicized policy?

nilenso is many things: a worker cooperative, a “hacker’s collective”, an experimental technology consultancy, a design firm, an Ops Team, an office space. Policy is verbose and blog posts are piecemeal. Principle is not easy to document. Moreover, as soon as a document is written it is out of date. All companies are built of ephemeral moving parts — nilenso especially so.


We have seen the effectiveness of “Architectural Decision Records (ADRs)” on our software projects and in open source. We believe that by documenting coarse-grained decision on an immutable, append-only timeline similar to a list of ADRs, we can capture much of the essence of our strategy, policy, and principles — in a consistent, reproducible, publishable format.

This format, structured as Context-Decision-Status-Consequences allow us to be both concise and informal while directing the reader to living documents such as policies, references, and long-form material such as articles, blog posts, and videos.

Status: Accepted.


Publicizing BDRs gives readers —both members of nilenso and the public— a singular starting point for discovery of material behind major decision nilenso has taken. This provides a modular blueprint for other organizations to examine, copy, and implement.

A very real danger exists that major decisions will go unrecorded. When this occurs, we must write retrospective BDRs (as all BDRs preceding this BDR have been) dependent on our memories and occurrences between the actual event and when the BDR is written.

We will try our best to write a meaningful BDR as and when a major decision is made.

It is important to note that a “major decision” can only be strategic. A BDR describes strategy, philosophy, principle, or policy.

BDRs should not describe tactics, implementation, or the specifics of an event. A good litmus test is whether or not a BDR contains the name of an individual. If it does, it is probably not a BDR.

BDRs should also not be confused for board resolutions. BDRs are not contracts; while they do express intent, they are not binding documents like a policy document or board resolution. Principle and philosophy BDRs tend to be emergent and are often decided and implemented implicitly before they are explicit. Board resolutions are a formal (and contractual!) document and should be written elsewhere.