agentleFS
popup-studio-aipopup-studio-ai/bkit-claude-code/skills/deploy/SKILL.md

deploy

Skill605 starsChanged 3 months agoApache-2.0View on GitHub

Deploy feature to target environment (dev/staging/prod) with level-based strategy. Triggers: deploy, /pdca deploy

  • Reads credentials

155 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

1 rule. 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 138 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Self-healing escalation: When self-healing agent exhausts its 5-iteration auto-fix budget without restoring SLO, it triggers /pdca deploy …

    line 108

“Common” is measured: kept by at least 6 in 10 of the 138 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Deploy Skill

Deploy code to target environment with automated CI/CD pipeline generation. Strategy adapts based on project level (Starter/Dynamic/Enterprise).

Usage

/pdca deploy {feature}              # Deploy to default env (dev)
/pdca deploy {feature} --env dev    # Deploy to DEV
/pdca deploy {feature} --env staging  # Deploy to STAGING (requires DEV 90%+)
/pdca deploy {feature} --env prod   # Deploy to PROD (requires STAGING 95%+ & Human Approval)
/pdca deploy status                 # Show deploy state machine status

Level-Based Strategy

LevelStrategyEnvironmentsTools
StarterGuide onlydevGitHub Pages, Netlify, Vercel
DynamicDocker + GHAdev, stagingDocker Compose, GitHub Actions
Enterprise6-Layer CI/CDdev, staging, prodTerraform, EKS, ArgoCD, Canary

Deploy Flow

/pdca deploy feature --env dev
    │
    ▼
① Level Detection (Starter/Dynamic/Enterprise)
    │
    ▼
② Generate CI/CD Files (if not exist)
    ├── .github/workflows/deploy.yml
    ├── Dockerfile (Dynamic/Enterprise)
    ├── docker-compose.yml (DEV)
    ├── k8s/ manifests (Enterprise)
    └── terraform/ (Enterprise)
    │
    ▼
③ Deploy State Machine Transition
    init → dev → verify(90%) → staging → verify(95%) → approval → prod(canary) → complete
    │
    ▼
④ Return to PDCA Check phase

Environment Promotion Gates

GateConditionAction
DEV → STAGINGMatch Rate ≥ 90%Auto-promote
STAGING → PRODMatch Rate ≥ 95% + Human ApprovalRequire /pdca deploy --env prod
PROD CanaryError rate < thresholdAuto-rollout 10% → 25% → 50% → 100%

Generated Files

Starter

  • Deployment guide document only

Dynamic

  • .github/workflows/deploy.yml — Docker build + push + deploy
  • Dockerfile — Multi-stage build
  • docker-compose.yml — DEV environment
  • .env.example — Environment variables template

Enterprise (additional)

  • infra/terraform/ — AWS infrastructure
  • infra/k8s/ — Kubernetes manifests
  • infra/argocd/ — ArgoCD Application + Helm
  • Security scan steps in CI/CD

Rollback

/pdca deploy rollback {feature}              # Rollback current deploy
/pdca deploy rollback {feature} --env prod   # Rollback specific environment

Rollback triggers:

  • Manual: /pdca deploy rollback command
  • Auto: Error rate spike detected by ops-metrics (> 5% threshold)
  • Canary fail: Argo Rollouts auto-rollback on metrics failure
  • Self-healing escalation: When self-healing agent exhausts its 5-iteration auto-fix budget without restoring SLO, it triggers /pdca deploy rollback as final remediation (see Self-Healing Integration below).

Rollback resets deploy state machine to idle and restores previous version.

Self-Healing Integration (v2.1.13)

The self-healing agent (linked-from-skills: deploy) closes the deploy ⇄ recovery loop:

StageTriggerAction
DetectSentry/Slack error pattern matches deploy windowself-healing agent activated via 8-lang triggers ("자동 수정", "auto fix", etc.)
Diagnose4-Layer Living Context loaded (Scenarios + Invariants + Impact + Incidents)Identify deploy-introduced regression
Auto-fixSpawn code-analyzer + gap-detector via Task toolUp to 5 iteration cycles with scenario runner verification
VerifyRe-run feature scenariosPass → auto PR; Fail → escalate
EscalateIteration budget exhausted or critical invariant violatedTrigger /pdca deploy rollback + alert human on-call

Invocation paths:

  • Implicit: Sentry webhook → self-healing agent (via plugin trigger registry)
  • Explicit: /pdca deploy rollback first checks for active self-healing session and aborts to wait for it; user can force-bypass with --force-rollback

The self-healing → deploy contract is mediated by lib/audit/audit-logger.js ACTION_TYPES (rollback_executed, agent_completed, gate_failed) so all transitions remain audit-trail compliant.

Hook Events

EventWhenHook
deploy-startDeploy initiatedPre-validation
deploy-completeDeploy successfulPost-notification
deploy-failedDeploy failedError handling + rollback suggestion

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.