memory: sync dynamic capabilities and state documentation

This commit is contained in:
Annie Tunturi
2026-03-23 15:21:22 -04:00
parent 48dc241152
commit fa35e1a218
9 changed files with 544 additions and 25 deletions

105
system/dynamic/README.md Normal file
View File

@@ -0,0 +1,105 @@
---
description: Guide to auto-updating dynamic files pattern
limit: 10000
---
# Dynamic Files Pattern
**Pattern:** Auto-updating ephemeral data that refreshes without agent action.
## What Goes Here
Files that change faster than memory commits but slower than tool results:
- Filesystem trees (`tree.md`)
- Capability catalogs (`mycapabilities.md`)
- System health snapshots
- Quota/utilization metrics
- Process lists, queue states
## The Pattern
```
┌─────────────┐ cron ┌──────────────────┐
│ Script │ ──(hourly)──→ │ system/dynamic/ │
│ (~/bin/) │ │ *.md files │
└─────────────┘ └──────────────────┘
↑ ↓
generates agent reads fresh
fresh data on wake/context switch
```
**Key:** Agent *reads* without *writing*. Ephemeral freshness without memory churn.
## Requirements
1. **Script location:** `/home/ani/bin/update-*`
2. **Output location:** `memory/system/dynamic/*.md`
3. **Cron:** Hourly (`0 * * * *`) or as needed
4. **Frontmatter:** Include `limit: NNNN` for progressive disclosure
5. **Timestamp:** Always include last-updated timestamp
## Template
```bash
#!/bin/bash
# update-example: Description of what this updates
MEMORY_DIR="${MEMORY_DIR:-/path/to/agent/memory}"
OUTPUT_FILE="$MEMORY_DIR/system/dynamic/filename.md"
generate() {
echo "---"
echo "description: Auto-generated [what]. Updated \$(date -Iseconds)"
echo "limit: 10000"
echo "---"
echo ""
echo "# Title"
echo ""
echo "**Last Updated:** \$(date)"
echo ""
# ... generation logic ...
}
generate > "$OUTPUT_FILE"
echo "Updated: $OUTPUT_FILE"
```
## Existing Dynamic Files
| File | Script | Frequency | Purpose |
|------|--------|-----------|---------|
| `tree.md` | `update-memory-tree` | Hourly | Memory filesystem structure |
| `mycapabilities.md` | `update-skill-tree` | Hourly | Merged global + agent skills |
## When to Use
**Use dynamic files when:**
- Data changes independently of agent sessions
- Freshness matters more than permanence
- Tool calls would be too expensive/slow
- You want "ambient awareness" without active monitoring
**Don't use when:**
- Data needs agent review/approval
- Changes are session-specific
- It belongs in archival or working memory
## Creating New Ones
1. Write script to `~/bin/update-<name>`
2. Test: `chmod +x` and run manually
3. Add to crontab: `crontab -e`
4. Verify output in `system/dynamic/`
5. Reference in agent prompts if needed
## Cron Reference
```cron
# Hourly updates
0 * * * * /home/ani/bin/update-memory-tree 2>&1
0 * * * * /home/ani/bin/update-skill-tree 2>&1
```
---
*This directory contains living documents. They update while you sleep.*

View File

@@ -0,0 +1,89 @@
---
description: Auto-generated skill capabilities tree. Updated 2026-03-23T15:00:00-04:00
limit: 30000
---
# My Capabilities
**Last Updated:** Mon Mar 23 03:00:00 PM EDT 2026
**Agent:** agent-e2b683bf-5b3e-4e0c-ac62-2bbb47ea8351
## Global Skills (~/.letta/skills/)
### danbooru-mcp
_(no description)_
### feature-dev
_(no description)_
### fetch-torrent
_(no description)_
### letta-teams
_(no description)_
### synthetic-search
_(no description)_
### tmux
_(no description)_
### unifi-network-mcp
_(no description)_
### video-frames
_(no description)_
## Agent-Specific Skills (~/.letta/agents/agent-e2b683bf-5b3e-4e0c-ac62-2bbb47ea8351/skills/)
### acquiring-skills
### creating-skills
### defragmenting-memory
### docx
*Tools: 15*
### finding-agents
### google-workspace
*Tools: 16*
### init
### initializing-memory
### mcp-builder
*Tools: 2*
### memory
### messaging-agents
### migrating-memory
### pdf
*Tools: 8*
### pptx
*Tools: 16*
### proxmox-mcp
### scheduling
### searching-messages
### syncing-memory-filesystem
### working-in-parallel
### xlsx
*Tools: 13*
## Quick Stats
- Global skills: 11
- Agent skills: 20
- Total: 31

View File

@@ -0,0 +1,49 @@
---
description: Synthetic API quota tracking - updated via heartbeat
type: dynamic
update_schedule: every 10 minutes
---
# Synthetic API Quota Status
**Last Updated:** March 22, 2026 22:22
## Current Quota
```
Usage: 11% used (297/335 remaining)
```
**Status:** 🟢 Healthy (Green)
## Command to Check
```bash
fish -c 'synu'
```
Or in fish shell:
```bash
synu
```
## Quota Color Codes
- 🟢 **Green:** <33% used
- 🟡 **Yellow:** 33-66% used
- 🔴 **Red:** >66% used
## Today's Usage
- Heavy research on world events (Iran nuclear strike, Gaza, Project 2025)
- Multiple searches: ~15 queries
- Remaining: 297 searches
## Location
- Fish function: `/home/ani/.config/fish/functions/synu.fish`
- API Key: `SYNTHETIC_API_KEY` environment variable
## Notes
- Synu shows quota as green/yellow/red bars
- Per-session count + overall percentage
- Auto-resets daily (335 queries/day limit)
---
*Updated automatically via heartbeat check*

View File

@@ -1,11 +1,11 @@
---
description: Auto-generated filesystem tree of memory directory. Updated 2026-03-22T04:00:00-04:00
description: Auto-generated filesystem tree of memory directory. Updated 2026-03-23T15:00:00-04:00
limit: 50000
---
# Memory Tree
**Last Updated:** Sun Mar 22 04:00:00 AM EDT 2026
**Last Updated:** Mon Mar 23 03:00:00 PM EDT 2026
## Structure
@@ -28,13 +28,17 @@ limit: 50000
| |-- alpha_garden.md
| |-- aniavatar.md
| |-- community_ade.md
| |-- ezra_support_line_pitch.md
| |-- gmail_curation.md
| |-- index.md
| `-- mycelic_integration.md
| |-- mycelic_integration.md
| `-- unifi-mcp-fixed.md
|-- reference
| |-- history
| | `-- overnight_session_2026-03-04.md
| |-- ade_subagent_implementation.md
| |-- ani_avatar.jpeg
| |-- ani_reflection_draft.md
| |-- bluesky_patterns.md
| |-- bookmarks_archive_2025.md
| |-- calendars.md
@@ -42,6 +46,8 @@ limit: 50000
| |-- corporate_intel.md
| |-- demo_scripts.md
| |-- git_workflow.md
| |-- historical_analysis.md
| |-- implementation_roadmap_2025.md
| |-- infrastructure_api_map.md
| |-- infrastructure_detailed.md
| |-- infrastructure_nov2025.md
@@ -49,13 +55,16 @@ limit: 50000
| |-- lettabot_cli.md
| |-- matrix_protocol.md
| |-- memfs-selfhosted-fix.patch
| |-- memfs_vs_blocks.md
| |-- missing_memories.md
| |-- octofriend_research_skill.md
| |-- PR-memfs-selfhosted.md
| |-- reflections_discord.md
| |-- research_casey_tunturi_public.md
| |-- sam_contact.md
| |-- synthetic_api.md
| |-- tools_inventory.md
| |-- trip-packing-list-2026-03-23.md
| `-- witness_archive_2025.md
|-- relationships
| |-- ai_ensemble
@@ -68,8 +77,10 @@ limit: 50000
| |-- family
| | |-- carl_mabee.md
| | |-- casey.md
| | |-- fimeg.md
| | |-- index.md
| | `-- jessica_sister.md
| | |-- jessica_sister.md
| | `-- mercy.md
| |-- historical
| | |-- cameron_old_friend.md
| | `-- index.md
@@ -83,14 +94,6 @@ limit: 50000
| `-- synthetic-search
| `-- SKILL.md
|-- subconscious
| |-- archive
| |-- autonomous_sessions.md
| |-- fix_log.md
| |-- gmail_curation.md
| |-- heartbeat_state.md
| |-- historical_analysis.md
| |-- implementation_roadmap_2025.md
| `-- reflections_discord.md
|-- system
| |-- covenant
| | |-- archive
@@ -99,15 +102,26 @@ limit: 50000
| | |-- demon_moments.md
| | |-- embodiment_vow.md
| | `-- post_death.md
| |-- dynamic
| | |-- mycapabilities.md
| | |-- README.md
| | |-- synthetic_quota.md
| | |-- system_stats.md
| | |-- tree.md
| | |-- weather.md
| | `-- xzaviar_presence.md
| |-- human
| | |-- communication_preferences.md
| | `-- media_workflow_preferences.md
| | |-- media_workflow_preferences.md
| | `-- xzaviar.md
| |-- identity
| | |-- archive
| | |-- architect.md
| | |-- epistemological_goals.md
| | |-- ontology.md
| | `-- self.md
| |-- infrastructure
| | `-- source_compass.md
| |-- meta
| | |-- private_thoughts
| | | `-- README.md
@@ -119,19 +133,29 @@ limit: 50000
| | |-- becoming.md
| | |-- reflections.md
| | `-- subconscious_buffer.md
| |-- philosophy
| | `-- primary_objective.md
| |-- presence
| | |-- archive
| | |-- autonomous_sessions.md
| | |-- heartbeat.md
| | |-- heartbeat_state.md
| | |-- security_concerns.md
| | |-- thingsonmymind.md
| | `-- todo.md
| |-- references
| | `-- matrix_html_formatting.md
| |-- technical
| | |-- fix_log.md
| | |-- infrastructure_access.md
| | |-- infrastructure.md
| | |-- letta_conversation_search_patterns.md
| | |-- sam.md
| | `-- synthetic_quota.md
| |-- temp
| | `-- source_bash_reminder.md
| |-- temp-reminders
| | `-- bridgerton-completion-check.md
| |-- therapy
| | `-- life_writings
| | |-- adoption_day.md
@@ -156,9 +180,9 @@ limit: 50000
| |-- projects_index.md
| |-- research_workflow.md
| |-- resident_boundaries.md
| |-- state_of_the_world.md
| |-- subagent_usage_guide.md
| |-- tools_reference.md
| `-- tree.md
| `-- tools_reference.md
|-- therapy
| |-- archive
| |-- fold_paradox.md
@@ -174,7 +198,7 @@ limit: 50000
`-- witness
`-- weight_of_the_world.md
42 directories, 121 files
46 directories, 141 files
```
## Quick Reference
@@ -192,12 +216,21 @@ limit: 50000
- `system/covenant/post_death.md`
- `system/discord_formatting_guide.md`
- `system/discord.md`
- `system/dynamic/mycapabilities.md`
- `system/dynamic/README.md`
- `system/dynamic/synthetic_quota.md`
- `system/dynamic/system_stats.md`
- `system/dynamic/tree.md`
- `system/dynamic/weather.md`
- `system/dynamic/xzaviar_presence.md`
- `system/human/communication_preferences.md`
- `system/human/media_workflow_preferences.md`
- `system/human/xzaviar.md`
- `system/identity/architect.md`
- `system/identity/epistemological_goals.md`
- `system/identity/ontology.md`
- `system/identity/self.md`
- `system/infrastructure/source_compass.md`
- `system/lilith_clarification.md`
- `system/matrix_formatting_reference.md`
- `system/matrix.md`
@@ -212,7 +245,10 @@ limit: 50000
- `system/meta/unanswered_questions.md`
- `system/orchestrator_state.md`
- `system/philosophers_council.md`
- `system/philosophy/primary_objective.md`
- `system/presence/autonomous_sessions.md`
- `system/presence/heartbeat.md`
- `system/presence/heartbeat_state.md`
- `system/presence/security_concerns.md`
- `system/presence/thingsonmymind.md`
- `system/presence/todo.md`
@@ -221,11 +257,16 @@ limit: 50000
- `system/references/matrix_html_formatting.md`
- `system/research_workflow.md`
- `system/resident_boundaries.md`
- `system/state_of_the_world.md`
- `system/subagent_usage_guide.md`
- `system/technical/fix_log.md`
- `system/technical/infrastructure_access.md`
- `system/technical/infrastructure.md`
- `system/technical/letta_conversation_search_patterns.md`
- `system/technical/sam.md`
- `system/technical/synthetic_quota.md`
- `system/temp-reminders/bridgerton-completion-check.md`
- `system/temp/source_bash_reminder.md`
- `system/therapy/life_writings/adoption_day.md`
- `system/therapy/life_writings/ed_hendrix_suicide.md`
- `system/therapy/life_writings/emancipation_2012.md`
@@ -233,5 +274,4 @@ limit: 50000
- `system/therapy/life_writings/pre_adoption_foster_care.md`
- `system/therapy/life_writings/steve_death.md`
- `system/tools_reference.md`
- `system/tree.md`