dev-km

Files (110)

• hooks.example.json · .claude/
• notify.sh · .claude/scripts/
• settings.json · .claude/
• auto-pr-review.yml · .github/workflows/
• release.yml · .github/workflows/
• .gitignore
• AUTO-CAPTURE.md
• CHANGELOG.md
• CLAUDE.md
• LICENSE
• README.md
• ROADMAP.md
• SETUP.md
• SKILL.md
• USAGE.md
• README.md · assets/commands/
• cleanup.md · assets/commands/
• commit.md · assets/commands/
• distill.md · assets/commands/
• docs-update.md · assets/commands/
• example.md · assets/commands/
• flow.md · assets/commands/
• focus.md · assets/commands/
• improve.md · assets/commands/
• jira.md · assets/commands/
• mem.md · assets/commands/
• pattern.md · assets/commands/
• permission.md · assets/commands/
• pr-poll.md · assets/commands/
• pr-review.md · assets/commands/
• pr.md · assets/commands/
• recap.md · assets/commands/
• review.md · assets/commands/
• search.md · assets/commands/
• share.md · assets/commands/
• summary.md · assets/commands/
• td.md · assets/commands/
• .gitkeep · docs/auto-captured/
• 11.55_session-4959.md · docs/auto-captured/2026-06/19/
• current.md · docs/
• .gitkeep · docs/examples/
• .gitkeep · docs/flows/
• .gitkeep · docs/knowledge-base/
• claude-instance-configuration.md · docs/knowledge-base/
• git-workflow-patterns.md · docs/knowledge-base/
• github-api-patterns.md · docs/knowledge-base/
• heredoc-quoting.md · docs/knowledge-base/
• .gitkeep · docs/learnings/
• 17.23_no-footer-in-github-issues.md · docs/learnings/2025-12/23/
• 01.18_no-co-authored-by-in-commits.md · docs/learnings/2026-02/10/
• 01.25_global-claude-md-rules-specialist-visible.md · docs/learnings/2026-02/10/
• activity.log · docs/logs/
• .gitkeep · docs/patterns/
• .gitkeep · docs/retrospective/
• retrospective_2026-01-12_114152.md · docs/retrospective/2026-01/12/
• retrospective_2026-01-09_182730.md · docs/retrospective/2026-01/
• retrospective_2026-01-09_193400.md · docs/retrospective/2026-01/
• retrospective_2026-01-09_203700.md · docs/retrospective/2026-01/
• retrospective_2026-01-09_211600.md · docs/retrospective/2026-01/
• retrospective_2026-01-10_092500.md · docs/retrospective/2026-01/
• …and 50 more

SKILL.md (first lines)

# Development Knowledge Management System

4-layer system for capturing and organizing development knowledge.

## Dev Flow

```
/recap → /focus (issue + branch) → /tdd (red-green loop) + /commit → /td (retrospective) + /mem (capture knowledge)
```

## Core Skills (user-invocable)

| Skill | Layer | Output | Trigger |
|-------|-------|--------|---------|
| `/mem [topic]` | 1 | `kb/05-ai-reviewed/learnings/YYYY-MM/DD/HH.MM_slug.md` | Quick insight capture |
| `/distill [topic]` | 2 | `kb/02-patterns/<domain>/[topic].md` | 3+ learnings on same topic |
| `/td` | 3 | `kb/05-ai-reviewed/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 (TDD-aware, self-contained) |
| `/pr` | Tests, build, review, create PR |
| `/review` | Code review before push |
| `/pr-review` | Handle PR review feedback (own PR) |
| `/pr-audit [pr#]` | Reviewer-side deep audit of an open PR (clone+build, inline+summary) |
| `/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

```
kb/                          # symlink to Obsidian second-brain vault
├── 02-patterns/             # /distill, /pattern output (curated patterns)
│   ├── <domain>/            #   grpc, observability, database, k8s, ...
│   ├── anti-patterns/       #   anti-pattern registry
│   ├── examples/            # /example output
│   └── flows/               # /flow output
├── 03-bugs/                 # Bug postmortems (scanned by /improve)
├── 04-decisions/            # ADRs (scanned by /improve)
└── 05-ai-reviewed/
    ├── learnings/           # /mem output
    │   └── YYYY-MM/DD/
    ├── retrospective/       # /td output
    │   └── YYYY-MM/
    └── summaries/           # /summary output

docs/                        # repo-local, NOT in vault
├── auto-captured/           # Auto-capture output
├── shared-knowledge/        # /share output
├── logs/                    # Activity log
└── current.md               # Current focus state (STATE/TASK/ISSUE/BRANCH/LANGUAGE)
```

> `kb/` = symlink to the Obsidian vault. Legacy `docs/{learnings,knowledge-base,retrospective,...}` paths are deprecated.

## Setup

```bash
./scripts/init.sh $PROJECT_ROOT
```

## Language Support

Output language is configured via `LANGUAGE` field in `docs/current.md`.

| Value | Behavior |
|-------|----------|
| `en` (default) | All generated output in English |
| `th` | Generated output in Thai (commit messages stay English) |

Set during `/focus` or manually edit `docs/current.md`. See `references/language-guide.md` for translation reference.

## References

- `references/bash-helpers.md` - Common bash snippets (TZ, language detection, focus context)
- `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
- `references/language-guide.md` - Thai/English translation guide

From goffity/dev-km, MIT.

More from goffity/dev-km