Sync Status Skill

Checks current implementation status, detects differences with Plans.md, and suggests next action.

Quick Reference

• "How far have we progressed?" → this skill

• "What should I do next?" → organize and suggest

• "Check if Plans.md matches actual progress" → detect and update

Deliverables

• Progress check: Consistency between implementation and Plans.md

• Difference update: Update Plans.md markers to match reality

• Next action suggestion: What to do next with priority

Execution Flow

Step 1: Gather Current Status (Parallel)

Plans.md state

cat Plans.md

Git change status

git status git diff --stat HEAD~3

Recent commit history

git log --oneline -10

Agent Trace (直近の編集ファイル)

tail -20 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.files[].path' | sort -u

Step 1.5: Agent Trace Analysis

Agent Trace から直近の編集履歴を取得し、Plans.md のタスクと照合:

直近の編集ファイル一覧

RECENT_FILES=$(tail -20 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.files[].path' | sort -u)

プロジェクト情報

PROJECT=$(tail -1 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.metadata.project') PROJECT_TYPE=$(tail -1 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.metadata.projectType')

照合ポイント:

チェック項目 検出方法

Plans.md にないファイル編集 Agent Trace vs タスク記述

タスク記述と異なるファイル 想定ファイル vs 実際の編集

長時間編集がないタスク Agent Trace 時系列 vs WIP期間

Step 2: Detect Differences

Check Item Detection Method

Done but still cc:WIP

Commit history vs marker

Started but still cc:TODO

Changed files vs marker

cc:done but not committed git status vs marker

Step 3: Update Plans.md

If differences detected, suggest and execute:

📝 Plans.md update needed

Update? (yes / no)

Step 4: Output Progress Summary

📊 Progress Summary

Project: {{project_name}} ({{project_type}})

Progress rate: {{percent}}%

📄 直近の編集ファイル (Agent Trace)

• {{file1}}
• {{file2}}
• ...

Step 5: Suggest Next Action

🎯 What to do next

Priority 1: {{task}}

• Reason: {{requested / unblock}}

Recommended: /work, /harness-review

Anomaly Detection

Situation Warning

Multiple cc:WIP

⚠️ Multiple tasks in progress

pm:requested not processed ⚠️ Process PM's request first

Large gap ⚠️ Task management not keeping up