speckit-retrospec

Reverse-engineer speckit specification files from an already-implemented codebase feature.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/alkampfergit/cisharpai --skill speckit-retrospec-alkampfergit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-retrospec
Source: https://github.com/alkampfergit/cisharpai/tree/main/.claude/skills/speckit-retrospec
Command: npx skills add https://github.com/alkampfergit/cisharpai --skill speckit-retrospec-alkampfergit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams that adopted spec-driven development after writing code often have working features with no corresponding speckit specifications, leaving no documented design intent for future maintenance or audits. ## Core Features & Use Cases - Reverse-engineered spec generation: Analyzes existing source files, tests, and docs to produce spec.md, plan.md, data-model.md, contracts/, research.md, and quickstart.md inside a numbered specs/ directory. - Feature discovery with confirmation: Builds a feature map of core abstractions, provider implementations, models, and tests, then waits for user approval before generating artifacts. - Optional tasks.md: Skips task checklist generation by default; with the --tasks flag it emits a fully checked-off task breakdown mapped to real files. - Use Case: A .NET library ships a streaming chat feature without specs; run the skill with the feature name to generate a complete speckit bundle traceable to the actual code. ## Quick Start Ask the assistant to run /speckit-retrospec with a feature name like "streaming chat" to generate the speckit specification bundle from the existing implementation.

Frequently Asked Questions about speckit-retrospec

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

FAQPage Schema
How do I generate speckit specs for code that already exists?▼

Run /speckit-retrospec with a feature name, description, or file paths. The skill analyzes the implementation, presents a feature map for confirmation, then writes spec.md, plan.md, and supporting artifacts into a new specs/ directory.

What files does speckit-retrospec generate?▼

It generates spec.md, plan.md, data-model.md, contracts/, research.md, quickstart.md, and a requirements checklist. tasks.md is skipped by default and only created when you include the --tasks flag, with every checkbox pre-marked complete.

Does speckit-retrospec require a spec-kit project structure?▼

Yes, it requires a .specify/ directory with templates such as spec-template.md and plan-template.md. It also reads .specify/init-options.json for directory numbering and .specify/extensions.yml for before/after hooks.

Can I generate a tasks.md for an existing implementation?▼

Yes, include --tasks in the input. The skill produces the task breakdown that would have produced the implementation, with every checkbox marked [x] and each task mapped to the actual file that implements it.

What happens if a spec already exists for the feature?▼

The skill checks the specs/ directory for name similarity before writing. If a matching spec exists, it warns you and asks whether to overwrite the existing spec or create a new one.