# thomassanson/the-devsecops-toolbox architecture

> Architecture diagram of the GitHub repository thomassanson/the-devsecops-toolbox, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/thomassanson/the-devsecops-toolbox
- Repository: https://github.com/thomassanson/the-devsecops-toolbox

## Overview

The DevSecOps Toolbox combines Task-driven lifecycle workflows, project scaffolding, and configurable quality/security tooling. Its documented user path is to invoke a Task stage (or the complete pipeline), run stage-specific checks and operations, and optionally scaffold and customize a project. The lifecycle files and tool integrations are represented from the tree and README; no source excerpts were provided, so links are limited to documented relationships.

Main entry points: [`Taskfile.yml`](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/Taskfile.yml) (Task control), [`.config/devsecops/Taskfile.code.yml`](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.code.yml) (Code), [`.config/devsecops/Taskfile.build.yml`](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.build.yml) (Build), [`copier.yml`](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/copier.yml) (Copier template)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["DevSecOps lifecycle"]
  node_task_control["Task control<br/>[Taskfile.yml]"]
  node_plan["Plan<br/>[Taskfile.plan.yml]"]
  node_code["Code<br/>[Taskfile.code.yml]"]
  node_build["Build<br/>[Taskfile.build.yml]"]
  node_test["Test<br/>[Taskfile.test.yml]"]
  node_release["Release"]
  node_deploy["Deploy"]
  node_operate["Operate"]
  node_monitor["Monitor"]
  node_feedback["Feedback"]
end

subgraph group_assurance["Quality and security"]
  node_quality_tools["Quality checks<br/>[config.yml]"]
  node_commit_rules["Commit standards<br/>[config.yml]"]
  node_complexity["Complexity analysis<br/>[Taskfile.yml]"]
  node_vulnerability_scan["Vulnerability scans<br/>[config.yml]"]
  node_security_scan["Security scans<br/>[config.yml]"]
end

subgraph group_scaffold["Project scaffolding"]
  node_copier["Copier template<br/>[copier.yml]"]
  node_stage_config["Stage templates"]
  node_project_tasks["Project tasks<br/>[Taskfile.yml]"]
end

subgraph group_environment["Development environment"]
  node_devcontainer["DevContainer<br/>[devcontainer.json]"]
  node_docker["Docker tooling<br/>[Taskfile.yml]"]
end

node_developer(("Developer"))

node_developer -->|"runs tasks"| node_task_control
node_task_control -->|"runs stage"| node_plan
node_task_control -->|"runs stage"| node_code
node_task_control -->|"runs stage"| node_build
node_task_control -->|"runs stage"| node_test
node_task_control -->|"runs stage"| node_release
node_task_control -->|"runs stage"| node_deploy
node_task_control -->|"runs stage"| node_operate
node_task_control -->|"runs stage"| node_monitor
node_task_control -->|"runs stage"| node_feedback
node_code -->|"runs checks"| node_quality_tools
node_code -->|"validates commits"| node_commit_rules
node_code -->|"analyzes complexity"| node_complexity
node_build -->|"builds images"| node_docker
node_build -->|"scans vulnerabilities"| node_vulnerability_scan
node_test -->|"runs security tests"| node_security_scan
node_developer -->|"generates project"| node_copier
node_copier -->|"customizes workflow"| node_project_tasks
node_copier -.->|"uses templates"| node_stage_config
node_developer -->|"uses environment"| node_devcontainer

click node_task_control "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/Taskfile.yml"
click node_plan "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.plan.yml"
click node_code "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.code.yml"
click node_build "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.build.yml"
click node_test "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.test.yml"
click node_release "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.release.yml"
click node_deploy "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.deploy.yml"
click node_operate "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.operate.yml"
click node_monitor "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.monitor.yml"
click node_feedback "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.feedback.yml"
click node_quality_tools "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/megalinter/config.yml"
click node_commit_rules "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/commitlint/config.yml"
click node_complexity "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/lizard/Taskfile.yml"
click node_vulnerability_scan "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/grype/config.yml"
click node_security_scan "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/trivy/config.yml"
click node_copier "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/copier.yml"
click node_stage_config "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.code.yml.jinja"
click node_project_tasks "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/project/Taskfile.yml"
click node_devcontainer "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.devcontainer/ubuntu/devcontainer.json"
click node_docker "https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/docker-ce/Taskfile.yml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_task_control,node_plan,node_code,node_build,node_test,node_release,node_deploy,node_operate,node_monitor,node_feedback toneBlue
class node_quality_tools,node_commit_rules,node_complexity,node_vulnerability_scan,node_security_scan toneAmber
class node_copier,node_stage_config,node_project_tasks toneMint
class node_devcontainer,node_docker toneRose
class node_developer toneIndigo
```

## Components

### DevSecOps lifecycle

- [Task control](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/Taskfile.yml): `Taskfile.yml`
- [Plan](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.plan.yml): `.config/devsecops/Taskfile.plan.yml`
- [Code](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.code.yml): `.config/devsecops/Taskfile.code.yml`
- [Build](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.build.yml): `.config/devsecops/Taskfile.build.yml`
- [Test](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.test.yml): `.config/devsecops/Taskfile.test.yml`
- [Release](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.release.yml): `.config/devsecops/Taskfile.release.yml`
- [Deploy](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.deploy.yml): `.config/devsecops/Taskfile.deploy.yml`
- [Operate](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.operate.yml): `.config/devsecops/Taskfile.operate.yml`
- [Monitor](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.monitor.yml): `.config/devsecops/Taskfile.monitor.yml`
- [Feedback](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.feedback.yml): `.config/devsecops/Taskfile.feedback.yml`

### Quality and security

- [Quality checks](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/megalinter/config.yml): `.config/megalinter/config.yml`
- [Commit standards](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/commitlint/config.yml): `.config/commitlint/config.yml`
- [Complexity analysis](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/lizard/Taskfile.yml): `.config/lizard/Taskfile.yml`
- [Vulnerability scans](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/grype/config.yml): `.config/grype/config.yml`
- [Security scans](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/trivy/config.yml): `.config/trivy/config.yml`

### Project scaffolding

- [Copier template](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/copier.yml): `copier.yml`
- [Stage templates](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/devsecops/Taskfile.code.yml.jinja): `.config/devsecops/Taskfile.code.yml.jinja`
- [Project tasks](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/project/Taskfile.yml): `project/Taskfile.yml`

### Development environment

- [DevContainer](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.devcontainer/ubuntu/devcontainer.json): `.devcontainer/ubuntu/devcontainer.json`
- [Docker tooling](https://github.com/thomassanson/the-devsecops-toolbox/blob/main/.config/docker-ce/Taskfile.yml): `.config/docker-ce/Taskfile.yml`

### Other components

- **Developer**

## Connections

- Developer → Task control: runs tasks (evidence: `README.md`)
- Task control → Plan: runs stage (evidence: `README.md`)
- Task control → Code: runs stage (evidence: `README.md`)
- Task control → Build: runs stage (evidence: `README.md`)
- Task control → Test: runs stage (evidence: `README.md`)
- Task control → Release: runs stage (evidence: `README.md`)
- Task control → Deploy: runs stage (evidence: `README.md`)
- Task control → Operate: runs stage (evidence: `README.md`)
- Task control → Monitor: runs stage (evidence: `README.md`)
- Task control → Feedback: runs stage (evidence: `README.md`)
- Code → Quality checks: runs checks (evidence: `README.md`)
- Code → Commit standards: validates commits (evidence: `README.md`)
- Code → Complexity analysis: analyzes complexity (evidence: `README.md`)
- Build → Docker tooling: builds images (evidence: `README.md`)
- Build → Vulnerability scans: scans vulnerabilities (evidence: `README.md`)
- Test → Security scans: runs security tests (evidence: `README.md`)
- Developer → Copier template: generates project (evidence: `README.md`)
- Copier template → Project tasks: customizes workflow (evidence: `README.md`)
- Copier template → Stage templates: uses templates
- Developer → DevContainer: uses environment (evidence: `README.md`)
