# evoveotech/cursor-howto architecture

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

- Interactive diagram: https://gitdiagram.com/evoveotech/cursor-howto
- Repository: https://github.com/evoveotech/cursor-howto

## Overview

1. This repository is a structured learning and reference site for Cursor IDE and Cursor CLI, not an application runtime. Its primary product is content: Markdown tutorials, templates, example configs, and packaged workflows that users copy into their own Cursor setup.

2. The top-level content is organized as a progressive curriculum. The numbered folders `01-slash-commands` through `10-cli` represent the learning path, moving from user-invoked shortcuts and memory to advanced automation, plugins, and CLI usage. `LEARNING-ROADMAP.md`, `CATALOG.md`, and `INDEX.md` act as the navigation and curriculum index layer.

3. There is a clear boundary between instructional content and reusable artifacts. The instructional layer is the documentation in `README.md` and module READMEs; the reusable layer is the actual Cursor-facing assets such as slash-command Markdown files, `CURSOR.md` memory files, skill bundles, subagent definitions, hook scripts, and plugin manifests.

4. The repository models Cursor’s feature stack as separate subsystems: slash commands for explicit user triggers, memory for persistent context, skills for auto-invoked capabilities with scripts/templates, subagents for delegated specialized reasoning, MCP configs for external tool access, hooks for event-driven automation, checkpoints for session rewind, advanced features for planning/background work, and CLI examples for terminal automation.

5. The `03-skills` directory is especially important because it contains mixed-content modules: a `SKILL.md` instruction file plus supporting scripts and templates. That makes it the closest thing in the repo to an executable workflow package, with Python utilities like `generate-docs.py`, analysis scripts in `code-review` and `refactor`, and content templates that drive generated output.

6. The `04-subagents` and `05-mcp` folders define two different integration boundaries. Subagents partition reasoning into isolated role-specific prompts, while MCP files define machine-readable tool connections to external systems such as GitHub, databases, and the filesystem. These are the repo’s main “agent-to-tool” and “agent-to-agent” integration surfaces.

7. The `06-hooks` subsystem provides event-driven automation around Cursor actions. The shell scripts there are intended to run on lifecycle or tool events such as writes, prompts, commits, notifications, and security checks, creating a validation/guardrail layer around the authoring workflow.

8. The `07-plugins` folder packages complete solutions as installable bundles. Each plugin combines commands, agents, hooks, templates, and sometimes MCP configs into a cohesive workflow area such as PR review, documentation generation, or DevOps automation. This is the highest-level composition boundary in the repository.

9. `08-checkpoints` and `09-advanced-features` document stateful and operational features rather than content packages. Checkpoints focus on snapshot/rewind behavior for safe experimentation, while advanced features cover planning mode, permissions, background tasks, and session management. These modules explain how long-running, multi-step work is controlled.

10. The repository also includes a small but important automation backend in `scripts/`. This Python tooling builds the EPUB export, checks cross-references and links, and validates Mermaid diagrams. It supports the documentation supply chain rather than the Cursor feature content itself.

11. Quality and delivery are enforced through GitHub Actions in `.github/workflows/`. Separate workflows handle docs checks, release, and tests, while repo metadata like issue templates, PR templates, security reporting, and testing docs define the contribution and verification boundary.

12. The main data flow is: author Markdown/config/script assets in the numbered feature folders, validate them with local Python/shell tooling and CI, then consume them in Cursor by copying or installing them into the user’s Cursor settings, `.cursor/` directories, or home-directory configuration. In other words, this repo is a source-of-truth template library plus a documentation system for assembling Cursor workflows.

Main entry points: [`07-plugins/README.md`](https://github.com/evoveotech/cursor-howto/blob/main/07-plugins/README.md) (Plugins), [`03-skills/README.md`](https://github.com/evoveotech/cursor-howto/blob/main/03-skills/README.md) (Skills), [`scripts/README.md`](https://github.com/evoveotech/cursor-howto/blob/main/scripts/README.md) (Scripts), [`README.md`](https://github.com/evoveotech/cursor-howto/blob/main/README.md) (README)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_g_curriculum["Curriculum"]
  node_readme["README<br/>entry docs<br/>[README.md]"]
  node_roadmap["Learning roadmap<br/>curriculum index"]
  node_catalog["Catalog<br/>content index<br/>[CATALOG.md]"]
  node_index["Index<br/>content map<br/>[INDEX.md]"]
end

subgraph group_g_features["Cursor features"]
  node_slash["Slash commands<br/>user triggers<br/>[README.md]"]
  node_memory["Memory<br/>persistent context<br/>[README.md]"]
  node_skills["Skills<br/>workflow packages<br/>[README.md]"]
  node_skills_code_review["Code review<br/>skill bundle<br/>[SKILL.md]"]
  node_skills_doc_generator["Doc generator<br/>skill workflow<br/>[SKILL.md]"]
  node_skills_refactor["Refactor<br/>skill bundle<br/>[SKILL.md]"]
  node_subagents["Subagents<br/>delegated reasoning<br/>[README.md]"]
  node_mcp[("MCP configs<br/>tool access<br/>[README.md]")]
  node_hooks["Hooks<br/>event automation<br/>[README.md]"]
  node_checkpoints["Checkpoints<br/>session rewind<br/>[README.md]"]
  node_advanced["Advanced features<br/>runtime controls<br/>[README.md]"]
  node_cli["CLI<br/>terminal automation<br/>[README.md]"]
end

subgraph group_g_composition["Composable packages"]
  node_plugins["Plugins<br/>installable bundles<br/>[README.md]"]
  node_plugin_docs["Docs plugin<br/>plugin bundle<br/>[README.md]"]
  node_plugin_devops["DevOps plugin<br/>plugin bundle<br/>[README.md]"]
  node_plugin_pr["PR review plugin<br/>plugin bundle<br/>[README.md]"]
end

subgraph group_g_tooling["Tooling"]
  node_scripts["Scripts<br/>repo automation<br/>[README.md]"]
end

subgraph group_g_governance["Governance"]
  node_ci["GitHub Actions<br/>ci workflows<br/>[docs-check.yml]"]
end

node_readme -->|"orients"| node_roadmap
node_readme -->|"summarizes"| node_catalog
node_readme -->|"maps"| node_index
node_roadmap -->|"starts with"| node_slash
node_roadmap -->|"ends with"| node_cli
node_index -->|"references"| node_memory
node_slash -->|"feeds"| node_memory
node_memory -->|"supports"| node_skills
node_skills -->|"includes"| node_skills_code_review
node_skills -->|"includes"| node_skills_doc_generator
node_skills -->|"includes"| node_skills_refactor
node_skills_refactor -->|"uses"| node_scripts
node_skills_code_review -->|"uses"| node_scripts
node_subagents -->|"composes into"| node_plugins
node_mcp -->|"composes into"| node_plugins
node_hooks -->|"composes into"| node_plugins
node_plugins -->|"contains"| node_plugin_docs
node_plugins -->|"contains"| node_plugin_devops
node_plugins -->|"contains"| node_plugin_pr
node_checkpoints -->|"pairs with"| node_advanced
node_scripts -->|"validated by"| node_ci
node_ci -->|"checks"| node_catalog
node_ci -->|"runs"| node_scripts

click node_readme "https://github.com/evoveotech/cursor-howto/blob/main/README.md"
click node_roadmap "https://github.com/evoveotech/cursor-howto/blob/main/LEARNING-ROADMAP.md"
click node_catalog "https://github.com/evoveotech/cursor-howto/blob/main/CATALOG.md"
click node_index "https://github.com/evoveotech/cursor-howto/blob/main/INDEX.md"
click node_slash "https://github.com/evoveotech/cursor-howto/blob/main/01-slash-commands/README.md"
click node_memory "https://github.com/evoveotech/cursor-howto/blob/main/02-memory/README.md"
click node_skills "https://github.com/evoveotech/cursor-howto/blob/main/03-skills/README.md"
click node_skills_code_review "https://github.com/evoveotech/cursor-howto/blob/main/03-skills/code-review/SKILL.md"
click node_skills_doc_generator "https://github.com/evoveotech/cursor-howto/blob/main/03-skills/doc-generator/SKILL.md"
click node_skills_refactor "https://github.com/evoveotech/cursor-howto/blob/main/03-skills/refactor/SKILL.md"
click node_subagents "https://github.com/evoveotech/cursor-howto/blob/main/04-subagents/README.md"
click node_mcp "https://github.com/evoveotech/cursor-howto/blob/main/05-mcp/README.md"
click node_hooks "https://github.com/evoveotech/cursor-howto/blob/main/06-hooks/README.md"
click node_checkpoints "https://github.com/evoveotech/cursor-howto/blob/main/08-checkpoints/README.md"
click node_advanced "https://github.com/evoveotech/cursor-howto/blob/main/09-advanced-features/README.md"
click node_cli "https://github.com/evoveotech/cursor-howto/blob/main/10-cli/README.md"
click node_plugins "https://github.com/evoveotech/cursor-howto/blob/main/07-plugins/README.md"
click node_plugin_docs "https://github.com/evoveotech/cursor-howto/blob/main/07-plugins/documentation/README.md"
click node_plugin_devops "https://github.com/evoveotech/cursor-howto/blob/main/07-plugins/devops-automation/README.md"
click node_plugin_pr "https://github.com/evoveotech/cursor-howto/blob/main/07-plugins/pr-review/README.md"
click node_scripts "https://github.com/evoveotech/cursor-howto/blob/main/scripts/README.md"
click node_ci "https://github.com/evoveotech/cursor-howto/blob/main/.github/workflows/docs-check.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_readme,node_roadmap,node_catalog,node_index toneBlue
class node_slash,node_memory,node_skills,node_skills_code_review,node_skills_doc_generator,node_skills_refactor,node_subagents,node_mcp,node_hooks,node_checkpoints,node_advanced,node_cli toneAmber
class node_plugins,node_plugin_docs,node_plugin_devops,node_plugin_pr toneMint
class node_scripts toneRose
class node_ci toneIndigo
```

## Components

### Curriculum

Navigation and learning-path content for the repo

- [README](https://github.com/evoveotech/cursor-howto/blob/main/README.md): entry docs · Top-level overview and usage guidance · `README.md`
- [Learning roadmap](https://github.com/evoveotech/cursor-howto/blob/main/LEARNING-ROADMAP.md): curriculum index · Progressive path through the numbered modules · `LEARNING-ROADMAP.md`
- [Catalog](https://github.com/evoveotech/cursor-howto/blob/main/CATALOG.md): content index · Inventory of available lessons and assets · `CATALOG.md`
- [Index](https://github.com/evoveotech/cursor-howto/blob/main/INDEX.md): content map · Cross-reference map for the repository · `INDEX.md`

### Cursor features

Core instructional modules for Cursor capabilities

- [Slash commands](https://github.com/evoveotech/cursor-howto/blob/main/01-slash-commands/README.md): user triggers · Explicit command snippets for common workflows · `01-slash-commands/README.md`
- [Memory](https://github.com/evoveotech/cursor-howto/blob/main/02-memory/README.md): persistent context · CURSOR.md memory files for scoped and project context · `02-memory/README.md`
- [Skills](https://github.com/evoveotech/cursor-howto/blob/main/03-skills/README.md): workflow packages · Reusable capability bundles with instructions, scripts, and templates · `03-skills/README.md`
- [Code review](https://github.com/evoveotech/cursor-howto/blob/main/03-skills/code-review/SKILL.md): skill bundle · Metrics, complexity analysis, and review templates · `03-skills/code-review/SKILL.md`
- [Doc generator](https://github.com/evoveotech/cursor-howto/blob/main/03-skills/doc-generator/SKILL.md): skill workflow · Documentation generation workflow with Python automation · `03-skills/doc-generator/SKILL.md`
- [Refactor](https://github.com/evoveotech/cursor-howto/blob/main/03-skills/refactor/SKILL.md): skill bundle · Smell detection, complexity analysis, and refactoring plans · `03-skills/refactor/SKILL.md`
- [Subagents](https://github.com/evoveotech/cursor-howto/blob/main/04-subagents/README.md): delegated reasoning · Role-specific agent prompts for specialized tasks · `04-subagents/README.md`
- [MCP configs](https://github.com/evoveotech/cursor-howto/blob/main/05-mcp/README.md): tool access · Machine-readable connectors to external systems · `05-mcp/README.md`
- [Hooks](https://github.com/evoveotech/cursor-howto/blob/main/06-hooks/README.md): event automation · Lifecycle and guardrail scripts around Cursor actions · `06-hooks/README.md`
- [Checkpoints](https://github.com/evoveotech/cursor-howto/blob/main/08-checkpoints/README.md): session rewind · Snapshot and restore examples for safe experimentation · `08-checkpoints/README.md`
- [Advanced features](https://github.com/evoveotech/cursor-howto/blob/main/09-advanced-features/README.md): runtime controls · Planning mode, permissions, background tasks, and session controls · `09-advanced-features/README.md`
- [CLI](https://github.com/evoveotech/cursor-howto/blob/main/10-cli/README.md): terminal automation · Cursor CLI usage and examples · `10-cli/README.md`

### Composable packages

Bundles that combine commands, agents, hooks, templates, and configs

- [Plugins](https://github.com/evoveotech/cursor-howto/blob/main/07-plugins/README.md): installable bundles · Highest-level packaged workflows built from multiple Cursor features · `07-plugins/README.md`
- [Docs plugin](https://github.com/evoveotech/cursor-howto/blob/main/07-plugins/documentation/README.md): plugin bundle · Documentation generation and sync workflow package · `07-plugins/documentation/README.md`
- [DevOps plugin](https://github.com/evoveotech/cursor-howto/blob/main/07-plugins/devops-automation/README.md): plugin bundle · Deployment, incident, and rollback workflow package · `07-plugins/devops-automation/README.md`
- [PR review plugin](https://github.com/evoveotech/cursor-howto/blob/main/07-plugins/pr-review/README.md): plugin bundle · Pull-request review workflow package with checks and review agents · `07-plugins/pr-review/README.md`

### Tooling

Repo automation, validation, and publishing support

- [Scripts](https://github.com/evoveotech/cursor-howto/blob/main/scripts/README.md): repo automation · Python tooling for EPUB build, validation, and link checking · `scripts/README.md`

### Governance

Contribution, release, and quality boundaries

- [GitHub Actions](https://github.com/evoveotech/cursor-howto/blob/main/.github/workflows/docs-check.yml): ci workflows · Docs checks, release, and test automation · `.github/workflows/docs-check.yml`

## Connections

- README → Learning roadmap: orients · Introduces the learning path and repository structure
- README → Catalog: summarizes · Points readers to the inventory of lessons and assets
- README → Index: maps · Uses the index as a navigation layer
- Learning roadmap → Slash commands: starts with · Curriculum begins with explicit user commands
- Learning roadmap → CLI: ends with · Curriculum culminates in terminal automation
- Index → Memory: references · Maps feature modules and reusable assets
- Slash commands → Memory: feeds · Commands are used alongside persistent context
- Memory → Skills: supports · Context files help package reusable workflows
- Skills → Code review: includes · Representative skill module
- Skills → Doc generator: includes · Representative skill module
- Skills → Refactor: includes · Representative skill module
- Refactor → Scripts: uses · Skill depends on analysis utilities
- Code review → Scripts: uses · Skill depends on metrics and comparison scripts
- Subagents → Plugins: composes into · Subagent roles are packaged into higher-level solutions
- MCP configs → Plugins: composes into · Tool integrations are bundled into plugins
- Hooks → Plugins: composes into · Event scripts are packaged with workflows
- Plugins → Docs plugin: contains · Documentation-focused workflow bundle
- Plugins → DevOps plugin: contains · Operations-focused workflow bundle
- Plugins → PR review plugin: contains · Review-focused workflow bundle
- Checkpoints → Advanced features: pairs with · State management and operational controls are adjacent topics
- Scripts → GitHub Actions: validated by · Local automation is reinforced by workflow checks
- GitHub Actions → Catalog: checks · CI helps keep docs and references consistent
- GitHub Actions → Scripts: runs · Workflows execute repository validation and build tooling
