# api-evangelist/kitchenstories architecture

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

- Interactive diagram: https://gitdiagram.com/api-evangelist/kitchenstories
- Repository: https://github.com/api-evangelist/kitchenstories

## Overview

This repository is a third-party profile of Kitchen Stories’ internal API, not the API implementation or a software product. A reader uses its descriptions and supporting artifacts to understand the documented API surface and its conventions, security, data model, and capabilities. The graph groups those artifacts by role; documented capability areas are summarized rather than treated as independently implemented services. Relationships are limited to the README’s artifact descriptions and derivation labels; no runtime calls are evidenced.

Main entry points: [`skills`](https://github.com/api-evangelist/kitchenstories/tree/main/skills) (Agent skills), [`openapi`](https://github.com/api-evangelist/kitchenstories/tree/main/openapi) (API capabilities), [`collections`](https://github.com/api-evangelist/kitchenstories/tree/main/collections) (Request collections), [`conventions/kitchenstories-conventions.yml`](https://github.com/api-evangelist/kitchenstories/blob/main/conventions/kitchenstories-conventions.yml) (API conventions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API description"]
  node_api_spec["Internal API spec"]
  node_api_domains["API capabilities"]
  node_collections["Request collections"]
end

subgraph group_analysis["API analysis"]
  node_conventions["API conventions"]
  node_data_model["Data model"]
  node_errors["Error catalog"]
  node_lifecycle["API lifecycle"]
  node_conformance["Conformance"]
  node_capabilities["Capability map"]
end

subgraph group_access["Access and guidance"]
  node_auth["Authentication"]
  node_security["Domain security"]
  node_mcp["MCP candidate"]
  node_skills["Agent skills"]
  node_api_index["API index<br/>[apis.yml]"]
end

subgraph group_examples["Illustrative content"]
  node_blogs["Recipe articles"]
end

node_reader(("API reader"))

node_reader -->|"reads"| node_api_spec
node_reader -->|"explores requests"| node_collections
node_reader -->|"uses guidance"| node_skills
node_api_spec -->|"documents"| node_api_domains
node_api_spec -->|"documents"| node_auth
node_api_spec -.->|"informs"| node_conventions
node_api_spec -.->|"informs"| node_data_model
node_api_spec -.->|"informs"| node_errors
node_api_spec -.->|"informs"| node_lifecycle
node_api_spec -.->|"informs"| node_conformance
node_api_spec -->|"maps"| node_capabilities
node_api_spec -.->|"candidate source"| node_mcp
node_api_spec -.->|"supports guidance"| node_skills
node_reader -->|"reviews examples"| node_blogs
node_reader -.->|"discovers profile"| node_api_index

click node_api_domains "https://github.com/api-evangelist/kitchenstories/tree/main/openapi"
click node_collections "https://github.com/api-evangelist/kitchenstories/tree/main/collections"
click node_auth "https://github.com/api-evangelist/kitchenstories/blob/main/authentication/kitchenstories-authentication.yml"
click node_security "https://github.com/api-evangelist/kitchenstories/blob/main/security/kitchenstories-domain-security.yml"
click node_conventions "https://github.com/api-evangelist/kitchenstories/blob/main/conventions/kitchenstories-conventions.yml"
click node_data_model "https://github.com/api-evangelist/kitchenstories/blob/main/data-model/kitchenstories-data-model.yml"
click node_errors "https://github.com/api-evangelist/kitchenstories/blob/main/errors/kitchenstories-problem-types.yml"
click node_lifecycle "https://github.com/api-evangelist/kitchenstories/blob/main/lifecycle/kitchenstories-lifecycle.yml"
click node_conformance "https://github.com/api-evangelist/kitchenstories/blob/main/conformance/kitchenstories-conformance.yml"
click node_capabilities "https://github.com/api-evangelist/kitchenstories/blob/main/capabilities/kitchenstories-capability-edges.yml"
click node_mcp "https://github.com/api-evangelist/kitchenstories/blob/main/mcp/kitchenstories-mcp.yml"
click node_skills "https://github.com/api-evangelist/kitchenstories/tree/main/skills"
click node_blogs "https://github.com/api-evangelist/kitchenstories/tree/main/blogs"
click node_api_index "https://github.com/api-evangelist/kitchenstories/blob/main/apis.yml"

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_api_spec,node_api_domains,node_collections toneBlue
class node_conventions,node_data_model,node_errors,node_lifecycle,node_conformance,node_capabilities toneAmber
class node_auth,node_security,node_mcp,node_skills,node_api_index,node_reader toneMint
class node_blogs toneRose
```

## Components

### API description

- **Internal API spec**
- [API capabilities](https://github.com/api-evangelist/kitchenstories/tree/main/openapi): `openapi`
- [Request collections](https://github.com/api-evangelist/kitchenstories/tree/main/collections): `collections`

### API analysis

- [API conventions](https://github.com/api-evangelist/kitchenstories/blob/main/conventions/kitchenstories-conventions.yml): `conventions/kitchenstories-conventions.yml`
- [Data model](https://github.com/api-evangelist/kitchenstories/blob/main/data-model/kitchenstories-data-model.yml): `data-model/kitchenstories-data-model.yml`
- [Error catalog](https://github.com/api-evangelist/kitchenstories/blob/main/errors/kitchenstories-problem-types.yml): `errors/kitchenstories-problem-types.yml`
- [API lifecycle](https://github.com/api-evangelist/kitchenstories/blob/main/lifecycle/kitchenstories-lifecycle.yml): `lifecycle/kitchenstories-lifecycle.yml`
- [Conformance](https://github.com/api-evangelist/kitchenstories/blob/main/conformance/kitchenstories-conformance.yml): `conformance/kitchenstories-conformance.yml`
- [Capability map](https://github.com/api-evangelist/kitchenstories/blob/main/capabilities/kitchenstories-capability-edges.yml): `capabilities/kitchenstories-capability-edges.yml`

### Access and guidance

- [Authentication](https://github.com/api-evangelist/kitchenstories/blob/main/authentication/kitchenstories-authentication.yml): `authentication/kitchenstories-authentication.yml`
- [Domain security](https://github.com/api-evangelist/kitchenstories/blob/main/security/kitchenstories-domain-security.yml): `security/kitchenstories-domain-security.yml`
- [MCP candidate](https://github.com/api-evangelist/kitchenstories/blob/main/mcp/kitchenstories-mcp.yml): `mcp/kitchenstories-mcp.yml`
- [Agent skills](https://github.com/api-evangelist/kitchenstories/tree/main/skills): `skills`
- [API index](https://github.com/api-evangelist/kitchenstories/blob/main/apis.yml): `apis.yml`

### Illustrative content

- [Recipe articles](https://github.com/api-evangelist/kitchenstories/tree/main/blogs): `blogs`

### Other components

- **API reader**

## Connections

- API reader → Internal API spec: reads (evidence: `README.md`)
- API reader → Request collections: explores requests (evidence: `README.md`)
- API reader → Agent skills: uses guidance (evidence: `README.md`)
- Internal API spec → API capabilities: documents (evidence: `README.md`)
- Internal API spec → Authentication: documents (evidence: `README.md`)
- Internal API spec → API conventions: informs
- Internal API spec → Data model: informs
- Internal API spec → Error catalog: informs
- Internal API spec → API lifecycle: informs
- Internal API spec → Conformance: informs
- Internal API spec → Capability map: maps (evidence: `README.md`)
- Internal API spec → MCP candidate: candidate source
- Internal API spec → Agent skills: supports guidance
- API reader → Recipe articles: reviews examples (evidence: `README.md`)
- API reader → API index: discovers profile
