Contents

A guide to the principles

The manifesto in practice

A principle earns its place when it helps someone make a difficult decision. It also needs to say where its advice ends. “Archive first, delete second” sounds sensible until the material is something you should no longer retain.

This guide puts the twelve synthesis principles to that test. Each chapter explains the problem a principle addresses, follows a concrete decision, and examines a case where applying the words literally could make the work worse. The scenarios are illustrations, not reports of measured results or accounts of a particular organization.

The manifesto is the short statement people sign. These pages are commentary on it. Three principles need more precise wording, and the wording and history page sets out those proposals beside the original text. Existing signatures are not endorsements of this guide or of those proposed changes.

What changes in the work

Imagine a team preparing a report with an AI assistant. The assistant has summarized the source material, produced a draft and announced that the report is ready. The team still has several decisions to make.

Someone checks whether the source supports the draft’s central claim. The team keeps the relevant evidence with the report, including the question that remains unanswered. If a required check of permission to distribute the report is unavailable, sending waits; authorized editing can continue. The next person can find the current draft and the decision about distribution without reconstructing a conversation.

That is the kind of work these principles ask for. The same team could misuse them. It could recheck every harmless detail until the report is late, retain private source material indefinitely, or demand approval for every sentence while calling that human judgment. Each chapter takes those costs seriously.

The practical aim is for people to understand the work well enough to direct it, assess it and continue it. Better tools can help. The responsibility for deciding what is worth doing remains with people, including those who will live with the consequences.

How to use the guide

Start with a decision you face. If the question is whether a result is ready, read about evidence and incomplete work. If you are handing work over or changing tools, read about continuity and portability. If two principles point in different directions, the conflicts page works through those choices.

The complete guide collects every chapter and the companion pages in one place, including a print view. You can read or share an individual principle without asking someone to study the whole system first.

Before signing, read the questions about support, independence and obligations. A useful conversation can end in a signature, a disagreement or a better explanation. None of those needs to be hurried.

Familiar practices, a shared discipline

Checking sources, leaving usable records and keeping people accountable are established practices. The manifesto brings them together around work that now crosses people, AI assistants, sessions and tools. Its paired values also draw on the form of the Manifesto for Agile Software Development.

The explanations here offer reasons to try these practices. They do not establish that adopting the whole manifesto improves every team’s results. On a real task, look for a concrete benefit: a mistake caught before release, a handoff someone can use, or a tool change that preserves enough context to continue. Count the effort required to achieve that benefit too. A practice that keeps producing paperwork without helping anyone decide deserves another look.

The twelve principles

  1. Checking the system you have today

    A remembered result can become a mistaken claim about today's system. Choose evidence that answers the question, and know when another check adds little.

  2. What would show that the work is done?

    Choose evidence that supports the specific claim being made. Practical examples distinguish delivered work from exploration, test counts and private judgment.

  3. A useful release can still be incomplete

    Ship useful increments with clear promises. Make consequential omissions visible where people decide to use the work, and distinguish scope from a hidden gap.

  4. When a safeguard stops working

    A failed check needs a visible outcome. Decide which action must stop, what can continue safely and whether an authorized fallback covers the failure.

  5. A handoff someone can use

    Give the next person enough context to continue without reconstructing every conversation. Preserve decisions and evidence, with clear limits on retention.

  6. When keeping a copy is the wrong choice

    Make valuable work recoverable before deleting it. Recognize when an archive defeats an erasure requirement, and verify what a backup can actually restore.

  7. Keeping project lessons useful

    A recorded lesson helps when someone can find, test and revise it. How to prevent a repeated mistake without turning one incident into a permanent rule.

  8. Human judgment needs room to act

    Human oversight means having the information, time and authority to change a decision. An example of useful delegation, empty approval and affected voices.

  9. What counts as a complete fix?

    A complete fix has an agreed problem boundary and a way to prove it works. Emergency containment can be responsible without being mistaken for resolution.

  10. Can your work survive a change of tools?

    An export is useful when work can continue from it. Test what a second tool preserves, what it loses and whether the full cost of leaving is acceptable.

  11. Sharing methods without exposing people

    A reusable method can be worth sharing even when its source material must stay private. Rights, security and confidentiality determine what can be released.

  12. How to judge a borrowed practice

    A practice deserves a fair trial under your constraints. Compare its benefits and costs, preserve useful dissent and distinguish evidence from fashion.

Questions and limits

Questions before signing

What a signature supports, how it relates to your employer and tools, and what the manifesto cannot promise.