---
feature: "Documentation System"
description: "Docs, features, issues, plans — project-aware self-documenting architecture"
files:
  - ".agent/workflows/docs.md"
  - ".agent/workflows/features.md"
  - ".agent/workflows/issue.md"
  - ".agent/workflows/plan.md"
  - ".agent/workflows/research.md"
  - ".agent/workflows/learn.md"
  - ".agent/skills/issue-management/SKILL.md"
  - ".agent/skills/planning-system/SKILL.md"
  - ".agent/skills/plugin-features/SKILL.md"
  - ".agent/rules/docs-first.md"
  - ".agent/rules/issues.md"
  - ".agent/rules/planning.md"
parent: true
children:
  - "Project Docs"
  - "Feature Docs"
  - "Issue Tracking"
  - "Implementation Plans"
  - "Research"
updated: "2026-04-12"
---

# Documentation System

Self-documenting, project-aware architecture. All documentation lives in `docs/<type>/<project>/` where `<project>` is determined from conversation context.

## Children

### Project Docs
- **What it does**: Generates/updates README, STRUCTURE, SETTINGS, DEPENDENCIES, CHANGELOG for a project
- **Workflow**: `/docs` (contextual) or `/docs all` (complete)
- **Output**: `docs/features/<project>/` — 5 core files
- **CHANGELOG.md** is source of truth for versioning

### Feature Docs
- **What it does**: Generates/updates parent→child feature documentation from codebase analysis
- **Workflow**: `/features` (contextual) or `/features all` (complete)
- **Output**: `docs/features/<project>/000-index.md` + numbered feature files
- **Format**: YAML frontmatter + structured children with methods, inputs, outputs, dependencies, settings

### Issue Tracking
- **What it does**: Records bugs as self-contained files that any independent agent can resolve
- **Workflow**: `/issue` (creates), rule `issues.md` (protects), skill `issue-management` (resolves)
- **Output**: `docs/issues/<project>/NNN-description.md`
- **Critical rule**: Agent NEVER changes status to `resolved` without explicit user confirmation

### Implementation Plans
- **What it does**: Creates detailed, self-contained implementation plans before any coding
- **Workflow**: `/plan` (creates), `/do` (implements), rule `planning.md` (enforces)
- **Output**: `docs/plans/<project>/NNN-description.md`
- **Lifecycle**: `draft` → `ready` (user approval) → `in-progress` → `completed` (user confirmation)

### Research
- **What it does**: Online research saved as structured documents
- **Workflow**: `/research`
- **Output**: `docs/research/YYYY-MM-DD-topic.md`
- **Related**: `/learn` loads existing feature docs (doesn't create new research)
