Knowledge Management

Knowledge Management System

4-layer system for capturing and organizing development knowledge.

Commands

Flow

ทำงาน → /mem "insight" → /distill topic → /td → /improve
         (Layer 1)        (Layer 2)      (Layer 3) (Layer 4)

Directory Structure

docs/
├── learnings/           # /mem output
│   └── YYYY-MM/DD/
├── knowledge-base/      # /distill output
└── retrospective/       # /td output
    └── YYYY-MM/

Setup

Run init script to create directory structure:

./scripts/init.sh $PROJECT_ROOT

Or manually:

mkdir -p docs/{learnings,knowledge-base,retrospective}

Command: /mem

Quick knowledge capture - ใช้ระหว่างทำงานเมื่อพบ insight

TZ='Asia/Bangkok' date '+%Y-%m/%d/%H.%M'  # Path format

Output: docs/learnings/YYYY-MM/DD/HH.MM_[slug].md

Template: See references/mem-template.md

Key sections: Key Insight, What We Learned, Gotchas, Tags

Command: /distill

Extract patterns - รวม learnings เป็น reusable patterns

When: มี 3+ learnings เรื่องเดียวกัน หรือ weekly review

Output: docs/knowledge-base/[topic-name].md

Template: See references/distill-template.md

Key sections: Key Insight, The Problem, The Solution (with code), Anti-Patterns, When to Apply

After: Mark source learnings as "Distilled"

Command: /td

Post-task retrospective with Before/After context

Output: docs/retrospective/YYYY-MM/retrospective_YYYY-MM-DD_hhmmss.md

Template: See references/td-template.md

Type Classification (frontmatter)

Required: Before/After Context

## Context: Before
- **Problem**: ปัญหาที่เจอ
- **Existing Behavior**: พฤติกรรมเดิม
- **Metrics**: ตัวเลขก่อนแก้

## Context: After
- **Solution**: วิธีแก้
- **New Behavior**: พฤติกรรมใหม่
- **Metrics**: ตัวเลขหลังแก้

Decisions Table

| Decision | Options Considered | Chosen | Rationale |
|----------|-------------------|--------|-----------|

Command: /commit

Atomic commits via TDG plugin

Delegates to: /tdg:atomic-commit from https://github.com/chanwit/tdg

What it does:

• Analyzes staged/unstaged changes
• Detects mixed concerns (multiple unrelated changes)
• Helps create clean, focused atomic commits
• Each commit is a complete unit of work

Usage: Simply run /commit and it will invoke TDG's atomic-commit skill.

Command: /improve

Work on pending items from all knowledge sources

Scan order (priority):

1. docs/knowledge-base/ - Patterns to apply
2. docs/retrospective/ - Future Improvements (- [ ])
3. docs/learnings/ - Gotchas to fix (skip if "Distilled")

Workflow:

1. Extract unchecked items
2. Present prioritized list
3. User selects items
4. Implement & commit
5. Update source file (- [ ] → - [x])

Search Commands

# Find by type
grep -l "type: bugfix" docs/retrospective/**/*.md

# Search content
grep -r "mongodb" docs/

# Recent learnings
find docs/learnings -name "*.md" -mtime -7

Auto-Capture

บันทึก session อัตโนมัติเมื่อจบงาน

Options

Setup (Hooks - Recommended)

# Add to ~/.claude/settings.json
{
  "hooks": {
    "Stop": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/skills/knowledge-management/scripts/auto-capture.sh . 2>/dev/null || true"
      }]
    }]
  }
}

Output

docs/auto-captured/YYYY-MM/DD/HH.MM_session-*.md

See AUTO-CAPTURE.md for full documentation.

References

• references/mem-template.md - Full /mem template
• references/distill-template.md - Full /distill template
• references/td-template.md - Full /td template
• references/improve-workflow.md - /improve detailed workflow