diff --git a/.story_kit/stories/upcoming/41_agent_completion_notification_via_mcp.md b/.story_kit/stories/upcoming/41_agent_completion_notification_via_mcp.md new file mode 100644 index 0000000..21393a1 --- /dev/null +++ b/.story_kit/stories/upcoming/41_agent_completion_notification_via_mcp.md @@ -0,0 +1,21 @@ +--- +name: Agent Completion Notification via MCP +test_plan: pending +--- + +# Story 41: Agent Completion Notification via MCP + +## User Story + +As a CLI user coordinating sub-agents, I want to be notified when an agent completes without manually polling, so that I can review results promptly without babysitting the process. + +## Acceptance Criteria + +- [ ] MCP tool wait_for_agent(story_id, agent_name) blocks until the agent reaches a terminal state (completed, failed, stopped) +- [ ] Returns the agent's final status and summary info (session_id, worktree_path, any commit made) +- [ ] Respects a timeout parameter so callers aren't stuck forever +- [ ] Works as a background call from Claude Code CLI so the user can keep working while waiting + +## Out of Scope + +- TBD