cc-initializer

Claude Code를 위한 통합 개발 워크플로우 프레임워크

/init --full 하나로 시작하는 체계적인 개발 환경

---

Architecture

                              ┌─────────────────────────────────────┐
                              │         cc-initializer               │
                              │    ┌───────────────────────┐        │
                              │    │    settings.json      │        │
                              │    └───────────┬───────────┘        │
                              │                │                     │
          ┌────────────────────────────────────┼────────────────────────────────────┐
          │                    │               │               │                    │
          ▼                    ▼               ▼               ▼                    ▼
   ┌─────────────┐     ┌─────────────┐ ┌─────────────┐ ┌─────────────┐     ┌─────────────┐
   │   Agents    │     │   Skills    │ │  Commands   │ │    Hooks    │     │  Templates  │
   │     25      │     │     18      │ │      6      │ │      5      │     │      3      │
   └──────┬──────┘     └──────┬──────┘ └──────┬──────┘ └──────┬──────┘     └─────────────┘
          │                   │               │               │
          │    ┌──────────────┴───────────────┴───────────────┘
          │    │
          ▼    ▼
   ┌──────────────────────────────────────────────────────────────────────────────────┐
   │                              Development Flow                                     │
   │                                                                                   │
   │   Discovery ──▶ Planning ──▶ Development ──▶ Review ──▶ Release                  │
   │       │            │              │            │           │                      │
   │       ▼            ▼              ▼            ▼           ▼                      │
   │   DISCOVERY    PRD.md        /feature      /gh pr     /release                   │
   │      .md      TECH-SPEC       start        create                                │
   │               PROGRESS                                                            │
   └──────────────────────────────────────────────────────────────────────────────────┘

---

Quick Start

git clone https://github.com/tygwan/cc-initializer.git ~/dev/cc-initializer
cd your-project && claude

/init --full          # 새 프로젝트: Discovery → 문서 → Phase 구조
/init --sync          # 기존 프로젝트에 프레임워크 동기화
/init --update        # cc-initializer 최신 버전으로 업데이트

---

Component Overview

Agents 23 Category Agents Discovery project-discovery Tracking progress-tracker phase-tracker Docs dev-docs-writer doc-splitter Git commit-helper pr-creator branch-manager GitHub github-manager Quality code-reviewer test-helper Analytics analytics-reporter

Skills 18 Category Commands Init /init /validate Agile /sprint /phase Git /feature /bugfix /release GitHub /gh Docs /agile-sync /dev-doc-system Utils /analytics /repair /sync-fix

---

Workflow Commands

Initialize /init --full Discovery → PRD → Phase

Develop /feature start "name" /feature complete Branch → Code → PR

Release /release v1.0.0 Tag → Notes → Deploy

---

Integration Flow

┌─────────────────────────────────────────────────────────────────────────────────┐
│                                                                                  │
│    /init ─────────────────────────────────────────────────────────▶ Setup       │
│      │                                                                           │
│      ├──▶ project-discovery ──▶ DISCOVERY.md                                    │
│      │                              │                                            │
│      └──▶ dev-docs-writer ◀─────────┘                                           │
│                 │                                                                │
│                 ├──▶ PRD.md                                                      │
│                 ├──▶ TECH-SPEC.md      ┌─────────────────┐                      │
│                 ├──▶ PROGRESS.md  ◀────│  phase-tracker  │◀──── Hooks           │
│                 └──▶ CONTEXT.md        └─────────────────┘                      │
│                                                                                  │
│    /feature ────▶ branch-manager ──▶ commit-helper ──▶ pr-creator              │
│                                                                                  │
│    /gh ─────────▶ github-manager ──▶ Issues / PRs / CI / Releases              │
│                                                                                  │
│    /analytics ──▶ analytics-reporter ──▶ CLI Charts & Reports                  │
│                                                                                  │
└─────────────────────────────────────────────────────────────────────────────────┘

---

GitHub Integration

/gh status              # Dashboard: 이슈, PR, 멘션, CI 상태
/gh issue list          # 이슈 목록
/gh pr create           # PR 생성
/gh ci watch            # CI 실시간 모니터링
/gh release create      # 릴리스 생성

---

Analytics

도구 사용량, 에이전트 호출, 오류 패턴을 CLI 차트로 시각화합니다.

/analytics              # 전체 요약
/analytics tools        # 도구별 사용량 차트
/analytics errors       # 오류 유형 분석
/analytics agents       # 에이전트 호출 빈도

CLI Output Example:

📊 Tool Usage (Last 7 days)
─────────────────────────────────────────────
Read        ████████████████████████████ 142
Edit        ██████████████████           89
Bash        ███████████████              74
Grep        █████████                    45
Write       ███████                      35

📈 Activity Sparkline
─────────────────────────────────────────────
Mon  Tue  Wed  Thu  Fri  Sat  Sun
▂▅▇█▆▃▁

⚠️ Error Summary
─────────────────────────────────────────────
Permission denied    ██████  12
File not found       ████    8
Timeout              ██      4

Metrics 저장: .claude/analytics/metrics.jsonl (JSONL 형식, 30일 보존)

---

Phase & Sprint

Phase 1 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100%
  └── Sprint 1.1 ████████████████████ Done
  └── Sprint 1.2 ████████████████████ Done

Phase 2 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  65%
  └── Sprint 2.1 ████████████████████ Done
  └── Sprint 2.2 ████████████░░░░░░░░ In Progress

/phase status           # Phase 진행률 확인
/sprint start           # Sprint 시작
/sprint complete        # Sprint 완료 + 회고

---

Real-World Example

DXTnavis Navisworks 2025 Property Viewer & 4D Automation Stack C# .NET 4.8, WPF MVVM Phases 13 (100% Complete) Features 445K+ Properties, 4D Automation View Repository →

Phase 1-4 ████████████████████ 100% Phase 5-7 ████████████████████ 100% Phase 8 ████████████████████ 100% Phase 9-12 ████████████████████ 100% Phase 13 ████████████████████ 100%

---

Projects Using cc-initializer

Project	Description
tygwan/dxtnavis	DXT Navigator - Navisworks Plugin

Add yours: Add uses-cc-initializer topic to your repo or submit PR

---

Directory Structure

.claude/
├── settings.json       ─── Configuration hub
├── agents/        23   ─── Specialized AI agents
├── skills/        18   ─── Workflow automation
├── commands/       6   ─── Development workflows
├── hooks/          5   ─── Auto-triggers
├── scripts/            ─── Utility scripts
├── templates/          ─── Document templates
└── analytics/          ─── Usage metrics (JSONL)

---

Changelog

Version	Release
4.5.0	README Helper & Agent Writer
4.4.0	Community Project Discovery
4.3.0	GitHub CLI Integration
4.2.0	Analytics Visualization
4.1.0	Framework Update System
4.0.0	Framework Setup & Sync
3.0.0	Discovery First Workflow

All Releases →

---

Issues • Documentation • MIT License