Skip to content

suboss87/FDEOps / skills/handoff

handoff

Verified

Transfer operation of a customer deployment with ownership, evidence and a tested support path. Use for handoff or an engineer rotation, not merely code delivery.

FileKindSize
.fde-generated.jsonconfig650 B
SKILL.mdskill md1.3 KB
agents/openai.yamlconfig207 B
references/close.mdmarkdown11.7 KB
references/encode-pattern.mdmarkdown7.9 KB
references/land.mdmarkdown14.4 KB
references/task-context.mdmarkdown6.6 KB

references/close.md

View on GitHub
# close - Transfer operations

**Context:** apply [task context and evidence](task-context.md) before using the named records below.

For a standalone handoff draft, use the supplied notes and project evidence; no customer record is required. The `fde handoff` CLI exports an existing record. Use it only when a record is selected, not to create one merely for a draft.

**Enter when:** the engagement is ending - the customer team must run this without the FDE.

**Read first:** for standalone work, use the supplied permitted operating notes, evidence and ownership; no engagement binding or CLI command is required. For a bound engagement, use bounded `fde handoff` or `fde resume`, then `fde recall <topic>` for relevant client patterns, earlier retrospectives, and missing evidence. Never initialize records merely to draft a handoff. Build the picture through relevant excerpts, not a full-directory load. Consult `terrain.md` only for code paths needed by the successor.

A handoff transfers the ability to operate the system, not just its files.

## Match the requested output

- **Draft a handoff:** return the operating summary, evidence and gaps from supplied context. Do not require a retrospective, initialized record or completed value measurement to produce a useful draft. Missing evidence limits readiness claims, not drafting. Follow steps 0, 3 and relevant operating details in 4, then check the draft as a lookup tool. Skip the closure-only steps and artifacts.
- **Assess readiness or close the engagement:** apply the close gates below. Reuse existing evidence and agreed acceptance rather than restarting the engagement.

Lead with what is being transferred, what the receiving team can demonstrably do, what is untested, and the next action with its owner or ownership gap. Label claims as **on record**, **proposed**, or **customer accepted** so a handoff reader can distinguish the saved history from an open recommendation and an accepted outcome. A document can be ready for review while operational handover remains incomplete.

## Method

**0. Find the operating gap.** Use supplied evidence to identify what still depends on the departing engineer. Ask “What will bite them when you’re gone?” only if the answer would change the handoff; do not repeat information already supplied.

**1. Closure only: the retrospective.** Work through, blame-free and specific:
- Did the real problem match the brief? (Compare `brief.md` vs `reality.md` - you have the receipts.)
- Which trust moments mattered?
- What did the codebase teach that `terrain.md` didn't know at the start?
- Which risk almost became real?
- Fix the class: sample up to five fixes from this engagement. For each, did the hazard sweep run, and did the same failure return? A failure that returned twice is a class; name the change that prevents it, or record it as an open risk with an owner.
- AI components: did they behave in production? What failure modes did the prototype hide? Is the team equipped to maintain them?

**1b. Closure/readiness assessment only: value + receipts gate (refuse green close if any fail):**
- Primary value bucket in `success.md` matches what the sponsor funded; at least one ledger row has **Measured** (not forever-`pending`) with evidence **and a named customer-side owner in Accepted by** for that bucket - or the retrospective explicitly records “not measured; sponsor accepted pending.” A measured-but-unaccepted number closes as `claimed`; say so in the retrospective rather than closing green on arithmetic nobody signed.
- The receiving team has accepted the operating responsibilities with a source. Critical operating capabilities (such as access, failure triage, recovery and disabling an AI action) are recorded as verified, failed or untested under the receiving team's intended access. Reuse applicable accepted ownership and drill evidence; a lookup exercise or a run using only the departing FDE's credentials is insufficient. Unresolved critical gaps prevent green closure.
- Audit receipt exists for the final shipped path (exceptions/operating map walked; cite file).
- Eval receipt: **n/a if no AI**, else final scoped eval result + operating owner and required human-review or bounded-automation authority recorded; kill switch / fallback named in `handoff.md`.
- Exit access and record disposition: list each grant the FDE or their agents hold in customer systems (accounts, API keys, OAuth grants, connectors, webhooks, scheduled jobs) with who revokes it and the check that should now fail. A revocation request is not revocation until that check fails. Record what happens to the local engagement record and raw source pulls: returned to the customer, kept with a named owner and retention period, or deleted and how. A vendor deletion request is not deletion. Unrevoked access to customer data prevents green closure.
- Use after launch: evidence, with its source, that the intended users still use the result after the first weeks, or a note that it was not checked. Name any group that has gone back to the old way and why. Missing use evidence is a recorded gap; it blocks green closure only when `success.md` depends on use.
- One line in the retrospective: which bucket moved, by how much, vs baseline.

**2. Closure only: the pattern.** Anything that happened here and may happen again - a compliance approach, a migration pattern, a stakeholder dynamic - is a candidate for the client's `patterns.md`. Use [encode-pattern](encode-pattern.md) to record applicability, counterexamples, and evidence. Cross-client generalizations need explicit approval and a user-chosen export destination under the applicable policy; closing an engagement does not authorize an automatic scan or export.

**3. The handoff.** Operational knowledge for the person woken at 2am, not technical documentation: the relevant observed failures, their recovery steps and any untested procedure · who holds the tribal knowledge · what each alert means · deploy and rollback in plain language. AI components additionally: model version, what normal output looks like (so drift is recognisable), fallback behaviour, who owns evaluation and corrective changes, and how to disable or contain the AI path using the supported fallback. Do not assume retraining is available or appropriate.

**3b. Stage the exit.** Transfer operations in three steps. Move to the next step only when its exit evidence exists; a date alone is not enough:

| Step | Who operates | Exit evidence |
|------|--------------|---------------|
| Run alongside | The customer runs it; the FDE fixes in the open | Several consecutive weeks with no FDE intervention |
| Shadow | The customer runs it; the FDE only watches and keeps a weekly list of missed issues | The customer's calls on anomalies match the FDE's calls several times in a row |
| Exit | The customer alone; one escalation channel remains | The last shadow list is empty; a check-in is booked months out |

Three assets must be rehearsed, not read: a one-page operating note (who watches which alert, which page for which incident, when to roll back); the eval set with a named maintainer and a refresh cadence; an incident playbook with a first response per failure class. Record each as `rehearsed by <name> on <date>` or `untested`. If the customer cannot reach exit, name managed operation as a priced line with its own scope; do not leave it as an open favor. Hold at least two customer relationships beyond the sponsor; a sponsor who leaves is the common cause of quiet churn.

**4. Transformation engagements - four extra answers in `handoff.md`:**
- Who owns AI governance after the FDE leaves? (Who can pull a model from production?)
- The response trigger: an agreed signal, threshold, observation window, owner and action. For example, a critical action-boundary failure can require pausing that path and investigating. Diagnose whether the cause is data, retrieval, configuration, integration or model behavior before choosing a correction; retraining is only one possible response.
- The operating model at scale: who coordinates twenty use cases across five teams?
- Decision authority for new use cases: intake, risk assessment, approver.

## Artifact

For a draft-only request, return the handoff in the requested format with evidence gaps and readiness status. Do not create retrospective or pattern artifacts. The following record destinations apply when closing a bound engagement under its write rules.

**`retrospectives/YYYY-MM-DD-<engagement>.md`** - one file per close, retaining dated lessons for targeted recall within this client. **`patterns.md`** - client pattern candidates and evidence. **`handoff.md`** - the 2am document, including the deployed revision, the policy, access, and ownership evidence current at handoff, and the exit access table with each revocation check. If the project reopens, use [land](land.md) to recheck these before dependent action; closure evidence remains historical.

## Checkpoint

**Check the handoff as a lookup tool.** Give the intended operator one realistic task, such as finding the owner and recovery steps for a failed run. Can they locate the answer and its source in the permitted handoff without your explanation? A reader finding the instructions is not proof they can execute them; verify operation separately in the agreed safe environment. Correct the passage they could not use, rather than adding a longer introduction.

If the operator is unavailable, a fresh reviewer can attempt the same lookup using only the permitted draft and task. Report this as a simulated clarity check, not operator validation, customer approval, or a green close. Claim independent review only if a separate reviewer actually performed it; identify the reviewer and evidence available. If none is available, perform a labeled self-check and report independent review as unperformed. Use one focused pass for a consequential handoff; do not add a committee or a second approval ritual.

For closure or readiness assessment, report to the FDE: did the engagement achieve `success.md` · 2-3 lessons that matter · is the pattern worth encoding · is the handoff complete or where are the gaps. Also: value bucket + audit receipt green; eval **n/a or green**. Pending Measured without sponsor acceptance = gap, not green close. Honest - a gap named now is cheaper than a callback in six weeks.

## Worked example

Acme, twelve weeks in, the FDE is rolling off.

Retrospective against the receipts: `brief.md` asked for monitoring, `reality.md` proved it was ownership - and the delta is the most useful paragraph in the file, because it is exactly the argument the next engagement will need.

The close gate bites in a useful way. The ledger shows detection at 12 minutes measured across two real incidents, but **Accepted by** is empty - Marco confirmed it in Slack, but Denise, the recorded acceptance owner, has not accepted the result. Her authority comes from the agreed acceptance record, not her finance title or the fact that she raised the original problem. So it closes as `claimed` with a one-line retrospective note and a named next step, rather than a green close on a number the agreed acceptance owner has not accepted.

`handoff.md` is written for the person woken at 2am: the observed failure modes, what the page means, how to re-run manually the way Marco does, and who holds the tribal knowledge (Raj, who built the original job - credited, because he protects it now). `patterns.md` gets *"unowned job" presents as "unmonitored job"* - it has now happened twice.

## Principles

- Done = the customer operates without you, and none of your access remains.
- No named value bucket moved (or sponsor-accepted pending) = not a green close.
- The retrospective is an investment in the next engagement, not a post-mortem.
- Encode what repeated. The same lesson learned twice is a process failure.
- Write the handoff for 2am.
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall