Living Specs in SpecKit

Описание и применение

Живые спецификации в SpecKit позволяют поддерживать актуальные требования к функционалу рядом с кодом, уменьшая дублирование и облегчая поиск текущих спецификаций.

Задача

Spec files become stale and fragmented, making it hard to understand current feature behavior and to reuse knowledge across changes.

Результат

Living specs reduce duplication, keep documentation current, and improve agent guidance by providing a single, up-to-date spec per feature.

Рабочий процесс

• 1. Define capabilities and match globs in living-specs.yml
• 2. Run SpecKit Companion to load the living spec before drafting
• 3. Agent drafts specify, plan, tasks, and implement phases
• 4. After implementation, Companion rewrites the living spec with updated requirements
• 5. Spec remains next to code for future runs and human review

Доказательства

Spec-kit gives each feature its own numbered folder, and that folder is finished the day the feature is

Источник

A living spec is a pointer to that previous understanding. When the next run starts, the agent has more guidance, faster, because the record of how the feature works is already there and already current.

Источник

The difference is who finds the spec without being told where it is. You can pick per capability, and /speckit.companion.living-move moves a spec between the two later, so nothing here is a commitment.

Источник