@h2nguyen/arc42-node-mcp-server 2.0.0 → 2.1.1

package/dist/templates/locales/ukr/templates-asciidoc.js

@@ -0,0 +1,764 @@
+/**
+ * Ukrainian Templates - AsciiDoc Format
+ *
+ * Contains all arc42 section templates in Ukrainian using AsciiDoc syntax.
+ * Based on the official arc42 templates from vendor/arc42-template.
+ *
+ * @module templates/locales/ukr/templates-asciidoc
+ */
+/**
+ * Get the Ukrainian AsciiDoc template for a specific section
+ */
+export function getTemplate(section) {
+    const templates = {
+        '01_introduction_and_goals': getIntroductionAndGoalsTemplate,
+        '02_architecture_constraints': getArchitectureConstraintsTemplate,
+        '03_context_and_scope': getContextAndScopeTemplate,
+        '04_solution_strategy': getSolutionStrategyTemplate,
+        '05_building_block_view': getBuildingBlockViewTemplate,
+        '06_runtime_view': getRuntimeViewTemplate,
+        '07_deployment_view': getDeploymentViewTemplate,
+        '08_concepts': getConceptsTemplate,
+        '09_architecture_decisions': getArchitectureDecisionsTemplate,
+        '10_quality_requirements': getQualityRequirementsTemplate,
+        '11_technical_risks': getTechnicalRisksTemplate,
+        '12_glossary': getGlossaryTemplate
+    };
+    return templates[section]();
+}
+function getIntroductionAndGoalsTemplate() {
+    return `= 1. Вступ і цілі
+
+== Огляд вимог
+
+*Мета*: Описує відповідні вимоги та рушійні сили, які повинні враховувати архітектори програмного забезпечення та команда розробників.
+
+=== Основні вимоги
+
+// Перелічіть 3-5 основних функціональних вимог
+
+[options="header",cols="1,3,1"]
+|===
+|ID |Вимога |Пріоритет
+|REQ-1 |[Короткий опис] |Високий
+|REQ-2 |[Короткий опис] |Середній
+|===
+
+=== Функції
+
+// Основні функції системи
+
+* Функція 1: [Опис]
+* Функція 2: [Опис]
+
+== Цілі якості
+
+*Мета*: Визначте 3-5 найважливіших цілей якості для архітектури.
+
+// На основі ISO 25010, розставте пріоритети таких якостей як:
+// Продуктивність, Безпека, Надійність, Підтримуваність, Зручність використання тощо.
+
+[options="header",cols="1,2,3"]
+|===
+|Пріоритет |Ціль якості |Мотивація
+|1 |[напр., Продуктивність] |[Чому це важливо]
+|2 |[напр., Безпека] |[Чому це важливо]
+|3 |[напр., Підтримуваність] |[Чому це важливо]
+|===
+
+== Зацікавлені сторони
+
+*Мета*: Визначте всіх, хто повинен знати про архітектуру.
+
+[options="header",cols="2,2,3"]
+|===
+|Роль/Ім'я |Контакт |Очікування
+|Власник продукту |[Ім'я/Email] |[Що вони очікують від архітектури]
+|Команда розробників |[Назва команди] |[Що їм потрібно знати]
+|Операційна команда |[Команда/Особа] |[Питання розгортання та експлуатації]
+|Кінцеві користувачі |[Тип] |[Очікування щодо користувацького досвіду]
+|===
+
+.Додаткова інформація
+Див. link:https://docs.arc42.org/section-1/[Вступ і Цілі] в документації arc42.
+`;
+}
+function getArchitectureConstraintsTemplate() {
+    return `= 2. Архітектурні обмеження
+
+*Мета*: Документуйте будь-які вимоги, що обмежують архітекторів у їхній свободі проектування та реалізації рішень.
+
+== Технічні обмеження
+
+[options="header",cols="1,3"]
+|===
+|Обмеження |Пояснення
+|[напр., Має працювати на Linux] |[Чому існує це обмеження]
+|[напр., Java 17 мінімум] |[Організаційна вимога]
+|===
+
+== Організаційні обмеження
+
+[options="header",cols="1,3"]
+|===
+|Обмеження |Пояснення
+|[напр., Розмір команди: 5 розробників] |[Вплив на архітектуру]
+|[напр., Термін: 6 місяців] |[Обмеження по доставці]
+|===
+
+== Конвенції
+
+[options="header",cols="1,3"]
+|===
+|Конвенція |Пояснення
+|[напр., Стиль коду: Google Java Style] |[Посилання на керівництво]
+|[напр., Документація: arc42] |[Вимоги до документації]
+|===
+
+.Додаткова інформація
+Див. link:https://docs.arc42.org/section-2/[Архітектурні обмеження] в документації arc42.
+`;
+}
+function getContextAndScopeTemplate() {
+    return `= 3. Область дії системи та її контекст
+
+*Мета*: Відмежовує вашу систему від її комунікаційних партнерів (сусідніх систем і користувачів).
+
+== Бізнес контекст
+
+*Мета*: Специфікація всіх комунікаційних партнерів (користувачів, ІТ-систем, ...) з поясненнями вхідних і вихідних даних домену.
+
+// Додайте контекстну діаграму тут (PlantUML, Mermaid, або зображення)
+
+[plantuml, business-context, svg]
+----
+@startuml
+!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
+
+Person(user, "Користувач", "Користувач системи")
+System(system, "Ваша Система", "Опис")
+System_Ext(external, "Зовнішня Система", "Опис")
+
+Rel(user, system, "Використовує")
+Rel(system, external, "Викликає")
+@enduml
+----
+
+[options="header",cols="1,2,2"]
+|===
+|Партнер |Вхід |Вихід
+|[Користувач/Система] |[Що вони надсилають] |[Що вони отримують]
+|===
+
+== Технічний контекст
+
+*Мета*: Специфікація технічних каналів і протоколів між системою та її контекстом.
+
+// Технічна інфраструктура з протоколами
+
+[options="header",cols="1,1,2"]
+|===
+|Партнер |Канал |Протокол
+|[Назва системи] |[напр., REST API] |[напр., HTTPS, JSON]
+|[Назва системи] |[напр., Черга повідомлень] |[напр., AMQP]
+|===
+
+.Додаткова інформація
+Див. link:https://docs.arc42.org/section-3/[Контекст і область дії] в документації arc42.
+`;
+}
+function getSolutionStrategyTemplate() {
+    return `= 4. Стратегія рішення
+
+*Мета*: Короткий виклад основних рішень і стратегій, які формують архітектуру системи.
+
+== Технологічні рішення
+
+[options="header",cols="1,2,2"]
+|===
+|Рішення |Вибір |Обґрунтування
+|Мова програмування |[напр., TypeScript] |[Чому цей вибір]
+|Фреймворк |[напр., NestJS] |[Чому цей вибір]
+|База даних |[напр., PostgreSQL] |[Чому цей вибір]
+|===
+
+== Декомпозиція верхнього рівня
+
+Опишіть структуру верхнього рівня:
+
+* [напр., Шарова архітектура]
+* [напр., Мікросервіси]
+* [напр., Подійно-орієнтована]
+
+== Стратегії досягнення якості
+
+[options="header",cols="1,2"]
+|===
+|Ціль якості |Стратегія досягнення
+|[Продуктивність] |[напр., Кешування, асинхронна обробка]
+|[Безпека] |[напр., OAuth2, шифрування даних]
+|[Підтримуваність] |[напр., Чиста архітектура, комплексні тести]
+|===
+
+.Додаткова інформація
+Див. link:https://docs.arc42.org/section-4/[Стратегія рішення] в документації arc42.
+`;
+}
+function getBuildingBlockViewTemplate() {
+    return `= 5. Представлення будівельних блоків
+
+*Мета*: Статична декомпозиція системи на будівельні блоки з їхніми залежностями.
+
+== Рівень 1: Загальна система
+
+*Мета*: White box опис показує внутрішню структуру всієї системи.
+
+=== White Box опис
+
+// Додайте діаграму компонентів тут
+
+[plantuml, building-blocks-l1, svg]
+----
+@startuml
+!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml
+
+Container(web, "Веб-додаток", "React", "Інтерфейс користувача")
+Container(api, "API Сервер", "Node.js", "Бізнес-логіка")
+ContainerDb(db, "База даних", "PostgreSQL", "Зберігання даних")
+
+Rel(web, api, "Викликає", "REST/JSON")
+Rel(api, db, "Читає/Записує", "SQL")
+@enduml
+----
+
+=== Вбудовані будівельні блоки
+
+[options="header",cols="1,3"]
+|===
+|Будівельний блок |Опис
+|[Компонент A] |[Відповідальність і призначення]
+|[Компонент B] |[Відповідальність і призначення]
+|===
+
+== Рівень 2: [Назва підсистеми]
+
+*Мета*: Декомпозиція основних компонентів на менші будівельні блоки.
+
+=== White Box [Компонент A]
+
+// Опишіть внутрішню структуру Компонента A
+
+[options="header",cols="1,3"]
+|===
+|Будівельний блок |Опис
+|[Підкомпонент A.1] |[Відповідальність]
+|[Підкомпонент A.2] |[Відповідальність]
+|===
+
+.Додаткова інформація
+Див. link:https://docs.arc42.org/section-5/[Представлення будівельних блоків] в документації arc42.
+`;
+}
+function getRuntimeViewTemplate() {
+    return `= 6. Рантайм представлення
+
+*Мета*: Документуйте поведінку та взаємодію будівельних блоків під час виконання.
+
+== Сценарій 1: [напр., Вхід користувача]
+
+// Опишіть поведінку під час виконання для ключового сценарію
+
+[plantuml, runtime-login, svg]
+----
+@startuml
+actor Користувач
+participant "Веб-додаток" as Web
+participant "API Сервер" as API
+participant "Сервіс автентифікації" as Auth
+database "БД Користувачів" as DB
+
+Користувач -> Web: Введення облікових даних
+Web -> API: POST /auth/login
+API -> Auth: Перевірка облікових даних
+Auth -> DB: Запит користувача
+DB --> Auth: Дані користувача
+Auth --> API: JWT токен
+API --> Web: Успіх + токен
+Web --> Користувач: Панель управління
+@enduml
+----
+
+=== Опис
+
+. Користувач вводить облікові дані у веб-додатку
+. Веб-додаток надсилає запит на вхід до API сервера
+. API перевіряє облікові дані через сервіс автентифікації
+. У разі успіху повертається JWT токен
+
+== Сценарій 2: [напр., Обробка даних]
+
+// Задокументуйте інший важливий сценарій виконання
+
+=== Опис
+
+[Опишіть кроки та взаємодії]
+
+.Додаткова інформація
+Див. link:https://docs.arc42.org/section-6/[Представлення часу виконання] в документації arc42.
+`;
+}
+function getDeploymentViewTemplate() {
+    return `= 7. Представлення розгортання
+
+*Мета*: Технічна інфраструктура із середовищами, комп'ютерами, процесорами, топологіями.
+
+== Інфраструктура Рівень 1
+
+*Мета*: Огляд інфраструктури розгортання.
+
+[plantuml, deployment-l1, svg]
+----
+@startuml
+!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Deployment.puml
+
+Deployment_Node(cloud, "Хмарний провайдер", "AWS/Azure/GCP") {
+    Deployment_Node(web_tier, "Веб рівень") {
+        Container(web, "Веб-сервер", "nginx", "Статичні файли + зворотний проксі")
+    }
+    Deployment_Node(app_tier, "Рівень додатку") {
+        Container(api, "API Сервер", "Node.js", "Бізнес-логіка")
+    }
+    Deployment_Node(data_tier, "Рівень даних") {
+        ContainerDb(db, "База даних", "PostgreSQL", "Основне сховище")
+    }
+}
+@enduml
+----
+
+=== Мотивація
+
+[Чому обрана ця архітектура розгортання]
+
+=== Характеристики якості та продуктивності
+
+[Як це розгортання підтримує цілі якості]
+
+== Інфраструктура Рівень 2
+
+*Мета*: Детальний огляд конкретних вузлів розгортання.
+
+=== [Назва вузла]
+
+[options="header",cols="1,3"]
+|===
+|Аспект |Опис
+|Апаратне забезпечення |[напр., 4 vCPU, 16GB RAM]
+|Програмне забезпечення |[напр., Ubuntu 22.04, Docker 24.x]
+|Мережа |[напр., VPC, групи безпеки]
+|===
+
+.Додаткова інформація
+Див. link:https://docs.arc42.org/section-7/[Представлення розгортання] в документації arc42.
+`;
+}
+function getConceptsTemplate() {
+    return `= 8. Наскрізні концепції
+
+*Мета*: Загальні правила та ідеї рішень, які стосуються багатьох будівельних блоків.
+
+== Модель домену
+
+// Основні концепції домену та їхні зв'язки
+
+[plantuml, domain-model, svg]
+----
+@startuml
+class Користувач {
+  +id: UUID
+  +email: String
+  +name: String
+}
+class Замовлення {
+  +id: UUID
+  +status: OrderStatus
+  +createdAt: DateTime
+}
+Користувач "1" -- "*" Замовлення : створює
+@enduml
+----
+
+== Концепція безпеки
+
+=== Автентифікація
+
+[Опишіть підхід до автентифікації: JWT, OAuth2 тощо]
+
+=== Авторизація
+
+[Опишіть підхід до авторизації: RBAC, ABAC тощо]
+
+== Обробка помилок
+
+[Опишіть, як обробляються помилки в системі]
+
+* [напр., Глобальний обробник помилок]
+* [напр., Структуровані відповіді про помилки]
+* [напр., Стратегія логування помилок]
+
+== Логування та моніторинг
+
+[options="header",cols="1,2"]
+|===
+|Аспект |Підхід
+|Логування |[напр., Структуровані JSON логи, ELK стек]
+|Метрики |[напр., Prometheus, Grafana]
+|Трасування |[напр., OpenTelemetry, Jaeger]
+|===
+
+== Стратегія тестування
+
+[options="header",cols="1,2,1"]
+|===
+|Тип |Обсяг |Цільове покриття
+|Модульні тести |Окремі функції/класи |80%
+|Інтеграційні тести |Взаємодія компонентів |Ключові шляхи
+|E2E тести |Повні сценарії користувача |Критичні потоки
+|===
+
+.Додаткова інформація
+Див. link:https://docs.arc42.org/section-8/[Наскрізні концепції] в документації arc42.
+`;
+}
+function getArchitectureDecisionsTemplate() {
+    return `= 9. Архітектурні рішення
+
+*Мета*: Документуйте важливі, дорогі, масштабні або ризиковані архітектурні рішення.
+
+== ADR-001: [Назва рішення]
+
+=== Статус
+
+[Запропоновано | Прийнято | Застаріло | Замінено]
+
+=== Контекст
+
+[Опишіть проблему, що мотивує це рішення]
+
+=== Рішення
+
+[Опишіть прийняте рішення]
+
+=== Наслідки
+
+*Позитивні:*
+
+* [Перевага 1]
+* [Перевага 2]
+
+*Негативні:*
+
+* [Недолік 1]
+* [Недолік 2]
+
+=== Розглянуті альтернативи
+
+[options="header",cols="1,2,2"]
+|===
+|Альтернатива |Переваги |Недоліки
+|[Варіант A] |[Переваги] |[Недоліки]
+|[Варіант B] |[Переваги] |[Недоліки]
+|===
+
+'''
+
+== ADR-002: [Назва рішення]
+
+// Використовуйте той самий шаблон для додаткових рішень
+
+.Додаткова інформація
+Див. link:https://docs.arc42.org/section-9/[Архітектурні рішення] в документації arc42.
+`;
+}
+function getQualityRequirementsTemplate() {
+    return `= 10. Вимоги до якості
+
+*Мета*: Конкретні вимоги до якості зі сценаріями для оцінки.
+
+== Дерево якості
+
+// Візуальне представлення цілей якості та їхньої деталізації
+
+[plantuml, quality-tree, svg]
+----
+@startmindmap
+* Якість
+** Продуктивність
+*** Час відповіді
+*** Пропускна здатність
+** Безпека
+*** Автентифікація
+*** Авторизація
+** Підтримуваність
+*** Модульність
+*** Тестованість
+@endmindmap
+----
+
+== Сценарії якості
+
+=== Сценарії продуктивності
+
+[options="header",cols="1,2,1,1"]
+|===
+|ID |Сценарій |Очікувана відповідь |Пріоритет
+|PERF-1 |Користувач запитує панель управління при нормальному навантаженні |< 200мс |Високий
+|PERF-2 |Система обробляє 1000 одночасних користувачів |Без деградації |Середній
+|===
+
+=== Сценарії безпеки
+
+[options="header",cols="1,2,1,1"]
+|===
+|ID |Сценарій |Очікувана поведінка |Пріоритет
+|SEC-1 |Невдала спроба входу |Блокування облікового запису після 5 спроб |Високий
+|SEC-2 |Неавторизований доступ до API |401 відповідь, журнал аудиту |Високий
+|===
+
+=== Сценарії підтримуваності
+
+[options="header",cols="1,2,1,1"]
+|===
+|ID |Сценарій |Очікуваний час |Пріоритет
+|MAINT-1 |Додати новий тип сутності |< 2 днів розробки |Середній
+|MAINT-2 |Оновити версію залежності |< 4 годин включаючи тести |Середній
+|===
+
+.Додаткова інформація
+Див. link:https://docs.arc42.org/section-10/[Вимоги до якості] в документації arc42.
+`;
+}
+function getTechnicalRisksTemplate() {
+    return `= 11. Ризики та технічні борги
+
+*Мета*: Виявлення та відстеження відомих технічних ризиків та накопиченого технічного боргу.
+
+== Технічні ризики
+
+[options="header",cols="1,2,1,2"]
+|===
+|Ризик |Опис |Ймовірність |Заходи зменшення
+|[напр., Збій API третьої сторони] |[Зовнішній сервіс, від якого ми залежимо] |Середня |[Circuit breaker, резервний варіант]
+|[напр., Втрата даних] |[Пошкодження бази даних] |Низька |[Резервні копії, реплікація]
+|===
+
+== Технічний борг
+
+[options="header",cols="1,2,1,1"]
+|===
+|Елемент |Опис |Вплив |Пріоритет
+|[напр., Застаріла автентифікація] |[Стара система автентифікації потребує заміни] |Високий |Середній
+|[напр., Відсутні тести] |[Покриття нижче цільового в модулі X] |Середній |Низький
+|===
+
+== Моніторинг ризиків
+
+[Опишіть, як відстежуються та переглядаються ризики]
+
+* [напр., Щотижневі зустрічі з огляду ризиків]
+* [напр., Автоматизовані сповіщення моніторингу]
+
+.Додаткова інформація
+Див. link:https://docs.arc42.org/section-11/[Ризики та технічний борг] в документації arc42.
+`;
+}
+function getGlossaryTemplate() {
+    return `= 12. Глосарій
+
+*Мета*: Визначте важливі доменні та технічні терміни, що використовуються в архітектурній документації.
+
+== Доменні терміни
+
+[options="header",cols="1,3"]
+|===
+|Термін |Визначення
+|[Доменний термін 1] |[Чітке, стисле визначення]
+|[Доменний термін 2] |[Чітке, стисле визначення]
+|===
+
+== Технічні терміни
+
+[options="header",cols="1,3"]
+|===
+|Термін |Визначення
+|[Технічний термін 1] |[Чітке, стисле визначення]
+|[Технічний термін 2] |[Чітке, стисле визначення]
+|===
+
+== Абревіатури
+
+[options="header",cols="1,3"]
+|===
+|Абревіатура |Значення
+|API |Application Programming Interface (Інтерфейс програмування додатків)
+|JWT |JSON Web Token (JSON веб-токен)
+|REST |Representational State Transfer (Передача репрезентативного стану)
+|===
+
+.Додаткова інформація
+Див. link:https://docs.arc42.org/section-12/[Глосарій] в документації arc42.
+`;
+}
+/**
+ * Get the Ukrainian workflow guide in AsciiDoc format
+ */
+export function getWorkflowGuide() {
+    return `= Керівництво з документування архітектури arc42
+
+== Огляд
+
+Це керівництво допоможе вам документувати архітектуру програмного забезпечення за допомогою шаблону arc42. Шаблон arc42 - це практичний, перевірений шаблон для документування архітектури програмного забезпечення та систем.
+
+== Доступні мови
+
+Цей arc42 MCP сервер підтримує багато мов для документації:
+
+[options="header",cols="1,2,2"]
+|===
+|Код |Мова |Рідна назва
+|EN |Англійська |English
+|DE |Німецька |Deutsch
+|CZ |Чеська |Cestina
+|ES |Іспанська |Espanol
+|FR |Французька |Francais
+|IT |Італійська |Italiano
+|NL |Нідерландська |Nederlands
+|PT |Португальська |Portugues
+|RU |Російська |Русский
+|UKR |Українська |Українська
+|ZH |Китайська |中文
+|===
+
+== Початок роботи
+
+=== Крок 1: Ініціалізація робочого простору
+
+Використовуйте інструмент \`arc42-init\` для створення робочого простору документації:
+
+[source]
+----
+arc42-init(projectName: "Мій Проект", language: "UKR")
+----
+
+Ви можете вказати іншу мову за допомогою коду мови ISO.
+
+=== Крок 2: Перевірка статусу
+
+Використовуйте \`arc42-status\` для перегляду поточного стану документації:
+
+[source]
+----
+arc42-status()
+----
+
+=== Крок 3: Генерація шаблонів розділів
+
+Використовуйте \`generate-template\` для отримання детальних шаблонів для кожного розділу:
+
+[source]
+----
+generate-template(section: "01_introduction_and_goals", language: "UKR")
+----
+
+== 12 розділів arc42
+
+. *Вступ і цілі* - Почніть тут! Визначте, що ви будуєте і чому.
+. *Архітектурні обмеження* - Що вам НЕ дозволено робити?
+. *Область дії та контекст* - Що входить, а що ні?
+. *Стратегія рішення* - Високорівневий підхід до вирішення проблеми.
+. *Представлення будівельних блоків* - Статична структура вашої системи.
+. *Рантайм представлення* - Динамічна поведінка та сценарії.
+. *Представлення розгортання* - Як система розгортається та експлуатується?
+. *Наскрізні концепції* - Патерни, що використовуються в системі.
+. *Архітектурні рішення* - Важливі рішення та їх обґрунтування.
+. *Вимоги до якості* - Конкретні сценарії якості.
+. *Ризики та технічний борг* - Що може піти не так?
+. *Глосарій* - Визначте ваші терміни.
+
+== Найкращі практики
+
+. *Почніть з розділу 1* - Розуміння цілей є фундаментальним
+. *Будьте лаконічними* - arc42 прагматичний, не бюрократичний
+. *Використовуйте діаграми* - Картинка вартує тисячі слів
+. *Документуйте рішення* - Майбутній ви подякує теперішньому
+. *Ітеруйте* - Документація архітектури ніколи не "завершена"
+
+== Доступні інструменти
+
+* \`arc42-init\` - Ініціалізація робочого простору документації
+* \`arc42-status\` - Перевірка статусу документації
+* \`generate-template\` - Генерація шаблонів розділів
+* \`update-section\` - Оновлення вмісту розділу
+* \`get-section\` - Читання вмісту розділу
+* \`arc42-workflow-guide\` - Показати це керівництво
+
+== Ресурси
+
+* link:https://arc42.org/[Веб-сайт arc42]
+* link:https://docs.arc42.org/[Документація arc42]
+* link:https://arc42.org/examples[Приклади arc42]
+`;
+}
+/**
+ * Get the Ukrainian README content in AsciiDoc format
+ */
+export function getReadmeContent(projectName) {
+    const name = projectName || 'Проект';
+    return `= ${name} - Архітектурна документація
+
+Цей каталог містить архітектурну документацію для ${name}, що відповідає шаблону arc42.
+
+== Структура
+
+* \`sections/\` - Окремі файли розділів AsciiDoc (12 розділів)
+* \`images/\` - Діаграми та зображення
+* \`arc42-documentation.adoc\` - Головна об'єднана документація
+* \`config.yaml\` - Конфігурація
+
+== 12 розділів arc42
+
+. *Вступ і цілі* - Вимоги, цілі якості, зацікавлені сторони
+. *Архітектурні обмеження* - Технічні та організаційні обмеження
+. *Область дії та контекст* - Бізнес та технічний контекст
+. *Стратегія рішення* - Фундаментальні рішення та стратегії
+. *Представлення будівельних блоків* - Статична декомпозиція
+. *Рантайм представлення* - Динамічна поведінка
+. *Представлення розгортання* - Інфраструктура та розгортання
+. *Наскрізні концепції* - Загальні правила та підходи
+. *Архітектурні рішення* - Важливі рішення (ADR)
+. *Вимоги до якості* - Дерево якості та сценарії
+. *Ризики та технічний борг* - Відомі проблеми та ризики
+. *Глосарій* - Важливі терміни
+
+== Початок роботи
+
+. Почніть з розділу 1: Вступ і цілі
+. Працюйте над розділами ітеративно
+. Використовуйте діаграми для ілюстрації концепцій
+. Зосередьтеся на рішеннях, а не на деталях реалізації
+
+== Генерація документації
+
+Використовуйте інструменти MCP для:
+
+* Перевірки статусу: \`arc42-status\`
+* Генерації шаблонів: \`generate-template\`
+* Оновлення розділів: \`update-section\`
+
+== Ресурси
+
+* link:https://arc42.org/[Веб-сайт arc42]
+* link:https://docs.arc42.org/[Документація arc42]
+* link:https://arc42.org/examples[Приклади arc42]
+`;
+}
+//# sourceMappingURL=templates-asciidoc.js.map