Methodology
You have built something, and now you need to decide what is next
Most businesses that have been running for a few years are running on software that has accumulated. Not one system, necessarily. A handful of tools, picked up at different moments to solve different problems, customized in places where the off-the-shelf version did not quite fit. A spreadsheet that nobody calls load-bearing but everyone treats as load-bearing. An integration set up by someone who has since left. A workflow that depends on three tools talking to each other through a fourth tool that nobody has looked at in eighteen months.
This is normal. It is how almost every small and mid-sized business actually runs. The accumulation is not a failure. It is the record of a business that has been doing real work and has made real decisions along the way about how to do it.
But there comes a point when the accumulation is making the next decision harder. The owner is being told to do something with AI and is not sure whether that means rebuilding everything, adding a layer to what they have, or ignoring the noise for another year. The key staff member who knows how the operational stack actually fits together is approaching retirement, and nobody has ever written down what they know. A vendor is sunsetting one of the tools, and replacing it will touch six other things. Software costs have crept past what they should be, and consolidating them would be smart, but nobody knows what would break.
In each of these situations, the next decision needs to be made against the truth of what is actually there. Not against what the owner remembers about the system. Not against what the staff describe when asked. Against the system itself, read carefully.
The methodology described here is the work of doing that reading.
When the methodology applies
There are three kinds of situations. The methodology applies to two of them.
Brownfield. A working operational reality already exists, and the question is what to do with it. Modernize it. Extend it. Replace a piece of it. Audit it before a major decision. The methodology applies directly. The work is reading what is there, surfacing what the reading reveals, and helping the owner decide what comes next.
Insertion. A new component is being built or bought, and it has to land inside an existing operational reality. The new thing is, in itself, greenfield — its requirements are still being worked out, its shape is still being decided. But the context it is landing in is not greenfield. It is whatever has accumulated already, and the new component has to fit. The methodology applies to the existing reality, not to the new component. You read the substrate so the new thing fits the business as it actually is, rather than fits a description of the business that is approximately right and wrong in the places that matter.
Greenfield. A genuinely new operation, with no prior operational reality to read. The methodology as described on this page does not apply — there is nothing accumulated to surface, and the requirements have to be discovered through interview because there is nothing else to read. Greenfield work is a different kind of engagement than the audit-led work the methodology describes, with a different rhythm and different deliverables, but the same standards apply: senior judgment, sustained attention, honest scope, durable documentation. If you are starting something new, the closing of this page applies to you the same as anyone else.
If you are not sure which of these you are, you are probably in one of the first two. Greenfield is rarer than it sounds. Most "new" projects are insertions, and insertions need the methodology more than the people commissioning them usually realize.
The cycle
The methodology is a cycle. The audit produces a substrate — a structured reading of the operational reality. The substrate produces reports, each a different lens on the same picture. The reports inform decisions. Each decision points the work in one of five directions — fix what is broken, modernize what you have, migrate to off-the-shelf software, rebuild on a different foundation, or build something adjacent — and the work that follows flows back into the substrate. The system changes. The substrate refreshes against it. The cycle continues.
This shape matters because the relationship between a business and its operational software is not a transaction. It is not a project with a beginning and an end. It is a continuous practice. The technology around the business keeps evolving. The business itself keeps evolving. Keeping them in alignment requires attention that does not stop after a deliverable ships. Most small and mid-sized businesses do not have the internal capability to maintain that practice. The methodology provides it from outside, in a form structured for the long run.
The audit, in five stages
The audit is the part of the methodology that produces the picture. It runs in five stages, in order, because each stage depends on the substrate the prior stages have built.
1. Read the system. Whatever the system can describe about itself becomes the foundation everything else reads from.
2. Pattern analysis. The substrate gets read with exhaustive coverage. Every script, every automation, every field, every connection — all of it receives the same attention.
3. Workflow tree. A complete map of what the system does — not just what it contains — gets built from the patterns the second stage has surfaced.
4. Focused questions. Short, specific questions go to the people who use the system. Not "tell us what you do." Specific questions, generated by the substrate, that the substrate cannot answer on its own.
5. Reports, one substrate. From everything above, the methodology produces reports — three lenses on the same picture, designed to be read together.
The continuing work
The audit produces the substrate. What happens next is the work the practice and the client do together with it.
The default opening posture is triage. Most operational systems, when read carefully, have a small number of things that are actively causing pain — bugs firing, integrations failing, workarounds that have ossified into the daily rhythm of the business. These get addressed first. The triage is surgical, not transformative. It is short. The point is to stop the bleeding so that the rest of the work can proceed against a stable foundation.
Triage is the default opening, not a universal rule. Some engagements start somewhere else. A business that wants to add a new component to an existing setup — the insertion case — may begin with the specification of the new component rather than with triage of the old one, if the old one is not actively in distress. A business being audited before a sale may receive the substrate and the reports as the entire engagement, with no work that follows on the practice's side. The methodology adapts. The triage-first default is the most common starting point, not the only one.
After triage, the work is decision-by-decision. The reports surface what the system tells the business about itself, what is at risk, what is possible. The client decides what to do with that picture. If the decision is to keep developing what they have, the substrate produces the specification for the changes — step by step, with estimates calibrated against the actual complexity of what is being changed. If the decision is to modernize, the substrate produces the modernization plan with the same character. If the decision is to migrate to off-the-shelf software designed for the situation, the substrate becomes the inventory the migration works against, so nothing has to be re-discovered through interview. If the decision is to rebuild on a different foundation, the substrate produces the rebuild specification. If the decision is to build something adjacent to the existing setup, the substrate produces the design for the new component, with the existing reality as a constraint the design has to satisfy. Each decision produces its own document. Each document is grounded in the substrate.
The work that follows the document can be done by the practice, or by the client's internal team, or by another firm the client chooses. The practice does the work when the work fits the practice's scope; the practice writes the specification regardless, so the work is doable by whoever does it. The deliverable is honest enough to be implementable by a competent practitioner who was not the one who wrote it.
As the system changes, the substrate updates. The substrate is not a snapshot the audit produced and then froze. It is a living record that refreshes as the system evolves. When a change is made, the substrate reflects it. When a new component is added, the substrate grows to include it. When the system is re-read against a fresh export, the analysis produces a diff that shows what has changed, what has been fixed, what has drifted, and how far the system has come.
Observation is continuous. The system's own logs are part of the substrate, and where the system has insufficient logging the practice can install what is needed. But automated observation is only part of it. The practice reads the logs. The practice collects feedback from the users who actually run the system day to day. The reading and the feedback together are what make the substrate trustworthy as a current picture of how the system is actually being used, not just how it is structured.
The relationship is open-ended. The default is that the practice and the client continue working together as long as the work is useful — through fixes, through new components, through modernization decisions, through eventual rebuilds, through whatever the operational reality requires next. The rhythm of engagement varies. Sometimes the work is intensive. Sometimes it is a quarterly substrate refresh and a short conversation about what has changed. The cycle does not have a fixed end. The substrate stays current. The decisions the client makes today are made against a system that has just been read, not against memory.
After decisions are made
The same substrate that produced the audit produces the work that follows. Whatever the decision was — keep developing what you have, extend it with something new, migrate to a different foundation — the work proceeds against a known system, with the documentation and the workflow maps and the report archive already in place to inform every change.
What this means in practice is that estimates are real. The work has been read carefully enough to know what it will cost, and the cost reflects the actual complexity of what is being changed, not a guess against a description of the system. The changes that look small are confirmed small. The changes that look small but are entangled with something else show up entangled before the work begins.
For a client extending an existing setup with something new — what the audit framing called the insertion case — the substrate does additional work. The new component is designed to fit what is actually there, with the existing reality as a constraint the design has to satisfy, rather than as a surprise the new component discovers mid-build.
For a client migrating to a different foundation, the substrate becomes the inventory the implementation team works against. Nothing has to be re-discovered through interview; the source operational reality is already documented. The migration's risk is the work, not the discovery.
What the methodology is honest about
A methodology that does not name its own limits is a methodology that has not been tested seriously. The places this one strains are worth naming.
The substrate is bounded by what the systems can describe about themselves. Spreadsheets used as databases. Browser automations running on individual workstations. Knowledge held only by individual staff members. Processes that happen entirely outside the software. These are visible only through the focused-questions stage, and only if the questions surface them. The methodology surfaces what it can. It does not always find everything.
The pattern analysis is bounded by the patterns the practitioner can recognize. AI extends the coverage; experience extends the recognition. A pattern that has not been encountered before may not be flagged. The methodology improves with each engagement, but at any moment it carries the limits of what has been seen.
The focused questions are only as good as the answers. Clients sometimes do not know what they do not know. A workflow described as standard may be a personal workaround that one staff member developed. A process described as well-established may have been failing intermittently for years. The methodology surfaces these conditions when it can. It cannot always tell, in the moment, whether the answer is correct.
The methodology is also bounded by what the practice can absorb. Some operational realities are too large or too complex for a single engagement at a senior-practitioner-led scope. When that condition appears, the methodology adapts — through staged engagement scopes, prioritized analysis, honest conversation about what can be accomplished in what time. It does not pretend every situation is tractable in the same way.
What the methodology produces
A clear picture of the operational reality, in a form the client owns, designed to serve whatever decisions the client faces.
A living record of institutional knowledge that updates as the systems update.
Reports — on the state of the system, on what the system tells about the business, and on what the paths forward would entail.
Executable next steps with honest estimates, in whatever direction the client chooses.
A continuing analytical capability that lets the work of the past inform the work of the future.
These are the outputs. The methodology is the work that produces them. The work serves the decision, whichever decision the evidence supports.
If you are running an operation on something that matters, you deserve a clearer picture than memory can provide. I would like to hear about it.