Compare commits
107 Commits
1da666b090
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
| 56f9544cb0 | |||
| 7e8f4859cd | |||
| e3503b6a77 | |||
| 9c5df0abdb | |||
| 190b9a3af5 | |||
| 2c5a0b6aef | |||
| d333d8a45a | |||
| 0227b7b982 | |||
| 71c5e88181 | |||
| cd7d20ccd4 | |||
| 75d07b5ac9 | |||
| 52b96d01de | |||
| a0f77ad121 | |||
| 16aab2279c | |||
| 15dec6c3fc | |||
| 33c3935164 | |||
| 6bcd1a5c58 | |||
| de4201d7d3 | |||
| e3e0de66e9 | |||
| 866fea7946 | |||
| 85c7415b8a | |||
| ed1b302274 | |||
| 26cc71ce60 | |||
| 285c007dff | |||
| 03aa4efcf0 | |||
| 4f90ed688f | |||
| 548dba6476 | |||
| 4a808dd9c4 | |||
| e71602e90c | |||
| bd96c4122c | |||
| 661710f349 | |||
| eae94cf1f3 | |||
| eeb9f6c686 | |||
| 37174788bf | |||
| 2db4810dfc | |||
| 8b6ef392f5 | |||
| eef557675b | |||
| 1a399400ff | |||
| 29314a7ec4 | |||
| 70fbac1b49 | |||
| 1c3d9906e4 | |||
| c841be1b31 | |||
| 94583bd30f | |||
| 17dff31dec | |||
| b14a0b3d58 | |||
| 03963fd896 | |||
| 663ed13522 | |||
| 9c122c8328 | |||
| 4d243c16e6 | |||
| 994b41aa37 | |||
| b79895e6fb | |||
| fb224a116c | |||
| e0eabfb350 | |||
| 3274dede7a | |||
| 754d609399 | |||
| e4948ad4c8 | |||
| be851ee311 | |||
| cb9ecb2de6 | |||
| b939a25456 | |||
| 8909629d8f | |||
| bc754e66fd | |||
| 7f35c3a585 | |||
| 2cc07ee2e5 | |||
| 69db07fe35 | |||
| acc19f4a44 | |||
| 2bbe67b4c5 | |||
| 7bc6eefad2 | |||
| 09505f5793 | |||
| cd2bd5bf19 | |||
| 20f9fa1e85 | |||
| b8954b300d | |||
| 00ae9d3067 | |||
| 3c80617ffb | |||
| 268f34198b | |||
| ae1b1f35e1 | |||
| f86fcc05f5 | |||
| 9404596012 | |||
| 10024a66c3 | |||
| b7a7b1e84d | |||
| 30d9d721fb | |||
| c9edd62a0b | |||
| ddc9332122 | |||
| e82cb0e68b | |||
| b1c838a637 | |||
| d13d5a06cc | |||
| 3bf0f506eb | |||
| c88354347b | |||
| 33c62993d5 | |||
| 499d787aa5 | |||
| b0b7d12d5a | |||
| 1ba563aa70 | |||
| 63ded10341 | |||
| 32204c9305 | |||
| 6799cb1715 | |||
| f33487f511 | |||
| 8367ced926 | |||
| 8b05f0f05c | |||
| d19131fa75 | |||
| 95c1c31e1f | |||
| 0dcd7f460b | |||
| b68a750e4f | |||
| 5d46504c1d | |||
| 4391bbe61d | |||
| 960cd78b8a | |||
| 01de542d15 | |||
| 9502d789b9 | |||
| 83d1517afc |
@@ -1,7 +1,7 @@
|
|||||||
# NAP-DMS Project Context & Rules
|
# NAP-DMS Project Context & Rules
|
||||||
|
|
||||||
- For: Windsurf Cascade (and compatible: Codex CLI, opencode, Amp, Antigravity, AGENTS.md tools)
|
- For: Devin Cascade (and compatible: Codex CLI, opencode, Amp, Antigravity, AGENTS.md tools)
|
||||||
- Version: 1.9.6 | Last synced from repo: 2026-05-22
|
- Version: 1.9.10 | Last synced from repo: 2026-06-06
|
||||||
- Repo: [https://git.np-dms.work/np-dms/lcbp3](https://git.np-dms.work/np-dms/lcbp3)
|
- Repo: [https://git.np-dms.work/np-dms/lcbp3](https://git.np-dms.work/np-dms/lcbp3)
|
||||||
- Skill pack: `.agents/skills/` (v1.9.0, 21 skills) — see [`skills/README.md`](./.agents/skills/README.md) + [`skills/_LCBP3-CONTEXT.md`](./.agents/skills/_LCBP3-CONTEXT.md)
|
- Skill pack: `.agents/skills/` (v1.9.0, 21 skills) — see [`skills/README.md`](./.agents/skills/README.md) + [`skills/_LCBP3-CONTEXT.md`](./.agents/skills/_LCBP3-CONTEXT.md)
|
||||||
|
|
||||||
|
|||||||
@@ -112,3 +112,99 @@
|
|||||||
| "แก้ bug / bugfix" | `.agents/workflows/bugfix.md`, `error-catalog.md` | ใช้ bugfix workflow สำหรับเคสที่สาเหตุชัดเจน |
|
| "แก้ bug / bugfix" | `.agents/workflows/bugfix.md`, `error-catalog.md` | ใช้ bugfix workflow สำหรับเคสที่สาเหตุชัดเจน |
|
||||||
| "ตรวจแอปจริง" | `.windsurf/workflows/check-real-app.md` | ตรวจ endpoint/UI/console หลัง build pass — No Fake Evidence |
|
| "ตรวจแอปจริง" | `.windsurf/workflows/check-real-app.md` | ตรวจ endpoint/UI/console หลัง build pass — No Fake Evidence |
|
||||||
| "งานค้าง / resume" | `.windsurf/workflows/resume-pending-work.md` | อ่าน checkpoint เดิม → ตรวจ build → วางแผนต่อโดยไม่ทำงานซ้ำ |
|
| "งานค้าง / resume" | `.windsurf/workflows/resume-pending-work.md` | อ่าน checkpoint เดิม → ตรวจ build → วางแผนต่อโดยไม่ทำงานซ้ำ |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔌 MCP MariaDB Tools
|
||||||
|
|
||||||
|
MCP MariaDB server ให้เครื่องมือสำหรับตรวจสอบและจัดการ database โดยตรง ใช้สำหรับ:
|
||||||
|
|
||||||
|
- ตรวจสอบ schema กับ spec file `specs/03-Data-and-Storage/lcbp3-v1.9.0-schema-02-tables.sql`
|
||||||
|
- Debug ปัญหา database โดยไม่ต้องเข้า MySQL client
|
||||||
|
- ตรวจสอบ data ใน production/staging
|
||||||
|
- Validate การเปลี่ยนแปลง schema ก่อน deploy
|
||||||
|
|
||||||
|
### Available Tools
|
||||||
|
|
||||||
|
| Tool | หน้าที่ | ตัวอย่างการใช้งาน |
|
||||||
|
|------|----------|------------------|
|
||||||
|
| `mcp1_mysql_test_connection` | ทดสอบ connection กับ database | ตรวจสอบว่า MCP server เชื่อมต่อได้ |
|
||||||
|
| `mcp1_mysql_show_databases` | แสดง databases ทั้งหมด | ดูว่ามี database อะไรบ้าง |
|
||||||
|
| `mcp1_mysql_show_tables` | แสดง tables ทั้งหมดใน database | ดูรายชื่อ tables ใน `lcbp3` |
|
||||||
|
| `mcp1_mysql_describe_table` | ดู structure/columns ของ table | ตรวจสอบ columns, types, keys ของ `correspondences` |
|
||||||
|
| `mcp1_mysql_query` | รัน SELECT query | ดู data ใน table หรือ join query |
|
||||||
|
| `mcp1_mysql_insert` | INSERT data | เพิ่ม seed data หรือ test data |
|
||||||
|
| `mcp1_mysql_update` | UPDATE data | แก้ไข data ใน table |
|
||||||
|
| `mcp1_mysql_delete` | DELETE data | ลบ data ใน table |
|
||||||
|
|
||||||
|
### การใช้งานร่วมกับ Development Flow
|
||||||
|
|
||||||
|
**เมื่อเขียน query ใหม่:**
|
||||||
|
1. ใช้ `mcp1_mysql_describe_table` เพื่อตรวจสอบ columns และ types
|
||||||
|
2. เปรียบเทียบกับ `specs/03-Data-and-Storage/lcbp3-v1.9.0-schema-02-tables.sql`
|
||||||
|
3. ใช้ `mcp1_mysql_query` เพื่อทดสอบ query ก่อน implement
|
||||||
|
|
||||||
|
**เมื่อเปลี่ยน schema (ADR-009):**
|
||||||
|
1. ใช้ `mcp1_mysql_describe_table` เพื่อดู structure ปัจจุบัน
|
||||||
|
2. สร้าง SQL delta ใน `specs/03-Data-and-Storage/deltas/`
|
||||||
|
3. ใช้ `mcp1_mysql_query` เพื่อตรวจสอบผลลัพธ์หลัง apply delta
|
||||||
|
|
||||||
|
**เมื่อ debug ปัญหา database:**
|
||||||
|
1. ใช้ `mcp1_mysql_query` เพื่อดู data จริง
|
||||||
|
2. เปรียบเทียบกับ spec และ data dictionary
|
||||||
|
3. ตรวจสอบ foreign keys และ constraints
|
||||||
|
|
||||||
|
### ข้อควรระวัง
|
||||||
|
|
||||||
|
- **❌ ห้ามใช้ MCP MariaDB สำหรับ DDL operations** (CREATE/ALTER/DROP) โดยตรง — ต้องใช้ SQL delta ตาม ADR-009
|
||||||
|
- **✅ ใช้สำหรับ DQL/DML operations** (SELECT/INSERT/UPDATE/DELETE) เพื่อ debug และ test เท่านั้น
|
||||||
|
- **⚠️ ระวัง DELETE operations** — อาจทำให้เสีย data ใน production
|
||||||
|
- **✅ ตรวจสอบ schema กับ spec file เสมอ** ก่อนเขียน query
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🧠 MCP Memory Tools
|
||||||
|
|
||||||
|
MCP Memory server ให้เครื่องมือสำหรับจัดการ Knowledge Graph และ Long-term Memory ใช้สำหรับ:
|
||||||
|
|
||||||
|
- จัดเก็บความรู้และ context ของโปรเจกต์ในรูปแบบ Graph (Entities + Relations + Observations)
|
||||||
|
- ค้นหาและดึงข้อมูล context จาก memory ที่บันทึกไว้ใน session ก่อนหน้า
|
||||||
|
- สร้าง/แก้ไข/ลบ entities, relations, และ observations ใน knowledge graph
|
||||||
|
|
||||||
|
### Available Tools
|
||||||
|
|
||||||
|
| Tool | หน้าที่ | ตัวอย่างการใช้งาน |
|
||||||
|
|------|----------|------------------|
|
||||||
|
| `mcp3_create_entities` | สร้าง entities ใหม่หลายตัวพร้อม observations | สร้าง entity ใหม่เช่น Project, User, Task |
|
||||||
|
| `mcp3_create_relations` | สร้าง relations ระหว่าง entities | สร้าง relation: Project → has → User |
|
||||||
|
| `mcp3_add_observations` | เพิ่ม observations ให้ entity ที่มีอยู่แล้ว | เพิ่ม context เพิ่มเติมให้ entity |
|
||||||
|
| `mcp3_delete_entities` | ลบ entities และ relations ที่เกี่ยวข้อง | ลบ entity ที่ไม่ใช้แล้ว |
|
||||||
|
| `mcp3_delete_relations` | ลบ relations ระหว่าง entities | ลบ relation ที่ผิดหรือไม่ใช้แล้ว |
|
||||||
|
| `mcp3_delete_observations` | ลบ observations จาก entity | ลบ context ที่ผิดหรือล้าสุด |
|
||||||
|
| `mcp3_open_nodes` | ดึงข้อมูล entities ตามชื่อ | ดึง entity ที่ระบุชื่อ |
|
||||||
|
| `mcp3_read_graph` | อ่าน knowledge graph ทั้งหมด | ดูทั้ง graph structure |
|
||||||
|
| `mcp3_search_nodes` | ค้นหา entities ตาม query | ค้นหา entity จากชื่อ, type, หรือ observation |
|
||||||
|
|
||||||
|
### การใช้งานร่วมกับ Development Flow
|
||||||
|
|
||||||
|
**เมื่อบันทึก context ใหม่:**
|
||||||
|
1. ใช้ `mcp3_create_entities` เพื่อสร้าง entities ใหม่ (ถ้ายังไม่มี)
|
||||||
|
2. ใช้ `mcp3_create_relations` เพื่อเชื่อมโยง entities
|
||||||
|
3. ใช้ `mcp3_add_observations` เพื่อเพิ่ม context/observations
|
||||||
|
|
||||||
|
**เมื่อค้นหา context:**
|
||||||
|
1. ใช้ `mcp3_search_nodes` เพื่อค้นหา entities ที่เกี่ยวข้อง
|
||||||
|
2. ใช้ `mcp3_open_nodes` เพื่อดึงข้อมูล entities ที่ต้องการ
|
||||||
|
3. ใช้ `mcp3_read_graph` เพื่อดู relations ระหว่าง entities
|
||||||
|
|
||||||
|
**เมื่อแก้ไข context:**
|
||||||
|
1. ใช้ `mcp3_add_observations` เพื่อเพิ่ม observations ใหม่
|
||||||
|
2. ใช้ `mcp3_delete_observations` เพื่อลบ observations ที่ผิด
|
||||||
|
3. ใช้ `mcp3_create_relations` หรือ `mcp3_delete_relations` เพื่อปรับ relations
|
||||||
|
|
||||||
|
### ข้อควรระวัง
|
||||||
|
|
||||||
|
- **✅ ใช้สำหรับบันทึก context ที่ต้องใช้ร่วมกันหลาย session** — เช่น การตัดสินใจสำคัญ, architecture decisions, rollout history
|
||||||
|
- **⚠️ ระวังการลบ entities** — อาจทำให้เสีย context ที่ยังใช้งานอยู่
|
||||||
|
- **✅ ตรวจสอบว่า entity มีอยู่แล้วก่อนสร้าง** — ใช้ `mcp3_search_nodes` หรือ `mcp3_open_nodes` ก่อน
|
||||||
|
- **✅ ใช้ชื่อ entity ที่ชัดเจนและไม่ซ้ำกัน** — เพื่อป้องกันความสับสน
|
||||||
|
|||||||
@@ -3,7 +3,7 @@
|
|||||||
## CRITICAL RULES
|
## CRITICAL RULES
|
||||||
|
|
||||||
- **ALWAYS** follow ADR-023 AI boundary policy (isolation on Admin Desktop)
|
- **ALWAYS** follow ADR-023 AI boundary policy (isolation on Admin Desktop)
|
||||||
- **ALWAYS** use ADR-023A 2-model stack (gemma4:e2b + nomic-embed-text)
|
- **ALWAYS** use ADR-034 model stack (typhoon2.5-np-dms:latest + typhoon-np-dms-ocr:latest + nomic-embed-text)
|
||||||
- **ALWAYS** use BullMQ 2-queue (ai-realtime + ai-batch) for GPU overload prevention
|
- **ALWAYS** use BullMQ 2-queue (ai-realtime + ai-batch) for GPU overload prevention
|
||||||
- **NEVER** allow AI direct database/storage access
|
- **NEVER** allow AI direct database/storage access
|
||||||
- **ALWAYS** implement human-in-the-loop validation
|
- **ALWAYS** implement human-in-the-loop validation
|
||||||
@@ -26,8 +26,8 @@ n8n (Migration) → DMS API → BullMQ → Admin Desktop (Ollama) → Backend Va
|
|||||||
| ----------------- | ------------------------- | ------------------------------------------------------------------------ |
|
| ----------------- | ------------------------- | ------------------------------------------------------------------------ |
|
||||||
| **AI Gateway** | Backend (NestJS) | API endpoints, validation, audit logging |
|
| **AI Gateway** | Backend (NestJS) | API endpoints, validation, audit logging |
|
||||||
| **BullMQ Queues** | Backend (NestJS) | ai-realtime (RAG/Suggest), ai-batch (OCR/Extract/Embed) |
|
| **BullMQ Queues** | Backend (NestJS) | ai-realtime (RAG/Suggest), ai-batch (OCR/Extract/Embed) |
|
||||||
| **Ollama Engine** | Admin Desktop (Desk-5439) | gemma4:e2b (LLM) + nomic-embed-text (Embedding) |
|
| **Ollama Engine** | Admin Desktop (Desk-5439) | typhoon2.5-np-dms:latest (Main LLM) + typhoon-np-dms-ocr:latest (OCR, keep_alive:0) + nomic-embed-text (Embedding) |
|
||||||
| **OCR Engine** | Admin Desktop (Desk-5439) | PaddleOCR + PyThaiNLP (Thai/English text extraction) |
|
| **OCR Engine** | Admin Desktop (Desk-5439) | Tesseract OCR + Typhoon OCR (via Ollama) + PyThaiNLP (Thai/English text extraction) |
|
||||||
| **Orchestrator** | QNAP NAS (n8n) | Migration Phase orchestrator only (calls DMS API, never Ollama directly) |
|
| **Orchestrator** | QNAP NAS (n8n) | Migration Phase orchestrator only (calls DMS API, never Ollama directly) |
|
||||||
|
|
||||||
## Backend Implementation (NestJS)
|
## Backend Implementation (NestJS)
|
||||||
@@ -76,7 +76,7 @@ export class AiService {
|
|||||||
async extractMetadata(documentId: string): Promise<AIMetadata> {
|
async extractMetadata(documentId: string): Promise<AIMetadata> {
|
||||||
// 1. Validate permissions
|
// 1. Validate permissions
|
||||||
// 2. Queue job to BullMQ (ai-batch or ai-realtime)
|
// 2. Queue job to BullMQ (ai-batch or ai-realtime)
|
||||||
// 3. Worker sends to Admin Desktop AI (gemma4:e2b)
|
// 3. Worker sends to Admin Desktop AI (typhoon2.5-np-dms:latest)
|
||||||
// 4. Validate AI response
|
// 4. Validate AI response
|
||||||
// 5. Log audit trail to ai_audit_logs
|
// 5. Log audit trail to ai_audit_logs
|
||||||
// 6. Return validated results
|
// 6. Return validated results
|
||||||
@@ -113,12 +113,12 @@ const DocumentReviewForm = ({ document, aiSuggestions }) => {
|
|||||||
- **n8n Boundary:** n8n MUST call DMS API → BullMQ, NEVER Ollama/Qdrant directly
|
- **n8n Boundary:** n8n MUST call DMS API → BullMQ, NEVER Ollama/Qdrant directly
|
||||||
- **GPU Overload Prevention:** BullMQ 2-queue (ai-realtime + ai-batch) with concurrency=1
|
- **GPU Overload Prevention:** BullMQ 2-queue (ai-realtime + ai-batch) with concurrency=1
|
||||||
|
|
||||||
## ADR-023A Specific Rules
|
## ADR-034 Model Stack (supersedes ADR-023A §2.1)
|
||||||
|
|
||||||
- **2-Model Stack:** gemma4:e2b + nomic-embed-text
|
- **3-Model Config:** typhoon2.5-np-dms:latest (Main) + typhoon-np-dms-ocr:latest (OCR, keep_alive:0) + nomic-embed-text (Embedding)
|
||||||
- **PDF 3-Page Limit:** Classification/Tagging uses first 3 pages only (NOT RAG embedding)
|
- **PDF 3-Page Limit:** Classification/Tagging uses first 3 pages only (NOT RAG embedding)
|
||||||
- **RAG Embedding:** Full document chunked at 512 tokens/64 tokens overlap
|
- **RAG Embedding:** Full document chunked at 512 tokens/64 tokens overlap
|
||||||
- **OCR Auto-Detect:** PyMuPDF chars > 100 → Fast path, else PaddleOCR
|
- **OCR Auto-Detect:** PyMuPDF chars > 100 → Fast path, else Tesseract OCR (with Typhoon OCR option)
|
||||||
- **Embed Auto-Trigger:** AUTO after commit (parallel), gap covered by DB search
|
- **Embed Auto-Trigger:** AUTO after commit (parallel), gap covered by DB search
|
||||||
- **Threshold Recalibration:** After 100-500 docs, based on ai_audit_logs analysis
|
- **Threshold Recalibration:** After 100-500 docs, based on ai_audit_logs analysis
|
||||||
|
|
||||||
@@ -129,7 +129,7 @@ const DocumentReviewForm = ({ document, aiSuggestions }) => {
|
|||||||
- [ ] BullMQ 2-queue setup (ai-realtime + ai-batch)
|
- [ ] BullMQ 2-queue setup (ai-realtime + ai-batch)
|
||||||
- [ ] QdrantService with projectPublicId enforcement
|
- [ ] QdrantService with projectPublicId enforcement
|
||||||
- [ ] DocumentReviewForm reusable component
|
- [ ] DocumentReviewForm reusable component
|
||||||
- [ ] Admin Desktop Ollama (gemma4:e2b + nomic-embed-text) + PaddleOCR setup
|
- [ ] Admin Desktop Ollama (typhoon2.5-np-dms:latest + typhoon-np-dms-ocr:latest + nomic-embed-text) setup
|
||||||
- [ ] n8n workflow orchestration (Migration Phase only)
|
- [ ] n8n workflow orchestration (Migration Phase only)
|
||||||
- [ ] AI audit logging and monitoring (ai_audit_logs)
|
- [ ] AI audit logging and monitoring (ai_audit_logs)
|
||||||
- [ ] Human-in-the-loop validation workflows
|
- [ ] Human-in-the-loop validation workflows
|
||||||
|
|||||||
@@ -42,7 +42,7 @@ init_agent_registry() {
|
|||||||
[qwen]="Qwen Code"
|
[qwen]="Qwen Code"
|
||||||
[opencode]="opencode"
|
[opencode]="opencode"
|
||||||
[codex]="Codex CLI"
|
[codex]="Codex CLI"
|
||||||
[windsurf]="Windsurf"
|
[devin]="Devin"
|
||||||
[kilocode]="Kilo Code"
|
[kilocode]="Kilo Code"
|
||||||
[auggie]="Auggie CLI"
|
[auggie]="Auggie CLI"
|
||||||
[roo]="Roo Code"
|
[roo]="Roo Code"
|
||||||
|
|||||||
@@ -99,14 +99,13 @@ find_feature_dir_by_prefix() {
|
|||||||
|
|
||||||
local prefix="${BASH_REMATCH[1]}"
|
local prefix="${BASH_REMATCH[1]}"
|
||||||
|
|
||||||
# Search for directories in specs/ that start with this prefix
|
# Search for directories in specs/ that start with this prefix (supporting subdirectories)
|
||||||
local matches=()
|
local matches=()
|
||||||
if [[ -d "$specs_dir" ]]; then
|
if [[ -d "$specs_dir" ]]; then
|
||||||
for dir in "$specs_dir"/"$prefix"-*; do
|
# ค้นหาโฟลเดอร์ที่ตรงกับ prefix ในระบบย่อย
|
||||||
if [[ -d "$dir" ]]; then
|
while IFS= read -r -d '' dir; do
|
||||||
matches+=("$(basename "$dir")")
|
matches+=("$dir")
|
||||||
fi
|
done < <(find "$specs_dir" -maxdepth 3 -type d -name "${prefix}-*" -print0 2>/dev/null)
|
||||||
done
|
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# Handle results
|
# Handle results
|
||||||
@@ -115,12 +114,12 @@ find_feature_dir_by_prefix() {
|
|||||||
echo "$specs_dir/$branch_name"
|
echo "$specs_dir/$branch_name"
|
||||||
elif [[ ${#matches[@]} -eq 1 ]]; then
|
elif [[ ${#matches[@]} -eq 1 ]]; then
|
||||||
# Exactly one match - perfect!
|
# Exactly one match - perfect!
|
||||||
echo "$specs_dir/${matches[0]}"
|
echo "${matches[0]}"
|
||||||
else
|
else
|
||||||
# Multiple matches - this shouldn't happen with proper naming convention
|
# Multiple matches - this shouldn't happen with proper naming convention
|
||||||
echo "ERROR: Multiple spec directories found with prefix '$prefix': ${matches[*]}" >&2
|
echo "ERROR: Multiple spec directories found with prefix '$prefix': ${matches[*]}" >&2
|
||||||
echo "Please ensure only one spec directory exists per numeric prefix." >&2
|
echo "Please ensure only one spec directory exists per numeric prefix." >&2
|
||||||
echo "$specs_dir/$branch_name" # Return something to avoid breaking the script
|
echo "${matches[0]}" # Return first match to avoid breaking the script
|
||||||
fi
|
fi
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -30,12 +30,12 @@
|
|||||||
#
|
#
|
||||||
# 5. Multi-Agent Support
|
# 5. Multi-Agent Support
|
||||||
# - Handles agent-specific file paths and naming conventions
|
# - Handles agent-specific file paths and naming conventions
|
||||||
# - Supports: Claude, Gemini, Copilot, Cursor, Qwen, opencode, Codex, Windsurf, Kilo Code, Auggie CLI, Roo Code, CodeBuddy CLI, Qoder CLI, Amp, SHAI, or Amazon Q Developer CLI
|
# - Supports: Claude, Gemini, Copilot, Cursor, Qwen, opencode, Codex, Devin, Kilo Code, Auggie CLI, Roo Code, CodeBuddy CLI, Qoder CLI, Amp, SHAI, or Amazon Q Developer CLI
|
||||||
# - Can update single agents or all existing agent files
|
# - Can update single agents or all existing agent files
|
||||||
# - Creates default Claude file if no agent files exist
|
# - Creates default Claude file if no agent files exist
|
||||||
#
|
#
|
||||||
# Usage: ./update-agent-context.sh [agent_type]
|
# Usage: ./update-agent-context.sh [agent_type]
|
||||||
# Agent types: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|shai|q|bob|qoder
|
# Agent types: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|devin|kilocode|auggie|shai|q|bob|qoder
|
||||||
# Leave empty to update all existing agent files
|
# Leave empty to update all existing agent files
|
||||||
|
|
||||||
set -e
|
set -e
|
||||||
@@ -609,8 +609,8 @@ update_specific_agent() {
|
|||||||
codex)
|
codex)
|
||||||
update_agent_file "$AGENTS_FILE" "Codex CLI"
|
update_agent_file "$AGENTS_FILE" "Codex CLI"
|
||||||
;;
|
;;
|
||||||
windsurf)
|
devin)
|
||||||
update_agent_file "$WINDSURF_FILE" "Windsurf"
|
update_agent_file "$DEVIN_FILE" "Devin"
|
||||||
;;
|
;;
|
||||||
kilocode)
|
kilocode)
|
||||||
update_agent_file "$KILOCODE_FILE" "Kilo Code"
|
update_agent_file "$KILOCODE_FILE" "Kilo Code"
|
||||||
@@ -681,8 +681,8 @@ update_all_existing_agents() {
|
|||||||
found_agent=true
|
found_agent=true
|
||||||
fi
|
fi
|
||||||
|
|
||||||
if [[ -f "$WINDSURF_FILE" ]]; then
|
if [[ -f "$DEVIN_FILE" ]]; then
|
||||||
update_agent_file "$WINDSURF_FILE" "Windsurf"
|
update_agent_file "$DEVIN_FILE" "Devin"
|
||||||
found_agent=true
|
found_agent=true
|
||||||
fi
|
fi
|
||||||
|
|
||||||
|
|||||||
+15
-16
@@ -1,8 +1,8 @@
|
|||||||
# `.agents/skills/` — LCBP3 Agent Skill Pack
|
# `.agents/skills/` — LCBP3 Agent Skill Pack
|
||||||
|
|
||||||
**Version:** 1.9.0 | **Last Updated:** 2026-05-17 | **Total Skills:** 23
|
**Version:** 1.9.0 | **Last Updated:** 2026-06-07 | **Total Skills:** 24
|
||||||
|
|
||||||
Agent skills for AI-assisted development in **Windsurf IDE** (and compatible agents: Codex CLI, opencode, Amp, Antigravity, AGENTS.md-aware tools).
|
Agent skills for AI-assisted development in **Devin IDE** (and compatible agents: Codex CLI, opencode, Amp, Antigravity, AGENTS.md-aware tools).
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -14,6 +14,7 @@ Agent skills for AI-assisted development in **Windsurf IDE** (and compatible age
|
|||||||
├── skills.md # Overview + dependency matrix + health monitoring
|
├── skills.md # Overview + dependency matrix + health monitoring
|
||||||
├── _LCBP3-CONTEXT.md # Shared LCBP3 context injected into every speckit-* skill
|
├── _LCBP3-CONTEXT.md # Shared LCBP3 context injected into every speckit-* skill
|
||||||
├── README.md # (this file)
|
├── README.md # (this file)
|
||||||
|
├── save-memory/ # Session log & project memory update
|
||||||
├── nestjs-best-practices/ # Backend rules (40 rules across 10 categories)
|
├── nestjs-best-practices/ # Backend rules (40 rules across 10 categories)
|
||||||
├── next-best-practices/ # Frontend rules (Next.js 15+)
|
├── next-best-practices/ # Frontend rules (Next.js 15+)
|
||||||
├── e2e-testing/ # Playwright E2E testing patterns (POM, flaky tests, CI/CD)
|
├── e2e-testing/ # Playwright E2E testing patterns (POM, flaky tests, CI/CD)
|
||||||
@@ -30,12 +31,10 @@ Each skill directory contains:
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🚀 How Windsurf Invokes These Skills
|
## 🚀 How Devin Invokes These Skills
|
||||||
|
|
||||||
Windsurf exposes two entry points:
|
1. **Skill tool** — Devin discovers skills by scanning `.agents/skills/*/SKILL.md` frontmatter. Skills marked `user-invocable: false` are used silently by Cascade.
|
||||||
|
2. **Slash commands** — `.devin/workflows/*.md` wraps each skill as a slash command (e.g. `/04-speckit.plan`). The workflow file is short; the heavy lifting is delegated to the skill via `skill` tool.
|
||||||
1. **Skill tool** — Windsurf discovers skills by scanning `.agents/skills/*/SKILL.md` frontmatter. Skills marked `user-invocable: false` are used silently by Cascade.
|
|
||||||
2. **Slash commands** — `.windsurf/workflows/*.md` wraps each skill as a slash command (e.g. `/04-speckit.plan`). The workflow file is short; the heavy lifting is delegated to the skill via `skill` tool.
|
|
||||||
|
|
||||||
Both paths end up executing the same `SKILL.md` instructions.
|
Both paths end up executing the same `SKILL.md` instructions.
|
||||||
|
|
||||||
@@ -65,14 +64,14 @@ Use `/00-speckit.all` to run specify → clarify → plan → tasks → analyze
|
|||||||
|
|
||||||
From repo root:
|
From repo root:
|
||||||
|
|
||||||
| Script | Purpose |
|
| Script | Purpose |
|
||||||
| --------------------------------------------------------- | ----------------------------------------------------------- |
|
| ------------------------------------------------------ | ---------------------------------------------------------- |
|
||||||
| `./.agents/scripts/bash/check-prerequisites.sh --json` | Emit `FEATURE_DIR` + `AVAILABLE_DOCS` for a feature branch |
|
| `./.agents/scripts/bash/check-prerequisites.sh --json` | Emit `FEATURE_DIR` + `AVAILABLE_DOCS` for a feature branch |
|
||||||
| `./.agents/scripts/bash/setup-plan.sh --json` | Emit `FEATURE_SPEC`, `IMPL_PLAN`, `SPECS_DIR`, `BRANCH` |
|
| `./.agents/scripts/bash/setup-plan.sh --json` | Emit `FEATURE_SPEC`, `IMPL_PLAN`, `SPECS_DIR`, `BRANCH` |
|
||||||
| `./.agents/scripts/bash/update-agent-context.sh windsurf` | Append tech entries to `AGENTS.md` |
|
| `./.agents/scripts/bash/update-agent-context.sh devin` | Append tech entries to `AGENTS.md` |
|
||||||
| `./.agents/scripts/bash/audit-skills.sh` | Validate all `SKILL.md` frontmatter + presence |
|
| `./.agents/scripts/bash/audit-skills.sh` | Validate all `SKILL.md` frontmatter + presence |
|
||||||
| `./.agents/scripts/bash/validate-versions.sh` | Version consistency check |
|
| `./.agents/scripts/bash/validate-versions.sh` | Version consistency check |
|
||||||
| `./.agents/scripts/bash/sync-workflows.sh` | Verify every skill has a `.windsurf/workflows/*.md` wrapper |
|
| `./.agents/scripts/bash/sync-workflows.sh` | Verify every skill has a `.devin/workflows/*.md` wrapper |
|
||||||
|
|
||||||
All scripts mirror to `.agents/scripts/powershell/*.ps1` for Windows.
|
All scripts mirror to `.agents/scripts/powershell/*.ps1` for Windows.
|
||||||
|
|
||||||
@@ -97,7 +96,7 @@ To add a new skill:
|
|||||||
|
|
||||||
1. Create `NAME/SKILL.md` with frontmatter: `name`, `description`, `version: 1.9.0`, `scope`, `depends-on`.
|
1. Create `NAME/SKILL.md` with frontmatter: `name`, `description`, `version: 1.9.0`, `scope`, `depends-on`.
|
||||||
2. Append an LCBP3 context reference pointing to `_LCBP3-CONTEXT.md`.
|
2. Append an LCBP3 context reference pointing to `_LCBP3-CONTEXT.md`.
|
||||||
3. Wrap with `.windsurf/workflows/NAME.md` so it becomes a slash command.
|
3. Wrap with `.devin/workflows/NAME.md` so it becomes a slash command.
|
||||||
4. Update [`skills.md`](./skills.md) dependency matrix.
|
4. Update [`skills.md`](./skills.md) dependency matrix.
|
||||||
5. Run `./.agents/scripts/bash/audit-skills.sh` → must pass.
|
5. Run `./.agents/scripts/bash/audit-skills.sh` → must pass.
|
||||||
|
|
||||||
|
|||||||
@@ -6454,7 +6454,7 @@ CREATE TABLE ai_audit_log (
|
|||||||
user_id INT NOT NULL,
|
user_id INT NOT NULL,
|
||||||
action VARCHAR(64) NOT NULL, -- 'ai.extract_metadata', 'ai.classify', etc.
|
action VARCHAR(64) NOT NULL, -- 'ai.extract_metadata', 'ai.classify', etc.
|
||||||
file_id INT,
|
file_id INT,
|
||||||
model VARCHAR(64), -- 'gemma-4:7b', 'paddleocr-v3'
|
model VARCHAR(64), -- 'gemma-4:7b', 'typhoon-np-dms-ocr', 'tesseract-ocr'
|
||||||
confidence DECIMAL(4,3),
|
confidence DECIMAL(4,3),
|
||||||
input_hash CHAR(64), -- SHA-256 of input for replay detection
|
input_hash CHAR(64), -- SHA-256 of input for replay detection
|
||||||
output_summary JSON,
|
output_summary JSON,
|
||||||
|
|||||||
@@ -137,7 +137,7 @@ CREATE TABLE ai_audit_log (
|
|||||||
user_id INT NOT NULL,
|
user_id INT NOT NULL,
|
||||||
action VARCHAR(64) NOT NULL, -- 'ai.extract_metadata', 'ai.classify', etc.
|
action VARCHAR(64) NOT NULL, -- 'ai.extract_metadata', 'ai.classify', etc.
|
||||||
file_id INT,
|
file_id INT,
|
||||||
model VARCHAR(64), -- 'gemma-4:7b', 'paddleocr-v3'
|
model VARCHAR(64), -- 'gemma-4:7b', 'typhoon-np-dms-ocr', 'tesseract-ocr'
|
||||||
confidence DECIMAL(4,3),
|
confidence DECIMAL(4,3),
|
||||||
input_hash CHAR(64), -- SHA-256 of input for replay detection
|
input_hash CHAR(64), -- SHA-256 of input for replay detection
|
||||||
output_summary JSON,
|
output_summary JSON,
|
||||||
|
|||||||
@@ -0,0 +1,198 @@
|
|||||||
|
---
|
||||||
|
name: save-memory
|
||||||
|
description: บันทึก session log และอัปเดต project memory ตามโครงสร้างใหม่
|
||||||
|
version: 1.9.0
|
||||||
|
scope: project-management
|
||||||
|
depends-on: []
|
||||||
|
user-invocable: true
|
||||||
|
---
|
||||||
|
|
||||||
|
# บันทึก Memory (Save Memory)
|
||||||
|
|
||||||
|
Skill นี้ใช้สำหรับบันทึก session log และอัปเดต project memory ตามโครงสร้างใหม่ที่ reorganization แล้ว
|
||||||
|
|
||||||
|
## โครงสร้าง Memory ใหม่
|
||||||
|
|
||||||
|
```
|
||||||
|
memory/
|
||||||
|
├── README.md (index + overview)
|
||||||
|
├── mcp-tools.md (MCP MariaDB + Memory Tools)
|
||||||
|
└── project-memory-override.md (OS rules, Current Decisions, Environment, Next Session Focus)
|
||||||
|
|
||||||
|
specs/88-logs/
|
||||||
|
├── rollouts.md (Recent rollouts table)
|
||||||
|
└── session-YYYY-MM-DD-[topic].md (Session logs)
|
||||||
|
```
|
||||||
|
|
||||||
|
## ขั้นตอนการบันทึก Memory
|
||||||
|
|
||||||
|
### 1. สร้าง Session Log (ถ้ามีงาน session ใหม่)
|
||||||
|
|
||||||
|
เมื่อทำงาน session ใหม่ให้:
|
||||||
|
|
||||||
|
1. **สร้างไฟล์ session log ใหม่** ใน `specs/88-logs/`
|
||||||
|
- ชื่อไฟล์: `session-YYYY-MM-DD-[topic].md`
|
||||||
|
- ตัวอย่าง: `session-2026-06-07-memory-reorganization.md`
|
||||||
|
|
||||||
|
2. **บันทึกเนื้อหาใน session log**:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Session [N] — YYYY-MM-DD ([Topic])
|
||||||
|
|
||||||
|
## Summary
|
||||||
|
|
||||||
|
[สรุปสิ่งที่ทำใน session นี้]
|
||||||
|
|
||||||
|
## ปัญหาที่พบ (Root Cause)
|
||||||
|
|
||||||
|
[อธิบายปัญหาและสาเหตุ]
|
||||||
|
|
||||||
|
## การแก้ไข (Fix)
|
||||||
|
|
||||||
|
| ไฟล์ | การเปลี่ยนแปลง |
|
||||||
|
| -------------- | ---------------------- |
|
||||||
|
| [path/to/file] | [อธิบายการเปลี่ยนแปลง] |
|
||||||
|
|
||||||
|
## กฎที่ Lock แล้ว
|
||||||
|
|
||||||
|
[บันทึก pattern หรือ decision ที่ตกลง]
|
||||||
|
|
||||||
|
## Verification
|
||||||
|
|
||||||
|
[วิธีตรวจสอบว่างานสำเร็จ]
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **อัปเดต `specs/88-logs/rollouts.md`**
|
||||||
|
- เพิ่ม entry ใหม่ในตาราง Recent Rollouts
|
||||||
|
- รูปแบบ: `| วันที่ | Version | รายการ | สถานะ |`
|
||||||
|
|
||||||
|
### 2. อัปเดต Project Memory (ถ้ามี decision ใหม่)
|
||||||
|
|
||||||
|
เมื่อมีการตัดสินใจสำคัญใหม่ให้:
|
||||||
|
|
||||||
|
1. **เปิดไฟล์ `memory/project-memory-override.md`**
|
||||||
|
|
||||||
|
2. **อัปเดตตาราง "Current Decisions (Locked)"**
|
||||||
|
- เพิ่ม entry ใหม่ถ้ามี decision ใหม่
|
||||||
|
- รูปแบบ: `| ID | Decision | ADR |`
|
||||||
|
|
||||||
|
3. **อัปเดต "Next Session Focus"**
|
||||||
|
- เพิ่มงานใหม่ถ้ามี
|
||||||
|
- ทำเครื่องหมาย `[ ]` สำหรับงานที่ยังไม่เสร็จ
|
||||||
|
- ทำเครื่องหมาย `[X]` สำหรับงานที่เสร็จแล้ว
|
||||||
|
|
||||||
|
4. **อัปเดต "Environment & Services"** (ถ้ามีการเปลี่ยนแปลง)
|
||||||
|
- อัปเดต URL, port, หรือ notes ถ้ามีการเปลี่ยน infrastructure
|
||||||
|
|
||||||
|
### 3. อัปเดต MCP Tools (ถ้ามี tools ใหม่)
|
||||||
|
|
||||||
|
เมื่อมี MCP tools ใหม่ให้:
|
||||||
|
|
||||||
|
1. **เปิดไฟล์ `memory/mcp-tools.md`**
|
||||||
|
|
||||||
|
2. **เพิ่ม tool ใหม่ในตาราง "Available Tools"**
|
||||||
|
- รูปแบบ: `| Tool | Purpose | Example Usage |`
|
||||||
|
|
||||||
|
3. **เพิ่ม usage example และ warnings** ถ้าจำเป็น
|
||||||
|
|
||||||
|
### 4. อัปเดต Root Documentation (ถ้ามีการเปลี่ยนแปลง)
|
||||||
|
|
||||||
|
เมื่อมีการเปลี่ยนแปลงที่ส่งผลต่อเอกสารระดับ root ให้:
|
||||||
|
|
||||||
|
1. **ARCHITECTURE.md** — อัปเดตเมื่อ:
|
||||||
|
- เปลี่ยน architecture หลัก
|
||||||
|
- เพิ่ม/ลบ component สำคัญ
|
||||||
|
- เปลี่ยน data flow หรือ integration pattern
|
||||||
|
|
||||||
|
2. **CHANGELOG.md** — อัปเดตเมื่อ:
|
||||||
|
- Deploy version ใหม่
|
||||||
|
- เพิ่ม feature หรือ breaking change สำคัญ
|
||||||
|
- รูปแบบ: `## [version] (YYYY-MM-DD)` → `### feat(scope): description`
|
||||||
|
|
||||||
|
3. **CONTEXT.md** — อัปเดตเมื่อ:
|
||||||
|
- เปลี่ยน domain terminology หลัก
|
||||||
|
- เพิ่ม concept ใหม่ที่ใช้ทั่ว project
|
||||||
|
- อัปเดต glossary หรือ business rules
|
||||||
|
|
||||||
|
4. **CONTRIBUTING.md** — อัปเดตเมื่อ:
|
||||||
|
- เปลี่ยน workflow การทำงาน
|
||||||
|
- เพิ่ม/เปลี่ยน coding standards
|
||||||
|
- อัปเดต CI/CD process
|
||||||
|
|
||||||
|
5. **README.md** — อัปเดตเมื่อ:
|
||||||
|
- เปลี่ยน project structure
|
||||||
|
- เพิ่ม/เปลี่ยน installation steps
|
||||||
|
- อัปเดต feature overview หรือ tech stack
|
||||||
|
|
||||||
|
## Template สำหรับ Session Log
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Session [N] — YYYY-MM-DD ([Topic])
|
||||||
|
|
||||||
|
## Summary
|
||||||
|
|
||||||
|
[สรุปสิ่งที่ทำใน session นี้ใน 1-2 ประโยค]
|
||||||
|
|
||||||
|
## ปัญหาที่พบ (Root Cause)
|
||||||
|
|
||||||
|
[อธิบายปัญหาและสาเหตุหลัก]
|
||||||
|
|
||||||
|
## การแก้ไข (Fix)
|
||||||
|
|
||||||
|
| ไฟล์ | การเปลี่ยนแปลง |
|
||||||
|
| -------------- | ---------------------- |
|
||||||
|
| `path/to/file` | [อธิบายการเปลี่ยนแปลง] |
|
||||||
|
|
||||||
|
## กฎที่ Lock แล้ว
|
||||||
|
|
||||||
|
[บันทึก pattern หรือ decision ที่ตกลงและไม่ควรเปลี่ยน]
|
||||||
|
|
||||||
|
## Verification
|
||||||
|
|
||||||
|
- [ ] [check 1]
|
||||||
|
- [ ] [check 2]
|
||||||
|
```
|
||||||
|
|
||||||
|
## ข้อควรระวัง
|
||||||
|
|
||||||
|
- **ห้าม** บันทึก rules ที่ซ้ำกับ specs/ (ADRs, glossary, guidelines)
|
||||||
|
- **ห้าม** บันทึก commands ที่ซ้ำกับ specs/05-Engineering-Guidelines/
|
||||||
|
- **ห้าม** บันทึก environment ที่ซ้ำกับ specs/04-Infrastructure-OPS/
|
||||||
|
- **ใช้** `specs/88-logs/` สำหรับ session history และ rollouts
|
||||||
|
- **ใช้** `memory/project-memory-override.md` สำหรับ OS rules, decisions, environment ที่ไม่มีใน specs
|
||||||
|
- **ใช้** `memory/mcp-tools.md` สำหรับ MCP tools documentation
|
||||||
|
- **อัปเดต Root Documentation** (ARCHITECTURE.md, CHANGELOG.md, CONTEXT.md, CONTRIBUTING.md, README.md) เฉพาะเมื่อมีการเปลี่ยนแปลงที่ส่งผลต่อ project architecture, version, terminology, workflow หรือ structure
|
||||||
|
|
||||||
|
## ตัวอย่างการใช้งาน
|
||||||
|
|
||||||
|
### กรณีที่ 1: ทำงาน session ใหม่
|
||||||
|
|
||||||
|
```
|
||||||
|
1. สร้างไฟล์ specs/88-logs/session-2026-06-07-bug-fix.md
|
||||||
|
2. บันทึกปัญหา, การแก้ไข, verification
|
||||||
|
3. อัปเดต specs/88-logs/rollouts.md
|
||||||
|
```
|
||||||
|
|
||||||
|
### กรณีที่ 2: มี decision ใหม่
|
||||||
|
|
||||||
|
```
|
||||||
|
1. เปิด memory/project-memory-override.md
|
||||||
|
2. เพิ่ม entry ใหม่ในตาราง Current Decisions
|
||||||
|
3. อัปเดต Next Session Focus
|
||||||
|
```
|
||||||
|
|
||||||
|
### กรณีที่ 3: เปลี่ยน infrastructure
|
||||||
|
|
||||||
|
```
|
||||||
|
1. เปิด memory/project-memory-override.md
|
||||||
|
2. อัปเดตตาราง Environment & Services
|
||||||
|
3. อัปเดต Key Environment Variables ถ้าจำเป็น
|
||||||
|
```
|
||||||
|
|
||||||
|
### กรณีที่ 4: อัปเดต Root Documentation
|
||||||
|
|
||||||
|
```
|
||||||
|
1. ตรวจสอบว่ามีการเปลี่ยนแปลงที่ส่งผลต่อ ARCHITECTURE.md, CHANGELOG.md, CONTEXT.md, CONTRIBUTING.md, หรือ README.md
|
||||||
|
2. อัปเดตไฟล์ที่เกี่ยวข้องตามรูปแบบที่กำหนด
|
||||||
|
3. ตรวจสอบว่าการเปลี่ยนแปลงสอดคล้องกับ specs/ และ ADRs
|
||||||
|
```
|
||||||
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
ไฟล์นี้กำหนดทักษะและความสามารถเฉพาะทางของ Document Intelligence Engine สำหรับโครงการ LCBP3 v1.9.0 เพื่อรักษามาตรฐานสูงสุดด้าน Security และ Data Integrity
|
ไฟล์นี้กำหนดทักษะและความสามารถเฉพาะทางของ Document Intelligence Engine สำหรับโครงการ LCBP3 v1.9.0 เพื่อรักษามาตรฐานสูงสุดด้าน Security และ Data Integrity
|
||||||
|
|
||||||
**Status**: Production Ready | **Last Updated**: 2026-05-17 | **Total Skills**: 23
|
**Status**: Production Ready | **Last Updated**: 2026-06-07 | **Total Skills**: 24
|
||||||
|
|
||||||
> 📌 Shared context for all speckit-\* skills: see [`_LCBP3-CONTEXT.md`](./_LCBP3-CONTEXT.md).
|
> 📌 Shared context for all speckit-\* skills: see [`_LCBP3-CONTEXT.md`](./_LCBP3-CONTEXT.md).
|
||||||
|
|
||||||
@@ -76,6 +76,7 @@
|
|||||||
| **speckit-status** | None | None | Progress tracking |
|
| **speckit-status** | None | None | Progress tracking |
|
||||||
| **speckit-taskstoissues** | speckit-tasks | None | Issue sync |
|
| **speckit-taskstoissues** | speckit-tasks | None | Issue sync |
|
||||||
| **speckit-checklist** | speckit-plan | None | Requirements validation |
|
| **speckit-checklist** | speckit-plan | None | Requirements validation |
|
||||||
|
| **save-memory** | None | None | Session log & memory update |
|
||||||
| **nestjs-best-practices** | None | speckit-implement | Backend patterns |
|
| **nestjs-best-practices** | None | speckit-implement | Backend patterns |
|
||||||
| **next-best-practices** | None | speckit-implement | Frontend patterns |
|
| **next-best-practices** | None | speckit-implement | Frontend patterns |
|
||||||
| **speckit-security-audit** | None | speckit-reviewer | Security validation |
|
| **speckit-security-audit** | None | speckit-reviewer | Security validation |
|
||||||
@@ -99,7 +100,7 @@
|
|||||||
|
|
||||||
### Health Metrics
|
### Health Metrics
|
||||||
|
|
||||||
- **Total Skills**: 23 implemented
|
- **Total Skills**: 24 implemented
|
||||||
- **Version Alignment**: v1.9.0 across all skills
|
- **Version Alignment**: v1.9.0 across all skills
|
||||||
- **Template Coverage**: 100% for skills requiring templates
|
- **Template Coverage**: 100% for skills requiring templates
|
||||||
- **Documentation**: Complete front matter + shared `_LCBP3-CONTEXT.md` appendix
|
- **Documentation**: Complete front matter + shared `_LCBP3-CONTEXT.md` appendix
|
||||||
|
|||||||
@@ -0,0 +1,11 @@
|
|||||||
|
---
|
||||||
|
description: บันทึก session log และอัปเดต project memory
|
||||||
|
---
|
||||||
|
|
||||||
|
# บันทึก Memory
|
||||||
|
|
||||||
|
ใช้ skill `save-memory` เพื่อบันทึก session log และอัปเดต project memory ตามโครงสร้างใหม่
|
||||||
|
|
||||||
|
```bash
|
||||||
|
skill save-memory
|
||||||
|
```
|
||||||
@@ -4,8 +4,8 @@ trigger: always_on
|
|||||||
|
|
||||||
# NAP-DMS Project Context & Rules
|
# NAP-DMS Project Context & Rules
|
||||||
|
|
||||||
- For: Windsurf Cascade (and compatible: Codex CLI, opencode, Amp, Antigravity, AGENTS.md tools)
|
- For: Devin Cascade (and compatible: Codex CLI, opencode, Amp, Antigravity, AGENTS.md tools)
|
||||||
- Version: 1.9.6 | Last synced from repo: 2026-05-22
|
- Version: 1.9.10 | Last synced from repo: 2026-06-06
|
||||||
- Repo: [https://git.np-dms.work/np-dms/lcbp3](https://git.np-dms.work/np-dms/lcbp3)
|
- Repo: [https://git.np-dms.work/np-dms/lcbp3](https://git.np-dms.work/np-dms/lcbp3)
|
||||||
- Skill pack: `.agents/skills/` (v1.9.0, 21 skills) — see [`skills/README.md`](./.agents/skills/README.md) + [`skills/_LCBP3-CONTEXT.md`](./.agents/skills/_LCBP3-CONTEXT.md)
|
- Skill pack: `.agents/skills/` (v1.9.0, 21 skills) — see [`skills/README.md`](./.agents/skills/README.md) + [`skills/_LCBP3-CONTEXT.md`](./.agents/skills/_LCBP3-CONTEXT.md)
|
||||||
|
|
||||||
@@ -116,3 +116,99 @@ trigger: always_on
|
|||||||
| "แก้ bug / bugfix" | `.agents/workflows/bugfix.md`, `error-catalog.md` | ใช้ bugfix workflow สำหรับเคสที่สาเหตุชัดเจน |
|
| "แก้ bug / bugfix" | `.agents/workflows/bugfix.md`, `error-catalog.md` | ใช้ bugfix workflow สำหรับเคสที่สาเหตุชัดเจน |
|
||||||
| "ตรวจแอปจริง" | `.windsurf/workflows/check-real-app.md` | ตรวจ endpoint/UI/console หลัง build pass — No Fake Evidence |
|
| "ตรวจแอปจริง" | `.windsurf/workflows/check-real-app.md` | ตรวจ endpoint/UI/console หลัง build pass — No Fake Evidence |
|
||||||
| "งานค้าง / resume" | `.windsurf/workflows/resume-pending-work.md` | อ่าน checkpoint เดิม → ตรวจ build → วางแผนต่อโดยไม่ทำงานซ้ำ |
|
| "งานค้าง / resume" | `.windsurf/workflows/resume-pending-work.md` | อ่าน checkpoint เดิม → ตรวจ build → วางแผนต่อโดยไม่ทำงานซ้ำ |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔌 MCP MariaDB Tools
|
||||||
|
|
||||||
|
MCP MariaDB server ให้เครื่องมือสำหรับตรวจสอบและจัดการ database โดยตรง ใช้สำหรับ:
|
||||||
|
|
||||||
|
- ตรวจสอบ schema กับ spec file `specs/03-Data-and-Storage/lcbp3-v1.9.0-schema-02-tables.sql`
|
||||||
|
- Debug ปัญหา database โดยไม่ต้องเข้า MySQL client
|
||||||
|
- ตรวจสอบ data ใน production/staging
|
||||||
|
- Validate การเปลี่ยนแปลง schema ก่อน deploy
|
||||||
|
|
||||||
|
### Available Tools
|
||||||
|
|
||||||
|
| Tool | หน้าที่ | ตัวอย่างการใช้งาน |
|
||||||
|
|------|----------|------------------|
|
||||||
|
| `mcp1_mysql_test_connection` | ทดสอบ connection กับ database | ตรวจสอบว่า MCP server เชื่อมต่อได้ |
|
||||||
|
| `mcp1_mysql_show_databases` | แสดง databases ทั้งหมด | ดูว่ามี database อะไรบ้าง |
|
||||||
|
| `mcp1_mysql_show_tables` | แสดง tables ทั้งหมดใน database | ดูรายชื่อ tables ใน `lcbp3` |
|
||||||
|
| `mcp1_mysql_describe_table` | ดู structure/columns ของ table | ตรวจสอบ columns, types, keys ของ `correspondences` |
|
||||||
|
| `mcp1_mysql_query` | รัน SELECT query | ดู data ใน table หรือ join query |
|
||||||
|
| `mcp1_mysql_insert` | INSERT data | เพิ่ม seed data หรือ test data |
|
||||||
|
| `mcp1_mysql_update` | UPDATE data | แก้ไข data ใน table |
|
||||||
|
| `mcp1_mysql_delete` | DELETE data | ลบ data ใน table |
|
||||||
|
|
||||||
|
### การใช้งานร่วมกับ Development Flow
|
||||||
|
|
||||||
|
**เมื่อเขียน query ใหม่:**
|
||||||
|
1. ใช้ `mcp1_mysql_describe_table` เพื่อตรวจสอบ columns และ types
|
||||||
|
2. เปรียบเทียบกับ `specs/03-Data-and-Storage/lcbp3-v1.9.0-schema-02-tables.sql`
|
||||||
|
3. ใช้ `mcp1_mysql_query` เพื่อทดสอบ query ก่อน implement
|
||||||
|
|
||||||
|
**เมื่อเปลี่ยน schema (ADR-009):**
|
||||||
|
1. ใช้ `mcp1_mysql_describe_table` เพื่อดู structure ปัจจุบัน
|
||||||
|
2. สร้าง SQL delta ใน `specs/03-Data-and-Storage/deltas/`
|
||||||
|
3. ใช้ `mcp1_mysql_query` เพื่อตรวจสอบผลลัพธ์หลัง apply delta
|
||||||
|
|
||||||
|
**เมื่อ debug ปัญหา database:**
|
||||||
|
1. ใช้ `mcp1_mysql_query` เพื่อดู data จริง
|
||||||
|
2. เปรียบเทียบกับ spec และ data dictionary
|
||||||
|
3. ตรวจสอบ foreign keys และ constraints
|
||||||
|
|
||||||
|
### ข้อควรระวัง
|
||||||
|
|
||||||
|
- **❌ ห้ามใช้ MCP MariaDB สำหรับ DDL operations** (CREATE/ALTER/DROP) โดยตรง — ต้องใช้ SQL delta ตาม ADR-009
|
||||||
|
- **✅ ใช้สำหรับ DQL/DML operations** (SELECT/INSERT/UPDATE/DELETE) เพื่อ debug และ test เท่านั้น
|
||||||
|
- **⚠️ ระวัง DELETE operations** — อาจทำให้เสีย data ใน production
|
||||||
|
- **✅ ตรวจสอบ schema กับ spec file เสมอ** ก่อนเขียน query
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🧠 MCP Memory Tools
|
||||||
|
|
||||||
|
MCP Memory server ให้เครื่องมือสำหรับจัดการ Knowledge Graph และ Long-term Memory ใช้สำหรับ:
|
||||||
|
|
||||||
|
- จัดเก็บความรู้และ context ของโปรเจกต์ในรูปแบบ Graph (Entities + Relations + Observations)
|
||||||
|
- ค้นหาและดึงข้อมูล context จาก memory ที่บันทึกไว้ใน session ก่อนหน้า
|
||||||
|
- สร้าง/แก้ไข/ลบ entities, relations, และ observations ใน knowledge graph
|
||||||
|
|
||||||
|
### Available Tools
|
||||||
|
|
||||||
|
| Tool | หน้าที่ | ตัวอย่างการใช้งาน |
|
||||||
|
|------|----------|------------------|
|
||||||
|
| `mcp3_create_entities` | สร้าง entities ใหม่หลายตัวพร้อม observations | สร้าง entity ใหม่เช่น Project, User, Task |
|
||||||
|
| `mcp3_create_relations` | สร้าง relations ระหว่าง entities | สร้าง relation: Project → has → User |
|
||||||
|
| `mcp3_add_observations` | เพิ่ม observations ให้ entity ที่มีอยู่แล้ว | เพิ่ม context เพิ่มเติมให้ entity |
|
||||||
|
| `mcp3_delete_entities` | ลบ entities และ relations ที่เกี่ยวข้อง | ลบ entity ที่ไม่ใช้แล้ว |
|
||||||
|
| `mcp3_delete_relations` | ลบ relations ระหว่าง entities | ลบ relation ที่ผิดหรือไม่ใช้แล้ว |
|
||||||
|
| `mcp3_delete_observations` | ลบ observations จาก entity | ลบ context ที่ผิดหรือล้าสุด |
|
||||||
|
| `mcp3_open_nodes` | ดึงข้อมูล entities ตามชื่อ | ดึง entity ที่ระบุชื่อ |
|
||||||
|
| `mcp3_read_graph` | อ่าน knowledge graph ทั้งหมด | ดูทั้ง graph structure |
|
||||||
|
| `mcp3_search_nodes` | ค้นหา entities ตาม query | ค้นหา entity จากชื่อ, type, หรือ observation |
|
||||||
|
|
||||||
|
### การใช้งานร่วมกับ Development Flow
|
||||||
|
|
||||||
|
**เมื่อบันทึก context ใหม่:**
|
||||||
|
1. ใช้ `mcp3_create_entities` เพื่อสร้าง entities ใหม่ (ถ้ายังไม่มี)
|
||||||
|
2. ใช้ `mcp3_create_relations` เพื่อเชื่อมโยง entities
|
||||||
|
3. ใช้ `mcp3_add_observations` เพื่อเพิ่ม context/observations
|
||||||
|
|
||||||
|
**เมื่อค้นหา context:**
|
||||||
|
1. ใช้ `mcp3_search_nodes` เพื่อค้นหา entities ที่เกี่ยวข้อง
|
||||||
|
2. ใช้ `mcp3_open_nodes` เพื่อดึงข้อมูล entities ที่ต้องการ
|
||||||
|
3. ใช้ `mcp3_read_graph` เพื่อดู relations ระหว่าง entities
|
||||||
|
|
||||||
|
**เมื่อแก้ไข context:**
|
||||||
|
1. ใช้ `mcp3_add_observations` เพื่อเพิ่ม observations ใหม่
|
||||||
|
2. ใช้ `mcp3_delete_observations` เพื่อลบ observations ที่ผิด
|
||||||
|
3. ใช้ `mcp3_create_relations` หรือ `mcp3_delete_relations` เพื่อปรับ relations
|
||||||
|
|
||||||
|
### ข้อควรระวัง
|
||||||
|
|
||||||
|
- **✅ ใช้สำหรับบันทึก context ที่ต้องใช้ร่วมกันหลาย session** — เช่น การตัดสินใจสำคัญ, architecture decisions, rollout history
|
||||||
|
- **⚠️ ระวังการลบ entities** — อาจทำให้เสีย context ที่ยังใช้งานอยู่
|
||||||
|
- **✅ ตรวจสอบว่า entity มีอยู่แล้วก่อนสร้าง** — ใช้ `mcp3_search_nodes` หรือ `mcp3_open_nodes` ก่อน
|
||||||
|
- **✅ ใช้ชื่อ entity ที่ชัดเจนและไม่ซ้ำกัน** — เพื่อป้องกันความสับสน
|
||||||
@@ -0,0 +1,30 @@
|
|||||||
|
# lcbp3 Development Guidelines
|
||||||
|
|
||||||
|
Auto-generated from all feature plans. Last updated: 2026-05-30
|
||||||
|
|
||||||
|
## Active Technologies
|
||||||
|
|
||||||
|
- TypeScript 5.x (NestJS 11 backend, Next.js 16 frontend), Python 3.11 (OCR sidecar)
|
||||||
|
+ Ollama (AI runtime), BullMQ (job queues), TypeORM (ORM), Redis (caching/locks), MariaDB 11.8 (database)
|
||||||
|
(232-typhoon-ocr-integration)
|
||||||
|
|
||||||
|
## Project Structure
|
||||||
|
|
||||||
|
```text
|
||||||
|
backend/
|
||||||
|
frontend/
|
||||||
|
tests/
|
||||||
|
```
|
||||||
|
|
||||||
|
## Commands
|
||||||
|
|
||||||
|
cd src [ONLY COMMANDS FOR ACTIVE TECHNOLOGIES][ONLY COMMANDS FOR ACTIVE TECHNOLOGIES] pytest [ONLY COMMANDS FOR ACTIVE TECHNOLOGIES][ONLY COMMANDS FOR ACTIVE TECHNOLOGIES] ruff check .
|
||||||
|
|
||||||
|
## Code Style
|
||||||
|
|
||||||
|
TypeScript 5.x (NestJS 11 backend, Next.js 16 frontend), Python 3.11 (OCR sidecar)
|
||||||
|
: Follow standard conventions
|
||||||
|
|
||||||
|
## Recent Changes
|
||||||
|
|
||||||
|
- 232-typhoon-ocr-integration: Added TypeScript 5.x (NestJS 11 backend, Next.js 16 frontend), Python 3.11 (OCR sidecar)
|
||||||
@@ -1,8 +1,8 @@
|
|||||||
# `.agents/skills/` — LCBP3 Agent Skill Pack
|
# `.agents/skills/` — LCBP3 Agent Skill Pack
|
||||||
|
|
||||||
**Version:** 1.9.0 | **Last Updated:** 2026-05-17 | **Total Skills:** 23
|
**Version:** 1.9.0 | **Last Updated:** 2026-06-07 | **Total Skills:** 24
|
||||||
|
|
||||||
Agent skills for AI-assisted development in **Windsurf IDE** (and compatible agents: Codex CLI, opencode, Amp, Antigravity, AGENTS.md-aware tools).
|
Agent skills for AI-assisted development in **Devin IDE** (and compatible agents: Codex CLI, opencode, Amp, Antigravity, AGENTS.md-aware tools).
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -14,6 +14,7 @@ Agent skills for AI-assisted development in **Windsurf IDE** (and compatible age
|
|||||||
├── skills.md # Overview + dependency matrix + health monitoring
|
├── skills.md # Overview + dependency matrix + health monitoring
|
||||||
├── _LCBP3-CONTEXT.md # Shared LCBP3 context injected into every speckit-* skill
|
├── _LCBP3-CONTEXT.md # Shared LCBP3 context injected into every speckit-* skill
|
||||||
├── README.md # (this file)
|
├── README.md # (this file)
|
||||||
|
├── save-memory/ # Session log & project memory update
|
||||||
├── nestjs-best-practices/ # Backend rules (40 rules across 10 categories)
|
├── nestjs-best-practices/ # Backend rules (40 rules across 10 categories)
|
||||||
├── next-best-practices/ # Frontend rules (Next.js 15+)
|
├── next-best-practices/ # Frontend rules (Next.js 15+)
|
||||||
├── e2e-testing/ # Playwright E2E testing patterns (POM, flaky tests, CI/CD)
|
├── e2e-testing/ # Playwright E2E testing patterns (POM, flaky tests, CI/CD)
|
||||||
@@ -30,12 +31,10 @@ Each skill directory contains:
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🚀 How Windsurf Invokes These Skills
|
## 🚀 How Devin Invokes These Skills
|
||||||
|
|
||||||
Windsurf exposes two entry points:
|
1. **Skill tool** — Devin discovers skills by scanning `.agents/skills/*/SKILL.md` frontmatter. Skills marked `user-invocable: false` are used silently by Cascade.
|
||||||
|
2. **Slash commands** — `.devin/workflows/*.md` wraps each skill as a slash command (e.g. `/04-speckit.plan`). The workflow file is short; the heavy lifting is delegated to the skill via `skill` tool.
|
||||||
1. **Skill tool** — Windsurf discovers skills by scanning `.agents/skills/*/SKILL.md` frontmatter. Skills marked `user-invocable: false` are used silently by Cascade.
|
|
||||||
2. **Slash commands** — `.windsurf/workflows/*.md` wraps each skill as a slash command (e.g. `/04-speckit.plan`). The workflow file is short; the heavy lifting is delegated to the skill via `skill` tool.
|
|
||||||
|
|
||||||
Both paths end up executing the same `SKILL.md` instructions.
|
Both paths end up executing the same `SKILL.md` instructions.
|
||||||
|
|
||||||
@@ -65,14 +64,14 @@ Use `/00-speckit.all` to run specify → clarify → plan → tasks → analyze
|
|||||||
|
|
||||||
From repo root:
|
From repo root:
|
||||||
|
|
||||||
| Script | Purpose |
|
| Script | Purpose |
|
||||||
| --------------------------------------------------------- | ----------------------------------------------------------- |
|
| ------------------------------------------------------ | ---------------------------------------------------------- |
|
||||||
| `./.agents/scripts/bash/check-prerequisites.sh --json` | Emit `FEATURE_DIR` + `AVAILABLE_DOCS` for a feature branch |
|
| `./.agents/scripts/bash/check-prerequisites.sh --json` | Emit `FEATURE_DIR` + `AVAILABLE_DOCS` for a feature branch |
|
||||||
| `./.agents/scripts/bash/setup-plan.sh --json` | Emit `FEATURE_SPEC`, `IMPL_PLAN`, `SPECS_DIR`, `BRANCH` |
|
| `./.agents/scripts/bash/setup-plan.sh --json` | Emit `FEATURE_SPEC`, `IMPL_PLAN`, `SPECS_DIR`, `BRANCH` |
|
||||||
| `./.agents/scripts/bash/update-agent-context.sh windsurf` | Append tech entries to `AGENTS.md` |
|
| `./.agents/scripts/bash/update-agent-context.sh devin` | Append tech entries to `AGENTS.md` |
|
||||||
| `./.agents/scripts/bash/audit-skills.sh` | Validate all `SKILL.md` frontmatter + presence |
|
| `./.agents/scripts/bash/audit-skills.sh` | Validate all `SKILL.md` frontmatter + presence |
|
||||||
| `./.agents/scripts/bash/validate-versions.sh` | Version consistency check |
|
| `./.agents/scripts/bash/validate-versions.sh` | Version consistency check |
|
||||||
| `./.agents/scripts/bash/sync-workflows.sh` | Verify every skill has a `.windsurf/workflows/*.md` wrapper |
|
| `./.agents/scripts/bash/sync-workflows.sh` | Verify every skill has a `.devin/workflows/*.md` wrapper |
|
||||||
|
|
||||||
All scripts mirror to `.agents/scripts/powershell/*.ps1` for Windows.
|
All scripts mirror to `.agents/scripts/powershell/*.ps1` for Windows.
|
||||||
|
|
||||||
@@ -97,7 +96,7 @@ To add a new skill:
|
|||||||
|
|
||||||
1. Create `NAME/SKILL.md` with frontmatter: `name`, `description`, `version: 1.9.0`, `scope`, `depends-on`.
|
1. Create `NAME/SKILL.md` with frontmatter: `name`, `description`, `version: 1.9.0`, `scope`, `depends-on`.
|
||||||
2. Append an LCBP3 context reference pointing to `_LCBP3-CONTEXT.md`.
|
2. Append an LCBP3 context reference pointing to `_LCBP3-CONTEXT.md`.
|
||||||
3. Wrap with `.windsurf/workflows/NAME.md` so it becomes a slash command.
|
3. Wrap with `.devin/workflows/NAME.md` so it becomes a slash command.
|
||||||
4. Update [`skills.md`](./skills.md) dependency matrix.
|
4. Update [`skills.md`](./skills.md) dependency matrix.
|
||||||
5. Run `./.agents/scripts/bash/audit-skills.sh` → must pass.
|
5. Run `./.agents/scripts/bash/audit-skills.sh` → must pass.
|
||||||
|
|
||||||
+1
-1
@@ -6454,7 +6454,7 @@ CREATE TABLE ai_audit_log (
|
|||||||
user_id INT NOT NULL,
|
user_id INT NOT NULL,
|
||||||
action VARCHAR(64) NOT NULL, -- 'ai.extract_metadata', 'ai.classify', etc.
|
action VARCHAR(64) NOT NULL, -- 'ai.extract_metadata', 'ai.classify', etc.
|
||||||
file_id INT,
|
file_id INT,
|
||||||
model VARCHAR(64), -- 'gemma-4:7b', 'paddleocr-v3'
|
model VARCHAR(64), -- 'gemma-4:7b', 'typhoon-np-dms-ocr', 'tesseract-ocr'
|
||||||
confidence DECIMAL(4,3),
|
confidence DECIMAL(4,3),
|
||||||
input_hash CHAR(64), -- SHA-256 of input for replay detection
|
input_hash CHAR(64), -- SHA-256 of input for replay detection
|
||||||
output_summary JSON,
|
output_summary JSON,
|
||||||
+1
-1
@@ -137,7 +137,7 @@ CREATE TABLE ai_audit_log (
|
|||||||
user_id INT NOT NULL,
|
user_id INT NOT NULL,
|
||||||
action VARCHAR(64) NOT NULL, -- 'ai.extract_metadata', 'ai.classify', etc.
|
action VARCHAR(64) NOT NULL, -- 'ai.extract_metadata', 'ai.classify', etc.
|
||||||
file_id INT,
|
file_id INT,
|
||||||
model VARCHAR(64), -- 'gemma-4:7b', 'paddleocr-v3'
|
model VARCHAR(64), -- 'gemma-4:7b', 'typhoon-np-dms-ocr', 'tesseract-ocr'
|
||||||
confidence DECIMAL(4,3),
|
confidence DECIMAL(4,3),
|
||||||
input_hash CHAR(64), -- SHA-256 of input for replay detection
|
input_hash CHAR(64), -- SHA-256 of input for replay detection
|
||||||
output_summary JSON,
|
output_summary JSON,
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user