# nikolay-shirokov/cc-1c-skills architecture

> Architecture diagram of the GitHub repository nikolay-shirokov/cc-1c-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nikolay-shirokov/cc-1c-skills
- Repository: https://github.com/nikolay-shirokov/cc-1c-skills

## Overview

This repository is an agent skill suite for 1C:Enterprise development, not a single application. An agent selects a skill for the requested artifact or operation; the skill’s scripts create, inspect, edit, compile, or validate 1C sources, while database and web skills carry changes into a running environment. The README also documents browser testing, regression runs, and video capture. Skill implementations are represented at their existing directories; their individual runtime wiring was not sampled, so uncertain calls between skill areas are omitted.

Main entry points: [`.claude/skills/db-run`](https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/db-run) (Database Operations), [`.claude/skills/web-test`](https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/web-test) (Browser Testing), [`hooks/skill-suggester.mjs`](https://github.com/nikolay-shirokov/cc-1c-skills/blob/main/hooks/skill-suggester.mjs) (Skill Guidance), [`hooks/support-guard.mjs`](https://github.com/nikolay-shirokov/cc-1c-skills/blob/main/hooks/support-guard.mjs) (Support Guard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["1C Authoring"]
  node_cf["Configuration<br/>[cf-edit]"]
  node_cfe["Extensions<br/>[cfe-borrow]"]
  node_metadata["Metadata Objects<br/>[meta-edit]"]
  node_forms["Managed Forms<br/>[form-compile]"]
  node_epf_erf["EPF and ERF<br/>[epf-build]"]
  node_mxl_skd["Layouts and Reports<br/>[mxl-compile]"]
  node_roles["Roles and Rights<br/>[role-compile]"]
  node_subsystems["Subsystems and UI<br/>[subsystem-edit]"]
  node_xdto["XDTO Packages<br/>[xdto-compile]"]
  node_project_files["1C Source Files"]
end

subgraph group_delivery["Database Delivery"]
  node_db_ops["Database Operations<br/>[db-run]"]
  node_db_store[("Information Base")]
  node_repo_ops["Config Repository<br/>[db-repo]"]
end

subgraph group_web["Web Operations"]
  node_web_publish["Web Publication<br/>[web-publish]"]
  node_apache["Apache Server"]
  node_web_test["Browser Testing<br/>[web-test]"]
  node_web_client["1C Web Client"]
end

subgraph group_agent_support["Agent Support"]
  node_hooks["Skill Guidance"]
  node_support_guard["Support Guard<br/>[support-guard.mjs]"]
  node_support_state["Support State<br/>[support-state.mjs]"]
  node_project_config["Project Settings<br/>[project.mjs]"]
end

node_agent(("AI Agent"))

node_agent -->|"invokes"| node_cf
node_agent -->|"invokes"| node_cfe
node_agent -->|"invokes"| node_metadata
node_agent -->|"invokes"| node_forms
node_agent -->|"invokes"| node_epf_erf
node_agent -->|"invokes"| node_mxl_skd
node_agent -->|"invokes"| node_roles
node_agent -->|"invokes"| node_subsystems
node_agent -->|"invokes"| node_xdto
node_cf -->|"edits and validates"| node_project_files
node_cfe -->|"builds extensions"| node_project_files
node_metadata -->|"edits and validates"| node_project_files
node_forms -->|"compiles and edits"| node_project_files
node_epf_erf -->|"builds and validates"| node_project_files
node_mxl_skd -->|"compiles and inspects"| node_project_files
node_roles -->|"compiles and validates"| node_project_files
node_subsystems -->|"edits and validates"| node_project_files
node_xdto -->|"compiles and edits"| node_project_files
node_agent -->|"invokes"| node_db_ops
node_db_ops -->|"loads and updates"| node_db_store
node_db_ops -->|"loads and dumps"| node_project_files
node_agent -->|"invokes"| node_repo_ops
node_repo_ops -->|"manages repository"| node_db_store
node_agent -->|"invokes"| node_web_publish
node_web_publish -->|"publishes to"| node_apache
node_agent -->|"invokes"| node_web_test
node_web_test -->|"drives and tests"| node_web_client
node_web_test -.->|"records sessions"| node_web_client
node_hooks -.->|"suggests skills"| node_agent
node_hooks -.->|"reads settings"| node_project_config
node_support_guard -.->|"checks edit state"| node_support_state
node_support_guard -.->|"reads policy"| node_project_config

click node_cf "https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/cf-edit"
click node_cfe "https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/cfe-borrow"
click node_metadata "https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/meta-edit"
click node_forms "https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/form-compile"
click node_epf_erf "https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/epf-build"
click node_mxl_skd "https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/mxl-compile"
click node_roles "https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/role-compile"
click node_subsystems "https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/subsystem-edit"
click node_xdto "https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/xdto-compile"
click node_db_ops "https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/db-run"
click node_repo_ops "https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/db-repo"
click node_web_publish "https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/web-publish"
click node_web_test "https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/web-test"
click node_hooks "https://github.com/nikolay-shirokov/cc-1c-skills/blob/main/hooks/skill-suggester.mjs"
click node_support_guard "https://github.com/nikolay-shirokov/cc-1c-skills/blob/main/hooks/support-guard.mjs"
click node_support_state "https://github.com/nikolay-shirokov/cc-1c-skills/blob/main/hooks/common/support-state.mjs"
click node_project_config "https://github.com/nikolay-shirokov/cc-1c-skills/blob/main/hooks/common/project.mjs"

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_cf,node_cfe,node_metadata,node_forms,node_epf_erf,node_mxl_skd,node_roles,node_subsystems,node_xdto,node_project_files toneBlue
class node_db_ops,node_db_store,node_repo_ops toneAmber
class node_web_publish,node_apache,node_web_test,node_web_client toneMint
class node_hooks,node_support_guard,node_support_state,node_project_config toneRose
class node_agent toneIndigo
```

## Components

### 1C Authoring

- [Configuration](https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/cf-edit): `.claude/skills/cf-edit`
- [Extensions](https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/cfe-borrow): `.claude/skills/cfe-borrow`
- [Metadata Objects](https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/meta-edit): `.claude/skills/meta-edit`
- [Managed Forms](https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/form-compile): `.claude/skills/form-compile`
- [EPF and ERF](https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/epf-build): `.claude/skills/epf-build`
- [Layouts and Reports](https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/mxl-compile): `.claude/skills/mxl-compile`
- [Roles and Rights](https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/role-compile): `.claude/skills/role-compile`
- [Subsystems and UI](https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/subsystem-edit): `.claude/skills/subsystem-edit`
- [XDTO Packages](https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/xdto-compile): `.claude/skills/xdto-compile`
- **1C Source Files**

### Database Delivery

- [Database Operations](https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/db-run): `.claude/skills/db-run`
- **Information Base**
- [Config Repository](https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/db-repo): `.claude/skills/db-repo`

### Web Operations

- [Web Publication](https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/web-publish): `.claude/skills/web-publish`
- **Apache Server**
- [Browser Testing](https://github.com/nikolay-shirokov/cc-1c-skills/tree/main/.claude/skills/web-test): `.claude/skills/web-test`
- **1C Web Client**

### Agent Support

- [Skill Guidance](https://github.com/nikolay-shirokov/cc-1c-skills/blob/main/hooks/skill-suggester.mjs): `hooks/skill-suggester.mjs`
- [Support Guard](https://github.com/nikolay-shirokov/cc-1c-skills/blob/main/hooks/support-guard.mjs): `hooks/support-guard.mjs`
- [Support State](https://github.com/nikolay-shirokov/cc-1c-skills/blob/main/hooks/common/support-state.mjs): `hooks/common/support-state.mjs`
- [Project Settings](https://github.com/nikolay-shirokov/cc-1c-skills/blob/main/hooks/common/project.mjs): `hooks/common/project.mjs`

### Other components

- **AI Agent**

## Connections

- AI Agent → Configuration: invokes
- AI Agent → Extensions: invokes
- AI Agent → Metadata Objects: invokes
- AI Agent → Managed Forms: invokes
- AI Agent → EPF and ERF: invokes
- AI Agent → Layouts and Reports: invokes
- AI Agent → Roles and Rights: invokes
- AI Agent → Subsystems and UI: invokes
- AI Agent → XDTO Packages: invokes
- Configuration → 1C Source Files: edits and validates
- Extensions → 1C Source Files: builds extensions
- Metadata Objects → 1C Source Files: edits and validates
- Managed Forms → 1C Source Files: compiles and edits
- EPF and ERF → 1C Source Files: builds and validates
- Layouts and Reports → 1C Source Files: compiles and inspects
- Roles and Rights → 1C Source Files: compiles and validates
- Subsystems and UI → 1C Source Files: edits and validates
- XDTO Packages → 1C Source Files: compiles and edits
- AI Agent → Database Operations: invokes
- Database Operations → Information Base: loads and updates
- Database Operations → 1C Source Files: loads and dumps
- AI Agent → Config Repository: invokes
- Config Repository → Information Base: manages repository
- AI Agent → Web Publication: invokes
- Web Publication → Apache Server: publishes to
- AI Agent → Browser Testing: invokes
- Browser Testing → 1C Web Client: drives and tests
- Browser Testing → 1C Web Client: records sessions
- Skill Guidance → AI Agent: suggests skills
- Skill Guidance → Project Settings: reads settings
- Support Guard → Support State: checks edit state
- Support Guard → Project Settings: reads policy
