AI Software Architect

Маркdown-фреймворк для внедрения строгих практик программной архитектуры в любом проекте, с интеграцией специализированного AI-ассистента.

Обзор

Фреймворк обеспечивает структурированный подход к:

1. Документированию архитектуры — шаблоны и процессы для фиксации архитектурных решений
2. Архитектурным ревью — многоуровневый процесс проверки с участием специализированных ревьюеров
3. Рекалибровке архитектуры — перевод результатов ревью в конкретные планы реализации
4. Отслеживанию прогресса — инструменты мониторинга внедрения архитектурных изменений
5. AI-интеграции — бесшовное взаимодействие с AI-ассистентами для написания кода

Подробные инструкции по использованию — в USAGE.md. Решение проблем и расширенное использование — в TROUBLESHOOTING.md.

Установка

Выберите способ установки для вашего AI-ассистента:

Установка для Claude Code

Claude Code поддерживает четыре способа установки:

Вариант 1: Claude Code Plugin (рекомендуется) 🆕

Установка через систему плагинов Claude Code с автоматическими обновлениями:

# В Claude Code выполните команды:
/plugin marketplace add anthropics/ai-software-architect
/plugin install ai-software-architect@ai-software-architect

Готово! Фреймворк теперь доступен во всех ваших проектах.

См. USAGE-WITH-CLAUDE-PLUGIN.md — подробное руководство по установке, решению проблем и сравнению с другими методами.

Преимущества: простейшая установка, автоматические обновления, работает во всех проектах, не требует ручного управления файлами

Когда использовать: вы работаете с Claude Code и хотите максимально удобный опыт с автоматическими обновлениями.

Вариант 2: Claude Skills

Установка как переиспользуемые скиллы, работающие во всех проектах:

# Клонируйте и установите скиллы
git clone https://github.com/codenamev/ai-software-architect /tmp/ai-architect-$$
cp -r /tmp/ai-architect-$$/.claude/skills ~/.claude/
# Временная директория будет удалена автоматически, или вы можете удалить её вручную:
# rm -rf /tmp/ai-architect-$$

Затем в любом проекте:

См. USAGE-WITH-CLAUDE-SKILLS.md для подробных инструкций.

Преимущества: нет зависимостей, автоматический вызов скиллов, портативность, работает офлайн

Когда использовать: вы хотите контролировать обновления вручную или нужна офлайн-доступность.

Вариант 3: MCP Server

Затем настройте в ~/.claude/config.json:

{
  "mcpServers": {
    "ai-software-architect": {
      "command": "mcp",
      "args": []
    }
  }
}

Преимущества: программная автоматизация, интеграция с внешними инструментами, расширенный анализ проектов

Когда использовать: нужен программный доступ или интеграция с другими MCP-совместимыми инструментами.

Вариант 4: Традиционная установка

См. USAGE-WITH-CLAUDE.md для подробных инструкций.

Преимущества: установка не требуется, работает сразу, максимальная гибкость

Когда использовать: быстрые эксперименты, нет прав на установку или нужна максимальная кастомизация.

Установка для Cursor

Если вы используете Cursor, доступны два варианта:

Вариант 1: MCP Server (рекомендуется)

Затем настройте в настройках Cursor (settings.json):

{
  "mcp.servers": {
    "ai-software-architect": {
      "command": "mcp",
      "args": []
    }
  }
}

Вариант 2: Традиционная установка

См. USAGE-WITH-CURSOR.md для подробных инструкций по традиционной установке.

Установка для GitHub Copilot / Codex

Поддержка MCP: GitHub Copilot и Codex имеют ограниченную поддержку MCP. Используйте традиционный способ установки:

См. USAGE-WITH-CODEX.md для подробных инструкций. Фреймворк будет настроен с контекстными файлами, которые GitHub Copilot и Codex смогут автоматически распознать.

Сравнение методов установки

Выберите подходящий метод для вашего рабочего процесса: