diff --git a/AGENTS.md b/AGENTS.md index 69651022d..b04eab9ed 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -58,6 +58,7 @@ Invoke them by name (e.g., `/office-hours`). |-------|-------------| | `/context-save` | Save working context (git state, decisions, remaining work). | | `/context-restore` | Resume from a saved context, even across Conductor workspaces. | +| `/handoff` | Hand a task off to another agentic harness, or claim one. Emits one `[handoff]` block into Plane + context-save + gbrain; pointer-based, token-optimized. | | `/learn` | Manage what gstack learned across sessions. | | `/retro` | Weekly retro with per-person breakdowns and shipping streaks. | | `/health` | Code quality dashboard (type checker, linter, tests, dead code). | diff --git a/docs/skills.md b/docs/skills.md index 8e8cb7adc..a5f456e35 100644 --- a/docs/skills.md +++ b/docs/skills.md @@ -37,6 +37,7 @@ Detailed guides for every gstack skill — philosophy, workflow, and examples. | [`/learn`](#learn) | **Memory** | Manage what gstack learned across sessions. Review, search, prune, and export project-specific patterns and preferences. | | [`/context-save`](#context-save) | **Save State** | Save working context (git state, decisions, remaining work) so any future session can resume. | | [`/context-restore`](#context-restore) | **Restore State** | Resume from a saved context, even across Conductor workspace handoffs. | +| [`/handoff`](#handoff) | **Relay Handoff** | Hand a task off to another agentic harness, or claim one that was handed off. One `[handoff]` block into Plane + context-save + gbrain; pointer-based, token-optimized. | | [`/health`](#health) | **Code Quality Dashboard** | Wraps type checker, linter, tests, dead code detection. Computes a weighted 0-10 score; tracks trends over time. | | [`/landing-report`](#landing-report) | **Ship Queue Dashboard** | Read-only snapshot of the workspace-aware ship queue. Which version slots are claimed, which sibling workspaces have WIP. | | [`/benchmark-models`](#benchmark-models) | **Model Benchmark** | Side-by-side cross-model benchmark for skills (Claude vs GPT vs Gemini). Latency, tokens, cost, optional LLM-judged quality. | diff --git a/gstack/llms.txt b/gstack/llms.txt index efe522f90..9b57e060f 100644 --- a/gstack/llms.txt +++ b/gstack/llms.txt @@ -33,6 +33,7 @@ Conventions: - [/gstack](gstack/SKILL.md): Router for the gstack skill suite. - [/gstack-upgrade](gstack-upgrade/SKILL.md): Upgrade gstack to the latest version. - [/guard](guard/SKILL.md): Full safety mode: destructive command warnings + directory-scoped edits. +- [/handoff](handoff/SKILL.md): Hand a task off to another agentic harness, or claim one that was handed off. - [/health](health/SKILL.md): Code quality dashboard. - [/investigate](investigate/SKILL.md): Systematic debugging with root cause investigation. - [/ios-clean](ios-clean/SKILL.md): Remove the DebugBridge SPM package and all #if DEBUG wiring from an iOS app. diff --git a/scripts/proactive-suggestions.json b/scripts/proactive-suggestions.json index d08c60853..759fa0df5 100644 --- a/scripts/proactive-suggestions.json +++ b/scripts/proactive-suggestions.json @@ -113,6 +113,11 @@ "routing": "Combines /careful (warns before rm -rf, DROP TABLE, force-push, etc.) with\n/freeze (blocks edits outside a specified directory). Use for maximum safety\nwhen touching prod or debugging live systems. Use when asked to \"guard mode\",\n\"full safety\", \"lock it down\", or \"maximum safety\".", "voice_line": null }, + "handoff": { + "lead": "Hand a task off to another agentic harness, or claim one that was handed off.", + "routing": "Emits one canonical [handoff] block into three sinks (Plane comment, context-save\nNotes, gbrain page) so any harness — Claude Code, Codex, Hermes, Antigravity — can\nresume without re-ingesting a transcript. Token-optimized: pointer-based handoff,\nnot context dump. Use when asked to \"hand off\", \"release this task\", \"claim a\nhandoff\", or \"pick up a handed-off task\".", + "voice_line": null + }, "health": { "lead": "Code quality dashboard.", "routing": "Wraps existing project tools (type checker, linter,\ntest runner, dead code detector, shell linter), computes a weighted composite\n0-10 score, and tracks trends over time. Use when: \"health check\",\n\"code quality\", \"how healthy is the codebase\", \"run all checks\",\n\"quality score\".",