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.

The same six things, and how I handle them
MomentHow it usually goesHow I handle it
QuotationA 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.
ScopeA 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.
ProgressPercentages communicated in a meeting.Milestones you can try yourself, on your own data.
AnalysisQuestionnaires and video calls with whoever coordinates.Time on site with the people who touch the data every day, where that is possible.
ReleaseA 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.
ClosingThe 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: · Delegated: no
Architecture
Architecture: mine, documented before any code is written.
Mine: · 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:
Code review
Code review: mine on every line that reaches production, their code included.
Mine: · 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.

  1. 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)
  2. 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)
  3. 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
  4. 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.

01

Why 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.

02

Who 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.

03

What 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.

04

How 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.

05

What 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.

06

How 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.

07

What 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.

08

What 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.

09

How 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.

10

How 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.

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 details

How 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.