root

Start or continue a Root development session for a GitHub issue. On first invocation classifies tier, loads docs via RAG, and plans. On re-invocation drives the stream through implementation, review, and merge. Also handles orchestration verbs (list, status, approve, run, sync, delete, clean, reset).

CRITICAL: Load this skill before ANY code change in the Root framework. Root is a dual-harness project — every file must work for both Claude Code (plugin) and Gemini CLI (extension). This skill contains the rules for shared vs harness-specific files, command naming, config schemas, environment variables, and CLI usage. Load when: editing any file in this repo, adding commands/skills/agents/hooks, modifying plugin.json or gemini-extension.json, changing scripts or configs, working with mcp-local-rag.

Use this skill when ingesting or querying documents with MCP local RAG, including `query_documents`, `ingest_file`, `ingest_data`, and CLI bulk ingestion. Covers query refinement, result score interpretation, and source metadata conventions for PDF, HTML, DOCX, TXT, and Markdown. Not for general file operations or SQL/database queries.