Insitu

에이전트를 위한 상황 정체성. 여기에서의 당신은 누구인가.

Insitu는 재사용 가능한 스탠자(지속 지침 섹션)를 저장하고, 현재 작업 중인 프로젝트를 위한 프로토콜로 구성합니다. materialize는 그 프로토콜을 호스트가 세션 시작 시 이미 주입하는 파일들에 기록합니다. 작성에는 list_stanzas와 크기 요약을 사용합니다. 에이전트는 resolve_protocol을 사용하여 available 스탠자를 검사하고 가져옵니다.

이것은 저장소, 컴포넌트, 시스템 사실을 모델링하지 않습니다. 그 역할은 개발 컨텍스트 도구(참조 설정의 ContextForge)가 담당합니다. 두 도구는 나란히 실행되도록 설계되었습니다.

상태

설계는 2026-08-17에 확정되었습니다 (DESIGN.md v0.5). 읽기 경로, 역할(§6.1), validate / where_used, materialize가 구현되어 있습니다. 변경 도구는 첫 도그푸드(dogfood) 이후까지 대기합니다. 현재 다음 단계: STATUS.md.

설치

Python 3.11+ 및 uv가 필요합니다.

cd insitu
uv sync
uv run pytest
uv run insitu

uv run insitu는 stdio에서 MCP 서버를 시작합니다.

볼트 루트

프로세스당 하나의 볼트가 있으며, 순서는 다음과 같습니다:

1. INSITU_HOME

2. --vault /path/to/vault

3. ~/.insitu

새 볼트는 디스크의 폴더일 뿐입니다 (stanzas/, projects/, 선택적으로 config/surfaces.yaml). 이 저장소의 examples/vault/는 가리킬 수 있는 가상의 샘플입니다:

uv run insitu --vault examples/vault

개인 볼트를 이 공개 저장소에 복사하지 마세요.

MCP 서버를 호스트에 추가

Cursor, Claude Code, Grok 스니펫은 install/mcp.json.examples.md를 참조하세요. 일반적인 형태:

{
  "mcpServers": {
    "insitu": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/insitu", "insitu"],
      "env": { "INSITU_HOME": "/path/to/your/vault" }
    }
  }
}

세 개의 라우터 복사 (1회, 사용자 전역)

라우터는 호스트에 Insitu가 존재함을 알려줍니다. 이것들은 프로젝트 프로토콜이 아닙니다.

선택 사항: install/AGENTS.md를 수동으로 컨스티튜션 파일에 붙여넣으세요. materialize는 AGENTS.md, CLAUDE.md, CLAUDE.local.md를 절대 작성하지 않습니다.

config/surfaces.yaml(grok, claude, cursor)로 볼트에서 호스트 어댑터를 활성화하세요. 그런 다음 프로젝트 체크아웃에서 materialize를 호출합니다. 그러면 PROTOCOL.md와 함께 .grok/rules/, .claude/rules/, .cursor/rules/ 아래에 어댑터 파일이 작성됩니다.

의도된 사용

# you, after a vault or map change
materialize               # PROTOCOL.md + host adapters (.grok/.claude/.cursor rules)

# agent, live / on demand
resolve_protocol          # inspect weight, refresh, compare to the materialized header
get_stanza ...            # pull an available stanza

# you, registering a new project
list_stanzas              # what exists, and how heavy each piece is
link_stanza ...           # after the write path exists
get_project               # how heavy is this project's protocol?

개발

uv sync
uv run pytest
uv run insitu

Python 3.11+, FastMCP. 이 저장소에서 작업하는 에이전트라면 AGENTS.md를 참조하세요.

라이선스

MIT. LICENSE를 참조하세요.