corezoid-ai-doc

# Corezoid AI Doc

Knowledge base and tooling for AI-assisted Corezoid process development. Provides documentation, agent workflow definitions, an MCP server, and ready-to-use configurations for Claude Code, Cursor, Windsurf, Kiro, GitHub Copilot, and Devin.

## What's in this repo

```
knowledge/      Single source of truth — auth, node types, gotchas, quick-reference
agents/         Tool-agnostic workflow definitions for 8 AI agents
skills/         Claude Code skills — install these for AI-assisted process development
mcp-server/     Python MCP server exposing 35+ Corezoid API tools
docs/           Full reference — all node types, process structure, APIGW, dashboards
playbooks/      Step-by-step guides for common tasks
samples/        Real working process JSON examples
templates/      Reusable process skeletons
json-schema/    JSON Schema files for process and node validation
scripts/        generate-tool-configs.py — regenerates all tool configs from knowledge/
```

## Quick start

**1. Get credentials** from Corezoid UI → Account Settings → API:

```
API_LOGIN   numeric user ID
SECRET      long static string (NOT the JWT session token)
BASE_URL    https://www.corezoid.com/api/2/json
COMPANY_ID  your workspace UUID
FOLDER_ID   target folder ID
```

**2. Configure credentials:**

```bash
cp .env.example .env
# fill in your values
```

**3. Connect your AI tool to the MCP server** — see [`docs/mcp/README.md`](docs/mcp/README.md)

**4. Read [`GETTING-STARTED.md`](GETTING-STARTED.md)** for the full onboarding guide.

## Claude Code Skills

Install the skills for AI-assisted Corezoid development in Claude Code:

```bash
cp -r skills/corezoid-* ~/.cursor/skills/
```

| Skill | Purpose |
|-------|---------|
| [corezoid-architect](skills/corezoid-architect/SKILL.md) | Design multi-process systems |
| [corezoid-process-builder](skills/corezoid-process-builder/SKILL.md) | Build new connector or logic process |
| [corezoid-process-reviewer](skills/corezoid-process-reviewer/