AIKraft/Skills/software-architecture

software-architecture

Руководство по качественной архитектуре ПО. Применяется при написании кода, проектировании архитектуры, анализе кода и любых задачах, связанных с разработкой.

sickn33 official Разработка ★ 47.3k

Что делает навык

Навык предоставляет руководство по разработке качественного ПО и проектированию архитектуры на основе принципов Clean Architecture и Domain-Driven Design. Он применяется для написания кода, анализа и проектирования, обеспечивая соблюдение стандартов качества и разделения ответственности.

Когда применять

  • Проектирование архитектуры приложения с разделением доменных сущностей и инфраструктурных задач.
  • Рефакторинг кода: разделение длинных компонентов (более 80 строк) и файлов (более 200 строк) на более мелкие модули.
  • Выбор решений: поиск готовых библиотек (например, cockatiel, Redux, Zustand) вместо написания собственного кода.
  • Улучшение читаемости кода через использование раннего возврата (early return) и избегание глубокой вложенности.
  • Именование модулей и функций в соответствии с доменной спецификой (bounded context) вместо использования общих имен.

Как работает

  1. Проверить наличие готовых решений в npm, SaaS или сторонних API перед написанием собственного кода.
  2. Применять принцип раннего возврата (early return) вместо вложенных условий для повышения читаемости.
  3. Разбивать функции длиннее 80 строк и файлы длиннее 200 строк на более мелкие компоненты или модули.
  4. Использовать стрелочные функции (arrow functions) вместо объявлений функций (function declarations).
  5. Изолировать бизнес-логику от UI-компонентов и баз данных, соблюдая границы контекстов.
  6. Называть модули и функции на основе доменной логики (например, OrderCalculator), избегая имен utils или helpers.

Примеры запросов агенту

Используй @software-architecture для этой задачи: руководство по качественной архитектуре ПО.
Проанализируй этот код с точки зрения принципов Clean Architecture и DDD.
Рефактори функцию, разбив её на более мелкие части и применив ранний возврат.

Описание составлено по SKILL.md навыка, сверено 06.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «software-architecture» из репозитория: # https://github.com/sickn33/agentic-awesome-skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r software-architecture/ ~/.claude/skills/software-architecture/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.