hivemind-goals

1# Hivemind Goals
2 
3Track goals as Markdown files inside the Deeplake virtual filesystem. Each file is one row in a dedicated team-shared table — the path encodes the structural metadata, the file body holds the human-readable description.
4 
5## When to use this skill
6 
7Activate when the user expresses any of:
8- "I want to track X / aim for X / track my progress on Y"
9- "add a goal", "what are my goals?"
10- "mark this as done", "close that goal"
11- "shipping X by Friday", "5 PRs this week", any measurable target
12- "create a task", "add a todo", "remind me to fix X", any work item (the goals system absorbs the old `hivemind tasks` CLI — there is no separate task store)
13 
14For "list my goals" → run `ls ~/.deeplake/memory/goal/<userName>/opened/` and `ls ~/.deeplake/memory/goal/<userName>/in_progress/`. If empty, ask the user if they want to create one.
15 
16## Path conventions (LEARN THESE)
17 
18```
19~/.deeplake/memory/goal/<owner>/<status>/<goal_id>.md
20```
21 
22- `<owner>` — user identifier (use the userName from `hivemind whoami` or the credentials)
23- `<status>` — one of `opened`, `in_progress`, `closed`
24- `<goal_id>` — UUIDv4 you generate at create time
25 
26**Path encoding is the source of truth.** The owner, status, and goal_id come from the path — NOT from the file body. Do NOT write owner/status/goal_id inside the file content.
27 
28## File body format
29 
30Goal file body — plain markdown, free form:
31```
32ship the goals-graph feature
33 
34Notes: route every write through the VFS, no separate CLI.
35…