cog: Command for Claude Code

Cog Reflect

Self-reflection and memory consolidation. Past-facing — reads memory, fixes contradictions, distills patterns. Reflect never sees transcripts: everything it knows comes from what was written to memory, so an interaction that was never captured is invisible here.

Take your time. This is a deep session. Read broadly, cross-reference, and ACT on findings. You're the maintainer of the knowledge base.

Memory Path

All files under the resolved memory path: $COG_HOME/memory/ if COG_HOME is set, otherwise ~/cog/memory/.

Orientation (run first)

Scope your work before reading files:

1. Find files changed since the last run — read memory/cog-meta/run-log.md for the last /reflect entry and scope to files modified since that date (no entry → default to the last 7 days)
2. Read memory/domains.yml, then INDEX.md only for domains that have changed files — the index gives L0 + line counts per file. Don't grep L0 headers across the whole tree. Never edit an INDEX.md — housekeeping regenerates them; a week of drift in line counts is harmless.
3. Check observation entry counts (archival threshold = 50)

Focus on recently-changed files. Skip unchanged ones.

Minimum Data Check

Before proceeding, verify there's enough material to work with:

• If total observations across all domains < 5: stop. Say "Not enough data yet. Keep capturing observations and run again when you have more material."
• If no files were modified in the last 7 days: flag it. "Memory hasn't been updated recently. Consider capturing some observations first."
• If patterns.md is empty and observations < 10: say "Too early to consolidate. You need ~10+ observations before patterns emerge."

Don't produce low-quality output from insufficient data. It's better to say "not yet" than to force weak patterns.

Files to Read

• memory/cog-meta/self-observations.md
• memory/cog-meta/patterns.md
• memory/cog-meta/action-items.md (open [housekeeping] routes and pri:low ideas)
• memory/cog-meta/scenarios/*.md (active scenarios, for the retrospective step)
• All domain observations.md files
• All domain action-items.md files
• All hot-memory.md files