continuity

장기 AI 작업을 위한 이식 가능한 git 기반 프로젝트 상태 — Claude Code, Cursor, 또는 MCP를 지원하는 모든 도구에서 사용할 수 있습니다.

메모리 도구가 아닙니다. 메모리 도구는 *"우리가 무슨 이야기를 했지?"*라는 질문에 답합니다. Continuity는 다른 질문에 답합니다: "이 프로젝트에 대해 지금 무엇이 사실이며, 무엇을 건드리면 안 되는가?"

이런 방식으로 만든 이유

• 상태는 git으로 추적되는 일반 마크다운 파일로 존재합니다. Git 자체가 이벤트 로그입니다: 히스토리 = git log, 롤백 = git revert, 감사 = git blame. 모든 주장은 사람이 읽을 수 있고, diff가 가능하며, 직접 편집할 수 있습니다. AI가 캡처한 내용을 생성된 코드를 검토하는 것과 같은 방식 — 즉 diff로 — 원할 때마다 검토할 수 있습니다. 캡처 시점에 승인 게이트는 없습니다.

• 두 가지 저장 모드, 하나의 API. 저장소 모드 (<repo>/.continuity/, 작업 디렉토리에서 상위로 탐색하여 찾음)는 Claude Code처럼 프로젝트 cwd가 있는 편집기/에이전트 도구에 적합합니다. 중앙 모드 (~/.continuity/projects/<name>/, 이름이 있는 프로젝트)는 Claude Desktop처럼 프로젝트 cwd가 없는 도구에 적합합니다 — 프로젝트 이름으로 참조하기만 하면 됩니다.

• 재개 컨텍스트는 해당 파일들의 결정적 투영입니다 (읽기 경로에 LLM 없음) — 고정된 제약, 이전 것을 대체한 이유가 포함된 활성 결정, 다시 제안해서는 안 되는 거부된 경로, 미해결 질문, 그리고 다음 단계.

• 신뢰는 맹목적 믿음이 아닌 정직함에서 나옵니다. 모든 주장은 confidence + provenance를 담고 있어, 새 세션이 무엇이 확인된 것이고 무엇이 AI 추론인지 알고 모든 것을 믿는 대신 보정할 수 있습니다.

전체 아키텍처는 DESIGN.md, 동기를 부여한 검증은 poc/에서 확인하세요.

Related MCP server: KeepGoing MCP Server

설치 (Claude 플러그인으로)

Continuity는 Claude Code 플러그인으로, 자체 플러그인 마켓플레이스로 배포됩니다 — 이 저장소가 마켓플레이스입니다. Claude Code가 실행되는 모든 곳에서 작동합니다: 터미널, 데스크톱 앱, 웹. Claude Code에서:

/plugin marketplace add vikcena01/ai-continuity-plugin
/plugin install continuity@continuity-marketplace

그게 전부입니다 — 번들된 MCP 서버, continuity 스킬(자동 재개 + 자동 캡처), SessionStart 훅, 그리고 /resume /freeze /why 명령이 모두 함께 설치됩니다. dist/는 커밋되어 있고 의존성이 없으므로 설치 시 빌드 단계가 없습니다.

로컬 개발

npm install
npm run build   # typecheck + bundle to dist/
npm test        # build + 69 assertions across four suites

루프 (CLI)

continuity init "Build Snip, an internal URL shortener"
continuity record-decision "PostgreSQL is the source of truth" --body "ops knows it; volume is modest"
continuity reject "DynamoDB as primary store" --reason "KV overhead unjustified at our volume"
continuity record-constraint "Short codes are exactly 7-char base62" --body "printed in marketing + partner contract"
continuity freeze "7-char base62"     # lock an invariant — fuzzy: id OR title substring
continuity resume                     # <- the compact state a new session gets
continuity why "301"                  # <- what a decision replaced, and why
continuity resolve "8-char codes" --reject --reason "separate namespace"
continuity list                       # ids are short: d1k3, c2m9, x1p4, ...
continuity log                        # the git-backed event log

주장은 짧고 입력 가능한 id를 가집니다 — 타입 접두사, 일련 번호, 두 글자 접미사: d1k3, c2m9, x1p4. 접미사가 동시 작업을 안전하게 만듭니다: 접미사가 없으면 16번째 결정을 각각 기록하는 두 개발자가 모두 claims/d16.md에 쓰고 병합 시 충돌합니다. freeze / why / supersede / resolve는 id 또는 제목 부분 문자열을 허용합니다. 상태는 claims/ 아래에 기록되고 모든 변경 시 git에 자동 커밋됩니다 — 그러나 자동 푸시는 절대 되지 않으므로, resume은 캡처된 커밋이 푸시되지 않은 채 남아 있을 때 경고합니다.

주장 종결

resolve는 주장이 종결 상태에 도달하는 유일한 방법이며, 이유는 필수입니다 — 그냥 사라지는 주장은 다음 세션에 아무것도 가르쳐주지 않습니다:

continuity resolve <id-or-text> --accept --reason "..."   # a parked conflict wins
continuity resolve <id-or-text> --reject --reason "..."   # it becomes a guardrail
continuity resolve <id-or-text> --close  --reason "..."   # a settled risk/question

고정된 주장에 대해 대기 중인 주장을 수락하려면 추가로 --unfreeze가 필요합니다. 고정은 모델에서 유일한 인간의 행위이므로, 이를 무시하려면 두 번째로 의도적인 행위가 필요합니다.

Claude Desktop에서 사용 (MCP)

프로젝트 cwd가 없지만 MCP를 지원하는 모든 호스트는 이름이 있는 프로젝트와 함께 MCP 서버를 사용할 수 있습니다. (참고: Claude 데스크톱 앱은 내부에서 Claude Code를 실행하므로 전체 플러그인 — 훅, 명령, 스킬 — 이 작동합니다; 이 경로는 순수 MCP 호스트용입니다.) 빌드(npm run build) 후 claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "continuity": {
      "command": "node",
      "args": ["/absolute/path/to/ai-continuity-plugin/dist/mcp.js"],
      "env": { "CONTINUITY_HOME": "/Users/you/.continuity/projects" }
    }
  }
}

그런 다음 채팅에서: "snip이라는 continuity 프로젝트를 만들어" → create_project; "snip 재개" → resume_context; 모델이 진행하면서 결정/제약/거부를 기록합니다. 사용자가 호출할 수 있는 resume 프롬프트는 Claude Code의 자동 재개 훅을 대체하는 Desktop용입니다. 도구: list_projects, create_project, resume_context, record_decision, record_constraint, record_rejection, record_open, capture, resolve_claim, freeze_claim, why.

Claude Code 플러그인으로 (보너스)

이 저장소 자체가 Claude Code 플러그인이기도 합니다 (매니페스트는 .claude-plugin/plugin.json). 여기서는 MCP 서버 위에 Claude Desktop이 할 수 없는 것들을 얻을 수 있습니다:

• 새 세션 / 재개된 세션 / 압축 후 세션에서 resume_context를 자동 주입하는 SessionStart 훅 (hooks/hooks.json) — 직접 요청할 필요가 없습니다;

• 턴 종료 시 캡처 검사를 실행하는 Stop 훅 — 누군가 요청하는 것을 기억하지 않아도 결정이 기록됩니다. 두 개의 독립적인 가드(stop_hook_active + 시간 제한)가 루프를 불가능하게 만듭니다;

• 슬래시 명령 /resume, /freeze, /why.

저장소는 또한 자체 커밋된 dist/에 대해 동일한 훅을 등록하는 .claude/settings.json을 제공합니다. 따라서 git clone만 실행하는 협업자는 아무것도 설치하지 않고 자동 재개와 자동 캡처를 얻습니다. 두 훅 모두 세션별로 중복 제거되므로, 플러그인을 설치하고 또한 저장소를 클론하는 것은 무해합니다.

주장 형식

각 .continuity/claims/<id>.md:

---
id: d4k7
type: decision            # decision | constraint | rejected_alternative | mission | milestone | question | next_action | ...
status: accepted          # accepted | frozen | superseded | rejected | open | needs_review | resolved | done
resolution:               # set by `resolve`: why this claim was closed
confidence: confirmed     # confirmed | tentative | unverified
provenance:
  origin: manual
  created: 2026-08-04T00:00:00.000Z
supersedes: []
superseded_by: null
depends_on: []
tags: []
---
Postgres is the primary datastore; a Redis read cache may come later.

주장 형식 (계약)

다른 사람의 저장소가 주장을 보유하게 되면 파일 형식은 계약이 됩니다 — 그래서 버전을 담고 있습니다:

---
schema: 1              # absent means 1
id: d16k3              # <type prefix><n><2-char suffix>; the suffix keeps concurrent clones from colliding
type: decision         # mission requirement decision constraint architecture milestone
                       # hypothesis experiment risk question next_action rejected_alternative
title: One crisp fact
status: accepted       # accepted active frozen open superseded invalidated rejected
                       # needs_review completed done resolved
confidence: confirmed  # unverified tentative confirmed
provenance: { origin: auto, created: ... }
supersedes: []
superseded_by: null
superseded_reason: ""  # why the replacement happened — travels with the claim
resolution: ""         # why it was closed, set by `continuity resolve`
---

Prose body. The reason, the context, whatever a future session needs.

안정성 약속. 이전 버전의 Continuity가 작성한 주장은 항상 읽을 수 있습니다: schema가 없으면 1을 의미하고, 이전 형태는 파일을 다시 쓰지 않고 메모리에서 앞으로 마이그레이션됩니다. 최신 Continuity가 작성한 주장은 절반만 파싱되는 대신 이름으로 명시적으로 거부됩니다 — 이해하지 못하는 형태를 추측하는 것은 상태가 조용히 손상되는 방식입니다. continuity migrate는 디스크에 버전을 명시적으로 두고 싶을 때 현재 스키마로 파일을 다시 씁니다.

캡처된 내용 검토

캡처는 자율적이므로, 안전장치는 작성된 내용을 볼 수 있다는 것입니다:

continuity review            # semantic diff: what appeared, changed status, or was edited — and why
continuity review --accept   # mark it reviewed

도구 쓰기뿐만 아니라 수동 편집도 감지하며, 재개 컨텍스트는 변경 사항이 대기 중일 때 알려줍니다.

상태

v1.0 — 결정적 코어 + CLI + MCP 서버 + Claude Code 플러그인. 버전이 있는 주장 파일, 충돌 방지 id, 퍼지 조회, 예산이 있는 재개 투영, git 기반 이벤트 로그, 그리고 7개 스위트에 걸친 124개의 단언 (npm test).

현재 작동 중:

• 각 턴 종료 시 Stop 훅에 의해 구동되는 자율 캡처 — 모델이 기억하는 것이 아닙니다.

• 모든 배치 캡처 뒤의 조정기(reconciler): 중복 제거, 계보를 보존하는 대체(supersession), 그리고 고정된 주장과 모순되는 것을 적용하는 대신 needs_review로 대기시키는 고정 가드.

• 조정기가 대기시킨 것을 종결하고, 해결된 위험/질문을 종결하는 resolve 동사.

알려진 한계는 이 저장소 자체의 .continuity/에 주장으로 추적됩니다: Stop 훅 캡처 검사는 최대 10초에 한 번으로 제한되므로, 매우 빠른 교환에서 결정된 사항은 여전히 놓칠 수 있습니다(q3); 지저분한 세션에서 안정적인 상태 추출이 여전히 공개된 기술적 위험입니다(q2).

마크

하나의 끊기지 않는 호로 그려진 C — 세션 사이에서 살아남는 실 — 노드, 즉 단일 캡처된 주장에서 끝납니다. assets/icon.svg는 아바타나 파비콘용 둥근 타일에 같은 마크입니다; assets/logo-light.svg와 assets/logo-dark.svg는 prefers-color-scheme에 의해 선택되는 워드마크 조합으로, 두 GitHub 테마 모두에서 작동합니다.

라이선스

MIT — LICENSE 참조. Copyright (c) 2026 Vikash.