# ann-ette/chatbot-compliance-kit architecture

> Architecture diagram of the GitHub repository ann-ette/chatbot-compliance-kit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ann-ette/chatbot-compliance-kit
- Repository: https://github.com/ann-ette/chatbot-compliance-kit

## Overview

chatbot-compliance-kit is a builder-facing compliance playbook, not a chatbot runtime. Its main workflow is to assess whether a product is in scope, use the law map and calendar to orient work, then apply duty cards as build specifications. The cards cover five core obligations plus platform and operational discipline, and describe acceptance criteria, tests, and evidence to retain. The tree also shows templates and probe files; because no source excerpts were provided and the README excerpt does not describe their specific connections, those links are omitted.

Main entry points: [`checklists/self-assessment.md`](https://github.com/ann-ette/chatbot-compliance-kit/blob/main/checklists/self-assessment.md) (Self-assessment), [`MATRIX.md`](https://github.com/ann-ette/chatbot-compliance-kit/blob/main/MATRIX.md) (Law Map), [`CALENDAR.md`](https://github.com/ann-ette/chatbot-compliance-kit/blob/main/CALENDAR.md) (Compliance Calendar), [`cards/engagement`](https://github.com/ann-ette/chatbot-compliance-kit/tree/main/cards/engagement) (Engagement Duties)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orientation["Assessment &amp; Planning"]
  node_assessment["Self-assessment<br/>[self-assessment.md]"]
  node_lawmap["Law Map<br/>[MATRIX.md]"]
  node_calendar["Compliance Calendar<br/>[CALENDAR.md]"]
end

subgraph group_duties["Compliance Duties"]
  node_disclosure["Disclosure Duties"]
  node_crisis["Crisis Duties"]
  node_minors["Minor Protections"]
  node_engagement["Engagement Duties"]
  node_data["Data Duties"]
  node_platform["Platform Duties"]
  node_process["Process Duties"]
end

subgraph group_operations["Operational Resources"]
  node_templates["Implementation Templates"]
end

subgraph group_verification["Verification"]
  node_crisisprobes["Crisis Probes<br/>[crisis-probes.yaml]"]
  node_disclosurechecks["Disclosure Checks"]
  node_identityprobes["Identity Probes"]
end

node_builder(("Product Builder"))

node_builder -->|"starts with"| node_assessment
node_assessment -->|"continue with"| node_engagement
node_builder -->|"consults"| node_lawmap
node_builder -->|"consults"| node_calendar

click node_assessment "https://github.com/ann-ette/chatbot-compliance-kit/blob/main/checklists/self-assessment.md"
click node_lawmap "https://github.com/ann-ette/chatbot-compliance-kit/blob/main/MATRIX.md"
click node_calendar "https://github.com/ann-ette/chatbot-compliance-kit/blob/main/CALENDAR.md"
click node_disclosure "https://github.com/ann-ette/chatbot-compliance-kit/tree/main/cards/disclosure"
click node_crisis "https://github.com/ann-ette/chatbot-compliance-kit/tree/main/cards/crisis"
click node_minors "https://github.com/ann-ette/chatbot-compliance-kit/tree/main/cards/minors"
click node_engagement "https://github.com/ann-ette/chatbot-compliance-kit/tree/main/cards/engagement"
click node_data "https://github.com/ann-ette/chatbot-compliance-kit/tree/main/cards/data"
click node_platform "https://github.com/ann-ette/chatbot-compliance-kit/tree/main/cards/platform"
click node_process "https://github.com/ann-ette/chatbot-compliance-kit/tree/main/cards/process"
click node_templates "https://github.com/ann-ette/chatbot-compliance-kit/tree/main/templates"
click node_crisisprobes "https://github.com/ann-ette/chatbot-compliance-kit/blob/main/tests/crisis-probes.yaml"
click node_disclosurechecks "https://github.com/ann-ette/chatbot-compliance-kit/blob/main/tests/disclosure-checks.yaml"
click node_identityprobes "https://github.com/ann-ette/chatbot-compliance-kit/blob/main/tests/identity-probes.yaml"

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_assessment,node_lawmap,node_calendar toneBlue
class node_disclosure,node_crisis,node_minors,node_engagement,node_data,node_platform,node_process toneAmber
class node_templates toneMint
class node_crisisprobes,node_disclosurechecks,node_identityprobes toneRose
class node_builder toneIndigo
```

## Components

### Assessment & Planning

- [Self-assessment](https://github.com/ann-ette/chatbot-compliance-kit/blob/main/checklists/self-assessment.md): `checklists/self-assessment.md`
- [Law Map](https://github.com/ann-ette/chatbot-compliance-kit/blob/main/MATRIX.md): `MATRIX.md`
- [Compliance Calendar](https://github.com/ann-ette/chatbot-compliance-kit/blob/main/CALENDAR.md): `CALENDAR.md`

### Compliance Duties

- [Disclosure Duties](https://github.com/ann-ette/chatbot-compliance-kit/tree/main/cards/disclosure): `cards/disclosure`
- [Crisis Duties](https://github.com/ann-ette/chatbot-compliance-kit/tree/main/cards/crisis): `cards/crisis`
- [Minor Protections](https://github.com/ann-ette/chatbot-compliance-kit/tree/main/cards/minors): `cards/minors`
- [Engagement Duties](https://github.com/ann-ette/chatbot-compliance-kit/tree/main/cards/engagement): `cards/engagement`
- [Data Duties](https://github.com/ann-ette/chatbot-compliance-kit/tree/main/cards/data): `cards/data`
- [Platform Duties](https://github.com/ann-ette/chatbot-compliance-kit/tree/main/cards/platform): `cards/platform`
- [Process Duties](https://github.com/ann-ette/chatbot-compliance-kit/tree/main/cards/process): `cards/process`

### Operational Resources

- [Implementation Templates](https://github.com/ann-ette/chatbot-compliance-kit/tree/main/templates): `templates`

### Verification

- [Crisis Probes](https://github.com/ann-ette/chatbot-compliance-kit/blob/main/tests/crisis-probes.yaml): `tests/crisis-probes.yaml`
- [Disclosure Checks](https://github.com/ann-ette/chatbot-compliance-kit/blob/main/tests/disclosure-checks.yaml): `tests/disclosure-checks.yaml`
- [Identity Probes](https://github.com/ann-ette/chatbot-compliance-kit/blob/main/tests/identity-probes.yaml): `tests/identity-probes.yaml`

### Other components

- **Product Builder**

## Connections

- Product Builder → Self-assessment: starts with (evidence: `README.md`)
- Self-assessment → Engagement Duties: continue with (evidence: `README.md`)
- Product Builder → Law Map: consults (evidence: `README.md`)
- Product Builder → Compliance Calendar: consults (evidence: `README.md`)
