evnict-kit 0.2.1

package/templates/workflows/claude/evnict-kit-init-rules.md

@@ -0,0 +1,112 @@
+# Init Rules — Khởi tạo Project Conventions
+**Command:** `/evnict-kit:init-rules $ARGUMENTS`
+
+$ARGUMENTS chứa mô tả từ user.
+
+## Mục đích
+Đọc toàn bộ codebase → phân tích → tự động điền nội dung cho file `05-evnict-kit-project-conventions.md` (RP01-RP07).
+
+## Pre-conditions
+- Project đã init bằng `evnict-kit init`
+- File `.agent/rules/05-evnict-kit-project-conventions.md` tồn tại (có placeholders)
+- Codebase có source code để phân tích
+
+---
+
+## Workflow
+
+### Task 1: Scan Project Structure
+```bash
+tree -L 3 --dirsfirst
+```
+Ghi nhận: package structure, module organization, config files.
+
+### Task 2: RP01 — Naming Convention
+Đọc 5-10 file Java/TypeScript → extract:
+- Package naming pattern
+- Class naming (Controller, Service, Repository, DTO)
+- Method naming (CRUD verbs, prefixes)
+- Variable naming
+- File naming
+- Table/Column naming (từ migration scripts hoặc JOOQ generated)
+
+### Task 3: RP02 — Architecture Pattern
+Phân tích:
+- Folder structure → xác định architecture (MVC, Clean, Hexagonal)
+- Layer dependencies (Controller→Service→Repository)
+- Module organization (by feature, by layer)
+
+### Task 4: RP03 — Coding Convention
+Đọc code → extract:
+- Indentation (tabs/spaces, size)
+- Import ordering
+- Method ordering
+- Comment style
+- Null handling
+- Logging framework
+
+### Task 5: RP04 — API Convention
+Đọc Controller classes → extract:
+- Base URL pattern
+- HTTP method usage
+- Request/Response format
+- Pagination pattern
+- Error format
+
+### Task 6: RP05 — Database Convention
+Đọc migration scripts, JOOQ config, application.yml → extract:
+- Database type & version
+- Schema structure
+- Table/column naming
+- PK pattern (sequence, UUID, identity)
+- Audit columns
+
+### Task 7: RP06 — Component Convention (Frontend only)
+Đọc Angular files → extract:
+- Component structure
+- Selector prefix
+- State management
+- UI library usage
+- Form handling
+
+### Task 8: RP07 — Integration Map
+Đọc config, dependencies, service files → extract:
+- External services (SSO, MinIO, CMIS)
+- Internal dependencies
+- Cache, messaging, storage
+
+### Task 9: Update File
+Cập nhật `05-evnict-kit-project-conventions.md`:
+1. Thay "⚠️ CHƯA ĐƯỢC KHỞI TẠO" bằng nội dung thực tế
+2. Thêm code examples LẤY TỪ CODE THỰC TẾ (không mẫu generic)
+3. Đổi header thành `✅ ĐÃ KHỞI TẠO — {date}`
+
+### Task 10: Summary
+Tạo `.agent/context/init-summary-backend.md` hoặc `init-summary-frontend.md`:
+```markdown
+# Init Summary — {date}
+## Conventions found: {count}/7
+## Files scanned: {count}
+## Key findings:
+- {finding 1}
+- {finding 2}
+```
+
+---
+
+## Bảo mật
+- KHÔNG ghi secrets, IP nội bộ, URLs production vào rules
+- KHÔNG ghi passwords, connection strings
+- Chỉ ghi PATTERNS không ghi VALUES
+
+## Output
+```
+✅ RP01 Naming: ACTIVE
+✅ RP02 Architecture: ACTIVE
+✅ RP03 Coding: ACTIVE
+✅ RP04 API: ACTIVE
+✅ RP05 Database: ACTIVE
+✅ RP06 Component: ACTIVE (hoặc SKIPPED nếu BE only)
+✅ RP07 Integration: ACTIVE
+📄 Summary: .agent/context/init-summary-{type}.md
+```

package/templates/workflows/claude/evnict-kit-init-wiki.md

@@ -0,0 +1,78 @@
+# Init Wiki — Setup LLM Wiki
+**Command:** `/evnict-kit:init-wiki $ARGUMENTS`
+
+$ARGUMENTS chứa mô tả từ user.
+
+## Mục đích
+Setup llm-wiki knowledge base cho dự án. Copy từ template có sẵn hoặc clone từ GitHub.
+
+## Options
+- `/evnict-kit:init-wiki` → Copy từ templates/wiki/ (mặc định)
+- `/evnict-kit:init-wiki --from-github` → Clone fresh từ GitHub
+
+---
+
+## Workflow (Default — Copy Template)
+
+### Bước 1: Xác định wiki path
+```bash
+cat .evnict/config.yaml | grep wiki
+# → wiki.folder: "{project}-wiki"
+```
+
+### Bước 2: Copy template
+Wiki template đã có sẵn trong evnict-kit package:
+```bash
+cp -r {evnict-kit}/templates/wiki/ ./{project}-wiki/
+```
+
+### Bước 3: Install dependencies
+```bash
+cd {project}-wiki
+npm install
+```
+
+### Bước 4: Configure
+Tạo `config.yaml` từ `config.example.yaml`:
+```yaml
+project: "{project-name}"
+raw_path: "raw/notes"
+processed_path: "processed"
+index_path: "processed/index.json"
+```
+
+### Bước 5: Tạo folder structure
+```bash
+mkdir -p raw/notes
+mkdir -p processed
+```
+
+### Bước 6: First ingest (nếu có notes sẵn)
+```bash
+npm run ingest
+```
+
+### Bước 7: Verify
+```
+✅ Wiki setup: {project}-wiki/
+✅ Dependencies installed
+✅ Config created
+✅ Folders ready
+```
+
+---
+
+## Workflow (--from-github)
+
+### Bước 1: Clone
+```bash
+git clone https://github.com/mduongvandinh/llm-wiki.git {project}-wiki
+```
+
+### Bước 2: Install + Configure
+Same as steps 3-7 above.
+
+---
+
+## Output
+Wiki folder ready at `{project}-wiki/` with npm dependencies installed.

package/templates/workflows/claude/evnict-kit-plan.md

@@ -0,0 +1,305 @@
+# Plan
+**Command:** `/evnict-kit:plan $ARGUMENTS`
+
+$ARGUMENTS chứa mô tả từ user.
+
+## Khi nào dùng
+Dùng để tự động sinh cấu trúc công việc CHI TIẾT, Breakdown các thành phần và tạo API Contract từ một bản Specification (Spec) đã chốt.
+
+## Input
+- Spec file path (Agent sẽ auto-detect từ `.evnict/specs/` gần nhất nếu không cung cấp)
+- Hoặc người dùng chỉ định trực tiếp: `/evnict-kit:plan .evnict/specs/feature-xyz/spec.md`
+
+---
+
+## Workflow chi tiết
+
+### Bước 1: Parse Specification
+1. Đọc file `spec.md` đã confirm.
+2. Kiểm tra xem có câu hỏi clarify nào chưa được user trả lời hay không.
+   - Nếu có: Yêu cầu người dùng trả lời trước khi tiếp tục. Dừng lệnh.
+   - Nếu đã trả lời: Tự động update `spec.md` với các quyết định/câu trả lời nếu cần thiết.
+3. Đọc `.agent/rules/` → nắm conventions dự án (naming, architecture, coding patterns).
+4. Đọc AGENTS.md → hiểu project overview, tech stack.
+
+### Bước 2: Đọc file mẫu trong project
+**BẮT BUỘC** đọc các file mẫu thật trong project để trích xuất code patterns:
+1. Tìm file mẫu tương tự với feature cần implement:
+   - Repository mẫu (VD: `LrsDepartmentRepository.java`)
+   - Service mẫu (VD: `LrsDepartmentService.java`)
+   - Controller mẫu (VD: `NCPTController.java`)
+   - DTO mẫu (VD: `LrsDepartmentDTO.java`)
+   - FE Service mẫu, Component mẫu (nếu FE project)
+2. Trích skeleton pattern: class structure, imports, method signatures, annotations.
+3. Lưu lại để paste vào task files ở bước sau.
+
+### Bước 3: Sinh Plan.md — PHẢI có 6 SECTIONS
+
+Tạo file `.evnict/specs/{feature-slug}/plan.md` theo template sau:
+
+```markdown
+# Plan: {Feature Name}
+
+## 1. Tổng quan
+- Feature: {tên chức năng}
+- Spec: .evnict/specs/{slug}/spec.md
+- Estimated: {X} tasks, phân bổ BE:{N} / FE:{M} / DB:{K}
+- Priority: {High/Medium/Low}
+- Branch: feature/{slug}
+
+## 2. Database Schema
+### Tables cần tạo/sửa
+| Table | Column | Type | Nullable | FK | Mô tả |
+|-------|--------|------|----------|-----|-------|
+| {TABLE_NAME} | ID | NUMBER | NO | PK | Primary key |
+| {TABLE_NAME} | {COL} | {TYPE} | {YES/NO} | {FK→TABLE} | {mô tả} |
+| ... | ... | ... | ... | ... | ... |
+
+### Indexes (nếu cần)
+| Index | Columns | Type | Mô tả |
+|-------|---------|------|-------|
+| {IDX_NAME} | {cols} | {UNIQUE/NORMAL} | {mô tả} |
+
+### Migration script naming
+- `V{YYYYMMDD}_{SEQ}__{description}.sql`
+
+## 3. API Design
+### Endpoints
+| # | Method | Path | Auth | Mô tả |
+|---|--------|------|------|-------|
+| 1 | POST | /api/{module}/{action} | JWT | {mô tả} |
+| ... | ... | ... | ... | ... |
+
+### Request/Response chi tiết cho MỖI endpoint
+
+**{METHOD} {PATH}**
+```json
+// Request
+{
+  "field1": "type — description",
+  "field2": "type — description",
+  "page": 0,
+  "size": 20
+}
+// Response (ResponseData wrapper)
+{
+  "success": true,
+  "message": "OK",
+  "data": {
+    "content": [{ ... }],
+    "totalElements": 100,
+    "totalPages": 5
+  }
+}
+// Error Response
+{
+  "success": false,
+  "message": "Lỗi cụ thể",
+  "data": null
+}
+```
+
+## 4. Frontend Design
+### Pages/Components
+| # | Component | Type | Route | Mô tả |
+|---|-----------|------|-------|-------|
+| 1 | {Name}ListComponent | Page | /{route} | Danh sách + filter + CRUD |
+| 2 | {Name}FormComponent | Dialog | — | Form thêm/sửa |
+
+### UI Elements
+- Filter bar: {dropdowns, date pickers, text inputs}
+- Table: columns mapped từ DTO
+- Actions: Thêm, Sửa, Xóa (confirm dialog)
+- Toolbar: Export Excel (nếu cần)
+
+### Dropdowns cần load
+| Dropdown | API | Value field | Display field |
+|----------|-----|-------------|---------------|
+| {Dropdown name} | {API path} | {value} | {display} |
+
+## 5. Business Rules áp dụng
+| Mã | Rule | Áp dụng cho |
+|----|------|-------------|
+| BR01 | {rule description} | BE: {endpoint} |
+| BR02 | {rule description} | BE + FE: validation |
+| ... | ... | ... |
+
+## 6. Task Breakdown
+### Thứ tự thực hiện
+```
+DB Migration → BE Repository → BE Service → BE Controller → FE Service → FE Component → FE Page
+```
+
+### Dependencies
+- FE tasks chờ BE xong → đọc API contract
+- BE tasks chờ DB migration xong
+
+### Task List
+| # | File | Mô tả | Depends on | Est. |
+|---|------|-------|------------|------|
+| 01 | db-migration | {desc} | — | 3 min |
+| 02 | be-repository | {desc} | 01 | 5 min |
+| ... | ... | ... | ... | ... |
+```
+
+---
+
+### Bước 4: Sinh Task Files — MỖI FILE PHẢI ≥ 100 DÒNG
+
+Tạo thư mục `.evnict/specs/{feature-slug}/tasks/` và sinh task files theo template:
+
+```markdown
+# Task {NN}: {be|fe|db}-{description}
+
+## 1. Mục tiêu
+{Mô tả cụ thể task này làm gì — 3-5 câu.
+Nêu rõ input/output, layer nào trong architecture,
+và kết quả mong đợi khi task hoàn thành.}
+
+## 2. Business Context
+Business rules liên quan đến task này (trích từ spec):
+- BR{XX}: {rule description} — cách áp dụng trong task này
+- BR{YY}: {rule description} — cách áp dụng trong task này
+
+Luồng nghiệp vụ liên quan:
+{Trích phần flow liên quan từ spec, giúp Agent hiểu WHY}
+
+## 3. Files cần tạo/sửa
+| File | Action | Mô tả |
+|------|--------|-------|
+| `src/.../XxxRepository.java` | CREATE | Repository JOOQ cho bảng {TABLE} |
+| `src/.../XxxDTO.java` | CREATE | DTO với @JsonProperty UPPER_SNAKE |
+| ... | ... | ... |
+
+## 4. Implementation Guide
+### Conventions phải tuân thủ (tham chiếu rules)
+- Rule 03: Backend Conventions → {specific convention}
+- Rule 05: Project Conventions → {specific convention}
+- {Liệt kê CỤ THỂ rule nào, section nào áp dụng}
+
+### Code Pattern tham khảo
+Tham khảo file mẫu trong project: `{ReferenceFile.java}`
+
+```java
+// Pattern trích từ {ReferenceFile.java}
+// Agent ĐÃ ĐỌC file thật và paste skeleton ở đây
+@Repository
+public class {EntityName}Repository extends BaseRepositoryImpl<...> {
+    @Qualifier(DefineProperties.DSLContextNCPT)
+    DSLContext dslContext;
+
+    @Override
+    public List<{EntityName}DTO> getAll(InputCondition input) {
+        // JOOQ type-safe query
+        // Pattern: select().from().where().fetch()
+    }
+
+    public int insert({EntityName}DTO dto) {
+        // Pattern: dslContext.insertInto(TABLE).set(...).execute()
+    }
+
+    public int update({EntityName}DTO dto) {
+        // Pattern: dslContext.update(TABLE).set(...).where(...).execute()
+    }
+
+    public int delete(Object id) {
+        // Pattern: dslContext.deleteFrom(TABLE).where(...).execute()
+    }
+}
+```
+
+### Validation/Error handling
+- {Mô tả cách xử lý lỗi theo convention dự án}
+- {VD: throw BusinessException("message") cho business rule violations}
+
+## 5. Test Cases (TDD — viết TRƯỚC)
+| # | Test | Input | Expected | Type |
+|---|------|-------|----------|------|
+| 1 | {test_name} | {input description} | {expected result} | Unit |
+| 2 | {test_name} | {input description} | {expected result} | Unit |
+| 3 | {test_name} | {input description} | {expected result} | Unit |
+| 4 | {test_name} | {input description} | {expected result} | Unit |
+| 5 | {test_name} | {input description} | {expected result} | Unit |
+
+### Test code skeleton
+```java
+@ExtendWith(MockitoExtension.class)
+class {EntityName}{Layer}Test {
+    // Arrange — mocks, test data
+    // Act — call method under test
+    // Assert — verify result + interactions
+}
+```
+
+## 6. Acceptance Criteria
+- [ ] {Criterion 1 — cụ thể, đo được}
+- [ ] {Criterion 2}
+- [ ] {Criterion 3}
+- [ ] Code theo đúng conventions (rule {XX}, {YY})
+- [ ] Unit tests pass (≥ {N} test cases)
+
+## 7. Dependencies
+- **Requires:** Task {XX} ({description}) hoàn thành
+- **Blocks:** Task {YY} ({description}) — cần output của task này
+- **Related:** {API Contract, handoff, other tasks}
+
+## 8. Estimated: {N} phút
+```
+
+---
+
+### Bước 5: Sinh API Contract
+Từ API Design trong plan.md, tạo file `.evnict/specs/{feature-slug}/contracts/api-contract.yaml`:
+
+```yaml
+# contracts/api-contract.yaml
+feature: {feature-name}
+generated: {date}
+endpoints:
+  - method: POST
+    path: /api/{module}/{action}
+    description: {mô tả}
+    request:
+      body:
+        fieldName: { type: string, required: true, maxLength: 100 }
+    response:
+      200:
+        schema: ResponseData
+        data:
+          id: { type: number }
+      400:
+        schema: ResponseData
+        error: { message: string }
+```
+
+### Bước 6: Quality Gate — KIỂM TRA TRƯỚC KHI HIỂN THỊ
+
+Agent PHẢI tự kiểm tra trước khi hiển thị plan cho user:
+
+| Check | Yêu cầu | Nếu fail |
+|-------|---------|----------|
+| Plan.md sections | Đủ 6 sections | Bổ sung section thiếu |
+| Task file length | Mỗi file ≥ 100 dòng | Bổ sung chi tiết |
+| Test cases | Mỗi task ≥ 3 test cases | Thêm test cases |
+| Code patterns | Mỗi task có skeleton code từ file mẫu THẬT | Đọc lại file mẫu |
+| Dependencies | Mỗi task ghi rõ Requires/Blocks | Bổ sung |
+| Business rules | Task liên quan có trích BR từ spec | Trích bổ sung |
+| API contract | File yaml tồn tại và đầy đủ endpoints | Bổ sung |
+
+### Bước 7: Chờ Confirm
+Hiển thị Plan đã Breakdown ra log cho User duyệt:
+```
+📋 Plan đã sinh:
+  📄 plan.md — {N} dòng, {X} tasks
+  📁 tasks/ — {X} files ({be_count} BE, {fe_count} FE, {db_count} DB)
+  📜 contracts/api-contract.yaml
+
+Quality Gate: ✅ PASSED (tất cả checks OK)
+
+Bạn duyệt plan này không?
+A) ✅ Approve — chạy /evnict-kit:implement
+B) 📝 Sửa — feedback cụ thể
+C) ❌ Hủy — xóa plan, quay lại spec
+```
+
+Sau khi người dùng Approve, hãy nhắc họ chạy lệnh: `/evnict-kit:implement`.

package/templates/workflows/claude/evnict-kit-review.md

@@ -0,0 +1,51 @@
+# Auto Review
+**Command:** `/evnict-kit:review $ARGUMENTS`
+
+$ARGUMENTS chứa mô tả từ user.
+
+## Khi nào dùng
+- Trước khi merge code
+- Review code do AI Agent sinh ra
+- Kiểm tra chất lượng trước pull request
+
+## Input
+- Branch (auto-detect current)
+- `/evnict-kit:review` hoặc `/evnict-kit:review --scope=security`
+
+---
+
+## Bước 1: Code Review
+Gọi skill `evnict-kit-code-review`:
+- 9 hạng mục review (Security, Logic, Quality, Tests, Build, Vibe Coding, Database, Documentation, Performance)
+- Tạo review report
+
+## Bước 2: Merge Checklist
+Gọi skill `evnict-kit-merge-checklist`:
+- 9 hạng mục pre-merge check
+- Build, tests, lint, security, secrets, commits, files, docs, migration
+
+## Bước 3: Verdict
+```markdown
+## 📋 Review Summary
+
+### Code Review: {APPROVE | REQUEST CHANGES | BLOCK}
+{Summary of issues}
+
+### Merge Checklist: {PASS | FAIL}
+{Summary of checks}
+
+### Final Verdict: {✅ READY TO MERGE | ❌ NEEDS FIXES}
+{Actions required before merge}
+```
+
+## Bước 4: Nếu BLOCK/FAIL
+1. Liệt kê issues cần fix
+2. Fix issues
+3. Chạy lại `/evnict-kit:review`
+
+---
+
+## Checklist
+- [ ] Code review completed (9 items)
+- [ ] Merge checklist completed (9 items)
+- [ ] Verdict: APPROVE + PASS → Ready to merge

package/templates/workflows/claude/evnict-kit-spec-archive.md

@@ -0,0 +1,51 @@
+# Spec Archive
+**Command:** `/evnict-kit:spec-archive $ARGUMENTS`
+
+$ARGUMENTS chứa mô tả từ user.
+
+## Khi nào dùng
+- Tìm spec đã tạo trước đó
+- Archive spec từ .evnict/ vào docs/
+- Liệt kê tất cả specs
+
+## Input
+- Action: list | find | archive | show
+- `/evnict-kit:spec-archive list` → Liệt kê tất cả specs
+- `/evnict-kit:spec-archive find {keyword}` → Tìm spec theo keyword
+- `/evnict-kit:spec-archive archive {slug}` → Archive spec vào docs/
+- `/evnict-kit:spec-archive show {slug}` → Hiển thị spec
+
+---
+
+## Action: LIST
+```bash
+ls .evnict/specs/
+```
+Output:
+```markdown
+## 📋 Specs
+| # | Slug | Status | Date | Tasks |
+|---|------|--------|------|-------|
+| 1 | {slug} | {draft|confirmed|archived} | {date} | {count} |
+```
+
+## Action: FIND
+```bash
+grep -rl "{keyword}" .evnict/specs/ --include="*.md"
+```
+
+## Action: ARCHIVE
+```bash
+cp -r .evnict/specs/{slug}/ docs/specs/{slug}/
+```
+
+## Action: SHOW
+```bash
+cat .evnict/specs/{slug}/spec.md
+```
+
+---
+
+## Checklist
+- [ ] Action executed successfully
+- [ ] Output formatted clearly