Skip to content

Fix Automations docs drift: job prompt args and missing review tools#779

Open
selfcontained wants to merge 1 commit into
mainfrom
agt_263d1389d88e/job-doc-ter-dda77ad0
Open

Fix Automations docs drift: job prompt args and missing review tools#779
selfcontained wants to merge 1 commit into
mainfrom
agt_263d1389d88e/job-doc-ter-dda77ad0

Conversation

@selfcontained

Copy link
Copy Markdown
Owner

Summary

  • Removed inaccurate claim that job prompts support {{D:Arg Name}} template placeholders — standalone jobs (the only kind creatable via UI or MCP) don't substitute args; the server-side substitution only fires for template-backed jobs, which have no creation surface.
  • Added 3 missing human review tools (dispatch_review_list_feedback, dispatch_review_resolve, dispatch_review_add_message) to the "Tools available to job agents" section — these are in JOB_TOOLS but were absent from the docs.

Audit scope

Deep-dive of the in-app Automations docs section (automations.tsx). Verified all claims against:

  • automations-form-fields.tsx (template create form fields)
  • jobs-add-dialog.tsx (job create form fields and defaults)
  • jobs-settings-tab.tsx (job settings, webhook toggle)
  • automations-pane.tsx (tab structure: Templates/Jobs/Brains)
  • automations-launch-dialog.tsx (launch dialog flow)
  • agent-types.ts (CLI_AGENT_TYPES for job agent filtering)
  • jobs/service.ts (run lifecycle, substituteArgs gating, buildJobPrompt)
  • shared/mcp/server.ts (JOB_TOOLS set)

Everything else in the section checked out: template fields, launch flows, job create fields and defaults, run lifecycle statuses, trigger sources, auto-review description, state-across-runs section, and the Automations UI tab description.

Deferred to next run

Next focus: Audit the docs-pane Notifications section against notification-settings.tsx and the server notification system.

🤖 Generated with Claude Code

…dd missing review tools

Co-Authored-By: Claude Opus 4.6 <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant