“docs/report.md에 보고서를 저장했습니다.”
declared by model
LOCAL-FIRST CONTINUITY FOR AI AGENTS
세션은 끊깁니다.
작업은 이어져야 합니다.
Kontexus는 에이전트의 태스크, 결정, 대화, 체크포인트와 판단의 마지막 경계를 프로젝트 안에 남깁니다. 다음 세션은 기억을 추측하지 않고, 기록된 상태에서 다시 시작합니다.
MCP / 29 TOOLS
CLI + WEB
RUST / 5 CRATES
FILE-FIRST
SESSION 01
Context exhausted
conversation closed
SESSION 02
State recovered
T30.1 · active
PROJECT STATE
.workgraph/
Tasks · Notes · Chat · FTM
The session resets. The work does not.
ACTIVE TASK
T30.1
bound to main
LAST VERDICT
CONFIRMED
server observed
01 — THE GAP
대화 기록은
프로젝트 상태가 아닙니다.
컨텍스트 창은 닫히고, 세션은 중단되며, 에이전트는 다시 시작됩니다. 그때 사라지는 것은 대화만이 아닙니다.
무엇을 왜 결정했는지, 현재 작업의 경계가 어디인지, 어떤 작용이 이미 실행되었는지, 다음 세션이 어디서 이어야 하는지가 함께 사라집니다.
Kontexus는 그 상태를 세션 밖, 프로젝트 안에 둡니다.
WITHOUT KONTEXUS
Session
lost
Session
lost
Session
WITH KONTEXUS
Session
state
Session
state
Session
02 — CLAIM / OBSERVATION
“완료했습니다”는
주장입니다.
에이전트가 제시한 evidence는 에이전트의 진술로
남습니다. serverEvidence는 서버가 직접 만들며,
에이전트가 제공하거나 덮어쓸 수 없습니다.
KONTEXUS / TURN CLOSURE
SERVER-OWNED OBSERVATION
target exists: docs/report.md
file · 4,210 bytes · modified 04:41:12
03 — DURABLE RECORDS
다음 세션에 필요한 것만,
다섯 개의 기록으로.
대화를 무작정 쌓는 대신, 서로 다른 역할을 가진 상태를 분리해 보존합니다. 안정적인 식별자로 직접 지목하고 검색은 보조로 사용합니다.
TASK / TURN
무엇을 하기로 했고, 의미 경계마다 어디까지 왔는지.
tasks/T27/task.md
CHECKPOINT / TRACK
사람이 확정한 작업의 이력과 병렬 작업의 계보.
checkpoints/C16/
NOTE
태스크 밖에서도 살아남아야 할 결정, 규칙, 예외와 주의.
notes/2,mym,1.md
CHAT
결정에 이른 대화를 수집하고 태스크의 시간축과 연결.
session_chat
FTM SEAM
세션이 끊긴 순간의 다음 상태와 아직 실행하지 않은 Effect.
nextInputState
NOT A TRANSCRIPT ARCHIVE. A WORKING MODEL OF THE PROJECT.
04 — ONE PROJECT TRUTH
파일이 원천입니다.
나머지는 모두 같은 상태를 보는 창입니다.
프로젝트 기록은 사람이 읽고 편집할 수 있는 파일에 남습니다. SQLite는 삭제 후 다시 만들 수 있는 검색 색인이며, 운영 이음과 큐만 별도로 유지합니다.
AI AGENTS
Codex
Claude Code
Gemini
OpenCode
MCP · 29 tools
CANONICAL PROJECT STATE
.workgraph/
tasks/
notes/
checkpoints/
chats/
human-readable files + derived index
HUMAN OPERATORS
CLI / TUI
Web Dashboard
$EDITOR
Git
inspect · edit · confirm
HUMAN-READABLE
GIT-FRIENDLY
REBUILDABLE INDEX
NO VECTOR DB REQUIRED
05 — OPERATOR SURFACE
에이전트가 기록하고,
사람은 같은 상태를 봅니다.
MCP가 쓰는 값과 CLI·TUI·웹 대시보드가 보여주는 값은 분리된 사본이 아닙니다. 같은 저장소, 같은 응답 계약 위에서 움직입니다.
TASK GRAPH
작업의 현재 위치
루트 Task와 Turn, 활성·등록·확정 상태를 한 화면에서 읽습니다.
ACTUAL PRODUCT OUTPUT
1 / 3
06 — AGENT LOOP
매 실행은 망각이 아니라,
상태에서 시작합니다.
루프는 다시 시작될 수 있습니다. 작업까지 초기화될 필요는 없습니다.
-
01
RECOVER
활성 태스크, 최근 checkpoint, 알림과 미완 판단을 불러옵니다.
check_kontexus_updates -
02
BIND
식별자를 발급하고 기록을 만든 뒤 현재 작업에 결속합니다.
set_active_task -
03
WORK
판단, Effect, invariant와 미결 질문을 분리해 진행합니다.
structure_reasoning -
04
OBSERVE
실행 결과와 서버가 직접 관측한 사실을 대조합니다.
record_effect_outcome -
05
CONTINUE
다음 세션이 이어받을 마지막 상태 경계를 남깁니다.
get_ftm_continuation -
06
CONFIRM
사람이 stage된 작업을 확인하고 이력으로 확정합니다.
task checkpoint
08 — ENGINEERED FOUNDATION
프롬프트 관습이 아니라,
인프라로 만들었습니다.
결정론적인 상태 변화와 IO 경계를 분리한 Rust 워크스페이스. 사람과 에이전트가 함께 쓰는 기록 계층을 배포 가능한 두 바이너리로 묶었습니다.
RUNTIMERust 1.96+edition 2021
ARCHITECTURE5 cratespure core / IO boundary
DISTRIBUTION2 binariesstatically linked sqlite
MCP SURFACE29 toolsstdio server
REASONINGState × Input → State′content-addressed
RIGOR3 levelsstandard / verified / strict
kontexus-core
+
kontexus-ftm
→
kontexus-store
→
mcp / cli
09 — START HERE
에이전트보다 오래 남는
프로젝트 기억을 만드십시오.
사람이 읽고, 에이전트가 이어받으며, 관측된 사실이 주장을 반박할 수 있는 상태를 프로젝트 안에 두십시오.
kontexus-cli init --project-name my-project
VERSION 0.9.2 SCHEMA workgraph-memory/v3.1.0 LOCAL-FIRST · MCP-NATIVE