Ontology

---
name: ontology
description: Use when you need to query, manage, or visualize the project-level ontology.
user-invocable: false
---

# Ontology Skill

Query, manage, and visualize the project's ontology.

## Usage

/team-shinchan:ontology [subcommand] [args]

## Subcommands

### show (default)
Display ontology summary with key metrics.
- Run: `node ${CLAUDE_PLUGIN_ROOT}/src/ontology-engine.js summary`
- Show: entity count, relation count, type distribution, top connected entities

### query <term>
Search for entities by name or type.
- Usage: `/team-shinchan:ontology query Payment`
- Usage: `/team-shinchan:ontology query --type Component`
- Run: `node ${CLAUDE_PLUGIN_ROOT}/src/ontology-engine.js query --name <term>` or `--type <type>`
- Display matching entities with their relations

### add <type> <name> [properties]
Manually add an entity (for domain concepts, decisions, patterns).
- Usage: `/team-shinchan:ontology add DomainConcept "User Authentication"`
- Usage: `/team-shinchan:ontology add Decision "Use REST over GraphQL" --rationale "Simpler for our team size"`
- Create entity via ontology-engine.js addEntity

### remove <entity-id>
Remove an entity and its relations.
- Usage: `/team-shinchan:ontology remove comp-a3f2`
- Cascade removes all connected relations

### scan
Trigger a full re-scan of the project.
- Usage: `/team-shinchan:ontology scan`
- Usage: `/team-shinchan:ontology scan --module src/services`
- Run scanner and merge results

### auto-scan
LLM 구동 온톨로지 자동 스캔 — 코드베이스를 분석하여 새 엔티티를 제안.
- Usage: `/team-shinchan:ontology auto-scan --check` — 발견된 엔티티 후보 리포트 (수정 없음)
- Usage: `/team-shinchan:ontology auto-scan --write` — 검토 후 ontology.json에 병합
- Run: `node ${CLAUDE_PLUGIN_ROOT}/src/ontology-engine.js auto-scan --check|--write`
- CI: `bash ${CLAUDE_PLUGIN_ROOT}/scripts/ontology-check.sh` — --check 모드로 차이 보고
- 주의: --write 실행 전 반드시 --check 결과를 사람이 검토할 것 (LLM 환각 방지)

### gen-kb
Regenerate kb-summary.md from ontology.
- Usage: `/team-shinchan:ontology gen-kb`
- Run: `node ${CLAUDE_PLUGIN_ROOT}/src/ontology-engine.js gen-kb`

### diagram [scope]
Generate a Mermaid diagram.
- Usage: `/team-shinchan:ontology diagram modules` — Module dependency graph
- Usage: `/team-shinchan:ontology diagram domain` — Domain concept map
- Usage: `/team-shinchan:ontology diagram entity <id>` — Entity neighborhood

## Graceful Degradation

If no ontology exists:
- Display: "No ontology found. Run `/team-shinchan:ontology scan` or wait for next session start to auto-build."
- All subcommands should handle missing ontology gracefully