LazyCodex
LazyCodexv4.12.1

$init-deep

계층적 AGENTS.md 프로젝트 메모리를 생성해 이후 에이전트가 완전한 컨텍스트로 시작하게 합니다.

$init-deep는 LazyCodex의 프로젝트 메모리를 구축합니다. 저장소 전반에 걸쳐 계층적인 AGENTS.md 파일을 생성해, 이후의 모든 에이전트 실행이 곧 수정할 코드 바로 옆에서 필요한 컨텍스트를 가지고 시작하도록 합니다.

저장소가 너무 커서 기억만으로 설명하기 어려울 때 실행합니다.

무엇을 하나요

복잡한 디렉터리에 점수를 매깁니다

$init-deep는 코드베이스를 순회하며 복잡도에 따라 디렉터리에 점수를 매기고, 실제로 문서화된 안내가 필요한 부분을 찾아냅니다.

코드 가까이에 로컬 안내를 작성합니다

중요한 디렉터리에는 그 코드를 설명하는 AGENTS.md를 가까이에 작성합니다. 덕분에 안내가 거대한 루트 파일 하나에 묻히지 않고, 에이전트가 작업하는 바로 그 위치에서 발견됩니다.

이후 에이전트를 위한 이정표를 남깁니다

그 결과로 만들어지는 AGENTS.md 계층 구조는 이후 에이전트가 수정에 들어가기 전에 이정표를 제공합니다. 여기에 무엇이 있고, 어떻게 맞물리며, 무엇을 조심해야 하는지를 알려줍니다.

언제 실행하나요

  • 코드베이스를 처음 다룰 때. 낯설거나 큰 저장소에서 LazyCodex에 실제 작업을 맡기기 전에 $init-deep를 실행해 에이전트가 완전한 컨텍스트로 시작하게 합니다.
  • 기억만으로 설명하기에 저장소가 너무 클 때. 프로젝트를 한 문장으로 요약할 수 없다면 $init-deep가 지도를 대신 그려주게 합니다.

언제 다시 실행하나요

코드베이스의 형태가 바뀌었을 때 $init-deep를 다시 실행합니다. 새로운 최상위 영역이 생기거나, 큰 리팩터링이 있거나, 기존 AGENTS.md 이정표를 낡게 만드는 재구성이 일어났을 때입니다. 메모리를 최신으로 유지하면 이후 모든 실행이 견고하게 유지됩니다.

옵션

기본 실행은 기존 AGENTS.md를 읽고 필요한 위치를 갱신하는 update mode입니다.

$init-deep
$init-deep --create-new
$init-deep --max-depth=2
  • --create-new — 기존 AGENTS.md를 읽어 맥락을 보존한 뒤, 새 구조로 다시 생성합니다.
  • --max-depth=<number> — 탐색할 디렉터리 깊이를 제한합니다. 기본값은 3입니다.

어디에 위치하나요

$init-deep는 메모리 단계입니다. 지도가 마련되면 다른 Commands가 작업을 수행합니다.

  • $ulw-plan은 코드를 바꾸기 전에 무엇을 만들지 결정합니다.
  • $start-work는 계획을 마지막 체크박스까지 실행합니다.
  • $ulw-loop는 결과가 검증될 때까지 열린 형태의 작업을 계속 진행합니다.

관련 문서

목차