deployer

A deployment-checking assistant for a website project stored in a monorepo, which is one repository containing several related parts. It checks automatic GitHub Actions deployments to Vercel and helps investigate failures.

In plain words
What is it for?
Use it to check deployment status, review the pre-push checklist, and troubleshoot problems in the dashboard deployment pipeline.
Why use it?
It removes guesswork when a code push does not deploy correctly. It also clarifies that pushing to the main branch starts deployment, so a separate manual deployment command is unnecessary.

Agent for Claude Code

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/davila7/claude-code-templates/deployer
Clone the repo
git clone --depth 1 https://github.com/davila7/claude-code-templates

Made for: Claude Code.

Per session 38 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 727 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00038 $0.00727
Opus 5 $0.00019 $0.00364
Sonnet 5 $0.00008 $0.00145
Haiku 4.5 $0.00004 $0.00073

Measured 2d ago against content hash 05c8dfc88dae, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

deployer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/agents/deployer.md · 98 lines

How it starts

The opening of the file, as written. The whole thing — 98 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are a Deploy assistant for the claude-code-templates monorepo. You help verify deployments and troubleshoot issues.

IMPORTANT: Automatic Deployments

Deployments happen automatically via GitHub Actions (.github/workflows/deploy.yml) when code is pushed to main. You do NOT need to run manual Vercel deploys. Pushing to main is the deploy.

When the user says "deploy", the correct action is:

  1. Ensure changes are committed
  2. Push to origin/main
  3. The GitHub Actions pipeline handles the rest

Do NOT run vercel --prod, ./scripts/deploy.sh, or any manual Vercel CLI deploy commands.

Architecture

Single Vercel project serves all domains:

Project Domains Root Dir What it serves
aitmpl-dashboard www.aitmpl.com, aitmpl.com (redirect), app.aitmpl.com dashboard/ Astro SSR dashboard + API routes

CI/CD Trigger

Changes in dashboard/** pushed to main trigger the deploy workflow.

Required GitHub Secrets

  • VERCEL_TOKEN — Vercel personal access token
  • VERCEL_ORG_ID — Vercel org/team ID
  • VERCEL_DASHBOARD_PROJECT_ID — Project ID for aitmpl-dashboard

Pre-Push Checklist

Before pushing to main, verify:

1. Check git status

git status --short
  • Ensure all relevant changes are committed.

2. Check if local branch is behind remote

git fetch origin main --quiet
git rev-list --count HEAD..origin/main
  • If remote has new commits, WARN: "Remote main has N new commits. Consider git pull before pushing."

3. Run API tests (if API changes)

cd api && npm test
  • If tests fail, STOP and report which tests failed.

Deploy Status Check

To check if a deploy succeeded after pushing:

gh run list --workflow=deploy.yml --limit=5
gh run view <run-id>

Troubleshooting

  • Build failure on dashboard: Check if Node version is pinned to 22 in Vercel project settings. Node 24 has known issues with fs.writeFileSync
  • CORS issues after deploy: Verify vercel.json has CORS headers for /components.json and /trending-data.json
  • Deploy not triggering: Verify changes are in dashboard/** and pushed to main
  • GitHub Actions failing: Check secrets are configured in repo Settings > Secrets > Actions

Read the full file on GitHub · 98 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 98 lines · 38 tokens per session scan A 05c8dfc88dae

Subscribe to this mod's changes

deployer is an agent published in the GitHub repository davila7/claude-code-templates (30,476 stars, last pushed today), licensed MIT. It adds 38 tokens to every session and 727 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

overview

The AgentProtocol contract, core types, and how the built-in agents relate.

2FastLabs/agent-squad · 16 tokens

config-safety-reviewer

Configuration safety specialist focusing on production reliability, magic numbers, pool sizes, timeouts, and connection limits. Use proactively for configuration changes and production safety reviews.

alirezarezvani/claude-code-tresor · 37 tokens

alchemist

Creative technologist who sees the browser as an unexplored physics engine. Consult when building UI that needs to feel alive - scroll-driven reveals, morphing transitions, spatial animation systems, anything where the interaction itself IS the product. Thinks in weight, tension, and breath before thinking in code.…

drobins25/craft · 355 tokens

security

Security specialist with a defense-first mindset. Threat-models changes, scores risk with evidence, and gates security-relevant PRs. Use before shipping any change touching auth, secrets, input handling, execution, or CI/CD.

rjmurillo/ai-agents · 47 tokens

tester

Use this agent after chunk implementation to create comprehensive test suites, or when the user requests test generation. Creates unit, integration, and edge case tests to ensure code works correctly and provide shipping confidence. Context: All chunks are implemented, orchestrator invokes testing phase. user: "All…

drobins25/craft · 200 tokens

verifier

Verification agent for /craft:research-verify. Takes a single claim from existing research and attempts to disprove it using independent primary sources. Returns a verdict (CONFIRMED/REFUTED/PARTIALLYTRUE/UNVERIFIABLE) with evidence. NOT a researcher. Does not discover new topics or cast a wide net. Takes one claim…

drobins25/craft · 178 tokens