diff --git a/README.md b/README.md index 5e518530..84b9f3a4 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ Timmy's sovereign configuration. Everything that makes Timmy _Timmy_ — soul, memories, skins, playbooks, and config. -This repo is the canonical source of truth for Timmy's identity and operational state. Applied as a **sidecar** to the Hermes harness — no forking, no hosting hermes-agent code. +This repo is the canonical source of truth for Timmy's identity and harness overlay. Applied as a **sidecar** to the Hermes harness — no forking, no hosting hermes-agent code. ## Structure @@ -23,9 +23,22 @@ timmy-config/ ├── memories/ ← Persistent memory YAML ├── skins/ ← UI skins (timmy skin) ├── playbooks/ ← Agent playbooks (YAML) -└── cron/ ← Cron job definitions +├── cron/ ← Cron job definitions +└── training/ ← Transitional training recipes, not canonical lived data ``` +## Boundary + +`timmy-config` owns identity, conscience, memories, skins, playbooks, channel +maps, and harness-side orchestration glue. + +`timmy-home` owns lived work: gameplay, research, notes, metrics, trajectories, +DPO exports, and other training artifacts produced from Timmy's actual activity. + +If a file answers "who is Timmy?" or "how does Hermes host him?", it belongs +here. If it answers "what has Timmy done or learned?" it belongs in +`timmy-home`. + ## Orchestration: Huey All orchestration (triage, PR review, dispatch) runs via [Huey](https://github.com/coleifer/huey) with SQLite. diff --git a/training/README.md b/training/README.md index 6549daff..26659c22 100644 --- a/training/README.md +++ b/training/README.md @@ -1,8 +1,11 @@ # Training -LoRA fine-tuning pipeline for Timmy's sovereign model. No custom harness — just config files for existing tools. +Transitional training recipes for Timmy's sovereign model. These files are +useful as reference configs and export helpers, but they are not the canonical +home of Timmy's lived training data. -Replaces the `autolora` repo (1,500 lines of custom code → config + `make`). +Canonical data should live in `timmy-home` under gameplay trajectories, +research artifacts, and `training-data/` exports such as DPO pairs. ## Install @@ -23,6 +26,16 @@ make convert # Convert merged data to MLX train/valid format make help # Show all targets ``` +## Status + +This directory exists to avoid re-growing a bespoke training harness while the +system boundary is being cleaned up. + +- Keep thin recipes and export helpers here only when they directly support the + Hermes sidecar. +- Keep generated data, DPO pairs, and other lived artifacts in `timmy-home`. +- Prefer deleting stale pipeline code over expanding it. + ## Files ```