Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 0 additions & 9 deletions .claude/skills/ccg-analyze/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,7 @@ Graph-based analysis for **change impact, call flow, dead code, module structure
| "Trace call flow from this function" | `trace_flow` | If broken at interfaces, see workaround below |
| "Who calls this function?" | `query_graph` (callers_of) | |
| "What does this function call?" | `query_graph` (callees_of) | |
| "Unused code" | `find_dead_code` | Interface methods may give false positives |
| "Large functions" | `find_large_functions` | Refactoring candidates |
| "Risk of this change" | `detect_changes` + `get_affected_flows` | git diff-based |
| "Module structure" | `list_communities` + `get_architecture_overview` | First time on a codebase |
| "Test coverage gaps" | `get_community` (with coverage) | |

## trace_flow Limitations & Workaround

Expand Down Expand Up @@ -67,14 +63,9 @@ If results are huge, the change scope is likely too wide. Reconsider the change
| --------------------------- | ---------------------------- |
| `get_impact_radius` | BFS blast radius |
| `trace_flow` | Call chain trace |
| `find_large_functions` | Above line threshold |
| `find_dead_code` | No callers |
| `detect_changes` | Git diff risk score |
| `get_affected_flows` | Flows affected by change |
| `list_flows` | Stored flow list |
| `list_communities` | Louvain module clusters |
| `get_community` | Community details + coverage |
| `get_architecture_overview` | Coupling summary |

For detailed parameters, see MCP schema.

Expand Down
13 changes: 6 additions & 7 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,17 +6,16 @@ Follow the global prompt rules first. This file adds project-specific skill rout

## MCP 서버

`.mcp.json`에 등록된 ccg MCP 서버가 29개 도구를 제공합니다:
`.mcp.json`에 등록된 ccg MCP 서버가 26개 도구를 제공합니다:

- `parse_project`, `build_or_update_graph`, `run_postprocess`
- `get_postprocess_policy`, `reset_postprocess_policy`
- `get_node`, `search`, `query_graph`, `list_graph_stats`, `get_minimal_context`
- `get_impact_radius`, `trace_flow`
- `find_large_functions`, `find_dead_code`
- `get_impact_radius`, `trace_flow`, `find_suspect_fallback_edges`
- `detect_changes`, `get_affected_flows`, `list_flows`
- `list_communities`, `get_community`, `get_architecture_overview`
- `get_annotation`
- `build_rag_index`, `get_rag_tree`, `get_doc_content`, `search_docs`
- `upload_file`, `upload_files`, `list_workspaces`, `list_files`, `delete_file`, `delete_workspace`
- `get_doc_content`, `search_docs`, `retrieve_docs`
- `upload_file`, `upload_files`, `list_files`, `delete_file`, `list_namespaces`, `delete_namespace`

HTTP 모드 (`--transport streamable-http`)에서는 `/health` 및 `/webhook` 엔드포인트도 제공합니다.
Webhook은 `--allow-repo` 플래그로 허용 리포지토리를 설정하면 활성화됩니다.
Expand Down Expand Up @@ -50,7 +49,7 @@ Graceful shutdown: SIGINT/SIGTERM 시 진행 중인 clone/build에 context cance
상세 문서는 `guide/` 디렉토리를 참조하세요:

- [CLI Reference](guide/cli-reference.md) — 전체 명령어, 플래그, 설정 파일
- [MCP Tools](guide/mcp-tools.md) — 29개 MCP 도구, Skills, AI-Driven Annotation
- [MCP Tools](guide/mcp-tools.md) — 26개 MCP 도구, Skills, AI-Driven Annotation
- [Annotations](guide/annotations.md) — 어노테이션 태그, 예시, 검색
- [Webhook](guide/webhook.md) — Webhook sync, 브랜치 필터링, HMAC, graceful shutdown
- [Docker](guide/docker.md) — Docker 빌드, MCP 서버, PostgreSQL 배포
Expand Down
5 changes: 0 additions & 5 deletions guide/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,11 +54,6 @@ queries.
|--------|-------------|
| `impact` | BFS blast-radius analysis |
| `flows` | Call-chain flow tracing |
| `deadcode` | Unused code detection |
| `community` | Directory-based module communities |
| `coupling` | Inter-module coupling analysis |
| `coverage` | Test coverage analysis |
| `largefunc` | Large function detection |
| `changes` | Git diff risk scoring |
| `query` | Graph queries (callers, callees, imports) |
| `incremental` | Incremental update |
Expand Down
2 changes: 1 addition & 1 deletion guide/cli-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ CCG has two search surfaces with different jobs:
|----------|----------------------|
| Natural-language code understanding, module exploration, architecture questions | `ccg docs`, then MCP `retrieve_docs`, `get_rag_tree`, `get_doc_content` |
| Exact symbol lookup, callers/callees, imports, bounded graph traversal | MCP `get_node`, `query_graph`, `get_minimal_context` |
| Impact analysis, flow tracing, dead code, large functions | MCP analysis tools such as `get_impact_radius`, `trace_flow`, `find_dead_code`, `find_large_functions` |
| Impact analysis, flow tracing | MCP analysis tools such as `get_impact_radius`, `trace_flow` |
| Focused annotation/keyword candidate search | `ccg search` or MCP `search` |

For coding agents, the recommended natural-language path is:
Expand Down
5 changes: 0 additions & 5 deletions guide/ko/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,11 +51,6 @@ GORM ORM 기반 저장소입니다. SQLite 및 PostgreSQL과 호환됩니다.
|--------|-------------|
| `impact` | BFS 영향 범위 분석 |
| `flows` | 호출 체인 흐름 추적 |
| `deadcode` | 사용되지 않는 코드 감지 |
| `community` | 디렉토리 기반 모듈 커뮤니티 분석 |
| `coupling` | 모듈 간 결합도 분석 |
| `coverage` | 테스트 커버리지 분석 |
| `largefunc` | 대규모 함수 감지 |
| `changes` | Git diff 리스크 점수 계산 |
| `query` | 그래프 쿼리 (callers, callees, imports) |
| `incremental` | 증분 업데이트 |
Expand Down
2 changes: 1 addition & 1 deletion guide/ko/cli-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ CCG에는 역할이 다른 두 검색 표면이 있습니다.
|----------|-------------|
| 자연어 기반 코드 이해, 모듈 탐색, 아키텍처 질문 | `ccg docs`, 이후 MCP `retrieve_docs`, `get_rag_tree`, `get_doc_content` |
| 정확한 심볼 조회, caller/callee, import, bounded graph traversal | MCP `get_node`, `query_graph`, `get_minimal_context` |
| 영향 분석, flow 추적, dead code, large function | `get_impact_radius`, `trace_flow`, `find_dead_code`, `find_large_functions` 같은 MCP 분석 도구 |
| 영향 분석, flow 추적 | `get_impact_radius`, `trace_flow` 같은 MCP 분석 도구 |
| 어노테이션/키워드 기반 후보 검색 | `ccg search` 또는 MCP `search` |

코딩 에이전트의 자연어 탐색에는 다음 흐름을 권장합니다.
Expand Down
7 changes: 2 additions & 5 deletions guide/ko/mcp-tools.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,8 +62,6 @@ CCG는 아직 Prometheus `/metrics` 엔드포인트를 제공하지 않습니다
|------|-------------|
| `get_impact_radius` | BFS 영향 범위(blast-radius) 분석 |
| `trace_flow` | 호출 체인 흐름 추적 |
| `find_large_functions` | 라인 제한을 초과하는 함수 찾기; `limit` 지원 |
| `find_dead_code` | 사용되지 않는 코드 감지 |
| `find_suspect_fallback_edges` | 의심스러운 fallback 호출 엣지 품질 리포트, 페이지네이션 지원 |
| `detect_changes` | Git diff 리스크 점수 계산 |
| `get_affected_flows` | 변경 사항의 영향을 받는 흐름 확인 |
Expand Down Expand Up @@ -93,9 +91,8 @@ CCG는 아직 Prometheus `/metrics` 엔드포인트를 제공하지 않습니다
| `get_architecture_overview` | `community_limit`, `community_offset`, `coupling_limit`, `coupling_offset` | 커뮤니티와 결합도에 별도 페이지네이션 객체 포함 |

일부 분석 도구는 아직 내부적으로 전체 결과를 조회합니다. 큰 네임스페이스에서는
`find_dead_code`, `find_suspect_fallback_edges`, 또는 광범위한 MCP prompt를
호출하기 전에 입력 범위를 좁히십시오. `find_large_functions`는 `limit`을
받지만 현재는 라인 기준 쿼리를 수행한 뒤 응답을 자릅니다.
`find_suspect_fallback_edges` 또는 광범위한 MCP prompt를 호출하기 전에 입력
범위를 좁히십시오.

### 어노테이션 및 문서화 (Annotation & Documentation)

Expand Down
4 changes: 1 addition & 3 deletions guide/ko/operations.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,10 +68,8 @@

사용 전에 범위를 좁혀야 하는 고용량 표면:

- `find_dead_code`는 네임스페이스의 모든 미참조 노드를 반환할 수 있습니다.
- `find_suspect_fallback_edges`는 모든 의심 fallback edge를 반환할 수 있습니다.
- `find_large_functions`는 `limit`을 받지만 현재 구현은 모든 매칭 함수를 찾은 뒤 응답을 자릅니다.
- architecture/onboarding 같은 MCP prompt는 넓은 프로젝트 상태를 요약하므로 네임스페이스로 그래프를 좁힌 뒤 사용하는 것이 좋습니다.
- onboarding 같은 MCP prompt는 넓은 프로젝트 상태를 요약하므로 네임스페이스로 그래프를 좁힌 뒤 사용하는 것이 좋습니다.

공유 서비스에서는 광범위한 분석 요청보다 경로 필터, 네임스페이스 분리,
페이지네이션 도구를 우선하십시오. 예상보다 큰 도구 응답은 네임스페이스가 너무
Expand Down
8 changes: 2 additions & 6 deletions guide/mcp-tools.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,8 +69,6 @@ current machine-readable operational surfaces.
|------|-------------|
| `get_impact_radius` | BFS blast-radius analysis |
| `trace_flow` | Call-chain flow tracing |
| `find_large_functions` | Functions exceeding line threshold; supports `limit` |
| `find_dead_code` | Unused code detection |
| `find_suspect_fallback_edges` | Suspect fallback call-edge quality report with pagination |
| `detect_changes` | Git diff risk scoring |
| `get_affected_flows` | Flows affected by changes |
Expand Down Expand Up @@ -99,10 +97,8 @@ communities, members, or coupling pairs. Paginated responses include
| `get_architecture_overview` | `community_limit`, `community_offset`, `coupling_limit`, `coupling_offset` | Response includes separate community and coupling pagination objects |

Some analysis tools still return full result sets internally. On large
namespaces, prefer scoped inputs before calling `find_dead_code`,
`find_suspect_fallback_edges`, or broad MCP prompts. `find_large_functions`
accepts `limit`, but it currently performs the line-threshold query before
truncating the response.
namespaces, prefer scoped inputs before calling `find_suspect_fallback_edges`
or broad MCP prompts.

### Annotation & Documentation

Expand Down
5 changes: 1 addition & 4 deletions guide/operations.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,11 +80,8 @@ responses inspectable and reduces context pollution.

Known high-volume surfaces that should be scoped before use:

- `find_dead_code` can return every unreferenced node in a namespace.
- `find_suspect_fallback_edges` can return every suspect fallback edge.
- `find_large_functions` accepts `limit`, but the current implementation still
finds all matching functions before truncating the response.
- MCP prompts such as architecture and onboarding prompts summarize broad
- MCP prompts such as onboarding prompts summarize broad
project state and are best used after the graph has been scoped by namespace.

For shared services, prefer path filters, namespace splitting, and paginated
Expand Down
Loading
Loading