# Generate Reflective Note

> 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.

- Skill: `bdambrosio/generate-reflective-note` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add bdambrosio/generate-reflective-note`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bdambrosio/generate-reflective-note/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: bdambrosio (https://skillmd.com/u/bdambrosio)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bdambrosio/generate-reflective-note

---


# 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

```json
{"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"}
```