검증 리포트
엔터프라이즈 Eve 에이전트 개발 핸드북 작성 시 확인한 소스, 문서, 구현 근거와 남은 리스크를 기록한다.
이 문서는 핸드북 작성 기준과 검증 범위를 기록합니다.
| 항목 | 값 |
|---|
| 소스 기준 | 비공개 로컬 Eve 소스 체크아웃 |
| package | packages/eve |
| Eve version | 0.11.4 |
| package description | Filesystem-first framework for durable backend AI agents that run anywhere. |
| 작성일 | 2026-06-18 |
| 공식 문서 대조 | 2026-06-18 https://eve.dev/sitemap.xml 기준 /docs/* 67개 Markdown 문서 |
| 문서 | 반영 장 |
|---|
README.md | 전체 개요 |
SKILL.md | 번들 문서 우선 원칙 |
docs/README.md | 문서 읽기 순서, public mental model |
docs/reference/project-layout.md | Ch3 |
docs/agent-config.md | Ch5 |
docs/concepts/execution-model-and-durability.md | Ch1, Ch13 |
docs/concepts/security-model.md | Ch8, Ch15 |
docs/concepts/sessions-runs-and-streaming.md | Ch9 |
docs/concepts/context-control.md | Ch6 |
docs/concepts/default-harness.md | Ch4, Ch7, Ch8 |
docs/tools/overview.mdx | Ch7 |
docs/tools/human-in-the-loop.md | Ch7 |
docs/connections.mdx | Ch7 |
docs/sandbox.mdx | Ch8 |
docs/channels/overview.mdx | Ch9 |
docs/channels/custom.mdx | Ch9 |
docs/subagents.mdx | Ch10 |
docs/guides/remote-agents.md | Ch10 |
docs/guides/dynamic-capabilities.md | Ch6 |
docs/guides/dynamic-workflows.md | Ch10 |
docs/guides/hooks.md | Ch11 |
docs/guides/state.md | Ch11 |
docs/schedules.mdx | Ch11 |
docs/evals/overview.mdx | Ch12 |
docs/evals/assertions.mdx | Ch12 |
docs/guides/auth-and-route-protection.md | Ch9, Ch15 |
docs/guides/deployment.md | Ch13 |
docs/guides/instrumentation.md | Ch13 |
2026-06-18에 공식 Introduction, 공식 sitemap, 공식 llms.txt를 기준으로 /docs/* 67개 문서의 Markdown 원문을 수집해 대조했습니다. 전체 링크 목록은 공식 문서 대조표에 정리했습니다.
대조 후 보정한 주요 항목:
| 항목 | 반영 |
|---|
| Beta/책임 고지 | index와 governance에 Beta 및 Responsible Use 기준 추가 |
agent.ts | root agent.ts 생략 가능, 작성 시 model 필수, scaffold/default model 표현 보정 |
| route auth | framework default와 scaffold placeholderAuth() 차이 명시 |
| channels | Slack/Discord/GitHub/Linear/Teams/Telegram/Twilio, WebSocket, cross-channel hand-off, metadata projection 추가 |
| client/frontend | TypeScript SDK와 useEveAgent, session cursor, clientContext 기준 추가 |
| evals | eve eval CLI 옵션, artifact 위치, 세부 eval 문서 분리 기준 추가 |
| 구현 파일 | 확인한 내용 |
|---|
packages/eve/package.json | package version, exports, public entrypoints |
packages/eve/src/public/index.ts | core public API |
packages/eve/src/public/tools/index.ts | tool helpers/export |
packages/eve/src/public/agents/auth.ts | remote agent outbound auth |
packages/eve/src/discover/project.ts | flat/nested project resolution |
packages/eve/src/discover/discover-agent.ts | authored slot discovery |
packages/eve/src/discover/manifest.ts | source manifest shape |
packages/eve/src/compiler/compile-agent.ts | artifact write and diagnostics handling |
packages/eve/src/compiler/manifest.ts | compiled manifest schema/version |
packages/eve/src/runtime/resolve-agent.ts | compiled node hydration |
packages/eve/src/runtime/resolve-agent-graph.ts | framework/authored registry merge |
packages/eve/src/runtime/agent/bootstrap.ts | RuntimeTurnAgent construction |
packages/eve/src/harness/tool-loop.ts | AI SDK tool loop, telemetry, compaction, HITL |
packages/eve/src/harness/tools.ts | ToolSet assembly, provider tool handling |
packages/eve/src/harness/input-requests.ts | pending input/approval resolution |
packages/eve/src/execution/workflow-entry.ts | durable driver loop, park/resume |
packages/eve/src/execution/turn-workflow.ts | turn workflow dispatch contract |
packages/eve/src/execution/workflow-steps.ts | "use step" harness execution |
packages/eve/src/execution/durable-session-store.ts | session snapshot and migration-aware state |
packages/eve/src/execution/session.ts | session hydration, compaction config |
| 요구 | 확인 |
|---|
| filesystem-first authoring | README, project-layout, discovery 구현 |
| durable session/turn/step | execution-model 문서, workflow-entry/turn-workflow 구현 |
| app runtime vs sandbox 분리 | security-model, sandbox 문서 |
| route auth fail-closed | auth-and-route-protection 문서 |
| tool approval default | tools/HITL 문서 |
| dynamic capability event order | dynamic-capabilities, workflow-steps 구현 |
| subagent isolation | subagents 문서, runtime graph 구현 |
| eval이 실제 HTTP surface를 구동 | evals overview |
| telemetry와 Workflow tags | instrumentation 문서 |
| 리스크 | 설명 |
|---|
| Preview API 변화 | Eve는 beta/preview 성격이며 API/behavior가 바뀔 수 있음 |
| 공식 문서 최신성 | 2026-06-18 공식 문서를 조회했지만 Eve beta 문서는 이후 변경될 수 있음 |
| 실제 Eve build 미실행 | 참조 Eve repo 자체의 test/build는 수행하지 않았고 코드/문서 정적 분석 중심 |
| 핸드북 렌더링 | MDX build/lint로 최종 확인 필요 |
이 핸드북을 실제 팀 표준으로 쓰려면 다음 artifact를 추가로 만들면 좋습니다.
| Artifact | 목적 |
|---|
| Eve PR template | tools/connections/channels/sandbox 변경 리뷰 |
| Eval starter kit | smoke, negative, approval, auth baseline |
| CODEOWNERS sample | 파일 슬롯별 owner 지정 |
| Production runbook | session.waiting, 401, sandbox, connection auth 장애 대응 |
| Data flow template | model/provider/tool/telemetry 경로 기록 |