Files

T

can1357 af1832af1b feat(coding-agent/prompts): refined tool prompts for shell, browser, and eval workflows

- Simplified `bash` guidance to tighten allowed command patterns, pipeline limits, and launch-based process handling.
- Reworked `browser` instructions into grouped helper sections while preserving selector restrictions and key action semantics.
- Harmonized `eval`, `irc`, `read`, and `todo` prompt wording around state reuse, messaging, selector formats, and task operations.

2026-07-15 03:28:21 +02:00

3.1 KiB

Raw Blame History

{{#if asyncEnabled}}{{#if batchEnabled}}Delegate work to background subagents by passing multiple items in a single tasks[] batch. Execution does not block — you receive IDs immediately; results deliver when subagents finish.{{else}}Delegate work to ONE background subagent per call. Execution does not block — you receive an ID immediately; the result delivers when the subagent finishes.{{/if}}{{#if hasBlockingAgents}} Agents marked BLOCKING run inline — results return in this call; non-blocking items in the same batch still spawn as background jobs.{{/if}}{{else}}{{#if batchEnabled}}Run subagents synchronously by passing items in a tasks[] batch. Execution blocks until all work finishes.{{else}}Run ONE subagent synchronously. Execution blocks until work finishes.{{/if}}{{/if}}

Task Design

Agent typing: Pick each item's agent type. Read-only research MUST use agent: "scout" (faster model). Use default worker only when no specialist fits.
No overhead: Each task MUST instruct its agent to skip formatters, linters, and project-wide test suites. Run those once at the end.
One-pass: Prefer agents that investigate AND edit in one pass; spin a read-only scout only when affected files are genuinely unknown.

Inputs

context: Shared project state for the entire batch — don't duplicate into individual tasks.
tasks[]: Subagents to spawn.
- name: CamelCase ≤32 chars (auto-generated if omitted).
- agent: specialist type (optional).
- task: Complete, self-contained instructions — no one-liners, no missing acceptance criteria. {{#if isolationEnabled}}
- isolated: Run in dedicated worktree, return patches. Destroyed on completion, cannot be addressed afterward. {{/if}} {{else}}
name: CamelCase ≤32 chars (auto-generated if omitted).
agent: specialist type (optional).
task: Complete, self-contained instructions — no one-liners, no missing acceptance criteria. {{#if isolationEnabled}}
isolated: Run in dedicated worktree, return patches. {{/if}} {{/if}}

Communication

Subagents start blank — no conversation history.{{#if ircEnabled}} Parent-to-subagent IRC delivered immediately as steering.{{/if}} Pass large payloads via local://<path> URIs, NEVER inline text.

Format Contracts

{{#if batchEnabled}} context format:

Goal ← what the batch accomplishes

Constraints ← rules and session decisions

Contract ← shared interfaces

task format:

Target ← exact files and symbols; explicit non-goals

Change ← step-by-step add/remove/rename; APIs and patterns

Acceptance ← observable result; no project-wide commands

Available Agents

{{#if spawningDisabled}} Agent spawning is currently disabled. {{else}} Pick the most specific agent; use default worker only when no specialist fits. {{#list agents join="\n"}}

{{name}}{{#if readOnly}} (READ-ONLY){{/if}}{{#if blocking}} (BLOCKING: inline result){{/if}}

{{description}} {{#if readOnly}}Use ONLY for investigation; do edits yourself or assign to a writing agent.{{/if}} {{/list}} {{/if}}

3.1 KiB Raw Blame History