spec-delta

Generate delta specifications with acceptance criteria and integration steps.

1|1|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/asermax/claude-plugins --skill spec-delta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-delta
Source: https://github.com/asermax/claude-plugins/tree/main/katachi/skills/spec-delta
Command: npx skills add https://github.com/asermax/claude-plugins --skill spec-delta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Delta specification often lacks precise scope and acceptance criteria, leading to drift and misinterpretation across teams.

Core Features & Use Cases

  • Structured delta templates and guidance for writing clear user stories.
  • Research prompts, impact discovery, and iterative refinement leveraging existing delta docs.
  • A repeatable process that produces ready-to-publish specs in docs/delta-specs/$ARGUMENTS.md.

Quick Start

Provide a new delta spec for a given ID by stepping through the guided workflow.

Frequently Asked Questions about spec-delta

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

FAQPage Schema
How do I write a delta specification for a new feature without scope drift?

To write a delta specification without scope drift, use a template-driven structure to codify feature changes, rationale, and acceptance criteria. This enforces research, impact discovery, and iterative drafting for UI and API changes.

What is a delta spec and when do I need one for feature changes?

A delta spec is a structured document that codifies feature changes and their rationale across docs, planning, and feature specs. You need one when you require precise scope and acceptance criteria to prevent drift and misinterpretation across teams.

How do I standardize feature specs for UI and API changes across teams?

You standardize feature specs for UI and API changes by applying a template-driven structure that guides research, impact discovery, and iterative drafting. This produces ready-to-publish specs with clear user stories and integration steps.

Does this delta spec workflow include automated review and status updates?

Yes, the delta spec workflow includes status updates and review steps. It integrates with a spec-reviewer to enforce acceptance criteria and integration steps, ensuring the specification meets quality standards before publishing.

What's the best way to document feature rationale and acceptance criteria?

The best way to document feature rationale and acceptance criteria is through a repeatable process that leverages existing delta docs. It guides iterative refinement and produces ready-to-publish specs in a standardized markdown format.

Can I use delta specs to research and discover the impact of feature changes?

Yes, you can use delta specs to research and discover the impact of feature changes. The workflow includes specific research prompts and impact discovery phases that leverage existing documentation to inform your iterative drafting.