| name | generate-reflective-note |
| type | python |
| description | Generate content with awareness of the agent's current reasoning state — goal analysis, situation context, character orientation. Like generate-note but informed by internal planner state. |
generate-reflective-note
LLM-based content generation with access to the agent's internal reasoning state.
Like generate-note, but the LLM prompt includes the planner's Stage 1 context
(character orientation, goal analysis, tool selection, situation awareness) as
background, enabling state-aware or reflective generation.
Input
prompt: Generation instruction (required)style: "code" or "text" (optional, default: "text")target_tokens: Integer (optional). Target output length in tokens. Overrides default max_tokens when provided via OUTPUT GUIDANCE.
Output
Success (status: "success"):
value: Generated content informed by agent state
Failure (status: "failed"):
reason: Error description
Behavior
- Automatically retrieves the planner's reasoning snapshot (if available)
- Includes it as
## Internal Reflective State context in the LLM prompt
- The prompt is the actual query; the reflective state is background
- Falls back to regular generation if no planner state is available
Planning Notes
- Use when the agent needs to generate content that reflects its current understanding,
orientation, or reasoning about the goal and situation
- Use
generate-note for plain generation without agent state awareness
- Typical uses: self-assessments, progress reflections, situation reports,
agent-perspective summaries, epistemic status notes
Examples
{"type":"generate-reflective-note","prompt":"Assess your current understanding of the user's goals and any gaps","out":"$assessment"}
{"type":"generate-reflective-note","prompt":"What aspects of this task are you most uncertain about?","out":"$uncertainty"}
{"type":"generate-reflective-note","prompt":"Summarize what you know about the current situation from the agent's perspective","out":"$sitrep"}
