/init 및 AGENTS.md로 프로젝트 시작하기

/init 명령은 프로젝트를 스캔하고 Bob이 모든 대화에서 지속적인 컨텍스트로 사용하는 AGENTS.md라는 구조화된 요약 파일을 생성합니다. /init 명령은 Bob이 각 상호작용 시작 시 모든 파일을 다시 읽을 필요 없이 프로젝트의 구조, 규칙 및 코드베이스에 대한 지식을 Bob에게 제공하는 방법입니다.

대규모 언어 모델은 상태 비저장입니다. 각 새로운 대화는 이전 상호작용에 대한 기억 없이 시작됩니다. 명시적인 프로젝트 컨텍스트가 없으면 Bob은 새로운 상호작용마다 코드베이스를 발견해야 하며, 이는 비효율적이고 규모가 커지면 비실용적이 됩니다.

이 튜토리얼에서는 데모 애플리케이션의 루트 디렉토리에서 Bob을 초기화하고, Bob이 애플리케이션에 대해 얻는 컨텍스트를 탐색하며, 모드별 컨텍스트를 위한 Bob의 구조에 대해 학습합니다.

이 튜토리얼을 완료하려면 다음이 필요합니다:

프로젝트 컨텍스트를 초기화하려면 Bob IDE의 안녕하세요, Bob입니다 채팅 인터페이스로 이동합니다. 사이드바 하단의 Agent 모드로 전환합니다.

채팅 인터페이스에서 /init 명령을 입력합니다. 자동 승인을 비활성화한 경우 Bob은 파일을 읽고 AGENTS.md 파일을 작성할 수 있는 권한을 요청합니다.

Bob은 프로젝트의 관련 파일을 읽습니다. 그런 다음 Bob은 Galaxium Travels 루트 디렉토리에 메인 AGENTS.md 파일을 생성합니다. Bob은 각 모드에 대한 AGENTS.md를 포함하는 .bob 폴더도 생성합니다.

AGENTS.md 파일은 Bob을 위한 온보딩 문서처럼 작동합니다. AGENTS.md는 Bob이 프로젝트의 구조와 규칙을 이해하는 데 필요한 모든 것을 제공하는 간결하고 실행 가능한 요약입니다.

왼쪽의 Bob 파일 탐색기 하단에서 메인 AGENTS.md 파일을 찾을 수 있습니다. 파일을 열어 내용을 읽으세요.

AGENTS.md 파일에는 일반적으로 다음 구성 요소가 포함됩니다:

Bob은 AGENTS.md를 새 대화에 자동으로 적용하고 프로젝트 컨텍스트를 학습합니다.

Galaxium Travels 루트 디렉토리의 메인 AGENTS.md 외에도 /init은 각 내장 모드에 대해 .bob 폴더에 모드별 컨텍스트 파일을 생성합니다. 각 모드별 AGENTS.md는 해당 모드의 목적에 관련된 컨텍스트로 메인 AGENTS.md를 확장합니다. 다음 표에 모드별 AGENTS.md 파일이 나열되어 있습니다:

Plan 모드 컨텍스트는 아키텍처 규칙을 강조하는 반면, Code 모드 컨텍스트는 파일 구조 및 명명 패턴을 강조합니다.

다음 프로젝트 조정을 수행한 후 /init을 다시 실행하세요:

Bob의 자동 스캔이 캡처하지 못할 수 있는 컨텍스트(예: 비즈니스 규칙, 배포 규칙 또는 팀별 관행)를 추가하기 위해 AGENTS.md를 수동으로 편집할 수도 있습니다.

이 튜토리얼에서는 다음을 배웠습니다: