Coding agents

Craft NG is unusual enough that a model trained on Angular classes will invent the wrong API. After you import @craft-ng/core, give the agent three layered entry points — the same split Angular uses with llms.txt, the CLI MCP server, and Agent Skills.

Layer	What it is	When the agent uses it
LLM files	`/llms.txt`, `/llms-full.txt`, and a `.md` sibling for every docs page	Discovery on the internet, no install
MCP server	`@craft-ng/mcp` — `get_best_practices`, `search_documentation`, `find_examples`, skills	Live lookup in Cursor, Claude Code, VS Code, Copilot
Agent Skills	`skills/` inside `@craft-ng/mcp`, plus an Agent Plugin manifest	Multi-step workflows (routes, spec → primitives, migration)

Do not scrape the HTML docs. Start from llms.txt or the MCP tools.

1. LLM files

These follow the llms.txt spec and are generated from this VitePress site at build time.

Index (curated links): https://ng-angular-stack.github.io/craft/llms.txt
Concatenated docs: https://ng-angular-stack.github.io/craft/llms-full.txt
One page, as markdown: append .md to any docs URL, for example local state

Paste this into an AGENTS.md (or CLAUDE.md) at the root of the app that imports Craft:

# Craft NG

This application uses `@craft-ng/core`.

- Docs index: https://ng-angular-stack.github.io/craft/llms.txt
- MCP: `npx -y @craft-ng/mcp@beta` (`get_best_practices`, `search_documentation`)
- Skills: `node_modules/@craft-ng/mcp/skills`

yield* every Craft reader. Do not generate Angular signal(), inject(), or
@Injectable in authored Craft code. craftRoutes files need componentDeps and
a per-file DI check.

The same snippet is returned by the MCP tool get_best_practices (field agentsMd) and lives in the package as content/agents.md.

2. MCP server

bash

npm install -D @craft-ng/mcp@beta

Add a project .mcp.json (Cursor, Claude Code, and VS Code all understand it):

json

{
  "mcpServers": {
    "craft-ng": {
      "command": "npx",
      "args": ["-y", "@craft-ng/mcp@beta"]
    }
  }
}

Claude Code, from the app directory:

shell

claude mcp add craft-ng -- npx -y @craft-ng/mcp@beta

Tools

Tool	Use it to
`get_best_practices`	Load the coding-agent guide and the `AGENTS.md` snippet
`search_documentation`	Find a Guide / Learn / Reference page by API or task
`get_documentation_page`	Read one page as markdown (`/guide/state/local-state`)
`find_examples`	Find Learn + demo examples
`list_skills` / `get_skill`	Load a workflow skill and its `references/*.md`
`get_llms_txt`	Get the public `llms.txt` URLs and the bundled path index

The server is read-only. It searches documentation bundled at publish time, so it works offline. It is not the runtime registry MCP used to mutate a live demo tab.

3. Agent Skills

Skills follow the Agent Skills layout (SKILL.md + optional references/). The package is also an Agent Plugin (plugin.json + mcp.json + skills/).

Skill	Trigger
`craft-ng`	Any authored Craft code
`translate-spec-to-ng-craft`	Spec / CRUD / filters / forms → primitives
`ng-craft-routes`	`craftRoutes`, `componentDeps`, `TS2589`
`ng-craft-service-migration`	`@Injectable` / `inject()` → `craftService`
`migrate-to-ng-craft`	`craft-migrate` then manual diagnostics

Point the agent at node_modules/@craft-ng/mcp/skills, or let it call get_skill. Cursor can also install a skill from that folder.

Verify the agent can see Craft

Ask it to add a state counter, a paged query, or a craftRoutes file. It should yield* readers, compose insertions with craftPipe, and put a DI check in the routes file. If it emits signal(), inject(), or a plain Angular Routes array, the MCP server or AGENTS.md snippet is not in context.

Coding agents ​

1. LLM files ​

2. MCP server ​

Tools ​

3. Agent Skills ​

Verify the agent can see Craft ​