swain-teardown

Audit session artifacts with orphan worktree detection and git dirty-state checks.

1|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/cristoslc/south-portland-school-budget-FY27 --skill swain-teardown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swain-teardown
Source: https://github.com/cristoslc/south-portland-school-budget-FY27/tree/main/.agents/skills/swain-teardown
Command: npx skills add https://github.com/cristoslc/south-portland-school-budget-FY27 --skill swain-teardown

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps session artifacts clean at close by performing structured teardown checks that detect orphan worktrees, warn about uncommitted changes, and ensure session tickets and handoffs are properly captured.

Core Features & Use Cases

  • Orphan worktree detection with safety checks to avoid accidental removals.
  • Git dirty-state check to surface uncommitted changes before ending a session.
  • Ticket sync prompt to verify that tickets reflect work completed, without auto-updating tickets.
  • Handoff summary: append a session report to SESSION-ROADMAP.md for audit and continuity.

Quick Start

Run the teardown skill at session end to perform hygiene checks and generate a handoff summary.

Frequently Asked Questions about swain-teardown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clean up orphan git worktrees before ending a development session?

A session teardown process detects orphan git worktrees by auditing session artifacts and applying safety checks. It validates rules and prompts for human confirmation before removing any worktree resources, preventing accidental deletions at session close.

How do I check for uncommitted changes and generate a handoff summary when closing a git session?

Checking for uncommitted changes and generating a handoff summary during a git session close involves running a teardown workflow. This workflow performs git dirty-state checks to surface uncommitted changes and appends a session report to SESSION-ROADMAP.md for audit continuity.

What is a session teardown workflow and when do I need it for git worktree management?

A session teardown workflow is a structured hygiene check process for repositories using git worktrees and session state data. You need it during session close workflows to detect orphan worktrees, surface uncommitted changes, and prompt ticket synchronization before handing off.

Does the session teardown automatically update my project tickets to reflect completed work?

The session teardown does not automatically update your project tickets. It provides a ticket-sync prompt to verify that your tickets manually reflect the work completed, ensuring accuracy without forcing auto-updates to your external tracking system.

Can I use this teardown workflow on repositories without swain session state data?

This teardown workflow applies specifically to repositories containing swain session state data and git worktrees. It relies on session JSON data to perform its audits, so repositories lacking this specific session state format will not be fully supported.