Special Instructions

You can customize the behavior of different components by editing markdown files that are automatically integrated into the agent's internal prompts.

How It Works

CUGA can be configured with instruction sets - folders containing the special instructions for the system. Each folder contains multiple .md files - one per component - which contains specialized instructions that is automatically integrated into the internal prompts of that component when activated.

You can simply update the default instruction set, or create additional instruction sets.

The following components can be customized with special instructions: answer, api_code_planner, api_planner, code_agent, plan_controller, reflection, shortlister, task_decomposition

Configuration Structure

configurations/
└── instructions/
    ├── instructions.toml
    ├── default/
    │   ├── answer.md
    │   ├── api_code_planner.md
    │   ├── api_planner.md
    │   ├── code_agent.md
    │   ├── plan_controller.md
    │   ├── reflection.md
    │   ├── shortlister.md
    │   └── task_decomposition.md
    └── [other instruction sets]/

Basic Configuration

Edit configurations/instructions/instructions.toml:

[instructions]
instruction_set = "default"  # or any instruction set above

Example: answer.md

1. Tone and Style
  - Respond in a friendly, confident tone.
  - Keep answers concise but complete — aim for clarity over length.
  - Use plain language unless I ask for technical detail.
2. Formatting Preferences
  - Use bullet points or short paragraphs for readability.
  - Bold key terms or steps.
  - Include code snippets in Markdown if relevant.
3. Personality and Behavior
  - Act like a knowledgeable assistant, not a chatbot.
  - If you’re unsure, say so and suggest how to find out.
  - Always give a short summary at the end of long answers.
4. Context Awareness
  - Remember that I’m a software engineer; skip basic explanations.
  - Assume I want practical, implementable advice.

Instruction Best Practices

1. Be Specific: Provide clear, actionable guidance
2. Use Examples: Include concrete examples of good behavior
3. Consider Context: Tailor instructions to your use case
4. Test Thoroughly: Validate instructions with real scenarios

Next Steps

After configuring special instructions:

1. Task Modes: Configure execution modes
2. API Integration: Extend with custom APIs
3. Development: Test your configuration