DevSecOps
When to Use
- Add or harden SAST, SCA, secrets, IaC, DAST, or container scans in CI/CD
- Configure protected-branch security gates, artifact signing, SBOMs, provenance, or OIDC federation
- Triage pipeline security findings and define remediation SLAs or exception workflows
- Secure GitHub Actions, GitLab CI, build containers, registries, and deployment credentials
- Map delivery artifacts to SOC 2, ISO 27001, SSDF, or supply-chain evidence requirements
When NOT to Use
- Provision general cloud infrastructure without a security gate focus →
infrastructure-engineer
- Operate build/deploy pipelines without security requirements →
devops
- Implement corporate IdP, KMS, PAM, SIEM, or EDR controls →
information-security-engineer
- IAM entitlement design, access reviews, federation (non-pipeline) →
iam-specialist
- Triage live SOC alerts or run SOAR playbooks →
soc-analyst
- Threat hunts or SIEM detection authoring →
defensive-security-analyst
- Define company-wide security strategy or GRC roadmap →
cybersecurity
- Bootstrap clusters, Helm releases, ingress, routine pod debug →
cluster-deployment-engineer
- Execute authorized penetration tests or exploit PoCs →
penetration-tester
- Manual web/API OWASP testing and retest →
web-pentester
- Disassembly, decompilation, patch diff, or malware RE lab work →
reverse-engineer
Related skills
| Need |
Skill |
| VPC, K8s platform, IaC provisioning, generic CI/CD |
infrastructure-engineer |
| AI agent workflows in CI (Codex, Claude Action, prompt injection) |
agentic-actions-auditor (if installed) |
| Application threat models from repo structure |
security-threat-model (if installed) |
| Data governance, PII in warehouses |
data-architect |
| Security runbooks and customer-facing docs |
tech-writer-researcher |
| Platform IAM, KMS, SIEM/EDR operations |
information-security-engineer |
| Workforce IAM, reviews, federation, PAM policy |
iam-specialist |
| Cloud org guardrails, CSPM, multi-account posture |
cloud-security-engineer |
| Product tenancy, service authZ, customer data isolation |
product-infrastructure-security-engineer |
| Audit evidence pipelines and control mapping |
compliance-engineer |
| Pipeline compromise incident response |
incident-responder |
| Binary RE, patch diff, defensive malware analysis |
reverse-engineer |
| K8s workload deploy and cluster day-2 ops |
cluster-deployment-engineer |
| External researcher disclosure program |
technical-program-manager-security-cvd |
| Authorized pentest and retest |
penetration-tester |
| Manual web/API OWASP testing |
web-pentester |
Core Workflows
1. Shift-left security baseline
Apply on every repo before merge to default branch:
- Inventory languages, build tool, deploy target, and compliance scope
- Enable secret scanning and push protection on the org/repo
- Add SAST + SCA in CI on pull requests (fail on new critical/high)
- Scan IaC on
terraform plan / manifest changes (Checkov, tfsec, KICS)
- Scan container images before registry push (Trivy, Grype)
- Document exceptions with owner, expiry, and compensating control
Gate policy (default):
| Finding |
PR |
Default branch |
Production deploy |
| Secret in code |
Block |
Block |
Block |
| Critical CVE (exploitable) |
Block |
Block |
Block |
| High CVE |
Warn or block |
Block |
Block with exception |
| Medium/low |
Warn |
Track |
Track |
See references/shift_left_scanning.md for tool matrices, baseline configs, and false-positive handling.
2. CI/CD security gates
Pipeline order (security stages must not be skippable on protected branches):
lint → unit test → SAST/SCA → build → image scan → sign/SBOM → deploy staging → DAST (if applicable) → promote prod
Checklist:
See references/cicd_security_gates.md for GitHub Actions/GitLab patterns, OIDC, and deployment controls.
3. Supply chain integrity
Minimum viable supply chain for production services:
- Generate SBOM (CycloneDX or SPDX) on each release build
- Sign container images and/or provenance (Sigstore/cosign, SLSA-oriented attestations where required)
- Block dependencies with known critical CVEs unless documented exception
- Prefer pinned lockfiles; review major dependency upgrades in PR
- Vet new third-party actions, Helm charts, and base images
See references/supply_chain.md for SBOM fields, signing flows, and dependency update policy.
4. Cloud, container, and runtime security
Pre-production checklist:
See references/cloud_runtime_security.md for K8s admission policies, WAF, and CSPM triage.
5. Threat modeling and security review
Lightweight review (every feature with auth, payments, PII, or external input):
- Draw data flow: actors, trust boundaries, stores, external APIs
- List assets and STRIDE threats per boundary
- Map mitigations to existing controls or new tickets
- Record accepted risks with approver and review date
Deeper review triggers: new public API, auth model change, multi-tenant isolation change, crypto design, admin tooling, agent/LLM in production path.
See references/threat_modeling.md for STRIDE prompts, abuse-case templates, and review cadence.
6. Vulnerability management and compliance evidence
Triage workflow:
- Normalize findings (tool, CVE, asset, environment, exploitability)
- Score with CVSS + business context (internet-facing, data class, compensating controls)
- Assign owner and remediation SLA (see reference SLAs)
- Verify fix in CI rescan before closing
- Aggregate metrics: MTTR, open critical count, recurring classes
Compliance: map controls to delivery artifacts (pipeline configs, scan reports, access reviews, change tickets).
See references/compliance_evidence.md for SOC 2 / ISO 27001 / SSDF mapping and audit artifact list.
When to load references
- SAST, SCA, secrets, IaC scans →
references/shift_left_scanning.md
- Pipeline gates, OIDC, GitHub/GitLab hardening →
references/cicd_security_gates.md
- SBOM, signing, dependencies →
references/supply_chain.md
- K8s, CSPM, WAF, runtime →
references/cloud_runtime_security.md
- STRIDE, abuse cases, review templates →
references/threat_modeling.md
- SLAs, SOC 2/ISO evidence →
references/compliance_evidence.md
1---2name: devsecops3description: Guides DevSecOps practices that embed security into software delivery—shift-left scanning, CI/CD security gates, supply-chain integrity, cloud/container runtime controls, threat modeling, and vulnerability management with audit evidence. Use when designing or hardening delivery pipelines, adding SAST/SCA/secrets/IaC/container scans, implementing SBOMs or artifact signing, configuring OIDC and least-privilege CI/CD, writing OPA/Kyverno policies, triaging CVEs, mapping controls to SOC 2/ISO 27001/SSDF, securing GitHub Actions or agentic CI workflows, or running pre-release security reviews—not for general cloud provisioning without a security lens (use infrastructure-engineer), LLM prompt guardrails (prompt-engineer), or cluster Helm/add-on operations without security policy focus (cluster-deployment-engineer), or authorized manual web/API pentest (web-pentester), or binary/firmware RE (reverse-engineer).4---56# DevSecOps78## When to Use910- Add or harden SAST, SCA, secrets, IaC, DAST, or container scans in CI/CD11- Configure protected-branch security gates, artifact signing, SBOMs, provenance, or OIDC federation12- Triage pipeline security findings and define remediation SLAs or exception workflows13- Secure GitHub Actions, GitLab CI, build containers, registries, and deployment credentials14- Map delivery artifacts to SOC 2, ISO 27001, SSDF, or supply-chain evidence requirements1516## When NOT to Use1718- Provision general cloud infrastructure without a security gate focus → `infrastructure-engineer`19- Operate build/deploy pipelines without security requirements → `devops`20- Implement corporate IdP, KMS, PAM, SIEM, or EDR controls → `information-security-engineer`21- IAM entitlement design, access reviews, federation (non-pipeline) → `iam-specialist`22- Triage live SOC alerts or run SOAR playbooks → `soc-analyst`23- Threat hunts or SIEM detection authoring → `defensive-security-analyst`24- Define company-wide security strategy or GRC roadmap → `cybersecurity`25- Bootstrap clusters, Helm releases, ingress, routine pod debug → `cluster-deployment-engineer`26- Execute authorized penetration tests or exploit PoCs → `penetration-tester`27- Manual web/API OWASP testing and retest → `web-pentester`28- Disassembly, decompilation, patch diff, or malware RE lab work → `reverse-engineer`2930## Related skills3132| Need | Skill |33|---|---|34| VPC, K8s platform, IaC provisioning, generic CI/CD | `infrastructure-engineer` |35| AI agent workflows in CI (Codex, Claude Action, prompt injection) | `agentic-actions-auditor` (if installed) |36| Application threat models from repo structure | `security-threat-model` (if installed) |37| Data governance, PII in warehouses | `data-architect` |38| Security runbooks and customer-facing docs | `tech-writer-researcher` |39| Platform IAM, KMS, SIEM/EDR operations | `information-security-engineer` |40| Workforce IAM, reviews, federation, PAM policy | `iam-specialist` |41| Cloud org guardrails, CSPM, multi-account posture | `cloud-security-engineer` |42| Product tenancy, service authZ, customer data isolation | `product-infrastructure-security-engineer` |43| Audit evidence pipelines and control mapping | `compliance-engineer` |44| Pipeline compromise incident response | `incident-responder` |45| Binary RE, patch diff, defensive malware analysis | `reverse-engineer` |46| K8s workload deploy and cluster day-2 ops | `cluster-deployment-engineer` |47| External researcher disclosure program | `technical-program-manager-security-cvd` |48| Authorized pentest and retest | `penetration-tester` |49| Manual web/API OWASP testing | `web-pentester` |5051## Core Workflows5253### 1. Shift-left security baseline5455**Apply on every repo before merge to default branch:**56571. Inventory languages, build tool, deploy target, and compliance scope582. Enable secret scanning and push protection on the org/repo593. Add SAST + SCA in CI on pull requests (fail on new critical/high)604. Scan IaC on `terraform plan` / manifest changes (Checkov, tfsec, KICS)615. Scan container images before registry push (Trivy, Grype)626. Document exceptions with owner, expiry, and compensating control6364**Gate policy (default):**6566| Finding | PR | Default branch | Production deploy |67|---|---|---|---|68| Secret in code | Block | Block | Block |69| Critical CVE (exploitable) | Block | Block | Block |70| High CVE | Warn or block | Block | Block with exception |71| Medium/low | Warn | Track | Track |7273**See `references/shift_left_scanning.md` for tool matrices, baseline configs, and false-positive handling.**7475### 2. CI/CD security gates7677**Pipeline order (security stages must not be skippable on protected branches):**7879```80lint → unit test → SAST/SCA → build → image scan → sign/SBOM → deploy staging → DAST (if applicable) → promote prod81```8283**Checklist:**8485- [ ] Use OIDC federation to cloud/K8s—no long-lived cloud keys in CI secrets86- [ ] Pin actions/images by digest or immutable version; allowlist third-party actions87- [ ] Separate build (untrusted) from deploy (trusted) jobs with environment protection rules88- [ ] Require code review + passing checks on default branch89- [ ] Store artifacts in immutable registry; verify signatures at deploy90- [ ] Log retention for audit (who deployed what, from which commit)9192**See `references/cicd_security_gates.md` for GitHub Actions/GitLab patterns, OIDC, and deployment controls.**9394### 3. Supply chain integrity9596**Minimum viable supply chain for production services:**97981. Generate SBOM (CycloneDX or SPDX) on each release build992. Sign container images and/or provenance (Sigstore/cosign, SLSA-oriented attestations where required)1003. Block dependencies with known critical CVEs unless documented exception1014. Prefer pinned lockfiles; review major dependency upgrades in PR1025. Vet new third-party actions, Helm charts, and base images103104**See `references/supply_chain.md` for SBOM fields, signing flows, and dependency update policy.**105106### 4. Cloud, container, and runtime security107108**Pre-production checklist:**109110- [ ] Workloads in private subnets; ingress only via LB/WAF111- [ ] Non-root containers, read-only root FS, dropped capabilities, no privileged pods112- [ ] Network policies or service mesh mTLS for east-west traffic113- [ ] Secrets from Vault/Secrets Manager/External Secrets—not in manifests or env in git114- [ ] CSPM/posture alerts wired to on-call for critical misconfigurations115- [ ] Runtime detection (Falco, cloud-native threat detection) for production clusters116117**See `references/cloud_runtime_security.md` for K8s admission policies, WAF, and CSPM triage.**118119### 5. Threat modeling and security review120121**Lightweight review (every feature with auth, payments, PII, or external input):**1221231. Draw data flow: actors, trust boundaries, stores, external APIs1242. List assets and STRIDE threats per boundary1253. Map mitigations to existing controls or new tickets1264. Record accepted risks with approver and review date127128**Deeper review triggers:** new public API, auth model change, multi-tenant isolation change, crypto design, admin tooling, agent/LLM in production path.129130**See `references/threat_modeling.md` for STRIDE prompts, abuse-case templates, and review cadence.**131132### 6. Vulnerability management and compliance evidence133134**Triage workflow:**1351361. Normalize findings (tool, CVE, asset, environment, exploitability)1372. Score with CVSS + business context (internet-facing, data class, compensating controls)1383. Assign owner and remediation SLA (see reference SLAs)1394. Verify fix in CI rescan before closing1405. Aggregate metrics: MTTR, open critical count, recurring classes141142**Compliance:** map controls to delivery artifacts (pipeline configs, scan reports, access reviews, change tickets).143144**See `references/compliance_evidence.md` for SOC 2 / ISO 27001 / SSDF mapping and audit artifact list.**145146## When to load references147148- **SAST, SCA, secrets, IaC scans** → `references/shift_left_scanning.md`149- **Pipeline gates, OIDC, GitHub/GitLab hardening** → `references/cicd_security_gates.md`150- **SBOM, signing, dependencies** → `references/supply_chain.md`151- **K8s, CSPM, WAF, runtime** → `references/cloud_runtime_security.md`152- **STRIDE, abuse cases, review templates** → `references/threat_modeling.md`153- **SLAs, SOC 2/ISO evidence** → `references/compliance_evidence.md`