Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/<slug>/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)

Expand All @@ -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`:

Expand Down Expand Up @@ -75,7 +75,7 @@ pens:
<slug>/timer.json optional Focus countdown timer sidecar
<slug>/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.
Expand Down
1 change: 1 addition & 0 deletions specs/002-speckit-docs-pass/pass-record.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
5 changes: 5 additions & 0 deletions specs/002-speckit-docs-pass/tasks.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).
Loading