# nifinet/ai-native-company-stack architecture

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

- Interactive diagram: https://gitdiagram.com/nifinet/ai-native-company-stack
- Repository: https://github.com/nifinet/ai-native-company-stack

## Overview

This repository is a self-hosted AI company-operations stack: six agent skills automate recurring work, Hermes runs them on schedules or events, and MCP servers expose CRM and project-tracker data through vendor-neutral tools. The main flow is trigger → skill → context gathering and synthesis → delivery, with memory supporting unit-specific rules and feedback. README-level architecture documents these connections; sampled helper scripts contain placeholders for several integrations, so the graph does not imply those helpers currently fetch data themselves.

Main entry points: [`skills/weekly-business-digest/SKILL.md`](https://github.com/nifinet/ai-native-company-stack/blob/main/skills/weekly-business-digest/SKILL.md) (Weekly digest), [`skills/lead-enrichment-brief/SKILL.md`](https://github.com/nifinet/ai-native-company-stack/blob/main/skills/lead-enrichment-brief/SKILL.md) (Lead brief), [`mcp-servers/pipedrive-mcp/server.py`](https://github.com/nifinet/ai-native-company-stack/blob/main/mcp-servers/pipedrive-mcp/server.py) (Pipedrive MCP), [`skills/content-draft-from-brief/SKILL.md`](https://github.com/nifinet/ai-native-company-stack/blob/main/skills/content-draft-from-brief/SKILL.md) (Content drafting)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Agent runtime"]
  node_hermes["Hermes Agent"]
end

subgraph group_skills["Business skills"]
  node_digest["Weekly digest<br/>[SKILL.md]"]
  node_digest_context["Digest context helper<br/>[pull_context.py]"]
  node_lead["Lead brief<br/>[SKILL.md]"]
  node_lead_enrich["Lead enrichment helper<br/>[enrich.py]"]
  node_content["Content drafting<br/>[SKILL.md]"]
  node_radar["Morning radar<br/>[SKILL.md]"]
  node_retro["Weekly retro<br/>[SKILL.md]"]
  node_qa["Output QA<br/>[SKILL.md]"]
end

subgraph group_servers["MCP integrations"]
  node_crm_template["CRM server template<br/>[server.py]"]
  node_pipedrive["Pipedrive MCP<br/>[server.py]"]
  node_notion["Notion projects MCP<br/>[server.py]"]
end

subgraph group_state["Context and delivery"]
  node_memory[("Unit memory")]
  node_messaging["Messaging channels"]
end

node_operator(("Operator / event"))
node_crm_api["CRM API"]
node_notion_api["Notion API"]
node_web["Public web"]

node_operator -->|"triggers"| node_hermes
node_hermes -->|"runs"| node_digest
node_hermes -->|"runs"| node_lead
node_hermes -->|"runs"| node_content
node_hermes -->|"runs"| node_radar
node_hermes -->|"runs"| node_retro
node_hermes -->|"runs"| node_qa
node_digest -->|"uses helper"| node_digest_context
node_lead -->|"uses helper"| node_lead_enrich
node_digest -->|"reads and updates"| node_memory
node_digest -->|"requests task updates"| node_notion
node_digest -->|"requests deal data"| node_pipedrive
node_digest -->|"reads and posts"| node_messaging
node_digest -->|"delivers digest"| node_messaging
node_lead -->|"uses CRM tools"| node_pipedrive
node_lead -->|"enriches lead"| node_web
node_content -->|"delivers draft"| node_messaging
node_radar -->|"posts radar"| node_messaging
node_retro -->|"delivers retro"| node_messaging
node_qa -->|"returns review"| node_messaging
node_crm_template -.->|"adapts to"| node_crm_api
node_pipedrive -->|"calls"| node_crm_api
node_notion -->|"calls"| node_notion_api

click node_digest "https://github.com/nifinet/ai-native-company-stack/blob/main/skills/weekly-business-digest/SKILL.md"
click node_digest_context "https://github.com/nifinet/ai-native-company-stack/blob/main/skills/weekly-business-digest/scripts/pull_context.py"
click node_lead "https://github.com/nifinet/ai-native-company-stack/blob/main/skills/lead-enrichment-brief/SKILL.md"
click node_lead_enrich "https://github.com/nifinet/ai-native-company-stack/blob/main/skills/lead-enrichment-brief/scripts/enrich.py"
click node_content "https://github.com/nifinet/ai-native-company-stack/blob/main/skills/content-draft-from-brief/SKILL.md"
click node_radar "https://github.com/nifinet/ai-native-company-stack/blob/main/skills/morning-radar/SKILL.md"
click node_retro "https://github.com/nifinet/ai-native-company-stack/blob/main/skills/weekly-retro-prep/SKILL.md"
click node_qa "https://github.com/nifinet/ai-native-company-stack/blob/main/skills/output-qa-check/SKILL.md"
click node_crm_template "https://github.com/nifinet/ai-native-company-stack/blob/main/mcp-servers/_crm-template/server.py"
click node_pipedrive "https://github.com/nifinet/ai-native-company-stack/blob/main/mcp-servers/pipedrive-mcp/server.py"
click node_notion "https://github.com/nifinet/ai-native-company-stack/blob/main/mcp-servers/notion-projects-mcp/server.py"

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_hermes toneBlue
class node_digest,node_digest_context,node_lead,node_lead_enrich,node_content,node_radar,node_retro,node_qa toneAmber
class node_crm_template,node_pipedrive,node_notion,node_crm_api,node_notion_api toneMint
class node_memory,node_messaging toneRose
class node_operator,node_web toneIndigo
```

## Components

### Agent runtime

- **Hermes Agent**

### Business skills

- [Weekly digest](https://github.com/nifinet/ai-native-company-stack/blob/main/skills/weekly-business-digest/SKILL.md): `skills/weekly-business-digest/SKILL.md`
- [Digest context helper](https://github.com/nifinet/ai-native-company-stack/blob/main/skills/weekly-business-digest/scripts/pull_context.py): `skills/weekly-business-digest/scripts/pull_context.py`
- [Lead brief](https://github.com/nifinet/ai-native-company-stack/blob/main/skills/lead-enrichment-brief/SKILL.md): `skills/lead-enrichment-brief/SKILL.md`
- [Lead enrichment helper](https://github.com/nifinet/ai-native-company-stack/blob/main/skills/lead-enrichment-brief/scripts/enrich.py): `skills/lead-enrichment-brief/scripts/enrich.py`
- [Content drafting](https://github.com/nifinet/ai-native-company-stack/blob/main/skills/content-draft-from-brief/SKILL.md): `skills/content-draft-from-brief/SKILL.md`
- [Morning radar](https://github.com/nifinet/ai-native-company-stack/blob/main/skills/morning-radar/SKILL.md): `skills/morning-radar/SKILL.md`
- [Weekly retro](https://github.com/nifinet/ai-native-company-stack/blob/main/skills/weekly-retro-prep/SKILL.md): `skills/weekly-retro-prep/SKILL.md`
- [Output QA](https://github.com/nifinet/ai-native-company-stack/blob/main/skills/output-qa-check/SKILL.md): `skills/output-qa-check/SKILL.md`

### MCP integrations

- [CRM server template](https://github.com/nifinet/ai-native-company-stack/blob/main/mcp-servers/_crm-template/server.py): `mcp-servers/_crm-template/server.py`
- [Pipedrive MCP](https://github.com/nifinet/ai-native-company-stack/blob/main/mcp-servers/pipedrive-mcp/server.py): `mcp-servers/pipedrive-mcp/server.py`
- [Notion projects MCP](https://github.com/nifinet/ai-native-company-stack/blob/main/mcp-servers/notion-projects-mcp/server.py): `mcp-servers/notion-projects-mcp/server.py`

### Context and delivery

- **Unit memory**
- **Messaging channels**

### Other components

- **Operator / event**
- **CRM API**
- **Notion API**
- **Public web**

## Connections

- Operator / event → Hermes Agent: triggers (evidence: `README.md`)
- Hermes Agent → Weekly digest: runs (evidence: `README.md`)
- Hermes Agent → Lead brief: runs (evidence: `README.md`)
- Hermes Agent → Content drafting: runs (evidence: `README.md`)
- Hermes Agent → Morning radar: runs (evidence: `README.md`)
- Hermes Agent → Weekly retro: runs (evidence: `README.md`)
- Hermes Agent → Output QA: runs (evidence: `README.md`)
- Weekly digest → Digest context helper: uses helper (evidence: `README.md`)
- Lead brief → Lead enrichment helper: uses helper (evidence: `README.md`)
- Weekly digest → Unit memory: reads and updates (evidence: `README.md`)
- Weekly digest → Notion projects MCP: requests task updates (evidence: `README.md`)
- Weekly digest → Pipedrive MCP: requests deal data (evidence: `README.md`)
- Weekly digest → Messaging channels: reads and posts (evidence: `README.md`)
- Weekly digest → Messaging channels: delivers digest (evidence: `README.md`)
- Lead brief → Pipedrive MCP: uses CRM tools (evidence: `README.md`)
- Lead brief → Public web: enriches lead (evidence: `README.md`)
- Content drafting → Messaging channels: delivers draft (evidence: `README.md`)
- Morning radar → Messaging channels: posts radar (evidence: `README.md`)
- Weekly retro → Messaging channels: delivers retro (evidence: `README.md`)
- Output QA → Messaging channels: returns review (evidence: `README.md`)
- CRM server template → CRM API: adapts to (evidence: `mcp-servers/_crm-template/server.py`)
- Pipedrive MCP → CRM API: calls (evidence: `mcp-servers/pipedrive-mcp/server.py`)
- Notion projects MCP → Notion API: calls (evidence: `mcp-servers/notion-projects-mcp/server.py`)
