Akan.js
문서블로그적용사례로드맵배포
Akan.js
문서블로그적용사례로드맵배포
문서블로그적용사례로드맵배포
Akan.js

MIT 라이선스 하에 배포되었습니다.

  • Akan.js 공식 컨설팅 서비스AkansoftCopyright © 2026 Akan.js 모든 권리 보유.시스템 관리자bassman

    로드맵

    Akan.js의 로드맵

    첫 인터페이스부터 다중 빌드, Bun 우선 스택, 모바일·데스크톱 패키징, 에이전틱 표현, v3 에이전틱 프레임워크까지 여섯 단계를 지나왔습니다. 다음은 세션과 사람, 앱을 넘나드는 에이전트 네트워크, Akan Cloud, SSR·CSR 다음의 렌더링인 컨텍스트사이드 렌더링, 그리고 오토파일럿입니다.

    현재 단계
    v3 · 에이전틱 프레임워크
    릴리즈
    akanjs 3.0.0
    확정 단계
    2
    제안 단계
    2

    지나온 단계

    v1 · 인터페이스

    빌려 쓴 스택 위의 컨벤션

    NestJS, Next.js, Vite 위에서 MongoDB를 기본으로 썼습니다. 비즈니스 선언 하나로 서버, 웹, 데이터를 한 번에 움직일 수 있다는 걸 증명한 단계입니다.

    확정된 단계

    결정된 방향입니다. 다음 단계들입니다.

    제안된 단계

    검토 중인 후보입니다. 순서는 제안일 뿐 일정이 아닙니다.

    1. 03 · 제안 · SSR → CSR → context-side

    한 사람이, 제품 전체를.

    각 단계는 작은 팀이 직접 만들거나 운영해야 했을 것을 하나씩 덜어냅니다. 도착점은 웹, 데스크톱, 모바일, 서버, 데이터, 그리고 그 안에서 일하는 에이전트까지, 개발자 한 명이 책임질 수 있는 제품입니다.

    Akan.js 참여하기v3 사용하기
    v1인터페이스다중 빌드SSR / CSR / Serverv2Bun-first모바일iOS / Android데스크톱Linux / macOS / Windows에이전틱MCP · 인페이지 에이전트v3에이전틱 프레임워크01에이전트 네트워크02클라우드03컨텍스트사이드 렌더링04오토파일럿
    지나온 단계현재 위치확정제안
    다음 단계
    01 · 세션, 사람, 앱을 넘나드는 에이전트
    이어서
    02 · Akan Cloud

    다중 빌드 · SSR / CSR / Server

    라우트 하나, 결과물 셋

    라우트가 결과물 하나로 끝나지 않게 됐습니다. SEO용 서버 렌더 HTML, 앱용 클라이언트 번들, 서버 프로세스를 같은 소스에서 함께 빌드합니다.

    v2 · Bun-first

    Bun 우선, Akan이 직접 소유

    Bun을 유일한 런타임으로, 하단 프레임워크 계층은 Akan이 직접, 첫 데이터베이스는 SQLite로 바꿨습니다. 움직이는 부품이 줄고 개발부터 프로덕션까지 경로가 하나가 됐습니다.

    모바일 · iOS / Android

    같은 페이지에서 나온 모바일

    웹 빌드가 iOS, Android로 패키징됩니다. 목록-상세 흐름, 오버레이, 맥락 전환은 프레임워크가 이미 가진 화면 전환을 그대로 씁니다.

    데스크톱 · Linux / macOS / Windows

    두 번째 코드베이스 없는 데스크톱

    같은 워크스페이스가 Linux, macOS, Windows용 데스크톱 앱을 빌드합니다. 클라이언트 번들과 화면 전환을 그대로 재사용합니다.

    에이전틱 · MCP · 인페이지 에이전트

    에이전트에게 열린 표현

    모든 시그널이 MCP 서버가 되고, 인페이지 에이전트가 사람이 쓰던 컨트롤로 화면을 움직이기 시작했습니다. 별도의 API나 별도의 UI 없이 에이전트가 앱에 닿았습니다.

    v3에서 바뀐 것 읽기

    01 · 확정 · session ↔ session ↔ app

    세션, 사람, 앱을 넘나드는 에이전트

    v3의 에이전트는 브라우저 세션 하나 안에서 일합니다. 다음 단계는 세션과 사람, 앱을 넘어 에이전트끼리 협업하게 하되, 여전히 같은 가드가 막아섭니다.

    • 세션 → 세션: 진행 중인 작업을 다른 탭이나 기기로 넘기기
    • 사람 → 사람: 명시적이고 철회 가능한 동의로 다른 사람의 에이전트를 내 세션에 초대하기
    • 앱 → 앱: 한 앱의 에이전트가 OAuth로 다른 앱의 MCP 서버를 호출해 앱끼리 에이전트로 연결
    • 경계를 넘는 모든 행동의 감사 기록: 누가 요청했고, 어떤 에이전트가, 무엇을 건드렸는지

    실제 일은 한 사람, 한 앱에서 끝나지 않고, 가드 모델은 이미 누가 무엇을 할 수 있는지 알고 있습니다.

  • 02 · 확정 · git push → production

    Akan Cloud

    Akan을 위해 만든 배포 타깃입니다. cloud.akanjs.com이 akan build 결과물을 그대로 돌리고, 작은 팀이 직접 조립하지 않아도 될 운영 조각을 맡습니다.

    • 브랜치마다 프리뷰 환경
    • 복제, 백업, 시점 복구를 갖춘 관리형 DB
    • akan logs의 로그, 트레이스, 지표를 브라우저에서
    • 앱 옆에서 관리되는 시크릿과 env

    프레임워크가 이미 빌드를 소유하니, 착륙까지 맡으면 코드 한 줄에서 라이브 제품까지 고리가 닫힙니다.

  • 컨텍스트사이드 렌더링

    SSR은 서버에서, CSR은 브라우저에서 화면을 그렸습니다. 컨텍스트사이드 렌더링은 지금 이 사용자에게 맞는 화면을 조립합니다. 페이지를 선언하는 대신 컴포넌트와 도구로 이루어진 UI 툴킷만 두고, 에이전트가 실시간으로 사용자 플로우를 구성합니다.

    • 플로우마다 페이지를 선언하지 않고 컴포넌트와 도구로만 구성된 UI 툴킷
    • 경로로 라우팅하는 대신 컨텍스트마다 조립되는 화면
    • 생성된 모든 컨트롤이 여전히 같은 가드, 도구, 감사 기록 뒤에서
    • 조성이 거부됐을 때 폴백으로 남는 선언된 페이지

    SSR, CSR 다음의 에이전틱 렌더링 방식입니다. 스택이 이미 MCP 서버와 에이전트 도구를 노출하니, 다음에 생성할 표현은 화면 자체입니다.

  • 04 · 제안 · issue → diff → reviewed PR

    오토파일럿

    오토파일럿은 보조를 멈추고 레포지토리를 개발합니다. 이슈 하나를 받으면 코드를 직접 수정하고, diff를 정리해 PR까지 진행하며, 기능을 변경·확장합니다. 사람은 코드를 쓰는 대신 결과를 리뷰합니다.

    • 워크플로 허용 목록 안에서 워크스페이스를 직접 수정하는 이슈 → diff 실행
    • 단순 패치가 아니라 필드, 엔드포인트, 화면, 마이그레이션까지 건드리는 레포 수준 변경
    • 검증, abstract, 에이전트 가이드까지 같은 실행에서 갱신
    • 실제 워크스페이스로 돌리는 평가 세트, 릴리즈마다 공개

    엄격한 컨벤션이야말로 레포지토리 엔진이 사람 없이 기능을 바꾸고 확장하면서도 리뷰 가능한 PR을 남기게 합니다.