vv-reflect

Extract generalized lessons and runbooks from session context into repository memory.

11|1|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/osovv/vv-opencode --skill vv-reflect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vv-reflect
Source: https://github.com/osovv/vv-opencode/tree/main/templates/skills/vv-reflect
Command: npx skills add https://github.com/osovv/vv-opencode --skill vv-reflect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Long development, debugging, bugfix, operations, and investigation sessions often uncover valuable lessons, fixes, and domain knowledge that get lost when the session ends, leaving future agents to repeat the same mistakes or rediscover the same insights.

Core Features & Use Cases

  • Generalized Knowledge Extraction: Extracts transferable lessons and reusable runbooks from session context instead of raw session transcripts, ensuring only durable, actionable knowledge is preserved.
  • Flexible Destination Routing: Automatically routes approved entries to existing high-confidence repository documentation, or falls back to the structured .vvoc XML memory store if no suitable existing destination exists.
  • Use Case: After a long debugging session where you uncovered a non-obvious repository quirk that causes intermittent test failures, use this skill to capture the quirk as a generalized lesson so future agents can avoid the same trap without re-investigating.

Quick Start

Use the vv-reflect skill at the end of your current development, debugging, or investigation session to propose durable, generalized repository knowledge entries for future agents.

Frequently Asked Questions about vv-reflect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I capture lessons learned from a debugging session as durable repository memory?

You can capture session insights as durable repository memory by applying a reflection workflow that extracts generalized lessons from chat context and routes them to existing documentation or a structured XML fallback store. This preserves transferable knowledge for future agents instead of discarding it.

What is the best way to generate runbooks from agent session context?

The best way to generate runbooks from agent session context is synthesizing visible chat interactions into reusable procedures rather than saving raw transcripts. This extracts durable, actionable knowledge from long debugging or investigation tasks to prevent future agents from rediscovering the same insights.

How does knowledge capture from session reflection work for future agents?

Knowledge capture through session reflection works by analyzing visible chat context at the end of a work session, proposing generalized lessons, and enforcing explicit per-entry approval before writing files. Approved entries are routed to high-confidence repository documentation or a structured XML memory store.

Can I route extracted session insights to existing repository documentation?

Yes, you can route extracted session insights to existing high-confidence repository documentation automatically. If no suitable existing destination is found, the workflow falls back to a structured .vvoc XML-first memory store to ensure durable knowledge is always preserved.

Do I need to approve repository memory entries before they are written?

Yes, explicit per-entry approval is strictly required before writing any files during the repository memory capture process. This ensures you maintain control over what generalized lessons and runbooks are persisted as durable knowledge for future agents.

When should I not use session reflection for knowledge capture?

You should not use session reflection for knowledge capture during short or trivial interactions where no generalized lessons or reusable procedures can be extracted. It applies specifically to long development, debugging, bugfix, operations, or investigation tasks yielding durable insights.