done-retirement

name	done-retirement
description	Pipeline retirement protocol for completed work items. Implements a 7-stage validate-commit-push-submit-notify-cleanup-terminate pipeline with irreversibility after push. Done means gone.
type	skill
category	state
status	stable
origin	tibsfox
modified	false
first_seen	"2026-03-06T00:00:00.000Z"
first_path	.claude/skills/done-retirement/SKILL.md
superseded_by	null

Done Retirement

Pipeline retirement processor for the Gastown chipset. When a polecat finishes its work, the done retirement pipeline takes over -- it validates the work, commits and pushes the branch, creates a merge request, notifies the convoy and mayor, cleans up the workspace, and terminates the agent. In hardware terms, done retirement is the instruction retirement unit -- it takes completed instructions from the execution unit (polecat), writes results to the register file (shared repository), updates the reorder buffer (merge queue), and frees execution resources (workspace and agent slot).

Activation Triggers

This skill activates when:

• A polecat has completed execution and is ready to retire its work
• An agent's hook status transitions to completed
• A work item's status transitions to done
• A convoy needs to track individual bead completion

Core Capabilities

The 7-Stage Retirement Pipeline

Every retirement flows through seven stages in strict order. The pipeline has an irreversibility boundary at Stage 3 (Push). Before push, the retirement can be aborted and the bead returned to in_progress. After push, the process is irreversible -- the branch is in the shared repository and the workspace will be destroyed.

VALIDATE      COMMIT        PUSH          SUBMIT        NOTIFY        CLEANUP      TERMINATE
   |             |            |              |             |             |             |
   v             v            v              v             v             v             v
verify work   ensure all   push branch   create merge  send mail to  remove work   mark agent
is actually   changes are  to shared     request       convoy/mayor  directory     as idle or
complete      committed    repository    record in     and witness   and context   terminated,
(criteria     to working   (IRREVERSIBLE state                                    release
met)          branch       AFTER THIS)                                            resources

Stage 1 -- Validate:

Verify that the work is actually complete. The bead's acceptance criteria must be met before the retirement pipeline begins. Validation checks the work item's done criteria against the actual state of the working branch.

const state = new StateManager({ stateDir: '.chipset/state/' });

async function validateCompletion(): <> {
   workItem =  state.(beadId);
   hook =  state.(agentId);

  
   (!workItem || workItem. !== ) {
     { : , :  };
  }

  
   (!hook || hook. !== ) {
     { : , :  };
  }

  
   (workItem. !== agentId) {
     { : , :  };
  }

   { :  };
}