skills.rest
datamonsterr
datamonsterrCOMMUNITY
Explore all skills by this author →
GitHub

speckit-sync-propose

Generate drift-resolution proposals for spec and code divergences.

Updated Apr 12, 2026
Search Tags:#proposals#spec#drift#analyze#backfill#propose#align
One-click install
npx skills add https://github.com/datamonsterr/mycoai_projects --skill speckit-sync-propose
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-sync-propose
Source: https://github.com/datamonsterr/mycoai_projects/tree/main/.agents/skills/speckit-sync-propose
Command: npx skills add https://github.com/datamonsterr/mycoai_projects --skill speckit-sync-propose

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Propose drift-resolution strategies for each divergence identified during speckit.sync.analyze to update specs or align code.

Core Features & Use Cases

  • Generate Backfill proposals to update specs when code has evolved beyond the spec.
  • Generate Align proposals to enact code changes when the spec is authoritative.
  • Include a Human Decision option with questions and trade-offs for ambiguous cases.
  • Produce a Drift Resolution Proposals document and a machine-friendly proposals file for tooling.

Quick Start

Provide drift data and run the speckit.sync.propose command to generate drift-resolution proposals.

Frequently Asked Questions about speckit-sync-propose

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

FAQPage Schema
How do I propose drift resolutions to align code and spec?▼

Use speckit-sync-propose to generate drift-resolution strategies from a drift-report.json file. It produces backfill, align, or human-decision proposals and saves them to proposals.md and proposals.json for review and automation.

What is spec drift and when do I need to backfill or align code?▼

Spec drift occurs when implementation diverges from documentation. You need backfill proposals to update specs when code has evolved beyond them, or align proposals to modify code when the spec remains authoritative.

How do I generate machine-friendly proposals for spec drift automation?▼

Run the sync.propose command on your drift data to generate a machine-friendly proposals.json file alongside a proposals.md document, enabling automated tooling to consume and execute the recommended drift resolutions.

Can I resolve ambiguous spec drift cases automatically or do they need human decision?▼

Ambiguous spec drift cases require human decision rather than automatic resolution. The system includes a human decision option that outlines specific questions and trade-offs for ambiguous divergences instead of forcing an automatic backfill or align action.

What format does the drift report need to be in for spec alignment proposals?▼

The drift report must be stored as a JSON file at .specify/sync/drift-report.json. This file provides the analyzed divergence data required to generate the corresponding Drift Resolution Proposals document and machine-friendly JSON output.

Related Skills

Explore More Software Engineering Skills→
B0yZ4kr14B0yZ4kr14

speckit-sync-propose

Propose resolution actions for drifted and missing spec-kit requirements.

Community
Intermediate
B0yZ4kr14B0yZ4kr14

speckit-sync-apply

Apply approved drift proposals to Specify specs and generate alignment tasks.

Community
Advanced
B0yZ4kr14B0yZ4kr14

speckit-sync-analyze

Compare spec-kit requirements against implementation artifacts and generate Markdown and JSON drift reports.

Community
Intermediate
oalansilvaoalansilva

org-standardization

Collect engineering standards and produce a standardization proposal and implementation plan.

Community
Intermediate