capture-work-guidance

What problem does it solve?

AI agents often complete tasks without adequately documenting their work, leading to knowledge gaps and repeated effort. This Skill provides comprehensive guidance for AI agents on when and how to proactively capture documentation using /docent:tell, transforming ephemeral work into persistent, searchable knowledge.

Core Features & Use Cases

• 5 Critical Moments: Teaches agents to capture documentation after completing work, making decisions, discovering insights, encountering blockers, and at natural breakpoints.
• Effective Capture Patterns: Guides agents on writing specific, context-rich documentation that explains "why" decisions were made.
• Anti-Pattern Avoidance: Helps agents avoid common documentation pitfalls like "I'll document it later" or assuming context is obvious.
• Use Case: Your AI agent is developing a new feature. This Skill ensures it automatically documents every key decision, insight, and completion, creating a rich, persistent working memory that allows seamless context switching and future reference.

Quick Start

Explain how to proactively capture documentation using /docent:tell.