{
  "markdown": "# claude-code-plugin-gvt-construct3\n\nThe **`gvt-construct3` plugin** for Claude Code — Construct 3 platform knowledge, C3 agents, and a convention audit for any repository with a Construct 3 project on disk.\n\nIt bundles the **construct3-chef** and **c3-domain-manager** MCP servers, ships the `c3-explorer` and `c3-implementer` agents, and owns the canonical **C3 platform reference** (`plugin/docs/c3/`). It is **independent of the `gvt-dev` plugin** — installable on its own.\n\nIt is distributed through the [`claude-code-marketplace`](https://github.com/genvid-holdings/claude-code-marketplace) catalog (marketplace name `genvid-plugins`).\n\n## Install\n\n```text\n/plugin marketplace add https://github.com/genvid-holdings/claude-code-marketplace.git\n/plugin install gvt-construct3@genvid-plugins\n```\n\nThe plugin declares `construct3-chef` and `c3-domain-manager` in its `plugin.json` (`mcpServers`), so they start when the plugin is enabled. They may appear as **\"Pending approval\"** — approve them once.\n\nThen verify the repo satisfies the contract:\n\n```text\n/gvt-construct3:audit-c3-conventions\n```\n\nThe audit checks for a **C3-project marker** and that both MCP servers are reachable at their minimum versions.\n\n## What the plugin provides\n\n**Agents** (dispatched via `subagent_type: \"gvt-construct3:<name>\"`):\n\n| Agent | Model | Purpose |\n|-------|-------|---------|\n| `c3-explorer` | haiku | Read-only C3 recon — DSL, layouts, domain index, search |\n| `c3-implementer` | opus | C3 mutations via recipes, layout/sprite scaffolding, project sync |\n\n**Skill** (invoked as `/gvt-construct3:<name>`):\n\n| Skill | Purpose |\n|-------|---------|\n| `audit-c3-conventions` | Read-only validator — C3-project marker + MCP server reachability/versions |\n| `author-navigation-patterns` | Authors/validates a chef `navigation.targetPatterns` convention for wrapper-routed navigation |\n| `build-reference` | Builds chef's `c3-reference` cache (built-in ACEs + concept docs) so `search-docs` resolves built-ins |\n| `create-c3-op` | Authors + dry-run-validates a construct3-chef user-defined op wrapper (params + `{{PARAM}}` placement) |\n\n**Bundled docs** (`plugin/docs/c3/`): the canonical **C3 platform reference** — event-sheet architecture, layouts, scripting, TS integration, and `construct3-guide.md`. The agents link these via `${CLAUDE_PLUGIN_ROOT}/docs/c3/*`.\n\n**Bundled MCP servers** (`plugin.json` `mcpServers`): `construct3-chef` (recipes, DSL, scaffolding; its own docs at the `construct3-chef` server's `docs:///index` resource) and `c3-domain-manager` (domain index, overrides).\n\n## The convention contract\n\n`gvt-construct3` requires a consuming repo to be a Construct 3 project with the two MCP servers available. The full contract — including the optional, project-owned context the agents read from your `CLAUDE.md` — is documented in [`plugin/CONVENTIONS.md`](plugin/CONVENTIONS.md).\n\n## Knowledge boundaries\n\n- **C3 platform reference** (how Construct 3 behaves) → this plugin (`plugin/docs/c3/`).\n- **Tooling reference** (recipe format, generators, CLI, recipe gotchas) → the `construct3-chef` server's `docs:///index` resource, versioned with the tool.\n- **Project-specific facts** (named layouts, file paths, commit format, project gotchas) → the consuming repo.\n\n## Contributing\n\nThe shipped plugin lives in the **`plugin/`** subfolder; the repo root is the dev workspace (a `gvt-dev` consumer). See [`CLAUDE.md`](CLAUDE.md) for the full layout.\n\n- Skills are directories with `SKILL.md`; agents are flat `.md` files in `plugin/agents/`.\n- Top-level frontmatter is fixed (`name`, `description`, plus Anthropic-supported fields); custom expectations go under `metadata.expects`.\n- Validate with `cd plugin && claude plugin validate .`.\n- Test the audit with `cd plugin && node --test skills/audit-c3-conventions/scripts/test/*.test.mjs`.\n",
  "bytes": 3848,
  "sha": "602327afaa8c5368f73ab164965f4465128444144b30e69ca507702519d6faaf",
  "repo_slug": "genvidtechnologies/claude-code-plugin-gvt-construct3",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_genvidtechnologies_claude_code_plugin_gv_eaf6361e/readme"
}