plan-sync

Synchronize plan documents with implementation status from conversation and code changes.

Updated Jul 8, 2017
One-click install
npx skills add https://github.com/mczkzk/dotfiles --skill plan-sync
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: plan-sync
Source: https://github.com/mczkzk/dotfiles/tree/main/dot_claude/skills/plan-sync
Command: npx skills add https://github.com/mczkzk/dotfiles --skill plan-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

πŸ’‘ This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automatically updates your plan documents to reflect the actual progress and changes made during implementation, ensuring your plans are always up-to-date without manual effort.

Core Features & Use Cases

  • Automatic Plan Updates: Seamlessly marks tasks as complete, adds new ones, modifies existing ones, and removes obsolete tasks based on conversation context and codebase analysis.
  • Evidence-Based Changes: All updates are backed by evidence from conversation logs and code changes (git diff, grep, glob).
  • Use Case: After a coding session, run this Skill to automatically update your plan.md file, marking completed user stories and adding any new tasks that emerged during development, ensuring accurate project tracking.

Quick Start

Run the plan-sync skill to update the current feature's plan document based on recent development activity.

Frequently Asked Questions about plan-sync

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

FAQPage Schema
How do I automatically update a plan document based on git changes?β–Ό

You can automatically update a plan document by analyzing conversation context and codebase changes like git diffs. This Skill marks tasks complete, adds new ones, and removes obsolete items in your markdown plan files.

How does synchronizing project plans with codebase implementation work?β–Ό

Synchronizing project plans with implementation works by reading conversation history and analyzing code changes via git, grep, and glob tools. It then rewrites markdown plan files to accurately match actual development progress.

Can I use this to track user stories in markdown after a coding session?β–Ό

Yes, you can use this to track user stories in markdown after a coding session. It applies to software development workflows for maintaining accurate task tracking by updating existing plan documents with evidence-based changes.

Do I need git to synchronize my plan with the current implementation status?β–Ό

You need tools for reading conversation history and analyzing code, which includes git, grep, and glob. These dependencies are required to gather the evidence needed for updating your plan documents accurately.

What is the best way to keep task tracking accurate during software development?β–Ό

The best way to keep task tracking accurate is to use evidence-based synchronization. This Skill backs all plan updates with evidence from conversation logs and code changes, ensuring your plans reflect actual progress without manual effort.

Why are obsolete tasks not being removed from my plan document automatically?β–Ό

Obsolete tasks may remain if the Skill cannot gather sufficient evidence from conversation logs or codebase changes. It relies on analyzing conversation context and code via git, grep, and glob to identify and remove outdated tasks.