프로젝트 소개

Atlas-Archify-Coding(aac)은 중후기 개발 프로젝트를 위한 제로 런타임 의존성 Node CLI로, 그래프 기반 개발(ADD, Atlas-Driven Development)의 실행 가능한 커널로 자리잡고 있습니다. 이는 스캐폴딩, 코드 완성, 또는 비즈니스 우선순위 판단을 대체하지 않으며, 프로젝트 시작 후 “누가 무엇을 하고 있는지, 어떤 주장이 증거를 가지고 있는지, 어떤 원장이 미결인지, 그래프와 코드가 언제 분기했는지”와 같은 진행 상황 관리 문제를 해결합니다. 핵심 기능에는 다음과 같은 것들이 포함됩니다: 삼축 상태 머신(truth, progress, ledger)은 마이그레이션 테이블을 통해 상태 변화를 제한하고 불법적인 점프를 거부합니다. 증거 앵커는 “파일:줄 + 줄 내용 해시” 형식으로 완료 또는 검증 주장을 바인딩하여, 코드가 변경되면 즉시 drifted로 표시됩니다. 그래프와 원장의 교차 검증은 아키텍처 그래프 노드와 원장 항목을 하나씩 비교하여 “그래프에는 있지만 원장에는 미결”과 같은 불일치를 드러냅니다. 게이트웨이 집행은 gate를 통해 validate, deliver, visual-check 세 가지 게이트를 직렬로 실행하고, doctor를 사용하여 환경과 원장 상태를 검사합니다. 경험 풀과 트랙은 실수 기록과 타임라인을 조회 가능하고, 퇴역 가능하며, 통계 가능한 공식 원장 항목으로 저장합니다. 프로젝트는 오프라인 테스트, 계약 회귀 테스트, CI 사전 검증, 공개 면에서의 개인 정보 검사 등을 제공하며, 명령 수, 매개변수 수, 도움말 줄 수, 문서 길이 등에 대한 상한 게이트를 설정하여 도구 자체의 기능 범위가 통제되지 않는 것을 방지합니다. 이는 외부 독립 프로젝트인 archify에 의존하여 그래픽 검증과 전달을 수행하며, 설치되지 않은 경우 관련 명령은 fail-closed되고 이유를 설명하며, 나머지 원장, 상태, 증거, 경험, 트랙 기능은 독립적으로 사용할 수 있습니다. 적용 시나리오는 이미 시작되었으며 상태가 점점 모호해지는 프로젝트로, 처음부터 시작하는 새 프로젝트에는 적합하지 않습니다.