Design Document Maintenance

概要

Refines and organizes architectural design documents by establishing clear, low-maintenance standards. This skill applies a structured workflow to inventory existing documentation, consolidate overlapping information into canonical sources, and prune obsolete content. It emphasizes creating skimmable, high-level documents that are easy to navigate and maintain, making it ideal for teams looking to reduce documentation debt and ensure their core architectural knowledge is accessible and up-to-date.

主な機能

• Audits existing documentation to identify overlaps and redundancies.
• Enforces a 'one topic per page' principle to minimize documentation upkeep.
• Consolidates topics into single, canonical documents to create a source of truth.
• Refactors content to be high-level and easily skimmable (e.g., TL;DR, use cases, gotchas).
• Organizes documents into a simple folder structure with a curated index for discoverability.
• 8 GitHub stars

ユースケース

• Refactoring a large or outdated set of technical design documents to reduce clutter.
• Establishing clear standards and a sustainable workflow for managing architectural documentation.
• Improving the discoverability of system designs to streamline the onboarding of new engineers.