Project Context: Zero-Pollution Agent Bootstrap Kit

What This Is

new_gene은 향후 모든 AI 에이전트 개발 및 자동화 프로젝트에 포크(Fork)되거나 복제되어 즉각적으로 활용되는 '완전 자율형·무오염(Zero-Pollution) 부트스트랩 마스터 템플릿' 입니다.

Core Value

코딩을 시작할 때 발생하는 세팅 오류, 프롬프트 해킹, 메인 브랜치 훼손, API 키 유출을 원천적으로 막습니다. 누구나 이 저장소만 클론(git clone) 받으면 환경 설정이나 별도의 복잡한 스크립트 실행 없이 19개의 최고급 개발 스킬(TDD, Git Worktree)과 GSD 오케스트레이터를 즉시 꺼내 쓸 수 있는 완벽한 턴키(Turn-key) 생태계를 구축합니다.

Success Criteria

사용자가 단 1개의 글로벌 패키지를 설치하지 않아도 로컬(.agent/env/node_modules)만을 통해 100% 작동해야 함.
터미널 명령어나 히스토리에 API 토큰이 노출되지 않고 자동 동기화(Vikunja/Gitea)가 이루어져야 함.
에이전트는 코딩 전 반드시 TDD 가설을 세우고, 서브 브랜치(Worktree)로 격리되어 안전하게 작업해야 함.
[Key Constraint] 템플릿의 모든 아키텍처는 git clone만으로 완전한 작업 흐름이 이어져야 하며, 각 파생 프로젝트들은 git pull 명령어 단 한 번만으로 최신 무기와 스킬(Agent 엔진)이 완벽히 업데이트되어야 함.

Requirements

Validated

✓ [Zero-Pollution] 모든 스킬(superpowers, obsidian-skills)이 글로벌 영역이 아닌 내부(.agent/skills/)로 캡슐화되어 직접 Git 트래킹을 받음.
✓ [API Bridge] sync_wiki.js와 sync_vikunja.js를 통해 토큰 노출 없이 서버와 통신 구조 확보.
✓ [Persistence] claude-mem (SQLite MCP) 기반의 오답노트 기억 능력 탑재.

Active

git clone/git pull만으로 19개 스킬 즉각 로드 (Master Sync Hub 토폴로지 확립)
GSD Phase 계획과 실제 코드 실행 간 오차를 자동으로 검증할 브릿지 시스템 보완
.env.agent만 셋업하면 모든 것이 알아서 연결되는 완전 자율화 체계 구축 지속

Out of Scope (배포 제약)

하위 프로젝트(Satellite Repo)에서의 오픈소스 서브모듈(Vendor) 직접 업데이트 행위 원천 금지. (오직 ఈ Master 템플릿의 sync_vendors 스크립트만이 서브모듈의 버전을 평탄화 추출/번역하여 100% 검증된 정적 파일(.agent/skills/)로 Git 트래킹합니다.)
하위 패키지에 글로벌 NPM 패키지 설치 요구 및 부트스트랩 스크립트 실행 강요 금지 (오직 git pull 하나만으로 마스터의 스킬셋 변동분을 수동적으로 상속받을 것).
/start 및 /end 같은 과거 유산(Legacy) 도입 금지

Last updated: 2026-03-29 after Phase 1 initialization

Evolution

This document evolves at phase transitions and milestone boundaries.

After each phase transition (via /gsd-transition):

Requirements invalidated? → Move to Out of Scope with reason
Requirements validated? → Move to Validated with phase reference
New requirements emerged? → Add to Active
Decisions to log? → Add to Key Decisions
"What This Is" still accurate? → Update if drifted

After each milestone (via /gsd-complete-milestone):

Full review of all sections
Core Value check — still the right priority?
Audit Out of Scope — reasons still valid?
Update Context with current state

3.5 KiB Raw Blame History