spec-plans-sync

Parse spec files to synchronize plan lifecycles and milestones.

Updated Jan 12, 2026
One-click install
npx skills add https://github.com/djalmaaraujo/claude-code-plugins --skill spec-plans-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-plans-sync
Source: https://github.com/djalmaaraujo/claude-code-plugins/tree/main/plugins/planner/skills/spec-plans-sync
Command: npx skills add https://github.com/djalmaaraujo/claude-code-plugins --skill spec-plans-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps implementation work aligned with evolving specs by parsing spec content, comparing it to existing plans, and updating or generating plans accordingly.

Core Features & Use Cases

  • Spec parsing: Reads the relevant sections from plans/[prefix]-spec.md such as Functional Requirements, Use Cases, and Milestones to guide plan generation.
  • Plan lifecycle management: Detects new plans, keeps matching existing plans, and deprecates plans no longer covered by the spec.
  • Milestones sync: Updates Section 6.2 Milestones in the spec to reflect the current set of plans and their execution order.

Quick Start

Provide a spec prefix to synchronize plans from the corresponding spec file.

Frequently Asked Questions about spec-plans-sync

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

FAQPage Schema
How do I sync implementation plans with evolving spec files?

To sync implementation plans with evolving spec files, parse the spec content to derive requirements and milestones, then compare them against existing plans to identify new, kept, and deprecated items for automatic updates.

What is the best way to automate plan generation from software engineering specs?

Automating plan generation from software engineering specs involves reading functional requirements and use cases from the spec file, then using a plan-creator agent to generate new plans and update the milestones section automatically.

How do I deprecate plans no longer covered by my spec?

To deprecate plans no longer covered by your spec, compare the current spec requirements against existing plans to detect obsolete items, then automatically handle their deprecation and update the milestones section accordingly.

Can I control parallel execution and verbosity during spec plan synchronization?

Yes, you can control parallel execution and verbosity during spec plan synchronization by configuring options like smart_parallelism and spec_verbose, which manage how the plan-creator agent runs and reports output.

Does spec plan synchronization update milestones in the spec file?

Yes, spec plan synchronization updates Section 6.2 Milestones in the spec file to reflect the current set of plans and their exact execution order after new plans are created and deprecated ones are handled.