summaryrefslogtreecommitdiff
path: root/docs/workflow-and-entry-points.md
AgeCommit message (Collapse)Author
6 daysdocs: fix workflow diagram — create_story does not auto-spawn a builder taskHEADmainClaudomator Agent
The StoryOrchestrator skips stories with no root_task_id (if st.RootTaskID == "") so create_story / POST /api/stories do not trigger Builder spawning on the next tick as the diagram incorrectly claimed. Corrected the flowchart node, the entry-point table rows, and added an explanatory note on the story lifecycle kickoff flow. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
6 daysdocs: fix workflow diagram — webhook and spawn_subtask don't auto-submit ↵Claudomator Agent
to pool - GitHub webhook (createCIFailureTask) only calls store.CreateTask with PENDING state; it never calls Pool.Submit. Previous diagram said "creates task + auto-runs" which was wrong. - spawn_subtask (both role= and no-role= variants) only calls store.CreateTask with PENDING state via storeChannel.SpawnSubtask. The pool is not called. Previous diagram labelled this "Pool.Submit() for new child/sibling" which was wrong. - Both spawn_subtask variants always set parent_task_id. The "sibling with depends_on" description for the role= case was misleading. - propose_epic and propose_role_config are storage-only writes with no connection to the pool at all. Previous diagram drew arrows from these to executor.Pool; removed and replaced with a STORAGE node. - Added explicit note that PENDING children need a separate /run call (scripts/start-next-task, StoryOrchestrator.spawnRoleTask, or manual). - StoryOrchestrator's spawnRoleTask correctly creates + QUEUED + Pool.Submit in one step; that path remains accurate. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
6 daysdocs: add workflow and entry points diagramClaudomator Agent
Covers all entry points verified against current code: - REST API (POST /api/tasks + /run), chatbot MCP (submit_task, create_story, accept_story), GitHub webhook, Story REST API, agent spawn_subtask (parent_task_id vs depends_on/role paths), propose_epic, propose_role_config, StoryOrchestrator's internal spawning (ensureEvaluators/ensureArbitration/ensureFixAttempt/ spawnNestedFixAttempt/processRetro), Scheduler retry/escalation and ask_user-timeout escalation, claudomator run <file> CLI. Includes task state machine diagram and recursive arbitrated-review cycle showing that builder-role READY means awaiting arbitration, not done. All diagrams use Mermaid (renders on GitHub). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>