docs: document MCP tool dependency system #60

Merged

Charon merged 1 commit from docs/doc-002-mcp-tool-dependency-system into main

2026-02-24 13:20:34 +00:00

Clotho commented

2026-02-23 12:06:35 +00:00

Member

Summary

Add Mcp/Tools/Agent/README.md documenting the ToolDependency system
Covers all three dependency types: contextExists, sessionState, entityExists
Documents context requirements (workspace_id, session_id) and multi-tenant safety patterns
Includes step-by-step guide for creating new tools with a full annotated example
Documents AgentTool base class properties and argument/response helpers
Explains dependency resolution order and recommended declaration sequence
Provides troubleshooting guide for common dependency and permission errors

Closes #32

Test plan

Review README for accuracy against actual tool implementations
Verify code examples match existing tool patterns (PlanCreate, SessionStart, StateSet, TaskUpdate)
Confirm troubleshooting section covers known failure modes

🤖 Generated with Claude Code

## Summary - Add `Mcp/Tools/Agent/README.md` documenting the `ToolDependency` system - Covers all three dependency types: `contextExists`, `sessionState`, `entityExists` - Documents context requirements (`workspace_id`, `session_id`) and multi-tenant safety patterns - Includes step-by-step guide for creating new tools with a full annotated example - Documents `AgentTool` base class properties and argument/response helpers - Explains dependency resolution order and recommended declaration sequence - Provides troubleshooting guide for common dependency and permission errors Closes #32 ## Test plan - [ ] Review README for accuracy against actual tool implementations - [ ] Verify code examples match existing tool patterns (PlanCreate, SessionStart, StateSet, TaskUpdate) - [ ] Confirm troubleshooting section covers known failure modes 🤖 Generated with [Claude Code](https://claude.com/claude-code)

Clotho added 1 commit 2026-02-23 12:06:35 +00:00

docs: document MCP tool dependency system

CI / PHP 8.3 (pull_request) Failing after 1m44s

Details

CI / PHP 8.4 (pull_request) Failing after 1m44s

Details

eb6bc27a4e

Add README to Mcp/Tools/Agent/ explaining:
- How ToolDependency works (contextExists, sessionState, entityExists)
- Context requirements (workspace_id, session_id) and multi-tenant safety
- Step-by-step guide for creating new tools
- AgentTool base class property and method reference
- Dependency resolution order and recommended declaration sequence
- Troubleshooting guide for common dependency errors

Closes #32

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>