01 / Method
Four phases, three of them mine
How I work: four phases, and who actually does them
This page exists because the real question a company asks itself before signing is not «which technologies do you use»: it is «what happens over the next ten weeks, who answers me when something goes wrong, and what do I hold at the end». The three answers are here, with what I don't do declared as precisely as what I do.
What comes out of each phase
- A map of the data flows
- Manual work in hours
- An architecture document
- A release plan
- Milestones you can try
- Logs and alerts
- Your code and credentials
Every phase produces a document or something you can try. If a phase leaves nothing verifiable behind, it is not a phase: it is billed time.
- Who does the critical work
- Analysis, architecture and code review are mine and I do not delegate them. They are the phases where it is decided whether the project holds up.
- On development
- When the volume calls for it I rely on a small network of people I have worked with for years, but every line that reaches production passes through my review.
- Who you deal with
- Always the same person, from the first call to release. No account manager, no handover.
- Quotation
- A fixed price after the analysis. Before that it would be an invented number, and anyone who gives you one earlier is guessing.
02 / Diagnosis
Why software projects end badly
Almost every company I speak to has a software project that went wrong behind them
Hardly ever through technical incompetence. The ways a project sinks are few and they repeat, and all of them are recognisable in the first two weeks — if you know what to look at.
The quotation arrived before the analysis
A number given without having looked at the systems is a bet. When the bet turns out wrong there are two outcomes: change requests that blow the budget, or a supplier cutting quality to stay inside the number. In the second case you pay anyway, only later.
Nobody wrote down what the system will not do
A scope described only by what is included leaves everything else in a grey area. Three months in, the grey area becomes a disagreement, and the disagreement becomes an argument about who understood what. You prevent it by writing the exclusions too.
Progress is reported in percentages
«We are at 70%» is not information: it is reassurance. Seventy per cent stays seventy per cent for weeks and then becomes seventy-five. The only verifiable progress is something you can try yourself, on your own data, with the people who will use it in the room.
The analysis was done on how the company describes itself
Every company describes its processes as they ought to work, not as they do. The difference between the two sits in steps nobody mentions because they have done them for years and consider them normal. Those steps are precisely the work to be automated.
The release was a switch
Old process off, new system on, and everybody discovering in production what had not been anticipated. A release done that way turns a small defect into an operational stoppage, and burns the trust of the people who are supposed to use the system.
At the end something was missing to carry on without the supplier
Code not handed over, infrastructure in their name, no documentation, a component nobody else can touch. The project technically works, but the company is not free. It is the damage that surfaces latest and costs most to repair.
The same six things, and how I handle them
This is not a list of good intentions: they are the operational countermeasures, each one verifiable by you during the project.
| Moment | How it usually goes | How I handle it |
|---|---|---|
| Quotation | A number given after a call, before having seen the systems. | The analysis as a piece of work in its own right, then a fixed price against a defined scope. |
| Scope | A list of what is included, and everything else in a grey area. | What is included and what explicitly is not, written in the same document. |
| Progress | Percentages communicated in a meeting. | Milestones you can try yourself, on your own data. |
| Analysis | Questionnaires and video calls with whoever coordinates. | Time on site with the people who touch the data every day, where that is possible. |
| Release | A changeover in one day, with the old process switched off. | Gradual, with the manual process live as a safety net until it has been proved. |
| Closing | The system is handed over, everything else stays with the supplier. | Code, documentation, architecture and credentials in your name. The known weak points too. |
03 / Principles
Four rules, and what they cost
The four rules the method is built on
Every rule has a cost. Declaring it is the only way to make the rule credible.
A method described only by its advantages is not a method, it is sales material. These four rules determine how I work, and each one has an uncomfortable consequence you are entitled to know about first: it slows the start, it raises the initial price, or it narrows the kind of project I can take on. I keep them anyway, because the alternative cost — a project that sinks halfway — is higher for both of us.
Analysis first, then the price
A figure for the project arrives after I have seen the systems. The cost: the start is slower and there is an initial spend before you know the total. The advantage: the number you get is a number, not a bet to be renegotiated halfway.
The phases that decide the project stay with me
Development I delegate to a small network of people I have worked with for years, and it is a deliberate choice: it is what keeps costs sane and lets me increase the firepower on a project when it needs it. The cost: I run few projects at a time, so the calendar is one of the first things we discuss rather than the last. The advantage: the person deciding the technical things is the person you talk to, from analysis to acceptance.
Every delivery can be tried
No progress in percentages: at every milestone there is something you try. The cost: it takes your time and your people's time during the project, not only at the end. The advantage: if something is not the way you thought, you find out at milestone two rather than at final acceptance.
At the end you must be able to carry on without me
Code, documentation, architecture and credentials in your name, and the known weak points declared. The cost: writing the documentation is time that lands in the quotation. The advantage: you are free to change supplier, and it is also the reason a technical due diligence finds no surprises.
How you recognise it during the project
- You get an architecture document that also records the alternatives I rejected and why
- In the scope you find an explicit list of what the system will not do, not only of what it will
- At every milestone there is an environment to try things in, not a progress meeting
- When a flow errors, the system finds it and tells a person — not the customer on the phone
- At release the manual process is still live, and it is switched off when the new one has proved itself
- At closing you hold the repository, the credentials, the documentation and the list of known weak points
04 / Specifications
How the work is organised
The organisation, in detail
The operational information you need in order to know what working together is like, before signing anything.
Who does what
- Analysis
- I do it myself, in person, and on site where that is possible. It cannot be delegated: it is the phase where the steps nobody mentions are found.
- Architecture
- I do it. The choices and their limits are documented before a line of code is written.
- Development
- Me, with a small network of trusted people when the volume calls for it. I tell you that at quotation stage, not once the project has started.
- Code review
- I do it on every line that reaches production, their code included. No exceptions when we are in a hurry.
Communication
- Who you deal with
- One person, always the same: me. No account manager and no handover halfway through.
- Rhythm
- A short check-in every one or two weeks, tied to a milestone. Not progress meetings on a fixed calendar.
- Language and hours
- English for documents, code, commit messages and calls, on Central European Time. Calls are scheduled inside your working day, not mine, where the two differ.
- What I need from your side
- One person with the authority to decide on scope, and access to the people who touch the data every day.
- Bad news
- It arrives when I know it, not at the next meeting. A date that slips, reported late, costs twice.
Estimates and price
- How I estimate
- After the analysis, against the written scope. The durations are estimates declared as such, not contractual commitments.
- Shape of the quotation
- A fixed price for the project, split across milestones. Not an open hourly rate. Invoiced in euros.
- What moves the dates
- Rarely the code: it is how long access, credentials and answers take to arrive from the vendors of your own systems.
- If the numbers don't add up
- If the analysis shows the spend cannot be justified against the manual work it removes, I write that down and we stop.
Quality and release
- Environments
- Development, test and production kept separate. Acceptance is done on real data in a separate environment, not in production.
- Errors
- The flow does not stop on a bad row: it rejects it, logs it with the reason and warns a person.
- Auditability
- Logs of every run, readable by you: what went through, when, how many rows, which rejects.
- Release
- Gradual, with the previous process live as a safety net. It is switched off when the new one has proved itself on your data.
Included in every project
- Process analysis and a map of how data and documents actually move
- An architecture document with the reasoning, the alternatives rejected and the limits
- Development, testing and code review done by me on every line
- Error handling with readable logs and alerts that reach a person
- A gradual release with the previous process live as a safety net
- Technical documentation, handover of code and credentials, and an agreed post-release support period
Not included, and I say so up front
- Licences for your own systems and subscriptions to third-party services
- Hosting and infrastructure, which stay in your name
- Tax, legal or employment advice on the rules the software applies
- Extended staff training beyond the handover
- IT support on networks, workstations and devices
- Any promise of a financial result: it cannot be guaranteed and I don't make it
Which phases are mine
- Analysis
- Analysis: mine, in person, never delegated.
- Mine: sì · Delegated: no
- Architecture
- Architecture: mine, documented before any code is written.
- Mine: sì · Delegated: no
- Development
- Development: mostly delegated to a small network I have worked with for years, with me on it too when the project is small.
- Mine: in parte · Delegated: sì
- Code review
- Code review: mine on every line that reaches production, their code included.
- Mine: sì · Delegated: no
05 / Phases
Four phases, three of them mine
The four phases, one at a time
The durations are estimates to help you plan, not contractual commitments. No phase commits you to the next: you can stop after the analysis, and what you have received stays yours.
- 01
Analysis
I look at how people actually work, not how they are supposed to. I trace where data is born, where it is retyped and where it gets lost, and I check what the systems really expose instead of trusting the sales documentation.
- Cosa ricevi
- A map of the data flows and a list of the retyping points, quantified in hours.
- Durata
- 1–2 weeks (estimate)
- 02
Architecture
I define which systems talk, in which direction, how often and who wins in a conflict. I document the choices, the alternatives rejected and the limits before writing code, so you know what you are buying and what happens when something falls over.
- Cosa ricevi
- An architecture document with diagrams, stated limits and a release plan.
- Durata
- 1–3 weeks (estimate)
- 03
Development
In milestones you can verify, starting from the step that costs the most manual work and not from the easiest one. At every delivery there is something you can try. If a priority changes, it changes at the next milestone rather than mid-flight.
- Cosa ricevi
- Milestones you can try in a test environment, one at a time.
- Durata
- Varies by project
- 04
Code review and release
Every line that reaches production passes through my review, the network's code included. Then the release is gradual, with the previous processes still live until the new flow has proved itself on your data.
- Cosa ricevi
- The flow in production, logs running, documentation and credentials handed over.
- Durata
- 1–2 weeks (estimate)
The three phases I do personally are the first, the second and the fourth. That is not a convenient choice: they are the phases where a mistake does not show immediately and is paid for months later, and they are also the ones where responsibility cannot be transferred.
06 / Frequently asked
About the way of working
Questions about the method
The questions I get about how I work, rather than about what I do. If yours is missing, write to me.
01Why is the analysis paid for, and separate from the project?
Because a quotation given before looking at the systems is a bet, and bets are paid for either way: in change requests or in quality cut to stay inside the number. The analysis is a piece of work in its own right, with defined deliverables — a map of the flows, the manual work in hours, an architecture document — that stay yours even if you then build nothing with me, and that any other supplier can work from. It is also the phase in which I can tell you the project is not worth doing, and that happens.
02Who writes the code, concretely?
Analysis, architecture and code review I do myself and do not delegate. For development, when the volume calls for it, I rely on a small network of people I have worked with for years — and I tell you that at quotation stage, not once the project has started. Every line that reaches production passes through my review, theirs included, with no exceptions when we are in a hurry. The person you deal with is still me: there is no account manager in between, and one will not appear after signing.
03What do you need from us during the project?
Three things. One person with the authority to decide on scope, because without somebody who can say no the project grows until it eats the budget. Access to the people who touch the data every day, who are the ones who know how it really works. And the time it takes to get access and credentials from the vendors of your systems, which is the variable that moves the dates most: it is rarely the code that makes a delivery slip.
04How do you measure progress?
With things you can try, not with percentages. At every milestone there is a flow or a function in an environment you can reach, and you try it on your own data with the people who will use it. The cost of this approach is that it needs your time during the project and not only at final acceptance. The advantage is that a misunderstanding surfaces at milestone two, when correcting it is cheap.
05What happens if priorities change during the project?
They change at the next milestone, not mid-flight. Changing direction halfway through a milestone means throwing away work already done and destabilising every estimate after it, so the request is recorded and assessed at the delivery point: either it enters the scope with its impact on time and cost declared, or it goes into the backlog. What I don't do is accept silent changes and then present a slip as a surprise.
06How does the analysis work if we are in another country?
The same way, with one difference in the calendar. The analysis phase is the one part of a project that genuinely benefits from being in the room: watching somebody retype an order tells you more than an hour of describing it. So I travel for it, in a block of a few days rather than in scattered visits, and travel costs are agreed in advance rather than appearing on an invoice. If travel is not practical — a site that cannot host visitors, a schedule that doesn't allow it — the analysis can be done remotely with screen sharing and recorded sessions with the people who do the work. It is slower and it finds slightly less, and I say so rather than pretending the two are equivalent.
07What language are the documents in?
English, written in English rather than translated from Italian afterwards: the architecture document, the field mappings, the scope, the commit messages and the code comments. It matters more than it sounds, because those documents exist precisely so that somebody who is not me can pick the project up — and a document that has been machine-translated at handover is a document nobody trusts. If you also need an Italian version for a subsidiary or an auditor, that is a separate deliverable and it gets said in the quotation.
08What stays with us at the end of the project?
The source code, the technical documentation, the architecture document and the credentials to every service and piece of infrastructure, all in your name. No encrypted components, no usage licence that forces you to stay, no service that stops working if you stop working with me. I also hand over the list of known weak points: there are always some, and hiding them does not make them disappear — it only makes you find them at the worst moment.
09How do you handle the release into production?
Gradually, with the previous process still live as a safety net. First the new flow runs alongside it read-only and the results are compared with what already exists; then writing is enabled on one part; then on all of it. The manual process is switched off when the new one has proved itself on your data, not on the day of delivery. It costs a few extra weeks and it has avoided practically every operational stoppage that a switch-style release produces.
10How many projects do you run at once?
Few at a time, and it is a choice: analysis, architecture and code review stay with me, while for development I rely on a small network of trusted people, which is what lets me scale the firepower on a project without multiplying the projects. The calendar is one of the first things we discuss on the call, so you know straight away whether the timing matches yours. The advantage is that when I am working on your project I am actually there, and the person deciding the technical things is the person you talk to.
07 / Related
Where to go next
Where to go next
The method is the same across every kind of engagement. What changes is what gets built.
08 / Contact
Half an hour, no automated quotation
Let's see whether the method fits your case
We spend half an hour: you tell me where the work jams, I tell you whether it is a problem I know how to solve, how I would approach it and whether the spend makes sense against what it costs you today. If it is outside my perimeter I say so straight away, and if I know somebody better suited I pass on the name.
Or write to me: I answer, usually within one working day.
All the contact detailsHow the call works
- Length
- Thirty minutes, video call or phone, in English.
- Who is there
- Me. No salesperson, no handover afterwards.
- What I need
- To know which systems you run and where the work jams. No specification document, no defined budget.
- What you get
- An honest view on feasibility and order of magnitude. The quotation comes after the analysis, not before.