Knowledge Management Skill for Claude Code

ระบบจัดการความรู้ 4 layers สำหรับ Claude Code CLI - inspired by Claude-Mem แต่เก็บไว้ใน Git repository

Roadmap: ดู ROADMAP.md สำหรับแผนพัฒนา

Usage Guide: ดู USAGE.md สำหรับคู่มือการใช้งานฉบับสมบูรณ์

Features

• 🚀 4-Layer System: /mem → /distill → /td → /improve
• 📝 Before/After Context: จับบริบทก่อน-หลังเหมือน Claude-Mem
• 🔍 Searchable: ค้นหาด้วย grep, type filter
• 📁 Git-Tracked: Version control ทุก knowledge
• 🔧 Portable: ใช้ได้กับทุก AI tool ที่อ่าน markdown
• 🤖 Auto-Capture: บันทึก session อัตโนมัติ พร้อม AI analysis
• 📋 Session Management: /recap → /focus → /td workflow
• 🔗 GitHub Integration: สร้าง Issues + PRs อัตโนมัติ
• 🎫 Jira Integration: สร้าง/จัดการ Jira issues (Atlassian Cloud)
• ✅ Code Review: /review ก่อน push
• 🔔 Notification Hooks: แจ้งเตือนเมื่อ Claude ต้องการ input (รองรับ Multi-Tab Workflow)
• 🤝 Multi-Agent Compatible: รองรับการใช้งานร่วมกับ multi-agent-auto-skill

Quick Start

For detailed usage examples and workflow guides, see USAGE.md

Installation

# Clone repository
git clone https://github.com/YOUR_USERNAME/knowledge-management-skill.git

# Copy to Claude skills directory
cp -r knowledge-management-skill ~/.claude/skills/

# Or install in your project
cd /path/to/your/project
~/.claude/skills/knowledge-management-skill/scripts/init.sh .

Manual Setup

# Create directories
mkdir -p .claude/commands
mkdir -p docs/{learnings,knowledge-base,retrospective}

# Copy command files
cp ~/.claude/skills/knowledge-management-skill/assets/commands/*.md .claude/commands/

Commands

Session Management

Git & Code

Knowledge Capture (4-Layer)

Jira Integration

See references/jira-integration.md for full documentation.

Session Lifecycle

┌─────────────────────────────────────────────────────────────────┐
│                        SESSION START                            │
└─────────────────────────────────────────────────────────────────┘
                               │
                               ▼
                    ┌─────────────────────┐
                    │      /recap         │
                    │  โหลด context เดิม   │
                    └─────────────────────┘
                               │
                               ▼
                    ┌─────────────────────┐
                    │      /focus         │
                    │  ตั้งงาน + สร้าง issue │
                    └─────────────────────┘
                               │
                               ▼
              ┌────────────────────────────────┐
              │         ทำงาน                   │
              │  /mem - บันทึก insight         │
              │  /commit - atomic commits      │
              │  /review - manual code review  │
              └────────────────────────────────┘
                               │
                               ▼
                    ┌─────────────────────┐
                    │        /pr          │
                    │  test + build       │
                    │  code review        │
                    │  create PR          │
                    │  start auto-respond │
                    └─────────────────────┘
                               │
                               ▼
                    ┌─────────────────────┐
                    │   [Auto-Respond]    │
                    │  poll for reviews   │
                    │  Claude handles     │
                    │  feedback auto      │
                    └─────────────────────┘
                               │
                               ▼
                    ┌─────────────────────┐
                    │        /td          │
                    │  retrospective      │
                    │  comment issue      │
                    └─────────────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────────┐
│                        SESSION END                              │
└─────────────────────────────────────────────────────────────────┘

Quick Start Workflow

# 1. เริ่ม session
/recap                          # โหลด context + state เดิม

# 2. ตั้ง focus + สร้าง issue
/focus Implement feature X      # จะถามรายละเอียด (Overview, Technical Details, etc.)

# 3. ทำงาน...
/mem "JWT refresh pattern"      # บันทึก insight ระหว่างทาง
/commit                         # commit เมื่อเสร็จ chunk

# 4. สร้าง PR
/pr                             # test + build + review + สร้าง PR

# 5. จบ session
/td done                        # สร้าง retrospective + comment issue

Knowledge Layer Workflow

                    ระหว่างทำงาน
                         │
                         ▼
┌─────────────────────────────────────────────────────────────────┐
│  Layer 1: /mem                                                  │
│  Quick capture → docs/learnings/YYYY-MM/DD/HH.MM_slug.md       │
└─────────────────────────────────────────────────────────────────┘
                         │
                         │ (เมื่อมี 3+ learnings เรื่องเดียวกัน)
                         ▼
┌─────────────────────────────────────────────────────────────────┐
│  Layer 2: /distill                                              │
│  Extract patterns → docs/knowledge-base/topic.md               │
└─────────────────────────────────────────────────────────────────┘
                         │
                         │ (periodic review)
                         ▼
┌─────────────────────────────────────────────────────────────────┐
│  Layer 4: /improve                                              │
│  Work on pending items from knowledge-base + retrospectives    │
└─────────────────────────────────────────────────────────────────┘

Before/After Context

Feature เด่นจาก Claude-Mem ที่ช่วยให้เข้าใจบริบท:

## Context: Before

- **Problem**: MongoDB timeout under load
- **Existing Behavior**: Error "context deadline exceeded" after 30s
- **Metrics**: p99 = 2s, error rate = 5%

## Context: After

- **Solution**: Connection pool + retry with exponential backoff
- **New Behavior**: Connections stable under load
- **Metrics**: p99 = 200ms, error rate < 0.1%

Type Classification

ใน /td ระบุ type ใน frontmatter เพื่อ filter ได้ง่าย:

State Machine

          /focus
ready ─────────────▶ working ──/td done──▶ completed
  ▲                     │                      │
  │                     │ /td pending          │
  │ /focus new          ▼                      │
  └───────────────── pending ◀────────────────┘
                        │        /focus new task
                        │
                        │ /td blocked
                        ▼
                     blocked

Directory Structure

project/
├── .claude/
│   └── commands/
│       ├── mem.md
│       ├── distill.md
│       ├── td.md
│       ├── improve.md
│       ├── commit.md
│       ├── focus.md        # NEW: Set focus + create issue
│       ├── recap.md        # NEW: Session context recovery
│       └── review.md       # NEW: Code review
└── docs/
    ├── current.md           # Current focus state
    ├── WIP.md               # Work in progress (paused tasks)
    ├── logs/
    │   └── activity.log     # Activity history
    ├── learnings/           # Layer 1: Quick capture
    │   └── YYYY-MM/
    │       └── DD/
    │           └── HH.MM_slug.md
    ├── knowledge-base/      # Layer 2: Curated patterns
    │   └── [topic].md
    ├── retrospective/       # Layer 3: Full reviews
    │   └── YYYY-MM/
    │       └── retrospective_YYYY-MM-DD_hhmmss.md
    └── auto-captured/       # Auto-captured sessions
        └── YYYY-MM/
            └── DD/
                └── HH.MM_session-*.md

Search

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

# Search content
grep -r "mongodb" docs/

# Recent learnings (last 7 days)
find docs/learnings -name "*.md" -mtime -7

# List all decisions
grep -l "type: decision" docs/retrospective/**/*.md

Skill Structure

claude-km-skill/
├── SKILL.md                    # Main skill definition
├── ROADMAP.md                  # Project roadmap & timeline
├── hooks.json                  # Hook configurations (Notification, Stop)
├── scripts/
│   ├── init.sh                 # Project setup script
│   ├── auto-capture.sh         # Auto session capture
│   ├── ai-capture.sh           # AI-powered capture
│   ├── claude-wrap.sh          # Claude wrapper
│   ├── notify.sh               # macOS notification script
│   ├── jira-client.sh          # Jira API client
│   ├── pr-review-poll.sh       # PR review polling daemon
│   ├── pr-review-poll-start.sh # Start daemon
│   ├── pr-review-poll-stop.sh  # Stop daemon
│   └── pr-review-poll-status.sh # Daemon status
├── references/
│   ├── mem-template.md         # Full /mem template
│   ├── distill-template.md     # Full /distill template
│   ├── td-template.md          # Full /td template
│   ├── improve-workflow.md     # /improve workflow
│   └── jira-integration.md     # Jira integration guide
├── .claude/
│   ├── commands/               # Slash command files (installed location)
│   └── agents/                 # Subagent definitions (installed location)
└── assets/
    ├── commands/               # Slash command source files
    │   ├── mem.md
    │   ├── distill.md
    │   ├── td.md
    │   ├── improve.md
    │   ├── commit.md
    │   ├── focus.md
    │   ├── recap.md
    │   ├── review.md
    │   ├── pr.md               # Create PR with tests & review
    │   ├── pr-review.md        # Handle PR review feedback
    │   ├── pr-poll.md          # PR review polling daemon
    │   ├── permission.md       # Permission management
    │   └── jira.md             # Jira commands
    └── agents/                 # Subagent definitions
        ├── code-reviewer.md
        ├── code-simplifier.md
        ├── security-auditor.md
        ├── knowledge-curator.md
        ├── session-analyzer.md
        └── build-validator.md

Issue Tracker Integration

/focus รองรับทั้ง GitHub Issues และ Jira:

Supported Trackers

/focus Workflow

/focus [task description]
     │
     ├── ถ้ามี Jira config ──→ เลือก: GitHub / Jira (new) / Jira (existing)
     │
     └── ถ้าไม่มี Jira ──→ ใช้ GitHub Issues (default)

Jira Setup

# 1. สร้าง API Token ที่ https://id.atlassian.com/manage-profile/security/api-tokens

# 2. ตั้งค่า credentials
/jira init

# 3. ทดสอบ connection
/jira test

See references/jira-integration.md for full Jira documentation.

GitHub Integration

/focus และ /td integrate กับ GitHub โดยอัตโนมัติ:

Issue Format (/focus)

## Overview
Brief description of the feature/bug.

## Current State
What exists now.

## Proposed Solution
What should be implemented.

## Technical Details
- Components affected
- Implementation approach

## Acceptance Criteria
- [ ] Specific testable criteria
- [ ] Performance requirements

PR Format (/td)

## Summary
Brief summary of the changes made.

## Changes Made
- List of key changes.

## Testing
- Description of tests performed.

## Related Issues
- #issue_number

Fixes #issue_number

Pre-Push Checklist (via /pr)

Note: /pr จะรันทุกขั้นตอนนี้ให้อัตโนมัติพร้อม update issue ทุก step

PR Review Auto-Respond

หลังจาก /pr สร้าง PR เสร็จ จะ auto-start polling daemon ที่จัดการ reviews อัตโนมัติ:

/pr สร้าง PR เสร็จ
        ↓
Start PR Poll Daemon (--auto-respond)
        ↓
[รอ reviewer...]
        ↓
เมื่อมี review → Daemon ตรวจจับ
        ↓
Spawn Claude CLI → run /pr-review อัตโนมัติ
        ↓
แก้ code, reply comments, push changes

Commands:

# ดูสถานะ daemon
/pr-poll status

# หยุด auto-respond
/pr-poll stop

# ดู Claude logs
tail -f ~/.pr-review-claude-*.log

Forbidden Actions

Why Not Claude-Mem?

Notification Hooks (Multi-Tab Workflow)

รองรับการทำงานแบบ Multi-Tab ตามแนวทางของ Boris Cherny (ผู้สร้าง Claude Code) - เปิดหลาย terminal tabs พร้อมกัน และรับ notification เมื่อ tab ใดต้องการ input

Notification Types

Setup

เพิ่มใน ~/.claude/settings.json:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "idle_prompt",
        "hooks": [{
          "type": "command",
          "command": "~/.claude/skills/claude-km-skill/scripts/notify.sh"
        }]
      },
      {
        "matcher": "permission_prompt",
        "hooks": [{
          "type": "command",
          "command": "~/.claude/skills/claude-km-skill/scripts/notify.sh"
        }]
      },
      {
        "matcher": "elicitation_dialog",
        "hooks": [{
          "type": "command",
          "command": "~/.claude/skills/claude-km-skill/scripts/notify.sh"
        }]
      }
    ]
  }
}

Multi-Tab Workflow

┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐
│  Tab 1  │  │  Tab 2  │  │  Tab 3  │  │  Tab 4  │  │  Tab 5  │
│ Feature │  │ Bug Fix │  │Refactor │  │  Tests  │  │  Docs   │
└────┬────┘  └────┬────┘  └────┬────┘  └────┬────┘  └────┬────┘
     │            │            │            │            │
     └────────────┴─────┬──────┴────────────┴────────────┘
                        │
                        ▼
              🔔 macOS Notification
              "Tab X needs your input"
                        │
                        ▼
                 สลับไป Tab นั้น

ใช้ร่วมกับ Git Worktrees

# สร้าง worktree สำหรับแต่ละ tab
git worktree add ../project-feature-a -b feature-a
git worktree add ../project-bugfix -b bugfix-123

# Tab 1: cd ../project-feature-a && claude
# Tab 2: cd ../project-bugfix && claude

Test Notification

echo '{"notification_type": "idle_prompt", "cwd": "/test"}' | \
  ~/.claude/skills/claude-km-skill/scripts/notify.sh

Optional: terminal-notifier

สำหรับ notification ที่ดีกว่า (clickable, groupable):

brew install terminal-notifier

Auto-Capture

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

Option 1: Hooks (Recommended)

# Add to ~/.claude/settings.json
{
  "hooks": {
    "Stop": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "[ ! -f docs/retrospective/$(date +%Y-%m)/retrospective_$(date +%Y-%m-%d)_*.md ] && ~/.claude/skills/claude-km-skill/scripts/auto-capture.sh . 2>/dev/null || true"
      }]
    }]
  }
}

Note: Duplicate check prevents multiple captures on the same day.

Option 2: Wrapper

# Add alias
alias claude='~/.claude/skills/claude-km-skill/scripts/claude-wrap.sh'

# Usage - shows summary and asks to capture
claude

Option 3: AI-Powered

export ANTHROPIC_API_KEY='your-key'
./scripts/ai-capture.sh .

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

See AUTO-CAPTURE.md for full documentation.

Security

สคริปต์ทั้งหมดมีการป้องกันความปลอดภัย:

Path Validation

ป้องกัน path traversal attacks - ทุกสคริปต์ตรวจสอบ path ก่อนใช้งาน:

# ❌ จะถูก reject
./init.sh "../../../etc"
./auto-capture.sh "../../sensitive"

# ✅ ใช้งานได้
./init.sh .
./init.sh /path/to/project

Input Sanitization

notify.sh sanitize ทุก input ก่อนส่งให้ osascript:

• Whitelist เฉพาะ alphanumeric, spaces, และ basic punctuation
• Validate notification types (whitelist approach)
• จำกัดความยาว input

Protected Scripts

Subagents

ตามแนวทาง Boris Cherny - ใช้ subagents เพื่อ automate workflows ที่ทำบ่อยๆ

Available Subagents

Usage

เรียกใช้ subagent ผ่าน Task tool:

Use the code-reviewer agent to review my changes

หรือใช้กับ commands:
- /review - ใช้ code-reviewer agent
- /td - ใช้ session-analyzer และ build-validator

Location

Agents ถูกติดตั้งที่ .claude/agents/ ใน project:

.claude/agents/
├── code-reviewer.md
├── code-simplifier.md
├── security-auditor.md
├── knowledge-curator.md
├── session-analyzer.md
└── build-validator.md

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

See ROADMAP.md for planned features and current progress.

Related Projects

• multi-agent-auto-skill - Multi-agent orchestration ที่ใช้ร่วมกับ skill นี้

Acknowledgments

• Inspired by Claude-Mem
• Inspired by weyermann-malt-productpage
• Built for Claude Code
• Multi-Tab workflow inspired by Boris Cherny