From e01ea6633e30bb0b8f17f534f0f2f1366aef7178 Mon Sep 17 00:00:00 2001 From: archae0pteryx Date: Sat, 17 Oct 2026 10:37:27 -0700 Subject: [PATCH] Align the user guide with settled Task and Limit terminology --- README.md | 10 +++++----- specs/002-speckit-docs-pass/pass-record.md | 1 + specs/002-speckit-docs-pass/tasks.md | 5 +++++ 3 files changed, 11 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 5b418e9..4ca52b6 100644 --- a/README.md +++ b/README.md @@ -22,11 +22,11 @@ See `specs/003-ranch-today/spec.md` for what the ranch does today, `CONTEXT.md` 1. Open the tray menu. Click **+ New Focus** and give it a title, an optional description, and an optional timer. 2. A pig appears for each Focus and wanders on the overlay. -3. Click a pig to open its detail card. Rename, duplicate, or delete the Focus; add, edit, check off, or clear Tasks. -4. Click the clock/time control on the Focus title or on any Task to start, restart, or clear a timer. Focus timers also drive animal growth and expired-focus alerts. +3. Click a pig to open its detail card. Rename, duplicate, or delete the Focus; add, edit, Complete, or Delete Tasks. +4. Click the clock/time control on the Focus title or on any Task to start, restart, or Clear a Timer. Focus timers also drive animal growth and expired-focus alerts. 5. Drag a pig to move it; release to toss it. Tray → **Gather Pigs** pulls every pig back onto the primary display. 6. Hand-edit `~/.adhd-ranch/focuses//focus.md` whenever you want — the watcher reflects changes within a second. Adding `- [ ] something` adds a task, `- [x]` marks it done, deleting a line removes it. -7. Tray → **Settings…** opens Preferences: caps, always-on-top, delete confirmation, enabled displays, and notification toggles. +7. Tray → **Settings…** opens Preferences: Limits, always-on-top, delete confirmation, enabled displays, and notification toggles. ### Claude Code animals (optional, macOS/Linux) @@ -40,7 +40,7 @@ Follow Claude's reload prompt if an already-open session has not activated the p ## Limits + alerts -Default caps: **5 Focuses**, **7 Tasks per Focus**. Going over still works (your markdown wins), but the tray icon turns red and the app sends a one-shot system notification per `under → over` transition. +Default Limits: **5 Focuses**, **7 Tasks per Focus**. Going Over Limit still saves your markdown, but the tray icon turns red and the app sends one system notification when the ranch becomes Over Limit. Override defaults in `~/.adhd-ranch/settings.yaml`: @@ -75,7 +75,7 @@ pens: /timer.json optional Focus countdown timer sidecar /task-timers.json optional Task countdown timer sidecar, indexed to task order - settings.yaml optional caps + notification/widget/display config + settings.yaml optional Limits + notification/widget/display config ``` The app makes no network calls and exposes no network API. The UI talks to Rust through Tauri IPC. diff --git a/specs/002-speckit-docs-pass/pass-record.md b/specs/002-speckit-docs-pass/pass-record.md index 68d4c49..b031902 100644 --- a/specs/002-speckit-docs-pass/pass-record.md +++ b/specs/002-speckit-docs-pass/pass-record.md @@ -60,6 +60,7 @@ - `CONTEXT.md`: the banner said the language was under review. The entries are settled. Higher authority: the glossary entries and ADR-0001. - `CHANGELOG.md` `[0.1.4]`: the entry says hook install writes Claude's `settings.json` and that a dead session has nothing to go stale. Left in place. It is the note for that release, not a current requirement. Current behavior is FR-014 and FR-015 in `specs/003-ranch-today/spec.md`. - `CLAUDE.md`: no sentence contradicted the current specification. No edit. +- `README.md` (T029): corrected Task actions to Complete/Delete, reserved Clear for Timers, and replaced caps with Limit/Over Limit in prose while preserving settings keys and actual menu labels. Higher authority: `CONTEXT.md` (Complete, Delete, Clear, Limit, Over Limit); current description: `specs/003-ranch-today/spec.md` FR-002 and FR-007. ## Unresolved diff --git a/specs/002-speckit-docs-pass/tasks.md b/specs/002-speckit-docs-pass/tasks.md index cbfc2b2..05edf97 100644 --- a/specs/002-speckit-docs-pass/tasks.md +++ b/specs/002-speckit-docs-pass/tasks.md @@ -198,3 +198,8 @@ One implementer should finish the stories in order P1, then P2, then P3. The par - Do not edit `specs/001-render-domain-seam/**` - Leave `specs/003-ranch-today/spec.md` at status Draft - Commit after each phase checkpoint + + +## Phase 7: Convergence + +- [X] T029 Correct the remaining user-guide terminology in `README.md`: use Complete/Delete for Task actions, reserve Clear for Timers, and use Limit/Over Limit in prose while preserving literal settings keys and actual menu labels. Record the settlement against `CONTEXT.md` and `specs/003-ranch-today/spec.md` in `specs/002-speckit-docs-pass/pass-record.md` per FR-010 and US3/AC3 (partial).