spec-manager

What problem does it solve?

Developers and teams often struggle to keep project documentation, such as specifications and architecture diagrams, synchronized with a rapidly evolving codebase. This manual effort is time-consuming and frequently leads to outdated or inaccurate documentation, creating confusion and hindering onboarding. This skill eliminates that burden by automatically updating your project's specifications, ensuring they always reflect the current state of your code.

Core Features & Use Cases

• Proactive Documentation Sync: Claude automatically detects significant development activities (e.g., starting new features, completing major code changes, refactoring, or detecting spec-related keywords) and updates relevant specification documents without explicit prompting.
• Comprehensive Specification Management: Automatically maintains a suite of critical documents including Product Requirements (PRD), Application Flow, Technology Stack, File Structure, and more, stored in a dedicated .spec-manager/ directory.
• Intelligent Change Detection: Monitors your development workflow and triggers updates based on predefined conditions, such as modifying 3+ files, making architectural changes, or ending a development session with substantial work.
• Automated User Notifications: Provides a concise summary of what documents were updated and why, keeping you informed without interrupting your focus.
• Use Case: Imagine you've just completed a major refactor of your authentication module. Instead of manually updating the TechStack.md and FileStructure.md, this skill automatically detects the changes, updates the relevant sections, and notifies you, allowing you to focus purely on coding.

Quick Start

This skill is designed to work proactively in the background. To manually trigger an update or ensure your specifications are current, simply tell Claude: Update the project's specification documents.