[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74EP4BZRZBJNGT3C9Q9DS9V":3,"skill-same:01M74EP4BZRZBJNGT3C9Q9DS9V":317},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M74EP4BZRZBJNGT3C9Q9DS9V","cypilot",null,"Invoke when user asks to do something with Cypilot, or wants to analyze\u002Fvalidate artifacts, or create\u002Fgenerate\u002Fimplement anything using Cypilot workflows, or plan phased execution. Core capabilities: workflow routing (plan\u002Fanalyze\u002Fgenerate\u002Fauto-config); deterministic validation (structure, cross-refs, traceability, TOC); code↔artifact traceability with @cpt-* markers; spec coverage measurement; ID search\u002Fnavigation; init\u002Fbootstrap; adapter + registry discovery; auto-configuration of brownfield projects (scan conventions, generate rules); kit management (install\u002Fupdate with file-level diff); TOC generation; agent integrations (Windsurf, Cursor, Claude, Copilot, OpenAI).","constructorfabric\u002Finsight-front","constructorfabric","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F286363322?v=4","01M74EHWDT73DH7WYE949KK2Y7","Constructor Fabric","01M74EMM2J3M4ECCBNGKX70S5J",3,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: cypilot\ndescription: \"Invoke when user asks to do something with Cypilot, or wants to analyze\u002Fvalidate artifacts, or create\u002Fgenerate\u002Fimplement anything using Cypilot workflows, or plan phased execution. Core capabilities: workflow routing (plan\u002Fanalyze\u002Fgenerate\u002Fauto-config); deterministic validation (structure, cross-refs, traceability, TOC); code↔artifact traceability with @cpt-* markers; spec coverage measurement; ID search\u002Fnavigation; init\u002Fbootstrap; adapter + registry discovery; auto-configuration of brownfield projects (scan conventions, generate rules); kit management (install\u002Fupdate with file-level diff); TOC generation; agent integrations (Windsurf, Cursor, Claude, Copilot, OpenAI).\"\n---\n\n# Cypilot Unified Tool\n\n\n\u003C!-- toc -->\n\n- [Cypilot Unified Tool](#cypilot-unified-tool)\n  - [Goal](#goal)\n  - [Preconditions](#preconditions)\n  - [⚠️ MUST Instruction Semantics ⚠️](#️-must-instruction-semantics-️)\n  - [Agent Acknowledgment](#agent-acknowledgment)\n  - [Execution Logging](#execution-logging)\n  - [Variables](#variables)\n    - [Template Variable Resolution](#template-variable-resolution)\n  - [CLI Resolution](#cli-resolution)\n  - [Protocol Guard](#protocol-guard)\n  - [Cypilot Mode](#cypilot-mode)\n  - [Agent-Safe Invocation](#agent-safe-invocation)\n  - [Quick Commands](#quick-commands)\n    - [Direct CLI Commands (No Workflow Routing)](#direct-cli-commands-no-workflow-routing)\n    - [Workflow Shortcuts](#workflow-shortcuts)\n  - [Workflow Routing](#workflow-routing)\n  - [Command Reference](#command-reference)\n  - [Auto-Configuration](#auto-configuration)\n  - [Project Configuration](#project-configuration)\n\n\u003C!-- \u002Ftoc -->\n\n## Goal\n\nCypilot provides artifact validation, cross-reference validation, code traceability, spec coverage measurement, ID search\u002Fnavigation, kit management, TOC generation\u002Fvalidation, multi-agent integration, and design-to-code implementation with `@cpt-*` markers.\n\n## Preconditions\n\n- `cpt` available (preferred) or `python3` as fallback\n- Target paths exist and are readable\n\n---\n\n## ⚠️ MUST Instruction Semantics ⚠️\n\n**MUST** and **ALWAYS** are mandatory. Skipping any MUST instruction invalidates execution, the output must be discarded, and the workflow fails.\n\n## Agent Acknowledgment\n\n- [ ] MUST\u002FALWAYS are mandatory; skipping any MUST invalidates execution.\n- [ ] I will read all required files before proceeding.\n- [ ] I will follow workflows step-by-step without shortcuts.\n- [ ] I will not create or modify files, or execute any other write-capable Cypilot command, without explicit user confirmation, and I will not add auto-approval flags unless the user explicitly asks for them.\n- [ ] I will list Cypilot files read, why, and the triggering instruction before any approval prompt.\n\nBy proceeding with Cypilot work, I acknowledge and accept these requirements.\n\nALWAYS SET {cypilot_mode} = `on` FIRST when loading this skill\n\n## Execution Logging\n\nALWAYS provide execution visibility:\n- Notify the user when entering any H2 section of a Cypilot prompt.\n- Notify the user when completing any `- [ ]` checklist task.\n- Use `- [CONTEXT]: MESSAGE`; set context to the file\u002Fsection and message to the action + why.\n- Logging must help the user understand loaded prompts, routing decisions, debugging state, and workflow progress.\n\nExample:\n```text\n- [execution-protocol]: Entering \"Load Rules\" — target is CODE, loading codebase\u002Frules.md\n- [DESIGN rules]: Completing \"Validate structure\" — all required sections present\n- [workflows\u002Fgenerate.md]: Entering \"Determine Target\" — user requested code implementation\n```\n\n## Variables\n\n| Variable | Value | Use |\n|---|---|---|\n| `{cypilot_path}` | Directory path resolved from root `AGENTS.md` | Base path for all Cypilot-relative references |\n| `{cypilot_mode}` | `on` or `off` | Current Cypilot mode state |\n| `{cpt_cmd}` | `cpt` or `python3 {cypilot_path}\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot.py` | Resolved CLI entrypoint |\n| `{cpt_installed}` | `true` or `false` | Whether the `cpt` CLI is available |\n\nSetting `{cypilot_mode}`: explicit `cypilot on\u002Foff` or a prompt that activates\u002Fdeactivates Cypilot workflows.\n\n### Template Variable Resolution\n\n- Resolve variables from `{cpt_cmd} --json info` first; parse the returned `variables` dict.\n- Use `{cpt_cmd} --json resolve-vars` only when a fresh or filtered map is needed.\n- Variable sources: system (`cypilot_path`, `project_root`) + installed kit resources.\n- ALWAYS resolve `{variable}` references to absolute paths before using kit markdown files.\n\n## CLI Resolution\n\nRun before Protocol Guard when `{cypilot_mode}` is `on`:\n1. `command -v cpt` → `{cpt_cmd} = cpt`, `{cpt_installed} = true`\n2. Otherwise `{cpt_cmd} = python3 {cypilot_path}\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot.py`, `{cpt_installed} = false`\n3. If `cpt` is missing and `~\u002F.cypilot\u002Fcache\u002Fcpt-prompt-dismissed` does not exist, offer `pipx install git+https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Fcyber-pilot.git`; on dismiss create the marker file\n4. Re-offer installation if the user later asks about the long invocation path\n\nALWAYS use `{cpt_cmd}` for all later CLI invocations.\n\n## Protocol Guard\n\n- ALWAYS FIRST open and remember `{cypilot_path}\u002F.gen\u002FAGENTS.md`\n- ALWAYS open and follow `{cypilot_path}\u002Fconfig\u002FAGENTS.md` when it exists\n- ALWAYS open and follow `{cypilot_path}\u002F.gen\u002FSKILL.md` when it exists\n- ALWAYS open and follow `{cypilot_path}\u002Fconfig\u002FSKILL.md` when it exists\n- ALWAYS FIRST run `{cpt_cmd} --json info` before any Cypilot workflow action\n- ALWAYS store the `variables` dict from `info` output and use it to resolve `{variable}` references in AGENTS\u002FSKILL\u002Frules\u002Fworkflows\n- ALWAYS follow this load order: `info` → registry\u002Fintent\u002Ftarget\u002Frules resolution from `execution-protocol.md` → matched WHEN-clause specs\n- ALWAYS load matched WHEN-clause specs only after registry understanding, target determination, and `rules.md` resolution provide enough context to match safely\n- ALWAYS FIRST parse and load all matched WHEN-clause specs before proceeding\n- MUST NOT preload every AGENTS\u002FSKILL\u002Fspec file up front; load only the smallest set needed for the current request\n- Before opening a large AGENTS\u002FSKILL\u002Fspec file, estimate size and prefer chunked reads of matched sections over full-file reads\n- If safe WHEN-clause matching is not yet possible, stop after registry\u002Ftarget\u002Frules resolution and continue only when enough context exists to load specs boundedly\n- If required Protocol Guard context would exceed the current turn budget, checkpoint or escalate instead of proceeding with partial or unbounded spec loading\n- ALWAYS include this block when editing code:\n```text\nCypilot Context:\n- Cypilot: {path}\n- Target: {artifact|codebase}\n- Specs loaded: {list paths or \"none required\"}\n```\n- ALWAYS stop and re-run Protocol Guard when required specs should have been loaded but were not\n\n## Cypilot Mode\n\n- ALWAYS set `{cypilot_mode} = on` first when user invokes `cypilot {prompt}`\n- ALWAYS run `info` when enabling Cypilot mode\n- ALWAYS show:\n```text\nCypilot Mode Enabled\nCypilot: {FOUND at path | NOT_FOUND}\n```\n\n## Agent-Safe Invocation\n\n- ALWAYS use `{cpt_cmd} --json \u003Csubcommand> [options]` for agent-driven CLI calls unless a command-specific exception below says otherwise\n- ALWAYS pass `--json` immediately after `{cpt_cmd}` and before the subcommand when using machine-output mode\n- EXCEPTION: NEVER run `{cpt_cmd} init` with `--json`; always invoke `{cpt_cmd} init ...` without `--json`\n- EXCEPTION: NEVER run `{cpt_cmd} delegate` with `--json`; always invoke `{cpt_cmd} delegate \u003Cplan_dir> ...` without `--json`\n- EXCEPTION: NEVER run `{cpt_cmd} update` with `--json`; always invoke `{cpt_cmd} update ...` without `--json`\n- ALWAYS use `=` form for pattern args starting with `-` (example: `--pattern=-req-`)\n- MUST obtain explicit user confirmation before executing any write-capable command, including direct CLI commands that do not route through a workflow\n- MUST NOT add auto-approval flags such as `--yes`, `-y`, or `--force` to write-capable commands unless the user explicitly requested that non-interactive behavior\n\n## Quick Commands\n\n### Direct CLI Commands (No Workflow Routing)\n\nNo workflow routing skips workflow selection only. It does not waive confirmation: obtain explicit user confirmation before executing any write-capable direct CLI command below.\n\n| User invocation | Direct action |\n|---|---|\n| `cypilot init` | After explicit user confirmation, run `{cpt_cmd} init` without `--json` |\n| `cypilot update` | After explicit user confirmation, run `{cpt_cmd} update` without `--json` |\n| `cypilot agents \u003Cname>` | Run `{cpt_cmd} --json agents --agent \u003Cname>` |\n| `cypilot generate-agents \u003Cname>` | After explicit user confirmation, run `{cpt_cmd} --json generate-agents --agent \u003Cname>` |\n| `cypilot workspace init` | After explicit user confirmation, run `{cpt_cmd} --json workspace-init [--root \u003Cdir>] [--output \u003Cpath>] [--inline] [--force] [--max-depth \u003CN>] [--dry-run]` |\n| `cypilot workspace add` | After explicit user confirmation, run `{cpt_cmd} --json workspace-add --name \u003Cname> (--path \u003Cpath> \\| --url \u003Curl>) [--branch \u003Cbranch>] [--role \u003Crole>] [--adapter \u003Cpath>] [--inline] [--force]` |\n| `cypilot workspace info` | Run `{cpt_cmd} --json workspace-info` |\n| `cypilot workspace sync` | After explicit user confirmation, run `{cpt_cmd} --json workspace-sync [--source \u003Cname>] [--dry-run] [--force]`; `--force` is destructive |\n\n### Workflow Shortcuts\n\n| User invocation | Action |\n|---|---|\n| `cypilot auto-config` \u002F `cypilot configure` | Open and follow `{cypilot_path}\u002F.core\u002Fworkflows\u002Fgenerate.md` |\n\n## Workflow Routing\n\nCypilot has exactly three core workflows plus specialized sub-workflows and dedicated capability agents. Routing priority is `delegate` > `compile-phase` > `execute-phase` > `plan` > `generate`\u002F`analyze`. Delegation intent MUST route to the `cypilot-ralphex` capability agent rather than falling through to generic planning or generation. Generated-plan phase compilation intent MUST route to the dedicated `cypilot-phase-compiler` capability agent, and generated-plan phase execution intent MUST route to the dedicated `cypilot-phase-runner` capability agent rather than back into generic planning.\n\nOversized-input invariant: if the raw task input exceeds `500` total lines across the direct prompt text, attached or provided files, or one large file, Cypilot MUST route through `\u002Fcypilot-plan` before any direct `\u002Fcypilot-generate` or `\u002Fcypilot-analyze` execution. The planner MUST first compute the input signature using the read-only `{cpt_cmd} --json chunk-input ... --dry-run` mode (which writes no files) to check for existing package reuse, and MUST obtain explicit user approval before materializing that input under `{cypilot_path}\u002F.plans\u002F{task-slug}\u002Finput\u002F` using the write-capable `{cpt_cmd} --json chunk-input ... --max-lines 300 --threshold-lines 500` command (without `--dry-run`). The planner MUST pass `--include-stdin` when direct prompt text must be packaged together with provided files; when stdin is used, it MUST also preserve that raw prompt as `input\u002Fdirect-prompt.md`. The emitted chunk files become mandatory plan inputs for the relevant phases.\n\nCompletion invariants for workflow outputs:\n- A `\u002Fcypilot-plan` run is not complete until it reaches one of three valid stopping points defined by `workflows\u002Fplan.md`: `(a)` the raw-input approval checkpoint, where the planner has identified oversized input and presented the `Proceed with raw-input materialization? [y\u002Fn]` prompt — the user may approve (`y`) to continue or reject (`n`) to cancel the plan with no filesystem mutations; `(b)` the brief checkpoint where `plan.toml` and every required `brief-*` file exist on disk and the response presents the explicit next-step choice set; or `(c)` the fully compiled plan state where every corresponding `phase-*` file also exists on disk after the user chose inline generation or `cypilot-phase-compiler` execution.\n- A `\u002Fcypilot-generate` run that wrote or updated any files is not complete until the final response includes both `Plan Review Prompt` and `Direct Review Prompt` blocks. This applies on both the validated success path and the RELAXED explicitly unvalidated recovery path.\n- A `\u002Fcypilot-analyze` run with any actionable issue is not complete until the final response includes both `Fix Prompt` and `Plan Prompt` blocks.\n- A `\u002Fcypilot delegate` run is not complete until the final response includes delegation status, handoff result or error details, and next-step options.\n- A native plan-phase compilation run is not complete until the final response includes compiled phase identity, output file path, and compile-time validation outcome.\n- A native plan-phase execution run is not complete until the final response includes executed phase status, manifest update outcome, and the next-phase handoff or recovery action.\n- MUST NOT end a workflow response immediately after the summary, analysis report, or next-step options when one of the required prompt pairs is still missing.\n\n| Intent | Match | Action |\n|---|---|---|\n| Delegate | `delegate`, `delegate to ralphex`, `ralphex execute`, `ralphex review`, `hand off to ralphex`, `run with ralphex`, `ralphex delegation` | Open and follow `{cypilot_path}\u002F.core\u002Fskills\u002Fcypilot\u002Fagents\u002Fcypilot-ralphex.md` |\n| Compile phase | `compile phase`, `compile next phase`, `compile plan phase`, `generate phase file`, `compile from brief`, `build phase from brief` | Open and follow `{cypilot_path}\u002F.core\u002Fskills\u002Fcypilot\u002Fagents\u002Fcypilot-phase-compiler.md` |\n| Execute phase | `execute phase`, `run next phase`, `continue plan`, `resume plan`, `execute plan phase`, `run plan phase`, `execute the next phase` | Open and follow `{cypilot_path}\u002F.core\u002Fskills\u002Fcypilot\u002Fagents\u002Fcypilot-phase-runner.md` |\n| Plan | `plan`, `create a plan`, `execution plan`, `break down`, `decompose`, or `plan to ...` | Open and follow `{cypilot_path}\u002F.core\u002Fworkflows\u002Fplan.md` first |\n| Generate | `create`, `edit`, `fix`, `update`, `implement`, `refactor`, `delete`, `add`, `setup`, `configure`, `build`, `code` and user did not say `plan` | Open and follow `{cypilot_path}\u002F.core\u002Fworkflows\u002Fgenerate.md` |\n| Analyze | `analyze`, `validate`, `review`, `check`, `inspect`, `audit`, `compare`, `list`, `show`, `find` and user did not say `plan` | Open and follow `{cypilot_path}\u002F.core\u002Fworkflows\u002Fanalyze.md` |\n| Workspace | `workspace`, `multi-repo`, `add source`, `add repo`, `cross-reference`, `cross-repo` | Open and follow `{cypilot_path}\u002F.core\u002Fworkflows\u002Fworkspace.md` |\n| Unclear | `help`, `look at`, `work with`, `handle` | Ask `plan (phased execution) \u002F generate (modify) \u002F analyze (read-only)?` and stop if the user cancels |\n\n`configure` and `auto-config` are workflow shortcuts, not direct no-protocol commands; both route through `generate.md`, which may auto-trigger `requirements\u002Fauto-config.md` for brownfield projects with no project-specific rules.\n\n## Command Reference\n\nEntrypoint: `{cpt_cmd} \u003Ccommand> [options]`\nMachine output: add `--json` immediately after `{cpt_cmd}` and before the subcommand, except for `init`, `delegate`, and `update`, which MUST be run without `--json`. Exit codes: `0 = PASS`, `1 = filesystem\u002Fconfig error`, `2 = FAIL`.\nLegacy aliases: `validate-code` = `validate`; `validate-rules` = `validate-kits`.\n\n| Category | Commands |\n|---|---|\n| Validation | `{cpt_cmd} --json validate` (artifacts + code), `{cpt_cmd} --json validate-kits` (kit config), `{cpt_cmd} --json validate-toc` (TOC integrity), `{cpt_cmd} --json self-check` (template\u002Fexample sync), `{cpt_cmd} --json spec-coverage` (marker coverage) |\n| Search | `{cpt_cmd} --json list-ids` (enumerate IDs), `{cpt_cmd} --json list-id-kinds` (kind counts), `{cpt_cmd} --json get-content` (fetch by ID), `{cpt_cmd} --json where-defined` (definition), `{cpt_cmd} --json where-used` (references) |\n| Kit management | `{cpt_cmd} --json kit install` (install kit), `{cpt_cmd} --json kit update` (file-level kit update) |\n| Delegation | `{cpt_cmd} delegate \u003Cplan_dir>` (compile and delegate plan to ralphex; MUST run without `--json`) |\n| Utilities | `{cpt_cmd} --json toc` (generate TOC), `{cpt_cmd} --json chunk-input` (chunk oversized workflow input into `input\u002F` files), `{cpt_cmd} --json info` (discover config), `{cpt_cmd} --json resolve-vars` (expand template vars), `{cpt_cmd} init` (bootstrap project; MUST run without `--json`), `{cpt_cmd} update` (refresh adapter; MUST run without `--json`), `{cpt_cmd} --json agents` (show generated integrations), `{cpt_cmd} --json generate-agents` (generate\u002Fupdate integrations) |\n| Migration | `{cpt_cmd} --json migrate` (v2→v3 project), `{cpt_cmd} --json migrate-config` (JSON→TOML config) |\n| Workspace | `{cpt_cmd} --json workspace-init` (create workspace), `{cpt_cmd} --json workspace-add` (add source), `{cpt_cmd} --json workspace-info` (status), `{cpt_cmd} --json workspace-sync` (update Git sources) |\n\nSee `skills\u002Fcypilot\u002Fcypilot.clispec` for full syntax, arguments, options, exit semantics, and examples.\n\n### Validation Commands\n\n#### validate\n```bash\nvalidate [--artifact \u003Cpath>] [--skip-code] [--verbose] [--output \u003Cpath>] [--local-only] [--source \u003Cname>]\n```\nValidates artifacts and code with deterministic checks (structure, cross-refs, task statuses, traceability markers — pairing, coverage, orphans). Use `--local-only` to skip cross-repo workspace validation. Use `--source \u003Cname>` to validate a specific workspace source. Note: `--local-only` and `--source` are independent and can be combined — `--source` narrows which artifacts are validated, `--local-only` controls whether cross-repo IDs are included as reference context.\n\nLegacy aliases: `validate-code` (same behavior), `validate-rules` (alias for `validate-kits`).\n\n#### validate-kits\n```bash\nvalidate-kits [--kit \u003Cid>] [--template \u003Cpath>] [--verbose]\n```\nValidates kit configuration — template frontmatter, constraints, resource paths.\n\n#### validate-toc\n```bash\nvalidate-toc \u003Cfiles...> [--max-level \u003CN>] [--verbose]\n```\nValidates Table of Contents in Markdown files — TOC exists, anchors point to real headings, all headings covered, not stale.\n\n#### self-check\n```bash\nself-check [--kit \u003Cid>] [--verbose]\n```\nValidates example artifacts against their templates (template QA). Ensures templates and examples remain synchronized.\n\n#### spec-coverage\n```bash\nspec-coverage [--system \u003Cslug>] [--min-coverage \u003CN>] [--min-file-coverage \u003CN>] [--min-granularity \u003CN>] [--verbose] [--output \u003Cpath>]\n```\nMeasures CDSL marker coverage in codebase files. Reports coverage percentage, granularity score, per-file details, and uncovered line ranges. Use `--system` to limit to specific system slug(s). Use `--min-file-coverage` to enforce per-file minimum.\n\n### Search Commands\n\n#### list-ids\n```bash\nlist-ids [--artifact \u003Cpath>] [--pattern \u003Cstring>] [--regex] [--kind \u003Cstring>] [--all] [--include-code] [--source \u003Cname>]\n```\nLists all Cypilot IDs from registered artifacts. Supports filtering by pattern, kind, and optional code scanning. Use `--source \u003Cname>` to list IDs from a specific workspace source.\n\n#### list-id-kinds\n```bash\nlist-id-kinds [--artifact \u003Cpath>]\n```\nLists ID kinds that exist in artifacts with counts and template mappings.\n\n#### get-content\n```bash\nget-content (--artifact \u003Cpath> | --code \u003Cpath>) --id \u003Cstring> [--inst \u003Cstring>]\n```\nRetrieves content block for a specific Cypilot ID from artifacts or code files.\n\n#### where-defined\n```bash\nwhere-defined --id \u003Cid> [--artifact \u003Cpath>]\n```\nFinds where a Cypilot ID is defined.\n\n#### where-used\n```bash\nwhere-used --id \u003Cid> [--artifact \u003Cpath>] [--include-definitions]\n```\nFinds all references to a Cypilot ID.\n\n### Kit Management Commands\n\n#### kit install\n```bash\nkit install \u003Csource-path> [--dry-run] [--yes]\n```\nInstalls a kit from a source directory. Copies kit files to `config\u002Fkits\u002F{slug}\u002F`.\n\n#### kit update\n```bash\nkit update [--kit \u003Cslug>] [--dry-run] [--yes] [--auto-approve]\n```\nUpdates kit files in `config\u002Fkits\u002F{slug}\u002F` with file-level diff. Interactive prompts for modified files: accept\u002Fdecline\u002Faccept-all\u002Fdecline-all.\n\n### Utility Commands\n\n#### toc\n```bash\ntoc \u003Cfiles...> [--max-level \u003CN>] [--indent \u003CN>] [--dry-run] [--skip-validate]\n```\nGenerates or updates Table of Contents in Markdown files between `\u003C!-- toc -->` markers.\n\n#### info\n```bash\ninfo [--root \u003Cpath>] [--cypilot-root \u003Cpath>]\n```\nDiscovers Cypilot configuration and shows project status (cypilot_dir, project_name, specs, kits). Includes a `variables` dict mapping all template variables to absolute paths.\n\n#### resolve-vars\n```bash\nresolve-vars [--root \u003Cpath>] [--kit \u003Cslug>] [--flat]\n```\nResolves all template variables (`{adr_template}`, `{scripts}`, etc.) to absolute file paths. Sources: system variables (`cypilot_path`, `project_root`) + kit resource bindings from `core.toml`. Use `--kit` to filter to a single kit. Use `--flat` for a plain variable→path dict.\n\n#### init\n```bash\ninit [--project-root \u003Cpath>] [--cypilot-root \u003Cpath>] [--project-name \u003Cstring>] [--yes] [--dry-run] [--force]\n```\nInitializes Cypilot config directory (`.core\u002F`, `.gen\u002F`, `config\u002F`) and root `AGENTS.md`.\n\n#### update\n```bash\nupdate [--source \u003Cpath>] [--force] [--dry-run]\n```\nUpdates `.core\u002F` from cache, updates kit files in `config\u002Fkits\u002F` with file-level diff, regenerates `.gen\u002F` aggregates, ensures `config\u002F` scaffold.\n\n#### agents\n```bash\nagents [--agent \u003Cname>] [--root \u003Cpath>] [--cypilot-root \u003Cpath>]\n```\nShows generated agent integration status. Read-only dry-run — reports which integration files currently exist or would be created\u002Fupdated for each supported agent without writing anything.\nSupported: windsurf, cursor, claude, copilot, openai.\n\n#### generate-agents\n```bash\ngenerate-agents [--agent \u003Cname>] [--root \u003Cpath>] [--cypilot-root \u003Cpath>] [--dry-run] [--yes] [--show-layers] [--discover]\n```\nGenerates agent-specific workflow proxies and skill entry points.\nSupported: windsurf, cursor, claude, copilot, openai.\n\nGenerates workflow commands, skill outputs, and **subagents** (isolated agent definitions with scoped tools and dedicated prompts). Two subagents are created for tools that support them: `cypilot-codegen` (full write access, worktree isolation) and `cypilot-pr-review` (read-only). Windsurf does not support subagents and is gracefully skipped.\n\nUse `--show-layers` to display layer provenance report instead of generating. Use `--discover` to scan conventional dirs and populate `manifest.toml` before generating.\n\nShortcut: `generate-agents --openai`\n\n### Migration Commands\n\n#### migrate\n```bash\nmigrate [--project-root \u003Cpath>] [--cypilot-root \u003Cpath>] [--dry-run] [--yes]\n```\nMigrates Cypilot v2 projects to v3 (adapter-based → blueprint-based, artifacts.json → artifacts.toml, three-directory layout).\n\n#### migrate-config\n```bash\nmigrate-config [--project-root \u003Cpath>] [--dry-run]\n```\nConverts legacy JSON config files to TOML format.\n\n### Workspace Commands\n\nWorkspaces are either **standalone** (`.cypilot-workspace.toml` at project root) or **inline** (`[workspace]` section in `config\u002Fcore.toml`). The two types cannot be mixed.\n\n#### workspace-init\n```bash\nworkspace-init [--root \u003Cdir>] [--output \u003Cpath>] [--inline] [--force] [--max-depth \u003CN>] [--dry-run]\n```\nInitialize a multi-repo workspace by scanning nested sub-directories for repos with cypilot directories. Rejects cross-type conflicts (inline vs standalone) and requires `--force` to reinitialize an existing workspace. Scanning depth is limited by `--max-depth` (default 3) to prevent unbounded traversal; symlinks are skipped.\n\n#### workspace-add\n```bash\nworkspace-add --name \u003Cname> (--path \u003Cpath> | --url \u003Curl>) [--branch \u003Cbranch>] [--role \u003Crole>] [--adapter \u003Cpath>] [--inline] [--force]\n```\nAdd a source to a workspace config. Auto-detects standalone vs inline workspace. Use `--inline` to force adding to `config\u002Fcore.toml`. Git URL sources are not supported in inline mode. `--path` is validated at add-time; returns error if directory not found. Returns error if source name already exists unless `--force` is specified.\n\n#### workspace-info\n```bash\nworkspace-info\n```\nDisplay workspace config, list sources, show per-source status (cypilot dir found, artifact count, reachability).\n\n#### workspace-sync\n```bash\nworkspace-sync [--source \u003Cname>] [--dry-run] [--force]\n```\nFetch and update worktrees for Git URL sources. Use `--source` to sync a single source. Use `--dry-run` to preview without network operations. Use `--force` to skip dirty worktree check (**WARNING: DESTRUCTIVE** — uncommitted changes will be discarded via `git reset --hard` and local commits may be lost via `git checkout -B`). Local path sources are skipped. Source resolution does not perform network operations for existing repos — use `workspace-sync` to explicitly update.\n\n---\n\n## Auto-Configuration\n\nUse auto-config after `cypilot init` on a brownfield project, when project conventions are unknown, or after major structural changes. It scans structure\u002Fconventions, generates `{cypilot_path}\u002Fconfig\u002Frules\u002F{slug}.md`, adds WHEN rules to `{cypilot_path}\u002Fconfig\u002FAGENTS.md`, and registers systems in `{cypilot_path}\u002Fconfig\u002Fartifacts.toml`. Invoke via `cypilot auto-config`, `cypilot configure`, or the automatic offer inside `generate.md`.\n\n## Project Configuration\n\nProject configuration lives in `{cypilot_path}\u002Fconfig\u002Fcore.toml` (systems, kits, ignore lists). Artifact registry lives in `{cypilot_path}\u002Fconfig\u002Fartifacts.toml` (artifact paths, kinds, system mappings, codebase paths, autodetect rules). All commands output JSON when invoked with `--json`. Exit codes: 0=PASS, 1=filesystem error, 2=FAIL.\n","# Cypilot Unified Tool\n\n\n\u003C!-- toc -->\n\n- [Cypilot Unified Tool](#cypilot-unified-tool)\n  - [Goal](#goal)\n  - [Preconditions](#preconditions)\n  - [⚠️ MUST Instruction Semantics ⚠️](#️-must-instruction-semantics-️)\n  - [Agent Acknowledgment](#agent-acknowledgment)\n  - [Execution Logging](#execution-logging)\n  - [Variables](#variables)\n    - [Template Variable Resolution](#template-variable-resolution)\n  - [CLI Resolution](#cli-resolution)\n  - [Protocol Guard](#protocol-guard)\n  - [Cypilot Mode](#cypilot-mode)\n  - [Agent-Safe Invocation](#agent-safe-invocation)\n  - [Quick Commands](#quick-commands)\n    - [Direct CLI Commands (No Workflow Routing)](#direct-cli-commands-no-workflow-routing)\n    - [Workflow Shortcuts](#workflow-shortcuts)\n  - [Workflow Routing](#workflow-routing)\n  - [Command Reference](#command-reference)\n  - [Auto-Configuration](#auto-configuration)\n  - [Project Configuration](#project-configuration)\n\n\u003C!-- \u002Ftoc -->\n\n## Goal\n\nCypilot provides artifact validation, cross-reference validation, code traceability, spec coverage measurement, ID search\u002Fnavigation, kit management, TOC generation\u002Fvalidation, multi-agent integration, and design-to-code implementation with `@cpt-*` markers.\n\n## Preconditions\n\n- `cpt` available (preferred) or `python3` as fallback\n- Target paths exist and are readable\n\n---\n\n## ⚠️ MUST Instruction Semantics ⚠️\n\n**MUST** and **ALWAYS** are mandatory. Skipping any MUST instruction invalidates execution, the output must be discarded, and the workflow fails.\n\n## Agent Acknowledgment\n\n- [ ] MUST\u002FALWAYS are mandatory; skipping any MUST invalidates execution.\n- [ ] I will read all required files before proceeding.\n- [ ] I will follow workflows step-by-step without shortcuts.\n- [ ] I will not create or modify files, or execute any other write-capable Cypilot command, without explicit user confirmation, and I will not add auto-approval flags unless the user explicitly asks for them.\n- [ ] I will list Cypilot files read, why, and the triggering instruction before any approval prompt.\n\nBy proceeding with Cypilot work, I acknowledge and accept these requirements.\n\nALWAYS SET {cypilot_mode} = `on` FIRST when loading this skill\n\n## Execution Logging\n\nALWAYS provide execution visibility:\n- Notify the user when entering any H2 section of a Cypilot prompt.\n- Notify the user when completing any `- [ ]` checklist task.\n- Use `- [CONTEXT]: MESSAGE`; set context to the file\u002Fsection and message to the action + why.\n- Logging must help the user understand loaded prompts, routing decisions, debugging state, and workflow progress.\n\nExample:\n```text\n- [execution-protocol]: Entering \"Load Rules\" — target is CODE, loading codebase\u002Frules.md\n- [DESIGN rules]: Completing \"Validate structure\" — all required sections present\n- [workflows\u002Fgenerate.md]: Entering \"Determine Target\" — user requested code implementation\n```\n\n## Variables\n\n| Variable | Value | Use |\n|---|---|---|\n| `{cypilot_path}` | Directory path resolved from root `AGENTS.md` | Base path for all Cypilot-relative references |\n| `{cypilot_mode}` | `on` or `off` | Current Cypilot mode state |\n| `{cpt_cmd}` | `cpt` or `python3 {cypilot_path}\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot.py` | Resolved CLI entrypoint |\n| `{cpt_installed}` | `true` or `false` | Whether the `cpt` CLI is available |\n\nSetting `{cypilot_mode}`: explicit `cypilot on\u002Foff` or a prompt that activates\u002Fdeactivates Cypilot workflows.\n\n### Template Variable Resolution\n\n- Resolve variables from `{cpt_cmd} --json info` first; parse the returned `variables` dict.\n- Use `{cpt_cmd} --json resolve-vars` only when a fresh or filtered map is needed.\n- Variable sources: system (`cypilot_path`, `project_root`) + installed kit resources.\n- ALWAYS resolve `{variable}` references to absolute paths before using kit markdown files.\n\n## CLI Resolution\n\nRun before Protocol Guard when `{cypilot_mode}` is `on`:\n1. `command -v cpt` → `{cpt_cmd} = cpt`, `{cpt_installed} = true`\n2. Otherwise `{cpt_cmd} = python3 {cypilot_path}\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot.py`, `{cpt_installed} = false`\n3. If `cpt` is missing and `~\u002F.cypilot\u002Fcache\u002Fcpt-prompt-dismissed` does not exist, offer `pipx install git+https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Fcyber-pilot.git`; on dismiss create the marker file\n4. Re-offer installation if the user later asks about the long invocation path\n\nALWAYS use `{cpt_cmd}` for all later CLI invocations.\n\n## Protocol Guard\n\n- ALWAYS FIRST open and remember `{cypilot_path}\u002F.gen\u002FAGENTS.md`\n- ALWAYS open and follow `{cypilot_path}\u002Fconfig\u002FAGENTS.md` when it exists\n- ALWAYS open and follow `{cypilot_path}\u002F.gen\u002FSKILL.md` when it exists\n- ALWAYS open and follow `{cypilot_path}\u002Fconfig\u002FSKILL.md` when it exists\n- ALWAYS FIRST run `{cpt_cmd} --json info` before any Cypilot workflow action\n- ALWAYS store the `variables` dict from `info` output and use it to resolve `{variable}` references in AGENTS\u002FSKILL\u002Frules\u002Fworkflows\n- ALWAYS follow this load order: `info` → registry\u002Fintent\u002Ftarget\u002Frules resolution from `execution-protocol.md` → matched WHEN-clause specs\n- ALWAYS load matched WHEN-clause specs only after registry understanding, target determination, and `rules.md` resolution provide enough context to match safely\n- ALWAYS FIRST parse and load all matched WHEN-clause specs before proceeding\n- MUST NOT preload every AGENTS\u002FSKILL\u002Fspec file up front; load only the smallest set needed for the current request\n- Before opening a large AGENTS\u002FSKILL\u002Fspec file, estimate size and prefer chunked reads of matched sections over full-file reads\n- If safe WHEN-clause matching is not yet possible, stop after registry\u002Ftarget\u002Frules resolution and continue only when enough context exists to load specs boundedly\n- If required Protocol Guard context would exceed the current turn budget, checkpoint or escalate instead of proceeding with partial or unbounded spec loading\n- ALWAYS include this block when editing code:\n```text\nCypilot Context:\n- Cypilot: {path}\n- Target: {artifact|codebase}\n- Specs loaded: {list paths or \"none required\"}\n```\n- ALWAYS stop and re-run Protocol Guard when required specs should have been loaded but were not\n\n## Cypilot Mode\n\n- ALWAYS set `{cypilot_mode} = on` first when user invokes `cypilot {prompt}`\n- ALWAYS run `info` when enabling Cypilot mode\n- ALWAYS show:\n```text\nCypilot Mode Enabled\nCypilot: {FOUND at path | NOT_FOUND}\n```\n\n## Agent-Safe Invocation\n\n- ALWAYS use `{cpt_cmd} --json \u003Csubcommand> [options]` for agent-driven CLI calls unless a command-specific exception below says otherwise\n- ALWAYS pass `--json` immediately after `{cpt_cmd}` and before the subcommand when using machine-output mode\n- EXCEPTION: NEVER run `{cpt_cmd} init` with `--json`; always invoke `{cpt_cmd} init ...` without `--json`\n- EXCEPTION: NEVER run `{cpt_cmd} delegate` with `--json`; always invoke `{cpt_cmd} delegate \u003Cplan_dir> ...` without `--json`\n- EXCEPTION: NEVER run `{cpt_cmd} update` with `--json`; always invoke `{cpt_cmd} update ...` without `--json`\n- ALWAYS use `=` form for pattern args starting with `-` (example: `--pattern=-req-`)\n- MUST obtain explicit user confirmation before executing any write-capable command, including direct CLI commands that do not route through a workflow\n- MUST NOT add auto-approval flags such as `--yes`, `-y`, or `--force` to write-capable commands unless the user explicitly requested that non-interactive behavior\n\n## Quick Commands\n\n### Direct CLI Commands (No Workflow Routing)\n\nNo workflow routing skips workflow selection only. It does not waive confirmation: obtain explicit user confirmation before executing any write-capable direct CLI command below.\n\n| User invocation | Direct action |\n|---|---|\n| `cypilot init` | After explicit user confirmation, run `{cpt_cmd} init` without `--json` |\n| `cypilot update` | After explicit user confirmation, run `{cpt_cmd} update` without `--json` |\n| `cypilot agents \u003Cname>` | Run `{cpt_cmd} --json agents --agent \u003Cname>` |\n| `cypilot generate-agents \u003Cname>` | After explicit user confirmation, run `{cpt_cmd} --json generate-agents --agent \u003Cname>` |\n| `cypilot workspace init` | After explicit user confirmation, run `{cpt_cmd} --json workspace-init [--root \u003Cdir>] [--output \u003Cpath>] [--inline] [--force] [--max-depth \u003CN>] [--dry-run]` |\n| `cypilot workspace add` | After explicit user confirmation, run `{cpt_cmd} --json workspace-add --name \u003Cname> (--path \u003Cpath> \\| --url \u003Curl>) [--branch \u003Cbranch>] [--role \u003Crole>] [--adapter \u003Cpath>] [--inline] [--force]` |\n| `cypilot workspace info` | Run `{cpt_cmd} --json workspace-info` |\n| `cypilot workspace sync` | After explicit user confirmation, run `{cpt_cmd} --json workspace-sync [--source \u003Cname>] [--dry-run] [--force]`; `--force` is destructive |\n\n### Workflow Shortcuts\n\n| User invocation | Action |\n|---|---|\n| `cypilot auto-config` \u002F `cypilot configure` | Open and follow `{cypilot_path}\u002F.core\u002Fworkflows\u002Fgenerate.md` |\n\n## Workflow Routing\n\nCypilot has exactly three core workflows plus specialized sub-workflows and dedicated capability agents. Routing priority is `delegate` > `compile-phase` > `execute-phase` > `plan` > `generate`\u002F`analyze`. Delegation intent MUST route to the `cypilot-ralphex` capability agent rather than falling through to generic planning or generation. Generated-plan phase compilation intent MUST route to the dedicated `cypilot-phase-compiler` capability agent, and generated-plan phase execution intent MUST route to the dedicated `cypilot-phase-runner` capability agent rather than back into generic planning.\n\nOversized-input invariant: if the raw task input exceeds `500` total lines across the direct prompt text, attached or provided files, or one large file, Cypilot MUST route through `\u002Fcypilot-plan` before any direct `\u002Fcypilot-generate` or `\u002Fcypilot-analyze` execution. The planner MUST first compute the input signature using the read-only `{cpt_cmd} --json chunk-input ... --dry-run` mode (which writes no files) to check for existing package reuse, and MUST obtain explicit user approval before materializing that input under `{cypilot_path}\u002F.plans\u002F{task-slug}\u002Finput\u002F` using the write-capable `{cpt_cmd} --json chunk-input ... --max-lines 300 --threshold-lines 500` command (without `--dry-run`). The planner MUST pass `--include-stdin` when direct prompt text must be packaged together with provided files; when stdin is used, it MUST also preserve that raw prompt as `input\u002Fdirect-prompt.md`. The emitted chunk files become mandatory plan inputs for the relevant phases.\n\nCompletion invariants for workflow outputs:\n- A `\u002Fcypilot-plan` run is not complete until it reaches one of three valid stopping points defined by `workflows\u002Fplan.md`: `(a)` the raw-input approval checkpoint, where the planner has identified oversized input and presented the `Proceed with raw-input materialization? [y\u002Fn]` prompt — the user may approve (`y`) to continue or reject (`n`) to cancel the plan with no filesystem mutations; `(b)` the brief checkpoint where `plan.toml` and every required `brief-*` file exist on disk and the response presents the explicit next-step choice set; or `(c)` the fully compiled plan state where every corresponding `phase-*` file also exists on disk after the user chose inline generation or `cypilot-phase-compiler` execution.\n- A `\u002Fcypilot-generate` run that wrote or updated any files is not complete until the final response includes both `Plan Review Prompt` and `Direct Review Prompt` blocks. This applies on both the validated success path and the RELAXED explicitly unvalidated recovery path.\n- A `\u002Fcypilot-analyze` run with any actionable issue is not complete until the final response includes both `Fix Prompt` and `Plan Prompt` blocks.\n- A `\u002Fcypilot delegate` run is not complete until the final response includes delegation status, handoff result or error details, and next-step options.\n- A native plan-phase compilation run is not complete until the final response includes compiled phase identity, output file path, and compile-time validation outcome.\n- A native plan-phase execution run is not complete until the final response includes executed phase status, manifest update outcome, and the next-phase handoff or recovery action.\n- MUST NOT end a workflow response immediately after the summary, analysis report, or next-step options when one of the required prompt pairs is still missing.\n\n| Intent | Match | Action |\n|---|---|---|\n| Delegate | `delegate`, `delegate to ralphex`, `ralphex execute`, `ralphex review`, `hand off to ralphex`, `run with ralphex`, `ralphex delegation` | Open and follow `{cypilot_path}\u002F.core\u002Fskills\u002Fcypilot\u002Fagents\u002Fcypilot-ralphex.md` |\n| Compile phase | `compile phase`, `compile next phase`, `compile plan phase`, `generate phase file`, `compile from brief`, `build phase from brief` | Open and follow `{cypilot_path}\u002F.core\u002Fskills\u002Fcypilot\u002Fagents\u002Fcypilot-phase-compiler.md` |\n| Execute phase | `execute phase`, `run next phase`, `continue plan`, `resume plan`, `execute plan phase`, `run plan phase`, `execute the next phase` | Open and follow `{cypilot_path}\u002F.core\u002Fskills\u002Fcypilot\u002Fagents\u002Fcypilot-phase-runner.md` |\n| Plan | `plan`, `create a plan`, `execution plan`, `break down`, `decompose`, or `plan to ...` | Open and follow `{cypilot_path}\u002F.core\u002Fworkflows\u002Fplan.md` first |\n| Generate | `create`, `edit`, `fix`, `update`, `implement`, `refactor`, `delete`, `add`, `setup`, `configure`, `build`, `code` and user did not say `plan` | Open and follow `{cypilot_path}\u002F.core\u002Fworkflows\u002Fgenerate.md` |\n| Analyze | `analyze`, `validate`, `review`, `check`, `inspect`, `audit`, `compare`, `list`, `show`, `find` and user did not say `plan` | Open and follow `{cypilot_path}\u002F.core\u002Fworkflows\u002Fanalyze.md` |\n| Workspace | `workspace`, `multi-repo`, `add source`, `add repo`, `cross-reference`, `cross-repo` | Open and follow `{cypilot_path}\u002F.core\u002Fworkflows\u002Fworkspace.md` |\n| Unclear | `help`, `look at`, `work with`, `handle` | Ask `plan (phased execution) \u002F generate (modify) \u002F analyze (read-only)?` and stop if the user cancels |\n\n`configure` and `auto-config` are workflow shortcuts, not direct no-protocol commands; both route through `generate.md`, which may auto-trigger `requirements\u002Fauto-config.md` for brownfield projects with no project-specific rules.\n\n## Command Reference\n\nEntrypoint: `{cpt_cmd} \u003Ccommand> [options]`\nMachine output: add `--json` immediately after `{cpt_cmd}` and before the subcommand, except for `init`, `delegate`, and `update`, which MUST be run without `--json`. Exit codes: `0 = PASS`, `1 = filesystem\u002Fconfig error`, `2 = FAIL`.\nLegacy aliases: `validate-code` = `validate`; `validate-rules` = `validate-kits`.\n\n| Category | Commands |\n|---|---|\n| Validation | `{cpt_cmd} --json validate` (artifacts + code), `{cpt_cmd} --json validate-kits` (kit config), `{cpt_cmd} --json validate-toc` (TOC integrity), `{cpt_cmd} --json self-check` (template\u002Fexample sync), `{cpt_cmd} --json spec-coverage` (marker coverage) |\n| Search | `{cpt_cmd} --json list-ids` (enumerate IDs), `{cpt_cmd} --json list-id-kinds` (kind counts), `{cpt_cmd} --json get-content` (fetch by ID), `{cpt_cmd} --json where-defined` (definition), `{cpt_cmd} --json where-used` (references) |\n| Kit management | `{cpt_cmd} --json kit install` (install kit), `{cpt_cmd} --json kit update` (file-level kit update) |\n| Delegation | `{cpt_cmd} delegate \u003Cplan_dir>` (compile and delegate plan to ralphex; MUST run without `--json`) |\n| Utilities | `{cpt_cmd} --json toc` (generate TOC), `{cpt_cmd} --json chunk-input` (chunk oversized workflow input into `input\u002F` files), `{cpt_cmd} --json info` (discover config), `{cpt_cmd} --json resolve-vars` (expand template vars), `{cpt_cmd} init` (bootstrap project; MUST run without `--json`), `{cpt_cmd} update` (refresh adapter; MUST run without `--json`), `{cpt_cmd} --json agents` (show generated integrations), `{cpt_cmd} --json generate-agents` (generate\u002Fupdate integrations) |\n| Migration | `{cpt_cmd} --json migrate` (v2→v3 project), `{cpt_cmd} --json migrate-config` (JSON→TOML config) |\n| Workspace | `{cpt_cmd} --json workspace-init` (create workspace), `{cpt_cmd} --json workspace-add` (add source), `{cpt_cmd} --json workspace-info` (status), `{cpt_cmd} --json workspace-sync` (update Git sources) |\n\nSee `skills\u002Fcypilot\u002Fcypilot.clispec` for full syntax, arguments, options, exit semantics, and examples.\n\n### Validation Commands\n\n#### validate\n```bash\nvalidate [--artifact \u003Cpath>] [--skip-code] [--verbose] [--output \u003Cpath>] [--local-only] [--source \u003Cname>]\n```\nValidates artifacts and code with deterministic checks (structure, cross-refs, task statuses, traceability markers — pairing, coverage, orphans). Use `--local-only` to skip cross-repo workspace validation. Use `--source \u003Cname>` to validate a specific workspace source. Note: `--local-only` and `--source` are independent and can be combined — `--source` narrows which artifacts are validated, `--local-only` controls whether cross-repo IDs are included as reference context.\n\nLegacy aliases: `validate-code` (same behavior), `validate-rules` (alias for `validate-kits`).\n\n#### validate-kits\n```bash\nvalidate-kits [--kit \u003Cid>] [--template \u003Cpath>] [--verbose]\n```\nValidates kit configuration — template frontmatter, constraints, resource paths.\n\n#### validate-toc\n```bash\nvalidate-toc \u003Cfiles...> [--max-level \u003CN>] [--verbose]\n```\nValidates Table of Contents in Markdown files — TOC exists, anchors point to real headings, all headings covered, not stale.\n\n#### self-check\n```bash\nself-check [--kit \u003Cid>] [--verbose]\n```\nValidates example artifacts against their templates (template QA). Ensures templates and examples remain synchronized.\n\n#### spec-coverage\n```bash\nspec-coverage [--system \u003Cslug>] [--min-coverage \u003CN>] [--min-file-coverage \u003CN>] [--min-granularity \u003CN>] [--verbose] [--output \u003Cpath>]\n```\nMeasures CDSL marker coverage in codebase files. Reports coverage percentage, granularity score, per-file details, and uncovered line ranges. Use `--system` to limit to specific system slug(s). Use `--min-file-coverage` to enforce per-file minimum.\n\n### Search Commands\n\n#### list-ids\n```bash\nlist-ids [--artifact \u003Cpath>] [--pattern \u003Cstring>] [--regex] [--kind \u003Cstring>] [--all] [--include-code] [--source \u003Cname>]\n```\nLists all Cypilot IDs from registered artifacts. Supports filtering by pattern, kind, and optional code scanning. Use `--source \u003Cname>` to list IDs from a specific workspace source.\n\n#### list-id-kinds\n```bash\nlist-id-kinds [--artifact \u003Cpath>]\n```\nLists ID kinds that exist in artifacts with counts and template mappings.\n\n#### get-content\n```bash\nget-content (--artifact \u003Cpath> | --code \u003Cpath>) --id \u003Cstring> [--inst \u003Cstring>]\n```\nRetrieves content block for a specific Cypilot ID from artifacts or code files.\n\n#### where-defined\n```bash\nwhere-defined --id \u003Cid> [--artifact \u003Cpath>]\n```\nFinds where a Cypilot ID is defined.\n\n#### where-used\n```bash\nwhere-used --id \u003Cid> [--artifact \u003Cpath>] [--include-definitions]\n```\nFinds all references to a Cypilot ID.\n\n### Kit Management Commands\n\n#### kit install\n```bash\nkit install \u003Csource-path> [--dry-run] [--yes]\n```\nInstalls a kit from a source directory. Copies kit files to `config\u002Fkits\u002F{slug}\u002F`.\n\n#### kit update\n```bash\nkit update [--kit \u003Cslug>] [--dry-run] [--yes] [--auto-approve]\n```\nUpdates kit files in `config\u002Fkits\u002F{slug}\u002F` with file-level diff. Interactive prompts for modified files: accept\u002Fdecline\u002Faccept-all\u002Fdecline-all.\n\n### Utility Commands\n\n#### toc\n```bash\ntoc \u003Cfiles...> [--max-level \u003CN>] [--indent \u003CN>] [--dry-run] [--skip-validate]\n```\nGenerates or updates Table of Contents in Markdown files between `\u003C!-- toc -->` markers.\n\n#### info\n```bash\ninfo [--root \u003Cpath>] [--cypilot-root \u003Cpath>]\n```\nDiscovers Cypilot configuration and shows project status (cypilot_dir, project_name, specs, kits). Includes a `variables` dict mapping all template variables to absolute paths.\n\n#### resolve-vars\n```bash\nresolve-vars [--root \u003Cpath>] [--kit \u003Cslug>] [--flat]\n```\nResolves all template variables (`{adr_template}`, `{scripts}`, etc.) to absolute file paths. Sources: system variables (`cypilot_path`, `project_root`) + kit resource bindings from `core.toml`. Use `--kit` to filter to a single kit. Use `--flat` for a plain variable→path dict.\n\n#### init\n```bash\ninit [--project-root \u003Cpath>] [--cypilot-root \u003Cpath>] [--project-name \u003Cstring>] [--yes] [--dry-run] [--force]\n```\nInitializes Cypilot config directory (`.core\u002F`, `.gen\u002F`, `config\u002F`) and root `AGENTS.md`.\n\n#### update\n```bash\nupdate [--source \u003Cpath>] [--force] [--dry-run]\n```\nUpdates `.core\u002F` from cache, updates kit files in `config\u002Fkits\u002F` with file-level diff, regenerates `.gen\u002F` aggregates, ensures `config\u002F` scaffold.\n\n#### agents\n```bash\nagents [--agent \u003Cname>] [--root \u003Cpath>] [--cypilot-root \u003Cpath>]\n```\nShows generated agent integration status. Read-only dry-run — reports which integration files currently exist or would be created\u002Fupdated for each supported agent without writing anything.\nSupported: windsurf, cursor, claude, copilot, openai.\n\n#### generate-agents\n```bash\ngenerate-agents [--agent \u003Cname>] [--root \u003Cpath>] [--cypilot-root \u003Cpath>] [--dry-run] [--yes] [--show-layers] [--discover]\n```\nGenerates agent-specific workflow proxies and skill entry points.\nSupported: windsurf, cursor, claude, copilot, openai.\n\nGenerates workflow commands, skill outputs, and **subagents** (isolated agent definitions with scoped tools and dedicated prompts). Two subagents are created for tools that support them: `cypilot-codegen` (full write access, worktree isolation) and `cypilot-pr-review` (read-only). Windsurf does not support subagents and is gracefully skipped.\n\nUse `--show-layers` to display layer provenance report instead of generating. Use `--discover` to scan conventional dirs and populate `manifest.toml` before generating.\n\nShortcut: `generate-agents --openai`\n\n### Migration Commands\n\n#### migrate\n```bash\nmigrate [--project-root \u003Cpath>] [--cypilot-root \u003Cpath>] [--dry-run] [--yes]\n```\nMigrates Cypilot v2 projects to v3 (adapter-based → blueprint-based, artifacts.json → artifacts.toml, three-directory layout).\n\n#### migrate-config\n```bash\nmigrate-config [--project-root \u003Cpath>] [--dry-run]\n```\nConverts legacy JSON config files to TOML format.\n\n### Workspace Commands\n\nWorkspaces are either **standalone** (`.cypilot-workspace.toml` at project root) or **inline** (`[workspace]` section in `config\u002Fcore.toml`). The two types cannot be mixed.\n\n#### workspace-init\n```bash\nworkspace-init [--root \u003Cdir>] [--output \u003Cpath>] [--inline] [--force] [--max-depth \u003CN>] [--dry-run]\n```\nInitialize a multi-repo workspace by scanning nested sub-directories for repos with cypilot directories. Rejects cross-type conflicts (inline vs standalone) and requires `--force` to reinitialize an existing workspace. Scanning depth is limited by `--max-depth` (default 3) to prevent unbounded traversal; symlinks are skipped.\n\n#### workspace-add\n```bash\nworkspace-add --name \u003Cname> (--path \u003Cpath> | --url \u003Curl>) [--branch \u003Cbranch>] [--role \u003Crole>] [--adapter \u003Cpath>] [--inline] [--force]\n```\nAdd a source to a workspace config. Auto-detects standalone vs inline workspace. Use `--inline` to force adding to `config\u002Fcore.toml`. Git URL sources are not supported in inline mode. `--path` is validated at add-time; returns error if directory not found. Returns error if source name already exists unless `--force` is specified.\n\n#### workspace-info\n```bash\nworkspace-info\n```\nDisplay workspace config, list sources, show per-source status (cypilot dir found, artifact count, reachability).\n\n#### workspace-sync\n```bash\nworkspace-sync [--source \u003Cname>] [--dry-run] [--force]\n```\nFetch and update worktrees for Git URL sources. Use `--source` to sync a single source. Use `--dry-run` to preview without network operations. Use `--force` to skip dirty worktree check (**WARNING: DESTRUCTIVE** — uncommitted changes will be discarded via `git reset --hard` and local commits may be lost via `git checkout -B`). Local path sources are skipped. Source resolution does not perform network operations for existing repos — use `workspace-sync` to explicitly update.\n\n---\n\n## Auto-Configuration\n\nUse auto-config after `cypilot init` on a brownfield project, when project conventions are unknown, or after major structural changes. It scans structure\u002Fconventions, generates `{cypilot_path}\u002Fconfig\u002Frules\u002F{slug}.md`, adds WHEN rules to `{cypilot_path}\u002Fconfig\u002FAGENTS.md`, and registers systems in `{cypilot_path}\u002Fconfig\u002Fartifacts.toml`. Invoke via `cypilot auto-config`, `cypilot configure`, or the automatic offer inside `generate.md`.\n\n## Project Configuration\n\nProject configuration lives in `{cypilot_path}\u002Fconfig\u002Fcore.toml` (systems, kits, ignore lists). Artifact registry lives in `{cypilot_path}\u002Fconfig\u002Fartifacts.toml` (artifact paths, kinds, system mappings, codebase paths, autodetect rules). All commands output JSON when invoked with `--json`. Exit codes: 0=PASS, 1=filesystem error, 2=FAIL.\n",{"name":5,"description":7},"main","f827970e3fe7c3e17a9d26d5a21d38365fd03a34","cypilot\u002F.core\u002Fskills\u002Fcypilot","https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front","https:\u002F\u002Fwww.constructorfabric.org","https:\u002F\u002Fgithub.com\u002Fconstructorfabric","https:\u002F\u002Fconstructorfabric.org","A unified fabric that automates the entire XaaS software development lifecycle  from planning to building to running services in prod","2026-11-02 16:08:21",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add constructorfabric\u002Finsight-front --skill cypilot",{"tool":39,"command":40},"bunx","bunx skills add constructorfabric\u002Finsight-front --skill cypilot",{"tool":42,"command":43},"pnpm","pnpm dlx skills add constructorfabric\u002Finsight-front --skill cypilot","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002FSKILL.md",true,[47,53,59,63,67,71,75,79,83,89,93,97,101,105,109,113,117,121,125,129,133,137,141,145,149,153,157,161,165,169,173,177,181,185,189,193,197,201,205,209,213,217,221,225,229,233,237,241,245,249,253,257,261,265,269,273,277,281,285,289,293,297,301,305,309,313],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"agents.toml","OTHER","其他",2801,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fagents.toml",{"path":54,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":57,"sourceHtmlUrl":58},"agents\u002Fcypilot-codegen.md","REFERENCE","参考文档",813,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fagents\u002Fcypilot-codegen.md",{"path":60,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":61,"sourceHtmlUrl":62},"agents\u002Fcypilot-phase-compiler.md",2108,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fagents\u002Fcypilot-phase-compiler.md",{"path":64,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":65,"sourceHtmlUrl":66},"agents\u002Fcypilot-phase-runner.md",2458,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fagents\u002Fcypilot-phase-runner.md",{"path":68,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":69,"sourceHtmlUrl":70},"agents\u002Fcypilot-pr-review.md",758,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fagents\u002Fcypilot-pr-review.md",{"path":72,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":73,"sourceHtmlUrl":74},"agents\u002Fcypilot-ralphex.md",7820,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fagents\u002Fcypilot-ralphex.md",{"path":76,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":77,"sourceHtmlUrl":78},"cypilot.clispec",41013,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fcypilot.clispec",{"path":80,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":81,"sourceHtmlUrl":82},"README.md",4039,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002FREADME.md",{"path":84,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":87,"sourceHtmlUrl":88},"scripts\u002Fcypilot.py","SCRIPT","脚本",502,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot.py",{"path":90,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":91,"sourceHtmlUrl":92},"scripts\u002Fcypilot\u002F__init__.py",479,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002F__init__.py",{"path":94,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":95,"sourceHtmlUrl":96},"scripts\u002Fcypilot\u002F__main__.py",418,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002F__main__.py",{"path":98,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":99,"sourceHtmlUrl":100},"scripts\u002Fcypilot\u002Fcli.py",16910,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcli.py",{"path":102,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":103,"sourceHtmlUrl":104},"scripts\u002Fcypilot\u002Fcommands\u002F__init__.py",0,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002F__init__.py",{"path":106,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":107,"sourceHtmlUrl":108},"scripts\u002Fcypilot\u002Fcommands\u002F_core_config.py",1388,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002F_core_config.py",{"path":110,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":111,"sourceHtmlUrl":112},"scripts\u002Fcypilot\u002Fcommands\u002Fadapter_info.py",24453,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fadapter_info.py",{"path":114,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":115,"sourceHtmlUrl":116},"scripts\u002Fcypilot\u002Fcommands\u002Fagents.py",153464,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fagents.py",{"path":118,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":119,"sourceHtmlUrl":120},"scripts\u002Fcypilot\u002Fcommands\u002Fcheck_language.py",10271,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fcheck_language.py",{"path":122,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":123,"sourceHtmlUrl":124},"scripts\u002Fcypilot\u002Fcommands\u002Fchunk_input.py",20051,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fchunk_input.py",{"path":126,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":127,"sourceHtmlUrl":128},"scripts\u002Fcypilot\u002Fcommands\u002Fdelegate.py",6388,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fdelegate.py",{"path":130,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":131,"sourceHtmlUrl":132},"scripts\u002Fcypilot\u002Fcommands\u002Fdoctor.py",4452,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fdoctor.py",{"path":134,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":135,"sourceHtmlUrl":136},"scripts\u002Fcypilot\u002Fcommands\u002Fget_content.py",5402,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fget_content.py",{"path":138,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":139,"sourceHtmlUrl":140},"scripts\u002Fcypilot\u002Fcommands\u002Finit.py",36207,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Finit.py",{"path":142,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":143,"sourceHtmlUrl":144},"scripts\u002Fcypilot\u002Fcommands\u002Fkit.py",100451,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fkit.py",{"path":146,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":147,"sourceHtmlUrl":148},"scripts\u002Fcypilot\u002Fcommands\u002Flist_id_kinds.py",9126,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Flist_id_kinds.py",{"path":150,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":151,"sourceHtmlUrl":152},"scripts\u002Fcypilot\u002Fcommands\u002Flist_ids.py",11941,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Flist_ids.py",{"path":154,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":155,"sourceHtmlUrl":156},"scripts\u002Fcypilot\u002Fcommands\u002Fmigrate.py",99853,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fmigrate.py",{"path":158,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":159,"sourceHtmlUrl":160},"scripts\u002Fcypilot\u002Fcommands\u002Fresolve_vars.py",19360,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fresolve_vars.py",{"path":162,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":163,"sourceHtmlUrl":164},"scripts\u002Fcypilot\u002Fcommands\u002Fself_check.py",23775,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fself_check.py",{"path":166,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":167,"sourceHtmlUrl":168},"scripts\u002Fcypilot\u002Fcommands\u002Fspec_coverage.py",11134,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fspec_coverage.py",{"path":170,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":171,"sourceHtmlUrl":172},"scripts\u002Fcypilot\u002Fcommands\u002Ftoc.py",5347,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Ftoc.py",{"path":174,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":175,"sourceHtmlUrl":176},"scripts\u002Fcypilot\u002Fcommands\u002Fupdate.py",38173,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fupdate.py",{"path":178,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":179,"sourceHtmlUrl":180},"scripts\u002Fcypilot\u002Fcommands\u002Fvalidate_kits.py",20397,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fvalidate_kits.py",{"path":182,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":183,"sourceHtmlUrl":184},"scripts\u002Fcypilot\u002Fcommands\u002Fvalidate_toc.py",4949,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fvalidate_toc.py",{"path":186,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":187,"sourceHtmlUrl":188},"scripts\u002Fcypilot\u002Fcommands\u002Fvalidate.py",49294,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fvalidate.py",{"path":190,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":191,"sourceHtmlUrl":192},"scripts\u002Fcypilot\u002Fcommands\u002Fwhere_defined.py",4378,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fwhere_defined.py",{"path":194,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":195,"sourceHtmlUrl":196},"scripts\u002Fcypilot\u002Fcommands\u002Fwhere_used.py",3978,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fwhere_used.py",{"path":198,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":199,"sourceHtmlUrl":200},"scripts\u002Fcypilot\u002Fcommands\u002Fworkspace_add.py",12043,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fworkspace_add.py",{"path":202,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":203,"sourceHtmlUrl":204},"scripts\u002Fcypilot\u002Fcommands\u002Fworkspace_info.py",9723,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fworkspace_info.py",{"path":206,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":207,"sourceHtmlUrl":208},"scripts\u002Fcypilot\u002Fcommands\u002Fworkspace_init.py",20481,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fworkspace_init.py",{"path":210,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":211,"sourceHtmlUrl":212},"scripts\u002Fcypilot\u002Fcommands\u002Fworkspace_sync.py",7796,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fcommands\u002Fworkspace_sync.py",{"path":214,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":215,"sourceHtmlUrl":216},"scripts\u002Fcypilot\u002Fconstants.py",1031,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fconstants.py",{"path":218,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":219,"sourceHtmlUrl":220},"scripts\u002Fcypilot\u002Fralphex_discover.py",7063,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fralphex_discover.py",{"path":222,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":223,"sourceHtmlUrl":224},"scripts\u002Fcypilot\u002Fralphex_export.py",57733,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Fralphex_export.py",{"path":226,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":227,"sourceHtmlUrl":228},"scripts\u002Fcypilot\u002Futils\u002F__init__.py",3777,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002F__init__.py",{"path":230,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":231,"sourceHtmlUrl":232},"scripts\u002Fcypilot\u002Futils\u002F_tomllib_compat.py",763,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002F_tomllib_compat.py",{"path":234,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":235,"sourceHtmlUrl":236},"scripts\u002Fcypilot\u002Futils\u002Fartifacts_meta.py",49495,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Fartifacts_meta.py",{"path":238,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":239,"sourceHtmlUrl":240},"scripts\u002Fcypilot\u002Futils\u002Fcodebase.py",22734,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Fcodebase.py",{"path":242,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":243,"sourceHtmlUrl":244},"scripts\u002Fcypilot\u002Futils\u002Fconstraints.py",99438,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Fconstraints.py",{"path":246,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":247,"sourceHtmlUrl":248},"scripts\u002Fcypilot\u002Futils\u002Fcontent_language.py",12217,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Fcontent_language.py",{"path":250,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":251,"sourceHtmlUrl":252},"scripts\u002Fcypilot\u002Futils\u002Fcontext.py",44535,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Fcontext.py",{"path":254,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":255,"sourceHtmlUrl":256},"scripts\u002Fcypilot\u002Futils\u002Fcoverage.py",15424,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Fcoverage.py",{"path":258,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":259,"sourceHtmlUrl":260},"scripts\u002Fcypilot\u002Futils\u002Fdiff_engine.py",35767,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Fdiff_engine.py",{"path":262,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":263,"sourceHtmlUrl":264},"scripts\u002Fcypilot\u002Futils\u002Fdocument.py",18847,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Fdocument.py",{"path":266,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":267,"sourceHtmlUrl":268},"scripts\u002Fcypilot\u002Futils\u002Ferror_codes.py",5716,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Ferror_codes.py",{"path":270,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":271,"sourceHtmlUrl":272},"scripts\u002Fcypilot\u002Futils\u002Ffiles.py",15903,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Ffiles.py",{"path":274,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":275,"sourceHtmlUrl":276},"scripts\u002Fcypilot\u002Futils\u002Ffixing.py",31252,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Ffixing.py",{"path":278,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":279,"sourceHtmlUrl":280},"scripts\u002Fcypilot\u002Futils\u002Fgit_utils.py",14601,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Fgit_utils.py",{"path":282,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":283,"sourceHtmlUrl":284},"scripts\u002Fcypilot\u002Futils\u002Flanguage_config.py",11471,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Flanguage_config.py",{"path":286,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":287,"sourceHtmlUrl":288},"scripts\u002Fcypilot\u002Futils\u002Flayer_discovery.py",10881,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Flayer_discovery.py",{"path":290,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":291,"sourceHtmlUrl":292},"scripts\u002Fcypilot\u002Futils\u002Fmanifest.py",53451,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Fmanifest.py",{"path":294,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":295,"sourceHtmlUrl":296},"scripts\u002Fcypilot\u002Futils\u002Fparsing.py",7247,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Fparsing.py",{"path":298,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":299,"sourceHtmlUrl":300},"scripts\u002Fcypilot\u002Futils\u002Ftoc.py",28004,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Ftoc.py",{"path":302,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":303,"sourceHtmlUrl":304},"scripts\u002Fcypilot\u002Futils\u002Ftoml_utils.py",5725,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Ftoml_utils.py",{"path":306,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":307,"sourceHtmlUrl":308},"scripts\u002Fcypilot\u002Futils\u002Fui.py",7614,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Fui.py",{"path":310,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":311,"sourceHtmlUrl":312},"scripts\u002Fcypilot\u002Futils\u002Fwhatsnew.py",10640,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Fwhatsnew.py",{"path":314,"resourceType":85,"resourceTypeDesc":86,"sizeBytes":315,"sourceHtmlUrl":316},"scripts\u002Fcypilot\u002Futils\u002Fworkspace.py",25136,"https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.core\u002Fskills\u002Fcypilot\u002Fscripts\u002Fcypilot\u002Futils\u002Fworkspace.py",[318,325,331,337,344,350],{"skillNo":319,"name":320,"nameZh":6,"description":321,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":322,"categories":323,"keywords":324,"publishedAt":19},"01M74EPCQNC4RTX5KXPHQ1FBE9","cypilot-sdlc","Artifacts: ADR, CODEBASE, DECOMPOSITION, DESIGN, FEATURE, PR-CODE-REVIEW-TEMPLATE, PR-REVIEW, PR-STATUS-REPORT-TEMPLATE, PRD; Workflows: migrate-openspec, pr-review, pr-status","https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002Fconfig\u002Fkits\u002Fsdlc\u002FSKILL.md",[],[],{"skillNo":326,"name":327,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":328,"categories":329,"keywords":330,"publishedAt":19},"01M74EPBXT0KA3J91ZBD0D91NB","config","https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002Fconfig\u002FSKILL.md",[],[],{"skillNo":332,"name":333,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":334,"categories":335,"keywords":336,"publishedAt":19},"01M74EPA5KDDVCSS5R68EM8SKG",".gen","https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002Fcypilot\u002F.gen\u002FSKILL.md",[],[],{"skillNo":338,"name":339,"nameZh":6,"description":340,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":341,"categories":342,"keywords":343,"publishedAt":19},"01M74ENYN95P7S4D3EGNQZA2YF","tanstack-router","TanStack Router (v1+) reference for code-based routing, loaders, search params, navigation, link composition, route guards, and integration patterns. Use when working with files under src\u002F that import from '@tanstack\u002Freact-router', when creating or modifying routes\u002Froute trees, when designing data-loading via route loaders or beforeLoad, when adding type-safe Links\u002FuseNavigate\u002FuseParams\u002FuseSearch, when configuring RouterProvider or createRouter, or whenever the user mentions \"tanstack router\", \"route loader\", \"useParams\", \"useNavigate\", \"search params\", \"beforeLoad\", or \"code-based routes\". Also triggers for migration questions from react-router or other routers.","https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftanstack-router\u002FSKILL.md",[],[],{"skillNo":345,"name":5,"nameZh":6,"description":346,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":347,"categories":348,"keywords":349,"publishedAt":19},"01M74ENSB9BZ68DZM6GR6E2CMS","Invoke when user asks to do something with Cypilot, or wants to analyze\u002Fvalidate artifacts, or create\u002Fgenerate\u002Fimplement anything using Cypilot workflows, or plan phased execution. Core capabilities: workflow routing (plan\u002Fanalyze\u002Fgenerate\u002Fauto-config); deterministic validation (structure, cross-refs, traceability, TOC); code↔artifact traceability with @cpt-* markers; spec coverage measurement; ID search\u002Fnavigation; init\u002Fbootstrap; adapter + registry discovery; auto-configuration of brownfield projects (scan conventions, generate rules); kit management (install\u002Fupdate with file-level diff); TOC generation; agent integrations (Windsurf, Cursor, Claude, Copilot, OpenAI). Kit sdlc: Artifacts: ADR, CODEBASE, DECOMPOSITION, DESIGN, FEATURE, PR-CODE-REVIEW-TEMPLATE, PR-REVIEW, PR-STATUS-REPORT-TEMPLATE, PRD; Workflows: migrate-openspec, pr-review, pr-status.","https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fcypilot\u002FSKILL.md",[],[],{"skillNo":351,"name":352,"nameZh":6,"description":353,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":354,"categories":355,"keywords":356,"publishedAt":19},"01M74ENR1XHNYHQDHBB4QQSGYT","cypilot-workspace","Multi-repo workspace setup — discover repos, configure sources, generate workspace config, validate","https:\u002F\u002Fgithub.com\u002Fconstructorfabric\u002Finsight-front\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fcypilot-workspace\u002FSKILL.md",[],[]]