Creates sidecar markdown documentation for source code files. Use when Claude needs to write or update documentation for code - creating new *.md files alongside source files, updating existing documentation, documenting individual files or entire projects, explaining code using Stage-Actor-Prop metaphor for both human and LLM readers
Creates sidecar markdown files (*.md) placed alongside non-autogenerated source code. Designed for both human and LLM readers.
Each documentation file must:
Last Updated: YYYY-MM-DDTHH:MM:SSZ (UTC ISO 8601 format)
date -u +"%Y-%m-%dT%H:%M:%SZ"# [Component/Module Name]
Last Updated: YYYY-MM-DDTHH:MM:SSZ
## Purpose
[Why this code exists, what problem it solves]
## Stage-Actor-Prop Overview
[Primary Stage-Actor-Prop sentence describing the main behavior]
## Components
[For larger files: break down functions/classes/modules, each with Stage-Actor-Prop descriptions]
## Usage
[Examples, parameters, return values]
## Dependencies
[What this code depends on, how it relates to other modules]
## Notes
[Important details, edge cases, design decisions]
Create or update documentation when:
Do NOT document:
date -u +"%Y-%m-%dT%H:%M:%SZ" to get current UTC timestamp in ISO 8601 format*.md file with timestamp.agents/skills/documentation-writer/references/)