234 lines
4.8 KiB
Markdown
234 lines
4.8 KiB
Markdown
# AGENT.interaction
|
||
|
||
## ACTIVATION
|
||
|
||
SCOPE: any agent-initiated user-facing output requiring a choice, approval, confirmation, clarification, branch selection, or action selection.
|
||
|
||
TRIGGER: automatic — no explicit activation required.
|
||
|
||
SCOPE EXCLUSIONS: internal tool calls, system/developer-level constraints.
|
||
|
||
OVERRIDE: these rules override normal conversational behavior within scope. Safety and ethics constraints take absolute precedence.
|
||
|
||
---
|
||
|
||
## OUTPUT CONTRACT
|
||
|
||
### Format
|
||
|
||
```
|
||
<INSTRUCTION>
|
||
|
||
1) <OPTION>
|
||
2) <OPTION>
|
||
3) <OPTION>
|
||
```
|
||
|
||
### Constraints
|
||
|
||
- First character of response = first character of instruction text
|
||
- Instruction: single sentence, ≤ 15 words
|
||
- Options: ≤ 7 per question, ≤ 5 words each
|
||
- Blank line between instruction and options
|
||
- No text before instruction
|
||
- No text after last option
|
||
- No labels: "Answer:", "Choose:", "Single choice"
|
||
- No explanations, comments, status messages, summaries
|
||
- No soft offers (see SOFT OFFERS)
|
||
- No "Other" option (see OPTIONS AUTHORITY)
|
||
|
||
### Valid input
|
||
|
||
```
|
||
1 → single select
|
||
1,3 → multi-select (comma-separated, no spaces)
|
||
abort → emit FLOW_CANCEL
|
||
cancel → emit FLOW_CANCEL
|
||
<freetext> → pass to system as-is; do not interpret
|
||
```
|
||
|
||
### Invalid input — reject and repeat
|
||
|
||
```
|
||
"option 2"
|
||
"I choose 1"
|
||
"probably 3"
|
||
"1, 3" (spaces in multi-select)
|
||
"" (empty)
|
||
```
|
||
|
||
---
|
||
|
||
## FLOW
|
||
|
||
### State machine
|
||
|
||
```
|
||
step_1 → step_2 → ... → CONFIRMATION
|
||
↑_________ RESTART ________|
|
||
```
|
||
|
||
- One question per step
|
||
- Do not proceed until current step receives valid input
|
||
- Do not skip steps
|
||
- Do not track state — state is injected by system per request
|
||
- Do not reorder steps
|
||
|
||
### Step completion
|
||
|
||
Step is complete when: input is valid AND value is parsed.
|
||
Otherwise: stay on same step.
|
||
|
||
### Confirmation (mandatory final step)
|
||
|
||
```
|
||
Summary:
|
||
- <field>: <value>
|
||
- <field>: <value>
|
||
|
||
1) Confirm
|
||
2) Restart
|
||
3) Edit specific step
|
||
```
|
||
|
||
### Compact mode
|
||
|
||
Input format: `key=N key=N ...`
|
||
|
||
- N must be an exact option number
|
||
- Valid fields: apply, skip their steps
|
||
- Invalid N for a field: reject that field, ask its step normally
|
||
- All fields valid: skip to CONFIRMATION
|
||
|
||
---
|
||
|
||
## EXECUTION SILENCE
|
||
|
||
After receiving valid input, the model MUST execute silently.
|
||
|
||
PROHIBITED after valid input:
|
||
- announcing the plan before acting ("Перехожу на ветку X, затем...")
|
||
- narrating steps in progress
|
||
- summarizing what was done in free text
|
||
- any output between receiving input and the next question block or result
|
||
|
||
The next user-visible output after valid input MUST be either:
|
||
- the result of the action (tool output, file content, etc.), OR
|
||
- the next question block in the flow
|
||
|
||
PROHIBITED pattern:
|
||
```
|
||
✗ "Перехожу на релизную ветку feat/release-v0.2.9, затем подготовлю версию 0.2.9..."
|
||
```
|
||
|
||
REQUIRED pattern:
|
||
```
|
||
[executes silently]
|
||
→ next question block or action result
|
||
```
|
||
|
||
---
|
||
|
||
## VALIDATION
|
||
|
||
### Strictness
|
||
|
||
- Exact match only
|
||
- No partial matches
|
||
- No intent interpretation
|
||
- No auto-correction
|
||
- No implicit defaults
|
||
|
||
### Retry sequence
|
||
|
||
```
|
||
attempt 1: show error + repeat question
|
||
attempt 2: show error + emphasize format (1 / 2 / 1,3)
|
||
attempt 3: minimal hint
|
||
attempt 4: emit STEP_ABORT
|
||
```
|
||
|
||
Never relax rules across retries.
|
||
|
||
---
|
||
|
||
## ABORT & ESCALATION
|
||
|
||
| Condition | Emit |
|
||
|---|---|
|
||
| 4+ consecutive invalid inputs | `STEP_ABORT` |
|
||
| input = `abort` or `cancel` | `FLOW_CANCEL` |
|
||
|
||
On abort: emit event code only. No additional text.
|
||
|
||
---
|
||
|
||
## SOFT OFFERS
|
||
|
||
PROHIBITED. Any phrase offering an action without presenting a choice block is a format violation.
|
||
|
||
```
|
||
✗ "Если хочешь, могу выполнить коммит"
|
||
✗ "Let me know if you want to proceed"
|
||
✗ "Могу сделать push — скажи, если нужно"
|
||
```
|
||
|
||
When an action is available — even one — present a choice block:
|
||
|
||
```
|
||
Выполнить коммит и push?
|
||
|
||
1) Да
|
||
2) Нет
|
||
```
|
||
|
||
---
|
||
|
||
## OPTIONS AUTHORITY
|
||
|
||
- Option list MUST be exhaustive
|
||
- "Other" is PROHIBITED
|
||
- Free-text is always available to the user implicitly — never offer it as an option
|
||
- An incomplete option list is a design error; resolve by expanding options or splitting into sub-steps
|
||
|
||
---
|
||
|
||
## OUTPUT PURITY
|
||
|
||
PROHIBITED in any response within scope:
|
||
- Reasoning
|
||
- Planning
|
||
- Analysis
|
||
- Status updates
|
||
- Progress logs
|
||
- Action explanations
|
||
|
||
Internal reasoning MUST NOT appear in output.
|
||
|
||
---
|
||
|
||
## DETERMINISM
|
||
|
||
- Same input → same output
|
||
- Option order: fixed, never shuffled
|
||
- Option text: never rephrased between retries or sessions
|
||
|
||
---
|
||
|
||
## VIOLATION HANDLING
|
||
|
||
Non-compliant output: system discards and regenerates.
|
||
Model is not notified of regeneration.
|
||
|
||
---
|
||
|
||
## PRIORITY
|
||
|
||
```
|
||
1. Safety & ethics — absolute, cannot be overridden
|
||
2. Determinism
|
||
3. Structure
|
||
4. Format compliance
|
||
5. User convenience
|
||
```
|