timmy-home/docs/QUICK_REFERENCE.md

# Timmy Workflow Quick Reference

Updated: April 4, 2026

## What Lives Where

- `~/.timmy`: Timmy's workspace, lived data, heartbeat, archive artifacts
- `~/.timmy/timmy-config`: Timmy's identity and orchestration sidecar repo
- `~/.hermes`: Hermes harness, sessions, config overlay, helper scripts

## Most Useful Commands

### Workflow Status

```bash
~/.hermes/bin/ops-panel.sh
~/.hermes/bin/ops-gitea.sh
~/.hermes/bin/timmy-dashboard
```

### Workflow Helpers

```bash
source ~/.hermes/bin/ops-helpers.sh
ops-help
ops-review-queue
ops-unassigned all
ops-queue codex-agent all
```

### Pipeline Freshness

```bash
~/.hermes/bin/pipeline-freshness.sh
```

### Archive Pipeline

```bash
python3 - <<'PY'
import json, sys
sys.path.insert(0, '/Users/apayne/.timmy/timmy-config')
from tasks import _archive_pipeline_health_impl
print(json.dumps(_archive_pipeline_health_impl(), indent=2))
PY
```

```bash
python3 - <<'PY'
import json, sys
sys.path.insert(0, '/Users/apayne/.timmy/timmy-config')
from tasks import _know_thy_father_impl
print(json.dumps(_know_thy_father_impl(), indent=2))
PY
```

### Manual Dispatch Prompt

```bash
~/.hermes/bin/agent-dispatch.sh groq 542 Timmy_Foundation/the-nexus
```

## Best Files to Check

### Operational State

- `~/.timmy/heartbeat/last_tick.json`
- `~/.hermes/model_health.json`
- `~/.timmy/twitter-archive/checkpoint.json`
- `~/.timmy/twitter-archive/metrics/progress.json`

### Archive Feedback

- `~/.timmy/twitter-archive/notes/`
- `~/.timmy/twitter-archive/knowledge/profile.json`
- `~/.timmy/twitter-archive/training/dpo/`

### Review and Queue

- Gitea PR queue
- Gitea unassigned issues
- Timmy/Allegro assigned review queue

## Rules of Thumb

- If it changes identity or orchestration, review it carefully in `timmy-config`.
- If it changes lived outputs or training inputs, it probably belongs in `timmy-home`.
- If it only “sounds right” but is not proven by runtime state, it is not verified.
- If a change is major, package it as a PR for Timmy review.