monomind 1.19.0 → 2.0.0

package/.claude/commands/mastermind/memory.md

@@ -1,227 +0,0 @@
-<!-- LanceDB memory system — store, search, retrieve, list, delete, and manage cross-session persistent memory with vector embeddings -->
-
-# Monomind Memory System
-
-Persistent memory backed by LanceDB with pure-JS HNSW vector indexing for semantic search (O(log n) approximate nearest neighbor). Supports cross-session and cross-agent collaboration.
-
-## Subcommands
-
-| Subcommand | Alias | Description |
-|---|---|---|
-| `init` | — | Initialize memory database (sql.js + LanceDB) |
-| `store` | — | Store a key/value entry |
-| `edit` | — | Edit an existing entry |
-| `retrieve` | `get` | Retrieve entry by key |
-| `search` | — | Semantic/vector search |
-| `list` | `ls` | List memory entries |
-| `delete` | `rm` | Delete an entry |
-| `templates` | — | Show best-practice entry templates |
-| `stats` | — | Show memory statistics |
-| `configure` | `config` | Configure memory backend |
-| `cleanup` | — | Clean expired/stale entries |
-| `compress` | — | Compress and optimize storage |
-| `export` | — | Export memory to file |
-| `import` | — | Import memory from file |
-
-## init — Initialize Database
-
-```bash
-npx monomind memory init
-npx monomind memory init --backend lancedb --verbose --verify
-npx monomind memory init --force  # Overwrite existing
-```
-
-**Flags:** `--backend hybrid|sqlite|lancedb` (default: `hybrid`), `--path`, `--force`, `--verbose`, `--verify` (default: true), `--load-embeddings`
-
-## store — Store Data
-
-```bash
-# Store with specific namespace
-npx monomind memory store --key "arch/api-design" --value "RESTful microservices" --namespace arch
-
-# With tags and TTL
-npx monomind memory store --key "pattern/auth" --value "JWT + refresh tokens" --namespace patterns --tags "auth,security" --ttl 86400
-
-# Upsert (update if exists)
-npx monomind memory store --key "bug/null-check" --value "Fixed null check in parser" --upsert
-```
-
-**Flags:**
-
-| Flag | Short | Default | Description |
-|---|---|---|---|
-| `--key` | `-k` | — | Storage key (required) |
-| `--value` | — | — | Value to store (required) |
-| `--namespace` | `-n` | `default` | Memory namespace |
-| `--ttl` | — | — | Time to live in seconds |
-| `--tags` | — | — | Comma-separated tags |
-| `--vector` | — | `false` | Store as vector embedding |
-| `--upsert` | `-u` | `false` | Update if key exists |
-
-## search — Semantic Search
-
-```bash
-# Semantic search (default)
-npx monomind memory search --query "authentication patterns"
-
-# Keyword search
-npx monomind memory search --query "JWT" --type keyword
-
-# Hybrid search with namespace filter
-npx monomind memory search --query "error handling" --namespace patterns --limit 5
-
-# Build HNSW index first for max speed
-npx monomind memory search --query "API design" --build-hnsw
-```
-
-**Flags:**
-
-| Flag | Short | Default | Description |
-|---|---|---|---|
-| `--query` | `-q` | — | Search query (required) |
-| `--namespace` | `-n` | all | Filter by namespace |
-| `--limit` | `-l` | `10` | Maximum results |
-| `--threshold` | — | `0.7` | Similarity threshold (0-1) |
-| `--type` | `-t` | `semantic` | `semantic`, `keyword`, `hybrid` |
-| `--build-hnsw` | — | `false` | Rebuild HNSW index before search |
-
-## retrieve — Get by Key
-
-```bash
-npx monomind memory retrieve --key "arch/api-design"
-npx monomind memory retrieve --key "pattern/auth" --namespace patterns
-```
-
-**Flags:** `--key/-k` (required), `--namespace/-n` (default: `default`)
-
-## list — Browse Entries
-
-```bash
-npx monomind memory list
-npx monomind memory list --namespace patterns --limit 20
-```
-
-**Flags:** `--namespace/-n`, `--limit/-l` (default: `20`)
-
-## delete — Remove Entry
-
-```bash
-npx monomind memory delete --key "old-pattern"
-npx monomind memory delete --key "temp-key" --namespace temp --force
-```
-
-**Flags:** `--key/-k` (required), `--namespace/-n` (default: `default`), `--force/-f` (skip confirmation)
-
-## templates — Entry Templates
-
-```bash
-npx monomind memory templates
-npx monomind memory templates --type feedback
-```
-
-Types: `user`, `feedback`, `project`, `reference` — scaffolds for the auto-memory format.
-
-## stats — Storage Overview
-
-```bash
-npx monomind memory stats
-```
-
-Shows backend, total entries, storage size, oldest/newest entry.
-
-## configure — Backend Settings
-
-```bash
-npx monomind memory configure --backend lancedb
-npx monomind memory configure --backend hybrid --cache-size 512 --hnsw-m 16 --hnsw-ef 200
-```
-
-**Flags:** `--backend/-b`, `--path`, `--cache-size`, `--hnsw-m`, `--hnsw-ef`
-
-## cleanup — Remove Stale Entries
-
-```bash
-# Preview without deleting
-npx monomind memory cleanup --dry-run
-
-# Delete entries older than 30 days
-npx monomind memory cleanup --older-than 30d
-
-# Remove expired TTL entries only
-npx monomind memory cleanup --expired-only
-
-# Clean specific namespace
-npx monomind memory cleanup --namespace temp --older-than 7d --force
-```
-
-**Flags:** `--dry-run/-d`, `--older-than/-o` (e.g., `7d`, `30d`), `--expired-only/-e`, `--namespace/-n`, `--force/-f`
-
-## compress — Optimize Storage
-
-```bash
-npx monomind memory compress
-npx monomind memory compress --quantize --bits 4  # 32x size reduction
-npx monomind memory compress --level max --target vectors
-```
-
-**Flags:** `--level fast|balanced|max` (default: `balanced`), `--target vectors|text|patterns|all`, `--quantize/-z`, `--bits 4|8|16`, `--rebuild-index/-r` (default: true)
-
-## export / import
-
-```bash
-# Export all to JSON
-npx monomind memory export --output ./backup.json
-
-# Export specific namespace to CSV
-npx monomind memory export --output ./patterns.csv --format csv --namespace patterns
-
-# Import
-npx monomind memory import --input ./backup.json
-npx monomind memory import --input ./backup.json --namespace archive
-```
-
-## Namespaces
-
-`default`, `agents`, `tasks`, `sessions`, `swarm`, `project`, `spec`, `arch`, `impl`, `test`, `debug`, `patterns`, `solutions`
-
-## MCP Tools
-
-```javascript
-// Store
-mcp__monomind__memory_store({ key: "pattern/auth", value: "JWT + refresh", namespace: "patterns" })
-
-// Search
-mcp__monomind__memory_search({ query: "authentication", namespace: "patterns" })
-
-// Retrieve
-mcp__monomind__memory_retrieve({ key: "pattern/auth", namespace: "patterns" })
-
-// List
-mcp__monomind__memory_list({ namespace: "patterns" })
-
-// Delete
-mcp__monomind__memory_delete({ key: "pattern/auth", namespace: "patterns" })
-
-// Stats
-mcp__monomind__memory_stats({})
-```
-
-## Common Workflows
-
-### Store successful pattern after completing a task
-
-```bash
-npx monomind memory store --key "pattern/oauth-integration" --value "Use PKCE flow, store tokens in httpOnly cookies" --namespace patterns --tags "auth,oauth"
-```
-
-### Search before starting a task
-
-```bash
-npx monomind memory search --query "OAuth integration patterns" --namespace patterns --limit 5
-```
-
-### Backup before major refactor
-
-```bash
-npx monomind memory export --output "./backups/memory-$(date +%Y%m%d).json"
-```

package/.claude/commands/mastermind/okf-export.md

@@ -1,14 +0,0 @@
-<!-- Export the Second Brain knowledge base as a portable OKF (Open Knowledge Format) bundle. -->
-
-Parse `$ARGUMENTS` for:
-- `--output <dir>` or `-o <dir>` → output directory (default: `.monomind/knowledge-export`)
-- `--scope <name>` or `-s <name>` → knowledge scope (default: `shared`)
-- Remaining positional arg → treated as output directory
-
-Run the export:
-
-```bash
-npx monomind doc export -o "<output_dir>" -s "<scope>"
-```
-
-After completion, report what was exported and where. If 0 documents exported, suggest `monomind doc ingest <path>` first.

package/.claude/commands/mastermind/okf-import.md

@@ -1,15 +0,0 @@
-<!-- Import an OKF (Open Knowledge Format) bundle into the Second Brain knowledge base. -->
-
-Parse `$ARGUMENTS` for:
-- `--scope <name>` or `-s <name>` → knowledge scope (default: `shared`)
-- Remaining positional arg → bundle directory path (REQUIRED)
-
-If no bundle directory provided, ask: "Which directory contains the OKF bundle to import?"
-
-Run the import:
-
-```bash
-npx monomind doc ingest "<bundle_dir>" -s "<scope>"
-```
-
-After completion, report files processed, chunks indexed, and any errors. If the bundle directory doesn't exist or contains no `.md` files, say so.

package/.claude/commands/mastermind/ops.md

@@ -1,23 +0,0 @@
-<!-- Mastermind ops domain — workflow automation, reporting, process optimization. Default mode: auto. -->
-
-**First — extract repeat flags:** Follow the REPEAT PREAMBLE from `_repeat.md`. Extracts `--repeat`, `--tillend`, `--maxruns`, `--wait`, `--rep`, `--loop` from `$ARGUMENTS` before all other parsing. If `is_continuation = true`, skip the empty-prompt check and intake below.
-
-Parse `$ARGUMENTS` for:
-- `--auto` flag → mode = auto
-- `--confirm` flag → mode = confirm
-- `--project <name>` → project_name = <name>
-- Remaining text = prompt
-
-If prompt is empty: ask "What operations task would you like to automate or optimize?"
-
-Load brain context for the `ops` domain (follow _protocol.md Brain Load Procedure).
-
-Run intake if prompt is vague (follow _intake.md — stop at Q3, domain is already known as `ops`).
-
-Default mode for this command: **auto** (unless `--confirm` flag present or intake Q4 says confirm).
-
-Invoke `Skill("mastermind-skills:ops")` passing: brain_context, prompt, project_name, board_id (create if needed), mode.
-
-After skill returns: follow _protocol.md Brain Write Procedure for domain `ops`.
-
-Invoke `Skill("mastermind-skills:_repeat")` now to execute the REPEAT POSTAMBLE. This is a required tool call — do not skip it.

package/.claude/commands/mastermind/orgs.md

@@ -1,18 +0,0 @@
-<!-- List all saved orgs with their status, schedule interval, and last/next run times. Shows stopped/active/paused state for scheduled orgs. -->
-
-**If $ARGUMENTS is empty:** Execute the listing below directly.
-
----
-
-**MASTERMIND: ORGS**
-
-Lists all saved orgs.
-
----
-
-Parse `$ARGUMENTS` for:
-- No flags expected — this command takes no arguments.
-
-Execute `Skill("mastermind-skills:orgs")` passing: caller: "command".
-
-Invoke `Skill("mastermind-skills:_repeat")` now to execute the REPEAT POSTAMBLE. This is a required tool call — do not skip it.

package/.claude/commands/mastermind/orgstatus.md

@@ -1,56 +0,0 @@
-<!-- Show detailed status for a single org — lifecycle state, schedule, last/next run, recent activity, and roles. For scheduled orgs shows loop health. -->
-
-**If $ARGUMENTS is empty:** Output the following and wait.
-
----
-
-**MASTERMIND: ORG STATUS**
-
-Shows detailed status for a saved org.
-
-**Usage:**
-
-```
-/mastermind:orgstatus --org <name>
-```
-
-**Examples:**
-
-```
-/mastermind:orgstatus --org livarto-issue-resolver
-/mastermind:orgstatus --org newsroom
-```
-
-Your saved orgs:
-
-```bash
-ls .monomind/orgs/*.json 2>/dev/null | grep -v -- '-approvals\|-state\|-activity' | \
-  xargs -I{} basename {} .json 2>/dev/null || echo "(none — run /mastermind:createorg to define one)"
-```
-
----
-
-**If $ARGUMENTS is non-empty:** Execute the flow below.
-
----
-
-Parse `$ARGUMENTS` for:
-- `--org <name>` → org_name = <name>
-
-If `--org` is not provided, list orgs and ask which to inspect.
-
-Verify the org file exists:
-```bash
-[ -f ".monomind/orgs/${org_name}.json" ] || { echo "Org '${org_name}' not found."; exit 1; }
-```
-
-Generate a session ID:
-```bash
-REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
-session_id="mm-$(date -u +%Y%m%dT%H%M%S)"
-CTRL_URL=$(jq -r '.url // "http://localhost:4242"' "$REPO_ROOT/.monomind/control.json" 2>/dev/null || echo "http://localhost:4242")
-```
-
-Invoke `Skill("mastermind-skills:orgstatus")` passing: org_name: `$org_name`, caller: "command".
-
-Invoke `Skill("mastermind-skills:_repeat")` now to execute the REPEAT POSTAMBLE. This is a required tool call — do not skip it.

package/.claude/commands/mastermind/plan.md

@@ -1,23 +0,0 @@
-<!-- Write a comprehensive implementation plan from a spec or requirements. Saves to docs/mastermind/plans/. Default mode: confirm. -->
-
-**First — extract repeat flags:** Follow the REPEAT PREAMBLE from `_repeat.md`. Extracts `--repeat`, `--tillend`, `--maxruns`, `--wait`, `--rep`, `--loop` from `$ARGUMENTS` before all other parsing. If `is_continuation = true`, skip the empty-prompt check and intake below.
-
-Parse `$ARGUMENTS` for:
-- `--auto` flag → mode = auto
-- `--confirm` flag → mode = confirm
-- `--project <name>` → project_name = <name>
-- Remaining text = spec description or path to spec file
-
-If spec is empty: ask "What would you like a plan for? (provide a spec, requirements, or feature description)"
-
-Load brain context (follow `_protocol.md` Brain Load Procedure).
-
-Default mode: **confirm** (unless `--auto` flag is present).
-
----
-
-Invoke `Skill("mastermind-skills:plan")` passing: brain_context, params, project_name, mode.
-
-After skill returns: follow `_protocol.md` Brain Write Procedure.
-
-**MANDATORY — invoke `Skill("mastermind-skills:_repeat")` now.** This is required regardless of how the skill above completed, regardless of whether you think the work is done, regardless of whether you plan to end your response. For `--repeat N`: the count is non-negotiable — all N runs must happen. For `--tillend`: only a verified empty round (confirmed by git diff) stops the loop. Do not end your response without invoking this skill.

package/.claude/commands/mastermind/receive-review.md

@@ -1,17 +0,0 @@
-<!-- Use when receiving code review feedback to evaluate and implement it with technical rigor — verifies before implementing, clarifies unclear items first, applies reasoned pushback when warranted -->
-
-**First — extract repeat flags:** Follow REPEAT PREAMBLE from `_repeat.md`.
-
-Parse `$ARGUMENTS` for `--auto`, `--confirm`, `--project <name>`, and remaining text.
-
-Load brain context (follow `_protocol.md` Brain Load Procedure).
-
-Default mode: **confirm**.
-
----
-
-Invoke `Skill("mastermind-skills:receive-review")` passing: brain_context, params, mode.
-
-After skill returns: follow `_protocol.md` Brain Write Procedure.
-
-Invoke `Skill("mastermind-skills:_repeat")` now. Required — do not skip.

package/.claude/commands/mastermind/references/antigravity-tools.md

@@ -1,60 +0,0 @@
-# Antigravity CLI (`agy`) Tool Mapping
-
-Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). On the Antigravity CLI (`agy`) these resolve to the tools below.
-
-| Action skills request | Antigravity CLI equivalent |
-|----------------------|----------------------|
-| Read a file | `view_file` |
-| Create a new file | `write_to_file` |
-| Edit a file | `replace_file_content` |
-| Edit a file in several places at once | `multi_replace_file_content` |
-| Run a shell command | `run_command` |
-| Search file contents | `grep_search` |
-| Find files by name / list a directory | `list_dir` (no dedicated glob tool — combine `list_dir` with `grep_search`) |
-| Fetch a URL | `read_url_content` |
-| Search the web | `search_web` |
-| Pose a structured question to your human partner | `ask_question` |
-| Dispatch a subagent (`Subagent (general-purpose):` template) | `invoke_subagent` with a built-in `TypeName` — `self` for full-capability work, `research` for read-only (see [Subagent support](#subagent-support)) |
-| Multiple parallel dispatches | Multiple entries in one `invoke_subagent` call's `Subagents` array |
-| Task tracking ("create a todo", "mark complete") | a **task artifact** — `write_to_file` with `IsArtifact: true` and `ArtifactType: "task"` (see [Task tracking](#task-tracking)). **Not** `manage_task`, which manages background processes. |
-
-## Invoking a skill — read its `SKILL.md`
-
-Antigravity surfaces every installed skill's `name` + `description` to you at the start of each session, but it has **no `Skill`/`activate_skill` tool**. To load a skill, **read its `SKILL.md` with `view_file`, setting `IsSkillFile: true`** when the skill applies — e.g. `view_file` on `.../mastermind/skills/<skill-name>/SKILL.md` with `IsSkillFile: true`.
-
-(`IsSkillFile` is agy's own signal that you're reading a file to *execute its instructions*, not to edit or preview it — set it whenever you load a skill.)
-
-This is the blessed skill-loading mechanism on this harness. The general rule "never read skill files manually" means "don't bypass your platform's skill-loading mechanism" — and on Antigravity, reading `SKILL.md` *is* that mechanism. Reading it honors the rule rather than breaking it.
-
-You already know which skills exist and what they're for: their names and descriptions are in front of you at session start. When a description matches what you're about to do, read that skill's `SKILL.md` before acting.
-
-## Subagent support
-
-Antigravity dispatches subagents with `invoke_subagent`, passing each one a `TypeName` in the `Subagents` array. Two `TypeName`s are **built in** — use them directly, no `define_subagent` needed:
-
-- **`self`** — a full clone of you, with every tool you have (including `write_to_file`/`replace_file_content`/`run_command`). The safe default for general-purpose work: implementing, fixing, anything that edits files or runs commands.
-- **`research`** — read-only (file reading, `grep_search`, web/URL fetch; no write or command access). Use it when you specifically want a subagent that can't make changes — investigation and read-only review.
-
-Call `define_subagent` only for a custom system prompt or capability mix: set `enable_write_tools: true` to grant file edits **and** `run_command`, `enable_subagent_tools` for nested dispatch, `enable_mcp_tools` for MCP. Then invoke it by the name you gave it.
-
-Skills dispatch with `Subagent (general-purpose):` and either reference a prompt-template file or supply an inline prompt. On Antigravity:
-
-| Skill dispatch form | Antigravity equivalent |
-|---------------------|----------------------|
-| An implementer-style template (writes code, runs tests) | Fill the template, then `invoke_subagent` with `TypeName: "self"` and the filled prompt |
-| A read-only reviewer template (`mastermind:review`) | `invoke_subagent` with `TypeName: "research"` and the filled review template |
-| Inline prompt (no template referenced) | `invoke_subagent` with `TypeName: "self"` (or `"research"` if the task only reads) and your inline prompt |
-
-### Prompt filling
-
-Skills provide prompt templates with placeholders like `{WHAT_WAS_IMPLEMENTED}` or `[FULL TEXT of task]`. Fill all placeholders before passing the complete prompt to `invoke_subagent`. The prompt template itself contains the agent's role, review criteria, and expected output format — the subagent will follow it.
-
-### Parallel dispatch
-
-Put multiple entries in a single `invoke_subagent` call's `Subagents` array to run independent subagent work in parallel. Keep dependent tasks sequential, but do not serialize independent subagent tasks just to preserve a simpler history.
-
-## Task tracking
-
-Antigravity has **no todo / `TodoWrite` tool** (`manage_task` manages background processes — it is *not* a checklist). When a skill says to create a todo list or track tasks, maintain a **task artifact**: a markdown checklist saved with `write_to_file` (`IsArtifact: true`, `ArtifactMetadata.ArtifactType: "task"`), edited with `replace_file_content` / `multi_replace_file_content` as you go.
-
-At the start of any multi-step task, create the task artifact listing every step of your plan. As you complete each step, edit the artifact to mark it done (`- [x]`). If the plan changes, update the checklist. Keep it current — it is your source of truth for what remains; once the conversation gets long, re-read it before starting each step.

package/.claude/commands/mastermind/references/claude-code-tools.md

@@ -1,50 +0,0 @@
-# Claude Code Tool Mapping
-
-Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). On Claude Code these resolve to the tools below.
-
-## Tools
-
-| Action skills request | Claude Code tool |
-|----------------------|------------------|
-| Read a file | `Read` |
-| Create a new file | `Write` |
-| Edit a file | `Edit` |
-| Run a shell command | `Bash` |
-| Search file contents | `Grep` |
-| Find files by name | `Glob` |
-| Fetch a URL | `WebFetch` |
-| Search the web | `WebSearch` |
-| Invoke a skill | `Skill` |
-| Dispatch a subagent (`Subagent (general-purpose):` template) | `Agent` (older releases named this `Task`) |
-| Multiple parallel dispatches | Multiple `Agent` calls in one response |
-| Task tracking ("create a todo", "mark complete") | `TaskCreate`, `TaskUpdate`, `TaskList`, `TaskGet`; `TodoWrite` in `claude -p` / Agent SDK unless `CLAUDE_CODE_ENABLE_TASKS=1` is set |
-| Background-process / subagent lifecycle (read output, cancel) | `TaskOutput`, `TaskStop` — these are distinct from the todo tools above and apply to running shells, agents, and remote sessions |
-
-## Instructions file
-
-When a skill mentions "your instructions file", on Claude Code this is **`CLAUDE.md`**. Claude Code walks up the directory tree from the current working directory and concatenates every `CLAUDE.md` and `CLAUDE.local.md` it finds along the way. Standard locations:
-
-| Scope | Location |
-|-------|----------|
-| Project (team-shared) | `./CLAUDE.md` or `./.claude/CLAUDE.md` |
-| User global | `~/.claude/CLAUDE.md` |
-| Local-private (gitignored) | `./CLAUDE.local.md` |
-| Managed policy (org-wide) | `/Library/Application Support/ClaudeCode/CLAUDE.md` (macOS), `/etc/claude-code/CLAUDE.md` (Linux/WSL), `C:\Program Files\ClaudeCode\CLAUDE.md` (Windows) |
-
-CLAUDE.md files can pull in additional content with `@path/to/file` imports (relative or absolute, max five hops deep). Subdirectory `CLAUDE.md` files are also discovered automatically and loaded on-demand when Claude Code reads files in those subdirectories.
-
-Claude Code does **not** read `AGENTS.md` directly. If a project already maintains `AGENTS.md` for other agents, import it from `CLAUDE.md` so both runtimes share the same instructions:
-
-```markdown
-@AGENTS.md
-
-## Claude Code
-
-(Claude-Code-specific instructions go here.)
-```
-
-For path-scoped rules and larger-project organization, see `.claude/rules/` (rules can be scoped to specific files via `paths` frontmatter and load on demand).
-
-## Personal skills directory
-
-User-level skills live at **`~/.claude/skills/`**. Each skill is a subdirectory containing a `SKILL.md` (with `name` and `description` frontmatter) plus any supporting files. Claude Code does not currently recognize the cross-runtime `~/.agents/skills/` path that Codex, Copilot CLI, and Gemini CLI read; if you're relying on cross-runtime support in the future, verify against the official skills docs.

package/.claude/commands/mastermind/references/codex-tools.md

@@ -1,64 +0,0 @@
-# Codex Tool Mapping
-
-Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). On Codex these resolve to the tools below.
-
-| Action skills request | Codex equivalent |
-|----------------------|------------------|
-| Read a file | `shell` (e.g., `cat`, `head`, `tail`) — Codex reads files via shell |
-| Create / edit / delete a file | `apply_patch` (structured diff for create, update, delete) |
-| Run a shell command | `shell` |
-| Search file contents | `shell` (e.g., `grep`, `rg`) |
-| Find files by name | `shell` (e.g., `find`, `ls`) |
-| Fetch a URL | `shell` with `curl` / `wget` — Codex has no native fetch tool |
-| Search the web | `web_search` (enabled by default; configurable in `config.toml` via the top-level `web_search` setting — `live`, `cached`, or `disabled`) |
-| Invoke a skill | Skills load natively — just follow the instructions |
-| Dispatch a subagent (`Subagent (general-purpose):` template) | `spawn_agent` (see [Subagent dispatch requires multi-agent support](#subagent-dispatch-requires-multi-agent-support)) |
-| Multiple parallel dispatches | Multiple `spawn_agent` calls in one response |
-| Wait for subagent result | `wait_agent` |
-| Free up subagent slot when done | `close_agent` |
-| Task tracking ("create a todo", "mark complete") | `update_plan` |
-
-## Instructions file
-
-When a skill mentions "your instructions file", on Codex this is **`AGENTS.md`** at the project root. Codex also reads `~/.codex/AGENTS.md` for global context, and an `AGENTS.override.md` (in the project tree or `~/.codex/`) takes precedence when present. Codex walks from the project root down to the current working directory, concatenating `AGENTS.md` files it finds along the way, up to `project_doc_max_bytes` (32 KiB by default).
-
-## Personal skills directory
-
-User-level skills live at **`$CODEX_HOME/skills/`** (default `~/.codex/skills/`). Codex also reads the cross-runtime path **`~/.agents/skills/`** (shared with Copilot CLI and Gemini CLI). When both directories exist at the same scope, Codex loads them both as separate skill catalogs. Each skill is a subdirectory containing a `SKILL.md` (with `name` and `description` frontmatter).
-
-## Subagent dispatch requires multi-agent support
-
-Add to your Codex config (`~/.codex/config.toml`):
-
-```toml
-[features]
-multi_agent = true
-```
-
-This enables `spawn_agent`, `wait_agent`, and `close_agent` for skills like `mastermind:taskdev` and `mastermind:review`.
-
-Legacy note: Codex builds before `rust-v0.115.0` exposed spawned-agent waiting as `wait`. Current Codex uses `wait_agent` for spawned agents. The `wait` name now belongs to code-mode `exec/wait`, which resumes a yielded exec cell by `cell_id`; it is not the spawned-agent result tool.
-
-## Environment Detection
-
-Skills that create worktrees or finish branches should detect their environment with read-only git commands before proceeding:
-
-```bash
-GIT_DIR=$(cd "$(git rev-parse --git-dir)" 2>/dev/null && pwd -P)
-GIT_COMMON=$(cd "$(git rev-parse --git-common-dir)" 2>/dev/null && pwd -P)
-BRANCH=$(git branch --show-current)
-```
-
-- `GIT_DIR != GIT_COMMON` → already in a linked worktree (skip creation)
-- `BRANCH` empty → detached HEAD (cannot branch/push/PR from sandbox)
-
-See `mastermind:worktree` Step 0 and `mastermind:finish` Step 1 for how each skill uses these signals.
-
-## Codex App Finishing
-
-When the sandbox blocks branch/push operations (detached HEAD in an externally managed worktree), the agent commits all work and informs the user to use the App's native controls:
-
-- **"Create branch"** — names the branch, then commit/push/PR via App UI
-- **"Hand off to local"** — transfers work to the user's local checkout
-
-The agent can still run tests, stage files, and output suggested branch names, commit messages, and PR descriptions for the user to copy.

package/.claude/commands/mastermind/references/copilot-tools.md

@@ -1,49 +0,0 @@
-# Copilot CLI Tool Mapping
-
-Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). On Copilot CLI these resolve to the tools below.
-
-| Action skills request | Copilot CLI equivalent |
-|----------------------|----------------------|
-| Read a file | `view` |
-| Create / edit / delete a file | `apply_patch` (Copilot CLI has no separate create/edit/write tools) |
-| Run a shell command | `bash` |
-| Search file contents | `rg` (ripgrep; Copilot CLI does not expose a `grep` tool) |
-| Find files by name | `glob` |
-| Fetch a URL | `web_fetch` |
-| Search the web | `web_search` |
-| Invoke a skill | `skill` |
-| Dispatch a subagent (`Subagent (general-purpose):` template) | `task` with `agent_type: "general-purpose"` (other accepted types: `explore`, `task`, `code-review`, `research`, `configure-copilot`) |
-| Multiple parallel dispatches | Multiple `task` calls in one response |
-| Subagent status/output/control | `read_agent`, `list_agents`, `write_agent` |
-| Task tracking ("create a todo", "mark complete") | `update_todo` |
-| Enter / exit plan mode | No equivalent — stay in the main session |
-
-## Instructions file
-
-When a skill mentions "your instructions file", on Copilot CLI this is **`AGENTS.md`** at the repository root. If both `AGENTS.md` and `.github/copilot-instructions.md` are present, Copilot reads both.
-
-## Personal skills directory
-
-User-level skills live at **`~/.copilot/skills/`**. Copilot CLI also recognizes the cross-runtime alias **`~/.agents/skills/`**, which is shared with Codex and Gemini CLI. Each skill is a subdirectory containing a `SKILL.md` (with `name` and `description` frontmatter).
-
-## Async shell sessions
-
-Copilot CLI supports persistent async shell sessions:
-
-| Tool | Purpose |
-|------|---------|
-| `bash` with `mode: "async"` (and optionally `detach: true`) | Start a long-running command in the background; returns a `shellId` |
-| `write_bash` | Send input to a running async session |
-| `read_bash` | Read output from an async session |
-| `stop_bash` | Terminate an async session |
-| `list_bash` | List all active shell sessions |
-
-## Additional Copilot CLI tools
-
-| Tool | Purpose |
-|------|---------|
-| `store_memory` | Persist facts about the codebase for future sessions |
-| `report_intent` | Update the UI status line with current intent |
-| `sql` | Query the session's SQLite database (todos, metadata) |
-| `fetch_copilot_cli_documentation` | Look up Copilot CLI documentation |
-| GitHub MCP tools (`github-mcp-server-*`) | Native GitHub API access (issues, PRs, code search) |