4-layer knowledge capture system for development sessions with session management, retrospectives, and knowledge distillation.

0 stars
0 forks
Shell
63 views

SKILL.md


name: dev-km description: 4-layer knowledge capture system for development sessions with session management, retrospectives, and knowledge distillation. user-invocable: false

Development Knowledge Management System

4-layer system for capturing and organizing development knowledge.

Dev Flow

/recap → /focus (issue + branch) → tdg:tdg (dev + commit) → /td (retrospective) + /mem (capture knowledge)

Core Skills (user-invocable)

Skill Layer Output Trigger
/mem [topic] 1 docs/learnings/YYYY-MM/DD/HH.MM_slug.md Quick insight capture
/distill [topic] 2 docs/knowledge-base/[topic].md 3+ learnings on same topic
/td 3 docs/retrospective/YYYY-MM/retrospective_*.md Task completed
/improve 4 Implementation Work on pending items
/recap - Context summary Start new session
/focus [task] - Issue + branch Set current task

Git & PR Skills (user-invocable)

Skill Purpose
/commit Atomic commits via TDG
/pr Tests, build, review, create PR
/review Code review before push
/pr-review Handle PR review feedback
/pr-poll PR review notification daemon

Knowledge & Docs Skills (user-invocable)

Skill Purpose
/cleanup Retention policy management
/consolidate Daily session file consolidation
/summary Weekly/monthly summaries
/search Search knowledge index
/example Save code examples
/flow Process flow diagrams
/pattern Design pattern docs
/share Cross-project knowledge sharing

Integration & Config Skills (user-invocable)

Skill Purpose
/jira Jira issue management
/permission Manage Claude Code permissions

Specialist Skills (context: fork, not user-invocable)

Skill Purpose
code-reviewer Reviews code for bugs, security, performance
session-analyzer Analyzes git changes for retrospective drafts
knowledge-curator Scans learnings, suggests distill topics
build-validator Validates build, tests, lint before push
code-simplifier Simplifies code, reduces complexity
security-auditor OWASP Top 10 security audit

Directory Structure

docs/
├── learnings/           # /mem output
│   └── YYYY-MM/DD/
├── knowledge-base/      # /distill output
├── retrospective/       # /td output
│   └── YYYY-MM/
├── auto-captured/       # Auto-capture output
├── examples/            # /example output
├── summaries/           # /summary output
├── shared-knowledge/    # /share output
├── flows/               # /flow output
├── patterns/            # /pattern output
├── logs/                # Activity log
└── current.md           # Current focus state

Setup

./scripts/init.sh $PROJECT_ROOT

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