team-shinchan-resume

name	team-shinchan:resume
description	Use when you need to resume an interrupted workflow from where it left off.
user-invocable	true

team-shinchan:resume

Resume a paused/interrupted workflow by loading saved state and delegating to the appropriate agent.

Step 0: Input Validation

If DOC_ID not provided:

Big projects (nested bigproject): Scan .shinchan-docs/*/PROJECT.yaml, filter current.status: active|paused|blocked. For each, collect project_id, title, current.active_phase, and the phase count from phases[]. These are resumed as a unit (see Step 0.5).

Active/Paused workflows: Scan .shinchan-docs/*/WORKFLOW_STATE.yaml (exclude archived/ subfolder), filter status: active|paused. Suppress any workflow that is a project child — i.e. its current.parent_doc_id is set, or its DOC_ID matches {project_id}-phase-* for a project listed above — so phases don't appear twice.

Archived workflows: Scan .shinchan-docs/archived/*/*/WORKFLOW_STATE.yaml, collect all entries.

Display combined output:

Projects:
  P1. {project_id} — {title} (phase {active_phase}/{total}, {status})
  ...

Active/Paused:
  1. {DOC_ID} ({status}, {stage})
  ...

Archived:
  A1. {DOC_ID} (expired, {stage}, archived {YYYY-MM})
  ...

If all lists empty: suggest /team-shinchan:start.

Step 0.5: Resume a Project (Conditional)

If the user selects a P# project entry: resume = re-enter the bigproject phase loop.

1. Read .shinchan-docs/{project_id}/PROJECT.yaml.
2. Find the first phase with status != complete (in execution_order if present, else by n).
3. If that phase's child workflow already exists and is mid-flight (.shinchan-docs/{project_id}-phase-{n}/WORKFLOW_STATE.yaml with status active/paused), resume that child via Steps 1–5 below (using its DOC_ID), then return to the loop. Otherwise start the phase fresh per skills/bigproject/SKILL.md Step 5.
4. Continue executing bigproject Step 5 (phase loop) and Step 6 (completion) on the main thread from that phase onward. Do NOT delegate the whole project to a sub-agent.

Standalone (non-project) selections continue with Steps 1–5 unchanged.

If user selects an archived entry:

1. Move .shinchan-docs/archived/{YYYY-MM}/{DOC_ID}/ → .shinchan-docs/{DOC_ID}/
2. In WORKFLOW_STATE.yaml: set status: paused
3. Add history event:

   - timestamp: "{ISO now}"
     event: unarchived
     agent: shinnosuke
     unarchived_at: "{ISO now}"
   

4. Proceed to Step 1 with the unarchived DOC_ID

If DOC_ID provided directly:

• Check .shinchan-docs/{DOC_ID}/ first, then .shinchan-docs/archived/*/{DOC_ID}/
• If found in archived: unarchive (steps 1-3 above) before proceeding
• Error if not found anywhere: list available workflows

Step 1: Load Context

1. Read .shinchan-docs/{DOC_ID}/WORKFLOW_STATE.yaml
   • Not found: error with list of available DOC_IDs
   • status: completed: inform user, suggest /team-shinchan:start
   • status: blocked: show blocker reason
2. Extract: current_stage, current_phase, current_owner

Step 1.5: Load Handoff State (Conditional)

Check if .shinchan-docs/pre-compact-state.json exists (using Read tool).

If file exists and readable: Parse the JSON and prepend the following block to the context header output in Step 4:

[Handoff] Completed: {completed_phases} | Pending: {pending_phases}
Last Decision: {last_decision|none}
Blocking Issues: {blocking_issues|none}

• completed_phases: array → join with ,; string → display as-is
• last_decision: null → display none
• blocking_issues: null → display none

If file does not exist or Read fails: skip silently. Proceed to Step 2 without error.

If JSON parse fails (malformed content): skip silently. Proceed to Step 2 without error.

Step 1.6: Load JSONL Checkpoint (Conditional)

Check if .shinchan-docs/{DOC_ID}/work-tracker.jsonl exists (using Read tool). If not found, also check .shinchan-docs/work-tracker.jsonl as fallback.

If file exists:

Read the last 32KB of the file (tail approach — do NOT read the full file to avoid memory issues on large JSONL logs). Scan lines in reverse order (last line first) for the first entry matching:

• "event": "phase_complete" or "event": "task_complete"

If a matching entry is found, parse it and store as {jsonl_checkpoint}.

Prepend the following block to the Step 4 output header (before the separator line):

[Checkpoint] Last: {jsonl_checkpoint.event} | Phase: {jsonl_checkpoint.phase|N/A} | Task: {jsonl_checkpoint.task|N/A} | At: {jsonl_checkpoint.timestamp|unknown}

If file does not exist: skip silently. Proceed to Step 2 without error.

If Read fails or no matching event found: skip silently. Proceed to Step 2 without error.

If JSON parse fails on a line: skip that line, continue scanning backward.

Step 1.7: Backfill Missing ak_gate Block (Conditional)

Check if current.ak_gate is present in the loaded WORKFLOW_STATE.yaml.

Do NOT overwrite existing ak_gate values. This step only fills in absent fields.

If ak_gate is entirely absent: write the following default block under current:

ak_gate:
  requirements:
    status: pending
    retry_count: 0
    last_rejection_reasons: []
  planning:
    status: pending
    retry_count: 0
    last_rejection_reasons: []

If ak_gate is present but missing sub-fields (e.g., requirements exists but planning is absent, or vice versa): add only the missing sub-fields using the same defaults above. Do NOT modify any sub-fields that already exist.

If ak_gate is fully present with both requirements and planning: skip silently. No changes needed.

After any write, proceed to Step 2 without error.

Step 2: Load Documents

• Always: Read .shinchan-docs/{DOC_ID}/REQUESTS.md (warn if missing)
• If stage >= planning: Read .shinchan-docs/{DOC_ID}/PROGRESS.md
• If requirements stage with current.interview: extract step/collected_count/last_question for Nene handoff

Step 3: Update State

Add resumed event to history, set status: active.

Step 4: Output Status

If handoff state was loaded in Step 1.5, prepend the [Handoff] block before the separator:

[Handoff] Completed: 1,2 | Pending: 3
Last Decision: Use regex-only parser for PROGRESS.md
Blocking Issues: none
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▶️ Workflow Resumed: {DOC_ID}
Stage: {current_stage} ({n}/4) | Phase: {current_phase|N/A} | Owner: {current_owner}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

If no handoff state (file absent or parse failed):

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▶️ Workflow Resumed: {DOC_ID}
Stage: {current_stage} ({n}/4) | Phase: {current_phase|N/A} | Owner: {current_owner}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Step 5: Delegate to Agent

Stage	Agent	Model	Context
requirements	Nene	Opus	REQUESTS.md + interview state
planning	Nene	Opus	REQUESTS.md + PROGRESS.md
execution	Bo/Specialist	Sonnet	REQUESTS.md + PROGRESS.md + phase tasks
completion	Bo + Action Kamen	Sonnet + Opus	All docs

Execution routing: frontend -> Aichan, backend -> Buriburi, infra -> Masao, default -> Bo.

Task(subagent_type="team-shinchan:{agent}", model="{model}",
  prompt="Resume {DOC_ID}. Stage: {stage}, Phase: {phase}.\n{context}\nContinue from: {last_action}")

Error Recovery

Error	Recovery
Missing folder	List available workflows
Corrupted YAML	Default: execution, owner: bo, phase: 1
Missing REQUESTS.md	Suggest /team-shinchan:start

Rules

• Always execute, always read WORKFLOW_STATE.yaml first
• Never skip state update, never invoke agent without context, never continue if completed