ship

Delete terminal FEAT and DISC session traces after human confirmation.

1|Updated May 3, 2026
One-click install
npx skills add https://github.com/gaabscps/ai-squad --skill ship-gaabscps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/gaabscps/ai-squad/tree/main/shared/skills/ship
Command: npx skills add https://github.com/gaabscps/ai-squad --skill ship-gaabscps

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Removes a finished session's runtime trace after human confirmation, ensuring the workspace remains clean and avoiding accidental retention of runtime data.

Core Features & Use Cases

  • Cross-squad cleanup for FEAT and DISC sessions by deleting terminal session traces only after explicit confirmation.
  • Guards against active work by ensuring current_phase is terminal (done, paused, escalated) before deletion.
  • Provides a clear pre-deletion summary and a human-in-the-loop confirmation step to prevent unintended data removal.

Quick Start

Confirm a terminal session cleanup by providing the spec_id (e.g., FEAT-NNN or DISC-NNN) and confirming the action to remove its runtime trace.

Frequently Asked Questions about ship

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

FAQPage Schema
How do I safely clean up terminal session runtime traces after completion?

To clean up terminal session runtime traces, you must enforce a precondition check on session.yml to verify the session reached a terminal state, then securely remove the .agent-session directory after explicit human confirmation.

What happens if I try to delete a runtime trace for an active session?

Deleting an active session's runtime trace is blocked by a precondition check on session.yml, ensuring current_phase is terminal (done, paused, escalated) before allowing secure removal of the .agent-session directory.

How do I remove an .agent-session directory for a finished FEAT or DISC session?

To remove an .agent-session directory, provide the spec_id for a finished FEAT or DISC session, review the pre-deletion summary, and submit explicit confirmation to securely delete the associated runtime trace.

Can I automate workspace cleanup without a human-in-the-loop confirmation step?

Workspace cleanup cannot be automated without confirmation, as securely removing the .agent-session trace requires a human-in-the-loop confirmation step to prevent unintended data removal.

When should I use cross-squad session cleanup to clear runtime data?

Use cross-squad session cleanup to clear runtime data when FEAT or DISC sessions have reached a terminal state, ensuring the workspace remains clean and avoiding accidental retention of finished runtime traces.

Does terminal session cleanup require any external dependencies or component installations?

Terminal session cleanup requires no external dependencies or component installations, relying solely on internal precondition checks against session.yml and human confirmation to securely remove the .agent-session directory.