Draft Substantial Completion
Draft the certificate, and check whether the date it claims is real
Once installed, type /draft-substantial-completion in Claude Code to run it.
Install just this one
npx archtmpl@latest --command draft-substantial-completion --globalFirst time? The whole install, step by step
- Open Claude Code — the terminal version or the desktop app, either one.
- In a terminal, paste the line above and press Enter. In the app, paste it into the chat and ask Claude to run it.
- Restart Claude Code. That's the whole install.
Set up plugins for me: run `claude plugin marketplace add https://archaiflow.com/plugins/marketplace.json` and then `claude plugin install draft-substantial-completion@archaiflow`Paste into the Code tab (not Chat or Cowork) and approve when Claude asks. The third-party marketplace it mentions is this site. Windows may ask to install Git once.
What this command does
Draft Substantial Completion
Substantial completion is a date with more consequences attached to it than any other in the project, and it is routinely certified because the building looks finished. The certificate is a professional act with liability behind it, and the question it answers is not whether the work looks done.
Inputs the command needs
- The contract definition, quoted, plus every clause that runs from the date: warranties, insurance transfer, liquidated damages, retainage, final payment, the correction period.
- The claimed date, and what the contractor offers in support.
- The punch list, with each item's status.
- Regulatory status: certificate of occupancy or its equivalent, fire department sign-off, elevator, health, whatever this project needs.
- What the owner intends to do on and after the date.
Workflow
Step 1 — Quote the definition, then test against it
State the contract's definition verbatim. Then, item by item, test what has been achieved against each element of that definition. Not against whether the building looks complete.
Most definitions turn on the owner being able to occupy or use the work for its intended purpose. That is a functional test, and it is answered by asking what the owner cannot do yet.
Step 2 — Sort outstanding work into two
| Item | Bars the date | Goes on the list only | Why |
|---|
The distinction is the whole exercise. Work bars the date when it prevents the owner using the work for its intended purpose, or when a regulatory approval depends on it. Everything else goes on the list.
Count both. If anything bars the date, say plainly that the certificate cannot be drafted for the claimed date and name what has to happen.
Step 3 — Check the regulatory position separately
A certificate of occupancy that has not been issued is not a punch list item. List every required approval, its status, and what it gates. Where an approval is conditional, list the conditions and who discharges them.
An occupancy approval outstanding almost always bars the date, whatever the building looks like.
Step 4 — Set out what the date moves
From the quoted clauses, list every consequence with its period:
| What shifts | From the contract clause | Period | Who is affected |
|---|
Cover at least: warranty commencement, the correction period, insurance transfer from builder's risk to the owner's, liquidated damages stopping, retainage reduction, utilities and maintenance transfer, security responsibility, the final payment sequence.
Leave every period as quoted, never recalled. Say plainly that the owner should confirm insurance is in place before the date, because the gap between builder's risk ending and the owner's policy starting is a real and expensive one.
Step 5 — Draft, or say why not
If nothing bars the date, draft the certificate in the form the contract requires, with the date, the list attached, and the consequences stated.
If something bars it, do not draft. Produce instead: what bars it, what would clear it, and what a realistic date looks like given that.
If the parties disagree, set out both positions with the evidence for each and say plainly that the certificate is the Architect's determination and not a negotiation.
Step 6 — Report and save
Counts of barring and non-barring items, the regulatory position, the consequences table, then the draft or the reason there is none.
Ask whether to write it to a file and where.
Rules
- Never supply a definition, a form, or a period. All from the executed agreement, quoted.
- Test against the contract definition, never against appearance.
- Sort every outstanding item into bars or does not bar, and give a reason.
- Treat regulatory approvals separately from punch items.
- Never draft a certificate when something bars the date.
- Never write the words certify or certified. That is the Architect of Record's act.
- Name the insurance gap on every run.
Anti-patterns
- Drafting because the building looks finished.
- Recalling a warranty period or a correction period.
- Putting an outstanding occupancy approval on the punch list.
- Treating a long punch list as barring, or a short one as clearing.
- Backdating to suit a payment application.
- Presenting the date as agreed when the parties disagree.
- Issuing without saying what the date moves.
What it does not check
What this does. Establishes the contract's own definition, tests what has been achieved against that definition rather than against appearance, sorts the outstanding work into what bars the date and what does not, and sets out everything the date shifts.
What this does not do.
- It carries no definition and no form. What substantial completion means, which certificate form is required, and what periods run from the date all come from the executed agreement, quoted. Contract families define it differently and the differences matter.
- It does not certify. Certification is the Architect of Record's act.
- It does not decide the date. It tests a claimed date against the quoted definition and reports what does not meet it.
- It does not produce the punch list.
punch-listdoes, and this reads it. - It does not track closeout deliverables.
closeout-checkdoes. - It does not resolve a dispute about the date. Where the contractor claims one date and the evidence supports another, it sets out both and the gap.
What you need before starting. The executed agreement's definition of substantial completion and everything the contract makes contingent on it. The claimed date and what supports it. The punch list. The status of every regulatory approval required for occupancy. The owner's intended use.