아키텍처

Minara가 요청을 통제 가능하고 지속 가능한 결과로 바꾸는 방식

Minara Agent는 여러 역할을 수행하는 하나의 시스템입니다. 요청을 받고, 알맞은 문맥과 전문 역할을 조합하고, 행동을 경계 안에 두며, 다음 의사결정을 더 좋게 만드는 기록을 보존합니다.

아키텍처 한눈에 보기

진입점을 선택합니다. 데스크톱 앱, Web UI, 터미널 또는 연결된 메시징 표면을 사용할 수 있습니다.
작업 문맥을 만듭니다. runtime이 세션, 관련 메모리, 현재 설정, 작업 신호를 읽습니다.
작업을 조합합니다. 작업에 맞는 스킬과 전문 역할을 선택합니다. 더 중요한 결정에는 리서치, 반론, 위험, 포트폴리오 관점을 추가할 수 있습니다.
행동 경계를 정합니다. 권한 수준, 위험 한도, 확인, 긴급 중지가 이번 턴에서 Agent가 할 수 있는 일을 정합니다.
필요한 능력만 호출합니다. 능력 레지스트리가 승인된 리서치, 분석, 실행, 파일, 자동화, 통합 도구를 제공합니다.
증거와 결과를 보존합니다. SQLite가 영구 기록을 유지합니다. 학습과 의사결정 회고는 기반 모델을 바꾸지 않고 이후 작업을 개선합니다.

SQLite와 워크스페이스는 세션, 감사 기록, 설정, 메모리, 학습 결과물을 Minara 데이터 디렉터리에 저장합니다. 영구 상태를 백업하고 검사할 수 있는 한 곳에 둡니다.

runtime은 필요할 때만 외부에 연결합니다. 추론용 LLM provider, 시장 및 거래 작업용 Minara 서비스, 선택적 외부 스킬 패키지 또는 MCP server가 대상입니다. 외부 접근이 로컬 권한 모델을 우회하지는 않습니다.

영역	책임
`apps/agent`	Agent runtime, gateway, 능력 레지스트리, 스킬, 안전 제어, SQLite 상태
`apps/web-ui`	채팅, 시장, 포트폴리오, 자동화, 검토를 위한 브라우저 인터페이스
`apps/desktop`	gateway와 Web UI를 함께 실행하는 독립형 데스크톱 셸
`packages/*`	공유 타입, 클라이언트 라이브러리, UI primitive, hooks, validator, 디자인 토큰
`apps/docs`	지역화된 가이드와 렌더링된 다이어그램을 포함한 이 문서 사이트

턴 단위 흐름은 Agent Loop, 라우팅과 능력 활성화는 스킬 시스템, 안전 경계는 금융 안전을 참고하세요.