vibespec-update

Update specification documents and ADRs to reflect code changes.

15|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/v0lka/skills --skill vibespec-update
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vibespec-update
Source: https://github.com/v0lka/skills/tree/main/development/sdd/vibespec-update
Command: npx skills add https://github.com/v0lka/skills --skill vibespec-update

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps specification documents in lockstep with code changes, preventing drift between behavior, interfaces, and contracts.

Core Features & Use Cases

  • Identify affected specs across domain detail docs, contracts, and architecture when a change is implemented.
  • Update targeted sections in place to preserve formatting, references, and cross-links.
  • Manage ADRs and refresh INDEX.md to reflect the current file set.

Quick Start

Run vibespec-update after implementing a code change that affects specs, and update the affected domain and contract docs accordingly.

Frequently Asked Questions about vibespec-update

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

FAQPage Schema
How do I keep architecture documentation and specifications aligned with code changes?

To keep architecture documentation aligned with code changes, identify affected domain specs, contracts, and ADRs, then update the targeted sections in place to preserve formatting, references, and cross-links.

When do I need to update ADRs and INDEX.md during software development?

You need to update ADRs and INDEX.md when code changes touch architectural boundaries, initialization, or configuration, ensuring specification documents accurately reflect the current file set and system contracts.

What is the best way to prevent specification drift when modifying domain contracts?

The best way to prevent specification drift when modifying domain contracts is to read current specs, determine affected files, and modify content in place following the required format to maintain lockstep between behavior and interfaces.

How to update cross-references in specification documents after refactoring?

To update cross-references in specification documents after refactoring, update targeted sections in place while preserving existing formatting and links, then manage ADRs and refresh INDEX.md to reflect the current file set.

Does updating architectural boundaries require modifying domain detail docs and contracts?

Yes, updating architectural boundaries requires modifying domain detail docs and contracts, because specification documents must be read and updated in place to keep code behavior and interfaces synchronized across components.