spec-engineer

Create, reverse-engineer, or update living feature specs from code.

29|4|Updated Nov 22, 2025
One-click install
npx skills add https://github.com/villetakanen/asdlc-io --skill spec-engineer-villetakanen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-engineer
Source: https://github.com/villetakanen/asdlc-io/tree/main/.agents/skills/spec-engineer
Command: npx skills add https://github.com/villetakanen/asdlc-io --skill spec-engineer-villetakanen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spec-driven development helps teams maintain alignment between architectural intent and implemented code by providing a stable living specification that can be created, reverse-engineered from code, or updated as designs evolve.

Core Features & Use Cases

  • Create: generate new specs from feature descriptions, requirements, or issue references.
  • Reverse: extract and reconstruct a spec from existing source code and architecture.
  • Update: refresh an existing spec to reflect current reality and changes across the feature area.

Quick Start

Describe the feature, its domain, and intent, then ask the Spec Engineer to create, reverse, or update the living spec.

Frequently Asked Questions about spec-engineer

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

FAQPage Schema
How do I reverse-engineer architectural specs from existing source code?

Living specs act as the single source of truth for feature domains, maintaining alignment between architectural intent and implemented code. They remain stable references that can be created, updated, or reverse-engineered as your software design evolves.

How do I update a living spec after design changes in my codebase?

Updating a living spec after design changes involves refreshing the existing specification document to reflect current reality. You describe the changes across the feature area, and the spec is updated to maintain its accuracy as the single source of truth.

What is spec-driven development and when do I need living specs?

Living specs codify architectural intent as a stable single source of truth, keeping teams aligned between design and implementation. You need them when feature requirements must remain synchronized with evolving source code across any software domain.

Can I generate a new feature spec from requirements or issue references?

Yes, you can generate new specs directly from feature descriptions, requirements, or issue references. You provide the feature domain and intent, and the Spec Engineer creates a living specification aligned to the spec-anchored workflow.

Do I need a specific directory structure for spec-anchored workflow?

Yes, spec-anchored workflow requires alignment to the specs/{feature-domain}/spec.md directory structure. This standardized path ensures the living specification remains discoverable and serves as the single source of truth for the feature area.