MikeCheng1208/BattleTree

Arach를 위한 개인 메타 스킬입니다. arach의 프로젝트, 규칙, 사용 가능한 스킬을 이해하기 위한 진입점 역할을 합니다. 'arach의 프로젝트', 'arach가 뭘 작업하나요?' 또는 arach/* 저장소에서 작업할 때 활성화됩니다.

BattleTree란 무엇인가요?

이 스킬은 Arach(@arach) 개발자의 프로젝트, 규칙, 작업 흐름을 이해하기 위한 개인 메타 인덱스입니다. Claude Code, Cursor, Codex 등 AI 에이전트 플랫폼에서 작동하며, 사용자가 'arach의 프로젝트' 또는 'arach가 뭘 작업하나요?'라고 묻거나 arach/* 저장소에서 작업할 때 자동으로 활성화됩니다. 스킬은 pnpm 패키지 매니저 사용, gitmoji 커밋 메시지, 공동 작성자 속성 금지 등 엄격한 규칙을 정의하며, dewey(문서 툴킷), arc(아키텍처 다이어그램 편집기) 등 주요 프로젝트와 Talkie, Scout 같은 macOS/iOS 앱, web 속성, 라이브러리를 체계적으로 정리합니다. 또한 각 프로젝트의 스킬 설치 방법, 기술 스택 선호도(React + TypeScript + TailwindCSS, Swift/SwiftUI, Tauri), 일반 명령어, 디렉터리 구조를 제공하여 AI 에이전트가 컨텍스트에 맞게 작업을 수행할 수 있도록 지원합니다. 새로운 머신에서 이 메타 스킬을 설치하면 모든 프로젝트 정보를 한 번에 파악할 수 있어 생산성을 크게 향상시킵니다.

지원 대상✓Claude Code~Codex CLI~Cursor

npx skills add https://github.com/MikeCheng1208/BattleTree/tree/HEAD/.agents/skills/arach

문서

arach

Arach(@arach)의 개인 스킬 인덱스입니다. 제 프로젝트, 규칙 및 코드베이스 작업 방법을 이해하기 위한 진입점입니다.

규칙

내 프로젝트에서 작업할 때는 항상 다음을 따르세요:

npm 대신 pnpm을 사용합니다 (먼저 pnpm-lock.yaml이 있는지 확인).
모든 커밋 메시지에 gitmoji를 추가합니다 (✨ 기능, 🐛 수정, 🎨 개선 등).
공동 작성자 표시나 "Claude Code로 생성됨" 바닥글을 절대 추가하지 마십시오.
모든 Puppeteer 사용을 묻지 않고 허용합니다.
새 파일을 만드는 것보다 기존 파일을 편집하는 것을 선호합니다.

주요 프로젝트

문서화 및 개발 도구

프로젝트	설명	스킬
dewey	AI 에이전트 지원 문서를 위한 문서화 도구 모음	`npx skills add arach/dewey`
arc	시각적 아키텍처 다이어그램 편집기	`npx skills add arach/arc`
og	Open Graph 이미지 생성기	—
hooked	Claude Code를 위한 음성 및 until 루프	—

앱 — macOS/iOS

프로젝트	설명	경로
Talkie	음성 대화 앱	`~/dev/talkie`
Scout	오디오 전사	`~/dev/scout`
Speakeasy	음성 비서	`~/dev/speakeasy`
Pomo	포모도로 타이머	`~/dev/pomo`
Tempo	시간 추적	`~/dev/tempo`

웹 속성

프로젝트	설명	경로
arach.dev	개인 사이트	`~/dev/arach.dev`
arach.io	포트폴리오	`~/dev/arach.io`
usetalkie.com	Talkie 랜딩 페이지	`~/dev/usetalkie.com`
agentlist.io	AI 에이전트 디렉토리	`~/dev/agentlist.io`

라이브러리 및 실험

프로젝트	설명	경로
agentloop	에이전트 루프 기본 요소	`~/dev/agentloop`
fabric	UI 프레임워크 실험	`~/dev/fabric`

스킬 설치

특정 프로젝트에서 작업할 때 더 깊은 컨텍스트를 위해 해당 프로젝트의 스킬을 설치합니다:

# 모든 arach 스킬 설치 (이 메타 스킬)
npx skills add arach/arach

# 특정 프로젝트 스킬 설치
npx skills add arach/arc        # 아키텍처 다이어그램
npx skills add arach/dewey      # 문서화 도구 모음

프로젝트 탐지

제가 언급하거나 작업 중임을 감지했을 때:

컨텍스트	동작
`~/dev/arc` 또는 "아키텍처 다이어그램"	arc-diagrams 스킬 로드
`~/dev/dewey` 또는 "문서화"	dewey-docs 스킬 로드
`~/dev/talkie` 또는 "음성 앱"	Swift/SwiftUI macOS 앱 컨텍스트
다른 `~/dev/*` 프로젝트	먼저 로컬 CLAUDE.md 확인

기술 스택 선호도

카테고리	선호도
패키지 관리자	pnpm
프론트엔드	React + TypeScript + TailwindCSS
데스크탑 앱	Swift/SwiftUI (macOS), Tauri (크로스 플랫폼)
빌드 도구	Vite, Turbo
테스트	Vitest, Playwright
상태 관리	Zustand

일반 명령어

# 개발
pnpm dev          # 개발 서버 시작
pnpm build        # 프로덕션 빌드
pnpm test         # 테스트 실행
pnpm lint         # 코드 린트

# Swift/macOS
swift build       # Swift 패키지 빌드
swift run         # 디버그 모드로 실행

# Git (항상 gitmoji 사용)
git commit -m "✨ 새로운 기능 추가"
git commit -m "🐛 컴포넌트 버그 수정"
git commit -m "🎨 코드 구조 개선"
git commit -m "📝 문서 업데이트"
git commit -m "🔧 설정 업데이트"

디렉토리 구조

~/dev/
├── arach/          # 이 저장소 (GitHub 프로필 + 메타 스킬)
├── arc/            # 아키텍처 다이어그램 [스킬 있음]
├── dewey/          # 문서화 도구 모음 [스킬 있음]
├── talkie/         # 음성 대화 앱
├── speakeasy/      # 음성 비서
├── arach.dev/      # 개인 웹사이트
├── ...             # ~100개 기타 프로젝트

새로 시작할 때

새 머신에서 모든 것을 부트스트랩하세요:

# 1. 이 메타 스킬 설치
npx skills add arach/arach

# 2. 이제 Claude가 모든 프로젝트를 알며 필요에 따라 특정 스킬을 설치할 수 있습니다.

링크

GitHub: github.com/arach
사이트: arach.dev
X: @arach
사이트: arach.io