gotcha

To document a failure pattern, you record it as a gotcha entry in a centralized gotchas.md file. This captures anti-patterns and preserves institutional knowledge to guide future interactions and workflow improvements.

A gotcha entry in knowledge management is a structured record of a non-obvious failure pattern or anti-pattern. It serves as a learning resource to harden future work by preventing repeated mistakes across teams.

You append a retrospective lesson by invoking the gotcha capture process when a mistake is corrected. It appends a structured, de-duplicated entry to the gotchas.md file within the specific skill directory.

Yes, you can build institutional knowledge from Claude interactions without external dependencies. It operates locally by appending structured entries to markdown files within your existing skill directories.

You should capture a gotcha when Claude makes a mistake, when you correct an approach, or when a non-obvious pattern is discovered. This ensures the failure pattern is recorded immediately for future reference.

Yes, this knowledge management method supports de-duplication of recorded anti-patterns. It creates or updates the gotchas.md file with generic guidance while ensuring duplicate failure patterns are filtered out.