The Maintainable AI
The Handoff Desk

A Complete Revision-Control System for Client Deliverables

A Complete Revision-Control System for Client Deliverables
Lost versions and unclear approval status create repeated work and client friction. This article provides a complete, lightweight revision-control system that freelancers and small agencies can maintain without specialized software.

Few experiences are more frustrating than discovering that the file you just edited is not the version the client last approved, or that a client is reviewing an outdated draft while a newer one sits in a different folder. In small practices these mix-ups are common because revision control is often left to memory, email subject lines, or inconsistent file names.

A complete revision-control system does not require enterprise software. It requires a consistent naming habit, a single visible log, and a clear rule for what “current” means. This article describes a system that freelancers and small agencies can run with ordinary document storage and a simple tracking sheet.

Few experiences are more frustrating than discovering that the file you just edited is not the version the client last approved

Why Revision Problems Persist in Small Practices

The root causes are structural rather than personal.

Multiple Channels Create Multiple Copies

Deliverables travel through email, shared drives, project tools, and sometimes messaging apps. Each channel can produce its own copy. Without a single designated home for the authoritative version, people reasonably assume the copy in front of them is current.

Approval Is Often Informal

A client reply that says “looks good” may refer to an earlier draft, a partial section, or a version that was later revised. When approval is not tied to a specific file identifier, the record of what was accepted remains ambiguous.

Naming Conventions Drift Under Deadline Pressure

Even teams that start with a clear naming system gradually introduce exceptions—“final,” “final2,” “really-final,” dates in different formats, initials added inconsistently. Drift makes sorting and searching unreliable exactly when speed is most needed.

The Three Pillars of a Maintainable Revision System

The system rests on three simple, interlocking practices.

Consistent File Naming That Encodes Version and Status

Every deliverable file name includes the project short name, the deliverable name, a version number, and a status marker. Example: ProjectX_StrategyMemo_v03_Review. The version number increments with every substantive change. The status marker is limited to a short fixed list: Draft, Review, Approved, Superseded. This naming makes the state of a file visible without opening it.

A Single Revision Log per Project

Alongside the files, maintain a short log—one spreadsheet tab or one document table—with columns for version number, date, what changed, who sent it, and current status. The log is the human-readable history. When there is any doubt, the log is consulted before the files are opened. Keeping the log in the same folder as the deliverables ensures it is found when it is needed.

One Designated Current Location

All working and approved versions live in one project folder or one shared drive location. Email attachments and downloads are treated as temporary copies only. The rule is simple: if it is not in the designated location with the correct name and log entry, it is not the authoritative version. This rule eliminates most “which file is current” conversations.

Operating the System Day to Day

The system only works if the habits are light enough to survive busy weeks.

Creating a New Version

When a substantive change is made, save a new file with the incremented version number and updated status marker. Add a one-line entry to the revision log describing the change in ordinary language. Do not overwrite previous versions. Overwriting destroys history that is often needed later for client questions or internal learning.

Sending a Version for Review

Before sending, confirm that the file name and the log entry both show status Review. In the email or message, refer to the version number explicitly: “Attached is StrategyMemo v03 for your review.” Explicit reference ties the client’s later comments to a specific artifact and prevents ambiguity.

Recording Approval

When the client approves, update the log status to Approved and, if useful, rename the file status marker to Approved. If the client requests changes, increment the version, record the request in the log, and repeat the review cycle. Never mark a file Approved on the basis of a vague or partial comment.

Handling Exceptions and Edge Cases

Real projects produce situations the basic rules must accommodate.

Partial Approvals

When a client approves some sections and requests changes to others, record the partial approval in the log with a clear note about which parts are accepted. Create the next version only for the sections that need work, and state in the log what was carried forward unchanged. This prevents the approved material from being accidentally reopened.

Parallel Work by More Than One Person

If two people must edit at the same time, agree in advance who owns the version number sequence. The other person works in a clearly named copy and merges changes into the next official version. Parallel editing without a single owner of the version sequence is the fastest way to lose control.

Client-Supplied Edits

When a client returns a file with their own changes, save their version into the designated location with a note in the log (“Client-returned edits on v03”) and then produce the next official version that incorporates or responds to those edits. Treating the client’s file as the new authoritative version without logging it creates gaps in the history.

If two people must edit at the same time, agree in advance who owns the version number sequence

Maintenance and Common Failure Points

A revision system erodes when certain shortcuts become normal.

Skipping the Log Entry Under Time Pressure

The safeguard is to treat the log entry as part of saving the file, not as an optional extra. A version without a log entry is incomplete. Making the entry a required step prevents the history from developing silent holes.

Allowing Status Markers to Multiply

When people invent new status words—AlmostFinal, ClientReady, InternalOnly—the system loses clarity. The safeguard is a fixed list of four or five markers and a refusal to accept files that use unlisted words. Consistency is more valuable than expressive variety.

Letting Email Become a Parallel Repository

The safeguard is a standing rule that email attachments are never the authoritative copy. After sending, the authoritative file remains in the designated location. After receiving client comments, the comments are transferred into the next version and the log; the email itself is not treated as the record.

A complete revision-control system does not eliminate the need for careful communication with clients. It makes the artifacts of that communication traceable and reduces the time spent reconstructing what was sent and what was accepted. For freelancers and small agencies, the combination of disciplined naming, a single visible log, and one designated current location provides most of the benefit of formal version control without the overhead of specialized tools. The system stays maintainable because each step is small and the rules are few.

Make it useful. Make it checkable. Make it easy to fix.

Updated · 2026-10-10 15:00
Feedback

No feedback yet — submit the first.

Submit feedback
© 2026 themaintainableai.com. All rights reserved. data-driven, published weekly ♥