feat(agent): introduce master vendor sync utility and update topology

This commit is contained in:
2026-03-29 08:26:06 +09:00
parent baea23e89f
commit c904bddc17
4 changed files with 81 additions and 8 deletions

View File

@@ -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' 를 통해 다른 파생 프로젝트들에게 이 최신 스킬셋을 무혈 배포하십시오!

View File

@@ -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' 를 입력하여 다른 파생 프로젝트들에게 이 성과를 무혈 배포하십시오!"

View File

@@ -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) 도입 금지
---

View File

@@ -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 WikiVikunja 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 자동 보고]