Skip to content

docs(mcp): Phase 9 — agent workflow contract - #379

Merged
erishforG merged 1 commit into
release/1.0from
feat/auto-mcp-phase9-workflow
Jul 6, 2026
Merged

docs(mcp): Phase 9 — agent workflow contract#379
erishforG merged 1 commit into
release/1.0from
feat/auto-mcp-phase9-workflow

Conversation

@erishforG

Copy link
Copy Markdown
Owner

무엇

MCP spec에 에이전트가 여러 tool call을 조합할 때 따를 workflow contract를 추가합니다.

Refs #292. v1.0 MCP tool spec이 개별 tool schema와 auth/error contract는 갖췄지만, create/inspect/ship 흐름에서 dry-run, state inspection, retry ordering을 명시하지 않아 클라이언트별 동작 차이가 생길 수 있습니다. @erishforG

변경

  • startup discovery에서 initialize 이후 tools/list 캐시와 mutation 전 state inspection 규칙 추가
  • worktree_start -> worktree_status -> health_check -> worktree_ship 순서의 happy path 정의
  • mutating tool 실패/연결 종료 후 recovery expectation 추가
  • v1.0 draft의 idempotency-key 비요구 방침과 ticket 기반 reconciliation 명시

다음 Phase 힌트

  • tools/list 메타데이터에 workflow hint나 mutating/dry_run capability가 충분히 노출되는지 검토
  • fixture에 create/inspect/ship 시퀀스 문서 예시를 추가

리스크

Low. docs/mcp/spec.md 문서-only 변경이며 CLI, transport, git/worktree 로직은 수정하지 않았습니다.

롤백

해당 문서 섹션을 revert하면 됩니다.

Test plan

  • cargo build --quiet
  • cargo fmt --check
  • cargo clippy --all-targets -- -D warnings
  • cargo test --quiet

Refs #292

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@erishforG erishforG added the auto-improvement Daily auto-generated improvement PR/issue label Jul 6, 2026
@erishforG
erishforG merged commit 98242da into release/1.0 Jul 6, 2026
12 checks passed
@erishforG
erishforG deleted the feat/auto-mcp-phase9-workflow branch July 6, 2026 00:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

auto-improvement Daily auto-generated improvement PR/issue

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant