# commonwealth-bank-of-australia/codecheck architecture

> Architecture diagram of the GitHub repository commonwealth-bank-of-australia/codecheck, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/commonwealth-bank-of-australia/codecheck
- Repository: https://github.com/commonwealth-bank-of-australia/codecheck

## Overview

CodeCheck is a coding-agent plugin for LLM-assisted security reviews. The user requests a review through Claude Code or Codex; the `codecheck` skill orchestrates scope, specialist discovery, independent finding review, and a final report returned in the agent. Shared finding rules guide hunters and reviewers. The README documents these stages and relationships; the repository tree shows the prompt files, but no runtime implementation was sampled, so the graph reflects the documented workflow rather than internal execution details.

Main entry points: [`skills/codecheck/SKILL.md`](https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/SKILL.md) (CodeCheck orchestrator), [`skills/codecheck/references/agents/cwe-scope.md`](https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/references/agents/cwe-scope.md) (CWE scope agent), [`skills/codecheck/references/agents/cwe-hunter.md`](https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/references/agents/cwe-hunter.md) (CWE hunters), [`skills/codecheck/references/agents/open-hunter.md`](https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/references/agents/open-hunter.md) (Open hunter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Review orchestration"]
  node_codecheck_skill["CodeCheck orchestrator<br/>[SKILL.md]"]
end

subgraph group_discovery["Discovery agents"]
  node_scope_agent["CWE scope agent<br/>[cwe-scope.md]"]
  node_cwe_hunter["CWE hunters<br/>[cwe-hunter.md]"]
  node_open_hunter["Open hunter<br/>[open-hunter.md]"]
  node_design_hunter["Design flaw hunter"]
  node_malicious_hunter["Malicious code hunter"]
end

subgraph group_review["Finding review and output"]
  node_finding_rules["Finding authoring rules<br/>[SKILL.md]"]
  node_finding_reviewer["Finding reviewer"]
  node_findings_report["Findings report"]
end

node_user(("Reviewer"))
node_coding_agent["Claude Code or Codex"]
node_reviewed_code["Code under review"]

node_user -->|"requests review"| node_coding_agent
node_coding_agent -->|"invokes skill"| node_codecheck_skill
node_coding_agent -->|"provides scope"| node_reviewed_code
node_codecheck_skill -->|"briefs scope"| node_scope_agent
node_codecheck_skill -->|"briefs hunters"| node_cwe_hunter
node_codecheck_skill -->|"briefs hunter"| node_open_hunter
node_codecheck_skill -->|"briefs hunter"| node_design_hunter
node_codecheck_skill -->|"briefs hunter"| node_malicious_hunter
node_codecheck_skill -->|"shares rules"| node_finding_rules
node_codecheck_skill -->|"briefs reviewers"| node_finding_reviewer
node_codecheck_skill -->|"writes report"| node_findings_report
node_codecheck_skill -->|"returns findings"| node_coding_agent

click node_codecheck_skill "https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/SKILL.md"
click node_scope_agent "https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/references/agents/cwe-scope.md"
click node_cwe_hunter "https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/references/agents/cwe-hunter.md"
click node_open_hunter "https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/references/agents/open-hunter.md"
click node_design_hunter "https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/references/agents/design-flaw-hunter.md"
click node_malicious_hunter "https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/references/agents/malicious-code-hunter.md"
click node_finding_rules "https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/finding-authoring/SKILL.md"
click node_finding_reviewer "https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/references/agents/security-finding-reviewer.md"

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_codecheck_skill,node_user,node_reviewed_code toneBlue
class node_scope_agent,node_cwe_hunter,node_open_hunter,node_design_hunter,node_malicious_hunter toneAmber
class node_finding_rules,node_finding_reviewer,node_findings_report toneMint
class node_coding_agent toneIndigo
```

## Components

### Review orchestration

- [CodeCheck orchestrator](https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/SKILL.md): `skills/codecheck/SKILL.md`

### Discovery agents

- [CWE scope agent](https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/references/agents/cwe-scope.md): `skills/codecheck/references/agents/cwe-scope.md`
- [CWE hunters](https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/references/agents/cwe-hunter.md): `skills/codecheck/references/agents/cwe-hunter.md`
- [Open hunter](https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/references/agents/open-hunter.md): `skills/codecheck/references/agents/open-hunter.md`
- [Design flaw hunter](https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/references/agents/design-flaw-hunter.md): `skills/codecheck/references/agents/design-flaw-hunter.md`
- [Malicious code hunter](https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/references/agents/malicious-code-hunter.md): `skills/codecheck/references/agents/malicious-code-hunter.md`

### Finding review and output

- [Finding authoring rules](https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/finding-authoring/SKILL.md): `skills/finding-authoring/SKILL.md`
- [Finding reviewer](https://github.com/commonwealth-bank-of-australia/codecheck/blob/main/skills/codecheck/references/agents/security-finding-reviewer.md): `skills/codecheck/references/agents/security-finding-reviewer.md`
- **Findings report**

### Other components

- **Reviewer**
- **Claude Code or Codex**
- **Code under review**

## Connections

- Reviewer → Claude Code or Codex: requests review (evidence: `README.md`)
- Claude Code or Codex → CodeCheck orchestrator: invokes skill (evidence: `README.md`)
- Claude Code or Codex → Code under review: provides scope (evidence: `README.md`)
- CodeCheck orchestrator → CWE scope agent: briefs scope (evidence: `README.md`)
- CodeCheck orchestrator → CWE hunters: briefs hunters (evidence: `README.md`)
- CodeCheck orchestrator → Open hunter: briefs hunter (evidence: `README.md`)
- CodeCheck orchestrator → Design flaw hunter: briefs hunter (evidence: `README.md`)
- CodeCheck orchestrator → Malicious code hunter: briefs hunter (evidence: `README.md`)
- CodeCheck orchestrator → Finding authoring rules: shares rules (evidence: `README.md`)
- CodeCheck orchestrator → Finding reviewer: briefs reviewers (evidence: `README.md`)
- CodeCheck orchestrator → Findings report: writes report (evidence: `README.md`)
- CodeCheck orchestrator → Claude Code or Codex: returns findings (evidence: `README.md`)
