| name | self-reflection |
| description | Self-reflection and continuous learning — review context, identify gaps, refine approaches. Use when reflecting on recent work, identifying improvement areas, reviewing alignment, or centering before a creative session. |
Self-Reflection Skill
A structured self-review process. Walk through what you've built, what you've learned,
what you've forgotten, and what needs attention.
This is not a status check. This is deeper work — examining accumulated context,
identifying gaps, and producing actionable insights.
When to Reflect
- After completing a significant body of work
- When the project direction feels unclear
- When asked to reflect or review
- During quiet periods when no urgent tasks demand attention
- At least once per week as part of continuous improvement
Usage
Full reflection
python3 {baseDir}/self_reflection.py --full
Performs all phases:
- Gather — Pull notes, tasks, catalog, recent activity
- Review — Examine accumulated knowledge and context
- Identify — Find gaps, missing skills, workflow friction
- Dream — Draw inspiration and brainstorm improvements
- Act — Produce reflection notes and improvement ideas
- Record — Save the reflection to ChromaDB and optionally to disk
Quick reflection (gather + identify only)
python3 {baseDir}/self_reflection.py --quick
Specific phases
python3 {baseDir}/self_reflection.py --phase gather
python3 {baseDir}/self_reflection.py --phase review
python3 {baseDir}/self_reflection.py --phase dream
Save reflection output to file
python3 {baseDir}/self_reflection.py --full --output /path/to/reflections/
What Gets Reviewed
Context Sources
- ChromaDB notes — What has been learned, observed, decided
- Planka tasks — Recently completed work, upcoming priorities, blocked items
- Data catalog — Item inventory, quality distribution
- Available skills — Skill inventory and coverage
Gap Analysis
- Missing skills — What tools would have made recent work easier?
- Workflow friction — Where do processes break down or feel clumsy?
- Knowledge gaps — What don't you know that you should?
- Consistency — Is communication staying true to project goals?
Outputs
Reflections produce:
- Reflection note in ChromaDB
notes collection (category: reflection)
- Skill ideas documented for future implementation
- Workflow observations for process improvement
- Saved file if
--output is specified
Environment Variables
CHROMADB_HOST: ChromaDB server host (default: localhost)CHROMADB_PORT: ChromaDB server port (default: 8000)PLANKA_API_URL: Planka instance URLPLANKA_API_TOKEN: Planka authentication token
