docs(gsd): initialize project and roadmap for Climate Risk Scenarios

This commit is contained in:
variet-worker
2026-04-03 10:33:38 +09:00
parent add7f40894
commit 42ac4724d1
3 changed files with 45 additions and 46 deletions

View File

@@ -1,49 +1,41 @@
# Project Context: Zero-Pollution Agent Bootstrap Kit
# 한국 기후위기 시나리오 테스트(NGFS) 변환 엔진
## What This Is
`new_gene`은 향후 모든 AI 에이전트 개발 및 자동화 프로젝트에 포크(Fork)되거나 복제되어 즉각적으로 활용되는 **'완전 자율형·무오염(Zero-Pollution) 부트스트랩 마스터 템플릿'** 입니다.
ISDA Phase 4(NGFS 단기기후시나리오) 체계를 기반으로 한국 금융시장에 최적화된 시장 파라미터 변환 엔진입니다. 채권, 스왑, 주식, 원자재, 달러/원 환율 등 전 자산군에 대한 거시/기후 충격 변환 계수를 생성하여 일차적으로 조회 최적화된 임시 SQLite 데이터베이스에 적재합니다.
## 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 엔진)이 완벽히 업데이트되어야 함.
한국표준산업분류(KSIC) 기반의 정확한 배출량 및 K-Taxonomy 매핑을 적용하여, 개별 자산군 리프라이싱(Repricing) 시 실제적인 기후 스트레스 충격 수치를 정밀하게 부여해야 합니다.
## Requirements
### Validated
- ✓ [Zero-Pollution] 모든 스킬(`superpowers`, `obsidian-skills`)이 글로벌 영역이 아닌 내부(`.agent/skills/`)로 캡슐화되어 직접 Git 트래킹을 받음.
- ✓ [API Bridge] `sync_wiki.js``sync_vikunja.js`를 통해 토큰 노출 없이 서버와 통신 구조 확보.
- ✓ [Persistence] `claude-mem` (SQLite MCP) 기반의 오답노트 기억 능력 탑재.
(None yet — ship to validate)
### Active
- [x] `git clone`/`git pull`만으로 19개 스킬 즉각 로드 (Master Sync Hub 토폴로지 확립)
- [ ] GSD Phase 계획과 실제 코드 실행 간 오차를 자동으로 검증할 브릿지 시스템 보완
- [ ] `.env.agent`만 셋업하면 모든 것이 알아서 연결되는 완전 자율화 체계 구축 지속
- [ ] NGFS 원시 데이터 파싱 및 입력 모듈 구축 (한국 프록시 페깅 포함)
- [ ] OIS 기반 리프라이싱용 스왑 커브 생성 로직 (PCA 금리 매핑)
- [ ] Merton 구조 확장 기반 채권 부도율 민감도/Cr.Spread 할당 모듈
- [ ] Scope 배출 민감도 기반 주식 DDM 팩터 쇼크 산출 모듈 확립
- [ ] 국가간 정책금리 차이를 이용한 환율(FX) 점프 산출
- [ ] K-Taxonomy/KSIC 기반 부문별 통합 배출 민감도(Carbon Beta) 매핑 규격 셋업
- [ ] SQLite 출력/저장 데이터베이스 구조 및 릴레이션 테이블 스키마 작성(자산군별)
### Out of Scope (배포 제약)
- **하위 프로젝트(Satellite Repo)에서의 오픈소스 서브모듈(Vendor) 직접 업데이트 행위 원천 금지.** (오직 ఈ Master 템플릿의 `sync_vendors` 스크립트만이 서브모듈의 버전을 평탄화 추출/번역하여 100% 검증된 정적 파일(`.agent/skills/`)로 Git 트래킹합니다.)
- 하위 패키지에 글로벌 NPM 패키지 설치 요구 및 부트스트랩 스크립트 실행 강요 금지 (오직 `git pull` 하나만으로 마스터의 스킬셋 변동분을 수동적으로 상속받을 것).
- `/start``/end` 같은 과거 유산(Legacy) 도입 금지
### Out of Scope
- [기존 레거시 API 연동] — 현 단계에서는 연동 및 API 배포 대신 검증용 SQLite 추출을 우선하여 정합성을 확인할 계획입니다.
## Context
- 방법론 레퍼런스: ISDA Phase 4 (NGFS Short Term Scenarios: Sudden Wake-up Call, Disasters and Policy Stagnation)
- 세부 앵커 체계: 한국표준산업분류 (KSIC, 5단위 세세분류 연계)
## Constraints
- 타 시스템 연계용 API는 1차 데이터베이스 조회 검증(Plausibility Check)이 끝난 후 개발(다음 페이즈)로 미룹니다.
## Key Decisions
| Decision | Rationale | Outcome |
|----------|-----------|---------|
| KSIC 중소분류 채택 | NGMS 배출 및 K-Taxonomy 공식 매핑 확보의 필수 요소 | — Pending |
| SQLite 출력 계층 우선적용 | 조기 데이터베이스를 통한 검증과 시계열 쇼크 비교 목적 | — Pending |
---
*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
*Last updated: 2026-04-03 after initialization*

View File

@@ -1,11 +1,18 @@
# Roadmap
## Phase 1: Zero-Pollution Pipeline Stabilization
**Status:** Complete (2026-03-30)
**Goal:** Fix the Master-Satellite synchronization pipeline to natively extract GSD skills, UI data, and Python MCP dependencies so that satellite repositories bootstrap via zero-click.
**Phase 1. 시나리오 데이터 수집 및 KSIC 프록시 맵핑 설계**
- [ ] NGFS 단기 시나리오(SWUC, DAPS) 원시 데이터 파싱 (한국/아시아 프록시 설정)
- [ ] 한국표준산업분류(KSIC) 대응 배출량/탄소비용 기반 Carbon Beta 맵핑 모듈 확립
### Requirements
- REQ-01: Bootstrap script must auto-install Python dependencies for MCP tools across satellites.
- REQ-02: Master sync script must invoke `get-shit-done-cc` local installation to native `.agent/skills` and ensure Git tracking.
- REQ-03: Master sync script must invoke `uipro update` and commit changes.
- REQ-04: The `.gitignore` generated by `extract_skills.js` must safely whitelist `/gsd` skill directories.
**Phase 2. 시장 파라미터 변환 엔진 구축**
- [ ] 금리 커브 및 스왑 텐서 변환 모듈 (PCA 매핑 기반)
- [ ] 주식/채권(크레딧) 섹터별 부도율 및 DDM 쇼크 연산
- [ ] FX 및 원자재 시장 리스크 충격 매핑 수식 적용
**Phase 3. SQLite Storage Layer 구축**
- [ ] 각 자산군별 변환 계수 조회용 SQLite 스키마 설계
- [ ] 변환 파라미터 데이터 적재 스크립트 작성 (정합성 검증)
**Phase 4. 한국 벤치마크 테스트**
- [ ] 가상 한국 시나리오 세트 가동
- [ ] ISDA 기준 시장 리스크 충격 플로저빌리티(Plausibility) 대조 및 수치 결과 평가 분석

View File

@@ -1,9 +1,9 @@
{
"mode": "yolo",
"granularity": "Standard",
"granularity": "standard",
"parallelization": true,
"commit_docs": true,
"model_profile": "balanced",
"model_profile": "inherit",
"workflow": {
"research": true,
"plan_check": true,