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
This commit is contained in:
49
.planning/PROJECT.md
Normal file
49
.planning/PROJECT.md
Normal file
@@ -0,0 +1,49 @@
|
||||
# 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. 사용자가 단 1개의 글로벌 패키지를 설치하지 않아도 로컬(`.agent/env/node_modules`)만을 통해 100% 작동해야 함.
|
||||
2. 터미널 명령어나 히스토리에 API 토큰이 노출되지 않고 자동 동기화(Vikunja/Gitea)가 이루어져야 함.
|
||||
3. 에이전트는 코딩 전 반드시 TDD 가설을 세우고, 서브 브랜치(Worktree)로 격리되어 안전하게 작업해야 함.
|
||||
4. **[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`):
|
||||
1. Requirements invalidated? → Move to Out of Scope with reason
|
||||
2. Requirements validated? → Move to Validated with phase reference
|
||||
3. New requirements emerged? → Add to Active
|
||||
4. Decisions to log? → Add to Key Decisions
|
||||
5. "What This Is" still accurate? → Update if drifted
|
||||
|
||||
**After each milestone** (via `/gsd-complete-milestone`):
|
||||
1. Full review of all sections
|
||||
2. Core Value check — still the right priority?
|
||||
3. Audit Out of Scope — reasons still valid?
|
||||
4. Update Context with current state
|
||||
11
.planning/codebase/ARCHITECTURE.md
Normal file
11
.planning/codebase/ARCHITECTURE.md
Normal file
@@ -0,0 +1,11 @@
|
||||
# Agent System Architecture
|
||||
|
||||
## 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`)**: 코딩 전 반드시 숙지해야 하는 최종 헌법.
|
||||
|
||||
## Data Flow
|
||||
[Agent NLU] → [GSD Phase Task] → [Superpowers Skill (Worktree 생성)] → [코드 작성/TDD] → [sync_*.js 로 Vikunja/Gitea 자동 보고]
|
||||
7
.planning/codebase/STACK.md
Normal file
7
.planning/codebase/STACK.md
Normal file
@@ -0,0 +1,7 @@
|
||||
# Tech Stack
|
||||
|
||||
- **CLI/Execution**: Node.js (v18+)
|
||||
- **Agent Memory**: SQLite (via `claude-mem` MCP)
|
||||
- **Design Tokens**: Python (via `ui-ux-pro-max-skill`)
|
||||
- **Version Control**: Git / Git Worktrees
|
||||
- **Documentation**: Obsidian Flavored Markdown (OFM)
|
||||
14
.planning/config.json
Normal file
14
.planning/config.json
Normal file
@@ -0,0 +1,14 @@
|
||||
{
|
||||
"mode": "yolo",
|
||||
"granularity": "Standard",
|
||||
"parallelization": true,
|
||||
"commit_docs": true,
|
||||
"model_profile": "balanced",
|
||||
"workflow": {
|
||||
"research": true,
|
||||
"plan_check": true,
|
||||
"verifier": true,
|
||||
"nyquist_validation": true,
|
||||
"auto_advance": true
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user