fcastel2002/pdk
PDK for Ignition Perspective: lets an AI agent build, validate, deploy and inspect Perspective views on a development gateway.
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
CONTEXT TAX · EVERY TURN
up to ~4.7k tokens
Claude Code loads MCP tools on demand, so the real cost is usually lower.
Moderate · median rig: 2.3k · breakdown
Copy this rig
# review before running: this installs third-party code $ claude mcp add pdk -- uv run --quiet pdk-mcp $ npx degit fcastel2002/pdk/.claude ./rig-pdk # inspect, then merge into .claude/
MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.
$ claude mcp add pdk -- uv run --quiet pdk-mcp $ npx degit fcastel2002/pdk/.claude/skills/perspective-views .claude/skills/perspective-views $ curl -fsSL --create-dirs -o .claude/agents/pdk-auditor.md https://raw.githubusercontent.com/fcastel2002/pdk/main/.claude/agents/pdk-auditor.md $ curl -fsSL --create-dirs -o .claude/agents/pdk-brief-runner.md https://raw.githubusercontent.com/fcastel2002/pdk/main/.claude/agents/pdk-brief-runner.md $ curl -fsSL --create-dirs -o .claude/agents/pdk-bundle-reader.md https://raw.githubusercontent.com/fcastel2002/pdk/main/.claude/agents/pdk-bundle-reader.md $ curl -fsSL --create-dirs -o .claude/agents/pdk-log-reader.md https://raw.githubusercontent.com/fcastel2002/pdk/main/.claude/agents/pdk-log-reader.md $ curl -fsSL --create-dirs -o .claude/agents/pdk-mechanic.md https://raw.githubusercontent.com/fcastel2002/pdk/main/.claude/agents/pdk-mechanic.md $ curl -fsSL --create-dirs -o .claude/agents/pdk-reviewer.md https://raw.githubusercontent.com/fcastel2002/pdk/main/.claude/agents/pdk-reviewer.md $ curl -fsSL --create-dirs -o .claude/agents/pdk-sdk-reader.md https://raw.githubusercontent.com/fcastel2002/pdk/main/.claude/agents/pdk-sdk-reader.md
This rig commits no guardrails. Here is the community baseline instead — the deny/ask rules most often found across all 16.2k rigs:
{
"permissions": {
"deny": [
"Read(./.env)",
"Read(./.env.*)",
"Read(**/.env)",
"Read(~/.ssh/**)",
"Bash(git push --force:*)",
"Read(**/*.pem)",
"Read(.env)",
"Read(~/.aws/**)",
"Read(**/*.key)",
"Read(**/.env.*)",
"Bash(git push --force*)",
"Bash(rm -rf:*)",
"Bash(rm -rf *)",
"Bash(sudo *)",
"Bash(sudo:*)",
"Bash(rm -rf /)",
"Bash(git push -f:*)",
"Read(.env.*)",
"Bash(git reset --hard*)",
"Bash(rm -rf /*)"
],
"ask": [
"Bash(git push:*)",
"Bash(git push *)",
"Bash(gh pr merge *)",
"Bash(git commit:*)",
"Bash(rm *)",
"Bash(gh pr merge:*)",
"Bash(gh pr create *)",
"Bash(git reset --hard:*)",
"Bash(npm publish:*)",
"Bash(git rebase *)"
]
}
} MCP servers (1)
| server | source | est. tokens |
|---|---|---|
| pdk-mcp · "pdk" | pypi | 2.5k |
Skills (1)
Subagents (7)
| pdk-auditor model: haiku | Read-only PDK audits answered with grep and comparison. Use it to check that README.md/AGENTS.md match the CLI (--help), that the perspective-views skill mentions the current diagnostic codes, that ev |
| pdk-brief-runner model: haiku | Benchmark run: takes ONE brief from bench/briefs/ and builds the view with the full PDK cycle (catalog → view.json → validate → deploy → inspect) under PDK/_bench/ in the sandbox, unassisted. Reports |
| pdk-bundle-reader model: haiku | Extracts raw data from Perspective's client JS bundle for ONE component at a time (props it reads, defaults, which CSS/DOM they map to). Read-only, first pass; the main agent validates the interpretat |
| pdk-log-reader model: haiku | Summarizes the development gateway's logs (wrapper.log and `pdk gateway logs`) over a time window or from a sequence number: distinct errors, how many times, first useful line of the stack and what tr |
| pdk-mechanic model: haiku | Mechanical, bounded changes to PDK's Python code with a verifiable definition of done (pytest + ruff green). Use it to extend EXTRACT_JS with props already decided, write tests for semantics already d |
| pdk-reviewer model: haiku | Reviews a view already deployed to the sandbox against acceptance criteria (a brief from bench/briefs/ or a list) with pdk inspect (--expect, --query) and, if needed, a screenshot. Returns met / not m |
| pdk-sdk-reader model: haiku | Searches the installed Ignition and Perspective jars (javap) for the classes and signatures that answer ONE API question for the Java module, e.g. "how to browse tags from the gateway" or "what PageMo |
Hooks (1)
| event | matcher | runs |
|---|---|---|
| PostToolUse | Write|Edit|MultiEdit | uv run --quiet pdk hook |
Similar rigs
rtk-ai/rtk
CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies
Orchestrator 2.6k tok · · Q0
Yeachan-Heo/oh-my-claudecode
Teams-first Multi-agent orchestration for Claude Code
Orchestrator 14.5k tok · · Q3
davila7/claude-code-templates
Open-source registry and CLI for Claude Code components: agents, commands, skills, hooks, MCPs, settings and mods
Orchestrator 27.6k tok · · Q24
alirezarezvani/claude-skills
380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8 more coding agents — engineering, marketing, product, complian
Orchestrator 48.5k tok · · Q23