Hivemind goals

--- name: hivemind-goals description: Create, track, and update team goals and KPIs via the Deeplake virtual filesystem at memory/goal/ and memory/kpi/. Use whenever the user mentions a goal, objective, KPI, target, milestone, or asks to track progress on something measurable. ALSO use when the user says “task,” “todo,” “work item,” “remind me to,” “fix X,” or any actionable work item:the goal system has replaced the legacy hivemind tasks CLI and now covers both objectives and tasks. allowed-tools: Read Bash --- # Hivemind Goals Track goals and KPIs as Markdown files within the Deeplake virtual filesystem. Each file is one row in a dedicated, team-shared table:the path encodes the structural metadata, and the file body contains the human-readable description. ## When to use thisskill Activate when the user expresses any of the following: - "I want to track X / aim for X / track my progress on Y" - "add a goal", "add a KPI", "what are my goals?" - "mark this as done", "close that goal" - “Ship X by Friday,” “5 PRs this week,” any measurable target - “Create a task,” “Add a to-do,” “Remind me to fix X,” any work item (the goals system replaces the old hivemind tasks CLI : there is no separate task store) For "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. ## Path conventions (LEARN THESE) `` ~/.deeplake/memory/goal/<owner>/<status>/<goal_id>.md ~/.deeplake/memory/kpi/<goal_id>/<kpi_id>.md ` - <owner> : user identifier (use the userName from hivemind whoami or the credentials) - <status> : one of opened , in_progress, closed - <goal_id> : UUIDv4 you generate at create time - <kpi_id> : short slug like k-prs or k-demos **Path encoding is the source of truth.** The owner, status, goal_id, and kpi_id come from the path : NOT from the file body. Do NOT write owner/status/goal_id/kpi_id inside the file content. ## File body format Goal file body : plain markdown, free form: ` ship the goals-graph feature Notes: focus on KPI tracking via VFS, no separate CLI. Due: 2026-05-30. ` KPI file body : markdown with a few mandatory key:value lines so the commit-driven auto-progress worker can parse and bump: ` PRs merged - target: 5 - current: 2 - unit: count ` The target: , current: , unit: lines must stay on a single line each. The first line is the human-readable name. Anything else is free notes. ## Operations ### 1. Create a new goal When the user expresses a new goal: 1. Get the current owner with hivemind whoami (use the userName, e.g. emanuele.fenocchi ). 2. Generate a UUIDv4: uuidgen (do NOT use node -e : Node is not available under the VFS path). 3. Write the goal file via **Bash** (Write / Edit are denied on memory paths; only Bash is intercepted and routed to SQL): `bash cat > ~/.deeplake/memory/goal/<owner>/opened/<uuid>.md <<'EOF' <goal description here, multiple lines OK> EOF ` For a single-line goal, echo '<text>' > ~/.deeplake/memory/goal /<owner>/opened /<uuid>.md is equivalent. 4. Respond to the user that the goal is created. **Do NOT auto-generate KPIs.** A goal is created with zero KPI files by default. Generate KPIs ONLY when the user explicitly asks you to ("aggiungi KPI per …", "add metrics for this goal", "track these metrics: …"). When the user asks, write each KPI as a separate file at ~/.deeplake/memory/kpi /<goal_id>/<kpi-slug>.md with the body format documented above. ### 1a. Capture a task for later (with resumable context) Use this when the user **parks a tangential task** mid-session : "save this for later", "remind me to …", "don't let me forget …", "let's do X later", "capture this in Hivemind". The value is NOT the one-liner : it's storing enough **context to resume cold** in a future session without the user re-explaining anything. Write it via the **CLI** (not the VFS heredoc) so the row is tagged agent: capture , which separates parked side-tasks from hand-made goals: ``bash hivemind goal add --agent capture "Add rate-limiting to the webhook handler Start here: add a per-IP token bucket to the handler