code-context-graph CLAUDE.md

Project instructions for Code Context Graph, a local tool that parses source code and builds a searchable graph of how the code is connected.

In plain words
What is it for?
Use them when parsing a repository, searching code relationships, checking what a change may affect, tracing program flows, or responding to updates from Git hosting services.
Why use it?
They tell the coding agent how to use the project's analysis tools and follow its repository and documentation rules.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/tae2089/code-context-graph/claude-md
Clone the repo
git clone --depth 1 https://github.com/tae2089/code-context-graph
Per session 1,336 This file is loaded in full into every session.
When invoked 1,336 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01336 $0.01336
Opus 5 $0.00668 $0.00668
Sonnet 5 $0.00267 $0.00267
Haiku 4.5 $0.00134 $0.00134

Measured 2d ago against content hash 5c4bc03a4535, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

code-context-graph CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 76 lines

How it starts

The opening of the file, as written. The whole thing — 76 lines — stays where its author put it; the contents beside it link to each section on GitHub.

code-context-graph

코드베이스를 Tree-sitter로 파싱하여 지식 그래프를 구축하는 로컬 코드 분석 도구.

Follow the global prompt rules first. This file adds project-specific skill routing for a project that uses the agent-team CLI (github.com/tae2089/agent-team) as its durable work ledger.

MCP 서버

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

  • parse_project, build_or_update_graph, run_postprocess
  • get_node, search, describe, query_graph, list_graph_stats, list_namespaces, get_minimal_context
  • get_impact_radius, trace_flow, list_cross_refs
  • detect_changes, get_affected_flows, list_flows
  • get_annotation
  • get_doc_content

HTTP 모드 (--transport streamable-http)에서는 /health/webhook 엔드포인트도 제공합니다. Webhook은 --allow-repo 플래그로 허용 리포지토리를 설정하면 활성화됩니다. 레포별 브랜치 필터링: --allow-repo "org/api:main,develop" (glob 패턴, 미지정 시 main/master 기본). GitHub (X-Hub-Signature-256) 및 Gitea (X-Gitea-Signature, X-Gitea-Event) 호환. Push 이벤트 수신 → 자동 clone/pull → 그래프 빌드 → DB 저장 파이프라인. Graceful shutdown: SIGINT/SIGTERM 시 진행 중인 clone/build에 context cancel 전파.

CLI Skills (4개)

Skill 설명
/ccg 코어 빌드 & 검색 — 파싱, 그래프 빌드, 쿼리, 검색
/ccg-analyze 코드 분석 — 영향 반경, 플로우 추적, 데드코드, 아키텍처
/ccg-annotate 어노테이션 시스템 — AI 어노테이션 워크플로우, 태그 레퍼런스
/ccg-docs 문서 — 문서 생성, RAG 인덱싱, lint

주요 커맨드:

  • ccg build [dir] — 코드 그래프 빌드 (--exclude, --no-recursive 지원)
  • ccg search <query> — 전문 검색 (어노테이션 포함)
  • ccg docs [--out dir] — 마크다운 문서 생성
  • ccg lint [--strict] — 문서 품질 체크
  • ccg annotate [file|dir] — AI 어노테이션 생성

.ccg.yaml로 exclude 패턴, DB 설정 등을 프로젝트 기본값으로 관리할 수 있습니다.

문서

상세 문서는 guide/ 디렉토리를 참조하세요:

  • CLI Reference — 전체 명령어, 플래그, 설정 파일
  • MCP Tools — 18개 MCP 도구, Skills, AI-Driven Annotation
  • Annotations — 어노테이션 태그, 예시, 검색
  • Webhook — Webhook sync, 브랜치 필터링, HMAC, graceful shutdown
  • Docker — Docker 빌드, MCP 서버, PostgreSQL 배포
  • Development — 개발 가이드, Integration test, 프로젝트 구조
  • Architecture — 데이터 흐름, 컴포넌트, DB 스키마

Read the full file on GitHub · 76 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 76 lines · 1,336 tokens per session scan A 5c4bc03a4535

Subscribe to this mod's changes

code-context-graph CLAUDE.md is an instructions file published in the GitHub repository tae2089/code-context-graph (17 stars, last pushed 11d ago), licensed MIT. It adds 1,336 tokens to every session, about $0.0067 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.