speccrew 0.7.44 → 0.7.46

package/README.uk.md

@@ -1,306 +0,0 @@
-# SpecCrew - AI-орієнтований фреймворк програмної інженерії
-
-<p align="center">
-  <a href="./README.md">简体中文</a> |
-  <a href="./README.zh-TW.md">繁體中文</a> |
-  <a href="./README.en.md">English</a> |
-  <a href="./README.ko.md">한국어</a> |
-  <a href="./README.de.md">Deutsch</a> |
-  <a href="./README.es.md">Español</a> |
-  <a href="./README.fr.md">Français</a> |
-  <a href="./README.it.md">Italiano</a> |
-  <a href="./README.da.md">Dansk</a> |
-  <a href="./README.ja.md">日本語</a> |
-  <a href="./README.pl.md">Polski</a> |
-  <a href="./README.ru.md">Русский</a> |
-  <a href="./README.bs.md">Bosanski</a> |
-  <a href="./README.ar.md">العربية</a> |
-  <a href="./README.no.md">Norsk</a> |
-  <a href="./README.pt-BR.md">Português (Brasil)</a> |
-  <a href="./README.th.md">ไทย</a> |
-  <a href="./README.tr.md">Türkçe</a> |
-  <a href="./README.uk.md">Українська</a> |
-  <a href="./README.bn.md">বাংলা</a> |
-  <a href="./README.el.md">Ελληνικά</a> |
-  <a href="./README.vi.md">Tiếng Việt</a>
-</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/v/speccrew.svg" alt="npm version"></a>
-  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/dm/speccrew.svg" alt="npm downloads"></a>
-  <a href="https://github.com/charlesmu99/speccrew/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/speccrew.svg" alt="license"></a>
-</p>
-
-> Віртуальна команда розробки на базі ШІ, що забезпечує швидку інженерну реалізацію для будь-якого програмного проекту
-
-## Що таке SpecCrew?
-
-SpecCrew — це вбудований фреймворк віртуальної команди розробки на базі ШІ. Він перетворює професійні робочі процеси програмної інженерії (PRD → Feature Design → System Design → Dev → Test) у багаторазові робочі процеси Агентів, допомагаючи командам розробників досягти Specification-Driven Development (SDD), особливо підходить для існуючих проектів.
-
-Інтегруючи Агентів та Навички в існуючі проекти, команди можуть швидко ініціалізувати системи документації проекту та віртуальні програмні команди, реалізуючи нові функції та модифікації відповідно до стандартних інженерних робочих процесів.
-
----
-
-## ✨ Ключові особливості
-
-### 🏭 Віртуальна команда розробки
-Генерація одним кліком **7 професійних ролей Агентів** + **30+ робочих процесів Навичок**, створення повної віртуальної команди розробки:
-- **Team Leader** - Глобальне планування та управління ітераціями
-- **Product Manager** - Аналіз вимог та генерація PRD
-- **Feature Designer** - Проектування функцій + API-контракти
-- **System Designer** - Проектування систем Frontend/Backend/Mobile/Desktop
-- **System Developer** - Багатоплатформна паралельна розробка
-- **Test Manager** - Координація тестування в три етапи
-- **Task Worker** - Паралельне виконання підзадач
-
-### 📐 Моделювання ISA-95 в шість етапів
-Базовано на міжнародній методології моделювання **ISA-95**, стандартизація перетворення бізнес-вимог в програмні системи:
-```
-Domain Descriptions → Functions in Domains → Functions of Interest
-     ↓                       ↓                      ↓
-Information Flows → Categories of Information → Information Descriptions
-```
-- Кожен етап відповідає певним UML-діаграмам (use case, sequence, class diagrams)
-- Бізнес-вимоги "уточнюються поетапно", без втрати інформації
-- Результати безпосередньо придатні для розробки
-
-### 📚 Система бази знань
-Трирівнева архітектура бази знань, що гарантує, що ШІ завжди працює на основі "єдиного джерела істини":
-
-| Рівень | Каталог | Вміст | Призначення |
-|--------|---------|-------|-------------|
-| L1 Системні знання | `knowledge/techs/` | Технологічний стек, архітектура, угоди | ШІ розуміє технічні межі проекту |
-| L2 Бізнес-знання | `knowledge/bizs/` | Функції модулів, бізнес-процеси, сутності | ШІ розуміє бізнес-логіку |
-| L3 Артефакти ітерацій | `iterations/iXXX/` | PRD, проектні документи, звіти про тестування | Повний ланцюжок відстеження для поточних вимог |
-
-### 🔄 Чотириетапний конвеєр знань
-**Автоматизована архітектура генерації знань**, автоматична генерація бізнес/технічної документації з вихідного коду:
-```
-Етап 1: Сканування вихідного коду → Генерація списку модулів
-Етап 2: Паралельний аналіз → Вилучення функцій (багато Worker паралельно)
-Етап 3: Паралельне узагальнення → Завершення оглядів модулів (багато Worker паралельно)
-Етап 4: Системна агрегація → Генерація панорами системи
-```
-- Підтримує **повну синхронізацію** та **інкрементальну синхронізацію** (на основі Git diff)
-- Один оптимізує, команда використовує
-
-### 🔧 Harness Практична структура впровадження
-**Стандартизована структура виконання**, що забезпечує точне перетворення проектних документів у виконувані інструкції з розробки:
-- **Принцип операційного посібника**: Навичка — це SOP, кроки чіткі, послідовні та самодостатні
-- **Контракт введення-виведення**: Чітке визначення інтерфейсів, суворе виконання як pseudocode
-- **Архітектура прогресивного розкриття**: Шаруватезавантаження інформації, уникнення одноразового перевантаження контексту
-- **Делегування суб-Агентів**: Автоматичний поділ складних завдань, паралельне виконання гарантує якість
-
----
-
-## Вирішення 8 ключових проблем
-
-### 1. ШІ ігнорує існуючу документацію проекту (розрив знань)
-**Проблема**: Існуючі методи SDD або Vibe Coding покладаються на те, що ШІ резюмує проекти в реальному часі, легко пропускаючи критичний контекст і призводячи до результатів розробки, що відхиляються від очікувань.
-
-**Рішення**: Репозиторій `knowledge/` служить "єдиним джерелом істини" проекту, накопичуючи архітектурний дизайн, функціональні модулі та бізнес-процеси, забезпечуючи відповідність вимог джерелу.
-
-### 2. Пряма технічна документація з PRD (пропуск змісту)
-**Проблема**: Прямий перехід від PRD до детального проектування легко пропускає деталі вимог, призводячи до того, що реалізовані функції відхиляються від вимог.
-
-**Рішення**: Впровадження фази **Документа Feature Design**, що фокусується лише на скелеті вимог без технічних деталей:
-- Які сторінки та компоненти включені?
-- Потоки операцій сторінок
-- Логіка обробки бекенду
-- Структура зберігання даних
-
-Розробка повинна лише "наростити м'ясо" на основі конкретного технічного стеку, забезпечуючи зростання функцій "близько до кісток (вимог)".
-
-### 3. Невизначена область пошуку Агента (невизначеність)
-**Проблема**: У складних проектах широкий пошук коду та документів ШІ дає невизначені результати, що ускладнює гарантування узгодженості.
-
-**Рішення**: Чіткі структури каталогів документів та шаблони, розроблені на основі потреб кожного Агента, реалізують **прогресивне розкриття та завантаження за запитом** для забезпечення детермінізму.
-
-### 4. Пропущені етапи та завдання (розрив процесу)
-**Проблема**: Відсутність повного охоплення інженерного процесу легко пропускає критичні кроки, що ускладнює гарантування якості.
-
-**Рішення**: Охоплення повного життєвого циклу програмної інженерії:
-```
-PRD (Вимоги) → Feature Design (Проектування функцій) → API Contract (Контракт)
-    → System Design (Системне проектування) → Dev (Розробка) → Test (Тестування)
-```
-- Вихід кожної фази є входом наступної фази
-- Кожен крок потребує людського підтвердження перед продовженням
-- Всі виконання Агентів мають списки todo з самоперевіркою після завершення
-
-### 5. Низька ефективність командної співпраці (інформаційні силоси)
-**Проблема**: Досвід програмування з ШІ важко розділяти між командами, що призводить до повторних помилок.
-
-**Рішення**: Всі Агенти, Навички та пов'язані документи версіонуються з вихідним кодом:
-- Оптимізація однієї людини розділяється командою
-- Знання накопичуються в кодовій базі
-- Підвищується ефективність командної співпраці
-
-### 7. Занадто довгий контекст одного Агента (вузьке місце продуктивності)
-**Проблема**: Великі складні завдання перевищують контекстні вікна одного Агента, викликаючи відхилення в розумінні та зниження якості виходу.
-
-**Рішення**: **Механізм автодиспетчеризації суб-Агентів**:
-- Складні завдання автоматично ідентифікуються та розділяються на підзавдання
-- Кожне підзавдання виконується незалежним суб-Агентом з ізольованим контекстом
-- Батьківський Агент координує та агрегує для забезпечення загальної узгодженості
-- Уникає розширення контексту одного Агента, забезпечуючи якість виходу
-
-### 8. Хаос ітерації вимог (труднощі управління)
-**Проблема**: Кілька вимог, змішаних в одній гілці, впливають одна на одну, що ускладнює відстеження та відкат.
-
-**Рішення**: **Кожна вимога як незалежний проект**:
-- Кожна вимога створює незалежний каталог ітерації `iterations/iXXX-[ім'я-вимоги]/`
-- Повна ізоляція: документи, дизайн, код та тести керуються незалежно
-- Швидка ітерація: доставка малої гранулярності, швидка верифікація, швидке розгортання
-- Гнучке архівування: після завершення, архівування в `archive/` з чіткою історичною відстежуваністю
-
-### 6. Затримка оновлення документів (старіння знань)
-**Проблема**: Документи застарівають по мірі розвитку проектів, змушуючи ШІ працювати з невірною інформацією.
-
-**Рішення**: Агенти мають можливості автоматичного оновлення документів, синхронізуючи зміни проекту в реальному часі для підтримки точності бази знань.
-
----
-
-## Основний робочий процес
-
-```mermaid
-graph LR
-    A[PRD<br/>Документ вимог] --> B[Feature Design<br/>Проектування функцій]
-    B --> C[API Contract<br/>Контракт інтерфейсу]
-    C --> D[System Design<br/>Системне проектування]
-    D --> E[Dev<br/>Реалізація]
-    E --> F[System Test<br/>Тестування]
-    F --> G[Archive<br/>Архівування]
-    
-    H[Knowledge<br/>Репозиторій] -.-> A
-    H -.-> B
-    H -.-> D
-    H -.-> E
-    
-    E -.-> H
-    F -.-> H
-```
-
-### Опис фаз
-
-| Фаза | Агент | Вхід | Вихід | Людське підтвердження |
-|------|-------|------|-------|----------------------|
-| PRD | PM | Користувацькі вимоги | Документ вимог продукту | ✅ Обов'язково |
-| Feature Design | Feature Designer | PRD | Документ Feature Design + API контракт | ✅ Обов'язково |
-| System Design | System Designer | Feature Spec | Документи проектування Frontend/Backend | ✅ Обов'язково |
-| Dev | Dev | Design | Код + Записи завдань | ✅ Обов'язково |
-| System Test | Test Manager | Вихід Dev + Feature Spec | Тест-кейси + Тестовий код + Тестовий звіт + Звіт багів | ✅ Обов'язково |
-
----
-
-## Порівняння з існуючими рішеннями
-
-| Вимір | Vibe Coding | Ralph Loop | **SpecCrew** |
-|-------|-------------|------------|-------------|
-| Залежність від документів | Ігнорує існуючі документи | Покладається на AGENTS.md | **Структурована база знань** |
-| Передача вимог | Пряме кодування | PRD → Код | **PRD → Feature Design → System Design → Код** |
-| Людська участь | Мінімальна | При запуску | **На кожній фазі** |
-| Повнота процесу | Слабка | Середня | **Повний інженерний робочий процес** |
-| Командна співпраця | Важко ділитися | Особиста ефективність | **Розділення знань команди** |
-| Управління контекстом | Один екземпляр | Цикл одного екземпляра | **Автодиспетчеризація суб-Агентів** |
-| Управління ітерацією | Змішане | Список завдань | **Вимога як проект, незалежна ітерація** |
-| Детермінізм | Низький | Середній | **Високий (прогресивне розкриття)** |
-
----
-
-## Швидкий старт
-
-### Передумови
-
-- Node.js >= 16.0.0
-- Підтримувані IDE: Qoder (за замовчуванням), Cursor, Claude Code
-
-> **Примітка**: Адаптери для Cursor та Claude Code не тестувалися в реальних середовищах IDE (реалізовані на рівні коду та верифіковані через E2E тести, але ще не протестовані в реальних Cursor/Claude Code).
-
-### 1. Встановити SpecCrew
-
-```bash
-npm install -g speccrew
-```
-
-### 2. Ініціалізувати проект
-
-Перейдіть до кореневого каталогу проекту та виконайте команду ініціалізації:
-
-```bash
-cd /path/to/your-project
-
-# За замовчуванням використовує Qoder
-speccrew init
-
-# Або вкажіть IDE
-speccrew init --ide qoder
-speccrew init --ide cursor
-speccrew init --ide claude
-```
-
-Після ініціалізації в проекті будуть створені:
-- `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 визначень ролей Агентів
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ робочих процесів Навичок
-- `speccrew-workspace/` — Робочий простір (каталоги ітерацій, база знань, шаблони документів)
-- `.speccrewrc` — Файл конфігурації SpecCrew
-
-Щоб пізніше оновити Агентів та Навички для конкретного IDE:
-
-```bash
-speccrew update --ide cursor
-speccrew update --ide claude
-```
-
-### 3. Почати робочий процес розробки
-
-Дотримуйтесь стандартного інженерного робочого процесу крок за кроком:
-
-1. **PRD**: Агент Product Manager аналізує вимоги та генерує документ вимог продукту
-2. **Feature Design**: Агент Feature Designer генерує документ feature design + API контракт
-3. **System Design**: Агент System Designer генерує документи system design за платформами (frontend/backend/mobile/desktop)
-4. **Dev**: Агент System Developer реалізує розробку за платформами паралельно
-5. **System Test**: Агент Test Manager координує трифазне тестування (дизайн кейсів → генерація коду → звіт виконання)
-6. **Archive**: Архівувати ітерацію
-
-> Результати кожної фази потребують людського підтвердження перед переходом до наступної фази.
-
-### 4. Оновити SpecCrew
-
-Коли виходить нова версія SpecCrew, виконайте оновлення у два кроки:
-
-```bash
-# Step 1: Update the global CLI tool to the latest version
-npm install -g speccrew@latest
-
-# Step 2: Sync Agents and Skills in your project to the latest version
-cd /path/to/your-project
-speccrew update
-```
-
-> **Примітка**: `npm install -g speccrew@latest` оновлює сам інструмент CLI, а `speccrew update` оновлює файли визначень Агентів та Навичок у вашому проекті. Для повного оновлення необхідні обидва кроки.
-
-### 5. Інші CLI команди
-
-```bash
-speccrew list       # Список встановлених агентів та навичок
-speccrew doctor     # Діагностика середовища та статусу встановлення
-speccrew update     # Оновлення агентів та навичок до останньої версії
-speccrew uninstall  # Видалити SpecCrew (--all також видаляє робочий простір)
-```
-
-📖 **Детальний посібник**: Після встановлення ознайомтесь з [Посібником початку роботи](docs/GETTING-STARTED.uk.md) для повного робочого процесу та посібника діалогів агентів.
-
----
-
-## Більше інформації
-
-- **Карта знань Агентів**: [speccrew-workspace/docs/agent-knowledge-map.md](./speccrew-workspace/docs/agent-knowledge-map.md)
-- **npm**: https://www.npmjs.com/package/speccrew
-- **GitHub**: https://github.com/charlesmu99/speccrew
-- **Gitee**: https://gitee.com/amutek/speccrew
-- **Qoder IDE**: https://qoder.com/
-
----
-
-> **SpecCrew не має на меті замінити розробників, а автоматизувати нудні частини, щоб команди могли зосередитися на більш цінній роботі.**

package/README.vi.md

@@ -1,174 +0,0 @@
-# SpecCrew - Khung Kỹ thuật Phần mềm Điều khiển bởi AI
-
-<p align="center">
-  <a href="./README.md">简体中文</a> |
-  <a href="./README.zh-TW.md">繁體中文</a> |
-  <a href="./README.en.md">English</a> |
-  <a href="./README.ko.md">한국어</a> |
-  <a href="./README.de.md">Deutsch</a> |
-  <a href="./README.es.md">Español</a> |
-  <a href="./README.fr.md">Français</a> |
-  <a href="./README.it.md">Italiano</a> |
-  <a href="./README.da.md">Dansk</a> |
-  <a href="./README.ja.md">日本語</a> |
-  <a href="./README.pl.md">Polski</a> |
-  <a href="./README.ru.md">Русский</a> |
-  <a href="./README.bs.md">Bosanski</a> |
-  <a href="./README.ar.md">العربية</a> |
-  <a href="./README.no.md">Norsk</a> |
-  <a href="./README.pt-BR.md">Português (Brasil)</a> |
-  <a href="./README.th.md">ไทย</a> |
-  <a href="./README.tr.md">Türkçe</a> |
-  <a href="./README.uk.md">Українська</a> |
-  <a href="./README.bn.md">বাংলা</a> |
-  <a href="./README.el.md">Ελληνικά</a> |
-  <a href="./README.vi.md">Tiếng Việt</a>
-</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/v/speccrew.svg" alt="npm version"></a>
-  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/dm/speccrew.svg" alt="npm downloads"></a>
-  <a href="https://github.com/charlesmu99/speccrew/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/speccrew.svg" alt="license"></a>
-</p>
-
-> Một đội phát triển AI ảo cho phép triển khai kỹ thuật nhanh chóng cho bất kỳ dự án phần mềm nào
-
-## SpecCrew là gì?
-
-SpecCrew là một khung đội phát triển AI ảo được nhúng. Nó chuyển đổi các quy trình kỹ thuật phần mềm chuyên nghiệp (PRD → Feature Design → System Design → Dev → Test) thành các quy trình Agent có thể tái sử dụng, giúp các đội phát triển đạt được Specification-Driven Development (SDD), đặc biệt phù hợp cho các dự án hiện có.
-
-Bằng cách tích hợp các Agent và Skill vào các dự án hiện có, các đội có thể nhanh chóng khởi tạo hệ thống tài liệu dự án và đội phần mềm ảo, triển khai các tính năng mới và sửa đổi theo các quy trình kỹ thuật tiêu chuẩn từng bước.
-
----
-
-## ✨ Điểm Nổi Bật Chính
-
-### 🏭 Đội Phần Mềm Ảo
-Tạo bằng một cú nhấp chuột **7 vai trò Agent chuyên nghiệp** + **30+ quy trình Skill**, xây dựng đội phần mềm ảo hoàn chỉnh:
-- **Team Leader** - Lập kế hoạch toàn cầu và quản lý lặp lại
-- **Product Manager** - Phân tích yêu cầu và xuất PRD
-- **Feature Designer** - Thiết kế tính năng + hợp đồng API
-- **System Designer** - Thiết kế hệ thống Frontend/Backend/Mobile/Desktop
-- **System Developer** - Phát triển song song đa nền tảng
-- **Test Manager** - Điều phối kiểm thử ba giai đoạn
-- **Task Worker** - Thực thi tác vụ phụ song song
-
-### 📐 Mô hình hóa ISA-95 Sáu Giai đoạn
-Dựa trên phương pháp luận mô hình hóa quốc tế **ISA-95**, chuẩn hóa chuyển đổi yêu cầu nghiệp vụ thành hệ thống phần mềm:
-```
-Domain Descriptions → Functions in Domains → Functions of Interest
-     ↓                       ↓                      ↓
-Information Flows → Categories of Information → Information Descriptions
-```
-- Mỗi giai đoạn tương ứng với biểu đồ UML cụ thể (use case, sequence, class)
-- Yêu cầu nghiệp vụ được "tinh chế từng bước", không mất thông tin
-- Đầu ra có thể sử dụng trực tiếp cho phát triển
-
-### 📚 Hệ thống Cơ sở Kiến thức
-Kiến trúc cơ sở kiến thức ba tầng đảm bảo AI luôn làm việc dựa trên "nguồn sự thật duy nhất":
-
-| Tầng | Thư mục | Nội dung | Mục đích |
-|------|---------|----------|----------|
-| L1 Kiến thức Hệ thống | `knowledge/techs/` | Stack công nghệ, kiến trúc, quy ước | AI hiểu ranh giới kỹ thuật của dự án |
-| L2 Kiến thức Nghiệp vụ | `knowledge/bizs/` | Chức năng module, luồng nghiệp vụ, thực thể | AI hiểu logic nghiệp vụ |
-| L3 Tạo phẩm Lặp | `iterations/iXXX/` | PRD, tài liệu thiết kế, báo cáo kiểm thử | Chuỗi truy xuất đầy đủ cho yêu cầu hiện tại |
-
-### 🔄 Pipeline Kiến thức Bốn Giai đoạn
-**Kiến trúc tạo kiến thức tự động**, tự động tạo tài liệu nghiệp vụ/kỹ thuật từ mã nguồn:
-```
-Giai đoạn 1: Quét mã nguồn → Tạo danh sách module
-Giai đoạn 2: Phân tích song song → Trích xuất tính năng (nhiều Worker song song)
-Giai đoạn 3: Tóm tắt song song → Hoàn thành tổng quan module (nhiều Worker song song)
-Giai đoạn 4: Tổng hợp hệ thống → Tạo toàn cảnh hệ thống
-```
-- Hỗ trợ **đồng bộ hóa đầy đủ** và **đồng bộ hóa tăng dần** (dựa trên Git diff)
-- Một người tối ưu hóa, cả đội chia sẻ
-
-### 🔧 Harness Khung Thực chiến Triển khai
-**Khung thực thi chuẩn hóa**, đảm bảo tài liệu thiết kế được chuyển đổi chính xác thành các chỉ lệnh phát triển có thể thực thi:
-- **Nguyên tắc sổ tay vận hành**: Skill là SOP, các bước rõ ràng, liên tục và tự chứa
-- **Hợp đồng đầu vào-đầu ra**: Định nghĩa rõ ràng các giao diện, thực thi nghiêm ngặt như pseudocode
-- **Kiến trúc tiết lộ dần dần**: Tải thông tin theo lớp, tránh quá tải ngữ cảnh một lần
-- **Ủy quyền Sub-Agent**: Tự động chia nhỏ tác vụ phức tạp, thực thi song song đảm bảo chất lượng
-
----
-
-## Giải quyết 8 Vấn đề Cốt lõi
-
-### 1. AI Bỏ qua Tài liệu Dự án Hiện có (Khoảng trống Kiến thức)
-**Vấn đề**: Các phương pháp SDD hoặc Vibe Coding hiện có phụ thuộc vào AI tóm tắt các dự án theo thời gian thực, dễ dàng bỏ lỡ bối cảnh quan trọng và gây ra kết quả phát triển lệch khỏi kỳ vọng.
-
-**Giải pháp**: Kho lưu trữ `knowledge/` đóng vai trò là "nguồn sự thật duy nhất" của dự án, tích lũy thiết kế kiến trúc, các mô-đun chức năng và quy trình kinh doanh để đảm bảo các yêu cầu vẫn đúng hướng từ nguồn.
-
-### 2. Tài liệu Kỹ thuật Trực tiếp từ PRD (Bỏ sót Nội dung)
-**Vấn đề**: Nhảy trực tiếp từ PRD đến thiết kế chi tiết dễ dàng bỏ sót các chi tiết yêu cầu, khiến các tính năng được triển khai lệch khỏi yêu cầu.
-
-**Giải pháp**: Giới thiệu giai đoạn **Tài liệu Feature Design**, chỉ tập trung vào khung yêu cầu mà không có chi tiết kỹ thuật:
-- Bao gồm những trang và thành phần nào?
-- Các luồng thao tác trang
-- Logic xử lý backend
-- Cấu trúc lưu trữ dữ liệu
-
-Phát triển chỉ cần "điền nội dung" dựa trên ngăn xếp công nghệ cụ thể, đảm bảo các tính năng phát triển "gần xương (yêu cầu)".
-
-### 3. Phạm vi Tìm kiếm Agent Không chắc chắn (Sự không chắc chắn)
-**Vấn đề**: Trong các dự án phức tạp, tìm kiếm rộng mã và tài liệu bởi AI mang lại kết quả không chắc chắn, làm cho tính nhất quán khó đảm bảo.
-
-**Giải pháp**: Các cấu trúc thư mục tài liệu rõ ràng và các mẫu, được thiết kế dựa trên nhu cầu của từng Agent, triển khai **tiết lộ dần dần và tải theo yêu cầu** để đảm bảo sự tất định.
-
-### 4. Thiếu Các Bước và Nhiệm vụ (Đứt gãy Quy trình)
-**Vấn đề**: Thiếu bao phủ đầy đủ quy trình kỹ thuật dễ dàng bỏ sót các bước quan trọng, làm cho chất lượng khó đảm bảo.
-
-**Giải pháp**: Bao phủ toàn bộ vòng đời kỹ thuật phần mềm:
-```
-PRD (Yêu cầu) → Feature Design (Thiết kế Tính năng) → API Contract (Hợp đồng)
-    → System Design (Thiết kế Hệ thống) → Dev (Phát triển) → Test (Kiểm thử)
-```
-- Đầu ra của mỗi giai đoạn là đầu vào của giai đoạn tiếp theo
-- Mỗi bước yêu cầu xác nhận của con người trước khi tiếp tục
-- Tất cả các thực thi Agent có danh sách todo với tự kiểm tra sau khi hoàn thành
-
-### 5. Hiệu quả Hợp tác Đội thấp (Các hầm chứa Kiến thức)
-**Vấn đề**: Kinh nghiệm lập trình AI khó chia sẻ giữa các đội, dẫn đến các lỗi lặp lại.
-
-**Giải pháp**: Tất cả các Agent, Skill và tài liệu liên quan được kiểm soát phiên bản với mã nguồn:
-- Tối ưu hóa của một người được chia sẻ bởi đội
-- Kiến thức được tích lũy trong cơ sở mã
-- Cải thiện hiệu quả hợp tác đội
-
-### 7. Ngữ cảnh Đơn Agent Quá dài (Điểm nghẽn Hiệu suất)
-**Vấn đề**: Các nhiệm vụ phức tạp lớn vượt qua cửa sổ ngữ cảnh đơn Agent, gây ra sự lệch lạc trong hiểu biết và giảm chất lượng đầu ra.
-
-**Giải pháp**: **Cơ chế Tự động Điều phối Sub-Agent**:
-- Các nhiệm vụ phức tạp được tự động nhận diện và chia thành các nhiệm vụ con
-- Mỗi nhiệm vụ con được thực thi bởi một Sub-Agent độc lập với ngữ cảnh được cô lập
-- Agent cha điều phối và tổng hợp để đảm bảo tính nhất quán tổng thể
-- Tránh mở rộng ngữ cảnh đơn Agent, đảm bảo chất lượng đầu ra
-
-### 8. Sự hỗn loạn Lặp lại Yêu cầu (Khó khăn Quản lý)
-**Vấn đề**: Nhiều yêu cầu trộn lẫn trong cùng một nhánh ảnh hưởng lẫn nhau, làm cho việc theo dõi và quay lại trở nên khó khăn.
-
-**Giải pháp**: **Mỗi Yêu cầu như một Dự án Độc lập**:
-- Mỗi yêu cầu tạo một thư mục lặp lại độc lập `iterations/iXXX-[tên-yêu-cầu]/`
-- Cô lập hoàn toàn: tài liệu, thiết kế, mã và kiểm thử được quản lý độc lập
-- Lặp lại nhanh chóng: giao hàng độ hạt nhỏ, xác minh nhanh, triển khai nhanh
-- Lưu trữ linh hoạt: sau khi hoàn thành, lưu trữ trong `archive/` với khả năng truy xuất lịch sử rõ ràng
-
-### 6. Trì hoãn Cập nhật Tài liệu (Sự xuống cấp Kiến thức)
-**Vấn đề**: Tài liệu trở nên lỗi thời khi các dự án phát triển, khiến AI làm việc với thông tin sai.
-
-**Giải pháp**: Các Agent có khả năng cập nhật tài liệu tự động, đồng bộ hóa các thay đổi dự án theo thời gian thực để giữ cho cơ sở kiến thức chính xác.
-
----
-
-## Thông tin Bổ sung
-
-- **Bản đồ Kiến thức Agent**: [speccrew-workspace/docs/agent-knowledge-map.md](./speccrew-workspace/docs/agent-knowledge-map.md)
-- **npm**: https://www.npmjs.com/package/speccrew
-- **GitHub**: https://github.com/charlesmu99/speccrew
-- **Gitee**: https://gitee.com/amutek/speccrew
-- **Qoder IDE**: https://qoder.com/
-
----
-
-> **SpecCrew không nhằm mục đích thay thế các nhà phát triển, mà tự động hóa các phần nhàm chán để các đội có thể tập trung vào công việc có giá trị hơn.**