dartlab/codaro의 mainPlan 운영방침을 차용한다. pyproc의 큰 방향 설계는 이 트리에서 이니셔티브 단위 폴더로 관리하고, 코드 착수 전 설계의 SSOT가 된다.
- 이니셔티브 = 폴더 하나.
mainPlan/<kebab-name>/아래 번호 문서(00-...md부터)와README.md(인덱스)를 둔다. - 문서 구성 관례 (필요한 것만, 순서 고정 아님):
00-product-vision.md- 무엇을, 누구를 위해, 왜. 기각 근거와 성공/실패 기준.01-architecture.md- 레이어, 능력, 발명 계보, 실측.02-phasing-and-wiring.md- phase 분해, 소비 배선, 게이트, 롤백.03-progress-ledger.md- 결정 원장. 세션 간 재개 지점(NEXT)을 항상 최신으로.
- 비전과 구현이 충돌하면 phasing 문서의 게이트가 우선한다.
- 완료·폐기된 이니셔티브는 폴더째
mainPlan/_done/<name>/으로 격리한다. 삭제하지 않는다(설계 근거·완료 기록은 계속 참조된다). 옮긴 폴더 README 상단에 완료/폐기 배너와 한 줄 요약을 남긴다. - 자기충족성이 합격 기준이다. 플랜 본문만 보고 재조사 없이 구현 가능해야 한다. 영향 파일/심볼, 소비 배선, 롤백을 placeholder 없이 채운다.
- 이 트리는 저장소 규칙(camelCase 파일명)의 예외다. dartlab 관례(kebab-case + 번호 프리픽스)를 따른다.
- mainPlan은 git 추적(공개 설계)이지만 npm
files에는 넣지 않는다(소비 패키지에 안 실림).
없음.
완결·폐기 이니셔티브 18개는 _done/으로 이관됐다(최신 이관 = asset-provenance, 완료). 세션 간 마지막 상태는 각 _done/<이니셔티브>/ 진행 원장 또는 README에서 확인한다.