Skip to content

doc: document {ORIGINAL_INSTRUCTIONS} placeholder for toolset instructions#2062

Merged
dgageot merged 1 commit intodocker:mainfrom
dgageot:board/document-how-one-can-use-original-instru-b2251d83
Mar 11, 2026
Merged

doc: document {ORIGINAL_INSTRUCTIONS} placeholder for toolset instructions#2062
dgageot merged 1 commit intodocker:mainfrom
dgageot:board/document-how-one-can-use-original-instru-b2251d83

Conversation

@dgageot
Copy link
Member

@dgageot dgageot commented Mar 11, 2026

Summary

Document how to use {ORIGINAL_INSTRUCTIONS} in a toolset instruction field to enrich the built-in instructions rather than replacing them.

Changes

  • agent-schema.json: Updated the instruction field description for both Toolset and MCPToolset to explain the {ORIGINAL_INSTRUCTIONS} placeholder and its behavior.
  • examples/toolset_instructions.yaml: New example demonstrating the three usage patterns:
    1. Enrich by appending custom rules after the originals
    2. Enrich by prepending custom rules before the originals
    3. Full replacement (omit the placeholder)
  • examples/README.md: Added the new example to the Basic Configurations table.

…tions

Update the agent-schema.json description for the toolset instruction field
(both Toolset and MCPToolset) to explain that {ORIGINAL_INSTRUCTIONS} can
be used to enrich built-in instructions rather than replacing them.

Add examples/toolset_instructions.yaml demonstrating the three patterns:
enrich by appending, enrich by prepending, and full replacement.

Add the new example to examples/README.md.

Assisted-By: docker-agent
@dgageot dgageot requested a review from a team as a code owner March 11, 2026 14:36
Copy link

@docker-agent docker-agent bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review Summary

Assessment: 🟢 APPROVE

This documentation PR cleanly adds the {ORIGINAL_INSTRUCTIONS} placeholder feature to the schema and provides clear examples.

Analysis

Schema Changes (agent-schema.json):

  • Updated instruction field descriptions for both Toolset and MCPToolset
  • Descriptions are clear, consistent, and explain the placeholder behavior with examples
  • JSON syntax is valid

Example (toolset_instructions.yaml):

  • Demonstrates all three usage patterns (prepend, append, replace)
  • YAML is well-structured with helpful comments
  • Consistent with the schema documentation

Documentation (examples/README.md):

  • Correctly adds the new example to the table

Findings

✅ No bugs found. The changes are documentation-only and correctly implement the feature description.


Automated review by docker-agent

@dgageot
Copy link
Member Author

dgageot commented Mar 11, 2026

cc @k33g

@dgageot dgageot merged commit 5947f4b into docker:main Mar 11, 2026
8 checks passed
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.

2 participants