GRAPHIFORGE 4-DOMAIN + CORE ARCHITECTURE & SKILL SUITE

GraphiForge 4대 도메인 + Core 통합 포털

스타일 테마 관리 · 다이어그램 작성 · 갤러리 뷰어 · 다이어그램 작성 패턴 관리의 4개 독립 도메인과 TypeSpec(.tsp) 단일 진실 공급원 기반 2-Stage CLI & MCP Handoff 코어로 구성된 통합 허브입니다.

🚀 스튜디오에서 직접 만들어보기 → 🎨 테마 미리보기 🧲 작성 피드백 데모
PART 1 · STYLE & THEME MANAGEMENT

1. 스타일 테마 관리 (graphiforge-style-themes)

14종 내장 테마 프리셋(라이트 10종 + 다크 4종), 17종 단축 별칭, 커스텀 .theme.json 스키마 및 다크·라이트 명도 대비 자동 보정을 전담합니다.

  • 도메인 모듈: packages/cli/src/domains/style-themes/index.ts
  • 전담 스킬 / 문서: skills-packages/graphiforge-style-themes · docs/01-style-themes/README.md
  • 핵심 CLI / MCP: graphiforge style list-presets (style_list_presets) · style apply-theme (style_apply_theme)
🎨 14종 테마 갤러리 열기 →
PART 2 · DIAGRAM AUTHORING

2. 다이어그램 작성 (graphiforge-diagram-authoring)

24종 기본 내장 Edge 작성 문법(선 패턴 7종, 단자/ERD 까마귀발 9종, 방위 포트 8종), 시맨틱 노드 클래스, ERD <TABLE> 작성 및 무겹침 SVG 렌더링을 전담합니다.

  • 도메인 모듈: packages/cli/src/domains/diagram-authoring/index.ts
  • 전담 스킬 / 문서: skills-packages/graphiforge-diagram-authoring · docs/02-diagram-authoring/README.md
  • 핵심 CLI / MCP: graphiforge style render (style_render) · style edge-specs (style_edge_specs)
🛠️ 실시간 DOT Edge 조합기 열기 → 24종 Edge 작성 표본 보기
PART 3 · GALLERY VIEWER

3. 갤러리 뷰어 (graphiforge-gallery-viewer)

3단 테마 비교 뷰어(Arch + ERD + Ortho-Edge), 실시간 DOT Edge 조합기, 흑백/라이트 즉시 전환 뷰어 및 정적 HTML 포털 생성을 전담합니다.

  • 도메인 모듈: packages/cli/src/domains/gallery-viewer/index.ts
  • 전담 스킬 / 문서: skills-packages/graphiforge-gallery-viewer · docs/03-gallery-viewer/README.md
  • 핵심 CLI / MCP: graphiforge style build-gallery (style_build_gallery) · style gallery · style edge-catalog
🖼️ 테마 갤러리 뷰어 📐 Edge 카탈로그 뷰어
PART 4 · DIAGRAM PATTERN MANAGEMENT

4. 다이어그램 작성 패턴 관리 (graphiforge-diagram-patterns)

8종 라우팅 기하학(ortho-rounded, ortho, line_jump, bus, erd-step)과 6대 상황별 선 정렬 레시피(S1~S6) 및 아키텍처 템플릿을 전담합니다.

  • 도메인 모듈: packages/cli/src/domains/diagram-patterns/index.ts
  • 전담 스킬 / 문서: skills-packages/graphiforge-diagram-patterns · docs/04-diagram-patterns/README.md
  • 핵심 CLI / MCP: graphiforge style patterns [S1..S6] -o out.dot (style_patterns) · template list
🧭 8종 라우팅 기하학 보기 → 📏 6대 상황별 정렬 레시피 (S1~S6)
PART 5 (CORE) · 2-STAGE CLI & MCP HANDOFF PIPELINE

5. 2-Stage CLI & MCP Handoff 코어 (cli-anything-graphiforge)

단일 TypeSpec(packages/cli/tsp/graphiforge-tools.tsp) SSOT에서 24개 도메인 도구 + 9개 R1~R5 예약 프로토콜 도구(총 33개 MCP 도구), 6종 문서 표준 테이블 어댑터(UnifiedTableIR), R1 디스크 Undo/Redo 및 R4 Handoff Envelope를 통합 구동합니다.

  • SSOT & 파이프라인: packages/cli/tsp/graphiforge-tools.tsp · packages/cli/src/pipeline/hydrator.ts
  • 전담 스킬 / 문서: skills-packages/cli-anything-graphiforge · docs/05-cli-mcp-handoff/README.md
  • 핵심 CLI / MCP: graphiforge table extract|apply-ops · style scenarios · mcp serve · npm run structure:improve
⚡ Dual-Surface CLI & MCP API 포털 열기 → 🎨 14종 테마 갤러리 📐 24종 Edge 디자인 카탈로그
MULTI-ANGLE DOCUMENTATION SUITE · 5 GUIDES

다각도 운영·개발·사용·다이어그램 관리·시나리오 5대 가이드 체계 (docs/guides/)

사용자·개발자·운영자·문서 관리자·AI 에이전트 오케스트레이터 각각의 관점에서 GraphiForge를 즉시 활용하고 유지보수할 수 있는 5대 표준 가이드입니다.

  • 1. 사용 가이드 (User Guide): docs/guides/01-user-guide.md — CLI · HTML 포털 · AI 스킬 · MCP 4대 표면별 사용법 및 테마/선/패턴 선택 매트릭스
  • 2. 개발 가이드 (Developer Guide): docs/guides/02-developer-guide.md — 4대 도메인 모듈 확장, TypeSpec(.tsp) SSOT 컴파일 파이프라인, 테스트 작성 규격
  • 3. 운영 가이드 (Operations Guide): docs/guides/03-operations-guide.md — Stage 2 mcp-use 서버 배포, R1~R5 상태 스토어 운영, structure:improve 재귀개선 자동화 런북
  • 4. 작성된 다이어그램 관리 가이드 (Diagram Lifecycle Guide): docs/guides/04-diagram-lifecycle-guide.md — .dot 검증/자동교정(fix), AST 비교(diff), 서브그래프 슬라이싱(focus), ERD UnifiedTableIR 진화
  • 5. 유저 시나리오별 대응 플레이북 (User Scenarios Playbook): docs/guides/05-user-scenarios-playbook.md — 실전 10대 유저 시나리오(U1~U10) 문제 해결 공식 및 CLI/MCP 체인
END-TO-END USER SCENARIO PLAYBOOKS (U1 ~ U10)

유저 시나리오별 대응 플레이북 (graphiforge style scenarios [U1..U10])

실무에서 가장 빈번하게 마주치는 10가지 다이어그램 작성·운영 시나리오별 최적 테마, 라우팅 기하학, 정렬 레시피(S1~S6) 및 원클릭 스캐폴딩 명령입니다.

U1 · 클라우드 아키텍트 / 백엔드 테크리드

U1. 클라우드 마이크로서비스 & 다중 VPC 계층 아키텍처 설계

5단계 중첩 클러스터(Region -> VPC -> Subnet -> Service Group) 안에서 메인 API 요청 경로가 흔들리지 않고 수직 척추를 유지하며, 보조 캐시/인증 서비스가 좌우로 정돈된 클라우드 아키텍처 도면을 작성해야 할 때.

  • 권장 조합: 테마 cloud-light · 라우팅 ortho-rounded + line_jump · 레시피 S1, S2, S4
  • 즉시 스캐폴딩 CLI: graphiforge style scenarios U1 -o ./cloud-msa.dot
  • 렌더링 CLI: graphiforge style ./cloud-msa.dot -t cloud-light -r ortho-rounded --line-jump -o ./cloud-msa.svg
U2 · 연구자 / 특허 명세서 작성자 / 기술 서적 저자

U2. 흑백 논문·특허·인쇄용 고대비(Monochrome) 기술 도면 작성

색상 구분이 불가능한 흑백 인쇄 환경에서 선의 굵기(bold/solid), 패턴(dashed/dotted/double), 단자 마커(normal/onormal/vee/diamond) 및 교차 반원 브릿지(⌒)만으로 5단계 호출 위계를 완벽히 구분해야 할 때.

  • 권장 조합: 테마 high-contrast · 라우팅 ortho-rounded + line_jump · 레시피 S6, S1
  • 즉시 스캐폴딩 CLI: graphiforge style scenarios U2 -o ./patent-mono.dot
  • 렌더링 CLI: graphiforge style ./patent-mono.dot -t high-contrast -r ortho-rounded --line-jump -o ./patent-mono.svg
U3 · 데이터베이스 엔지니어 / 백엔드 개발자

U3. 다중 외래키(FK) 관계형 DB ERD 설계 및 인플레이스 스키마 진화

HTML

기반 ERD에서 한 테이블이 다른 테이블을 2회 이상 참조(예: buyer_id, approver_id)할 때 글씨 침범과 세로선 겹침을 방지하고, CLI/MCP를 통해 테이블 컬럼을 안전하게 추가·수정해야 할 때.

  • 권장 조합: 테마 cloud-light · 라우팅 erd-step + line_jump · 레시피 S5
  • 즉시 스캐폴딩 CLI: graphiforge style scenarios U3 -o ./commerce-erd.dot
  • 렌더링 CLI: graphiforge style ./commerce-erd.dot -t cloud-light -r erd-step --line-jump -o ./commerce-erd.svg
U4 · 플랫폼 엔지니어 / 메시징 아키텍트

U4. 1:N 이벤트 브로드캐스트 버스 분기 & DLQ 외곽 재시도 루프

단일 이벤트 브로커(Kafka/EventBridge)에서 4개 이상의 컨슈머 워커로 분기할 때 거미줄 같은 대각선 대신 수평 공유 버스(Bus Trunk)로 정돈하고, 실패 이벤트를 우측 외곽 루프로 재시도할 때.

  • 권장 조합: 테마 nordic-frost · 라우팅 bus · 레시피 S3, S4
  • 즉시 스캐폴딩 CLI: graphiforge style scenarios U4 -o ./event-bus.dot
  • 렌더링 CLI: graphiforge style ./event-bus.dot -t nordic-frost -r bus -o ./event-bus.svg
U5 · SRE / 인프라 엔지니어

U5. Multi-AZ Active-Standby 이중화 & 수평 동급 피어 복제 토폴로지

Active-Standby DB 쌍이나 Multi-AZ 대칭 노드를 동일한 수평 행(rank=same)에 고정하고, 이중 평행선(style="double")으로 고대역폭 동기 복제 채널을 표현해야 할 때.

  • 권장 조합: 테마 emerald-mint · 라우팅 ortho-rounded · 레시피 S2, S1
  • 즉시 스캐폴딩 CLI: graphiforge style scenarios U5 -o ./ha-replication.dot
  • 렌더링 CLI: graphiforge style ./ha-replication.dot -t emerald-mint -r ortho-rounded -o ./ha-replication.svg
U6 · DevOps / 플랫폼 관제 엔지니어

U6. 다크 모드 관제(NOC) 대시보드 & 리소스 헬스 상태 시각화

다크 테마(enterprise-blueprint, obsidian-emerald, cloud-dark) 환경에서 밝은 파스텔 색상이 하드코딩된 다이어그램의 눈부심을 자동으로 보정하고, 노드의 정상/저하/장애(healthy/degraded/failed) 상태를 검증·시각화할 때.

  • 권장 조합: 테마 enterprise-blueprint · 라우팅 ortho-rounded + line_jump · 레시피 S1, S4
  • 즉시 스캐폴딩 CLI: graphiforge style scenarios U6 -o ./noc-ops.dot
  • 렌더링 CLI: graphiforge style ./noc-ops.dot -t enterprise-blueprint -r ortho-rounded --line-jump -o ./noc-ops.svg
U7 · 결제/주문 도메인 설계자 / QA 엔지니어

U7. 유한 상태 머신(FSM) 설계 및 데드락·도달불가 상태 정적 검증

주문·결제 상태 전이 다이어그램에서 시작 상태 누락, 도달 불가능 상태(Unreachable), 빠져나올 수 없는 데드락 상태(Deadlock)를 CLI/MCP로 정적 검증(validate --fsm)한 뒤 출판용 SVG로 렌더링할 때.

  • 권장 조합: 테마 lavender-indigo · 라우팅 ortho-rounded · 레시피 S1, S4
  • 즉시 스캐폴딩 CLI: graphiforge style scenarios U7 -o ./order-fsm.dot
  • 렌더링 CLI: graphiforge style ./order-fsm.dot -t lavender-indigo -r ortho-rounded -o ./order-fsm.svg
U8 · 아키텍처 문서 관리자 / 기술 문서 엔지니어

U8. 레거시 .dot 다이어그램 오타 자동 교정, 서브그래프 추출 및 AST Diff 감사

수작업으로 작성되어 오타가 섞이거나 거대해진 기존 .dot 파일을 자동 교정(fix)하고, 특정 핵심 노드 주변 의존성만 슬라이싱(focus/query)하거나 이전 버전과의 구조적 차이(diff)를 추적해야 할 때.

  • 권장 조합: 테마 amber-sand · 라우팅 ortho-rounded + line_jump · 레시피 S1, S2
  • 즉시 스캐폴딩 CLI: graphiforge style scenarios U8 -o ./legacy-arch.dot
  • 렌더링 CLI: graphiforge style ./modernized-arch.dot -t amber-sand -r ortho-rounded --line-jump -o ./modernized-arch.svg
U9 · AI 에이전트 오케스트레이터 / MCP 워크플로우 개발자

U9. AI 에이전트 간 2-Stage Dry-Run 계획 수립 · OCC 지문 검증 재개 · 디스크 Undo/Redo

Stage 1 CLI 에이전트가 파일을 직접 덮어쓰지 않고 --dry-run으로 변경 계획(preview-bundle/v1 + handoff-envelope/v1)만 생성한 뒤, 사용자 승인 후 Stage 2 MCP 에이전트가 expectedBeforeFingerprint 충돌 검증을 거쳐 안전하게 커밋하거나 즉시 롤백(session undo)해야 할 때.

  • 권장 조합: 테마 rose-quartz · 라우팅 ortho-rounded · 레시피 S1, S5
  • 즉시 스캐폴딩 CLI: graphiforge style scenarios U9 -o ./handoff-schema.dot
  • 렌더링 CLI: graphiforge session redo handoff-demo
U10 · 데브옵스 / 문서 플랫폼 메인테이너

U10. CI/CD 다중 테마·포털 일괄 빌드 및 100점 정량 루브릭 재귀개선 게이트 운영

저장소의 TypeSpec(.tsp) SSOT, 5대 스킬 패키지, 5대 파트 문서, 5대 심층 가이드, 70종 SVG 및 4대 HTML 포털이 항상 100/100 정합성을 유지하도록 자동 감사(audit) 및 자기치유 재귀개선(improve) 루프를 운영할 때.

  • 권장 조합: 테마 obsidian-emerald · 라우팅 ortho-rounded + line_jump · 레시피 S1, S3, S6
  • 즉시 스캐폴딩 CLI: npm run structure:verify
  • 렌더링 CLI: npm --workspace=@graphiforge/cli test