# rasta26/fayahlibrary architecture

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

- Interactive diagram: https://gitdiagram.com/rasta26/fayahlibrary
- Repository: https://github.com/rasta26/fayahlibrary

## Overview

fayahLibrary is a Claude Code plugin library: users install its marketplace plugin and MCP defaults, then invoke commands and skills for coding workflows. The documented main flow runs /spec into /orchestrate, which dispatches agents to implement requirements, followed by review and optional cleanup/tracking or kata practice. The graph also preserves the hook telemetry and optional MCP/external-tool offerings. Runtime source excerpts are limited, so edges reflect README-documented behavior rather than inferred implementation calls.

Main entry points: [`install`](https://github.com/rasta26/fayahlibrary/blob/main/install) (Installer), [`plugins/fayah-core/commands/review.md`](https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/commands/review.md) (/review), [`plugins/fayah-core/commands/orchestrate.md`](https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/commands/orchestrate.md) (/orchestrate), [`mcp/servers.json`](https://github.com/rasta26/fayahlibrary/blob/main/mcp/servers.json) (MCP server catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Development workflow"]
  node_spec["/spec<br/>[spec.md]"]
  node_orchestrate["/orchestrate<br/>[orchestrate.md]"]
  node_manager["Manager agent<br/>[manager.md]"]
  node_subagents["Implementation agents"]
  node_sharedbranch["Shared branch"]
  node_review["/review<br/>[review.md]"]
end

subgraph group_plugin["Plugin capabilities"]
  node_cleanup["/cleanup-audit<br/>[cleanup-audit.md]"]
  node_tracking["/add-tracking<br/>[add-tracking.md]"]
  node_kata["/kata<br/>[kata.md]"]
  node_review_skill["Mentoring review<br/>[SKILL.md]"]
  node_quality_skill["Code quality review<br/>[SKILL.md]"]
  node_tdd_skill["Spec-first TDD<br/>[SKILL.md]"]
  node_kata_skill["Coding kata<br/>[SKILL.md]"]
  node_tracking_skill["Event tracking<br/>[SKILL.md]"]
  node_hook["PostToolUse hook<br/>[hooks.json]"]
  node_event_log[("Local usage log")]
end

subgraph group_integrations["Tool integrations"]
  node_mcp_config["MCP server catalog<br/>[servers.json]"]
  node_default_mcp["Default MCP servers"]
  node_optional_mcp["Optional MCP servers"]
  node_external_catalog["External tools catalog<br/>[catalog.json]"]
end

subgraph group_setup["Installation"]
  node_install["Installer"]
  node_marketplace["Plugin marketplace<br/>[marketplace.json]"]
end

node_user(("Claude Code user"))

node_user -->|"runs"| node_install
node_install -->|"registers"| node_marketplace
node_install -->|"adds defaults"| node_default_mcp
node_install -.->|"installs on request"| node_optional_mcp
node_user -->|"invokes"| node_spec
node_spec -->|"defines requirements"| node_orchestrate
node_user -->|"invokes"| node_orchestrate
node_orchestrate -->|"runs"| node_manager
node_manager -->|"dispatches"| node_subagents
node_subagents -->|"merge work"| node_sharedbranch
node_user -->|"invokes"| node_review
node_review -->|"uses"| node_review_skill
node_user -->|"invokes"| node_cleanup
node_user -->|"invokes"| node_tracking
node_tracking -.->|"uses"| node_tracking_skill
node_user -->|"invokes"| node_kata
node_review -->|"practice findings"| node_kata
node_hook -->|"logs locally"| node_event_log
node_mcp_config -->|"curates"| node_default_mcp
node_mcp_config -->|"lists optional"| node_optional_mcp
node_external_catalog -.->|"optional install"| node_install

click node_spec "https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/commands/spec.md"
click node_orchestrate "https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/commands/orchestrate.md"
click node_manager "https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/agents/manager.md"
click node_subagents "https://github.com/rasta26/fayahlibrary/tree/main/plugins/fayah-core/agents"
click node_review "https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/commands/review.md"
click node_cleanup "https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/commands/cleanup-audit.md"
click node_tracking "https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/commands/add-tracking.md"
click node_kata "https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/commands/kata.md"
click node_review_skill "https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/skills/mentoring-code-review/SKILL.md"
click node_quality_skill "https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/skills/code-quality-review/SKILL.md"
click node_tdd_skill "https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/skills/spec-first-tdd/SKILL.md"
click node_kata_skill "https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/skills/coding-kata/SKILL.md"
click node_tracking_skill "https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/skills/event-tracking/SKILL.md"
click node_hook "https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/hooks/hooks.json"
click node_install "https://github.com/rasta26/fayahlibrary/blob/main/install"
click node_marketplace "https://github.com/rasta26/fayahlibrary/blob/main/.claude-plugin/marketplace.json"
click node_mcp_config "https://github.com/rasta26/fayahlibrary/blob/main/mcp/servers.json"
click node_external_catalog "https://github.com/rasta26/fayahlibrary/blob/main/external/catalog.json"

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_spec,node_orchestrate,node_manager,node_subagents,node_sharedbranch,node_review,node_user toneBlue
class node_cleanup,node_tracking,node_kata,node_review_skill,node_quality_skill,node_tdd_skill,node_kata_skill,node_tracking_skill,node_hook,node_event_log toneAmber
class node_mcp_config,node_default_mcp,node_optional_mcp,node_external_catalog toneMint
class node_install,node_marketplace toneRose
```

## Components

### Development workflow

- [/spec](https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/commands/spec.md): `plugins/fayah-core/commands/spec.md`
- [/orchestrate](https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/commands/orchestrate.md): `plugins/fayah-core/commands/orchestrate.md`
- [Manager agent](https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/agents/manager.md): `plugins/fayah-core/agents/manager.md`
- [Implementation agents](https://github.com/rasta26/fayahlibrary/tree/main/plugins/fayah-core/agents): `plugins/fayah-core/agents`
- **Shared branch**
- [/review](https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/commands/review.md): `plugins/fayah-core/commands/review.md`

### Plugin capabilities

- [/cleanup-audit](https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/commands/cleanup-audit.md): `plugins/fayah-core/commands/cleanup-audit.md`
- [/add-tracking](https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/commands/add-tracking.md): `plugins/fayah-core/commands/add-tracking.md`
- [/kata](https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/commands/kata.md): `plugins/fayah-core/commands/kata.md`
- [Mentoring review](https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/skills/mentoring-code-review/SKILL.md): `plugins/fayah-core/skills/mentoring-code-review/SKILL.md`
- [Code quality review](https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/skills/code-quality-review/SKILL.md): `plugins/fayah-core/skills/code-quality-review/SKILL.md`
- [Spec-first TDD](https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/skills/spec-first-tdd/SKILL.md): `plugins/fayah-core/skills/spec-first-tdd/SKILL.md`
- [Coding kata](https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/skills/coding-kata/SKILL.md): `plugins/fayah-core/skills/coding-kata/SKILL.md`
- [Event tracking](https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/skills/event-tracking/SKILL.md): `plugins/fayah-core/skills/event-tracking/SKILL.md`
- [PostToolUse hook](https://github.com/rasta26/fayahlibrary/blob/main/plugins/fayah-core/hooks/hooks.json): `plugins/fayah-core/hooks/hooks.json`
- **Local usage log**

### Tool integrations

- [MCP server catalog](https://github.com/rasta26/fayahlibrary/blob/main/mcp/servers.json): `mcp/servers.json`
- **Default MCP servers**
- **Optional MCP servers**
- [External tools catalog](https://github.com/rasta26/fayahlibrary/blob/main/external/catalog.json): `external/catalog.json`

### Installation

- [Installer](https://github.com/rasta26/fayahlibrary/blob/main/install): `install`
- [Plugin marketplace](https://github.com/rasta26/fayahlibrary/blob/main/.claude-plugin/marketplace.json): `.claude-plugin/marketplace.json`

### Other components

- **Claude Code user**

## Connections

- Claude Code user → Installer: runs (evidence: `README.md`)
- Installer → Plugin marketplace: registers (evidence: `README.md`)
- Installer → Default MCP servers: adds defaults (evidence: `README.md`)
- Installer → Optional MCP servers: installs on request (evidence: `README.md`)
- Claude Code user → /spec: invokes (evidence: `README.md`)
- /spec → /orchestrate: defines requirements (evidence: `README.md`)
- Claude Code user → /orchestrate: invokes (evidence: `README.md`)
- /orchestrate → Manager agent: runs (evidence: `README.md`)
- Manager agent → Implementation agents: dispatches (evidence: `README.md`)
- Implementation agents → Shared branch: merge work (evidence: `README.md`)
- Claude Code user → /review: invokes (evidence: `README.md`)
- /review → Mentoring review: uses (evidence: `README.md`)
- Claude Code user → /cleanup-audit: invokes (evidence: `README.md`)
- Claude Code user → /add-tracking: invokes (evidence: `README.md`)
- /add-tracking → Event tracking: uses (evidence: `README.md`)
- Claude Code user → /kata: invokes (evidence: `README.md`)
- /review → /kata: practice findings (evidence: `README.md`)
- PostToolUse hook → Local usage log: logs locally (evidence: `README.md`)
- MCP server catalog → Default MCP servers: curates (evidence: `README.md`)
- MCP server catalog → Optional MCP servers: lists optional (evidence: `README.md`)
- External tools catalog → Installer: optional install (evidence: `README.md`)
