증인 증거(Witness Evidence)

에이전트 시스템을 위한 개방형 증거 계층

당신의 에이전트는 행동할 수 있습니다. Witness는 무엇이 결정되었는지, 어떤 증거가 첨부되었는지, 그리고 다음 에이전트가 무엇을 물려받을 수 있는지를 보존합니다.

AI 에이전트는 행동할 수 있습니다. Witness는 그들의 작업을 책임질 수 있게 만듭니다.

에이전트는 점점 소프트웨어 인력이 되어가고 있습니다. 하지만 그들이 수용한 진실은 여전히 너무 자주 채팅 로그에 갇혀 있습니다. 플래너가 방향을 선택하고, 빌더가 "완료"를 보고하고, 검증자가 나중에 도착하며, 다음 모델은 누가 그 결과를 신뢰했는지 그 이유를 재구성해야 합니다.

Witness Evidence는 에이전트 플랫폼 및 AI 인프라 엔지니어를 위한 것입니다. 이들의 에이전트, 모델, 그리고 추적 데이터는 수용된 프로젝트 상태를 보존하는 능력보다 빠르게 성장하고 있습니다. Witness는 MCP를 통해 신원에 바인딩된 결정, 첨부된 증거, 결과, 수명주기 변경, 그리고 경계가 있는 프로젝트 컨텍스트를 기록합니다.

진실을 위임하지 않고 실행만 위임하세요.

실제 로컬 데모 실행(v0.1.0 코어) · 현재 실행 가능한 기능 보기 · 기능 로드맵 탐색 · 증명 상태 확인

Related MCP server: Clockchain Developer Tools MCP Server

Witness가 위치하는 곳

MCP connects agents to tools.
A2A connects agents to agents.
Traces show what ran.
Durable runtimes keep workflows alive.
Witness preserves what was decided, which evidence was attached, which status transitions followed, and what the next agent may inherit.

Witness는 에이전트 런타임, 추적, 오케스트레이션, Git, 또는 관측성을 대체하지 않습니다. 실행 세부사항 위에 지속적인 증거 경계로 자리합니다. 즉, 팀이 실행한 결정, 생성된 결과, 증거 참조, 각 상태 전환을 수행한 신원, 그리고 이후 에이전트가 복구할 수 있는 컨텍스트를 기록하는 장소입니다.

실패 모드

공유된 증거 계층이 없으면, 다중 에이전트 시스템은 자신만만한 대화 기록 더미가 됩니다:

Planner:   “Build the release.”
Builder:   “Done.”
Validator: “Which bytes? Which requirements? Why this design?”
Next run:  “I have no context from the previous chat.”
Owner:     reconstructs everything by hand.

지속되어야 할 객체는 대화가 아니라, 목격된(witnessed) 프로젝트 상태여야 합니다.

현재 실행 가능한 기능

버전 0.1.0은 로컬 오픈소스 증거 코어를 실행합니다:

• 프로젝트, 결정, 인사이트, 결과, 기록, 수명주기, 경계 컨텍스트, FTS5 검색을 위한 10개의 MCP 도구;

• 정확한 도구, 요청 페이로드, 테넌트, 프로필, 런타임 세대, nonce에 바인딩된 서명된 에이전트 신원 엔벨로프;

• 역할 기반 기본 거부(default-deny) 접근 및 멱등(idempotent) 변경;

• 영속화 전 개인정보 보호를 위한 redaction;

• 트랜잭션 추가 전용(append-only) 작업 감사가 포함된 SQLite 영속성;

• 별도의 빌더 및 검증자 신원을 사용하는 실제 로컬 흐름;

• 재현 가능한 Apache-2.0 릴리스 아티팩트 및 단계별 신규 설치 doctor.

포함된 데모에서, 별도의 합성 검증자 신원이 결과를 verified로 이동시킵니다. 전환은 해당 행위자와 그 이유를 기록합니다. 버전 0.1.0은 빌더/검증자 분리를 강제하지 않으며, 공개 읽기 프로젝션을 통해 결과의 based_on 증거 참조를 노출하지 않고, 참조된 아티팩트를 가져오지 않으며, 정확성을 자동으로 판단하지 않습니다. 이것은 자동 증거 검증이 아닙니다.

시스템이 움직이는 모습 보기

sequenceDiagram
    actor Owner
    participant Planner
    participant Builder
    participant Validator
    participant Witness
    participant NextAgent as Next agent / model

    Owner->>Planner: Ship a validated release
    Planner->>Witness: Record decision + acceptance rule
    Planner->>Builder: Build exact candidate
    Builder->>Witness: Record outcome + evidence reference
    Validator->>Witness: Read decision and outcome
    Validator->>Witness: Accept or dispute the result
    NextAgent->>Witness: Restore bounded project context
    Witness-->>NextAgent: Decision + outcome + acceptance state

저장소에는 실제 로컬 MCP 흐름이 포함되어 있습니다. 임시 데이터베이스를 생성하고, 별도의 서명된 합성 빌더 및 검증자 신원을 사용하며, 결정과 결과를 기록하고, 결과를 recorded에서 verified로 이동시키며, 프로젝트 컨텍스트를 복원합니다.

[1/3] Decision recorded: require independent validation
[2/3] Outcome verified by a distinct validator identity
[3/3] Project context restored from the database
WITNESS_DEMO_PASS decisions=1 outcomes=1 outcome_status=verified distinct_validator=true context_restored=true

증거 등급: 실제 로컬 제품 흐름. 데모는 합성 자격증명으로 공개 MCP 서버와 영속성 계층을 실행합니다. 클라우드 스크린샷, 시뮬레이션된 응답, 또는 외부 통합의 증명이 아닙니다.

실제 데모 실행

git clone https://github.com/MaximilianoColoma/witness.git
cd witness
uv sync --locked
uv run python examples/coordinated_autonomy_demo.py

예상되는 최종 출력 줄:

WITNESS_DEMO_PASS decisions=1 outcomes=1 outcome_status=verified distinct_validator=true context_restored=true

이것이 가능하게 하는 것

책임 있는 빌더

빌더는 작업을 생성할 수 있고, 데모에서 보여주듯 다른 신원이 이후 검토 전환을 수행할 수 있습니다. 팀은 Witness가 해당 불변식을 추가할 때까지 자체 정책에서 필요한 빌더/검증자 분리를 강제해야 합니다.

모델 독립적 연속성

모델을 교체하거나, 프로세스를 재시작하거나, 다음 주에 재개하세요. 이후 에이전트는 오래된 대화 기록을 역공학하는 대신 경계가 있는 프로젝트 객체를 검색할 수 있습니다.

증거 인식 게이트

결정, 결과, 영수증, 상태 전환은 CI, 릴리스 거버넌스, 사고 검토, 인간 승인에 대한 쿼리 가능한 입력이 됩니다.

경계가 있는 메모리

Witness는 대화 기록 덤프나 일반 RAG 저장소가 아닙니다. 선언된 프로젝트 객체를 영속화하고, 영속화 전에 지원되는 PII를 redaction하며, 읽기를 제한하고, 선언되지 않은 권한을 거부합니다.

일반 제품 호출이 쉽게 다시 쓸 수 없는 감사

공개 코어 변경과 감사 이벤트는 함께 커밋되거나 전혀 커밋되지 않습니다. 정식 트리거는 일반 애플리케이션 경로를 통한 운영 기록의 업데이트와 삭제를 보호합니다.

다음 단계 구축

교차 모델 프로젝트 연속성

다음 개발자 기능은 이식 가능한 연속성 계약입니다. Claude, Codex, GPT, 로컬 모델, 전문 에이전트가 동일한 경계가 있는 Witness 프로젝트 상태를 사용하고 원래 채팅에 접근하지 않고도 작업을 계속할 수 있어야 합니다.

이것은 계획된 것이며, 아직 외부적으로 입증되지 않았습니다. 증명은 다른 에이전트 팀이 현재 결정, 첨부된 증거, 수용 상태를 재구성해야 하며, 재구성 시간과 실패 사례를 측정해야 합니다. EVIDENCE.md를 참조하세요.

Claude, Codex, OpenAI Agents SDK, LangGraph, 또는 Temporal용 자사 어댑터는 v0.1.0에 포함되지 않습니다. 오늘날 이러한 시스템은 통합자가 구축한 사용자 정의 MCP/클라이언트 연결을 통해서만 Witness에 도달할 수 있습니다. 문서화된 참조 어댑터는 로드맵 작업이지 현재 기능이 아닙니다.

북극성(North star)

Witness는 에이전트 조직이 에이전트, 모델, 실행, 시스템 전반에 걸쳐 결정하고, 증명하고, 학습한 것을 보존하는 개방형 증거 및 학습 인프라가 되는 것을 목표로 합니다.

그 북극성에는 이식 가능한 검증과 검증된 학습 환류(verified learning return) 가 포함됩니다. 수용된 결과는 검증되지 않은 텍스트가 조용히 정책이 되는 것을 허용하지 않으면서 이후 작업에 정보를 제공할 수 있습니다. v0.1.0에서는 자동 교차 모델 학습이 아닙니다.

두 제품 아키텍처

Mission은 별도의 제품입니다. Spindle은 Witness 내부의 계획된 학습 기능입니다.

Mission은 에이전트 작업을 조정합니다. Witness는 증거를 보존하며 검증된 학습이 축적되도록 설계되었습니다.

flowchart LR
    H["Human<br/>goal and direction"] --> M["Mission<br/>coordinates"]
    M --> G["Specialist agents<br/>work"]
    G --> E

    subgraph W["Witness"]
        E["Decision · Outcome · Evidence"] --> S["Spindle<br/>planned learning function"]
        S --> L["Patterns · Rules · Guards"]
    end

    L -. "future governed return" .-> M

증거 코어는 오늘 실행됩니다. 전체 Spindle 학습 루프는 계획된 상태입니다. Witness 내부에서의 미래 역할은 Witness의 verified 수명주기 상태에 있는 결과를 가져와, 추가 적격성 및 검토 게이트를 거친 후, 관리되는 학습 후보, 재사용 가능한 패턴, 규칙, 이후 Mission 실행을 위한 가드로 전환하는 것입니다. 상태는 수용 전환을 기록하지만, 그 자체로 Witness가 기저 증거를 가져오거나 독립적으로 검증했음을 증명하지는 않습니다. 버전 0.1.0은 이러한 아티팩트를 생성하거나 자동으로 피드백하지 않습니다.

꿈의 기능

이것들은 오늘날 번들된 오케스트레이션이 아닌 활성화된 패턴입니다:

• 대화 기록 접근 없이 교차 모델 연속성;

• 외부 검증자가 빌더의 서술을 신뢰하지 않고 검사할 수 있는 이식 가능한 증명;

• Witness 내부의 계획된 학습 기능인 Spindle을 통한 검증된 학습 환류;

• 지속적인 결정 체인을 통한 소유자가 읽을 수 있는 자율성;

• 수용된 근본 원인과 예방을 이후 미션에 전달하는 사고 메모리.

모든 토큰은 시스템을 이전보다 더 가치 있게 떠나야 합니다. 이것은 제품 방향이지, 현재의 효율성 또는 경제적 주장이 아닙니다.

Mission과 Witness는 두 가지 주요 제품입니다. Mission은 작업을 조정하고, Witness는 증거 경계와 계획된 Spindle 학습 기능을 소유합니다. v0.1.0에는 자동 Witness-to-Mission 학습 환류가 포함되지 않습니다.

지금 구축된 것 — 그리고 아직 아닌 것

서비스는 이 저장소에 의해 배포되지 않습니다. 게시와 녹색 CI는 프로덕션 운영, 규모, 절감, 또는 사용자 영향을 증명하지 않습니다.

공개 MCP 표면

정식 계약은 spec/ 아래에 있습니다. FTS5는 로컬 텍스트 검색이지, 의미론적 또는 벡터 검색이 아닙니다.

설치 및 검증

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

./install.sh --manifest --json
./install.sh --target "$HOME/.local/share/witness" --non-interactive --json
uv sync --locked
uv run python -m pytest -q -p no:cacheprovider tests repair-tests
uv build

단계별 설치 프로그램은 상속된 Python 환경 변수를 정리하고, 잠긴(locked) 설치를 수행하며, 경계가 있는 로컬 구성과 저장소를 작성하고, 실제 MCP 최초 실행 doctor를 실행합니다.

명명 및 기술적 정체성

Witness Evidence는 공개용 한정어이며, 기술 식별자는 변경되지 않습니다. 저장소 MaximilianoColoma/witness, 패키지 witness-public, Python 모듈 witness_public, MCP 도구 이름, 계약, 릴리스된 v0.1.0 아티팩트는 기존 기술 식별자를 유지합니다. 요컨대: 이야기는 더 명확해졌고, 유선(wire)은 그대로입니다.

관련 없는 기존 프로젝트도 Witness라는 이름을 사용합니다. 혼동 방지 고지 사항은 TRADEMARKS.md를 참조하세요.

프로젝트 센터

• 기능 로드맵: ROADMAP.md

• 증거 및 증명 상태: EVIDENCE.md

• 거버넌스 및 릴리스 권한: GOVERNANCE.md

• 기여 및 DCO: CONTRIBUTING.md

• 보안 신고: SECURITY.md

• 지원 범위: SUPPORT.md

• 명명 및 혼동 방지: TRADEMARKS.md

라이선스

Apache License 2.0에 따라 라이선스가 부여됩니다. NOTICE를 참조하세요. Apache-2.0은 사용, 수정, 재배포, 상업적 사용을 허용합니다. 공식 프로젝트 지위나 상표 승인을 암시할 권한은 부여하지 않습니다.