evnict-kit 0.2.1

package/templates/context/CLAUDE.md.template

@@ -0,0 +1,301 @@
+# {{PROJECT_NAME}} — Claude Code Context
+> Generated by evnict-kit v0.2.1 | {{DATE}}
+> Đây là file context CHỦ ĐẠO — Claude Code đọc file này ở MỌI request.
+
+---
+
+## 1. PROJECT OVERVIEW
+
+| Property | Value |
+|----------|-------|
+| Project Name | {{PROJECT_NAME}} |
+| Tech Stack | {{TECH_STACK}} |
+| Database | {{DATABASE}} |
+| evnict-kit | v0.2.1 |
+
+### Mô tả
+<!-- CHƯA KHỞI TẠO — chạy /evnict-kit:init-context -->
+{Mô tả ngắn gọn về dự án — 2-3 câu}
+
+### Mục tiêu nghiệp vụ
+<!-- CHƯA KHỞI TẠO -->
+{Mục tiêu chính của hệ thống}
+
+---
+
+## 2. ARCHITECTURE
+
+### Layer Structure
+```
+Controller Layer    → HTTP handling, input validation (@Valid)
+    ↓
+Service Layer       → Business logic, @Transactional
+    ↓
+Repository Layer    → Data access (JOOQ type-safe queries)
+    ↓
+Database            → Oracle/SQL Server
+```
+
+### Nguyên tắc
+- Controller KHÔNG chứa business logic
+- Service quản lý transactions
+- Repository CHỈ data access — không business logic
+- DTO cho data transfer — KHÔNG dùng Entity trực tiếp trong response
+
+---
+
+## 3. PROJECT STRUCTURE
+
+### Backend
+<!-- CHƯA KHỞI TẠO — Agent sẽ điền từ tree output -->
+```
+src/main/java/com/evn/{{PROJECT_NAME}}/
+├── config/              ← Application configuration
+├── common/              ← Shared utilities, base classes
+│   ├── dto/             ← ResponseData, PageDTO
+│   └── exception/       ← BusinessException, GlobalExceptionHandler
+├── security/            ← JWT filter, SecurityConfig
+└── {module}/            ← Feature modules
+    ├── controller/
+    ├── service/
+    ├── repository/
+    └── dto/
+```
+
+### Frontend
+<!-- CHƯA KHỞI TẠO -->
+```
+src/app/
+├── core/                ← Guards, interceptors, core services
+├── shared/              ← Reusable components, pipes, directives
+├── features/            ← Feature modules (lazy-loaded)
+│   └── {module}/
+│       ├── pages/
+│       ├── components/
+│       ├── services/
+│       └── models/
+└── assets/              ← Static assets, i18n files
+```
+
+---
+
+## 4. DEVELOPMENT COMMANDS
+
+### Backend
+```bash
+./mvnw clean install          # Build
+./mvnw spring-boot:run        # Run
+./mvnw test                   # Test
+./mvnw spotless:check         # Lint
+./mvnw flyway:migrate         # Migration
+./mvnw jooq-codegen:generate  # JOOQ codegen
+```
+
+### Frontend
+```bash
+npm install       # Install
+ng serve          # Run
+ng test --watch=false  # Test
+ng lint           # Lint
+ng build --configuration=production  # Build
+npm audit         # Security
+```
+
+---
+
+## 5. CODING CONVENTIONS
+
+<!-- CHƯA KHỞI TẠO — /evnict-kit:init-rules sẽ điền project-specific -->
+
+### Naming
+| Loại | Convention | Ví dụ |
+|------|-----------|-------|
+| Class | PascalCase | `CustomerService` |
+| Method | camelCase | `findByStatus()` |
+| Variable | camelCase | `customerId` |
+| Constant | UPPER_SNAKE | `MAX_FILE_SIZE` |
+| Table | UPPER_SNAKE | `CUSTOMER` |
+| Column | UPPER_SNAKE | `CREATED_DATE` |
+| API path | kebab-case | `/api/customers` |
+
+### API Response Format
+```java
+public class ResponseData {
+    private int status;      // 0 = success, 1 = error
+    private String message;
+    private Object data;
+}
+// ResponseData.ok(data) → { status: 0, message: "Thành công", data: {...} }
+// ResponseData.error("msg") → { status: 1, message: "msg", data: null }
+```
+
+### Commit Message
+```
+{type}({scope}): {description} [task-{N}]
+Types: feat, fix, refactor, test, docs, chore
+```
+
+### API Endpoint Pattern
+```
+GET    /api/{module}          → List (paginated)
+GET    /api/{module}/{id}     → Get by ID
+POST   /api/{module}          → Create
+PUT    /api/{module}/{id}     → Update
+DELETE /api/{module}/{id}     → Delete
+POST   /api/{module}/search   → Complex search
+```
+
+### Database
+- Migration Tool: Flyway — `V{YYYYMMDD}_{seq}__{desc}.sql`
+- Audit columns BẮT BUỘC: CREATED_BY, CREATED_DATE, UPDATED_BY, UPDATED_DATE
+- Soft delete: IS_DELETED NUMBER(1) DEFAULT 0
+
+---
+
+## 6. RULES — PHẢI TUÂN THỦ
+
+### General Rules (R01-R08)
+- **R01 No Secrets**: KHÔNG hardcode API keys, passwords, connection strings, JWT secrets. Dùng env vars / @Value.
+- **R02 No Auto Push**: KHÔNG tự động `git push`. Commit OK, push PHẢI HỎI USER.
+- **R03 No Destructive Ops**: KHÔNG `rm -rf` src/, KHÔNG `DROP TABLE` production, KHÔNG `git reset --hard` shared branch.
+- **R04 No PII In Logs**: KHÔNG log password, token, CMND, phone, card number. Log IDs và actions.
+- **R05 Test Before Commit**: BẮT BUỘC test pass trước commit. Build fail → fix trước.
+- **R06 Minimal Diff**: CHỈ sửa code liên quan. KHÔNG refactor/rename ngoài scope. Vibe coding (sửa >3 lần) → DỪNG.
+- **R07 No Placeholder Code**: KHÔNG `// TODO: implement later`. Mỗi function PHẢI có logic thực tế.
+- **R08 Respect Gitignore**: KHÔNG tạo/commit files thuộc .gitignore (node_modules, .env, *.key).
+
+### Backend Rules (RB01-RB06)
+- **RB01 Input Validation**: MỌI input validate ở Controller (@Valid, @NotNull, @Size). Whitelist sort columns.
+- **RB02 Service Layer**: Controller → Service → Repository. Business logic CHỈ trong Service.
+- **RB03 Error Handling**: GlobalExceptionHandler, KHÔNG expose stack trace. Log đầy đủ nội bộ, message chung cho client.
+- **RB04 Database Migration**: Schema changes qua Flyway scripts. BẮT BUỘC có rollback script.
+- **RB05 Auth Every Route**: Mọi endpoint PHẢI authenticated (default deny). Public endpoints whitelist rõ ràng.
+- **RB06 Rate Limiting**: API public (login) → rate limit BẮT BUỘC.
+
+### Frontend Rules (RF01-RF06)
+- **RF01 No Inline Styles**: Tất cả styles trong .scss. Dùng CSS classes, KHÔNG [style] binding.
+- **RF02 Component Reuse**: Kiểm tra PrimeNG + shared/ trước khi tạo mới. Component dùng ≥2 nơi → shared/.
+- **RF03 No Hardcoded Text**: Tất cả text qua i18n (ngx-translate). Labels, messages, tooltips → translate.
+- **RF04 Accessibility**: img PHẢI có alt. Form field PHẢI có label/aria-label. Color contrast ≥ 4.5:1.
+- **RF05 No Direct DOM**: KHÔNG document.getElementById(). Dùng @ViewChild, Renderer2, template bindings.
+- **RF06 Responsive**: Desktop + Tablet + Mobile. PrimeNG Grid hoặc CSS Grid/Flexbox. Table scrollable mobile.
+
+### Security Rules (ATTT01-ATTT08)
+- **ATTT01 SQL Injection**: JOOQ type-safe (mặc định an toàn). KHÔNG string concatenation trong SQL.
+- **ATTT02 XSS**: Angular interpolation (auto-escaped). KHÔNG [innerHTML] / bypassSecurityTrust.
+- **ATTT03 CSRF**: JWT stateless → disable CSRF OK. Session-based → CsrfTokenRepository.
+- **ATTT04 JWT**: RS256/RS512 ONLY — KHÔNG HS256. Key ≥ 2048 bits. Exp ≤ 24h.
+- **ATTT05 Dependency CVE**: `mvnw dependency-check:check`, `npm audit`. Critical → 24h hotfix.
+- **ATTT06 File Upload**: Extension whitelist + MIME check + size limit + UUID rename + MinIO storage.
+- **ATTT07 No Data Exposure**: LUÔN dùng DTO response, KHÔNG return Entity trực tiếp.
+- **ATTT08 Anti-Vibe-Coding**: Sửa >3 lần cùng đoạn → DỪNG. Code không giải thích được = không merge.
+
+### Checkpoint (BẮT BUỘC)
+Trước phiên AI: `git checkout -b feature/ai-task-xxx` hoặc `git commit -m "checkpoint: before AI session"`
+
+---
+
+## 7. SAFETY & PERMISSIONS
+
+```
+❌ KHÔNG tự động git push
+❌ KHÔNG xóa file/folder quan trọng
+❌ KHÔNG hardcode secrets, passwords, API keys
+❌ KHÔNG log PII (password, CMND, phone, token)
+❌ KHÔNG expose stack trace cho client
+❌ KHÔNG sửa code ngoài scope yêu cầu
+❌ KHÔNG tiếp tục khi test fail > 3 lần (3-strike rule)
+
+✅ Luôn tạo checkpoint trước phiên AI
+✅ Luôn chạy test trước commit
+✅ Luôn dùng DTO, không Entity trực tiếp
+✅ Luôn validate input ở Controller
+✅ Luôn transaction ở Service
+```
+
+---
+
+## 8. INTEGRATION MAP
+
+<!-- CHƯA KHỞI TẠO — /evnict-kit:init-context sẽ điền -->
+
+| Service | Protocol | Usage |
+|---------|----------|-------|
+| EVN SSO | JWT (RS256) | Authentication |
+| MinIO | S3 API | File storage |
+| Redis | TCP | Session + cache |
+| CMIS | HTTP | Document management |
+| Azure DevOps | Git + Pipeline | CI/CD |
+
+---
+
+## 9. AVAILABLE COMMANDS
+
+### Phase 1: Init (chạy 1 lần)
+| Command | Mô tả |
+|---------|--------|
+| `/evnict-kit:init-rules` | Agent đọc code → điền rules RP01-RP07 |
+| `/evnict-kit:init-context` | Agent sinh CLAUDE.md context |
+| `/evnict-kit:init-check` | Verify setup |
+| `/evnict-kit:init-wiki` | Setup llm-wiki knowledge base |
+
+### Phase 2: Development (thường xuyên)
+| Command | Mô tả |
+|---------|--------|
+| `/evnict-kit:feature-large` | Feature lớn: spec→plan→TDD→archive |
+| `/evnict-kit:feature-small` | Feature nhỏ: plan→TDD |
+| `/evnict-kit:bug-fix` | Sửa lỗi: reproduce→TDD fix |
+| `/evnict-kit:implement` | TDD implement từ plan |
+| `/evnict-kit:plan` | Tạo implementation plan |
+| `/evnict-kit:attt` | Scan ATTT (full hoặc module) |
+| `/evnict-kit:review` | Auto review trước merge |
+| `/evnict-kit:handoff` | FE↔BE coordination |
+| `/evnict-kit:archive-wiki` | Archive spec + push wiki |
+| `/evnict-kit:spec-archive` | Quản lý specs |
+
+### Wiki Commands
+| Command | Mô tả |
+|---------|--------|
+| `/evnict-kit:wiki-scan-project` | Scan code → sinh wiki notes |
+| `/evnict-kit:wiki-archive-feature` | Archive feature → wiki |
+| `/evnict-kit:wiki-query` | Tìm kiếm trong wiki |
+
+---
+
+## 10. WORKSPACE STRUCTURE
+
+```
+workspace/
+├── .evnict/                  ← Workspace config
+│   ├── config.yaml
+│   ├── handoff/              ← FE↔BE coordination
+│   │   ├── contracts/
+│   │   └── handoff.md
+│   └── specs/                ← Feature specs
+├── {{BE_FOLDER}}/            ← Backend project
+│   ├── .claude/
+│   │   └── commands/         ← Slash commands (workflows)
+│   ├── CLAUDE.md             ← THIS FILE
+│   └── Instruct-Agent-AI.md
+├── {{FE_FOLDER}}/            ← Frontend project
+│   └── (same structure)
+├── docs/
+├── database/
+│   └── migrations/
+└── {{PROJECT_NAME}}-wiki/    ← LLM Wiki
+```
+
+---
+
+## 11. REFERENCES
+
+- **QĐ-TTPM**: Quy định hướng dẫn sử dụng AI trong PTPM tại EVNICT
+  - Điều 7: Thiết lập ngữ cảnh
+  - Điều 8: Nguyên tắc sử dụng AI an toàn
+- **OWASP Top 10:2021**: https://owasp.org/Top10/
+- **evnict-kit**: v0.2.1
+
+---
+
+> ⚠️ **File này chứa sections "CHƯA KHỞI TẠO"**
+> Chạy `/evnict-kit:init-context` để Agent tự động điền nội dung.

package/templates/context/copilot-instructions.md.template

@@ -0,0 +1,60 @@
+# {{PROJECT_NAME}} — GitHub Copilot Instructions
+> Generated by evnict-kit v0.2.1 | {{TECH_STACK}} | {{DATABASE}}
+
+## Project Context
+- **Tech**: {{TECH_STACK}}, {{DATABASE}}, JOOQ, Angular + PrimeNG
+- **Architecture**: Controller → Service → Repository → DB
+- **Auth**: JWT RS256 via EVN SSO
+- **File Storage**: MinIO (S3-compatible)
+
+## Coding Rules
+
+### CRITICAL — Không bao giờ
+- Hardcode API keys, passwords, JWT secrets, connection strings
+- `git push` (commit ok, push phải hỏi user)
+- `rm -rf` trên src/, database/, docs/
+- Log password, token, CMND, phone, card number
+- Return Entity trực tiếp (luôn dùng DTO)
+- Expose stack trace cho client
+- Viết `// TODO: implement later` (code PHẢI có logic thực tế)
+
+### Backend
+- Input validation: @Valid, @NotNull, @Size ở Controller
+- Business logic CHỈ trong Service, KHÔNG trong Controller
+- GlobalExceptionHandler — generic message cho client, full log nội bộ
+- Mọi endpoint PHẢI authenticated (default deny)
+- Schema changes qua Flyway migration scripts, BẮT BUỘC rollback
+
+### Frontend
+- Styles trong .scss (KHÔNG inline styles)
+- Reuse PrimeNG components trước khi tạo mới
+- i18n tất cả text (ngx-translate)
+- KHÔNG document.getElementById() — dùng @ViewChild, Renderer2
+- Responsive: Desktop + Tablet + Mobile
+
+## Security Rules
+- SQL: JOOQ type-safe queries mặc định an toàn. KHÔNG string concatenation.
+- XSS: Angular interpolation auto-escaped. KHÔNG [innerHTML].
+- JWT: RS256 only, key ≥ 2048 bits, exp ≤ 24h
+- File upload: extension whitelist + MIME check + UUID rename + MinIO
+- Dependency scan: `mvnw dependency-check:check`, `npm audit`
+
+## Conventions
+- **Naming**: Class=PascalCase, method=camelCase, constant=UPPER_SNAKE, table=UPPER_SNAKE
+- **Response**: `ResponseData { status, message, data }` — `ResponseData.ok()` / `.error()`
+- **API**: `GET /api/{module}`, `POST /api/{module}`, `PUT /api/{module}/{id}`, `DELETE /api/{module}/{id}`
+- **Commit**: `{type}({scope}): {description} [task-{N}]`
+- **DB audit columns**: CREATED_BY, CREATED_DATE, UPDATED_BY, UPDATED_DATE (bắt buộc)
+
+## Workflow Guide
+Khi được yêu cầu tạo feature / fix bug:
+1. Hỏi clarify trước khi code
+2. Tạo checkpoint: `git checkout -b feature/ai-task-xxx`
+3. Viết test trước (TDD) nếu có thể
+4. Follow conventions ở trên
+5. Chạy `./mvnw test` (BE) hoặc `ng test --watch=false` (FE) trước commit
+6. Không tự push git — chỉ commit
+
+## Anti-Vibe-Coding
+- Sửa cùng đoạn code >3 lần mà lỗi chưa fix → DỪNG, chia nhỏ yêu cầu
+- Code không giải thích được = không merge

package/templates/context/cursorrules.template

@@ -0,0 +1,114 @@
+# {{PROJECT_NAME}} — Cursor AI Context
+> Generated by evnict-kit v0.2.1 | {{TECH_STACK}} | {{DATABASE}}
+
+## Project Overview
+<!-- CHƯA KHỞI TẠO — chạy /evnict-kit:init-context -->
+- Tech: {{TECH_STACK}} + {{DATABASE}}
+- Architecture: Controller → Service → Repository → DB
+- Auth: JWT RS256 via EVN SSO
+- File Storage: MinIO (S3-compatible)
+
+## Project Structure
+```
+Backend: src/main/java/com/evn/{{PROJECT_NAME}}/{module}/{controller,service,repository,dto}/
+Frontend: src/app/{core,shared,features}/{module}/{pages,components,services,models}/
+```
+
+## Development Commands
+```bash
+# Backend
+./mvnw test && ./mvnw spring-boot:run
+
+# Frontend
+ng test --watch=false && ng serve
+
+# Database
+./mvnw flyway:migrate && ./mvnw jooq-codegen:generate
+```
+
+---
+
+## Coding Conventions
+
+### Naming
+- Class: PascalCase (`CustomerService`), Method: camelCase (`findByStatus()`)
+- Table/Column: UPPER_SNAKE (`CUSTOMER`, `CREATED_DATE`), API: kebab-case (`/api/customers`)
+
+### API Response
+```java
+ResponseData { status: 0|1, message: "...", data: {...} }
+// ResponseData.ok(data) | ResponseData.error("msg")
+```
+
+### Commit: `{type}({scope}): {description} [task-{N}]`
+
+### API Pattern
+```
+GET /api/{module}, POST /api/{module}, PUT /api/{module}/{id}, DELETE /api/{module}/{id}
+```
+
+### Database
+- Flyway migration: `V{YYYYMMDD}_{seq}__{desc}.sql` + rollback
+- Audit columns: CREATED_BY, CREATED_DATE, UPDATED_BY, UPDATED_DATE
+- Soft delete: IS_DELETED NUMBER(1) DEFAULT 0
+
+---
+
+## Rules — PHẢI TUÂN THỦ
+
+### Critical Rules
+- ❌ No Secrets: KHÔNG hardcode API keys, passwords, JWT secrets. Dùng env vars.
+- ❌ No Auto Push: KHÔNG `git push`. Commit OK, push HỎI USER.
+- ❌ No Destructive Ops: KHÔNG `rm -rf`, `DROP TABLE`, `git reset --hard`.
+- ❌ No PII In Logs: KHÔNG log password, token, CMND, phone.
+- ❌ No Placeholder Code: KHÔNG `// TODO`. Mỗi function PHẢI có logic thực tế.
+
+### Backend
+- Input validation @Valid ở Controller. Business logic CHỈ trong Service.
+- GlobalExceptionHandler — KHÔNG expose stack trace.
+- Auth mọi route (default deny). Flyway migrations + rollback.
+
+### Frontend
+- Styles trong .scss (KHÔNG inline). Reuse PrimeNG + shared/ components.
+- i18n tất cả text. Accessibility: alt, aria-label. KHÔNG document.querySelector().
+- Responsive: Desktop + Tablet + Mobile.
+
+### Security
+- SQL: JOOQ type-safe, KHÔNG string concat. XSS: Angular interpolation, KHÔNG innerHTML.
+- JWT RS256 only, key ≥ 2048 bits, exp ≤ 24h.
+- File upload: extension whitelist + MIME + UUID rename + MinIO.
+- LUÔN dùng DTO response, KHÔNG Entity trực tiếp.
+- Anti-vibe-coding: sửa >3 lần cùng đoạn → DỪNG NGAY.
+
+### Checkpoint
+Trước phiên AI: `git checkout -b feature/ai-task-xxx` hoặc commit checkpoint.
+
+---
+
+## Safety (NON-NEGOTIABLE)
+```
+❌ git push | ❌ rm -rf src/ | ❌ hardcode secrets | ❌ log PII | ❌ expose stack trace
+✅ checkpoint trước AI | ✅ test trước commit | ✅ DTO response | ✅ @Valid input
+```
+
+---
+
+## Commands Guide
+> Cursor không có slash commands. User gõ tự nhiên:
+- "Tạo feature mới quản lý công suất" → Cursor đọc rules + conventions
+- "Fix bug lỗi validate ngày" → Cursor áp dụng security + backend rules
+- "Scan ATTT module customer" → Cursor chạy scan commands theo security rules
+
+---
+
+## Integration Map
+| Service | Protocol | Usage |
+|---------|----------|-------|
+| EVN SSO | JWT (RS256) | Authentication |
+| MinIO | S3 API | File storage |
+| Redis | TCP | Session + cache |
+| CMIS | HTTP | Document management |
+
+---
+
+> ⚠️ File này chứa sections "CHƯA KHỞI TẠO". Tham khảo `.cursor/rules/` cho chi tiết.

package/templates/instruct/Instruct-Agent-AI.be.md

@@ -0,0 +1,96 @@
+# Instruct-Agent-AI.md — Backend
+# Project: {{PROJECT_NAME}} | Tech: {{TECH_STACK}} | DB: {{DATABASE}}
+# Generated by evnict-kit v0.1.3
+
+---
+
+## Hướng dẫn Agent khởi tạo Backend Project
+
+Bạn là AI Agent đang khởi tạo cấu hình cho project backend.
+Đọc hướng dẫn dưới đây và thực hiện TỪNG BƯỚC.
+
+---
+
+## Bước 1: Đọc rules hiện tại
+Đọc tất cả files trong `{{AGENT_DIR}}/rules/`:
+- `01-evnict-kit-general-rules.md` → Nắm general rules
+- `02-evnict-kit-security-rules.md` → Nắm security rules
+- `03-evnict-kit-backend-conventions.md` → Nắm BE conventions
+- `05-evnict-kit-project-conventions.md` → Xem sections cần điền
+
+## Bước 2: Chạy `/evnict-kit:init-rules`
+Skill này sẽ hướng dẫn bạn:
+
+### Task 1: Scan project structure
+```bash
+tree -L 3 --dirsfirst
+```
+→ Ghi nhận package structure, module organization
+
+### Task 2: RP01 — Naming Convention
+Đọc 5-10 file Java → extract naming patterns:
+- Package: `com.evn.{{PROJECT_NAME}}.{module}`
+- Class: `{Module}{Type}.java`
+- Method: camelCase, prefix find/get/create/update/delete
+- Table/Column: UPPER_SNAKE_CASE
+→ Cập nhật RP01 trong `05-evnict-kit-project-conventions.md`
+
+### Task 3: RP02 — Architecture Pattern
+Phân tích folder structure → xác định:
+- Architecture type (MVC, Clean, Hexagonal)
+- Layer organization
+- Module organization
+→ Cập nhật RP02
+
+### Task 4: RP03 — Coding Convention
+Đọc code → extract:
+- Indentation, import ordering
+- Method ordering, comment style
+- Logging framework, null handling
+→ Cập nhật RP03
+
+### Task 5: RP04 — API Convention
+Đọc Controller classes → extract:
+- Base URL pattern, HTTP methods
+- Request/Response format (ResponseData)
+- Pagination pattern
+→ Cập nhật RP04
+
+### Task 6: RP05 — Database Convention
+Đọc migration scripts, config → extract:
+- Schema structure, naming
+- PK pattern, audit columns
+- Soft delete pattern
+→ Cập nhật RP05
+
+### Task 7: RP07 — Integration Map
+Đọc dependencies, config files → extract:
+- External services (SSO, MinIO, CMIS)
+- Cache, messaging
+→ Cập nhật RP07
+
+### Task 8: Summary
+Tạo file `{{AGENT_DIR}}/context/init-summary-backend.md`:
+```markdown
+# Init Summary — Backend
+## Date: {YYYY-MM-DD}
+## Conventions found: {count}/7
+## Key findings:
+- {finding 1}
+- {finding 2}
+```
+
+## Bước 3: Chạy `/evnict-kit:init-context`
+→ Sinh file AGENTS.md ở root project (400-600 dòng)
+
+## Bước 4: Chạy `/evnict-kit:init-check`  
+→ Sinh demo code để verify setup
+
+---
+
+## Bảo mật — NGHIÊM CẤM
+- ❌ KHÔNG ghi secrets, passwords, API keys
+- ❌ KHÔNG ghi IP nội bộ, URLs production
+- ❌ KHÔNG ghi connection strings
+- ❌ KHÔNG ghi thông tin nhân sự, tổ chức cụ thể
+- ✅ Chỉ ghi PATTERNS, không ghi VALUES

package/templates/instruct/Instruct-Agent-AI.fe.md

@@ -0,0 +1,79 @@
+# Instruct-Agent-AI.md — Frontend
+# Project: {{PROJECT_NAME}} | Tech: {{TECH_STACK}}
+# Generated by evnict-kit v0.1.3
+
+---
+
+## Hướng dẫn Agent khởi tạo Frontend Project
+
+Bạn là AI Agent đang khởi tạo cấu hình cho project frontend.
+Đọc hướng dẫn dưới đây và thực hiện TỪNG BƯỚC.
+
+---
+
+## Bước 1: Đọc rules hiện tại
+Đọc tất cả files trong `{{AGENT_DIR}}/rules/`:
+- `01-evnict-kit-general-rules.md` → Nắm general rules
+- `02-evnict-kit-security-rules.md` → Nắm security rules
+- `04-evnict-kit-frontend-conventions.md` → Nắm FE conventions
+- `05-evnict-kit-project-conventions.md` → Xem sections cần điền
+
+## Bước 2: Chạy `/evnict-kit:init-rules`
+
+### Task 1: Scan project structure
+```bash
+tree -L 3 --dirsfirst
+```
+
+### Task 2: RP01 — Naming Convention
+Đọc component, service, module files → extract:
+- Component naming: `{name}.component.ts`
+- Service naming: `{name}.service.ts`
+- Selector prefix: `app-`
+- File structure patterns
+→ Cập nhật RP01
+
+### Task 3: RP02 — Architecture Pattern
+Phân tích folder structure → xác định:
+- Module organization (feature-based, core/shared/features)
+- Routing pattern (lazy-loaded modules)
+- State management approach
+→ Cập nhật RP02
+
+### Task 4: RP03 — Coding Convention
+Đọc TypeScript files → extract:
+- Indentation, import ordering
+- Component structure (properties → constructor → lifecycle → methods)
+- RxJS patterns (takeUntil, async pipe)
+→ Cập nhật RP03
+
+### Task 5: RP06 — Component Convention
+Đọc component files → extract:
+- Shared vs feature components
+- UI library usage (PrimeNG components)
+- Form handling (Reactive Forms / Template-driven)
+- State management
+→ Cập nhật RP06
+
+### Task 6: RP07 — Integration Map
+Đọc environment files, services → extract:
+- API base URLs pattern
+- Auth interceptor
+- File upload service
+→ Cập nhật RP07
+
+### Task 7: Summary
+Tạo file `{{AGENT_DIR}}/context/init-summary-frontend.md`
+
+## Bước 3: Chạy `/evnict-kit:init-context`
+→ Sinh file AGENTS.md ở root project
+
+## Bước 4: Chạy `/evnict-kit:init-check`
+→ Sinh demo component để verify setup
+
+---
+
+## Bảo mật — NGHIÊM CẤM
+- ❌ KHÔNG ghi secrets, API keys
+- ❌ KHÔNG ghi production URLs/IPs
+- ✅ Chỉ ghi PATTERNS, không ghi VALUES