# bogdaniel/sentinel-shield architecture

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

- Interactive diagram: https://gitdiagram.com/bogdaniel/sentinel-shield
- Repository: https://github.com/bogdaniel/sentinel-shield

## Overview

Sentinel Shield is a reusable security, quality, architecture, CI/CD, and release-gate baseline adopted by engineering teams across supported stacks. Its principal workflow is to select an adoption mode and stack profile, apply the baseline, collect and normalize project evidence, then resolve gates and determine release readiness. Separate capabilities include policy enforcement, workflow templates, scanner integrations, and operational health checks. The README documents these product areas; sampled source confirms several evidence adapters. Unsampled engine behavior and most subsystem connections are therefore omitted or left unverified.

Main entry points: [`scripts/install-baseline.sh`](https://github.com/bogdaniel/sentinel-shield/blob/master/scripts/install-baseline.sh) (Baseline install), [`scripts/collectors`](https://github.com/bogdaniel/sentinel-shield/tree/master/scripts/collectors) (Raw evidence), [`profiles`](https://github.com/bogdaniel/sentinel-shield/tree/master/profiles) (Stack profiles), [`scripts/adapters`](https://github.com/bogdaniel/sentinel-shield/tree/master/scripts/adapters) (Evidence adapters)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_adoption["Adoption"]
  node_profiles["Stack profiles"]
  node_install["Baseline install"]
  node_upgrade["Upgrade planning<br/>[plan-upgrade.sh]"]
  node_workflow_templates["Workflow templates"]
end

subgraph group_assurance["Assurance"]
  node_collectors["Evidence collectors"]
  node_adapters["Evidence adapters"]
  node_evidence["Raw evidence"]
  node_scanner_audits["Scanner audits"]
  node_semgrep_rules["Semgrep rules"]
  node_opa_policies["OPA policies"]
end

subgraph group_governance["Governance"]
  node_gate_resolution["Gate resolution<br/>[resolve-gates.sh]"]
  node_security_policy["Security policy"]
  node_release_readiness["Release readiness"]
  node_release_evidence["Release evidence"]
end

subgraph group_operations["Operations"]
  node_health["Operational health<br/>[health.sh]"]
end

node_team(("Engineering team"))
node_project(("Adopting project"))

node_team -->|"selects stack"| node_profiles
node_team -->|"applies baseline"| node_install
node_profiles -.->|"configures adoption"| node_install
node_install -->|"copies baseline"| node_project
node_team -->|"plans upgrade"| node_upgrade
node_team -->|"adopts workflows"| node_workflow_templates
node_project -.->|"runs checks"| node_collectors
node_collectors -.->|"produces evidence"| node_evidence
node_adapters -->|"normalizes reports"| node_evidence
node_scanner_audits -.->|"reports audit results"| node_evidence
node_team -->|"uses security rules"| node_semgrep_rules
node_team -->|"uses policy rules"| node_opa_policies
node_team -->|"resolves gates"| node_gate_resolution
node_team -->|"enforces security"| node_security_policy
node_team -->|"checks readiness"| node_release_readiness
node_team -->|"collects evidence"| node_release_evidence
node_team -->|"checks health"| node_health

click node_profiles "https://github.com/bogdaniel/sentinel-shield/tree/master/profiles"
click node_install "https://github.com/bogdaniel/sentinel-shield/blob/master/scripts/install-baseline.sh"
click node_upgrade "https://github.com/bogdaniel/sentinel-shield/blob/master/scripts/plan-upgrade.sh"
click node_workflow_templates "https://github.com/bogdaniel/sentinel-shield/tree/master/templates/workflows"
click node_collectors "https://github.com/bogdaniel/sentinel-shield/tree/master/scripts/collectors"
click node_adapters "https://github.com/bogdaniel/sentinel-shield/tree/master/scripts/adapters"
click node_evidence "https://github.com/bogdaniel/sentinel-shield/tree/master/scripts/collectors"
click node_scanner_audits "https://github.com/bogdaniel/sentinel-shield/tree/master/scripts/audits"
click node_semgrep_rules "https://github.com/bogdaniel/sentinel-shield/tree/master/semgrep"
click node_opa_policies "https://github.com/bogdaniel/sentinel-shield/tree/master/policies/opa"
click node_gate_resolution "https://github.com/bogdaniel/sentinel-shield/blob/master/scripts/resolve-gates.sh"
click node_security_policy "https://github.com/bogdaniel/sentinel-shield/blob/master/scripts/enforce-security-policy.sh"
click node_release_readiness "https://github.com/bogdaniel/sentinel-shield/blob/master/scripts/check-release-readiness.sh"
click node_release_evidence "https://github.com/bogdaniel/sentinel-shield/blob/master/scripts/collect-release-evidence.sh"
click node_health "https://github.com/bogdaniel/sentinel-shield/blob/master/scripts/health.sh"

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_profiles,node_install,node_upgrade,node_workflow_templates toneBlue
class node_collectors,node_adapters,node_evidence,node_scanner_audits,node_semgrep_rules,node_opa_policies toneAmber
class node_gate_resolution,node_security_policy,node_release_readiness,node_release_evidence toneMint
class node_health toneRose
class node_team,node_project toneIndigo
```

## Components

### Adoption

- [Stack profiles](https://github.com/bogdaniel/sentinel-shield/tree/master/profiles): `profiles`
- [Baseline install](https://github.com/bogdaniel/sentinel-shield/blob/master/scripts/install-baseline.sh): `scripts/install-baseline.sh`
- [Upgrade planning](https://github.com/bogdaniel/sentinel-shield/blob/master/scripts/plan-upgrade.sh): `scripts/plan-upgrade.sh`
- [Workflow templates](https://github.com/bogdaniel/sentinel-shield/tree/master/templates/workflows): `templates/workflows`

### Assurance

- [Evidence collectors](https://github.com/bogdaniel/sentinel-shield/tree/master/scripts/collectors): `scripts/collectors`
- [Evidence adapters](https://github.com/bogdaniel/sentinel-shield/tree/master/scripts/adapters): `scripts/adapters`
- [Raw evidence](https://github.com/bogdaniel/sentinel-shield/tree/master/scripts/collectors): `scripts/collectors`
- [Scanner audits](https://github.com/bogdaniel/sentinel-shield/tree/master/scripts/audits): `scripts/audits`
- [Semgrep rules](https://github.com/bogdaniel/sentinel-shield/tree/master/semgrep): `semgrep`
- [OPA policies](https://github.com/bogdaniel/sentinel-shield/tree/master/policies/opa): `policies/opa`

### Governance

- [Gate resolution](https://github.com/bogdaniel/sentinel-shield/blob/master/scripts/resolve-gates.sh): `scripts/resolve-gates.sh`
- [Security policy](https://github.com/bogdaniel/sentinel-shield/blob/master/scripts/enforce-security-policy.sh): `scripts/enforce-security-policy.sh`
- [Release readiness](https://github.com/bogdaniel/sentinel-shield/blob/master/scripts/check-release-readiness.sh): `scripts/check-release-readiness.sh`
- [Release evidence](https://github.com/bogdaniel/sentinel-shield/blob/master/scripts/collect-release-evidence.sh): `scripts/collect-release-evidence.sh`

### Operations

- [Operational health](https://github.com/bogdaniel/sentinel-shield/blob/master/scripts/health.sh): `scripts/health.sh`

### Other components

- **Engineering team**
- **Adopting project**

## Connections

- Engineering team → Stack profiles: selects stack (evidence: `README.md`)
- Engineering team → Baseline install: applies baseline (evidence: `README.md`)
- Stack profiles → Baseline install: configures adoption
- Baseline install → Adopting project: copies baseline (evidence: `README.md`)
- Engineering team → Upgrade planning: plans upgrade (evidence: `README.md`)
- Engineering team → Workflow templates: adopts workflows (evidence: `README.md`)
- Adopting project → Evidence collectors: runs checks
- Evidence collectors → Raw evidence: produces evidence
- Evidence adapters → Raw evidence: normalizes reports (evidence: `scripts/adapters/istanbul-summary-to-coverage-json.mjs`)
- Scanner audits → Raw evidence: reports audit results
- Engineering team → Semgrep rules: uses security rules (evidence: `README.md`)
- Engineering team → OPA policies: uses policy rules (evidence: `README.md`)
- Engineering team → Gate resolution: resolves gates (evidence: `README.md`)
- Engineering team → Security policy: enforces security (evidence: `README.md`)
- Engineering team → Release readiness: checks readiness (evidence: `README.md`)
- Engineering team → Release evidence: collects evidence (evidence: `README.md`)
- Engineering team → Operational health: checks health (evidence: `README.md`)
