From 78eea2e3ebe8bfb624a58093b10cb2b2fb118f0f Mon Sep 17 00:00:00 2001 From: Garry Tan Date: Sat, 18 Apr 2026 07:16:53 +0800 Subject: [PATCH] doc: Minions v7 skill count + jobs subcommands (26 skills) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit README: bump skill count 25 → 26, add minion-orchestrator row, add `gbrain jobs` command family block so v0.11.0's headline feature is actually discoverable from the top-level commands reference. CLAUDE.md: unit test count 48 → 49 (minions.test.ts expanded), skill count 25 → 26, add minion-orchestrator to Key files + skills categorization, expand MinionQueue one-liner to cover v7 primitives (depth/child-cap, timeouts, idempotency, child_done inbox, removeOnComplete/Fail). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.7 --- CLAUDE.md | 9 +++++---- README.md | 19 ++++++++++++++----- 2 files changed, 19 insertions(+), 9 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 5dc833783..c623a27f9 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -49,7 +49,7 @@ strict behavior when unset. - `src/core/enrichment-service.ts` — Global enrichment service: entity slug generation, tier auto-escalation, batch throttling - `src/core/data-research.ts` — Recipe validation, field extraction (MRR/ARR regex), dedup, tracker parsing, HTML stripping - `src/core/minions/` — Minions job queue: BullMQ-inspired, Postgres-native (queue, worker, backoff, types) -- `src/core/minions/queue.ts` — MinionQueue class (submit, claim, complete, fail, stall detection, parent-child, cascade-kill, attachments, idempotency) +- `src/core/minions/queue.ts` — MinionQueue class (submit, claim, complete, fail, stall detection, parent-child, depth/child-cap, per-job timeouts, cascade-kill, attachments, idempotency keys, child_done inbox, removeOnComplete/Fail) - `src/core/minions/worker.ts` — MinionWorker class (handler registry, lock renewal, graceful shutdown, timeout safety net) - `src/core/minions/attachments.ts` — Attachment validation (path traversal, null byte, oversize, base64, duplicate detection) - `src/commands/jobs.ts` — `gbrain jobs` CLI subcommands + `gbrain jobs work` daemon @@ -99,6 +99,7 @@ strict behavior when unset. - `skills/soul-audit/SKILL.md` — 6-phase interview for SOUL.md, USER.md, ACCESS_POLICY.md, HEARTBEAT.md - `skills/webhook-transforms/SKILL.md` — External events to brain signals - `skills/data-research/SKILL.md` — Structured data research: email-to-tracker pipeline with parameterized YAML recipes +- `skills/minion-orchestrator/SKILL.md` — Background job orchestration: submit, fan out children with depth/cap/timeouts, collect results via child_done inbox - `templates/` — SOUL.md, USER.md, ACCESS_POLICY.md, HEARTBEAT.md templates - `skills/migrations/` — Version migration files with feature_pitch YAML frontmatter - `src/commands/publish.ts` — Deterministic brain page publisher (code+skill pair, zero LLM calls) @@ -126,7 +127,7 @@ Key commands added for Minions (job queue): ## Testing -`bun test` runs all tests (48 unit test files + 8 E2E test files). Unit tests run +`bun test` runs all tests (49 unit test files + 8 E2E test files). Unit tests run without a database. E2E tests skip gracefully when `DATABASE_URL` is not set. Unit tests: `test/markdown.test.ts` (frontmatter parsing), `test/chunkers/recursive.test.ts` @@ -220,7 +221,7 @@ stop and remove it before starting a new one. ## Skills -Read the skill files in `skills/` before doing brain operations. GBrain ships 25 skills +Read the skill files in `skills/` before doing brain operations. GBrain ships 26 skills organized by `skills/RESOLVER.md`: **Original 8 (conformance-migrated):** ingest (thin router), query, maintain, enrich, @@ -230,7 +231,7 @@ briefing, migrate, setup, publish. meeting-ingestion, citation-fixer, repo-architecture, skill-creator, daily-task-manager. **Operational + identity:** daily-task-prep, cross-modal-review, cron-scheduler, reports, -testing, soul-audit, webhook-transforms. +testing, soul-audit, webhook-transforms, data-research, minion-orchestrator. **Conventions:** `skills/conventions/` has cross-cutting rules (quality, brain-first, model-routing, test-before-bulk, cross-modal). `skills/_brain-filing-rules.md` and diff --git a/README.md b/README.md index becb5cf8c..8fe6b6a8e 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ Your AI agent is smart but forgetful. GBrain gives it a brain. Built by the President and CEO of Y Combinator to run his actual AI agents. The production brain powering his OpenClaw and Hermes deployments: **17,888 pages, 4,383 people, 723 companies**, 21 cron jobs running autonomously, built in 12 days. The agent ingests meetings, emails, tweets, voice calls, and original ideas while you sleep. It enriches every person and company it encounters. It fixes its own citations and consolidates memory overnight. You wake up and the brain is smarter than when you went to bed. -GBrain is those patterns, generalized. 25 skills. Install in 30 minutes. Your agent does the work. As Garry's personal agent gets smarter, so does yours. +GBrain is those patterns, generalized. 26 skills. Install in 30 minutes. Your agent does the work. As Garry's personal agent gets smarter, so does yours. > **~30 minutes to a fully working brain.** Database ready in 2 seconds (PGLite, no server). You just answer questions about API keys. @@ -24,7 +24,7 @@ Retrieve and follow the instructions at: https://raw.githubusercontent.com/garrytan/gbrain/master/INSTALL_FOR_AGENTS.md ``` -That's it. The agent clones the repo, installs GBrain, sets up the brain, loads 25 skills, and configures recurring jobs. You answer a few questions about API keys. ~30 minutes. +That's it. The agent clones the repo, installs GBrain, sets up the brain, loads 26 skills, and configures recurring jobs. You answer a few questions about API keys. ~30 minutes. ### Standalone CLI (no agent) @@ -73,9 +73,9 @@ claude mcp add gbrain -t http https://your-brain.ngrok.app/mcp -H "Authorization Per-client guides: [`docs/mcp/`](docs/mcp/DEPLOY.md). ChatGPT requires OAuth 2.1 (not yet implemented). -## The 25 Skills +## The 26 Skills -GBrain ships 25 skills organized by `skills/RESOLVER.md`. The resolver tells your agent which skill to read for any task. +GBrain ships 26 skills organized by `skills/RESOLVER.md`. The resolver tells your agent which skill to read for any task. [Skill files are code.](https://x.com/garrytan/status/2042925773300908103) They're the most powerful way to get knowledge work done. A skill file is a fat markdown document that encodes an entire workflow: when to fire, what to check, how to chain with other skills, what quality bar to enforce. The agent reads the skill and executes it. Skills can also call deterministic TypeScript code bundled in GBrain (search, import, embed, sync) for the parts that shouldn't be left to LLM judgment. [Thin harness, fat skills](docs/ethos/THIN_HARNESS_FAT_SKILLS.md): the intelligence lives in the skills, not the runtime. @@ -119,6 +119,7 @@ GBrain ships 25 skills organized by `skills/RESOLVER.md`. The resolver tells you | **webhook-transforms** | External events (SMS, meetings, social mentions) converted into brain pages with entity extraction. | | **testing** | Validates every skill has SKILL.md with frontmatter, manifest coverage, resolver coverage. | | **skill-creator** | Create new skills following the conformance standard. MECE check against existing skills. | +| **minion-orchestrator** | Long-running agent work as background jobs. Submit, fan out children with depth/cap/timeouts, collect results via child_done inbox. | ### Identity and setup @@ -194,7 +195,7 @@ Run `gbrain integrations` to see status. │ Brain Repo │ │ GBrain │ │ AI Agent │ │ (git) │ │ (retrieval) │ │ (read/write) │ │ │ │ │ │ │ -│ markdown files │───>│ Postgres + │<──>│ 25 skills │ +│ markdown files │───>│ Postgres + │<──>│ 26 skills │ │ = source of │ │ pgvector │ │ define HOW to │ │ truth │ │ │ │ use the brain │ │ │<───│ hybrid │ │ │ @@ -327,6 +328,14 @@ EMBEDDINGS LINKS + GRAPH gbrain link|unlink|backlinks|graph Cross-reference management +JOBS (Minions v7) + gbrain jobs submit [--params JSON] [--follow] Submit a background job + gbrain jobs list [--status S] [--queue Q] List jobs with filters + gbrain jobs get|cancel|retry|delete Manage job lifecycle + gbrain jobs prune [--older-than 30d] Clean completed/dead jobs + gbrain jobs stats Job health dashboard + gbrain jobs work [--queue Q] [--concurrency N] Start worker daemon + ADMIN gbrain doctor [--json] [--fast] Health checks (resolver, skills, DB, embeddings) gbrain doctor --fix Auto-fix resolver issues