update-docs

To keep AGENTS.md documentation in sync, you can automatically update files with patterns, commands, and architectural insights discovered during a development session. The Skill identifies relevant sections from conversation context and records them.

Documenting common pitfalls and conventions is best handled by extracting session learnings and appending them to AGENTS.md files. This approach ensures discovered development patterns are promptly recorded for future reference.

Automatic documentation update works by analyzing the current development conversation to identify relevant learnings, then applying those insights to the appropriate AGENTS.md sections while adhering to established style and placement guidelines.

You need to follow the guidelines in `docs/updating-agents-docs.md` for content placement and style. This file defines the structural rules required before the Skill can properly update your AGENTS.md documentation.

Yes, you can use this approach to document error handling patterns. It applies to recording commands, conventions, architectural insights, and specific pitfalls discovered during development sessions in your AGENTS.md files.

You should not use automated updates when the session learnings lack reusable patterns, architectural insights, or conventions. It is designed for persistent knowledge management, not transient debugging steps or temporary code fixes.