feat(agent): introduce master vendor sync utility and update topology
This commit is contained in:
37
.agent/scripts/sync_vendors.bat
Normal file
37
.agent/scripts/sync_vendors.bat
Normal 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' 를 통해 다른 파생 프로젝트들에게 이 최신 스킬셋을 무혈 배포하십시오!
|
||||
35
.agent/scripts/sync_vendors.sh
Normal file
35
.agent/scripts/sync_vendors.sh
Normal 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' 를 입력하여 다른 파생 프로젝트들에게 이 성과를 무혈 배포하십시오!"
|
||||
@@ -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) 도입 금지
|
||||
|
||||
---
|
||||
|
||||
@@ -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 자동 보고]
|
||||
|
||||
Reference in New Issue
Block a user