~ / rigs / fcastel2002 / pdk

fcastel2002/pdk

PDK for Ignition Perspective: lets an AI agent build, validate, deploy and inspect Perspective views on a development gateway.

↗ GitHub ★ 2 Apache-2.0 updated 1mo ago project Claude CodeCodex
share on X
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
GUARDRAILS
1/5
No YOLO mode · details
Quality 18/100 Guardrails v2

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)

serversourceest. 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)

eventmatcherruns
PostToolUseWrite|Edit|MultiEdituv run --quiet pdk hook

Similar rigs

copied ✓