speckit-sync-backfill

Generate backfilled specifications, plans, and review scaffolding from existing code.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-sync-backfill-b0yz4kr14
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-sync-backfill
Source: https://github.com/B0yZ4kr14/OrthoPlus-Enterprise/tree/main/.specify-backups/20260518-141826/_agents/skills/speckit-sync-backfill
Command: npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-sync-backfill-b0yz4kr14

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Backfilling specs becomes hard when features exist in code but there is no formal specification, making alignment, onboarding, and future changes slower and riskier.

Core Features & Use Cases

  • Generate a complete backfilled specification by extracting intent from implementation, tests, and documentation.
  • Infer user stories and functional requirements based on discovered command/service behaviors and test scenarios.
  • Produce supporting artifacts including a spec scaffold, a review task, and optional structure to guide implementation understanding.

Quick Start

Use speckit-sync-backfill with a feature name or file path to generate a backfilled spec from the current implementation.

Frequently Asked Questions about speckit-sync-backfill

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

FAQPage Schema
How do I backfill missing feature specifications from existing code?

Backfilling missing feature specifications from existing code involves extracting behaviors from method signatures, validations, business logic, and test scenarios to infer undocumented user stories and functional requirements. This process generates a full spec scaffold and review task from the discovered implementation.

What is the best way to generate user stories from an undocumented codebase?

Generating user stories from an undocumented codebase requires inferring requirements from discovered command and service behaviors, mapping extracted method signatures and test scenarios into functional requirements. This creates a structured specification scaffold with a backfill notice indicating the documentation was reverse-engineered.

Can I extract functional requirements from test scenarios and method signatures?

Yes, extracting functional requirements from test scenarios and method signatures is possible by analyzing discovered validations and business logic. The extracted behaviors are mapped into functional requirements, CLI command implications, and success criteria to build a comprehensive backfilled specification.

How do I create codebase documentation for features that exist but have no specs?

Creating codebase documentation for unspecced features involves reverse-engineering the implementation to produce a spec scaffold and review task. It uses discovered tests and docs to infer the original intent, ensuring alignment and onboarding for future changes are faster and less risky.

Does spec backfilling work for extracting requirements from CLI commands and services?

Spec backfilling works for extracting requirements from CLI commands and services by discovering their behaviors and mapping them into functional requirements and CLI command implications. It infers user stories from the implementation and test scenarios to generate a complete specification.

When should I not use codebase documentation extraction for requirements?

You should not use codebase documentation extraction when the implementation lacks clear method signatures, validations, or test scenarios to infer behaviors from. Without discoverable commands or business logic, generating accurate functional requirements and user stories becomes unreliable.