Summary

This repository provides a unified set of rules, roles, and integrations for AI agents developing in 1C:Enterprise 8 (BSL). It addresses the challenge of adapting AI development practices across different agents by offering a portable, adaptable framework, enhancing developer productivity and consistency.

How It Works

The core approach centralizes rules and configurations (content/) that are adapted via specific adapters (adapters/*.yaml) for supported AI agents (Cursor, Claude Code, Codex, etc.). Installation is handled either directly by the AI agent following AGENT-INSTALL.md or via a PowerShell script (install.ps1). The system integrates specialized sub-agents, modular SKILL packages, and optional, locally deployed Dockerized MCP servers for advanced analysis and tooling, with graceful fallbacks.

Quick Start & Requirements

• Install: Via AI Agent: "Установи правила из https://github.com/comol/ai_rules_1c по AGENT-INSTALL.md". Via PowerShell: .\install.ps1 init -Source https://github.com/comol/ai_rules_1c (requires Git).
• Prerequisites: Git, PowerShell (for fallback), Docker (for MCP servers), target AI agent environment.
• Links: Repository, MCP Servers.

Highlighted Details

• Unified Rule Set: A single source of rules (content/) is dynamically adapted for multiple AI agents, ensuring consistent AI behavior.
• Specialized Sub-agents: Twelve distinct AI roles are provided for specific 1C development tasks, from architecture to testing.
• Modular SKILL Packages: Offers self-contained tools for metadata management, form generation, query optimization, and integrations.
• Advanced MCP Servers: Integrates optional Dockerized servers for deep analysis (metadata graph, code search, syntax checking) with graceful fallbacks.
• OpenSpec Integration: Includes a workspace for managing development specifications via slash commands.

Maintenance & Community

• Community: Discussions via the Telegram channel "IT Does Matter".

Licensing & Compatibility

• License: Stated as "No license, take and use as you wish," implying public domain or highly permissive use, but lacks formal definition.
• Compatibility: Primarily targets 1C:Enterprise 8 (BSL) development. Commercial use implications of the informal license should be carefully reviewed.

Limitations & Caveats

• Informal Licensing: The lack of a formal license introduces ambiguity for commercial adoption and derivative works.
• Optional Dependencies: Full functionality relies on optional, locally deployed MCP servers (Docker).
• Agent Dependency: Effectiveness is contingent on the capabilities and integration of supported AI agents.
• Fallback Requirements: PowerShell fallback requires Git and PowerShell installed on the system.