initial commit

.config/opencode/skills/doc-coverage/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: doc-coverage
+description: Documentation coverage checklist and update procedures — load when completing a feature or change set
+---
+
+## When to Use
+
+Load this skill when a feature or change set is nearing completion. Documentation is a **completion gate** — a task is not done until docs are handled.
+
+## Coverage Checklist
+
+For every completed change set, verify documentation coverage:
+
+### 1. README
+- [ ] Does the README reflect the current state of the project?
+- [ ] Are new features, commands, or configuration options documented?
+- [ ] Are removed features cleaned up from the README?
+
+### 2. Docs directory (`docs/*`)
+- [ ] Are there relevant docs files that need updating?
+- [ ] Do new features need their own doc page?
+- [ ] Are API changes reflected in API documentation?
+
+### 3. AGENTS.md / agent definitions
+- [ ] Did this change alter workflow, policies, or agent behavior?
+- [ ] If yes, update AGENTS.md or the relevant agent definition file.
+
+### 4. Inline documentation
+- [ ] Are complex functions/components documented with comments explaining **why**, not **what**?
+- [ ] Are public APIs documented with parameter descriptions?
+
+## Update Procedure
+
+1. Review the list of changed files and their purpose.
+2. Identify which documentation files are affected.
+3. Read the current state of each affected doc file.
+4. Update docs to reflect the implemented changes — keep descriptions accurate and concise.
+5. If a change removes functionality, remove or update the corresponding documentation.
+6. If creating a new feature, add documentation in the most appropriate location.
+
+## Anti-patterns
+
+- **Never leave stale docs.** If you changed behavior, the docs must change too.
+- **Never create placeholder docs.** "TODO: document this" is not documentation.
+- **Never duplicate content across doc files.** Link to the canonical source instead.
+- **Never wait for the user to ask.** If docs need updating, update them proactively as part of the change set.
+
+## Delegation
+
+- The **librarian** subagent is the specialist for documentation work.
+- Lead should delegate doc coverage review to librarian after coder completes implementation.
+- Librarian reads the changes, identifies doc gaps, and writes/updates documentation.