🧠 3가지 사고 모드 (Research, Plan, Agent)

숫자 왜곡, 승인 전 임의 파일 변경, 존재하지 않는 산출물 주장을 원천 방지하기 위해 AMBA는 Lean Triad（3가지 핵심 사고 모드: Research, Plan, Agent）를 강제합니다. 대화창의 세그먼트 컨트롤에서 즉시 전환하거나, Agent 모드에 맡겨 처음부터 끝까지 자율 완결할 수 있습니다.

Lean Triad 인지 사고 모델 /
├── 💬 1. Research (질의응답·탐색)  ➔ 엄격한 읽기 전용 문서 열람·질의응답 및 계산 지원 (디스크 쓰기 불가)
├── 📋 2. Plan (하드록 실행 계획)    ➔ 엄격한 전략적 실행 계획 수립. workings/plans/YYYYMMDD_<slug>.md 에 영구 보관
└── ⚡ 3. Agent (자율 실행·납품)     ➔ 네이티브 Office (Excel, Word, PowerPoint) 및 벡터 PDF 완성본 직접 산출

READ-ONLY

💬 Research 모드

엄격한 읽기 전용 문서 열람

비즈니스 질의응답, 수식 검증 및 탐색. 디스크 쓰기 원천 차단.

1-클릭 지식 베이스 저장

HARD-LOCKED

📋 Plan 모드

하드록 전략 실행 계획

엄격한 세부 전략 계획 수립. workings/plans/YYYYMMDD_<slug>.md 저장.

검토 및 최종 승인

🚀 승인 및 실행 트리거

AUTONOMOUS

⚡ Agent 모드

reports/ 폴더로 자율 납품

이사회 제출용 최종 보고서와 데이터 모델을 자율 컴파일.

📦네이티브 Excel (.xlsx)

📦Word 보고서 (.docx)

📦16:9 슬라이드 (.pptx)

📦벡터 PDF

---

⚡ TypeSafe AI (Jev — System 1 Decision Engine) 자동 라우팅

매번 프롬프트마다 모드를 수동으로 전환하는 대신, AMBA는 실험적 지능형 자동 라우팅 엔진으로 **TypeSafe AI (Jev — System 1 Decision Engine)**을 지원합니다:

• 1초 미만 실시간 의도 분류: 입력된 프롬프트를 밀리초 단위로 분석하여 최적의 실행 모드(Research, Plan, 또는 Agent)를 즉각 자동 판별합니다.
• 실시간 레이턴시 배지: 활성화 시 대화창에 판별 속도를 나타내는 작은 배지(예: Jev · 68ms)가 표시되어 투명하게 확인할 수 있습니다.
• 모델 설정 3단계에서 구성: **모델 설정 > 3단계 (고급 및 실험적 라우팅)**에서 TypeSafe API 키를 입력하여 간편하게 활성화할 수 있습니다.

---

1. 💬 Research 모드 — 대화, 질의응답 및 안전한 탐색

사용 시점: 파일을 변경하지 않고 원본 문서를 깊이 있게 열람하거나, 복잡한 실무 질문을 하거나 수식을 검증할 때.

• 동작: 순수한 대화, 문서 정밀 분석, 확정적 분석 계산 지원.
• 허용 권한: 워크스페이스 내 파일 읽기(filesystem_read, excel_read, pdf_read), 확정적 분석 SQL 쿼리(accounting_sql_query, accounting_load_file), 활성화된 경우 웹 검색.
• 원클릭 지식 저장: 업무 규칙, 세법 규정, 핵심 용어를 발견하면 메시지 하단의 액션 버튼을 통해 클릭 한 번으로 로컬 SQLite 메모리에 영구 저장할 수 있습니다.
• 엄격한 제한: 완전한 읽기 전용(Strictly Read-Only). Rust 정책 엔진(Policy Engine)이 프로젝트 내부(작업 공간과 소스)로의 파일 쓰기를 물리적으로 차단합니다. 모든 도구는 쓰기 여부를 선언하며, 통합 문서·프레젠테이션·Word 문서 편집, Office 스크립트, 셸 명령, 연결된 MCP 도구도 권한 확인 전에 거부됩니다. 저장하지 않고 프레젠테이션이나 Word 편집을 미리 보는 것은 허용됩니다.

---

2. 📋 Plan 모드 — 하드록 실행 계획 수립 (Hard-Locked Blueprint)

사용 시점: 최종 산출물 파일을 생성하거나 수정하기 전에, 다단계 작업 공정, 계산 가정, 납품 파일 목록을 사전 합의할 때.

• 엄격한 실행 계약 모델 (Sovereign Executive Contract): 최고 수준의 에이전트 설계와 마찬가지로, Plan 모드는 타협 없는 원칙을 제공합니다: 하드록(Hard-Locked) 읽기 전용 정밀 분석. 소스의 원본 자료를 분석하고, 산출 공식과 파일 구조를 설계하며, 실행 단계를 정의한 뒤—실제 파일을 전혀 건드리지 않고 완전히 멈춥니다.
• 일자별 계획서 파일 규약 (workings/plans/YYYYMMDD_<slug>.md):
  • 모든 계획서는 날짜가 포함된 Markdown 문서로 디스크에 즉시 저장됩니다: workings/plans/YYYYMMDD_<이름>.md (예: workings/plans/20260917_q3_financial_reconciliation.md).
  • 감사 및 추적 가능한 업무 히스토리: 경영진과 재무 관리자는 시간 순서대로 보존된 전략적 로드맵 기록을 유지합니다. 이전 계획서를 덮어쓰지 않으며, 같은 날짜의 새 계획은 자동으로 버전(_v2.md)이 매겨집니다.
  • 인터랙티브 플랜 인스펙터 카드 (Plan Inspector Card): 채팅창에 계획서 제목, 생성 일시, 예정 산출물 칩과 버튼 두 개가 표시됩니다: [ 계획 검토 ]는 계획서 파일을 열고, [ 초안 생성 ]은 검토용 결과물을 workings/drafts/에 만듭니다. 초안이 괜찮으면 채팅에서 에이전트에게 최종본을 요청하세요(예: "보고서를 확정해 줘"). 최종 결과물은 reports/에 저장됩니다.
• 엄격한 제한: 직접 산출물 생성 완전 차단. 에이전트는 workings/plans/ 아래에만 계획서를 작성할 수 있습니다. 승인 전까지 작업 공간에 산출물을 쓰는 것은 런타임에 의해 차단됩니다.

---

3. ⚡ Agent 모드 — 자율 실행 및 결과물 납품

사용 시점: 승인된 계획서나 직접적인 경영진 지시에 따라 검증된 이사회 제출용 완성본을 산출할 때.

• 동작: 다단계 워크플로를 자율 실행하고, 내장 SQLite에 데이터를 적재하며, 정확한 수식을 계산한 뒤 검증된 결과물을 작업 공간(기본값은 보고서 폴더 reports/)에 작성합니다.
• 승인된 계획 실행: 초안 생성을 누르면 Agent 모드가 해당 계획서([EXECUTE PLAN DRAFT: workings/plans/YYYYMMDD_<slug>.md])를 로드하고, 전제 조건을 확인하며 각 단계를 순차 실행해 초안을 workings/drafts/에 쓴 뒤 계획 상태를 Executed로 업데이트합니다. 초안을 검토한 다음 채팅에서 최종본을 요청하면 에이전트가 reports/에 저장합니다.
• 인트리 산출물 팩토리 (Python, LibreOffice, Node, 외부 클라우드 불필요):
  • 네이티브 Excel(.xlsx): 동적 XML 수식을 포함하는 excel_write / accounting_export_table_to_xlsx
  • 네이티브 Word(.docx): docx_write
  • 네이티브 16:9 PowerPoint(.pptx): pptx_write
  • 벡터 PDF(.pdf): pdf_generate
  • Markdown 브리핑(.md): filesystem_write (동반 벡터 PDF 자동 동시 생성)
• 1+1 산출물 표준: 정형 데이터 모델(.xlsx) 1종과 서술형 전략 문서(.docx, .pptx, .md, .pdf) 1종의 결합 납품을 표준 규약으로 삼습니다.

---

🌐 다국어 추론 경계 규약 (ADR-020)

3가지 사고 모드 전반에서 AMBA는 엄격한 다국어 추론 경계 규약을 준수합니다:

1. 추론은 답변에 포함되지 않음 (ADR-074): 모델의 추론은 제공업체 고유의 추론 채널 안에서 이루어지며, AMBA는 추론이나 계획을 답변에 쓰도록 요청하지 않습니다. 여러 단계로 이루어진 작업은 계획 도구로 기록된 계획이 답변 옆에 체크리스트로 표시되고, 도구 매개변수(경로, 시트 이름, 수식)는 파일에 정의된 그대로 유지됩니다.
2. 프로젝트 언어 최종 산출: 대화 답변, UI 카드, 최종 Office/PDF 보고서는 현재 활성화된 프로젝트 언어(ko, en, vi, ja)로 자연스럽고 매끄럽게 컴파일됩니다.

---

👁️ 에이전트 답변에 표시되는 것 (ADR-074)

모든 답변에는 본문과 분리해서 열어 볼 수 있는 세 가지가 함께 표시됩니다.

• 생각: 모델 제공사가 작성한 추론의 짧은 요약입니다. 기본적으로 접혀 있으며, 열면 소요 시간과 함께 읽을 수 있습니다. 작업 중에는 실시간으로 표시되고, 실행 중인 단계 아래에 짧은 진행 메모가 나타납니다. AMBA는 원본 추론을 표시하지 않으며, 요약이 없는 이전 답변에는 표시되지 않습니다.
• 계획: 여러 단계의 작업에서는 에이전트가 단계 체크리스트를 유지하고 완료할 때마다 표시합니다. 계획이 없으면 실제로 실행한 작업으로 만든 수행한 단계가 연한 표시로 나타납니다.
• 결과: 자동으로 실행되는 작업(프로세스)은 만든 파일과 함께 결과를 제출합니다. 파일은 답변 아래에 칩으로 표시되며 클릭하면 열립니다. 답변에 본문이 전혀 없으면 작업을 완료했다는 문구만 사용자 언어로 표시합니다.

---

3가지 사고 모드 비교

모드	주요 목적	샌드박스 디스크 권한	출력 산출물
💬 Research	읽기 전용 조회, 원본 정밀 분석, 계산 지원	읽기 전용 (filesystem_read, excel_read, pdf_read, sql)	없음 (채팅 답변 + 1클릭 지식 저장)
📋 Plan	실행 계획 수립, 요구사항 분해, 수식 설계	읽기 전용 + workings/plans/ 내 계획서 작성	workings/plans/YYYYMMDD_<slug>.md
⚡ Agent	완결형 자율 실행 및 최종 산출물 납품	전체 도구 권한 (excel_write, docx_write, pptx_write, pdf_generate)	reports/(또는 요청한 위치) 내 완성 파일 및 작업 기록

---

모드 선택 가이드

비즈니스 목표	권장 모드
"두 CSV 파일 간 매출 차이 원인을 설명해 줘"	Research
"이 단가표를 읽고 할인 구간을 파악해 줘"	Research (+ 지식에 저장)
"3개년 재무 모델을 만들기 전에 작업 단계와 가정을 먼저 보여 줘"	Plan
"계획서를 확인했으니 실제로 재무 모델을 작성해 줘"	Agent (via [ 초안 생성 ] → 채팅에서 최종본 요청)
"3분기 이사회 보고서와 엑셀 통합 모델을 한 번에 완성해 줘"	Agent