The method
How EnterDone is built
EnterDone is built by agents, within rules written in code, with a receipt for every step — the same way it works inside your company. That way has a name and is written down: the Suleiman Method, an engineering model for real systems built with agents, by someone who does not read code and validates by what shows up on screen. This page is the summary; the full document is at the end, for anyone who wants to use it in their own project.
The central sentence
Observe what is real, find the difference, fix the minimum, prove in proportion to the risk, and turn valuable errors into permanent properties of the system.
Or, operationally:
AI proposes. Engineering constrains. The system executes. Evidence demonstrates. The human perceives and governs the risk. Error teaches. Code learns.
A system is not correct because the agent said it was done, because the code compiled or because the tests went green. It is correct within what has been demonstrated by evidence. Authority comes from proof, not from trust in the agent.
The central loop
- MeasureEstablish the real state.
- ContrastCompare what was observed with what was believed. The most valuable finding is often the one that contradicts the hypothesis.
- ExplainFind the cause, without confusing correlation with causation.
- FixMake the smallest change that restores the invariant.
- ProveEvidence proportional to the risk — including trying to refute your own work and, where perceptual quality is involved, human observation.
- GeneralizeAsk: what class of error is this?
- Wall it offWhen it is worth it, turn the lesson into a permanent protection.
- RecordPreserve the finding so nobody has to relearn it.
The human is a sensor, not only a governor
The agent reads the code — the intent. The human sees the screen — the behavior. Some errors only appear in time, motion and perception: the skipped frame, the almost-right layout, the technically correct answer that sounds wrong. For those qualities the agent cannot declare anything proven; it says where to look and what to observe, and human verification is legitimate evidence. A trained eye is a measuring instrument, and the method treats it as one.
The 16 invariants
- Measure before you explain.
- Every important operational claim needs reproducible evidence.
- Absence, error and unavailability are different states.
- A test only demonstrates what it actually asked.
- The greater the impact, the stronger the proof must be.
- Prefer mechanical constraints to behavioral instructions.
- Autonomy must be proportional to reversibility and risk.
- Important information carries provenance.
- Operations at scale have limits and recovery mechanisms.
- Recurring errors must become permanent protections.
- Local evidence does not become universal law without generalization.
- The agent is not the authority on its own success; the observed system is.
- Whoever did it is not whoever verifies it, in proportion to the risk.
- Risk is defined by what the change touches, not by the confidence of whoever makes it.
- Before declaring it done, try to prove you are wrong.
- What only the human eye perceives, only the human eye proves.
How it shows up in the product
The method is not a text about EnterDone; it is what EnterDone enforces inside your company. Each rule below has a matching wall in the product, described on the governance page.
The full document
The whole method — 44 sections, with its origin, its convergences with established engineering and what is its own contribution — and the operational contract agents follow in every project are published in an open repository, as written, in Portuguese (an English version follows):
- github.com/suleiman-ribeiro/metodo-suleiman — the public repository: the source, with history, issues and the license.
- ENGINEERING_METHOD.md — the method: why. (copy on this site)
- AGENTS.md — the agents' engineering contract: how to work. Section 10 is a template for each project to fill in. (copy on this site)
Author: Suleiman Ribeiro. License Creative Commons Attribution 4.0: use, adapt and redistribute, crediting the source. The method came from practice, not from research; where it converges with established ideas, the reference table at the end of the document says which.