Files

CD baea23e89f docs: initialize project and codebase maps

- Finalized PROJECT.md incorporating 'Zero-Pollution' constraints
- Enforced native Git portability (git pull sync only)
- Generated ARCHITECTURE.md and STACK.md maps
- Deleted .agent/skills/.gitignore to physically track flattened skills

2026-03-29 08:18:55 +09:00

3.3 KiB

Raw Blame History

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개 스킬이 즉각 로드될 수 있도록 .agent/skills/ 구조 강제화 유지
GSD Phase 계획과 실제 코드 실행 간 오차를 자동으로 검증할 브릿지 시스템 보완
.env.agent만 셋업하면 모든 것이 알아서 연결되는 완전 자율화 (No Touch Rules) 체계 구축 지속

Out of Scope

글로벌 NPM 패키지 설치 및 글로벌 환경 변수 제어 금지 (로컬 의존성 100% 강제)
추가 번거로운 부트스트랩 설치 스크립트 의존 (Git Pull 자체만으로 업데이트를 소화해야 하므로 스크립트를 통한 2차 의존성 최소화)
/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.3 KiB Raw Blame History