실행 모드와 권한

Manual Accept Mode은 파일 수정과 명령 실행을 제어할 수 있는 기본 실행 모드입니다.

자동 작업:

• 파일 읽기와 코드 분석
• 디렉터리 탐색

권한 필요:

• 파일 편집(생성, 수정, 삭제)
• 명령 실행(터미널 명령, 테스트, 빌드)

Verdent이 보호된 작업을 수행해야 할 때, 어떤 작업을 하려는지와 관련된 파일/명령이 무엇인지 표시합니다. 각 작업을 수락하거나 거부할 수 있습니다.

중요: 각 권한은 해당 특정 작업에만 적용됩니다. Manual Accept Mode은 세션 내내 모든 보호된 작업마다 승인이 필요합니다.

사용 시점

• Verdent의 기능과 워크플로 패턴을 익힐 때
• 세심한 감독이 필요한 익숙하지 않은 코드베이스에서 작업할 때
• 프로덕션 코드나 보안에 민감한 영역을 중요하게 변경할 때
• 명시적인 승인 기록이 필요한 컴플라이언스 요구 사항이 있을 때

활성화

Manual Accept Mode은 기본으로 활성화되어 있습니다. 다시 전환하려면:

안전 고려 사항

장점:

• 도구 유형별 첫 사용 승인(파일 편집, 명령, 도구)
• 접근 권한을 부여하기 전에 전체 내용을 확인할 수 있음
• 가장 높은 수준의 제어와 투명성

제한 사항:

• 한 도구 유형을 처음 승인한 뒤에는 이후 사용이 프롬프트 없이 진행됨
• 승인은 작업별이 아니라 도구 유형별로 적용됨
• 중요한 코드를 작업할 때는 새 세션을 시작해 도구 승인을 초기화하세요

Auto-Run Mode은 파일 작업을 자동으로 승인하면서 명령에는 권한을 요구합니다. 일상적인 파일 작업에서 권한 프롬프트를 줄이면서, 위험한 작업에는 안전성을 유지합니다.

자동:

• 워크스페이스 내 파일 읽기, 편집, 생성, 삭제
• 워크스페이스 내 파일 이동, 이름 변경, 정리
• 파일 검색과 탐색 작업

권한 필요:

• 현재 워크스페이스 외부 경로가 포함된 모든 명령
• 위험한 bash 명령: rm -rf, git commit, git push 등
• 명령 실행(터미널, 스크립트, 빌드)
• 패키지 설치와 시스템 수정

사용 시점

활성화

세션과 VS Code 재시작 후에도 유지됩니다. 모든 워크스페이스에 전역으로 적용됩니다.

예시 워크플로

POST /api/tasks 엔드포인트 만들기:

1. Auto-Run Mode을 활성화합니다
2. 제출: "카테고리가 존재하는지 검증하고 데이터베이스에 저장하는 POST /api/tasks 엔드포인트를 만들어줘"
3. Verdent이 5개 이상의 파일을 읽고, 3개 파일을 자동으로 수정합니다(프롬프트 없음)
4. Source Control 패널에서 변경 사항을 검토합니다
5. 테스트 요청: "tasks API의 테스트를 실행해줘"
6. npm test 명령에 대한 권한 프롬프트가 표시됩니다 - 수락합니다
7. 검증 추가: "빈 제목에 대한 검증을 추가해줘"
8. Verdent이 자동으로 편집합니다(프롬프트 없음)
9. 테스트를 다시 요청합니다 - 권한 프롬프트 - 수락합니다
10. diff를 검토하고 변경 사항을 커밋합니다

결과: 명령 프롬프트 3개, 파일 프롬프트 0개. Manual Accept라면 파일 프롬프트가 4개 더 필요합니다.

안전 고려 사항

장점:

• 변경 사항이 즉시 VS Code에 표시됨
• 워크스페이스 범위로 제한됨(시스템 파일에 영향을 줄 수 없음)
• Git이 롤백 안전망을 제공함

위험:

• 파일 작업에 대한 감독이 없음
• 예상치 못한 범위("User를 Account로 이름 바꿔줘"가 수십 개 파일을 수정할 수 있음)
• 정리 과정에서 파일 삭제 가능
• 프롬프트에 따라 민감한 파일을 수정할 수 있음

완화 방법:

• 명확하고 구체적인 프롬프트를 사용합니다
• 완료 후 Source Control 패널을 검토합니다
• 깨끗한 체크포인트를 위해 자주 커밋합니다
• 복잡한 작업에는 먼저 Plan Mode을 사용합니다
• 민감한 파일을 보호하도록 .gitignore를 설정합니다

Skip Permission Mode은 모든 권한 프롬프트를 건너뛰고 완전한 자율성을 허용합니다. 격리되고 폐기 가능한 환경에서만 사용하세요.

모든 작업 자동:

• 파일 작업
• 명령 실행
• 패키지 설치
• 시스템 수준 작업

사용 시점

활성화

활성화 전 안전 확인:

• 폐기 가능한 컨테이너나 VM인가요?
• 이 환경을 삭제해도 문제가 없나요?
• 여기에 프로덕션 코드나 중요한 코드가 있나요?

앞의 두 질문 중 하나라도 "아니요"이거나 세 번째 질문이 "예"라면 활성화하지 마세요.

안전 경고

모든 안전 가드레일이 제거됩니다:

• 명령이 시스템 권한으로 즉시 실행됩니다
• 파일이 경고 없이 수정되거나 삭제될 수 있습니다
• 데이터베이스 작업, Git 작업(force push 포함)이 승인 없이 진행됩니다
• 악성 패키지를 설치하거나 자격 증명을 노출할 수 있습니다

안전한 경우:

• 환경이 완전히 폐기 가능함
• 중요한 코드나 데이터가 없음
• 프로덕션 시스템과 연결되지 않음
• 무엇이든 파괴될 수 있음을 받아들임

요청별 활성화에는 UI 버튼을 사용합니다:

모든 AI 제공자와 함께 작동합니다. 지속되지 않으므로 깊은 추론이 필요한 요청마다 매번 활성화해야 합니다.

프롬프트에 사고 관련 키워드를 포함합니다:

Think: Design the optimal database schema for this multi-tenant SaaS application

또는 최대 추론을 위해:

Ultrathink: Analyze the trade-offs between different authentication approaches

요청별 활성화만 가능하며 Manual Accept나 Auto-Run처럼 지속되지 않습니다.