Repository Guidelines
## Project Structure & Module Organization
`src/` contains the TypeScript MCPserver: shared logic is in `core/`, MCP features in `features/`, transport code in `transport/`, and TouchDesigner communication in `tdClient
build` for all widget bundles, `npm run typecheck` for TypeScript, and `npm test` for MCPserver and widget contract coverage.
The plugin package is materialized directly from this directory. After
Forbidden Imports And Actions
- Do not call Codex app-server, the filesystem, shell commands, MCPservers, or privileged host APIs from artifact code.
- Do not import `@/app/*`, `apps/agent-html-app`, `@/agent-html/runtime/ui`, `renderAgentHtml
source for `seo`, a local-first TypeScript SEO CLI, library,
router skill, and stdio MCPserver. The public repository is
`iannuttall/seo`. The public npm package is the unscoped `seo` package
whole session: **do you shell out to the
CLI, or do you load the MCPserver?**
---
## Two lanes into the same engine
XActions ships both lanes from one install
Codex, OpenCode, and other AGENTS.md-aware agents)
This project provides a `token-optimizer` MCPserver. Use a named optimizer tool
only when that exact schema is visible in the current
Cloud. A PR that adds business logic to a CLI command file or MCPserver module is rejected.
### Module boundaries
tach enforces: `dbt_charts.cli` may depend only on `dbt_charts.agent
already does, with a buffer name that carries the pid so
the manager, the MCPserver, and the CLI never swap text between panes.
## Concurrent sessions
Multiple agent sessions share
ExtensionPost.** Don't bypass the permission gate when changing the executor. Don't put MCPserver tool schemas on the model — only `mcp_list` / `mcp_inspect` / `mcp_call`.
- **Extensions
packages/mcp` package is a Model Context Protocol server that exposes design system knowledge — component APIs, tokens, and usage guidance — to MCP-capable clients over a stdio transport.
#### Key commands
```bash
Runs **per workspace** using the Claude CLI.
- Configuration is written to each workspace:
- `.claude/settings.local.json` (MCPservers + permissions)
- `.claude/skills/ /SKILL.md` (native skills with YAML frontmatter)
- `CLAUDE.md` (general workspace context)
- Auth: when
Agent Quickstart
Vibe Check MCP is a lightweight oversight layer for AI agents. It exposes two tools:
- **vibe_check** – prompts you with clarifying questions to prevent tunnel vision.
- **vibe_learn
Agent Quickstart
Vibe Check MCP is a lightweight oversight layer for AI agents. It exposes two tools:
- **vibe_check** – prompts you with clarifying questions to prevent tunnel vision.
- **vibe_learn