What is the difference between an Architecture Doc and an ADR?

Architecture Docs explain 'how' a system is currently structured, while ADRs (Architecture Decision Records) capture the 'why' behind specific decisions at a point in time to prevent future re-litigation.

When should I extract documentation into a Claude Code Skill?

If an analysis or guide identifies a repeatable workflow with clear steps, it should be converted into a machine-readable skill to automate the process, allowing the source documentation to be archived.

How does this skill prevent documentation clutter?

It implements the 'Link Test' and a ruthless deletion policy, ensuring that only documentation with long-term reference value or active links in the README is preserved.

Does this skill help with session continuity?

Yes, it provides structured templates for tracking active work and deferred ideas in project-specific or cross-project tracking files, ensuring context isn't lost between sessions.

Documentation Management

Name: Documentation Management
Author: ImproperSubset

byImproperSubset

0•

内容管理

Enforces a structured documentation policy to prevent clutter and ensure project knowledge remains actionable and maintainable.

The Documentation Management skill provides a comprehensive framework for organizing project knowledge within AI-driven development environments. It eliminates 'write-only' documentation by defining clear document types—such as Architecture Decision Records (ADRs), reference guides, and session trackers—while enforcing strict naming conventions and lifecycle rules. By applying the 'Link Test' and encouraging the extraction of repeatable patterns into reusable skills, this tool helps developers maintain a lean, trusted documentation hierarchy that supports both human contributors and AI assistants.

主要功能

010 GitHub stars

02Decision tree for creating, archiving, or deleting documentation

03Standardized naming patterns for ADRs, guides, and architecture files

04Repeatable pattern identification for skill extraction

05Lifecycle management using the 'Link Test' to eliminate documentation rot

06Session tracking management for project-specific and cross-project tasks

使用场景

01Managing session continuity and backlog tracking across multiple repositories

02Standardizing how technical decisions and system architectures are recorded

03Auditing existing documentation to archive obsolete analysis and keep guides relevant

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add impropersubset/hh-agentics documentation-management

For use in Claude.ai and ChatGPT

Download Skill