Cognitive · 인지 / Agent Operating System
JARVIS - Personal AI Operating System
1인 개발로 진행한 개인용 AI 운영체제(JARVIS)입니다. Fastify 오케스트레이션 백엔드와 Next.js HUD 인터페이스를 결합해 provider routing, missions/councils/executions, approvals, workspaces, memory, watchers를 하나의 제품 표면으로 묶었습니다.
- 역할
- 1인 개발 · 아키텍처, 구현, 운영 도구
- 기간
- 2026.02 - Present
- 맥락
- Personal Project
1인 개발로 진행한 개인용 AI 운영체제(JARVIS)입니다. Fastify 오케스트레이션 백엔드와 Next.js HUD 인터페이스를 결합해 provider routing, missions/councils/executions, approvals, workspaces, memory, watchers를 하나의 제품 표면으로 묶었습니다.
무엇이 시스템을 어렵게 만들었는가.
애매한 사용자 요청을 리서치, 코드 실행, 승인, 자동화 흐름으로 라우팅하면서도, 역할 권한, 스트리밍 상태, provider fallback, workspace execution이 운영자 관점에서 이해 가능해야 했습니다.
어떤 경계와 흐름으로 답했는가.
Fastify 백엔드에 typed route 모듈, auth/role enforcement, rate limit, SSE stream, provider registry/policy, missions/councils/executions, workspace PTY 엔드포인트를 구성했습니다. 프론트는 visual core와 widget routing을 갖춘 Next.js HUD로 만들고, OpenAPI 동기화 타입과 Playwright dogfood 검증을 붙였습니다.
시스템을 통과하는 책임의 경로.
Orchestrator Backend
API & Workflow Core
Responsibilities
- — Missions/councils/executions routes
- — Provider routing and policies
- — Role-gated approvals and workspaces
HUD Frontend
Operator Interface
Responsibilities
- — Visual core + modular widgets
- — Workspace and approval surfaces
- — Mission-focused navigation
Quality Loop
Verification & Dogfood
Responsibilities
- — OpenAPI-generated client types
- — E2E smoke coverage
- — Dogfood reports with screenshot evidence
개요
- 1인 개발로 진행한 개인용 AI 운영체제입니다.
- 오케스트레이션 백엔드와 HUD 스타일 오퍼레이터 인터페이스를 결합해, 작업 라우팅/승인/실행/근거 표시를 하나의 제품으로 구성했습니다.
백엔드 표면
1) 오케스트레이션 API
- auth, providers, assistant contexts, missions, councils, executions, workspaces, memory, approvals, reports, radar, upgrades, jarvis sessions 등의 Fastify route 모듈을 구성했습니다.
- role 기반 인증/세션 처리, rate limit, raw-body parsing, 오류 정규화를 포함합니다.
- mission/council/execution/assistant/dashboard/notification 업데이트를 SSE/event 스트림으로 제공합니다.
2) 실행/정책 제어
- provider routing policy, credential resolution, registry refresh, token/health worker를 포함합니다.
- workspace runtime의 PTY spawn/write/read/shutdown 엔드포인트를 구성했습니다.
- 고위험 액션은 approval gate와 notification channel을 통해 제어합니다.
프론트엔드 표면
1) HUD 인터페이스
- Inbox, Assistant, Council, Workbench, Tasks, Reports, Watchers, Dossier, Notifications, Skills, Approvals, Memory, Settings, Model Control, Ideation 모듈을 가진 Next.js HUD를 구성했습니다.
- visual core 페이지와 scene switching, widget 기반 네비게이션을 제공합니다.
- core, studio, mission, tasks, approvals, automations, settings, reports 등의 딥링크 라우트를 가집니다.
2) 타입/클라이언트 동기화
- OpenAPI 스펙에서 프론트 타입을 생성해 클라이언트 계층과 맞췄습니다.
- 위젯 간 API 요청/응답을 타입 기반으로 연결했습니다.
품질 루프
- core visibility, HUD intake autoplay, council trace, session restore, auth/settings에 대한 Playwright smoke 커버리지를 구성했습니다.
- 저장소 내부에 도그푸딩 리포트, 스크린샷, 검증 결과를 남겨 회귀와 품질 이력을 추적합니다.
- 공개 GitHub 저장소를 통해 코드와 검증 산출물을 직접 확인할 수 있습니다.