maintain-dev-docs

Standardize /docs structure and update SPECIFICATION.md, TASKS.md, PHASE#.md, and README.md files.

Updated Jan 19, 2026
One-click install
npx skills add https://github.com/illogical/InstructionLibrary --skill maintain-dev-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maintain-dev-docs
Source: https://github.com/illogical/InstructionLibrary/tree/main/skills/maintain-dev-docs
Command: npx skills add https://github.com/illogical/InstructionLibrary --skill maintain-dev-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill helps teams maintain living documentation by standardizing a /docs structure and capturing core decisions.

Core Features & Use Cases

  • Establishes a living documentation pattern for /docs, including SPECIFICATION.md, TASKS.md, PHASE#.md, and README.md to track progress and decisions.
  • Provides a reminder-driven workflow and templates to keep documentation in sync with code, reducing drift across phases.
  • Offers optional git hooks guidance to enforce documentation discipline.

Quick Start

Get started by adopting the standard /docs structure and templates. Create the core files (docs/brainstorm.md, docs/specification.md, docs/tasks.md, docs/PHASE0.md, docs/README.md) and run the reminder script to surface a documentation checklist.

Frequently Asked Questions about maintain-dev-docs

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

FAQPage Schema
How do I keep project documentation in sync with code during ongoing development?

You can prevent documentation drift by enforcing a standardized /docs structure with SPECIFICATION.md, TASKS.md, and PHASE#.md files. A reminder workflow and optional git-hooks keep these living documents accurate across ongoing project phases.

What files do I need for a standard /docs structure to track project decisions?

A standard /docs structure requires brainstorm.md, specification.md, tasks.md, PHASE0.md, and README.md files. These living documents track core decisions, project progress, and user-facing information throughout ongoing development phases.

Can I use git hooks to enforce documentation updates before committing code?

Yes, you can use optional git hooks guidance to enforce documentation discipline before committing code. This prevents drift by ensuring developers update /docs files like SPECIFICATION.md and TASKS.md alongside their code changes.

What is living documentation and when do I need it for software engineering projects?

Living documentation is a standardized /docs structure that captures core decisions and tracks progress continuously. You need it for software engineering projects when ongoing phases cause code and documentation drift, requiring reminder workflows and templates to maintain accuracy.

Does this documentation approach work without any external dependencies?

Yes, this documentation approach works without external dependencies because it relies on standard markdown files and optional git hooks. You only need to create the /docs directory structure and run the provided reminder script to surface checklists.

Why does my project documentation keep drifting from the actual codebase?

Project documentation drifts when there is no standardized /docs structure or reminder workflow to enforce updates. Without templates for files like SPECIFICATION.md and PHASE#.md, capturing core decisions across ongoing development phases becomes inconsistent and inaccurate.