Manifestos and Checklists

The Agile Manifesto was probably the first, but certainly not the last attempt at creating a web page that provides a whole platform to a certain ideology.

During the past 20 years, lots of people got fed up with some situation, and wrote a web page (sometimes, a whole website) dedicated to scratching that particular itch, usually with the word “Manifesto” on it. Sometimes, instead, using the word “Checklist,” but with a similar objective. These articles range from the useful to the funny, and they usually have the best intentions.

This article is a summary of the ones I could find in the past 5 years of collecting such links into a Joplin note that grew uncomfortably big.


Let us start with Manifestos, beginning with the most well known of them all.

Project Management

One does not need to introduce the all-mighty Agile Manifesto, which started quite a revolution 20 years ago. In a similar vein we can find the similarly worded and presented Manifesto for Software Craftmanship. Both look quite harmless, from a distance at least.

The implementations of the ideas behind Agile, however, prompted quite a response: the Tarantino-inspired Programming, Motherfucker which is totally not SFW, Artisanal Retro-Futurism crossed with Team-Scale Anarcho-Syndicalism which includes a video, and the Sweary Lightweight Agile Planning or SLAP methodology, which includes a SFW version should you need one.

Finally, the level of burnout in our industry due to an endless stream of consecutive scrums, and the increase of teams’ “velocity”, have brought us the 501 Manifesto and the cry for the 1x Engineer.

I hope you can see an evolution in the three paragraphs above, and maybe this will give you an idea of the current state of the software industry.

Update, 2022-09-30: People are asking Apple to Fix Radar or GTFO.


Let us now concentrate in the best part of our craft. You might want to use UTF-8 everywhere in your code and documentation. Whatever language you use, remember to follow the 12 Factor App principles if you are writing backend services, or the 9 iOS Factors in case you are writing apps for the App Store.

If you are into PHP, consider reading PHP the Right Way as well as the Field Guide to Elephpants. Kinda cute. If you are into reactive thingies, which are quite fashionable these days, read the Reactive Manifesto instead.

Of course, writing the code is just a part of the story; another is debugging, and for that, make sure you have a rubber duck nearby.

Once your code runs, you need to release it. For that, use rootless containers, follow semantic versioning, and keep a changelog (yes, there are two such manifestos about changelogs, clearly they had not heard of one another.)

If your Linux is slow, make it fast again.

I assume you are using Git (who is not?) in which case you might be interested in following the principles of GitOps and in reading the Oh Shit, Git!?! guide. You are welcome.

Finally, if you are in the business of writing console (CLI) applications, consider reading the Command Line Interface Guidelines (arguably featuring the best font design of all manifestos in this page) and paying attention to the DO_NOT_TRACK variable in your environment.

Update, 2021-02-11: Implement your network protocols without I/O.

Update, 2022-05-14: A proposal for self-contained systems.

Update, 2022-07-01: The Continuous Architecture manifesto.

Update, 2023-09-08: Get better project history through Conventional Commits.


There are also manifestos for designers. Let us start with the Laws of UX, the Photoshop Etiquette (please rename your layers, people,) and the guide to Brutalist Web Design. I am not a graphic designer, so maybe there are more, but I have not came across any more than these.

Declarations of In(ter)dependence

These manifestos deserve a section of their own. The oldest of these is the EFF Declaration of Cyberspace Independence written in Davos, in February 1996 (when the word “Cyberspace” was still cool). Then comes the Declaration of Interdependence which according to Graham was originally located in Alistair Cockburn’s website.

Finally, here is Larry Sanger’s Declaration of Digital Independence.

Whatever these things mean.

Communication & Business

Sometimes the problems lie in the way people talk to each other, and the following manifestos try to bring solutions to those issues.

Take this one for example: the reason why your question in Stack Overflow receives no answers is because of the way you asked it; check the XY Problem manifesto to learn more and change your question asking habits. It is a bit like a meta-RTFM of sorts.

Or maybe you need to make better comments, follow the core protocols, or to learn how to explain security honestly. Of course, none of this would matter if you are not working in a responsive organization, anyway.

Or you might just need to make clear to somebody who is the team behind a website, that is all.

Update, 2022-11-26: During the rise of Mastodon, here’s a charter for the fediverse.

Update, 2024-04-12: Here’s how to make Enterprise-ready software.

Open Source

The global collaboration required to make good open source software requires lots of goodwill and mutual understanding. For example, if you are just creating a hobby project, make it clear to others that it will go unmaintained.

On the other hand, if you want to contribute to open source software, remember to read the Contributor Covenant first.

Maybe you are not a developer, in which case you would like to know what open source software might help you replace some other commercial package, and there is a guide for that as well.

No matter what you want to do with open source software, remember always to first, do no harm and to learn exactly what empowered free software means.

Do Not Do This, Do Not Use That

Then we have the family of widely negative manifestos. They range from the obvious, such as Chrome is Bad and do not use Medium, to the least obvious, like not using the “Hello” word in chats to list all the things that are wrong with YAML.

The truth is, the whole industry has been designed to be defective by design.

Update, 2022-08-19: Dear Linux developers, please do not ship work in progress to users.

Update, 2022-08-26: Do not send HTML email, only plain-text email.


The 2020 pandemic has changed our relationship to work and society. First of all, stay the fuck home. Then, remember that it’s OK if you do not feel well. And also, project managers out there, you must adapt to the new remote working conditions ASAP. Did not you get the memo?


The software industry keeps its head buried under the sand, failing to acknowledge the role of ethics in society. For those of us who refuse to ignore the truth, here go some enlightening reads: The Ethical Source Movement, the Post-Meritocracy Manifesto, and a Contract for the Web.

Read them. Breathe. Change yourself.

Update, 2022-11-04: The IndieWeb Manifesto, more relevant than ever at a time when platforms start going crazy.

Update, 2024-01-19: The Sensible AI Manifesto is designed to help people make the right decisions in implementing and managing Generative AI within organizations.


We live in the most challenging times of our species. Our relationship with one another and our economic organization must change, and here are two interesting manifestos for that: Common Futures and Participatory Economics. If you give a shit about humanity, you will find them truly inspiring.

Update, 2021-02-08: Here goes a manifesto to avoid having free plans in your SaaS.

Update, 2021-04-09: If you are into accounting, you might want to manage your accounts in plain text. Or not.


To finish, some checklists you might find useful.

If you deploy in Kubernetes, check the production best practices and the production checklist.

With all of those deployments in the cloud, security has become an actual concern. For that, here are the security checklist, the Azure checklist, and if you use AWS, here is the AWS Security Checklist for you. If you follow DevSecOps practices, here is the DevSecOps Checklist.


There is no conclusion, this page is just a list of links, click on them and have fun. I like collecting stuff like that, so expect more posts similar to this one in the future.

Update, 2024-04-26: Neither a checklist nor a manifesto, but here’s a set of useful cards to explicitly tell people not to reply or provide suggestions when you express rants or tell people about your experience online: the Do Not Reply Cards.