Can I choose whether code or documentation is the primary source of truth?

Yes, Spec-Lock features a priority system where you can define rules in a YAML file to prioritize 'code' (implementation wins), 'spec' (documentation wins), or 'ask' (user decides) on a per-directory basis.

Does it support automatic updates for API contracts?

Absolutely. Spec-Lock is specifically designed to handle API versioning, endpoint changes, and parameter updates by suggesting or automatically applying documentation patches when implementation changes.

How does Spec-Lock track dependencies between files?

It maintains a local SQLite database that maps specific code files to their corresponding specification documents, ensuring the system knows exactly which docs to check when a file is modified.

How does Spec-Lock detect documentation drift?

Spec-Lock uses a PostToolUse hook to analyze the semantic intent of your code changes immediately after an edit, comparing them against your SPEC.md, CLAUDE.md, and other registered documentation files.

Spec-Lock Documentation Synchronizer

Name: Spec-Lock Documentation Synchronizer
Author: aegntic

byaegntic

•

콘텐츠 관리

Maintains bi-directional synchronization between implementation and documentation to eliminate documentation rot and technical debt.

Spec-Lock is a sophisticated synchronization engine for Claude Code designed to solve the problem of documentation falling behind rapid code iterations. By treating documentation as executable context, it performs post-edit analysis to detect semantic drift between source code and specifications like SPEC.md or API contracts. Whether you are updating API endpoints, refactoring auth logic, or changing database schemas, Spec-Lock ensures your documentation remains a perfect reflection of your codebase through automated AI-powered patching and configurable priority rules.

주요 기능

01Real-time drift detection triggered automatically after file edits and tool usage

02Bi-directional synchronization allowing either code or documentation to act as the source of truth

03Configurable priority rules (code-first, spec-first, or manual) via YAML configuration

04Persistent dependency tracking using a local SQLite knowledge graph to map code to documents

05Automated documentation patching using AI to generate precise updates for affected specs

069 GitHub stars

사용 사례

01Maintaining security specifications during refactors of authentication and authorization flows

02Synchronizing REST API documentation with backend endpoint and parameter changes

03Keeping internal technical guides and CLAUDE.md files updated with new architectural patterns

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add aegntic/cldcde spec-lock

For use in Claude.ai and ChatGPT

Download Skill