# kensaurus/cursor-kenji architecture

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

- Interactive diagram: https://gitdiagram.com/kensaurus/cursor-kenji
- Repository: https://github.com/kensaurus/cursor-kenji

## Overview

cursor-kenji is a cross-agent playbook pack for software work, not a hosted application. A user asks an agent to run a skill or command; the playbooks guide orientation, assessment, changes, verification, and shipping. The README names the feature-build and fix-and-ship flows and describes audits, planning, deployment, integrations, and completion guardrails. The installer distributes the pack to supported agent tools. Edges reflect those documented workflows; implementation wiring for most markdown playbooks is not shown in the sampled source.

Main entry points: [`bin/install.mjs`](https://github.com/kensaurus/cursor-kenji/blob/main/bin/install.mjs) (Merge Installer), [`skills/workflow-build-feature/SKILL.md`](https://github.com/kensaurus/cursor-kenji/blob/main/skills/workflow-build-feature/SKILL.md) (Build Feature), [`skills`](https://github.com/kensaurus/cursor-kenji/tree/main/skills) (Test & Verify), [`skills/workflow-fix-and-ship/SKILL.md`](https://github.com/kensaurus/cursor-kenji/blob/main/skills/workflow-fix-and-ship/SKILL.md) (Fix & Ship)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_playbooks["Work Playbooks"]
  node_skills["Skills"]
  node_commands["Slash Commands"]
  node_subagents["Subagents"]
end

subgraph group_stages["Delivery Stages"]
  node_orient["Orient<br/>[SKILL.md]"]
  node_assess["Assess &amp; Plan"]
  node_build["Build Feature<br/>[SKILL.md]"]
  node_fixship["Fix &amp; Ship<br/>[SKILL.md]"]
  node_prove["Test &amp; Verify"]
  node_deploy["Ship &amp; Observe<br/>[SKILL.md]"]
end

subgraph group_controls["Agent Controls"]
  node_rules["Project Rules"]
  node_completion["Completion Gate"]
end

subgraph group_distribution["Installation &amp; Integrations"]
  node_mcp["MCP Templates"]
  node_installer["Merge Installer<br/>[install.mjs]"]
  node_toolconfigs["Agent Tool Configs<br/>[.mcp.json]"]
end

node_user(("Developer"))
node_agent(("Coding Agent"))
node_external{{"External Services"}}

node_user -->|"requests work"| node_agent
node_agent -->|"orients with"| node_orient
node_agent -->|"assesses with"| node_assess
node_agent -->|"builds with"| node_build
node_agent -->|"fixes with"| node_fixship
node_agent -->|"verifies with"| node_prove
node_agent -->|"ships with"| node_deploy
node_agent -->|"invokes"| node_skills
node_agent -->|"invokes"| node_commands
node_agent -->|"delegates to"| node_subagents
node_agent -->|"follows"| node_rules
node_agent -->|"stop check"| node_completion
node_user -->|"runs"| node_installer
node_installer -->|"installs"| node_skills
node_installer -->|"installs"| node_commands
node_installer -->|"installs"| node_subagents
node_installer -->|"installs"| node_rules
node_installer -->|"installs config"| node_mcp
node_mcp -->|"templates config"| node_toolconfigs
node_toolconfigs -.->|"connects"| node_external
node_assess -->|"approval before change"| node_build
node_build -->|"proves changes"| node_prove
node_fixship -->|"verifies fix"| node_prove
node_deploy -.->|"observes deployment"| node_external

click node_skills "https://github.com/kensaurus/cursor-kenji/tree/main/skills"
click node_commands "https://github.com/kensaurus/cursor-kenji/tree/main/commands"
click node_subagents "https://github.com/kensaurus/cursor-kenji/tree/main/agents"
click node_orient "https://github.com/kensaurus/cursor-kenji/blob/main/skills/workflow-onboard/SKILL.md"
click node_assess "https://github.com/kensaurus/cursor-kenji/tree/main/skills"
click node_build "https://github.com/kensaurus/cursor-kenji/blob/main/skills/workflow-build-feature/SKILL.md"
click node_fixship "https://github.com/kensaurus/cursor-kenji/blob/main/skills/workflow-fix-and-ship/SKILL.md"
click node_prove "https://github.com/kensaurus/cursor-kenji/tree/main/skills"
click node_deploy "https://github.com/kensaurus/cursor-kenji/blob/main/skills/workflow-ship-and-observe/SKILL.md"
click node_rules "https://github.com/kensaurus/cursor-kenji/tree/main/rules"
click node_completion "https://github.com/kensaurus/cursor-kenji/blob/main/hooks/completion-gate.mjs"
click node_mcp "https://github.com/kensaurus/cursor-kenji/tree/main/mcp"
click node_installer "https://github.com/kensaurus/cursor-kenji/blob/main/bin/install.mjs"
click node_toolconfigs "https://github.com/kensaurus/cursor-kenji/blob/main/.mcp.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_skills,node_commands,node_subagents toneBlue
class node_orient,node_assess,node_build,node_fixship,node_prove,node_deploy toneAmber
class node_rules,node_completion toneMint
class node_mcp,node_installer,node_toolconfigs toneRose
class node_user,node_agent,node_external toneIndigo
```

## Components

### Work Playbooks

- [Skills](https://github.com/kensaurus/cursor-kenji/tree/main/skills): `skills`
- [Slash Commands](https://github.com/kensaurus/cursor-kenji/tree/main/commands): `commands`
- [Subagents](https://github.com/kensaurus/cursor-kenji/tree/main/agents): `agents`

### Delivery Stages

- [Orient](https://github.com/kensaurus/cursor-kenji/blob/main/skills/workflow-onboard/SKILL.md): `skills/workflow-onboard/SKILL.md`
- [Assess & Plan](https://github.com/kensaurus/cursor-kenji/tree/main/skills): `skills`
- [Build Feature](https://github.com/kensaurus/cursor-kenji/blob/main/skills/workflow-build-feature/SKILL.md): `skills/workflow-build-feature/SKILL.md`
- [Fix & Ship](https://github.com/kensaurus/cursor-kenji/blob/main/skills/workflow-fix-and-ship/SKILL.md): `skills/workflow-fix-and-ship/SKILL.md`
- [Test & Verify](https://github.com/kensaurus/cursor-kenji/tree/main/skills): `skills`
- [Ship & Observe](https://github.com/kensaurus/cursor-kenji/blob/main/skills/workflow-ship-and-observe/SKILL.md): `skills/workflow-ship-and-observe/SKILL.md`

### Agent Controls

- [Project Rules](https://github.com/kensaurus/cursor-kenji/tree/main/rules): `rules`
- [Completion Gate](https://github.com/kensaurus/cursor-kenji/blob/main/hooks/completion-gate.mjs): `hooks/completion-gate.mjs`

### Installation & Integrations

- [MCP Templates](https://github.com/kensaurus/cursor-kenji/tree/main/mcp): `mcp`
- [Merge Installer](https://github.com/kensaurus/cursor-kenji/blob/main/bin/install.mjs): `bin/install.mjs`
- [Agent Tool Configs](https://github.com/kensaurus/cursor-kenji/blob/main/.mcp.json): `.mcp.json`

### Other components

- **Developer**
- **Coding Agent**
- **External Services**

## Connections

- Developer → Coding Agent: requests work
- Coding Agent → Orient: orients with
- Coding Agent → Assess & Plan: assesses with
- Coding Agent → Build Feature: builds with
- Coding Agent → Fix & Ship: fixes with
- Coding Agent → Test & Verify: verifies with
- Coding Agent → Ship & Observe: ships with
- Coding Agent → Skills: invokes
- Coding Agent → Slash Commands: invokes
- Coding Agent → Subagents: delegates to
- Coding Agent → Project Rules: follows
- Coding Agent → Completion Gate: stop check
- Developer → Merge Installer: runs
- Merge Installer → Skills: installs
- Merge Installer → Slash Commands: installs
- Merge Installer → Subagents: installs
- Merge Installer → Project Rules: installs
- Merge Installer → MCP Templates: installs config
- MCP Templates → Agent Tool Configs: templates config
- Agent Tool Configs → External Services: connects
- Assess & Plan → Build Feature: approval before change
- Build Feature → Test & Verify: proves changes
- Fix & Ship → Test & Verify: verifies fix
- Ship & Observe → External Services: observes deployment