setup-deployment

Discover deployment adapters, interview for routing details, and update .claude/project.md.

1|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/Joaovsales/coding-agent-workflow --skill setup-deployment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-deployment
Source: https://github.com/Joaovsales/coding-agent-workflow/tree/main/.claude/skills/setup-deployment
Command: npx skills add https://github.com/Joaovsales/coding-agent-workflow --skill setup-deployment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the initial deployment readiness for new projects by automatically discovering deployment runbooks, collecting per-service routing details, and updating the central project configuration.

Core Features & Use Cases

  • Discover available adapters by parsing all .claude/deployments/*.md runbooks and extracting display name, detect_files, and runbook path.
  • Detect deployed services at the project root by checking for matching deployment signal files and build a verified list.
  • Guide per-service interviews to capture the branch trigger and project ID, then merge results into .claude/project.md in an idempotent, non-destructive way.
  • Update .gitignore with deployment-state artifacts and ensure the project configuration is isolated to .claude/project.md, avoiding CLAUDE.md edits.
  • Verify runbook files exist and require alignment with the project’s sync flow to migrate legacy sections when needed.

Quick Start

Run /setup-deployment from the project root to bootstrap deployment verification and generate the .claude/project.md deployment table.

Frequently Asked Questions about setup-deployment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate deployment verification setup for multiple services?

Automating deployment verification setup involves scanning runbooks to discover adapters, detecting services at the project root, and interviewing for routing details to merge into a central configuration file.

What is deployment routing configuration and when do I need it?

Deployment routing configuration maps branch triggers and project IDs to specific services. You need it when initializing deployment verification to ensure automated runbooks target the correct environments.

Does deployment verification setup modify CLAUDE.md or existing project files?

Deployment verification setup does not modify CLAUDE.md. It isolates configuration updates to .claude/project.md using an idempotent, non-destructive merge to preserve existing project settings.

How do I bootstrap deployment routing when I have legacy runbooks?

Bootstrapping deployment routing with legacy runbooks requires verifying runbook files exist and aligning with the project's sync flow to migrate legacy sections into the updated .claude/project.md configuration.

Do I need a .claude directory to set up project deployment routing?

You need an existing .claude directory containing deployment runbooks to set up project deployment routing, as the setup process parses these files to detect services and extract adapter information.