knowledge-capture

What problem does it solve?

This Skill addresses the critical issue of knowledge loss in engineering teams by providing a structured system for capturing decisions, operational procedures, and anti-patterns, ensuring context is preserved and easily accessible.

Core Features & Use Cases

• Architecture Decision Records (ADRs): Document and track significant technical decisions.
• Runbooks: Create task-oriented operational procedures for incidents and common tasks.
• Anti-Pattern Documentation: Prevent recurring mistakes by documenting past failures and correct approaches.
• Decision Analysis: Utilize trade-off matrices and risk assessments for informed decision-making.
• Living Documentation: Maintain up-to-date documentation integrated with the codebase.
• Knowledge Organization: Implement taxonomy and discoverability techniques for efficient information retrieval.
• Use Case: A team needs to document a recent architectural choice. They use the ADR pattern to record the problem, decision, alternatives, and consequences, ensuring future team members understand the rationale.

Quick Start

Use the knowledge-capture skill to document a new architecture decision using the ADR pattern.