speccrew 0.7.45 → 0.7.46

package/README.th.md

@@ -1,311 +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>
-
-> ทีมพัฒนา AI เสมือนที่ช่วยให้การใช้งานวิศวกรรมอย่างรวดเร็วสำหรับโปรเจกต์ซอฟต์แวร์ใดๆ
-
-## SpecCrew คืออะไร?
-
-SpecCrew เป็นเฟรมเวิร์กทีมพัฒนา AI เสมือนแบบฝังตัว มันแปลงเวิร์กโฟลว์วิศวกรรมซอฟต์แวร์มืออาชีพ (PRD → Feature Design → System Design → Dev → Deployment → Test) เป็นเวิร์กโฟลว์ Agent ที่นำกลับมาใช้ใหม่ได้ ช่วยให้ทีมพัฒนาบรรลุ Specification-Driven Development (SDD) โดยเฉพาะเหมาะสำหรับโปรเจกต์ที่มีอยู่แล้ว
-
-โดยการรวม Agent และ Skill เข้ากับโปรเจกต์ที่มีอยู่ ทีมสามารถเริ่มต้นระบบเอกสารโปรเจกต์และทีมซอฟต์แวร์เสมือนได้อย่างรวดเร็ว ดำเนินการเพิ่มและแก้ไขคุณสมบัติใหม่ตามเวิร์กโฟลว์วิศวกรรมมาตรฐาน
-
----
-
-## ✨ จุดเด่นหลัก
-
-### 🏭 ทีมซอฟต์แวร์เสมือน
-การสร้างด้วยคลิกเดียว **7 บทบาท Agent มืออาชีพ** + **30+ เวิร์กโฟลว์ Skill** สร้างทีมซอฟต์แวร์เสมือนที่สมบูรณ์:
-- **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)
-- ความต้องการทางธุรกิจ "ถูกกลั่นกรองทีละขั้นตอน" โดยไม่สูญเสียข้อมูล
-- ผลลัพธ์สามารถนำไปใช้ในการพัฒนาได้โดยตรง
-
-### 📚 ระบบฐานความรู้
-สถาปัตยกรรมฐานความรู้สามชั้นที่รับรองว่า AI ทำงานอิงตาม "แหล่งความจริงเดียว" เสมอ:
-
-| ชั้น | ไดเรกทอรี | เนื้อหา | วัตถุประสงค์ |
-|------|-----------|---------|-------------|
-| L1 ความรู้ระบบ | `knowledge/techs/` | Stack เทคโนโลยี, สถาปัตยกรรม, ข้อตกลง | AI เข้าใจขอบเขตทางเทคนิคของโปรเจกต์ |
-| L2 ความรู้ธุรกิจ | `knowledge/bizs/` | ฟังก์ชันโมดูล, การไหลทางธุรกิจ, เอนทิตี | AI เข้าใจตรรกะทางธุรกิจ |
-| L3 สิ่งซ้ำการทำซ้ำ | `iterations/iXXX/` | PRD, เอกสารการออกแบบ, รายงานการทดสอบ | โซ่การติดตามที่สมบูรณ์สำหรับความต้องการปัจจุบัน |
-
-### 🔄 ไปป์ไลน์ความรู้สี่ขั้นตอน
-**สถาปัตยกรรมการสร้างความรู้โดยอัตโนมัติ** การสร้างเอกสารธุรกิจ/เทคนิคโดยอัตโนมัติจากรหัสต้นฉบับ:
-```
-ขั้นตอนที่ 1: สแกนรหัสต้นฉบับ → สร้างรายการโมดูล
-ขั้นตอนที่ 2: การวิเคราะห์ขนาน → สกัดฟีเจอร์ (multi-Worker ขนาน)
-ขั้นตอนที่ 3: การสรุปขนาน → ทำให้ภาพรวมโมดูลสมบูรณ์ (multi-Worker ขนาน)
-ขั้นตอนที่ 4: การรวมระบบ → สร้างภาพพาโนรามาของระบบ
-```
-- รองรับ **การซิงค์แบบเต็ม** และ **การซิงค์แบบเพิ่ม** (อิงตาม Git diff)
-- คนเดียวปรับปรุง ทีมแชร์
-
-### 🔧 Harness กรอบการลงมือปฏิบัติจริง
-**กรอบการดำเนินการมาตรฐาน** เพื่อให้แน่ใจว่าเอกสารการออกแบบถูกแปลงเป็นคำสั่งพัฒนาที่ปฏิบัติได้อย่างแม่นยำ:
-- **หลักคู่มือการดำเนินการ**: Skill คือ SOP ขั้นตอนชัดเจน ต่อเนื่อง และครบถ้วนในตัวเอง
-- **สัญญาอินพุต-เอาต์พุต**: กำหนดอินเทอร์เฟซชัดเจน ปฏิบัติอย่างเคร่งครัดเหมือน pseudocode
-- **สถาปัตยกรรมการเปิดเผยแบบก้าวหน้า**: โหลดข้อมูลแบบเลเยอร์ หลีกเลี่ยงการโหลดบริบทมากเกินไปในครั้งเดียว
-- **การมอบหมาย Sub-Agent**: แยกงานอัตโนมัติสำหรับงานที่ซับซ้อน ดำเนินการแบบขนานเพื่อรับประกันคุณภาพ
-
----
-
-## แก้ปัญหาหลัก 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[Deployment<br/>การปรับใช้]
-    F --> G[System Test<br/>การทดสอบ]
-    G --> H[Archive<br/>การเก็บถาวร]
-    
-    I[Knowledge<br/>รีโพสิทอรี] -.-> A
-    I -.-> B
-    I -.-> D
-    I -.-> E
-    I -.-> F
-    
-    E -.-> I
-    F -.-> I
-    G -.-> I
-```
-
-### คำอธิบายแต่ละเฟส
-
-| เฟส | Agent | อินพุต | เอาต์พุต | การยืนยันจากมนุษย์ |
-|------|-------|--------|---------|-------------------|
-| PRD | PM | ความต้องการผู้ใช้ | เอกสารความต้องการผลิตภัณฑ์ | ✅ จำเป็น |
-| Feature Design | Feature Designer | PRD | เอกสาร Feature Design + สัญญา API | ✅ จำเป็น |
-| System Design | System Designer | Feature Spec | เอกสารการออกแบบ Frontend/Backend | ✅ จำเป็น |
-| Dev | Dev | Design | โค้ด + บันทึกงาน | ✅ จำเป็น |
-| Deployment | System Deployer | เอาต์พุต Dev | รายงานการปรับใช้ + แอปพลิเคชันที่ทำงาน | ✅ จำเป็น |
-| System Test | Test Manager | เอาต์พุต Deployment + 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 30+ ตัว
-- `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. **Deployment**: Agent System Deployer ดำเนินการ build, database migration, service startup และ smoke test
-6. **System Test**: Agent Test Manager ประสานการทดสอบสามเฟส (การออกแบบเคส → การสร้างโค้ด → รายงานการดำเนินการ)
-7. **Archive**: เก็บถาวรการวนซ้ำ
-
-> ผลลัพธ์ของแต่ละเฟสต้องการการยืนยันจากมนุษย์ก่อนดำเนินการต่อไปยังเฟสถัดไป
-
-### 4. อัปเดต SpecCrew
-
-เมื่อมีการเปิดตัว SpecCrew เวอร์ชันใหม่ ให้ทำการอัปเดตให้เสร็จสิ้นใน 2 ขั้นตอน:
-
-```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` อัปเดตไฟล์กำหนด Agent และ Skill ในโปรเจกต์ของคุณ ต้องใช้ทั้งสองขั้นตอนสำหรับการอัปเดตที่สมบูรณ์
-
-### 5. คำสั่ง 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 ไม่ได้มีจุดประสงค์เพื่อแทนที่นักพัฒนา แต่เพื่อทำให้ส่วนที่น่าเบื่อเป็นอัตโนมัติ เพื่อให้ทีมสามารถมุ่งเน้นไปที่งานที่มีคุณค่ามากขึ้น**

package/README.tr.md

@@ -1,306 +0,0 @@
-# SpecCrew - AI Destekli Yazılım Mühendisliği Çerçevesi
-
-<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>
-
-> Herhangi bir yazılım projesi için hızlı mühendislik uygulaması sağlayan sanal bir AI geliştirme ekibi
-
-## SpecCrew Nedir?
-
-SpecCrew, gömülü bir sanal AI geliştirme ekibi çerçevesidir. Profesyonel yazılım mühendisliği iş akışlarını (PRD → Feature Design → System Design → Dev → Test) yeniden kullanılabilir Agent iş akışlarına dönüştürerek geliştirme ekiplerinin Specification-Driven Development (SDD) elde etmesine yardımcı olur ve özellikle mevcut projeler için uygundur.
-
-Mevcut projelere Agent'ları ve Skill'leri entegre ederek, ekipler proje dokümantasyon sistemlerini ve sanal yazılım ekiplerini hızla başlatabilir ve standart mühendislik iş akışlarını takip ederek yeni özellikleri ve modifikasyonları adım adım uygulayabilir.
-
----
-
-## ✨ Ana Özellikler
-
-### 🏭 Sanal Yazılım Ekibi
-Tek tıkla **7 profesyonel Agent rolü** + **30+ Skill iş akışı** oluşturma, eksiksiz bir sanal yazılım ekibi oluşturma:
-- **Team Leader** - Global planlama ve iterasyon yönetimi
-- **Product Manager** - Gereksinim analizi ve PRD çıktısı
-- **Feature Designer** - Özellik tasarımı + API sözleşmeleri
-- **System Designer** - Frontend/Backend/Mobil/Desktop sistem tasarımı
-- **System Developer** - Çoklu platform paralel geliştirme
-- **Test Manager** - Üç aşamalı test koordinasyonu
-- **Task Worker** - Alt görev paralel yürütme
-
-### 📐 ISA-95 Altı Aşamalı Modelleme
-Uluslararası **ISA-95** modelleme metodolojisine dayalı, iş gereksinimlerinden yazılım sistemlerine dönüşümün standartlaştırılması:
-```
-Domain Descriptions → Functions in Domains → Functions of Interest
-     ↓                       ↓                      ↓
-Information Flows → Categories of Information → Information Descriptions
-```
-- Her aşama belirli UML diyagramlarına karşılık gelir (use case, sequence, class)
-- İş gereksinimleri "adım adım rafine edilir", bilgi kaybı olmadan
-- Çıktılar geliştirme için doğrudan kullanılabilir
-
-### 📚 Bilgi Tabanı Sistemi
-AI'nın her zaman "tek gerçek kaynağına" dayanarak çalışmasını sağlayan üç katmanlı bilgi tabanı mimarisi:
-
-| Katman | Dizin | İçerik | Amaç |
-|--------|-------|--------|------|
-| L1 Sistem Bilgisi | `knowledge/techs/` | Tech stack, mimari, sözleşmeler | AI projenin teknik sınırlarını anlar |
-| L2 İş Bilgisi | `knowledge/bizs/` | Modül işlevleri, iş akışları, varlıklar | AI iş mantığını anlar |
-| L3 İterasyon Eserleri | `iterations/iXXX/` | PRD, tasarım belgeleri, test raporları | Mevcut gereksinimler için eksiksiz izlenebilirlik zinciri |
-
-### 🔄 Dört Aşamalı Bilgi Hattı
-**Otomatik bilgi üretimi mimarisi**, kaynak koddan iş/teknik dokümantasyonun otomatik olarak oluşturulması:
-```
-Aşama 1: Kaynak kod tarama → Modül listesi oluşturma
-Aşama 2: Paralel analiz → Özellik çıkarma (çoklu Worker paralel)
-Aşama 3: Paralel özetleme → Modül görünümlerini tamamlama (çoklu Worker paralel)
-Aşama 4: Sistem agregasyonu → Sistem panoraması oluşturma
-```
-- **Tam senkronizasyon** ve **artımlı senkronizasyon** destekler (Git diff tabanlı)
-- Bir kişi optimize eder, ekip paylaşır
-
-### 🔧 Harness Pratik Uygulama Çerçevesi
-**Standartlaştırılmış yürütme çerçevesi**, tasarım belgelerinin yürütülebilir geliştirme talimatlarına hassas bir şekilde dönüştürülmesini sağlar:
-- **Operasyonel kılavuz ilkesi**: Skill bir SOP'dur, adımlar net, ardışık ve kendi kendine yeten
-- **Girdi-çıktı sözleşmesi**: Arayüzleri açıkça tanımlar, pseudocode gibi titizlikle yürütür
-- **Aşamalı açıklama mimarisi**: Bilgileri katmanlı yükler, tek seferde bağlam aşırı yüklenmesini önler
-- **Alt Agent delege etme**: Karmaşık görevleri otomatik böler, paralel yürütme kaliteyi güvence altına alır
-
----
-
-## Çözülen 8 Temel Sorun
-
-### 1. AI Mevcut Proje Dokümantasyonunu Görmezden Gelir (Bilgi Boşluğu)
-**Problem**: Mevcut SDD veya Vibe Coding yöntemleri, AI'nın projeleri gerçek zamanlı özetlemesine dayanır, bu da kritik içeriğin kolayca kaçırılmasına ve geliştirme sonuçlarının beklentilerden sapmasına neden olur.
-
-**Çözüm**: `knowledge/` deposu projenin "tek doğruluk kaynağı" olarak hizmet eder, mimari tasarımı, işlevsel modülleri ve iş süreçlerini biriktirerek gereksinimlerin kaynaktan itibaren yolda kalmasını sağlar.
-
-### 2. PRD'den Doğrudan Teknik Dokümantasyon (İçerik Atlama)
-**Problem**: PRD'den doğrudan detaylı tasarıma atlamak, gereksinim detaylarını kolayca kaçırır ve uygulanan özelliklerin gereksinimlerden sapmasına neden olur.
-
-**Çözüm**: Teknik detaylar olmadan yalnızca gereksinim iskeletine odaklanan **Feature Design Dokümanı** aşamasını tanıtın:
-- Hangi sayfalar ve bileşenler dahil?
-- Sayfa operasyon akışları
-- Backend işleme mantığı
-- Veri depolama yapısı
-
-Geliştirme, belirli teknoloji yığınına dayalı olarak sadece "eti doldurmak" zorundadır ve özelliklerin "kemiklere (gereksinimlere) yakın" büyümesini sağlar.
-
-### 3. Belirsiz Agent Arama Kapsamı (Belirsizlik)
-**Problem**: Karmaşık projelerde, AI'nın geniş kod ve doküman araması belirsiz sonuçlar verir ve tutarlılığı garanti etmeyi zorlaştırır.
-
-**Çözüm**: Her Agent'ın ihtiyaçlarına göre tasarlanmış net doküman dizin yapıları ve şablonlar, determinizmi garanti etmek için **aşamalı açıklama ve talep üzerine yükleme** uygular.
-
-### 4. Eksik Aşamalar ve Görevler (Süreç Kopukluğu)
-**Problem**: Eksik mühendislik süreci kapsamı kritik adımları kolayca kaçırır ve kaliteyi garanti etmeyi zorlaştırır.
-
-**Çözüm**: Yazılım mühendisliği yaşam döngüsünün tamamını kapsar:
-```
-PRD (Gereksinimler) → Feature Design (Özellik Tasarımı) → API Contract (Sözleşme)
-    → System Design (Sistem Tasarımı) → Dev (Geliştirme) → Test (Test)
-```
-- Her aşamanın çıktısı bir sonraki aşamanın girdisidir
-- Her adım devam etmeden önce insan onayı gerektirir
-- Tüm Agent yürütmelerinin tamamlanma sonrası kendi kendini kontrol eden todo listeleri vardır
-
-### 5. Düşük Takım İşbirliği Verimliliği (Bilgi Siloları)
-**Problem**: AI programlama deneyimi takımlar arasında paylaşılması zor olduğundan, tekrarlanan hatalara yol açar.
-
-**Çözüm**: Tüm Agent'lar, Skill'ler ve ilgili dokümanlar kaynak koduyla birlikte versiyon kontrol edilir:
-- Bir kişinin optimizasyonu takım tarafından paylaşılır
-- Bilgi kod tabanında birikir
-- Takım işbirliği verimliliği artar
-
-### 7. Tek Agent Bağlamı Çok Uzun (Performans Darboğazı)
-**Problem**: Büyük karmaşık görevler tek Agent bağlam pencerelerini aşar, anlama sapmalarına ve çıktı kalitesinin düşmesine neden olur.
-
-**Çözüm**: **Sub-Agent Otomatik Dispatch Mekanizması**:
-- Karmaşık görevler otomatik olarak tanımlanır ve alt görevlere bölünür
-- Her alt görev, izole bağlam ile bağımsız bir Sub-Agent tarafından yürütülür
-- Parent Agent koordine eder ve birleştirerek genel tutarlılığı sağlar
-- Tek Agent bağlam genişlemesini önler ve çıktı kalitesini garanti eder
-
-### 8. Gereksinim İterasyon Kaosu (Yönetim Zorluğu)
-**Problem**: Aynı dalda karıştırılan birden fazla gereksinim birbirini etkiler, takip ve geri alma işlemlerini zorlaştırır.
-
-**Çözüm**: **Her Gereksinim Bir Bağımsız Proje Olarak**:
-- Her gereksinim bağımsız bir iterasyon dizini oluşturur `iterations/iXXX-[gereksinim-adı]/`
-- Tam izolasyon: dokümanlar, tasarım, kod ve testler bağımsız yönetilir
-- Hızlı iterasyon: küçük parçalı teslimat, hızlı doğrulama, hızlı dağıtım
-- Esnek arşivleme: tamamlandıktan sonra, net tarihsel izlenebilirlikle `archive/` altında arşivlenir
-
-### 6. Doküman Güncelleme Gecikmesi (Bilgi Çürümesi)
-**Problem**: Projeler geliştikçe dokümanlar eskir ve AI yanlış bilgiyle çalışır.
-
-**Çözüm**: Agent'lar otomatik doküman güncelleme yeteneklerine sahiptir, proje değişikliklerini gerçek zamanlı senkronize ederek bilgi tabanının doğruluğunu korur.
-
----
-
-## Temel İş Akışı
-
-```mermaid
-graph LR
-    A[PRD<br/>Gereksinim Dokümanı] --> B[Feature Design<br/>Özellik Tasarımı]
-    B --> C[API Contract<br/>Arayüz Sözleşmesi]
-    C --> D[System Design<br/>Sistem Tasarımı]
-    D --> E[Dev<br/>Uygulama]
-    E --> F[System Test<br/>Test]
-    F --> G[Archive<br/>Arşivleme]
-    
-    H[Knowledge<br/>Depo] -.-> A
-    H -.-> B
-    H -.-> D
-    H -.-> E
-    
-    E -.-> H
-    F -.-> H
-```
-
-### Aşama Açıklamaları
-
-| Aşama | Agent | Girdi | Çıktı | İnsan Onayı |
-|-------|-------|-------|-------|-------------|
-| PRD | PM | Kullanıcı Gereksinimleri | Ürün Gereksinim Dokümanı | ✅ Gerekli |
-| Feature Design | Feature Designer | PRD | Feature Design Dokümanı + API Sözleşmesi | ✅ Gerekli |
-| System Design | System Designer | Feature Spec | Frontend/Backend Tasarım Dokümanları | ✅ Gerekli |
-| Dev | Dev | Design | Kod + Görev Kayıtları | ✅ Gerekli |
-| System Test | Test Manager | Dev Çıktısı + Feature Spec | Test Senaryoları + Test Kodu + Test Raporu + Bug Raporu | ✅ Gerekli |
-
----
-
-## Mevcut Çözümlerle Karşılaştırma
-
-| Boyut | Vibe Coding | Ralph Loop | **SpecCrew** |
-|-------|-------------|------------|-------------|
-| Doküman Bağımlılığı | Mevcut dokümanları görmezden gelir | AGENTS.md'e bağımlı | **Yapılandırılmış Bilgi Tabanı** |
-| Gereksinim Transferi | Doğrudan kodlama | PRD → Kod | **PRD → Feature Design → System Design → Kod** |
-| İnsan Katılımı | Minimal | Başlangıçta | **Her aşamada** |
-| Süreç Tamlığı | Zayıf | Orta | **Tam mühendislik iş akışı** |
-| Takım İşbirliği | Paylaşım zor | Kişisel verimlilik | **Takım bilgi paylaşımı** |
-| Bağlam Yönetimi | Tek örnek | Tek örnek döngüsü | **Sub-Agent otomatik dispatch** |
-| İterasyon Yönetimi | Karışık | Görev listesi | **Gereksinim proje olarak, bağımsız iterasyon** |
-| Determinizm | Düşük | Orta | **Yüksek (aşamalı açıklama)** |
-
----
-
-## Hızlı Başlangıç
-
-### Önkoşullar
-
-- Node.js >= 16.0.0
-- Desteklenen IDE'ler: Qoder (varsayılan), Cursor, Claude Code
-
-> **Not**: Cursor ve Claude Code için adaptörler gerçek IDE ortamlarında test edilmemiştir (kod seviyesinde uygulanmış ve E2E testleri ile doğrulanmış, ancak gerçek Cursor/Claude Code'da henüz test edilmemiştir).
-
-### 1. SpecCrew'ü Kurun
-
-```bash
-npm install -g speccrew
-```
-
-### 2. Projeyi Başlatın
-
-Projenizin kök dizinine gidin ve başlatma komutunu çalıştırın:
-
-```bash
-cd /path/to/your-project
-
-# Varsayılan olarak Qoder kullanır
-speccrew init
-
-# Veya IDE belirtin
-speccrew init --ide qoder
-speccrew init --ide cursor
-speccrew init --ide claude
-```
-
-Başlatmadan sonra projenizde şu dosyalar oluşturulacaktır:
-- `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 Agent rol tanımı
-- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ Skill iş akışı
-- `speccrew-workspace/` — Çalışma alanı (iterasyon dizinleri, bilgi tabanı, doküman şablonları)
-- `.speccrewrc` — SpecCrew yapılandırma dosyası
-
-Daha sonra belirli bir IDE için Agent'ları ve Skill'leri güncellemek için:
-
-```bash
-speccrew update --ide cursor
-speccrew update --ide claude
-```
-
-### 3. Geliştirme İş Akışını Başlatın
-
-Standart mühendislik iş akışını adım adım takip edin:
-
-1. **PRD**: Product Manager Agent gereksinimleri analiz eder ve ürün gereksinim dokümanı oluşturur
-2. **Feature Design**: Feature Designer Agent feature design dokümanı + API sözleşmesi oluşturur
-3. **System Design**: System Designer Agent platformlara göre sistem tasarım dokümanları oluşturur (frontend/backend/mobile/desktop)
-4. **Dev**: System Developer Agent platformlara göre paralel geliştirme uygular
-5. **System Test**: Test Manager Agent üç aşamalı test koordine eder (senaryo tasarımı → kod üretimi → yürütme raporu)
-6. **Archive**: İterasyonu arşivle
-
-> Her aşamanın teslim edilebilirleri bir sonraki aşamaya geçmeden önce insan onayı gerektirir.
-
-### 4. SpecCrew'ü Güncelle
-
-SpecCrew'un yeni bir sürümü yayınlandığında, güncellemeyi iki adımda tamamlayın:
-
-```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
-```
-
-> **Not**: `npm install -g speccrew@latest` CLI aracının kendisini güncellerken, `speccrew update` projenizdeki Agent ve Skill tanım dosyalarını günceller. Tam bir güncelleme için her iki adım da gereklidir.
-
-### 5. Diğer CLI Komutları
-
-```bash
-speccrew list       # Yüklü agent'ları ve skill'leri listele
-speccrew doctor     # Ortamı ve kurulum durumunu teşhis et
-speccrew update     # Agent'ları ve skill'leri en son sürüme güncelle
-speccrew uninstall  # SpecCrew'ü kaldır (--all çalışma alanını da siler)
-```
-
-📖 **Detaylı Kılavuz**: Kurulumdan sonra, tam iş akışı ve Agent konuşma kılavuzu için [Başlangıç Kılavuzu](docs/GETTING-STARTED.tr.md)'na bakın.
-
----
-
-## Daha Fazla Bilgi
-
-- **Agent Bilgi Haritası**: [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 geliştiricilerin yerini almayı değil, sıkıcı kısımları otomatikleştirerek ekiplerin daha değerli işlere odaklanmasını sağlar.**