speccrew 0.1.0 → 0.1.2

package/README.ru.md

@@ -0,0 +1,321 @@
+# SpecCrew - Фреймворк программной инженерии на базе ИИ
+
+<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) в повторно используемые рабочие процессы Агентов, помогая командам разработчиков достичь разработки на основе спецификаций (SDD), особенно подходящей для существующих проектов.
+
+Интегрируя Агентов и Навыки в существующие проекты, команды могут быстро инициализировать системы документации проекта и виртуальные программные команды, реализуя новые функции и модификации в соответствии со стандартными инженерными рабочими процессами.
+
+---
+
+## Решение 8 ключевых проблем
+
+### 1. ИИ игнорирует существующую документацию проекта (разрыв знаний)
+**Проблема**: Существующие методы SDD или Vibe Coding полагаются на то, что ИИ резюмирует проекты в реальном времени, легко упуская критический контекст и приводя к результатам разработки, отклоняющимся от ожиданий.
+
+**Решение**: Репозиторий `knowledge/` служит "единственным источником истины" проекта, аккумулируя архитектурный дизайн, функциональные модули и бизнес-процессы, обеспечивая соответствие требований источнику.
+
+### 2. Прямое преобразование документации требований в техническую (пропуск содержания)
+**Проблема**: Прямой переход от PRD к детальному проектированию легко упускает детали требований, приводя к тому, что реализованные функции отклоняются от требований.
+
+**Решение**: Введение фазы **Документа Feature Design**, фокусирующейся только на каркасе требований без технических деталей:
+- Какие страницы и компоненты включены?
+- Потоки операций страниц
+- Логика обработки бэкенда
+- Структура хранения данных
+
+Разработке нужно только "нарастить мясо" на основе конкретного технического стека, обеспечивая рост функций "близко к кости (требованиям)".
+
+### 3. Неопределённый область поиска Агента (неопределённость)
+**Проблема**: В сложных проектах широкий поиск кода и документов ИИ даёт неопределённые результаты, что затрудняет гарантирование согласованности.
+
+**Решение**: Чёткие структуры каталогов документов и шаблоны, разработанные на основе потребностей каждого Агента, реализуют **прогрессивное раскрытие и загрузку по запросу** для обеспечения детерминизма.
+
+### 4. Пропущенные этапы и задачи (разрыв процесса)
+**Проблема**: Отсутствие полного покрытия инженерного процесса легко упускает критические шаги, что затрудняет гарантирование качества.
+
+**Решение**: Покрытие полного жизненного цикла программной инженерии:
+```
+PRD (Требования) → Feature Design (Проектирование функций) → API Contract (Контракт)
+    → System Design (Системное проектирование) → Dev (Разработка) → Test (Тестирование)
+```
+- Выход каждой фазы является входом следующей фазы
+- Каждый шаг требует человеческого подтверждения перед продолжением
+- Все выполнения Агентов имеют списки задач с самопроверкой после завершения
+
+### 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/` — 38 рабочих процессов Навыков
+- `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. Другие команды CLI
+
+```bash
+speccrew list       # Список установленных агентов и навыков
+speccrew doctor     # Диагностика среды и статуса установки
+speccrew update     # Обновление агентов и навыков до последней версии
+speccrew uninstall  # Удалить SpecCrew (--all также удаляет рабочее пространство)
+```
+
+📖 **Подробное руководство**: После установки ознакомьтесь с [Руководством по началу работы](docs/GETTING-STARTED.ru.md) для полного рабочего процесса и руководства по диалогам агентов.
+
+---
+
+## Структура каталога
+
+```
+your-project/
+├── .qoder/                          # Каталог конфигурации IDE (пример Qoder)
+│   ├── agents/                      # 7 Агентов ролей
+│   │   ├── speccrew-team-leader.md       # Лидер команды: Глобальное планирование и управление итерациями
+│   │   ├── speccrew-product-manager.md   # Продакт-менеджер: Анализ требований и PRD
+│   │   ├── speccrew-feature-designer.md  # Feature Designer: Feature Design + API контракт
+│   │   ├── speccrew-system-designer.md   # System Designer: Системный дизайн по платформам
+│   │   ├── speccrew-system-developer.md  # System Developer: Параллельная разработка по платформам
+│   │   ├── speccrew-test-manager.md      # Test Manager: Координация трёхфазного тестирования
+│   │   └── speccrew-task-worker.md       # Task Worker: Параллельное выполнение подзадач
+│   └── skills/                      # 38 Навыков (сгруппированных по функциям)
+│       ├── speccrew-pm-*/                # Управление продуктом (анализ требований, оценка)
+│       ├── speccrew-fd-*/                # Feature Design (Feature Design, API контракт)
+│       ├── speccrew-sd-*/                # System Design (frontend/backend/mobile/desktop)
+│       ├── speccrew-dev-*/               # Разработка (frontend/backend/mobile/desktop)
+│       ├── speccrew-test-*/              # Тестирование (дизайн кейсов/генерация кода/отчёт выполнения)
+│       ├── speccrew-knowledge-bizs-*/    # Бизнес-знания (анализ API/анализ UI/классификация модулей и т.д.)
+│       ├── speccrew-knowledge-techs-*/   # Технические знания (генерация tech стека/соглашения/индекс и т.д.)
+│       ├── speccrew-knowledge-graph-*/   # Граф знаний (чтение/запись/запрос)
+│       └── speccrew-*/                   # Утилиты (диагностика/временные метки/рабочий процесс и т.д.)
+│
+└── speccrew-workspace/              # Рабочее пространство (генерируется при инициализации)
+    ├── docs/                        # Управленческие документы
+    │   ├── configs/                 # Конфигурационные файлы (маппинг платформ, маппинг tech стека и т.д.)
+    │   ├── rules/                   # Конфигурации правил
+    │   └── solutions/               # Документы решений
+    │
+    ├── iterations/                  # Проекты итераций (генерируются динамически)
+    │   └── {номер}-{тип}-{имя}/
+    │       ├── 00.docs/             # Исходные требования
+    │       ├── 01.product-requirement/ # Требования продукта
+    │       ├── 02.feature-design/   # Feature design
+    │       ├── 03.system-design/    # System design
+    │       ├── 04.development/      # Фаза разработки
+    │       ├── 05.system-test/      # Системное тестирование
+    │       └── 06.delivery/         # Фаза поставки
+    │
+    ├── iteration-archives/          # Архивы итераций
+    │
+    └── knowledges/                  # База знаний
+        ├── base/                    # База/метаданные
+        │   ├── diagnosis-reports/   # Отчёты диагностики
+        │   ├── sync-state/          # Состояние синхронизации
+        │   └── tech-debts/          # Технический долг
+        ├── bizs/                    # Бизнес-знания
+        │   └── {platform-type}/{module-name}/
+        └── techs/                   # Технические знания
+            └── {platform-id}/
+```
+
+---
+
+## Основные принципы проектирования
+
+1. **Управление спецификациями**: Сначала пишите спецификации, затем позволяйте коду "расти" из них
+2. **Прогрессивное раскрытие**: Агенты начинают с минимальных точек входа, загружая информацию по запросу
+3. **Человеческое подтверждение**: Выход каждой фазы требует человеческого подтверждения для предотвращения отклонений ИИ
+4. **Изоляция контекста**: Большие задачи разделяются на малые, изолированные по контексту подзадачи
+5. **Сотрудничество суб-Агентов**: Сложные задачи автоматически диспетчеризируют суб-Агентов для избежания расширения контекста единственного Агента
+6. **Быстрая итерация**: Каждое требование как независимый проект для быстрой поставки и верификации
+7. **Разделение знаний**: Все конфигурации версионируются с исходным кодом
+
+---
+
+## Сценарии использования
+
+### ✅ Рекомендуется для
+- Средних и крупных проектов, требующих стандартизированных рабочих процессов
+- Командной разработки программного обеспечения
+- Инженерной трансформации наследованных проектов
+- Продуктов, требующих долгосрочной поддержки
+
+### ❌ Не подходит для
+- Персональной быстрой валидации прототипов
+- Исследовательских проектов с очень неопределёнными требованиями
+- Одноразовых скриптов или инструментов
+
+---
+
+## Дополнительная информация
+
+- **Карта знаний Агентов**: [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.th.md

@@ -0,0 +1,239 @@
+# 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>
+
+> ทีมพัฒนา AI เสมือนที่ช่วยให้การใช้งานวิศวกรรมอย่างรวดเร็วสำหรับโปรเจกต์ซอฟต์แวร์ใดๆ
+
+## SpecCrew คืออะไร?
+
+SpecCrew เป็นเฟรมเวิร์กทีมพัฒนา AI เสมือนแบบฝังตัว มันแปลงเวิร์กโฟลว์วิศวกรรมซอฟต์แวร์มืออาชีพ (PRD → Feature Design → System Design → Dev → Test) เป็นเวิร์กโฟลว์ Agent ที่นำกลับมาใช้ใหม่ได้ ช่วยให้ทีมพัฒนาบรรลุ Specification-Driven Development (SDD) โดยเฉพาะเหมาะสำหรับโปรเจกต์ที่มีอยู่แล้ว
+
+โดยการรวม Agent และ Skill เข้ากับโปรเจกต์ที่มีอยู่ ทีมสามารถเริ่มต้นระบบเอกสารโปรเจกต์และทีมซอฟต์แวร์เสมือนได้อย่างรวดเร็ว ดำเนินการเพิ่มและแก้ไขคุณสมบัติใหม่ตามเวิร์กโฟลว์วิศวกรรมมาตรฐาน
+
+---
+
+## แก้ปัญหาหลัก 8 ประการ
+
+### 1. AI เพิกเฉยต่อเอกสารโปรเจกต์ที่มีอยู่ (ช่องว่างความรู้)
+**ปัญหา**: เมธอด SDD หรือ Vibe Coding ที่มีอยู่พึ่งพา AI สรุปโปรเจกต์แบบเรียลไทม์ ซึ่งมักพลาดบริบทสำคัญ ทำให้ผลลัพธ์การพัฒนาเบี่ยงเบนจากความคาดหวัง
+
+**แนวทางแก้ไข**: รีโพสิทอรี `knowledge/` ทำหน้าที่เป็น "แหล่งความจริงเดียว" ของโปรเจกต์ สะสมการออกแบบสถาปัตยกรรม โมดูลฟังก์ชัน และกระบวนการทางธุรกิจ เพื่อให้มั่นใจว่าความต้องการยังคงอยู่ในแนวทางจากแหล่งที่มา
+
+### 2. เอกสารทางเทคนิคโดยตรงจาก PRD (การละเว้นเนื้อหา)
+**ปัญหา**: การข้ามจาก PRD ไปยังการออกแบบโดยละเอียดโดยตรงมักพลาดรายละเอียดความต้องการ ทำให้ฟังก์ชันที่ใช้งานเบี่ยงเบนจากความต้องการ
+
+**แนวทางแก้ไข**: แนะนำเฟส **เอกสาร Feature Design** โดยเน้นเฉพาะโครงสร้างความต้องการโดยไม่มีรายละเอียดทางเทคนิค:
+- มีหน้าและคอมโพเนนต์ใดบ้าง?
+- โฟลว์การดำเนินการของหน้า
+- ตรรกะการประมวลผลแบ็กเอนด์
+- โครงสร้างการจัดเก็บข้อมูล
+
+การพัฒนาเพียงแค่ต้อง "เติมเนื้อ" ตามเทคสแต็กเฉพาะ ทำให้มั่นใจว่าฟังก์ชันเติบโต "ใกล้กระดูก (ความต้องการ)"
+
+### 3. ขอบเขตการค้นหา Agent ไม่แน่นอน (ความไม่แน่นอน)
+**ปัญหา**: ในโปรเจกต์ที่ซับซ้อน การค้นหาโค้ดและเอกสารอย่างกว้างขวางโดย AI ให้ผลลัพธ์ที่ไม่แน่นอน ทำให้ความสอดคล้องรับประกันได้ยาก
+
+**แนวทางแก้ไข**: โครงสร้างไดเรกทอรีเอกสารและเทมเพลตที่ชัดเจน ออกแบบตามความต้องการของแต่ละ Agent ใช้ **การเปิดเผยแบบก้าวหน้าและการโหลดตามความต้องการ** เพื่อรับประกันดีเทอร์มินิซึม
+
+### 4. ขาดขั้นตอนและงาน (การขาดตอนของกระบวนการ)
+**ปัญหา**: การขาดความครอบคลุมกระบวนการวิศวกรรมอย่างสมบูรณ์มักพลาดขั้นตอนสำคัญ ทำให้คุณภาพรับประกันได้ยาก
+
+**แนวทางแก้ไข**: ครอบคลุมวงจรชีวิตวิศวกรรมซอฟต์แวร์ทั้งหมด:
+```
+PRD (ความต้องการ) → Feature Design (การออกแบบฟังก์ชัน) → API Contract (สัญญา)
+    → System Design (การออกแบบระบบ) → Dev (การพัฒนา) → Test (การทดสอบ)
+```
+- เอาต์พุตของแต่ละเฟสเป็นอินพุตของเฟสถัดไป
+- แต่ละขั้นตอนต้องการการยืนยันจากมนุษย์ก่อนดำเนินการต่อ
+- การดำเนินการ Agent ทั้งหมดมีรายการ todo พร้อมการตรวจสอบตัวเองหลังเสร็จสิ้น
+
+### 5. ประสิทธิภาพการทำงานร่วมกันของทีมต่ำ (ไซโลความรู้)
+**ปัญหา**: ประสบการณ์การเขียนโปรแกรม AI แบ่งปันระหว่างทีมได้ยาก นำไปสู่ข้อผิดพลาดซ้ำๆ
+
+**แนวทางแก้ไข**: Agent, Skill และเอกสารที่เกี่ยวข้องทั้งหมดถูกควบคุมเวอร์ชันด้วยโค้ดต้นฉบับ:
+- การเพิ่มประสิทธิภาพของคนหนึ่งแบ่งปันโดยทีม
+- ความรู้สะสมในฐานโค้ด
+- ประสิทธิภาพการทำงานร่วมกันของทีมเพิ่มขึ้น
+
+### 7. บริบท Agent เดี่ยวยาวเกินไป (คอขวดประสิทธิภาพ)
+**ปัญหา**: งานซับซ้อนขนาดใหญ่เกินหน้าต่างบริบท Agent เดี่ยว ทำให้เกิดการเบี่ยงเบนความเข้าใจและลดคุณภาพเอาต์พุต
+
+**แนวทางแก้ไข**: **กลไก Auto-Dispatch Sub-Agent**:
+- งานซับซ้อนถูกระบุโดยอัตโนมัติและแบ่งเป็นงานย่อย
+- แต่ละงานย่อยดำเนินการโดย Sub-Agent อิสระพร้อมบริบทแยก
+- Parent Agent ประสานและรวบรวมเพื่อรับประกันความสอดคล้องโดยรวม
+- หลีกเลี่ยงการขยายบริบท Agent เดี่ยว รับประกันคุณภาพเอาต์พุต
+
+### 8. ความโกลาหลในการวนซ้ำความต้องการ (ความยากลำบากในการจัดการ)
+**ปัญหา**: ความต้องการหลายอย่างผสมในสาขาเดียวกันมีผลกระทบต่อกัน ทำให้ติดตามและย้อนกลับยาก
+
+**แนวทางแก้ไข**: **แต่ละความต้องการเป็นโปรเจกต์อิสระ**:
+- แต่ละความต้องการสร้างไดเรกทอรีวนซ้ำอิสระ `iterations/iXXX-[ชื่อความต้องการ]/`
+- การแยกโดยสมบูรณ์: เอกสาร, การออกแบบ, โค้ด และการทดสอบจัดการอย่างอิสระ
+- การวนซ้ำอย่างรวดเร็ว: การส่งมอบแบบละเอียดเล็กน้อง, การตรวจสอบอย่างรวดเร็ว, การปรับใช้อย่างรวดเร็ว
+- การเก็บถาวรที่ยืดหยุ่น: หลังเสร็จสิ้น เก็บถาวรใน `archive/` พร้อมการติดตามประวัติที่ชัดเจน
+
+### 6. การอัปเดตเอกสารล่าช้า (การเสื่อมสภาพของความรู้)
+**ปัญหา**: เอกสารล้าสมัยเมื่อโปรเจกต์พัฒนา ทำให้ AI ทำงานด้วยข้อมูลที่ไม่ถูกต้อง
+
+**แนวทางแก้ไข**: Agent มีความสามารถอัปเดตเอกสารอัตโนมัติ ซิงโครไนซ์การเปลี่ยนแปลงโปรเจกต์แบบเรียลไทม์เพื่อรักษาความถูกต้องของฐานความรู้
+
+---
+
+## เวิร์กโฟลว์หลัก
+
+```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
+```
+
+### คำอธิบายแต่ละเฟส
+
+| เฟส | Agent | อินพุต | เอาต์พุต | การยืนยันจากมนุษย์ |
+|------|-------|--------|---------|-------------------|
+| 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 | เคสทดสอบ + โค้ดทดสอบ + รายงานการทดสอบ + รายงาน Bug | ✅ จำเป็น |
+
+---
+
+## การเปรียบเทียบกับโซลูชันที่มีอยู่
+
+| มิติ | Vibe Coding | Ralph Loop | **SpecCrew** |
+|------|-------------|------------|-------------|
+| การพึ่งพาเอกสาร | เพิกเฉยเอกสารที่มีอยู่ | พึ่งพา AGENTS.md | **ฐานความรู้แบบโครงสร้าง** |
+| การถ่ายโอนความต้องการ | เขียนโค้ดโดยตรง | PRD → โค้ด | **PRD → Feature Design → System Design → โค้ด** |
+| การมีส่วนร่วมของมนุษย์ | น้อยที่สุด | ตอนเริ่มต้น | **ในทุกเฟส** |
+| ความสมบูรณ์ของกระบวนการ | อ่อนแอ | ปานกลาง | **เวิร์กโฟลว์วิศวกรรมที่สมบูรณ์** |
+| การทำงานร่วมกันของทีม | แชร์ยาก | ประสิทธิภาพส่วนบุคคล | **การแชร์ความรู้ของทีม** |
+| การจัดการบริบท | อินสแตนซ์เดียว | ลูปอินสแตนซ์เดียว | **Auto-dispatch Sub-Agent** |
+| การจัดการวนซ้ำ | ผสม | รายการงาน | **ความต้องการเป็นโปรเจกต์, วนซ้ำอิสระ** |
+| ดีเทอร์มินิซึม | ต่ำ | ปานกลาง | **สูง (การเปิดเผยแบบก้าวหน้า)** |
+
+---
+
+## เริ่มต้นอย่างรวดเร็ว
+
+### ข้อกำหนดเบื้องต้น
+
+- 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/` — นิยามบทบาท Agent 7 ตัว
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — เวิร์กโฟลว์ Skill 38 ตัว
+- `speccrew-workspace/` — พื้นที่ทำงาน (ไดเรกทอรีวนซ้ำ, ฐานความรู้, เทมเพลตเอกสาร)
+- `.speccrewrc` — ไฟล์การกำหนดค่า SpecCrew
+
+เพื่ออัปเดต Agent และ Skill สำหรับ IDE เฉพาะภายหลัง:
+
+```bash
+speccrew update --ide cursor
+speccrew update --ide claude
+```
+
+### 3. เริ่มเวิร์กโฟลว์การพัฒนา
+
+ทำตามเวิร์กโฟลว์วิศวกรรมมาตรฐานทีละขั้นตอน:
+
+1. **PRD**: Agent Product Manager วิเคราะห์ความต้องการและสร้างเอกสารความต้องการผลิตภัณฑ์
+2. **Feature Design**: Agent Feature Designer สร้างเอกสาร Feature Design + สัญญา API
+3. **System Design**: Agent System Designer สร้างเอกสาร System Design ตามแพลตฟอร์ม (frontend/backend/moble/desktop)
+4. **Dev**: Agent System Developer ใช้งานการพัฒนาตามแพลตฟอร์มแบบขนาน
+5. **System Test**: Agent Test Manager ประสานการทดสอบสามเฟส (การออกแบบเคส → การสร้างโค้ด → รายงานการดำเนินการ)
+6. **Archive**: เก็บถาวรการวนซ้ำ
+
+> ผลลัพธ์ของแต่ละเฟสต้องการการยืนยันจากมนุษย์ก่อนดำเนินการต่อไปยังเฟสถัดไป
+
+### 4. คำสั่ง CLI อื่นๆ
+
+```bash
+speccrew list       # แสดงรายการ agent และ skill ที่ติดตั้ง
+speccrew doctor     # วินิจฉัยสภาพแวดล้อมและสถานะการติดตั้ง
+speccrew update     # อัปเดต agent และ skill เป็นเวอร์ชันล่าสุด
+speccrew uninstall  # ถอนการติดตั้ง SpecCrew (--all ลบพื้นที่ทำงานด้วย)
+```
+
+📖 **คู่มือโดยละเอียด**: หลังการติดตั้ง ดู [คู่มือเริ่มต้น](docs/GETTING-STARTED.th.md) สำหรับเวิร์กโฟลว์เต็มรูปแบบและคู่มือการสนทนา Agent
+
+---
+
+## ข้อมูลเพิ่มเติม
+
+- **แผนที่ความรู้ 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 ไม่ได้มีจุดประสงค์เพื่อแทนที่นักพัฒนา แต่เพื่อทำให้ส่วนที่น่าเบื่อเป็นอัตโนมัติ เพื่อให้ทีมสามารถมุ่งเน้นไปที่งานที่มีคุณค่ามากขึ้น**