# arpxxx/sylph architecture

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

- Interactive diagram: https://gitdiagram.com/arpxxx/sylph
- Repository: https://github.com/arpxxx/sylph

## Overview

Sylph is a repository-based company knowledge workspace for AI coding agents, combining domain context, reusable task skills, and role-based agents. A user invokes a skill or agent through their AI tool; it reads relevant instructions and domain knowledge, prepares an output or task, and can improve skill guidance after user review. The README documents broad business capabilities, but implementation is mostly Markdown and its runtime interactions are not shown in the sampled source. The sampled DOCX generator implements contract document generation; links beyond those explicitly described in the README are therefore not inferred.

Main entry points: [`agents`](https://github.com/arpxxx/sylph/tree/main/agents) (Agent roles), [`.claude/skills`](https://github.com/arpxxx/sylph/tree/main/.claude/skills) (Task skills), [`legal/templates/enterprise-service-agreement.md`](https://github.com/arpxxx/sylph/blob/main/legal/templates/enterprise-service-agreement.md) (Contract templates), [`legal/templates/generate-docx.js`](https://github.com/arpxxx/sylph/blob/main/legal/templates/generate-docx.js) (DOCX generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_knowledge["Company knowledge"]
  node_global_rules["Agent instructions<br/>[AGENTS.md]"]
  node_company_context["Company context<br/>[CONTEXT.md]"]
  node_domain_context["Domain knowledge"]
  node_brand_context["Brand guidance"]
end

subgraph group_workflows["Skills and workflows"]
  node_skill_library["Task skills<br/>[skills]"]
  node_skill_setup["Skill setup<br/>[SKILL.md]"]
  node_self_improvement["Skill improvement<br/>[skills]"]
end

subgraph group_agents["AI agents"]
  node_agent_roles["Agent roles"]
  node_chief_staff["Chief of Staff<br/>[PROMPT.md]"]
  node_cmo["CMO<br/>[PROMPT.md]"]
  node_product_manager["Product Manager<br/>[PROMPT.md]"]
  node_customer_success["Customer Success<br/>[PROMPT.md]"]
  node_head_data["Head of Data<br/>[PROMPT.md]"]
  node_head_sales["Head of Sales<br/>[PROMPT.md]"]
  node_executive_assistant["Executive Assistant"]
  node_brand_designer["Brand Designer<br/>[PROMPT.md]"]
end

subgraph group_outputs["Business outputs"]
  node_content["Content workspace"]
  node_sales["Sales workspace"]
  node_product["Product work"]
  node_events["Events workspace"]
  node_legal_templates["Contract templates"]
  node_docx_generator["DOCX generator<br/>[generate-docx.js]"]
  node_finance["Investor updates"]
  node_customer_files["Customer success files"]
end

node_user(("Company team"))
node_agent_tool{{"AI coding agent"}}

node_user -->|"invokes"| node_agent_tool
node_agent_tool -->|"reads"| node_global_rules
node_agent_tool -->|"reads"| node_company_context
node_agent_tool -->|"uses domain context"| node_domain_context
node_agent_tool -->|"runs skill"| node_skill_library
node_agent_tool -->|"runs agents"| node_agent_roles
node_agent_tool -.->|"uses brand guidance"| node_brand_context
node_agent_tool -->|"personalizes skills"| node_skill_setup
node_skill_library -->|"improves after review"| node_self_improvement
node_agent_roles -->|"defines role"| node_chief_staff
node_agent_roles -->|"defines role"| node_cmo
node_agent_roles -->|"defines role"| node_product_manager
node_agent_roles -->|"defines role"| node_customer_success
node_agent_roles -->|"defines role"| node_head_data
node_agent_roles -->|"defines role"| node_head_sales
node_agent_roles -->|"defines role"| node_executive_assistant
node_agent_roles -->|"defines role"| node_brand_designer
node_agent_tool -->|"creates content"| node_content
node_agent_tool -->|"creates sales work"| node_sales
node_agent_tool -->|"creates product issues"| node_product
node_agent_tool -->|"creates events"| node_events
node_agent_tool -->|"drafts contracts"| node_legal_templates
node_docx_generator -.->|"generates document from"| node_legal_templates
node_agent_tool -->|"drafts updates"| node_finance
node_agent_tool -->|"drafts follow-ups"| node_customer_files

click node_global_rules "https://github.com/arpxxx/sylph/blob/main/AGENTS.md"
click node_company_context "https://github.com/arpxxx/sylph/blob/main/CONTEXT.md"
click node_domain_context "https://github.com/arpxxx/sylph/tree/main/product"
click node_brand_context "https://github.com/arpxxx/sylph/tree/main/brand/guidelines"
click node_skill_library "https://github.com/arpxxx/sylph/tree/main/.claude/skills"
click node_skill_setup "https://github.com/arpxxx/sylph/blob/main/.claude/skills/sylph-setup-skill/SKILL.md"
click node_self_improvement "https://github.com/arpxxx/sylph/tree/main/.claude/skills"
click node_agent_roles "https://github.com/arpxxx/sylph/tree/main/agents"
click node_chief_staff "https://github.com/arpxxx/sylph/blob/main/agents/chief-of-staff/PROMPT.md"
click node_cmo "https://github.com/arpxxx/sylph/blob/main/agents/cmo/PROMPT.md"
click node_product_manager "https://github.com/arpxxx/sylph/blob/main/agents/product-manager/PROMPT.md"
click node_customer_success "https://github.com/arpxxx/sylph/blob/main/agents/customer-success/PROMPT.md"
click node_head_data "https://github.com/arpxxx/sylph/blob/main/agents/head-of-data/PROMPT.md"
click node_head_sales "https://github.com/arpxxx/sylph/blob/main/agents/head-of-sales/PROMPT.md"
click node_executive_assistant "https://github.com/arpxxx/sylph/tree/main/agents"
click node_brand_designer "https://github.com/arpxxx/sylph/blob/main/agents/brand-designer/PROMPT.md"
click node_content "https://github.com/arpxxx/sylph/tree/main/content"
click node_sales "https://github.com/arpxxx/sylph/tree/main/sales"
click node_product "https://github.com/arpxxx/sylph/tree/main/product"
click node_events "https://github.com/arpxxx/sylph/tree/main/events"
click node_legal_templates "https://github.com/arpxxx/sylph/blob/main/legal/templates/enterprise-service-agreement.md"
click node_docx_generator "https://github.com/arpxxx/sylph/blob/main/legal/templates/generate-docx.js"
click node_finance "https://github.com/arpxxx/sylph/tree/main/finance/investor-updates"
click node_customer_files "https://github.com/arpxxx/sylph/tree/main/customer-success"

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_global_rules,node_company_context,node_domain_context,node_brand_context toneBlue
class node_skill_library,node_skill_setup,node_self_improvement toneAmber
class node_agent_roles,node_chief_staff,node_cmo,node_product_manager,node_customer_success,node_head_data,node_head_sales,node_executive_assistant,node_brand_designer toneMint
class node_content,node_sales,node_product,node_events,node_legal_templates,node_docx_generator,node_finance,node_customer_files toneRose
class node_user,node_agent_tool toneIndigo
```

## Components

### Company knowledge

- [Agent instructions](https://github.com/arpxxx/sylph/blob/main/AGENTS.md): `AGENTS.md`
- [Company context](https://github.com/arpxxx/sylph/blob/main/CONTEXT.md): `CONTEXT.md`
- [Domain knowledge](https://github.com/arpxxx/sylph/tree/main/product): `product`
- [Brand guidance](https://github.com/arpxxx/sylph/tree/main/brand/guidelines): `brand/guidelines`

### Skills and workflows

- [Task skills](https://github.com/arpxxx/sylph/tree/main/.claude/skills): `.claude/skills`
- [Skill setup](https://github.com/arpxxx/sylph/blob/main/.claude/skills/sylph-setup-skill/SKILL.md): `.claude/skills/sylph-setup-skill/SKILL.md`
- [Skill improvement](https://github.com/arpxxx/sylph/tree/main/.claude/skills): `.claude/skills`

### AI agents

- [Agent roles](https://github.com/arpxxx/sylph/tree/main/agents): `agents`
- [Chief of Staff](https://github.com/arpxxx/sylph/blob/main/agents/chief-of-staff/PROMPT.md): `agents/chief-of-staff/PROMPT.md`
- [CMO](https://github.com/arpxxx/sylph/blob/main/agents/cmo/PROMPT.md): `agents/cmo/PROMPT.md`
- [Product Manager](https://github.com/arpxxx/sylph/blob/main/agents/product-manager/PROMPT.md): `agents/product-manager/PROMPT.md`
- [Customer Success](https://github.com/arpxxx/sylph/blob/main/agents/customer-success/PROMPT.md): `agents/customer-success/PROMPT.md`
- [Head of Data](https://github.com/arpxxx/sylph/blob/main/agents/head-of-data/PROMPT.md): `agents/head-of-data/PROMPT.md`
- [Head of Sales](https://github.com/arpxxx/sylph/blob/main/agents/head-of-sales/PROMPT.md): `agents/head-of-sales/PROMPT.md`
- [Executive Assistant](https://github.com/arpxxx/sylph/tree/main/agents): `agents`
- [Brand Designer](https://github.com/arpxxx/sylph/blob/main/agents/brand-designer/PROMPT.md): `agents/brand-designer/PROMPT.md`

### Business outputs

- [Content workspace](https://github.com/arpxxx/sylph/tree/main/content): `content`
- [Sales workspace](https://github.com/arpxxx/sylph/tree/main/sales): `sales`
- [Product work](https://github.com/arpxxx/sylph/tree/main/product): `product`
- [Events workspace](https://github.com/arpxxx/sylph/tree/main/events): `events`
- [Contract templates](https://github.com/arpxxx/sylph/blob/main/legal/templates/enterprise-service-agreement.md): `legal/templates/enterprise-service-agreement.md`
- [DOCX generator](https://github.com/arpxxx/sylph/blob/main/legal/templates/generate-docx.js): `legal/templates/generate-docx.js`
- [Investor updates](https://github.com/arpxxx/sylph/tree/main/finance/investor-updates): `finance/investor-updates`
- [Customer success files](https://github.com/arpxxx/sylph/tree/main/customer-success): `customer-success`

### Other components

- **Company team**
- **AI coding agent**

## Connections

- Company team → AI coding agent: invokes (evidence: `README.md`)
- AI coding agent → Agent instructions: reads (evidence: `README.md`)
- AI coding agent → Company context: reads (evidence: `README.md`)
- AI coding agent → Domain knowledge: uses domain context (evidence: `README.md`)
- AI coding agent → Task skills: runs skill (evidence: `README.md`)
- AI coding agent → Agent roles: runs agents (evidence: `README.md`)
- AI coding agent → Brand guidance: uses brand guidance
- AI coding agent → Skill setup: personalizes skills (evidence: `README.md`)
- Task skills → Skill improvement: improves after review (evidence: `README.md`)
- Agent roles → Chief of Staff: defines role (evidence: `README.md`)
- Agent roles → CMO: defines role (evidence: `README.md`)
- Agent roles → Product Manager: defines role (evidence: `README.md`)
- Agent roles → Customer Success: defines role (evidence: `README.md`)
- Agent roles → Head of Data: defines role (evidence: `README.md`)
- Agent roles → Head of Sales: defines role (evidence: `README.md`)
- Agent roles → Executive Assistant: defines role (evidence: `README.md`)
- Agent roles → Brand Designer: defines role (evidence: `README.md`)
- AI coding agent → Content workspace: creates content (evidence: `README.md`)
- AI coding agent → Sales workspace: creates sales work (evidence: `README.md`)
- AI coding agent → Product work: creates product issues (evidence: `README.md`)
- AI coding agent → Events workspace: creates events (evidence: `README.md`)
- AI coding agent → Contract templates: drafts contracts (evidence: `README.md`)
- DOCX generator → Contract templates: generates document from
- AI coding agent → Investor updates: drafts updates (evidence: `README.md`)
- AI coding agent → Customer success files: drafts follow-ups (evidence: `README.md`)
