# lambdatest/rook architecture

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

- Interactive diagram: https://gitdiagram.com/lambdatest/rook
- Repository: https://github.com/lambdatest/rook

## Overview

This repository documents Rook, a terminal-based agent assurance product, but the available runtime source is specifically the companion coding-agent skill installer. The installer CLI accepts install, update, or uninstall requests, then delegates to the installer, which validates ownership and safely stages or removes skill copies for selected coding-agent clients. The README describes Rook’s broader explore-to-scenarios-to-run-to-verdict workflow and capabilities, but their implementation is not present in the supplied source index/tree; those product subsystems are therefore not mapped as runtime components.

Main entry points: [`skill-installer/lib/installer.js`](https://github.com/lambdatest/rook/blob/main/skill-installer/lib/installer.js) (Skill management), [`skill-installer/cli.js`](https://github.com/lambdatest/rook/blob/main/skill-installer/cli.js) (Installer CLI), [`skill-installer/skills`](https://github.com/lambdatest/rook/tree/main/skill-installer/skills) (Bundled skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_installer["Skill installer"]
  node_cli["Installer CLI<br/>[cli.js]"]
  node_manage["Skill management<br/>[installer.js]"]
end

node_user(("CLI user"))
node_agent_clients["Agent clients"]
node_skill_bundle["Bundled skill"]

node_user -->|"requests install"| node_cli
node_cli -->|"delegates action"| node_manage
node_manage -->|"copies bundle"| node_skill_bundle
node_manage -->|"installs or removes"| node_agent_clients

click node_cli "https://github.com/lambdatest/rook/blob/main/skill-installer/cli.js"
click node_manage "https://github.com/lambdatest/rook/blob/main/skill-installer/lib/installer.js"
click node_skill_bundle "https://github.com/lambdatest/rook/tree/main/skill-installer/skills"

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_cli,node_manage,node_user,node_agent_clients toneBlue
class node_skill_bundle toneTeal
```

## Components

### Skill installer

- [Installer CLI](https://github.com/lambdatest/rook/blob/main/skill-installer/cli.js): `skill-installer/cli.js`
- [Skill management](https://github.com/lambdatest/rook/blob/main/skill-installer/lib/installer.js): `skill-installer/lib/installer.js`

### Other components

- **CLI user**
- **Agent clients**
- [Bundled skill](https://github.com/lambdatest/rook/tree/main/skill-installer/skills): `skill-installer/skills`

## Connections

- CLI user → Installer CLI: requests install (evidence: `skill-installer/cli.js`)
- Installer CLI → Skill management: delegates action (evidence: `skill-installer/cli.js`)
- Skill management → Bundled skill: copies bundle (evidence: `skill-installer/lib/installer.js`)
- Skill management → Agent clients: installs or removes (evidence: `skill-installer/lib/installer.js`)
