# ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs architecture

> Architecture diagram of the GitHub repository ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs
- Repository: https://github.com/ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs

## Overview

Suite Builder is documented as a proprietary service; its implementation is not present in this repository. The main workflow is a website crawl producing observations used to generate a runnable test suite and a site-health audit. The graph captures documented capabilities and relationships only; component paths are null where the tree provides no implementation source.

Main entry points: [`sample/the-internet-cypress-tests/ai`](https://github.com/ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs/tree/main/sample/the-internet-cypress-tests/ai) (Claude assistance), [`sample/the-internet-cypress-tests/crawl`](https://github.com/ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs/tree/main/sample/the-internet-cypress-tests/crawl) (Crawl observations), [`sample/the-internet-cypress-tests`](https://github.com/ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs/tree/main/sample/the-internet-cypress-tests) (Cypress suite), [`sample/the-internet-cypress-tests/AUDIT.html`](https://github.com/ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs/blob/main/sample/the-internet-cypress-tests/AUDIT.html) (Site audit)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Site discovery"]
  node_crawler["Site crawler"]
  node_crawl_observations["Crawl observations"]
  node_site_audit["Site audit<br/>[AUDIT.html]"]
end

subgraph group_generation["Suite generation"]
  node_suite_builder["Suite Builder"]
  node_suite_validation["Suite validation"]
  node_playwright_suite["Playwright suite"]
  node_selenium_suite["Selenium suite"]
  node_cypress_suite["Cypress suite"]
  node_test_pipeline["CI pipeline files"]
end

subgraph group_extensions["Team workflows"]
  node_claude_assistance["Claude assistance"]
  node_user_stories["User stories"]
  node_suite_rebuild["Suite rebuilds"]
end

node_site_owner(("Site owner"))
node_website["Target website"]
node_engineer(("Site engineer"))
node_jira["Jira"]

node_site_owner -->|"requests build"| node_suite_builder
node_suite_builder -->|"reads site"| node_crawler
node_crawler -->|"crawls"| node_website
node_crawler -->|"records observations"| node_crawl_observations
node_suite_builder -->|"produces audit"| node_site_audit
node_suite_builder -->|"machine-checks"| node_suite_validation
node_suite_validation -->|"traces tests"| node_crawl_observations
node_suite_builder -->|"generates"| node_playwright_suite
node_suite_builder -->|"generates"| node_selenium_suite
node_suite_builder -->|"generates"| node_cypress_suite
node_suite_builder -->|"includes pipeline"| node_test_pipeline
node_engineer -->|"runs suite"| node_cypress_suite
node_user_stories -->|"prompt tests"| node_claude_assistance
node_claude_assistance -->|"extends suite"| node_suite_builder
node_jira -->|"provides ready stories"| node_suite_builder
node_suite_builder -->|"updates cards"| node_jira
node_suite_builder -->|"supports rebuilds"| node_suite_rebuild
node_suite_rebuild -->|"preserves changes"| node_engineer

click node_crawl_observations "https://github.com/ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs/tree/main/sample/the-internet-cypress-tests/crawl"
click node_site_audit "https://github.com/ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs/blob/main/sample/the-internet-cypress-tests/AUDIT.html"
click node_cypress_suite "https://github.com/ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs/tree/main/sample/the-internet-cypress-tests"
click node_claude_assistance "https://github.com/ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs/tree/main/sample/the-internet-cypress-tests/ai"

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_crawler,node_crawl_observations,node_site_audit toneBlue
class node_suite_builder,node_suite_validation,node_playwright_suite,node_selenium_suite,node_cypress_suite,node_test_pipeline toneAmber
class node_claude_assistance,node_user_stories,node_suite_rebuild toneMint
class node_site_owner,node_website,node_engineer,node_jira toneIndigo
```

## Components

### Site discovery

- **Site crawler**
- [Crawl observations](https://github.com/ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs/tree/main/sample/the-internet-cypress-tests/crawl): `sample/the-internet-cypress-tests/crawl`
- [Site audit](https://github.com/ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs/blob/main/sample/the-internet-cypress-tests/AUDIT.html): `sample/the-internet-cypress-tests/AUDIT.html`

### Suite generation

- **Suite Builder**
- **Suite validation**
- **Playwright suite**
- **Selenium suite**
- [Cypress suite](https://github.com/ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs/tree/main/sample/the-internet-cypress-tests): `sample/the-internet-cypress-tests`
- **CI pipeline files**

### Team workflows

- [Claude assistance](https://github.com/ghost-in-the-kernel-labs/ghost-in-the-kernel-labs-suite-builder-docs/tree/main/sample/the-internet-cypress-tests/ai): `sample/the-internet-cypress-tests/ai`
- **User stories**
- **Suite rebuilds**

### Other components

- **Site owner**
- **Target website**
- **Site engineer**
- **Jira**

## Connections

- Site owner → Suite Builder: requests build (evidence: `README.md`)
- Suite Builder → Site crawler: reads site (evidence: `README.md`)
- Site crawler → Target website: crawls (evidence: `README.md`)
- Site crawler → Crawl observations: records observations (evidence: `README.md`)
- Suite Builder → Site audit: produces audit (evidence: `README.md`)
- Suite Builder → Suite validation: machine-checks (evidence: `README.md`)
- Suite validation → Crawl observations: traces tests (evidence: `README.md`)
- Suite Builder → Playwright suite: generates (evidence: `README.md`)
- Suite Builder → Selenium suite: generates (evidence: `README.md`)
- Suite Builder → Cypress suite: generates (evidence: `README.md`)
- Suite Builder → CI pipeline files: includes pipeline (evidence: `README.md`)
- Site engineer → Cypress suite: runs suite (evidence: `README.md`)
- User stories → Claude assistance: prompt tests (evidence: `README.md`)
- Claude assistance → Suite Builder: extends suite (evidence: `README.md`)
- Jira → Suite Builder: provides ready stories (evidence: `README.md`)
- Suite Builder → Jira: updates cards (evidence: `README.md`)
- Suite Builder → Suite rebuilds: supports rebuilds (evidence: `README.md`)
- Suite rebuilds → Site engineer: preserves changes (evidence: `README.md`)
