코드베이스에서 지속적인 AI 에이전트 메모리를 위한 순회 가능한 스킬 그래프

상태 비저장 AI 어시스턴트에 대한 실용적인 해결책

AI 코딩 어시스턴트는 세션 간 지속적인 메모리가 부족하여 개발자들이 매번 처음부터 시작해야 합니다. .cursorrules와 같은 대규모 규칙 파일에 모든 것을 덤프하는 일반적인 접근 방식은 토큰 제한과 지침의 희석으로 인해 실패합니다.

제시된 해결책은 코드베이스 내부에 존재하는 탐색 가능한 스킬 그래프를 통한 점진적 공개입니다. AI는 세션을 걸쳐 이 그래프를 자율적으로 탐색합니다.

3계층 아키텍처

이 시스템은 세 가지 구별되는 계층을 가지고 있습니다:

• 계층 1 (항상 로드됨): 150줄 미만 (300 토큰). 스택 식별자, 폴더 규칙, 그리고 절대적인 규칙들을 포함합니다. HANDOVER.md로 향하는 하나의 아웃바운드 포인터를 포함합니다.
• 계층 2 (세션별 로드됨): HANDOVER.md는 문서가 아닌 주의 라우터 역할을 합니다. 현재 작업(결제, 인증, 데이터베이스, API 경로)에 기반하여 어떤 도메인 파일을 로드할지 AI에게 알려줍니다. 각 도메인 파일은 다음 관련 파일을 가리키는 지침으로 끝나며, 이는 자기 주도적 시스템을 생성합니다.
• 계층 3 (작업별 로드됨): 12개 카테고리로 구성된 프롬프트 라이브러리. 각 항목은 컨텍스트, 빌드, 검증, 디버그 섹션을 포함합니다. AI는 인덱스를 확인하고, 카테고리를 로드하며, 패턴을 따릅니다.

핵심 통찰: 자기 주도적 지침

핵심 혁신은 지침이 단순한 참조가 아닌 의미를 전달한다는 점입니다. 예를 들어: "웹훅 핸들러를 수정하기 전에 security/threat-modeling.md를 로드하세요"는 AI에게 무엇을 할지뿐만 아니라 언제, 왜 해야 하는지 알려줍니다.

개발자는 이를 코드베이스와 함께 제공되는 SaaS 템플릿으로 구축했으며, 전체 그래프 구조를 검토하고 싶은 사람들은 launchx.page에서 확인할 수 있습니다.