diff --git a/.agent/scripts/sync_vendors.bat b/.agent/scripts/sync_vendors.bat new file mode 100644 index 0000000..091f3b5 --- /dev/null +++ b/.agent/scripts/sync_vendors.bat @@ -0,0 +1,37 @@ +@echo off +chcp 65001 >nul +:: ============================================================================== +:: [NEW_GENE MASTER SYNC TOOL] +:: 이 스크립트는 중앙 관리자만이 오직 이 메인 저장소(Master)에서 작동시키는 +:: 외부 오픈소스 서브모듈 동기화 및 스킬 평탄화 파이프라인입니다. +:: 하위 파생 프로젝트들은 이 스크립트를 구동할 필요 없이 'git pull' 단 한방으로 결과를 상속받습니다. +:: ============================================================================== + +echo 🔄 [1/4] 업스트림 오픈소스 서브모듈 메인 브랜치 추적 동기화 중... +git submodule update --remote --merge +if %errorlevel% neq 0 ( + echo ❌ 서브모듈 동기화 실패! + exit /b %errorlevel% +) + +echo ⛏️ [2/4] 업데이트된 서브모듈에서 최상위 스킬 추출 및 평탄화 중... +node .agent\scripts\extract_skills.js +if %errorlevel% neq 0 ( + echo ❌ 평탄화 스크립트 실행 실패! + exit /b %errorlevel% +) + +echo 🌐 [3/4] 신규 유입된 영문 스킬 설명을 한글 UI 친화적 언어로 번역 중... +node .agent\scripts\translate_skills.js +if %errorlevel% neq 0 ( + echo ❌ 번역 스크립트 실행 실패! + exit /b %errorlevel% +) + +echo 📦 [4/4] 변동 사항을 Git 트래킹 리스트에 올려 위성 배포(Push) 준비 완료... +git add .agent\vendor\ .agent\skills\ .gitmodules +git commit -m "chore(agent): 마스터 허브 오픈소스 서브모듈 최신화 및 평탄화 동기화 완료" || echo ⚠️ 변동 사항이 없습니다. + +echo. +echo ✅ 모든 서브모듈 추출 작업이 마스터 레포지토리에 귀속되었습니다. +echo ✅ 이제 'git push' 를 통해 다른 파생 프로젝트들에게 이 최신 스킬셋을 무혈 배포하십시오! diff --git a/.agent/scripts/sync_vendors.sh b/.agent/scripts/sync_vendors.sh new file mode 100644 index 0000000..e3d72fe --- /dev/null +++ b/.agent/scripts/sync_vendors.sh @@ -0,0 +1,35 @@ +#!/bin/bash +# ============================================================================== +# [NEW_GENE MASTER SYNC TOOL] +# 이 스크립트는 중앙 관리자(신규 유전자 배포자)만이 오직 이 메인 저장소(Master)에서 작동시키는 +# 외부 오픈소스 서브모듈 동기화 및 스킬 평탄화 파이프라인입니다. +# 하위 위성 프로젝트 개발자들은 이 스크립트를 누를 필요 없이 오직 git pull만으로 결과를 상속받습니다. +# ============================================================================== + +echo "🔄 [1/4] 업스트림 오픈소스 서브모듈 메인 브랜치 추적 동기화 중..." +git submodule update --remote --merge +if [ $? -ne 0 ]; then + echo "❌ 서브모듈 동기화 실패!" + exit 1 +fi + +echo "⛏️ [2/4] 업데이트된 서브모듈에서 19개 이상 최상위 스킬 추출 및 평탄화 중..." +node .agent/scripts/extract_skills.js +if [ $? -ne 0 ]; then + echo "❌ 평탄화 스크립트 실행 실패!" + exit 1 +fi + +echo "🌐 [3/4] 신규 유입된 영문 스킬 설명을 한글 UI 친화적 언어로 심층 번역 중..." +node .agent/scripts/translate_skills.js +if [ $? -ne 0 ]; then + echo "❌ 번역 스크립트 실행 실패!" + exit 1 +fi + +echo "📦 [4/4] 변동 사항을 Git 트래킹 리스트에 커밋하고 위성 배포(Push) 준비 완료..." +git add .agent/vendor/ .agent/skills/ .gitmodules +git commit -m "chore(agent): 마스터 허브 오픈소스 서브모듈 최신화 및 평탄화 동기화 완료" || echo "⚠️ 변동 사항이 없습니다." + +echo "✅ 모든 서브모듈 추출 작업이 이 마스터 레포지토리에 귀속되었습니다." +echo "✅ 이제 'git push' 를 입력하여 다른 파생 프로젝트들에게 이 성과를 무혈 배포하십시오!" diff --git a/.planning/PROJECT.md b/.planning/PROJECT.md index 333aa01..7fdf460 100644 --- a/.planning/PROJECT.md +++ b/.planning/PROJECT.md @@ -20,13 +20,13 @@ - ✓ [Persistence] `claude-mem` (SQLite MCP) 기반의 오답노트 기억 능력 탑재. ### Active -- [ ] `git clone`/`git pull`만으로도 19개 스킬이 즉각 로드될 수 있도록 `.agent/skills/` 구조 강제화 유지 +- [x] `git clone`/`git pull`만으로 19개 스킬 즉각 로드 (Master Sync Hub 토폴로지 확립) - [ ] GSD Phase 계획과 실제 코드 실행 간 오차를 자동으로 검증할 브릿지 시스템 보완 -- [ ] `.env.agent`만 셋업하면 모든 것이 알아서 연결되는 완전 자율화 (No Touch Rules) 체계 구축 지속 +- [ ] `.env.agent`만 셋업하면 모든 것이 알아서 연결되는 완전 자율화 체계 구축 지속 -### Out of Scope -- 글로벌 NPM 패키지 설치 및 글로벌 환경 변수 제어 금지 (로컬 의존성 100% 강제) -- 추가 번거로운 부트스트랩 설치 스크립트 의존 (Git Pull 자체만으로 업데이트를 소화해야 하므로 스크립트를 통한 2차 의존성 최소화) +### Out of Scope (배포 제약) +- **하위 프로젝트(Satellite Repo)에서의 오픈소스 서브모듈(Vendor) 직접 업데이트 행위 원천 금지.** (오직 ఈ Master 템플릿의 `sync_vendors` 스크립트만이 서브모듈의 버전을 평탄화 추출/번역하여 100% 검증된 정적 파일(`.agent/skills/`)로 Git 트래킹합니다.) +- 하위 패키지에 글로벌 NPM 패키지 설치 요구 및 부트스트랩 스크립트 실행 강요 금지 (오직 `git pull` 하나만으로 마스터의 스킬셋 변동분을 수동적으로 상속받을 것). - `/start` 및 `/end` 같은 과거 유산(Legacy) 도입 금지 --- diff --git a/.planning/codebase/ARCHITECTURE.md b/.planning/codebase/ARCHITECTURE.md index 507c479..21ecd54 100644 --- a/.planning/codebase/ARCHITECTURE.md +++ b/.planning/codebase/ARCHITECTURE.md @@ -3,9 +3,10 @@ ## Core Components 1. **Orchestrator Layer (`get-shit-done`)**: 프로젝트 `.planning/` 디렉터리의 상태를 관리하며 개발 페이즈(Phase)를 통제. CLI 명령어 체이닝을 담당. 2. **Skill Encapsulation Layer (`.agent/vendor/`, `.agent/skills/`)**: 19종 이상의 핵심 무기가 CLI에 직결됨. 하위 모듈이 아니라 원시 폴더로 직접 트래킹되어 Git Clone 시 100% 작동. -3. **External Sync Bridge (`.agent/scripts/`)**: Gitea Wiki와 Vikunja Ticket으로 상태를 푸시하는 노드 기반 보안 터널. -4. **Memory Protocol (`claude-mem`)**: MCP 기반 로컬 SQLite 영구 기억 장치. -5. **Rule Enforcement (`agent_lifecycle_sop.md`)**: 코딩 전 반드시 숙지해야 하는 최종 헌법. +3. **External Sync Bridge (`.agent/scripts/`)**: Gitea Wiki/Vikunja 상태 푸시 보안 터널. +4. **Master Vendor Sync (`.agent/scripts/sync_vendors.bat`)**: 이 마스터 저장소 단 한 곳에서만 오프소스 모듈을 동기화하고 평탄화, 번역, Git 커밋까지 One-click에 처리해 하위 파생 프로젝트로 뿌려주는 핵심 분배기(Distributor). +5. **Memory Protocol (`claude-mem`)**: MCP 기반 로컬 SQLite 영구 기억 장치. +6. **Rule Enforcement (`agent_lifecycle_sop.md`)**: 코딩 전 반드시 숙지해야 하는 최종 헌법. ## Data Flow [Agent NLU] → [GSD Phase Task] → [Superpowers Skill (Worktree 생성)] → [코드 작성/TDD] → [sync_*.js 로 Vikunja/Gitea 자동 보고]