Prepare and test-plan an existing project edit

Use this scenario

Run

Run project_edit scenario.

Use run_scenario with the saved scenario name and string-valued inputs. Required values are requested before execution.

View invocation JSON

JSON

{
  "scenario_name": "project_edit",
  "inputs": {
    "name": "your name",
    "request": "your request"
  }
}

project_edit2 INPUTS / 5 TOOLS / 4 STEPS

Inputs

PARAMETERS

Input	Requirement	Default value
`name`	Required	`No default`
`request`	Required	`No default`

Agent instructions

SYSTEM PROMPT

Prepare a private copy and scoped source edits. No generated code executes until the user explicitly uses the host project-test command. Do not publish original files.

Tool access

CAPABILITIES

project_edit_prepare_operation — selected from this version's tool catalog.
project_edit_apply_operation — selected from this version's tool catalog.
project_edit_require_operation — selected from this version's tool catalog.
project_draft_read_operation — selected from this version's tool catalog.
project_draft_source_operation — selected from this version's tool catalog.

Ordered steps

EXECUTION

01
BOUND OPERATION / HOST EXECUTED
project_edit_prepare_operation
- name = {{name}}
- request = {{request}}
Save output as draft.
02
BOUNDED COLLECTION / FRESH CHILDREN
Read draft.editAttempts as attempt. Target 1; at most 3 attempts. Collect applied.
Count successful applied results; distinct identity: not specified.
1. 01
  BOUND OPERATION / HOST EXECUTED
  project_draft_read_operation
  - id = {{draft.id}}
  Save output as current.
2. 02
  BOUND OPERATION / HOST EXECUTED
  project_draft_source_operation
  - id = {{draft.id}}
  Save output as currentSource.
3. 03
  NESTED SCENARIO / FRESH CHILD
  project_edit_plan ↗
  - kind = {{draft.kind}}
  - prd = {{draft.prd}}
  - request = {{request}}
  - source = {{currentSource.source}}
  - diagnostics = {{current.diagnostics}}
  Save output as changes.
4. 04
  BOUND OPERATION / HOST EXECUTED
  project_edit_apply_operation
  - id = {{draft.id}}
  - changes = {{changes}}
  Save output as applied.
Save output as editAttempts.
03
BOUND OPERATION / HOST EXECUTED
project_edit_require_operation
- id = {{draft.id}}
Save output as edited.
04
NESTED SCENARIO / FRESH CHILD
project_plan_tests ↗
- id = {{draft.id}}
Save output as receipt.

Return to main

COPY EXIT

Return private draft details and the separate execution approval command unchanged.

The final text returns without model rewriting. Bound operation scenarios return application results; pending changes still require host approval.

Complete XML, including any embedded C#. Copy it without changing the file's contents.

XMLStructureInputsTools / C#StepsExit

<scenario schemaVersion="3" id="project_edit" title="Prepare and test-plan an existing project edit">
  <inputs><input name="name" required="true"/><input name="request" required="true"/></inputs>
  <systemPrompt>Prepare a private copy and scoped source edits. No generated code executes until the user explicitly uses the host project-test command. Do not publish original files.</systemPrompt>
  <tools><allow name="project_edit_prepare_operation"/><allow name="project_edit_apply_operation"/><allow name="project_edit_require_operation"/><allow name="project_draft_read_operation"/><allow name="project_draft_source_operation"/></tools>
  <steps>
    <tool name="project_edit_prepare_operation" result="draft"><input name="name" value="{{name}}"/><input name="request" value="{{request}}"/></tool>
    <foreach items="draft.editAttempts" item="attempt" collect="applied" result="editAttempts" limit="1" attempts="3" successProperty="applied">
      <tool name="project_draft_read_operation" result="current"><input name="id" value="{{draft.id}}"/></tool>
      <tool name="project_draft_source_operation" result="currentSource"><input name="id" value="{{draft.id}}"/></tool>
      <run scenario="project_edit_plan" result="changes"><input name="kind" value="{{draft.kind}}"/><input name="prd" value="{{draft.prd}}"/><input name="request" value="{{request}}"/><input name="source" value="{{currentSource.source}}"/><input name="diagnostics" value="{{current.diagnostics}}"/></run>
      <tool name="project_edit_apply_operation" result="applied"><input name="id" value="{{draft.id}}"/><input name="changes" value="{{changes}}"/></tool>
    </foreach>
    <tool name="project_edit_require_operation" result="edited"><input name="id" value="{{draft.id}}"/></tool>
    <run scenario="project_plan_tests" result="receipt"><input name="id" value="{{draft.id}}"/></run>
  </steps>
  <exit mode="copy">Return private draft details and the separate execution approval command unchanged.</exit>
</scenario>

<scenario schemaVersion="3" id="project_edit" title="Prepare and test-plan an existing project edit">
  <inputs><input name="name" required="true" /><input name="request" required="true" /></inputs>
  <systemPrompt>Prepare a private copy and scoped source edits. No generated code executes until the user explicitly uses the host project-test command. Do not publish original files.</systemPrompt>
  <tools><allow name="project_edit_prepare_operation" /><allow name="project_edit_apply_operation" /><allow name="project_edit_require_operation" /><allow name="project_draft_read_operation" /><allow name="project_draft_source_operation" /></tools>
  <steps>
    <tool name="project_edit_prepare_operation" result="draft"><input name="name" value="{{name}}" /><input name="request" value="{{request}}" /></tool>
    <foreach items="draft.editAttempts" item="attempt" collect="applied" result="editAttempts" limit="1" attempts="3" successProperty="applied">
      <tool name="project_draft_read_operation" result="current"><input name="id" value="{{draft.id}}" /></tool>
      <tool name="project_draft_source_operation" result="currentSource"><input name="id" value="{{draft.id}}" /></tool>
      <run scenario="project_edit_plan" result="changes"><input name="kind" value="{{draft.kind}}" /><input name="prd" value="{{draft.prd}}" /><input name="request" value="{{request}}" /><input name="source" value="{{currentSource.source}}" /><input name="diagnostics" value="{{current.diagnostics}}" /></run>
      <tool name="project_edit_apply_operation" result="applied"><input name="id" value="{{draft.id}}" /><input name="changes" value="{{changes}}" /></tool>
    </foreach>
    <tool name="project_edit_require_operation" result="edited"><input name="id" value="{{draft.id}}" /></tool>
    <run scenario="project_plan_tests" result="receipt"><input name="id" value="{{draft.id}}" /></run>
  </steps>
  <exit mode="copy">Return private draft details and the separate execution approval command unchanged.</exit>
</scenario>

Download XML ↓

EVERY XML ELEMENT / IN FILE ORDER

Every part, briefly.

Short explanations of every element and chat step in this scenario.

01
<scenario>
Names and versions the workflow.
Writing example ↗
02
<inputs>
Declares input values.
Writing example ↗
03
<input>name
Requires a supplied value.
Writing example ↗
04
<input>request
Requires a supplied value.
Writing example ↗
05
<systemPrompt>
Sets the child's instructions.
Writing example ↗
06
<tools>
Defines available capabilities.
Writing example ↗
07
<allow>project_edit_prepare_operation
Grants an existing tool.
Writing example ↗
08
<allow>project_edit_apply_operation
Grants an existing tool.
Writing example ↗
09
<allow>project_edit_require_operation
Grants an existing tool.
Writing example ↗
10
<allow>project_draft_read_operation
Grants an existing tool.
Writing example ↗
11
<allow>project_draft_source_operation
Grants an existing tool.
Writing example ↗
12
<steps>
Orders the chat turns.
Writing example ↗
13
<tool>project_edit_prepare_operation
Executes a declared host operation.
Writing example ↗
14
<input>name
Binds a named operation or child input.
Writing example ↗
15
<input>request
Binds a named operation or child input.
Writing example ↗
16
<foreach>
Processes and collects a bounded array.
Writing example ↗
17
<tool>project_draft_read_operation
Executes a declared host operation.
Writing example ↗
18
<input>id
Binds a named operation or child input.
Writing example ↗
19
<tool>project_draft_source_operation
Executes a declared host operation.
Writing example ↗
20
<input>id
Binds a named operation or child input.
Writing example ↗
21
<run>
Invokes a fresh saved child scenario.
Writing example ↗
22
<input>kind
Binds a named operation or child input.
Writing example ↗
23
<input>prd
Binds a named operation or child input.
Writing example ↗
24
<input>request
Binds a named operation or child input.
Writing example ↗
25
<input>source
Binds a named operation or child input.
Writing example ↗
26
<input>diagnostics
Binds a named operation or child input.
Writing example ↗
27
<tool>project_edit_apply_operation
Executes a declared host operation.
Writing example ↗
28
<input>id
Binds a named operation or child input.
Writing example ↗
29
<input>changes
Binds a named operation or child input.
Writing example ↗
30
<tool>project_edit_require_operation
Executes a declared host operation.
Writing example ↗
31
<input>id
Binds a named operation or child input.
Writing example ↗
32
<run>
Invokes a fresh saved child scenario.
Writing example ↗
33
<input>id
Binds a named operation or child input.
Writing example ↗
34
<exit>
Returns the output unchanged.
Writing example ↗

Write a scenario, step by step ↗How sub-agents work ↗