Skip to content

Instantly share code, notes, and snippets.

@indexzero
Last active January 16, 2026 16:58
Show Gist options
  • Select an option

  • Save indexzero/d2f60d440d19375ee1e3c0ee8cc11997 to your computer and use it in GitHub Desktop.

Select an option

Save indexzero/d2f60d440d19375ee1e3c0ee8cc11997 to your computer and use it in GitHub Desktop.
Principles of Note: a list of select principles that have been particularly useful in helping design, refine, and debug complex systems (both computer & human)

Principles of Note

A list of select principles that have been particularly useful in helping design, refine, and debug complex systems (both computer & human)

Any organization that designs a system (defined broadly) will produce a design hose structure is a copy of the organization's communication structure.

— Melvin E. Conway

A complex system that works is invariably found to have evolved from a simple system that worked. The inverse proposition also appears to be true: A complex system designed from scratch never works and cannot be made to work. You have to start over, beginning with a working simple system.

– John Gall

Postel's Law (Robustness principle)

Be conservative in what you do, be liberal in what you accept from others.

– Jon Postel

n.b. the above is often reworded in the context of systems design as: "be conservative in what you send, be liberal in what you accept"

Goodhart's Law

source: https://sketchplanations.com/goodharts-law

Parkinson's Law

Work expands so as to fill the time available for its completion

– C. Northcote Parkinson, 1955

n.b. the above is reworded in "Four Thousand Weeks" to define "Work" as "what needs doing".

Brook's Law

This idea is known as Brooks's law, and is presented along with the second-system effect and advocacy of prototyping.

(See: The Mythical Man-Month)

@indexzero
Copy link
Author

@indexzero
Copy link
Author

@indexzero
Copy link
Author

"Given enough eyeballs, all bugs are shallow"

  • Eric Raymond, CATB

@indexzero
Copy link
Author

Existence of mathematical beauty https://en.wikipedia.org/wiki/Mathematical_beauty

@indexzero
Copy link
Author

Akham's Razor

@indexzero
Copy link
Author

Select excerpts, Engineering Kindness https://kind.engineering/

@indexzero
Copy link
Author

@indexzero
Copy link
Author

@indexzero
Copy link
Author

Parkinson's law
parkinsons-law

@indexzero
Copy link
Author

@indexzero
Copy link
Author

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment