Writing documentation

When to apply

• Creating or updating Markdown documentation in the project
• Creating or updating AI-facing content: skills (SKILL.md), rules, similar instructional docs

New documentation: template first

Before drafting new documentation, do not proceed with a full write-up until one of the following is satisfied:

1. User provides a template — follow it for structure and sections.
2. No template given — propose 1–2 concrete outline options (or a minimal default template: title, overview, sections matching the doc type) and confirm or adjust with the user before writing the body.

Updates to existing docs do not require this step unless the user is effectively starting a new doc from scratch.

Core principles