# yetone/kill-ai-slop architecture

> Architecture diagram of the GitHub repository yetone/kill-ai-slop, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yetone/kill-ai-slop
- Repository: https://github.com/yetone/kill-ai-slop

## Overview

Kill AI Slop combines a multilingual editorial field guide with an agent skill for finding and remediating AI-style design patterns. The website presents a catalogue of tells and interactive before/after examples; the skill scans a project, reports findings for review, and guides fixes. The graph includes documented capabilities whose implementation was not sampled, but avoids inferring unshown page-to-component wiring.

Main entry points: [`website/src/pages`](https://github.com/yetone/kill-ai-slop/tree/main/website/src/pages) (Guide website), [`skill/SKILL.md`](https://github.com/yetone/kill-ai-slop/blob/main/skill/SKILL.md) (Skill workflow), [`skill/scripts/scan.mjs`](https://github.com/yetone/kill-ai-slop/blob/main/skill/scripts/scan.mjs) (Project scanner), [`website/src/data/catalogue.ts`](https://github.com/yetone/kill-ai-slop/blob/main/website/src/data/catalogue.ts) (Tell catalogue)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guide["Field Guide"]
  node_guide_site["Guide website"]
  node_guide_layout["Site layout"]
  node_guide_components["Page components"]
  node_guide_styles["Site styles"]
end

subgraph group_content["Catalogue Content"]
  node_catalogue["Tell catalogue<br/>[catalogue.ts]"]
  node_translations["Translations<br/>[catalogue.i18n.ts]"]
  node_demos["Before/after demos<br/>[demos.ts]"]
end

subgraph group_scanner["Project Scanner"]
  node_scanner["Project scanner<br/>[scan.mjs]"]
  node_custom_rules["Custom rules<br/>[rules.ru.mjs]"]
end

subgraph group_skill["Skill Guidance"]
  node_skill_definition["Skill workflow<br/>[SKILL.md]"]
  node_detection["Detection guide<br/>[detection.md]"]
  node_taxonomy["Tell taxonomy<br/>[taxonomy.md]"]
  node_fixes["Remediation playbook<br/>[fixes.md]"]
end

node_reader(("Site visitor"))
node_agent(("Coding agent"))
node_target_project["Web project"]

node_reader -->|"visits"| node_guide_site
node_guide_site -->|"presents tells"| node_catalogue
node_guide_site -->|"shows examples"| node_demos
node_catalogue -->|"supplements entries"| node_translations
node_agent -->|"invokes skill"| node_skill_definition
node_skill_definition -->|"runs scan"| node_scanner
node_scanner -->|"scans files"| node_target_project
node_scanner -->|"loads optionally"| node_custom_rules
node_scanner -->|"uses patterns"| node_detection
node_skill_definition -->|"consults taxonomy"| node_taxonomy
node_skill_definition -->|"guides remediation"| node_fixes
node_skill_definition -->|"triages findings"| node_scanner
node_guide_site -.-> node_guide_layout
node_guide_site -.-> node_guide_components
node_guide_site -.-> node_guide_styles

click node_guide_site "https://github.com/yetone/kill-ai-slop/tree/main/website/src/pages"
click node_guide_layout "https://github.com/yetone/kill-ai-slop/tree/main/website/src/layouts"
click node_guide_components "https://github.com/yetone/kill-ai-slop/tree/main/website/src/components"
click node_guide_styles "https://github.com/yetone/kill-ai-slop/tree/main/website/src/styles"
click node_catalogue "https://github.com/yetone/kill-ai-slop/blob/main/website/src/data/catalogue.ts"
click node_translations "https://github.com/yetone/kill-ai-slop/blob/main/website/src/data/catalogue.i18n.ts"
click node_demos "https://github.com/yetone/kill-ai-slop/blob/main/website/src/data/demos.ts"
click node_skill_definition "https://github.com/yetone/kill-ai-slop/blob/main/skill/SKILL.md"
click node_scanner "https://github.com/yetone/kill-ai-slop/blob/main/skill/scripts/scan.mjs"
click node_custom_rules "https://github.com/yetone/kill-ai-slop/blob/main/skill/scripts/rules.ru.mjs"
click node_detection "https://github.com/yetone/kill-ai-slop/blob/main/skill/references/detection.md"
click node_taxonomy "https://github.com/yetone/kill-ai-slop/blob/main/skill/references/taxonomy.md"
click node_fixes "https://github.com/yetone/kill-ai-slop/blob/main/skill/references/fixes.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_guide_site,node_guide_layout,node_guide_components,node_guide_styles toneBlue
class node_catalogue,node_translations,node_demos toneAmber
class node_scanner,node_custom_rules toneMint
class node_skill_definition,node_detection,node_taxonomy,node_fixes toneRose
class node_reader,node_agent,node_target_project toneIndigo
```

## Components

### Field Guide

- [Guide website](https://github.com/yetone/kill-ai-slop/tree/main/website/src/pages): `website/src/pages`
- [Site layout](https://github.com/yetone/kill-ai-slop/tree/main/website/src/layouts): `website/src/layouts`
- [Page components](https://github.com/yetone/kill-ai-slop/tree/main/website/src/components): `website/src/components`
- [Site styles](https://github.com/yetone/kill-ai-slop/tree/main/website/src/styles): `website/src/styles`

### Catalogue Content

- [Tell catalogue](https://github.com/yetone/kill-ai-slop/blob/main/website/src/data/catalogue.ts): `website/src/data/catalogue.ts`
- [Translations](https://github.com/yetone/kill-ai-slop/blob/main/website/src/data/catalogue.i18n.ts): `website/src/data/catalogue.i18n.ts`
- [Before/after demos](https://github.com/yetone/kill-ai-slop/blob/main/website/src/data/demos.ts): `website/src/data/demos.ts`

### Project Scanner

- [Project scanner](https://github.com/yetone/kill-ai-slop/blob/main/skill/scripts/scan.mjs): `skill/scripts/scan.mjs`
- [Custom rules](https://github.com/yetone/kill-ai-slop/blob/main/skill/scripts/rules.ru.mjs): `skill/scripts/rules.ru.mjs`

### Skill Guidance

- [Skill workflow](https://github.com/yetone/kill-ai-slop/blob/main/skill/SKILL.md): `skill/SKILL.md`
- [Detection guide](https://github.com/yetone/kill-ai-slop/blob/main/skill/references/detection.md): `skill/references/detection.md`
- [Tell taxonomy](https://github.com/yetone/kill-ai-slop/blob/main/skill/references/taxonomy.md): `skill/references/taxonomy.md`
- [Remediation playbook](https://github.com/yetone/kill-ai-slop/blob/main/skill/references/fixes.md): `skill/references/fixes.md`

### Other components

- **Site visitor**
- **Coding agent**
- **Web project**

## Connections

- Site visitor → Guide website: visits (evidence: `README.md`)
- Guide website → Tell catalogue: presents tells (evidence: `README.md`)
- Guide website → Before/after demos: shows examples (evidence: `README.md`)
- Tell catalogue → Translations: supplements entries (evidence: `website/src/data/catalogue.ts`)
- Coding agent → Skill workflow: invokes skill (evidence: `README.md`)
- Skill workflow → Project scanner: runs scan (evidence: `README.md`)
- Project scanner → Web project: scans files (evidence: `skill/scripts/scan.mjs`)
- Project scanner → Custom rules: loads optionally (evidence: `skill/scripts/scan.mjs`)
- Project scanner → Detection guide: uses patterns (evidence: `README.md`)
- Skill workflow → Tell taxonomy: consults taxonomy (evidence: `README.md`)
- Skill workflow → Remediation playbook: guides remediation (evidence: `README.md`)
- Skill workflow → Project scanner: triages findings (evidence: `README.md`)
- Guide website → Site layout
- Guide website → Page components
- Guide website → Site styles
