Tree Parse Skill

Name: tree-parse
Rating: 76
Author: 0pg

목적

프로젝트 디렉토리 구조를 분석하여 CLAUDE.md가 필요한 위치를 식별. Rust CLI claude-md-core parse-tree를 래핑.

입력

code

root_path: 프로젝트 루트 경로 (기본: 현재 디렉토리)

출력

.claude/extract-tree.json 파일 생성

json

{
  "root": "/path/to/project",
  "needs_claude_md": [
    {
      "path": "src",
      "source_file_count": 2,
      "subdir_count": 3,
      "reason": "2 source files and 3 subdirectories",
      "depth": 1
    },
    {
      "path": "src/auth",
      "source_file_count": 4,
      "subdir_count": 1,
      "reason": "4 source files",
      "depth": 2
    }
  ],
  "excluded": ["node_modules", "target", "dist"]
}

워크플로우

1. CLI 빌드 확인

bash

CORE_DIR="${CLAUDE_PLUGIN_ROOT}/core"
CLI_PATH="$CORE_DIR/target/release/claude-md-core"
if [ ! -f "$CLI_PATH" ]; then
    echo "Building claude-md-core..."
    cd "$CORE_DIR" && cargo build --release
fi

2. 트리 파싱 실행

bash

mkdir -p .claude
$CLI_PATH parse-tree --root {root_path} --output .claude/extract-tree.json

3. 결과 확인

bash

# 파일 존재 및 유효성 확인
if [ -f ".claude/extract-tree.json" ]; then
    echo "Tree parsing completed successfully"
    echo "Output: .claude/extract-tree.json"
else
    echo "Error: Tree parsing failed"
    exit 1
fi

결과 반환

code

---tree-parse-result---
output_file: .claude/extract-tree.json
status: success
directory_count: {needs_claude_md 배열 길이}
---end-tree-parse-result---

제외 디렉토리 (Exclude)

기본적으로 다음 디렉토리는 자동 제외됨:

•node_modules, target, dist, build, __pycache__, .git, .claude
•빌드 산출물 및 의존성 디렉토리

제외 목록은 lib.rs의 EXCLUDED_DIRS 상수에 정의됨.

DO / DON'T

DO:

•CLI 빌드 상태 확인 후 실행
•구조화된 결과 블록 (---tree-parse-result---) 반환
•제외 디렉토리 목록 확인

DON'T:

•빌드 실패 시 진행하지 않음
•결과 JSON을 직접 수정하지 않음
•제외 디렉토리 내부를 분석하지 않음

참조 자료

•examples/tree.json: tree-parse 출력 JSON 예시

오류 처리

상황	대응
CLI 빌드 실패	에러 메시지 출력, 실패 반환
루트 경로 없음	에러 메시지 출력, 실패 반환
파싱 실패	CLI 에러 메시지 전달