docs: add efficiency-levers setup and current-run instructions
- PROJECT_STATE.md: section on three deployed levers (FK annotations, context-pack, recap v2) with setup instructions for new workspaces; psd pre-configured - README.md: one-time setup for workspace (tht schema suggest-fks); note that levers 2+3 auto-activate - Updated 'How to run' with explicit command and prereq checklist - Last-updated timestamp: 2026-07-08 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -65,6 +65,27 @@ tht lsh build -c /path/to/tht-workspace-<customer>/<customer>.yaml
|
||||
tht session new -c /path/to/tht-workspace-<customer>/<customer>.yaml
|
||||
```
|
||||
|
||||
## Efficiency levers setup (one-time per workspace)
|
||||
|
||||
To enable the three deployed optimization levers on a **new workspace**:
|
||||
|
||||
```bash
|
||||
# Lever 1: Foreign key suggestions from approved SQL + heuristics.
|
||||
# Run once after schema introspection to populate annotations.yaml.
|
||||
tht schema suggest-fks \
|
||||
--from-sql /path/to/customer/sessions \
|
||||
--assume cod_paz=dim_patient \
|
||||
-c /path/to/customer/workspace.yaml \
|
||||
--write
|
||||
|
||||
# (psd workspace: 228 FK suggestions already generated via this command 2026-07-08)
|
||||
|
||||
# Levers 2 + 3: automatic at next session (context-pack + recap from ledger).
|
||||
# No setup needed — SKILL.md prescribes them automatically.
|
||||
```
|
||||
|
||||
See `PROJECT_STATE.md` for what each lever does.
|
||||
|
||||
## The workflow
|
||||
|
||||
`workflow.yaml` is the **single source of workflow truth** (spec F2). Eight phases
|
||||
|
||||
Reference in New Issue
Block a user