dev-session-closure

Dev Session Closure

This skill handles the proper closure of development sessions.

When to Use

• During /end command
• When finalizing a development session
• When computing final session status
• When clearing .current-session

Input

• sessionPath: Path to the current session (or read from .current-session)
• options:
  • triggerCommit: boolean - Whether to trigger git commits
  • triggerDocs: boolean - Whether to trigger documentation generation
  • triggerQuality: boolean - Whether to trigger quality check
  • modifiedFiles: string[] - List of files modified in session (for quality check)

Responsibilities

• Load session via session-manager
• Read session.md (and plan.md if needed) via artifact-fs-manager
• Compute final Status based on step completion:
  • All steps COMPLETED → COMPLETED
  • Some steps FAILED → FAILED
  • Some COMPLETED and some NOT_STARTED → PARTIALLY_COMPLETED
  • No plan exists (planning phase only) → READY
• Update session.md:
  • Status: Final computed status
  • End Time: Current timestamp
  • Duration: Calculated from Start Time
  • Last Updated: Current timestamp
• Optionally trigger (based on flags):
  • Git commits via git-and-docs skill
  • Documentation generation via git-and-docs skill
  • Quality report via dev-quality-report skill
• Clear .current-session content via session-manager

MUST NOT

• Modify plan.md content
• Execute development steps
• Re-run planning
• Modify source code

Process

Step 1: Load Session

1. Use session-manager to load current session
2. Verify session exists and is in a closeable state

Step 2: Read Session State

1. Use artifact-fs-manager to read session.md
2. Check if plan.md exists
3. Extract current Status
4. Extract all step statuses from "All Steps Overview"

Step 3: Handle Based on Current Status

If Status is PLANNING:

1. No steps to evaluate
2. Set Status to READY
3. Update timestamps only
4. Do NOT trigger commits, docs, or quality check
5. Suggest /run to execute