skills.rest
jankneumann
jankneumannCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

update-specs

Detect and update OpenSpec documents to match implemented code.

4|1|Updated Jan 16, 2026
Search Tags:#design#documentation#sync#openspec#spec-drift#update-specs
One-click install
npx skills add https://github.com/jankneumann/agentic-coding-tools --skill update-specs-jankneumann
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-specs
Source: https://github.com/jankneumann/agentic-coding-tools/tree/main/.agents/skills/update-specs
Command: npx skills add https://github.com/jankneumann/agentic-coding-tools --skill update-specs-jankneumann

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenSpec documentation often drifts from the actual implementation; this Skill identifies gaps and updates spec.md, design.md, and related docs to reflect the built system.

Core Features & Use Cases

  • Detect and surface divergences between OpenSpec docs and the implemented codebase across components and APIs.
  • Update spec.md, design.md, and tasks.md to align with the real behavior and decisions observed during debugging, testing, and review.
  • Coordinate updates across openspec/specs and the codebase to maintain a single source of truth for future work and audits.

Quick Start

Run the update-specs workflow to align OpenSpec docs with the current implementation.

Frequently Asked Questions about update-specs

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

FAQPage Schema
How do I keep OpenSpec documentation aligned with implemented code?▼

To fix spec drift in OpenSpec, identify divergences between implemented code and documentation, then update spec.md and design.md files to accurately reflect the actual built system.

What is spec drift and how do I detect it in my project?▼

Spec drift occurs when OpenSpec documentation diverges from implemented code. Detect it by comparing spec.md and design.md files against the actual behavior observed during debugging and code review.

When should I update spec files to match my codebase?▼

Update spec files after debugging, testing, or code review sessions. This ensures spec.md, design.md, and tasks.md documentation accurately matches what was built across all project components.

Can I update multiple OpenSpec documents at the same time?▼

Yes, you can coordinate updates across openspec/specs and the codebase simultaneously. The workflow updates spec.md, design.md, and tasks.md together to maintain a single source of truth.

What's the best way to maintain a single source of truth for OpenSpec docs?▼

The best way to maintain a single source of truth is to regularly run a workflow that surfaces divergences and coordinates updates across openspec/specs and your codebase to align documentation.

Do I need any specific dependencies to sync OpenSpec specs with my implementation?▼

No specific dependencies are required to sync OpenSpec specs with your implementation. The workflow operates directly on your existing spec.md, design.md, and tasks.md files.

Related Skills

Explore More Software Engineering Skills→
dariopalminiodariopalminio
1

openspec-generate-baseline

Generate an OpenSpec baseline from existing source code and archive it.

Community
Advanced
joestumpjoestump
30

spec

Create and maintain paired OpenSpec specification and design documents.

Community
Advanced
samjhechtsamjhecht
4

design-system-governance

Detect design token drift between Figma and code implementations.

Community
Advanced
rlagycksrlagycks
3

ontology-sync

Validate domain spec sections and synchronize ontology index JSON files.

Community
Intermediate