# nickcarmonadigital/riftkit architecture

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

- Interactive diagram: https://gitdiagram.com/nickcarmonadigital/riftkit
- Repository: https://github.com/nickcarmonadigital/riftkit

## Overview

riftkit is an AI-assisted software-development process framework: a project copies or installs its `.agent` resources, then an AI assistant uses phase-specific skills and CLI commands while specialized agents and hooks support the work. The documented lifecycle runs from project context and brainstorming through design, build, security, shipping, handoff, and maintenance. The README also describes blueprints, rules, and event-driven hooks. No source excerpts were provided, so relationships below rely on README statements; unsampled internals are represented only at documented subsystem-directory level.

Main entry points: [`.agent/commands`](https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/commands) (Slash Commands), [`.agent/skills`](https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/skills) (Lifecycle Skills), [`.agent/skills-by-phase.md`](https://github.com/nickcarmonadigital/riftkit/blob/main/.agent/skills-by-phase.md) (Lifecycle Map), [`.agent/blueprints`](https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/blueprints) (Project Blueprints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Process Guidance"]
  node_skills["Lifecycle Skills<br/>[skills]"]
  node_lifecycle["Lifecycle Map<br/>[skills-by-phase.md]"]
  node_docs["Process Docs<br/>[docs]"]
end

subgraph group_automation["AI Automation"]
  node_commands["Slash Commands<br/>[commands]"]
  node_agents["Specialized Agents<br/>[agents]"]
end

subgraph group_project_resources["Project Resources"]
  node_blueprints["Project Blueprints<br/>[blueprints]"]
end

subgraph group_enforcement["Workflow Enforcement"]
  node_hooks["Event Hooks<br/>[hooks]"]
  node_rules["Coding Rules<br/>[rules]"]
end

node_developer(("Developer"))
node_assistant(("AI Assistant"))

node_developer -->|"invokes"| node_commands
node_assistant -->|"reads on demand"| node_skills
node_commands -->|"invokes"| node_agents
node_commands -->|"invokes"| node_skills
node_lifecycle -->|"maps phases"| node_skills
node_hooks -->|"enforces workflow"| node_assistant
node_rules -->|"guides coding"| node_assistant
node_blueprints -->|"provides starters"| node_developer

click node_skills "https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/skills"
click node_lifecycle "https://github.com/nickcarmonadigital/riftkit/blob/main/.agent/skills-by-phase.md"
click node_docs "https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/docs"
click node_commands "https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/commands"
click node_agents "https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/agents"
click node_hooks "https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/hooks"
click node_rules "https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/rules"
click node_blueprints "https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/blueprints"

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_lifecycle,node_docs toneBlue
class node_commands,node_agents toneAmber
class node_blueprints toneMint
class node_hooks,node_rules toneRose
class node_developer,node_assistant toneIndigo
```

## Components

### Process Guidance

- [Lifecycle Skills](https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/skills): `.agent/skills`
- [Lifecycle Map](https://github.com/nickcarmonadigital/riftkit/blob/main/.agent/skills-by-phase.md): `.agent/skills-by-phase.md`
- [Process Docs](https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/docs): `.agent/docs`

### AI Automation

- [Slash Commands](https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/commands): `.agent/commands`
- [Specialized Agents](https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/agents): `.agent/agents`

### Project Resources

- [Project Blueprints](https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/blueprints): `.agent/blueprints`

### Workflow Enforcement

- [Event Hooks](https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/hooks): `.agent/hooks`
- [Coding Rules](https://github.com/nickcarmonadigital/riftkit/tree/main/.agent/rules): `.agent/rules`

### Other components

- **Developer**
- **AI Assistant**

## Connections

- Developer → Slash Commands: invokes (evidence: `README.md`)
- AI Assistant → Lifecycle Skills: reads on demand (evidence: `README.md`)
- Slash Commands → Specialized Agents: invokes (evidence: `README.md`)
- Slash Commands → Lifecycle Skills: invokes (evidence: `README.md`)
- Lifecycle Map → Lifecycle Skills: maps phases (evidence: `README.md`)
- Event Hooks → AI Assistant: enforces workflow (evidence: `README.md`)
- Coding Rules → AI Assistant: guides coding (evidence: `README.md`)
- Project Blueprints → Developer: provides starters (evidence: `README.md`)
