코딩 Agent

🟢 자금은 이동하지 않습니다. Coding은 선택한 프로젝트 체크아웃 안에서 파일을 수정하고 명령을 실행할 수 있습니다. 기본 작업 디렉터리에 영향을 주지 않으려면 격리 워크트리를 사용하십시오.

Coding은 프로젝트 맥락을 이해하는 엔지니어링 워크스페이스를 Minara에 제공합니다. Agent는 편집 전에 저장소를 살펴보고 프로젝트 지침을 따릅니다. 필요한 범위만 변경하고 프로젝트 자체 도구로 결과를 검증합니다.

낯선 코드베이스 이해, 기능 구현, 실패한 테스트 수정, 변경 검토, 알고리즘 개선에 사용할 수 있습니다. 금융 공학 코드에서는 데이터, 정밀도, 위험에 관한 가정도 명확히 합니다.

코딩 작업 시작하기

1. Web UI에서 Coding을 엽니다.
2. 새 프로젝트 폴더를 만들거나 기존 폴더를 추가합니다. 컴퓨터의 임의 폴더를 선택하려면 Minara 데스크톱 앱이 필요합니다.
3. 새 Git 작업에서는 컴포저의 워크트리를 끄면 선택한 로컬 체크아웃을 사용하고, 켜면 작업을 격리할 수 있습니다.
4. 워크트리 모드는 사용할 수 있는 경우 main을 우선 선택하고, 없으면 유효한 기본 또는 현재 로컬 브랜치로 대체합니다. 브랜치 선택기에서 다른 로컬 기준을 선택할 수도 있으며, 이 작업은 로컬 체크아웃을 전환하지 않습니다.
5. 원하는 결과를 설명하고 첫 프롬프트를 전송합니다. Agent가 작업을 시작하기 전에 Minara가 선택한 기준에서 minara/task-* 브랜치와 관리형 워크트리를 만듭니다. 프로젝트, 체크아웃, 터미널, 파일, 워크벤치 도구가 해당 작업에 계속 연결됩니다.

작업이 시작되면 Minara는 루트의 AGENTS.md와 CLAUDE.md를 읽습니다. 중첩된 지침 파일과 저장소 구조도 찾고, 각 파일을 변경하기 전에 적용할 규칙을 불러옵니다.

프로젝트, 체크아웃, 워크트리

프로젝트는 Coding에 등록한 저장소 또는 폴더입니다. 체크아웃은 한 작업이 실제로 사용하는 디렉터리입니다.

워크트리 모드를 사용하지 않을 때 브랜치 선택기는 로컬 브랜치, 현재 브랜치, 미커밋 파일 수를 표시하고 브랜치를 만들거나 체크아웃할 수 있습니다. 워크트리 모드에서는 새 작업 브랜치의 기준만 선택하며 로컬 체크아웃을 전환하지 않습니다. 로컬 변경을 덮어쓰게 되는 경우 Git이 전환을 거부합니다.

Agent가 할 수 있는 일

• 파일, 아키텍처, 타입, 설정, 프로젝트 기록을 탐색합니다.
• 연결된 체크아웃 안에서 파일을 편집, 추가, 이름 변경, 삭제합니다.
• 터미널 명령, 테스트, 타입 검사, 빌드, 프로젝트별 검증을 실행합니다.
• 프로젝트에 개발 서버나 미리보기 명령이 있으면 애플리케이션 미리보기와 런타임 동작을 확인합니다.
• 코드와 함께 알고리즘, 데이터 흐름, 장애 원인, 절충점을 설명합니다.
• 분석만 요청한 경우 파일을 변경하지 않고 기존 diff를 검토합니다.

Browser & Computer Use

Browser와 Computer Use는 하나의 상호작용 기능으로 동작합니다. Minara는 페이지 구조 확인, 스크린샷, 클릭, 입력, 스크롤, 드래그, 키 입력을 수행할 수 있습니다. 같은 세션에서 작업 과정을 볼 수 있습니다.

• 클라우드 환경에서는 화면에 표시되는 클라우드 브라우저 또는 클라우드 컴퓨터 세션을 제어합니다.
• 데스크톱에서는 로컬 브라우저와 컴퓨터 화면을 제어합니다.
• 일반 웹 페이지에는 페이지 구조를 사용합니다. 캔버스, 데스크톱 앱, 신뢰할 수 있는 선택자가 없는 컨트롤에는 시각적 컴퓨터 제어를 사용합니다.

로컬 미리보기 확인, UI 버그 재현, 반응형 레이아웃 검증, 브라우저 기반 개발 흐름에 활용할 수 있습니다. 상태를 바꾼 뒤에는 화면을 다시 확인합니다. 게시, 구매, 전송, 삭제처럼 외부에 영향을 주는 중요한 작업 전에는 확인을 요청합니다.

각 턴의 변경 검토하기

Coding 턴에서 파일을 변경하면 응답에 변경 세트 카드가 나타납니다. 변경된 경로와 추가 및 삭제 줄 수를 볼 수 있으며, Review에서 diff를 확인할 수 있습니다.

턴이 끝난 뒤 파일이 다시 변경되지 않았다면 Undo로 해당 턴을 복원할 수 있습니다. Minara는 현재 파일과 기록된 변경 후 상태를 먼저 비교합니다. 다른 편집을 덮어쓸 가능성이 있으면 충돌로 중단하고 어떤 파일도 복원하지 않습니다.

대용량 또는 바이너리 파일은 되돌릴 수 있는 텍스트 스냅샷 없이 변경만 표시될 수 있습니다. 커밋하기 전에 Git diff를 기준으로 검토하십시오.

안전 및 Git 경계

• 작업은 연결된 체크아웃 안에서 수행됩니다. 범위를 넓히려면 명시적인 지시가 필요하며 설정된 폴더 권한도 허용해야 합니다.
• 프로젝트를 작업에 연결하기 전에 Minara가 디렉터리의 읽기 및 쓰기 권한을 확인합니다.
• 기존 사용자 변경은 사용자 소유입니다. Agent는 이를 보존하고 관련 없는 정리를 피합니다.
• 명시적으로 요청하지 않으면 Agent는 커밋, 푸시, 브랜치 생성이나 전환, 풀 리퀘스트 생성, 기록 재작성, 변경 폐기를 수행하지 않습니다.
• Coding은 금융 작업과 브라우저 및 컴퓨터의 중요한 작업에 적용되는 확인 규칙을 우회하지 않습니다.

프롬프트 예시

이 저장소를 탐색하고 아키텍처, 실행 명령, 주요 위험을 설명해 주세요.

격리 워크트리를 만들고 보고서 페이지에 CSV 내보내기를 구현한 뒤 관련 테스트를 실행해 주세요.

인증 테스트가 실패하는 근본 원인을 찾으세요. 코드를 변경하기 전에 진단 내용을 설명해 주세요.

현재 diff의 정확성, 보안, 누락된 테스트를 검토하세요. 파일은 수정하지 마세요.

로컬 미리보기를 열어 모바일 레이아웃 버그를 재현하고, 수정 후 데스크톱과 모바일 크기에서 검증해 주세요.

다음 문서

• 코딩 작업에 인용이 포함된 외부 근거가 필요하면 딥 리서치를 사용하십시오.
• 관리형 컴포넌트와 게시 흐름을 갖춘 실시간 데이터 대시보드는 Data Studio를 사용하십시오.
• Web UI의 나머지 기능은 Web 대시보드를 참고하십시오.