🏛️ 경영진 문서철: 안전한 로컬 업무 공간

경영진 문서철(Executive Dossier)은 AMBA의 핵심 업무 공간 아키텍처입니다. 문서를 일시적인 웹 세션이나 클라우드 저장소에 보관하는 기존 챗봇과 달리, AMBA는 사용자 컴퓨터의 실제 로컬 폴더에 프로젝트를 고정하고 이를 소스와 작업 공간의 두 영역으로 체계화합니다.

모든 기업 데이터는 사용자 PC에서 100% 로컬로 안전하게 유지·처리되며, 민감한 비즈니스 자산이 외부 클라우드로 유출될 위험이 전혀 없습니다.

---

📂 소스와 작업 공간

AMBA의 각 프로젝트 폴더에는 두 가지 영역이 있습니다.

내 프로젝트 폴더 /
├── 📥 소스 (sources/)        (사용자나 채널이 제공한 모든 파일 — 에이전트는 읽기 전용)
│   ├── uploads/                  직접 추가한 파일
│   └── <소스>/<YYYY-MM-DD>/      Telegram, Drive, 폴더에서 들어온 파일(날짜별)
└── 🗂️ 작업 공간              (그 밖의 모든 것 — 원하는 방식으로 정리)
    ├── reports/                  기본 산출물 위치(정기 보고서는 reports/<YYYY-MM>/)
    └── workings/                 초안, 계획서, 임시 파일

---

1. 📥 소스 — 안전하게 봉인된 원본 보관소

모든 입력 자료는 여기에 있습니다.

• 은행 입출금 거래 내역 엑셀 파일(.xlsx, .csv)
• 전자세금계산서, 매입/매출장, 영수증(.pdf, .csv)
• 고객사 제안요청서(RFP), 과업지시서, 거래처 견적서
• 매체 단가표 및 사내 운영 가이드라인

앱에서 추가한 파일은 sources/uploads/에 보관됩니다. 연결된 소스(Telegram 그룹, Google Drive 폴더, 로컬 폴더)에서 들어온 파일은 소스와 해당 날짜별로 정리됩니다(예: sources/<소스>/2026-10-07/). 파일 트리에서 소스마다 항목이 있고 그 아래에 날짜가 있습니다. 소스를 클릭하면 가져오기 기록(들어온 것, 건너뛴 것과 이유)을 볼 수 있습니다.

읽기 전용 안전 보장

AMBA는 소스(PC의 sources/ 폴더)를 모든 모드에서 에이전트에 대해 엄격한 읽기 전용으로 설정합니다. AI 어시스턴트는 문서를 읽고, 데이터를 추출하고, 분석할 수는 있지만, 소스의 파일을 수정·덮어쓰기·이동·삭제하는 것은 원천 차단되며 결과는 항상 작업 공간의 새 파일에 기록됩니다. 소스 파일을 사용자가 직접 편집할 수는 있으며, AMBA는 이전 버전을 보관하고 그 파일에서 가져온 수치를 재확인 필요로 표시합니다.

---

2. 🗂️ 작업 공간 — 원하는 방식으로 정리

소스 밖의 모든 것이 작업 공간입니다. 필수 하위 폴더는 없으며, 사용자와 에이전트가 자유롭게 정리하고 산출물은 요청한 위치에 저장됩니다. 따로 지정하지 않으면 AMBA는 두 가지 관례를 따릅니다.

• 보고서 폴더 reports/: 완성된 산출물 — 엑셀(.xlsx), Word 문서(.docx), 슬라이드, PDF 보고서. 정기 보고서는 월별 폴더(예: reports/2026-10/)에 저장됩니다.
• workings/: 어시스턴트의 작업대 — 단계별 실행 계획서(workings/plans/), 초안(workings/drafts/), 수식 검증용 중간 계산 테이블 및 대조 작업 시트.

클린 데스크 모드 (Clean Desk Mode)

작업 공간을 항상 쾌적하게 유지하기 위해, AMBA는 클린 데스크 모드를 기본으로 적용합니다. workings/의 내부 임시 로그나 백그라운드 데이터베이스 파일은 자동으로 숨겨져, 진행 중인 계획서와 핵심 증적 파일에만 집중할 수 있습니다. 시스템 파일을 확인하고 싶을 땐 언제든 모두 표시를 누르면 됩니다.

---

3. ✅ 최종본은 폴더가 아니라 상태입니다

산출물은 프로세스가 전달했거나 사용자가 파일 트리에서 최종본으로 표시하면 최종본이 됩니다. 저장 위치와는 관계없습니다. 원한다면 자신만의 final/ 폴더를 계속 사용할 수도 있습니다.

실제 파일 검증 보장

작업이 완료되기 전, 시스템은 해당 실행이 작업 공간에 기록한 산출물을 실제 PC 디스크에서 물리적으로 검증합니다. 빈 파일이나 손상된 파일을 원천 차단하며, 엑셀, 워드, PDF 뷰어에서 즉시 열어 활용할 수 있는 정상 파일만 안전하게 납품됩니다.

버전 0.5.13 이전에 만든 프로젝트

이전 프로젝트는 세 개의 고정 폴더(input/, workings/, output/)를 사용했습니다. AMBA가 한 번 자동으로 옮겼습니다. input/의 파일은 소스(sources/uploads/…, 소스에서 들어온 파일은 sources/<소스>/<날짜>/)로 이동했고, workings/와 output/는 작업 공간의 일반 폴더로 그대로 남아 있습니다.

---

⚙️ 간결한 3탭 구성의 프로젝트 설정

AMBA의 프로젝트 관리는 비개발자 실무자도 쉽게 이해할 수 있도록 설계되었습니다. 헤더의 프로젝트 설정 아이콘을 클릭하면 핵심 기능만 모은 3개의 탭이 나타납니다:

1. 일반 설정 (General):
   • 프로젝트 이름 및 설명.
   • 보고서 산출물 언어 선택(ko, en, vi, ja).
   • 로컬 컴퓨터의 실제 프로젝트 폴더 경로 관리.
2. 권한 및 보안 (Permissions & Security):
   • 직관적인 허용(Allow) 및 차단(Deny) 스위치 컨트롤.
   • 파일시스템 샌드박스, 웹 검색 및 시장 정보 수집, 터미널 실행 차단, MCP 플러그인 권한 제어.
3. 위험 구역 (Danger Zone):
   • 실수를 방지하는 2단계 확인 잠금장치가 포함된 안전한 프로젝트 삭제.

네이티브 코어 설계의 이점

AMBA에서는 스프레드시트 수식 연산과 대사용 SQL 엔진이 고성능 Rust 런타임에 기본 내장되어 있으며, 업무 일정 및 스케줄링은 전문 에이전트 설정, 프로세스, 소스가 직접 담당합니다. 따라서 복잡한 기술 설정 탭을 모두 걷어내고 가장 간결하고 명확한 설정 경험을 제공합니다.

---

🖱️ AMBA Studio에서의 간편한 사용

데스크톱 앱 화면에서 손쉽게 작업할 수 있습니다.

• 드래그 앤 드롭: 바탕화면의 계약서나 엑셀 파일을 소스로 바로 끌어다 놓으세요(sources/uploads/에 보관됩니다).
• 로컬 폴더 즉시 열기: 상단 폴더 아이콘을 클릭하면 macOS Finder나 Windows 탐색기에서 실제 프로젝트 폴더가 바로 열립니다.
• 원클릭 미리보기 및 인쇄: 최종 산출물을 클릭하여 즉시 내용을 확인하고, 기본 오피스 앱으로 실행하거나 PDF로 바로 인쇄할 수 있습니다.

---

🧠 에이전트가 프로젝트를 아는 방법

에이전트는 프로젝트 내용을 추측하지 않습니다. 실행할 때마다 AMBA는 이 컴퓨터의 파일로 만든, 출처가 있는 짧은 요약을 에이전트에게 전달합니다.

• 파일: 통합 문서마다 시트, 머리글 행, 열(숫자·날짜·텍스트), 행 수, 날짜 범위, 합계 행. 문서와 슬라이드의 제목과 목차. 수신 파일의 영업일. 통화와 숫자 표기 방식.
• 파일에서 확인한 수치: 에이전트가 도구로 수치를 읽으면 출처(파일, 시트, 셀)와 함께 기록합니다. AMBA는 그 셀을 열어 값을 확인한 뒤 저장합니다. 완성된 결과의 핵심 수치도 같은 방식으로 저장됩니다.
• 내 규칙: 채팅에서 말한 내용("회계연도는 4월 시작", "항상 원화, 소수점 없이")은 내가 한 말 그대로 저장됩니다.

파일이 바뀌면 그 파일에서 가져온 수치는 다시 확인 필요로 표시되고 에이전트가 파일을 다시 읽습니다. 목록에 없는 것은 파일에서 읽거나 물어보며, 절대 추정하지 않습니다.

프로젝트 상단 → 에이전트가 아는 내용에서 전체를 볼 수 있습니다. 틀린 항목은 삭제하세요. 프로젝트 폴더(.amba/context.json, 숨김 파일)에 저장되어 프로젝트와 함께 이동하며, 선택한 AI 모델로 보내는 요청(개인정보 마스킹 적용) 외에는 컴퓨터 밖으로 나가지 않습니다.

메모리와 프로젝트 컨텍스트의 차이

AMBA는 에이전트에게 두 가지를 제공하며, 둘 다 직접 확인할 수 있습니다.

	프로젝트 컨텍스트	메모리
내용	파일에서 읽은 사실, 내가 말한 규칙	내가 저장한 메모, 커넥터가 가져온 문서
확인 위치	프로젝트 헤더 → 에이전트가 아는 내용	설정 → 메모리
작성 주체	AMBA (파일에서, 확인 후)	나 (답변의 지식으로 수집, 새 메모), 또는 기억하라고 요청했을 때의 에이전트

• 메모 저장: 에이전트 답변 아래에서 지식으로 수집을 누르고 사용 범위를 고릅니다: 이 프로젝트의 모든 에이전트(기본) 또는 이 에이전트만. 메모리에 자동으로 저장되는 것은 없습니다.
• 사용된 항목 확인: 저장된 메모를 불러온 답변에는 **사용된 메모리 (n)**이 표시됩니다. 열면 각 메모가 보이며, 틀리거나 오래된 항목은 삭제할 수 있습니다. 사용된 메모가 없으면 아무것도 표시되지 않습니다.
• 메모리 관리: 설정 → 메모리에 프로젝트, 사용 범위, 출처, 작성자와 함께 모든 메모가 나열됩니다. 프로젝트와 에이전트로 필터링하며 검색도 같은 필터를 사용합니다. 편집·삭제하거나 공통 지식으로 지정하여 모든 프로젝트의 모든 에이전트가 쓰게 할 수 있습니다(문서 발췌는 해당 프로젝트에 남습니다). 지우기는 필터에 보이는 것만 지웁니다: 이 프로젝트의 이 에이전트 항목, 프로젝트 전체, 또는 전부 — 항상 확인 후 실행됩니다.
• 한 프로젝트의 메모가 다른 프로젝트에서 일하는 에이전트에게 전달되는 일은 없습니다.