session-knowledge-harvest

What problem does it solve?

Extract and document architectural knowledge discovered during coding or investigation sessions. Mines the session for business rules, behavioral contracts, counterintuitive code patterns, new terminology, and gaps that were researched or user-clarified — then integrates the findings into the existing architecture knowledge base. Use at the end of any session where meaningful domain or codebase understanding was gained: debugging sessions, code reviews, work item analysis, investigation spikes, refactoring work, or any session where "I didn't know that before" occurred.

Core Features & Use Cases

• Mine sessions for knowledge candidates and update the architecture documentation accordingly.
• Check for gaps against existing architecture docs and plan targeted updates.
• Support a Lessons Learned feedback loop via LessonsLearned.md and LessonsLearned.GLOBAL.md to improve documentation over time.

Quick Start

Run this skill at the end of any session where meaningful domain or codebase knowledge has been gained to extract and integrate new insights into the architecture docs.