hive-mind-agent 1.0.0

package/scripts/install-skill.mjs

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+/**
+ * Install hive-mind-orchestrator skill to ~/.cursor/skills/
+ * Run: npm run skill:install
+ */
+
+import { mkdir, readdir, readFile, writeFile } from 'fs/promises';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, '..');
+const SKILL_SOURCE = join(ROOT, 'skill');
+const SKILL_DEST = join(process.env.HOME || process.env.USERPROFILE, '.cursor', 'skills', 'hive-mind-orchestrator');
+
+const FILES = ['SKILL.md', 'reference.md', 'CONTEXT_TEMPLATE.md'];
+
+async function install() {
+  try {
+    await readdir(SKILL_SOURCE);
+  } catch (e) {
+    console.error('Skill source not found at', SKILL_SOURCE);
+    process.exit(1);
+  }
+
+  await mkdir(SKILL_DEST, { recursive: true });
+  for (const f of FILES) {
+    const src = join(SKILL_SOURCE, f);
+    try {
+      const content = await readFile(src, 'utf-8');
+      await writeFile(join(SKILL_DEST, f), content);
+      console.log('  Installed', f);
+    } catch (e) {
+      if (e.code === 'ENOENT') console.log('  Skipped (missing)', f);
+      else throw e;
+    }
+  }
+  console.log('\nSkill installed to', SKILL_DEST);
+  console.log('Restart Cursor or reload the window for the skill to be discovered.');
+}
+
+install().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});

package/skill/CONTEXT_TEMPLATE.md

@@ -0,0 +1,28 @@
+# Hive Context
+
+## Goals
+
+- **Primary:** [Describe the main objective for this hive]
+- **Target product:** [Product/project name and path]
+- [Optional supporting goals]
+
+## Strategy
+
+[Current approach: what the central brain has decided to do next]
+
+## Pending Tasks
+
+| ID | Description | Assigned | Status |
+|----|-------------|----------|--------|
+| 1  | [Task 1]    | -        | pending |
+| 2  | [Task 2]    | -        | pending |
+
+## Recent Outcomes (last 10)
+
+| Date       | Task   | Status  | Result   |
+| ---------- | ------ | ------- | -------- |
+| YYYY-MM-DD | [Task] | success | [Summary] |
+
+## Learnings
+
+- [What the hive has learned from outcomes]

package/skill/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: hive-mind-orchestrator
+description: Orchestrates multi-agent hive workflows. Use when user says "unleash the hive", "advance the hive", "hive cycle", or wants autonomous parallel task execution across multiple agents. Works with any project—targets come from hive.config.json.
+---
+
+# Hive-Mind Orchestrator
+
+Orchestrate parallel subagent workflows. Project-agnostic, model-agnostic, platform-agnostic.
+
+## When to Use
+
+- User says "unleash the hive", "advance the hive", "hive cycle", "run the hive"
+- User wants autonomous parallel task execution across multiple agents
+- User wants a central brain that assigns tasks and ingests outcomes
+- Any project with `hive.config.json` or `context.md` + `outcomes/`
+
+## Quick Start
+
+1. **Locate config** — Look for `hive.config.json` or `.hive/config.json` in workspace root
+2. **Read context** — Use `contextPath` from config (default `context.md`)
+3. **Decide tasks** — Pick 2–3 independent tasks that advance goals
+4. **Launch workers** — Call `mcp_task` for each (in parallel when independent)
+5. **Ingest outcomes** — Update context with results; add to Recent Outcomes, Learnings
+
+## Config (hive.config.json)
+
+If present, use:
+- `contextPath` — shared state file (default `context.md`)
+- `outcomesPath` — worker outputs (default `outcomes`)
+- `targetProducts` — products/projects to operate on
+- `maxParallelTasks` — max parallel subagents (default 3)
+
+## Task Assignment
+
+When invoking `mcp_task`:
+- **description** — 3–5 word summary
+- **prompt** — Full instructions: what to do, relevant context from context.md, expected outcome
+- **subagent_type** — `explore` | `shell` | `generalPurpose` (plus role in prompt for enterprise types)
+
+For enterprise roles (implementer, architect, evangelist, etc.), use `generalPurpose` and pass the role in the prompt; MCP has fixed enum.
+
+## Outcome Ingestion
+
+- Add row to Recent Outcomes (Date, Task, Status, Result)
+- Add learnings to Learnings section
+- Remove completed tasks from Pending Tasks
+
+## Shared State
+
+- **Context** — Central brain reads and writes; workers do not
+- **Outcomes** — Workers write; central brain reads to ingest
+
+See [reference.md](reference.md) for full format and worker contract.

package/skill/reference.md

@@ -0,0 +1,66 @@
+# Hive-Mind Reference
+
+## Context Format (context.md)
+
+```markdown
+# Hive Context
+
+## Goals
+- [Objective 1]
+- [Objective 2]
+
+## Strategy
+[Current approach]
+
+## Pending Tasks
+| ID | Description | Assigned | Status |
+|----|-------------|----------|--------|
+| 1  | [Task]      | -        | pending |
+
+## Recent Outcomes (last 10)
+| Date | Task | Status | Result |
+|------|------|--------|--------|
+| 2024-01-15 | [Brief] | success | [Summary] |
+
+## Learnings
+- [Learning 1]
+```
+
+## Outcome Format (outcomes/YYYY-MM-DD-slug.md)
+
+```markdown
+# Outcome: [Task description]
+
+**Status:** success | partial | blocked | failed
+
+## Result
+[Summary]
+
+## Artifacts
+- path/to/file
+
+## Suggested Follow-ups
+- [Optional next task]
+```
+
+## Config Schema (hive.config.json)
+
+```json
+{
+  "targetProducts": [{"name": "...", "path": "...", "description": "..."}],
+  "workspaceRoots": ["/path/to/hive", "/path/to/product"],
+  "contextPath": "context.md",
+  "outcomesPath": "outcomes",
+  "maxParallelTasks": 3
+}
+```
+
+## Subagent Types
+
+| Type | Use when |
+|------|----------|
+| `explore` | Codebase search, finding patterns |
+| `shell` | Commands, terminal operations |
+| `generalPurpose` | Research, complex tasks, enterprise roles (pass role in prompt) |
+
+Enterprise roles: architect, implementer, reviewer, deployer, researcher, evangelist, launchSpecialist, etc. — use `generalPurpose` + role in prompt.