Witness

AI 에이전트는 행동할 수 있습니다. Witness는 그들의 작업에 책임성을 부여합니다.

모델은 코드를 작성하고, 도구를 호출하고, 다른 모델에게 작업을 넘길 수 있습니다. 그러나 채팅이 사라지면 무엇이 남을까요?

Witness는 에이전트 작업을 영속적이고 검사 가능한 프로젝트 메모리로 전환합니다: 결정, 증거, 결과, 기록, 신원, 그리고 이력 — MCP를 통해 노출됩니다.

빌더는 “완료”라고 말할 수 있습니다. Witness는 무엇이 결정되었는지, 실제로 무엇이 발생했는지, 그리고 다음 에이전트가 무엇을 검증할 수 있는지를 보존합니다.

실제 데모 실행 · 로드맵 살펴보기 · v0.1.0 설치

Related MCP server: Cruxible Core

실패 모드

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

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.

Witness를 사용하면, 영속적 객체는 대화가 아닙니다. 그것은 입증된 프로젝트 상태입니다.

시스템이 작동하는 모습을 확인하세요

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 references
    Validator->>Witness: Read decision and outcome
    Validator->>Witness: Verify or dispute result
    NextAgent->>Witness: Restore bounded project context
    Witness-->>NextAgent: Why + what happened + current evidence

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

[1/3] Decision witnessed: builder cannot validate its own release
[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

이를 통해 가능해지는 것

책임 있는 빌더

빌더는 작업을 생성하는 동안 다른 에이전트가 원래 결정 및 증거에 대해 이를 검증할 수 있습니다. 실행과 승인이 더 이상 동일한 모델 컨텍스트에 존재할 필요가 없습니다.

모델 독립적 연속성

모델을 교체하거나, 프로세스를 재시작하거나, 다음 주에 재개하세요. 다음 에이전트는 오래된 채팅을 역설계하는 대신 제한된 프로젝트 컨텍스트를 검색할 수 있습니다.

증거 인식 릴리스 게이트

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

경계가 있는 메모리

Witness는 무제한 대화 기록 덤프가 아닙니다. 공개 코어는 선언된 프로젝트 객체를 저장하고, 영속화 전에 지원되는 PII를 편집하며, 제한된 읽기를 사용하고, 선언되지 않은 권한을 거부합니다.

에이전트가 마음대로 다시 쓸 수 없는 감사 추적

공개 코어 변경과 감사 이벤트는 함께 커밋되거나 전혀 커밋되지 않습니다. 표준 트리거는 추가 전용 작업 이력을 업데이트와 삭제로부터 보호합니다.

꿈의 기능

이것들은 v0.1.0에서 번들된 오케스트레이션이 아닌, 활성화된 패턴입니다:

• 자율 소프트웨어 팩토리 — 모든 릴리스가 누가 결정했는지, 누가 구축했는지, 무엇이 테스트되었는지, 어떤 증거가 통과했는지에 답할 수 있습니다.

• 교차 모델 연속성 — Claude, GPT, 로컬 모델, 전문 에이전트가 프로젝트 진실을 잃지 않고 자리를 바꿀 수 있습니다.

• 자기 개선 에이전트 조직 — 검증된 결과가 채팅 기록으로 사라지는 대신 나중에 학습 계층에 공급될 수 있습니다.

• 소유자가 읽을 수 있는 자율성 — 인간이 “시스템이 왜 이렇게 했습니까?”라고 물을 수 있고 기록된 결정 체인을 받을 수 있습니다.

• 사고 메모리 — 동일한 실패를 재발견하는 대신 근본 원인과 예방을 다음 실행으로 전달합니다.

• 휴대 가능한 증명 — 외부 검증자가 빌더의 서술을 신뢰하지 않고 릴리스된 증거를 검사할 수 있습니다.

Witness는 증거 토대를 제공합니다. 스케줄링 에이전트, 빌더 생성, 자동 학습, 교차 제품 브리지는 별도의 계층입니다.

현재 구축된 것 — 그리고 아직 구축되지 않은 것

버전 0.1.0은 검증된 공개 릴리스입니다. 이 서비스는 이 저장소에 의해 배포되지 않으며, 게시는 프로덕션 지원 또는 사용자 영향에 대한 주장이 아닙니다.

공개 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 첫 실행 진단을 실행합니다.

프로젝트 센터

• 제품 로드맵: ROADMAP.md

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

• 기여 및 DCO: CONTRIBUTING.md

• 보안 신고: SECURITY.md

• 지원 범위: SUPPORT.md

• 공식 명칭 및 포크: TRADEMARKS.md

라이선스

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