전체 문서
02 시스템 아키텍처

System Architecture

비공개 운영 원천과 공개 포트폴리오 계층으로 나뉜 Keystone 시스템 구조

프로젝트 생태계

Keystone은 비공개 운영 원천과 공개 전시 계층을 분리합니다. 원천은 내부에서 관리하고, 공개 가능한 정제본만 포트폴리오로 게시합니다.

프로젝트역할핵심 산출물
ai-rules비공개 규칙 원천agent rules, commands, skills, documentation policy
pkb-wiki비공개 지식 원천curated decisions, failure learning, operating notes
keystone-hub비공개 배포 원천hooks, settings, skills, agents, scripts
ai-rules-public공개 OSS 원천distributable rules package, examples, public docs
keystone-portfolio공개 전시 계층architecture notes, case studies, public methodology
product projects실전 적용 대상하네스가 적용되는 실제 제품과 작업 저장소

데이터 흐름 (5단계 순환)

flowchart TD
  A["1. 개발 세션<br/>Claude Code / Codex 작업 수행"]
  B["2. 자동 회상<br/>Memory Bank 검색과 사실 축적"]
  C["3. 선별 문서화<br/>/pkb-capture, decisions, failure learning"]
  D["4. 규칙 승격<br/>ai-rules rule / command / skill"]
  E["5. 배포<br/>keystone-hub apply, sync"]
  F["6. 공개 정제<br/>keystone-portfolio / ai-rules-public"]

  A --> B --> C --> D --> E --> A
  C --> F
  D --> F

레이어 아키텍처

keystone-hub는 4단계 레이어로 설정을 분리합니다:

flowchart TD
  U["00-universal<br/>모든 머신, OS, 회사 공통"]
  O["10-os-{macos|windows}<br/>OS별 경로, 도구, statusLine"]
  C["20-company-{personal|bs}<br/>회사별 에이전트, 스킬, 규칙"]
  L["30-machine-local<br/>시크릿, 토큰, 로컬 템플릿"]

  U -->|덮어씀| O -->|덮어씀| C -->|템플릿만| L

apply.sh --profile personal-macos 한 줄로 전체 배포:

  • $HOME 경로 자동 확장 (어떤 사용자든 동작)
  • settings.json 레이어별 deep merge (hooks 배열 합산)
  • commands, Codex skills 자동 동기화

공개 사이트는 이 배포 레이어를 그대로 복사하지 않습니다. 내부 경로와 훅 세부값을 제거한 정제본만 게시합니다.

규칙 3계층

계층소스배포 대상예시
Universalai-rules core모든 프로젝트 CLAUDE.md시크릿 금지, force-push 금지, R2 차단
Companykeystone-hub layers~/.claude/rules/브랜치 전략, QA 프로세스, 커밋 컨벤션
Personalkeystone-hub 20-company-personal~/.claude/rules/응답 언어, 신뢰도 레이블, 에이전트 모드