How does it distinguish between Plans and Living Docs?

Plans are 'foresight' written before building (what we will do), while Living Docs are 'hindsight' written after building (how it works now).

What is the primary goal of the Agent Documentation System?

The primary goal is to ensure project legibility for AI agents and humans by creating a standardized way to document plans, decisions, and current system states.

What are the different agent roles in this system?

The system defines specific documentation duties for Planners (plans/decisions), Builders (living docs), Verifiers (accuracy reports), and Gardeners (auditing and pruning).

Where should I store my design documents using this skill?

Plans are centralized in the root `design-docs/plans/` folder, while Living Docs are distributed near the code they describe, such as in `{package}/design-docs/`.

Agent Documentation System

Name: Agent Documentation System
Author: JSai23

byJSai23

•

内容管理

Establishes a standardized framework for AI agents to create, maintain, and evolve technical design documentation.

This skill implements a robust documentation system designed specifically for AI-driven development workflows. It provides a structured methodology for managing 'foresight' (plans) and 'hindsight' (living docs), ensuring that every agent session inherits clear context, architectural maps, and decision logs. By enforcing a visual-first doctrine and specific folder hierarchies, it prevents documentation rot and ensures that project knowledge remains legible to both humans and AI agents as the system scales.

主要功能

01Role-based documentation duties for Planners, Builders, Verifiers, and Gardeners

021 GitHub stars

03Clear lifecycle management for plans from draft to active and complete

04Architecture and Principles templates to act as entry points for fresh agent sessions

05Structured frontmatter conventions for tracking doc status, scope, and traceability

06Standardized design-docs/ folder structure for centralized plans and distributed living docs

使用场景

01Standardizing technical architecture maps and design patterns for complex repositories

02Maintaining continuity and context across multiple AI-led development sessions

03Automating the maintenance of 'living' system documentation as code evolves

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jsai23/claude-tooling common-design-docs-k

For use in Claude.ai and ChatGPT

Download Skill