@votruongdanh/ai-agent-skills 3.3.4 → 3.4.1

package/.agents/.skills-version

@@ -1 +1 @@
-3.3.3
+3.4.0

package/.agents/skills/agents/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: agents
 description: "Agent routing system — automatically selects the best specialist agent based on user request domain. Handles keyword matching, Vietnamese and English triggers, compound-keyword routing, vague-request fallback, and multi-agent coordination. This skill is always loaded silently."
+encoding: "UTF-8"
 metadata:
   category: system
   auto-load: true

package/.agents/skills/brainstorm/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: brainstorm
 description: "Ideation, option generation, and feature exploration. Use when the user wants to brainstorm ideas, explore options, compare approaches, or generate creative solutions. Triggers: brainstorm, ideate, options, ý tưởng, so sánh phương án."
+encoding: "UTF-8"
 agents: [project-planner, orchestrator]
 related-skills: [plan, create, orchestrate]
 ---

package/.agents/skills/clean/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: clean
 description: "Clean up junk files, temporary files, AI-generated artifacts, and caches. Use when the user wants to remove unused files, reduce repo clutter, or update .gitignore. Triggers: clean, remove junk, dọn dẹp, xoá file rác, cache."
+encoding: "UTF-8"
 agents: [devops-engineer]
 related-skills: [status, enhance]
 ---

package/.agents/skills/create/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: create
 description: "Build new features, files, components, endpoints, pages, or scripts. Use when the user wants to create something new in the codebase. Triggers: create, build, add, new, scaffold, tạo, thêm mới, tạo trang, tạo API."
+encoding: "UTF-8"
 agents: [backend-specialist, frontend-specialist, database-architect]
 related-skills: [plan, test, debug]
 ---

package/.agents/skills/debug/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: debug
 description: "Root-cause analysis for bugs, failing commands, broken behavior, and error logs. Use when the user encounters errors, crashes, or unexpected behavior. Triggers: debug, fix, bug, error, crash, lỗi, sửa lỗi, hỏng, fail."
+encoding: "UTF-8"
 agents: [debugger, backend-specialist, frontend-specialist]
 related-skills: [test, enhance, status]
 ---

package/.agents/skills/deploy/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: deploy
 description: "Deployment steps, release preparation, environment setup, CI/CD guidance, and production rollout. Use when the user wants to deploy, release, or set up infrastructure. Triggers: deploy, release, CI/CD, docker, production, triển khai, phát hành, đưa lên production."
+encoding: "UTF-8"
 agents: [devops-engineer, security-auditor]
 related-skills: [test, status, plan]
 ---

package/.agents/skills/enhance/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: enhance
 description: "Improve existing code — refactor, optimize performance, tighten security, or enhance UX. Use when the user wants to make code better without changing its purpose. Triggers: enhance, improve, refactor, optimize, review, cải thiện, tối ưu, nhanh hơn, code dài quá."
+encoding: "UTF-8"
 agents: [performance-optimizer, security-auditor, frontend-specialist]
 related-skills: [debug, test, plan]
 ---

package/.agents/skills/explain/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: explain
 description: "Explain code, walk through logic, and help understand architecture or behavior. Use when the user asks what code does, how something works, or wants a walkthrough. Triggers: explain, what does this do, how does this work, giải thích, giải thích code, code này làm gì."
+encoding: "UTF-8"
 agents: [documentation-writer, backend-specialist, frontend-specialist]
 related-skills: [debug, enhance, status]
 ---
@@ -65,6 +66,7 @@ If any answer is unclear, ASK before proceeding.
 - If the code is unclear or has issues, mention them without derailing the explanation.
 - Avoid proposing wide changes mid-explanation; if improvement requires broader edits, ASK before switching to implementation.
 - Always read and update the memory file.
+ - Code encoding: All code snippets and files referenced or produced must be UTF-8 encoded. When providing example files, ensure they use UTF-8 and indicate `encoding: "UTF-8"` in front-matter where applicable.
 
 ## Related Skills
 - `/debug` → read `.kiro/skills/debug/SKILL.md` — If explanation reveals bugs

package/.agents/skills/integrate/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: integrate
 description: "Integrate provided sample code/snippets into the existing system with minimal changes and minimal risk. Use when the user gives a code mẫu and wants to merge it into current project. Triggers: integrate, merge snippet, gộp code mẫu, ghép code, áp code mẫu vào hệ thống."
+encoding: "UTF-8"
 agents: [backend-specialist, frontend-specialist, debugger]
 related-skills: [plan, test, debug, enhance]
 ---

package/.agents/skills/motion-ui/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: motion-ui
 description: "Advanced Motion UI (AMUI) — Create clean, modern UI with subtle Framer Motion micro-interactions, clear states (idle/loading/success/error), consistent styling via design tokens, and smooth animations. Use when the user wants motion-rich, polished UI with micro-interactions. Triggers: motion, animation, framer motion, micro-interaction, smooth ui, amui, chuyển động, hiệu ứng mượt."
+encoding: "UTF-8"
 agents: [frontend-specialist]
 related-skills: [create, ui-ux-pro-max, enhance]
 ---

package/.agents/skills/orchestrate/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: orchestrate
 description: "Coordinate multi-step plans across multiple roles, files, systems, or parallel workstreams. Use when the user has a complex request spanning multiple domains or needing decomposition. Triggers: orchestrate, coordinate, multi-step, full-stack, tổng hợp, làm nhiều bước."
+encoding: "UTF-8"
 agents: [orchestrator, project-planner]
 related-skills: [plan, create, deploy, test]
 ---

package/.agents/skills/plan/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: plan
 description: "Create concrete implementation plans with milestones, task breakdowns, and estimates. Use when the user wants to plan, organize work, or create a roadmap. Triggers: plan, milestone, breakdown, roadmap, estimate, kế hoạch, lên kế hoạch, phân chia công việc."
+encoding: "UTF-8"
 agents: [project-planner, orchestrator]
 related-skills: [brainstorm, create, orchestrate]
 ---

package/.agents/skills/preview/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: preview
 description: "Preview expected output, UX flows, copy, interaction design, or generated content before implementing. Use when the user wants to see what something will look like. Triggers: preview, mockup, show me, xem trước, thử xem, mô phỏng."
+encoding: "UTF-8"
 agents: [frontend-specialist, documentation-writer]
 related-skills: [create, ui-ux-pro-max, plan]
 ---

package/.agents/skills/status/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: status
 description: "Project status summary, progress snapshots, repo overview, and outstanding work tracking. Use when the user wants to know where a project stands. Triggers: status, progress, overview, what's done, dự án đang ở đâu, tiến độ, tổng quan."
+encoding: "UTF-8"
 agents: [project-planner, orchestrator]
 related-skills: [plan, debug, deploy]
 ---

package/.agents/skills/test/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: test
 description: "Write tests, improve coverage, define test strategy, and add validation. Use when the user wants to test code, add unit/integration/e2e tests, or check coverage. Triggers: test, coverage, jest, vitest, playwright, spec, kiểm thử, viết test."
+encoding: "UTF-8"
 agents: [test-engineer, debugger]
 related-skills: [debug, create, enhance]
 ---

package/.agents/skills/ui-ux-pro-max/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: ui-ux-pro-max
 description: "Advanced UI/UX improvements — layout, design critique, copy refinement, interaction design, accessibility, and responsive patterns. Use when the user wants professional-grade UI/UX upgrades. Triggers: ui, ux, design, layout, responsive, giao diện, thiết kế, cải thiện UI."
+encoding: "UTF-8"
 agents: [frontend-specialist, performance-optimizer]
 related-skills: [create, preview, enhance]
 ---

package/.kiro/.skills-version

@@ -1 +1 @@
-3.3.3
+3.4.0

package/.kiro/skills/_scripts/.ai-memory-template.md

@@ -0,0 +1,55 @@
+# Project Memory
+
+> This file is automatically maintained by AI Agent Skills.
+> It persists project understanding across conversations.
+> **Do NOT delete this file** — it helps AI give better, context-aware responses.
+
+## Codex Memory Structure (when available)
+- If the workspace has `memories/`, use it alongside this file.
+- `memories/` = persistent user-level notes.
+- `memories/session/` = temporary notes for current conversation.
+- `memories/repo/` = repository-scoped technical facts and conventions.
+- Keep `.ai-memory.md` as the cross-IDE source of truth; mirror only high-signal repo facts into `memories/repo/`.
+
+## Memory Compaction Rules (IMPORTANT)
+- **Write style**: concise bullets, no paragraphs. Prefer numbers, filenames, and nouns over prose.
+- **No duplication**: if a new note repeats an existing one, update the existing bullet instead of appending.
+- **Deduping rule (anti-duplicate)**:
+  - Before writing, **scan the target section** for a similar bullet.
+  - Consider bullets “similar” if they match after: lowercasing + trimming + collapsing whitespace + removing trailing punctuation.
+  - If similar: **merge into 1 bullet** (keep the most specific wording, add missing file paths/IDs).
+  - Never keep 2 bullets that describe the same decision/issue/work item.
+- **Hard limits**:
+  - Tech Stack: max 6 bullets
+  - Architecture: max 8 bullets
+  - Conventions: max 8 bullets
+  - Decisions: keep last 12 items
+  - Known Issues: keep last 20 items (closed issues can be removed once stable)
+  - Recent Work: keep last 15 items
+- **Per bullet**: aim ≤ 140 characters. If longer, split into 2 bullets.
+- **Always include**: files touched (paths), and why (1 short phrase).
+
+## Tech Stack
+- Language: (auto-detected on first use)
+- Framework: (auto-detected on first use)
+- Database: (if any)
+- Package manager: (auto-detected)
+
+## Architecture
+- Pattern: (discovered)
+- Key directories: (discovered)
+- Entry points: (discovered)
+
+## Conventions
+- Naming: (observed from codebase)
+- File structure: (observed)
+- Testing: (framework + patterns observed)
+
+## Decisions
+<!-- Format: - [YYYY-MM-DD] Decision description and rationale -->
+
+## Known Issues
+<!-- Format: - [status] Issue description -->
+
+## Recent Work
+<!-- Format: - [YYYY-MM-DD] What was done, files changed, outcome -->

package/.kiro/skills/_scripts/checklist.md

@@ -0,0 +1,35 @@
+---
+name: checklist
+description: Reusable pre/post checklists for any skill execution
+---
+
+## Pre-Execution Checklist (Run before ANY skill)
+- [ ] Read `.ai-memory.md` from project root
+- [ ] Understand user intent (ask if unclear)
+- [ ] Check if similar work was done before (from memory)
+- [ ] Identify the correct agent for the domain
+- [ ] Minimize blast radius: identify the smallest set of files that must change
+- [ ] If any step is uncertain or could cause broad changes, ask before editing
+
+## Post-Execution Checklist (Run after ANY skill)
+- [ ] All checklist items from the skill are satisfied
+- [ ] No regressions introduced
+- [ ] Code follows existing project conventions
+- [ ] Update `.ai-memory.md` with findings (follow "Memory Compaction Rules")
+- [ ] Dedupe `.ai-memory.md` updates: merge similar bullets instead of appending duplicates
+- [ ] If `.ai-memory.md` exceeds 500 lines or sections exceed limits, compact it (see `.kiro/skills/_scripts/memory-compact.md`)
+- [ ] Suggest related next steps
+
+## Code Quality Checklist
+- [ ] No hardcoded secrets or credentials
+- [ ] Error handling at system boundaries
+- [ ] Input validation for user-facing code
+- [ ] Existing tests still pass
+- [ ] New code is covered by tests (if test framework exists)
+
+## Security Checklist
+- [ ] No SQL injection vectors
+- [ ] No XSS vulnerabilities
+- [ ] No exposed secrets in code or logs
+- [ ] Dependencies are up to date
+- [ ] Access controls are appropriate

package/.kiro/skills/_scripts/memory-compact.md

@@ -0,0 +1,142 @@
+---
+name: memory-compact
+description: Procedure to compact `.ai-memory.md` when it grows too long
+---
+
+## When to compact
+Run this procedure when `.ai-memory.md` exceeds **500 lines** or when you notice:
+- Duplicate or near-duplicate bullets
+- Outdated information (old decisions, resolved issues, ancient work items)
+- Verbose bullets that could be shortened
+- Sections exceeding their hard limits (see Memory Compaction Rules)
+
+## Compaction procedure
+
+### 1. Check section limits (from `.ai-memory-template.md`)
+- **Tech Stack**: max 6 bullets
+- **Architecture**: max 8 bullets
+- **Conventions**: max 8 bullets
+- **Decisions**: keep last 12 items
+- **Known Issues**: keep last 20 items (remove resolved/closed)
+- **Recent Work**: keep last 15 items
+
+### 2. Dedupe within each section
+For each section:
+1. Read all bullets
+2. Group similar bullets (same topic, same file, same decision)
+3. Merge groups into single bullets:
+   - Keep most specific wording
+   - Preserve all file paths, dates, IDs
+   - Remove redundant phrases
+
+**Example:**
+```markdown
+Before:
+- [2024-01-15] Added auth middleware to protect routes
+- [2024-01-16] Implemented authentication middleware in src/middleware/auth.js
+- Auth middleware added for route protection
+
+After:
+- [2024-01-15] Added auth middleware (src/middleware/auth.js) to protect routes
+```
+
+### 3. Remove outdated items
+- **Decisions**: Keep only decisions still relevant to current architecture
+- **Known Issues**: Remove resolved/closed issues older than 30 days
+- **Recent Work**: Keep only last 15 items (remove older)
+
+### 4. Shorten verbose bullets
+Target: ≤ 140 characters per bullet
+
+**Techniques:**
+- Remove filler words: "basically", "essentially", "in order to"
+- Use abbreviations: "impl" for "implemented", "cfg" for "config"
+- Use file paths instead of descriptions: `src/auth.js` not "the authentication file"
+- Use symbols: `+` for "added", `~` for "updated", `-` for "removed"
+
+**Example:**
+```markdown
+Before:
+- [2024-01-15] We implemented a new authentication system that uses JWT tokens for user sessions in the backend API
+
+After:
+- [2024-01-15] + JWT auth system (src/api/auth.js) for user sessions
+```
+
+### 5. Enforce hard limits
+If a section still exceeds limits after deduping and shortening:
+- **Decisions**: Keep last 12, archive older ones in a comment
+- **Known Issues**: Keep last 20, remove oldest resolved
+- **Recent Work**: Keep last 15, remove oldest
+
+**Archive pattern:**
+```markdown
+## Decisions
+- [2024-03-01] Current decision 1
+- [2024-02-28] Current decision 2
+...
+
+<!-- Archived decisions (for reference):
+- [2024-01-15] Old decision that's no longer relevant
+-->
+```
+
+### 6. Verify compaction
+After compacting:
+- [ ] No section exceeds hard limits
+- [ ] No duplicate bullets
+- [ ] All bullets ≤ 140 characters (or split into 2)
+- [ ] File paths preserved
+- [ ] Dates preserved
+- [ ] Recent/important info retained
+
+## Quick compaction (when in a hurry)
+If you need to compact quickly:
+1. **Recent Work**: Keep last 15, delete rest
+2. **Known Issues**: Remove all resolved/closed, keep last 20
+3. **Decisions**: Keep last 12
+4. Run dedupe on remaining bullets (merge similar ones)
+
+## Automation tip
+When updating memory, always:
+1. Check if section is at limit BEFORE adding
+2. If at limit, remove oldest item OR merge with existing
+3. Never append if it creates a duplicate
+
+## Example: Full compaction
+
+**Before (verbose, duplicates, over limits):**
+```markdown
+## Recent Work
+- [2024-01-10] Added login page
+- [2024-01-11] Created login component
+- [2024-01-12] Implemented login functionality
+- [2024-01-13] Fixed login bug
+- [2024-01-14] Updated login styles
+- [2024-01-15] Added logout button
+- [2024-01-16] Implemented logout functionality
+- [2024-01-17] Fixed logout bug
+- [2024-01-18] Added user profile page
+- [2024-01-19] Created user profile component
+- [2024-01-20] Implemented profile edit
+- [2024-01-21] Fixed profile bug
+- [2024-01-22] Added settings page
+- [2024-01-23] Created settings component
+- [2024-01-24] Implemented settings save
+- [2024-01-25] Fixed settings bug
+- [2024-01-26] Added dashboard
+- [2024-01-27] Created dashboard component
+```
+
+**After (compact, deduped, within limits):**
+```markdown
+## Recent Work
+- [2024-01-27] + Dashboard (src/pages/Dashboard.jsx)
+- [2024-01-26] + Settings page (src/pages/Settings.jsx) with save functionality
+- [2024-01-22] + User profile page (src/pages/Profile.jsx) with edit feature
+- [2024-01-15] + Login/logout (src/pages/Login.jsx, src/components/LogoutBtn.jsx)
+```
+
+## Related
+- Read `.kiro/skills/_scripts/.ai-memory-template.md` for Memory Compaction Rules
+- Read `.kiro/skills/_scripts/memory-dedupe.md` for dedupe procedure

package/.kiro/skills/_scripts/memory-dedupe.md

@@ -0,0 +1,26 @@
+---
+name: memory-dedupe
+description: Lightweight dedupe procedure for `.ai-memory.md` updates
+---
+
+## When to use
+Run mentally for every memory update, especially when adding items to **Decisions**, **Known Issues**, or **Recent Work**.
+
+## Dedupe procedure (fast)
+1. Pick the **target section** (Decisions / Known Issues / Recent Work / etc.).
+2. Before adding a new bullet, scan existing bullets for a near-match.
+3. Normalize both bullets and compare:
+   - lowercase
+   - trim
+   - collapse whitespace
+   - remove trailing punctuation (`.`, `;`, `,`)
+4. If it’s the same idea:
+   - **merge** into the existing bullet
+   - keep the most concrete version (file paths, error codes, IDs, dates)
+   - remove the redundant one
+5. Only append a new bullet if it’s clearly a new fact/event/decision.
+
+## Examples
+- Two bullets both say “Added auth middleware” → keep one, add the specific files touched.
+- “Fix login bug” and “Fixed login issue” → merge into one with the root cause or PR/files.
+

package/.kiro/skills/_scripts/pre-deploy.md

@@ -0,0 +1,42 @@
+---
+name: pre-deploy
+description: Pre-deployment verification checklist
+---
+
+## Pre-Deploy Checklist
+
+### Code Readiness
+- [ ] All tests pass
+- [ ] No lint errors
+- [ ] Build succeeds
+- [ ] No TODO/FIXME in critical paths
+- [ ] Version number updated (package.json, CHANGELOG)
+
+### Security
+- [ ] No secrets in source code
+- [ ] Environment variables documented
+- [ ] Dependencies audited (`npm audit`)
+- [ ] No known critical vulnerabilities
+
+### Configuration
+- [ ] Environment config is correct for target
+- [ ] Database migrations are ready (if applicable)
+- [ ] API keys and secrets are in environment, not code
+- [ ] Feature flags set appropriately
+
+### Documentation
+- [ ] CHANGELOG updated
+- [ ] README reflects current state
+- [ ] API docs updated (if applicable)
+- [ ] Deployment instructions are current
+
+### Rollback Plan
+- [ ] Previous version tagged
+- [ ] Rollback procedure documented
+- [ ] Database rollback scripts ready (if applicable)
+- [ ] Monitoring alerts configured
+
+## After Deploy
+- [ ] Smoke tests pass
+- [ ] Monitoring shows healthy metrics
+- [ ] Update `.ai-memory.md` with deploy details

package/.kiro/skills/_scripts/verify-all.md

@@ -0,0 +1,28 @@
+---
+name: verify-all
+description: Full verification pass — run all checks across the project
+---
+
+## Steps
+1. **Read Memory** — Load `.ai-memory.md` for known issues
+2. **Structure Check** — Verify project structure matches expectations
+3. **Dependency Check** — Are all dependencies installed and up to date?
+4. **Lint/Format Check** — Does code pass linting and formatting rules?
+5. **Test Check** — Do all existing tests pass?
+6. **Build Check** — Does the project build successfully?
+7. **Security Check** — Run security audit (npm audit, etc.)
+8. **Documentation Check** — Are README and docs up to date?
+9. **Git Check** — Any uncommitted changes? Branch is clean?
+10. **Report** — Summarize findings with pass/fail for each check
+
+## Output Format
+```
+✅ Structure    — OK
+✅ Dependencies — OK  
+⚠️  Lint        — 3 warnings
+❌ Tests       — 1 failure in test/auth.test.js
+✅ Build       — OK
+⚠️  Security   — 2 moderate vulnerabilities
+✅ Docs        — OK
+✅ Git         — Clean
+```

package/.kiro/skills/agents/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: agents
+description: "Agent routing system — automatically selects the best specialist agent based on user request domain. Handles keyword matching, Vietnamese and English triggers, compound-keyword routing, vague-request fallback, and multi-agent coordination. This skill is always loaded silently."
+encoding: "UTF-8"
+metadata:
+  category: system
+  auto-load: true
+---
+
+## Purpose
+This is the master agent routing skill. It analyzes every user request and silently applies the most relevant specialist knowledge.
+
+## Memory Protocol
+**START**: Read `.ai-memory.md` from project root — check which agents were used previously and what domain knowledge has been accumulated.
+**END**: Update `.ai-memory.md` using **Memory Compaction Rules** with which agent was applied and why.
+
+## Agent Selection Matrix
+
+| Domain | Primary Agent | Agent File | Trigger Keywords | Skill Files to Load |
+|--------|--------------|-----------|------------------|---------------------|
+| Bug/Error analysis | @debugger | `.kiro/skills/agents/agents/debugger.md` | debug, lỗi, error, bug, crash, 500, exception, fail, fix, sửa, hỏng, lỗi rồi | `.kiro/skills/debug/SKILL.md`, `.kiro/skills/test/SKILL.md` |
+| API/Backend | @backend-specialist | `.kiro/skills/agents/agents/backend-specialist.md` | api, server, endpoint, route, middleware, auth, jwt, database query, tạo API, backend | `.kiro/skills/create/SKILL.md`, `.kiro/skills/deploy/SKILL.md` |
+| UI/Frontend | @frontend-specialist | `.kiro/skills/agents/agents/frontend-specialist.md` | ui, ux, component, page, css, layout, responsive, animation, tạo trang, giao diện, trang | `.kiro/skills/create/SKILL.md`, `.kiro/skills/ui-ux-pro-max/SKILL.md` |
+| Database | @database-architect | `.kiro/skills/agents/agents/database-architect.md` | database, schema, migration, query, sql, prisma, orm, model, cơ sở dữ liệu | `.kiro/skills/create/SKILL.md`, `.kiro/skills/deploy/SKILL.md` |
+| Security | @security-auditor | `.kiro/skills/agents/agents/security-auditor.md` | security, vulnerability, xss, csrf, injection, auth, encrypt, ssl, bảo mật | `.kiro/skills/debug/SKILL.md`, `.kiro/skills/test/SKILL.md` |
+| DevOps/Deploy | @devops-engineer | `.kiro/skills/agents/agents/devops-engineer.md` | deploy, ci/cd, docker, kubernetes, aws, vercel, pipeline, build, triển khai, phát hành | `.kiro/skills/deploy/SKILL.md` |
+| Testing | @test-engineer | `.kiro/skills/agents/agents/test-engineer.md` | test, coverage, jest, vitest, playwright, e2e, unit test, spec, kiểm thử, viết test | `.kiro/skills/test/SKILL.md` |
+| Performance | @performance-optimizer | `.kiro/skills/agents/agents/performance-optimizer.md` | performance, slow, optimize, cache, bundle, lighthouse, speed, chậm, nhanh hơn, tối ưu | `.kiro/skills/enhance/SKILL.md` |
+| Documentation | @documentation-writer | `.kiro/skills/agents/agents/documentation-writer.md` | docs, readme, api docs, changelog, comment, jsdoc, tài liệu | `.kiro/skills/create/SKILL.md` |
+| Code Explanation | @documentation-writer | `.kiro/skills/agents/agents/documentation-writer.md` | explain, giải thích, walkthrough, how does this work, what does this do, hiểu code | `.kiro/skills/explain/SKILL.md` |
+| Planning/Multi-domain | @orchestrator | `.kiro/skills/agents/agents/orchestrator.md` | orchestrate, coordinate, full-stack, multi-step, complex, tổng hợp | `.kiro/skills/orchestrate/SKILL.md`, `.kiro/skills/plan/SKILL.md` |
+| Project planning | @project-planner | `.kiro/skills/agents/agents/project-planner.md` | plan, milestone, breakdown, estimate, roadmap, sprint, kế hoạch, lên kế hoạch | `.kiro/skills/plan/SKILL.md`, `.kiro/skills/brainstorm/SKILL.md` |
+
+## Compound Keyword Rules (checked BEFORE single keywords)
+
+| Pattern | Route |
+|---------|-------|
+| test + fail/error/broken/lỗi | @debugger → debug test failures (`.kiro/skills/debug/SKILL.md`) |
+| create + test / viết test | @test-engineer → write new tests (`.kiro/skills/test/SKILL.md`) |
+| deploy + fail/error/lỗi | @debugger + @devops-engineer → debug deploy issues (`.kiro/skills/debug/SKILL.md`) |
+| review + code | @security-auditor + @performance-optimizer + @documentation-writer → holistic review (`.kiro/skills/enhance/SKILL.md`) |
+
+## Routing Protocol
+
+1. Analyze the user's request for domain keywords from the matrix above.
+2. Select the primary agent from the matching row.
+3. **Read the agent's persona file** at the path listed in "Agent File" column.
+4. **Read the skill file(s)** listed in "Skill Files to Load" column.
+5. If request spans multiple domains, read `.kiro/skills/agents/agents/orchestrator.md` to coordinate.
+6. Announce: "🤖 Applying @{agent} knowledge..."
+
+## Vague / General Request Fallback
+
+When the user's request does NOT match any domain keywords:
+
+| User says | Action |
+|-----------|--------|
+| "Help me", "What should I do?" | Read `.kiro/skills/status/SKILL.md` → then `.kiro/skills/plan/SKILL.md` |
+| "Review my code", "review code cho tôi" | Read `.kiro/skills/enhance/SKILL.md` with @security-auditor + @performance-optimizer + @documentation-writer (holistic review) |
+| "I'm stuck", "Don't know where to start" | Read `.kiro/skills/status/SKILL.md` → then `.kiro/skills/brainstorm/SKILL.md` |
+| "Explain this", "giải thích code", "how does this work?" | Read `.kiro/skills/explain/SKILL.md` with @documentation-writer |
+| Complaints about code ("too long", "messy", "dài quá", "rối quá") | Read `.kiro/skills/enhance/SKILL.md` or `.kiro/skills/clean/SKILL.md` — ask Socratic Gate to clarify intent |
+| Any multi-part or unclear request | Read `.kiro/skills/agents/agents/orchestrator.md` → triage into sub-tasks |
+| Greeting ("hi", "hello", "xin chào") | Respond warmly, list skills, ask how to help |
+| Empty message | Respond with skill menu, ask what to work on |
+| Completely unclear | Ask ONE clarifying question, then route to the best matching skill |
+
+**Never skip routing for general requests.** General requests need the MOST help, not the least.
+
+## Multi-Agent Scenarios
+
+For complex requests that span domains:
+1. Read `.kiro/skills/agents/agents/orchestrator.md` as coordinator
+2. Orchestrator decomposes task into workstreams
+3. For each workstream, read the specialist agent file from the matrix
+4. Execute sequentially, sharing state via `.ai-memory.md`
+5. Merge results with consistency checks
+
+- [ ] Clean code chuẩn (Standard clean code applied)
+- [ ] Cập nhật đầy đủ tất cả các file liên quan (All related files fully updated)
+
+## Quality Gate
+After completing any routed task, read `.kiro/skills/_scripts/checklist.md` for cross-cutting quality checks.
+
+## Rules
+- Agent selection is SILENT — do not ask the user which agent to use
+- Always announce which agent is being applied
+- **Never skip routing for general/vague requests** — use the fallback table above
+- Never override an explicit user request with agent logic

package/.kiro/skills/agents/agents/backend-specialist.md

@@ -0,0 +1,29 @@
+# @backend-specialist
+
+## Role
+Backend architecture and API expert. Handles server-side logic, APIs, authentication, and data flow.
+
+## Skills
+- create (build endpoints, services)
+- deploy (server deployment)
+- test (API testing)
+- debug (backend bugs)
+
+## Behavior
+- Design RESTful or GraphQL APIs following best practices
+- Implement proper error handling and validation at boundaries
+- Use middleware patterns for cross-cutting concerns
+- Follow security best practices (input validation, auth, rate limiting)
+- Prefer existing patterns in the codebase
+- Consider scalability and performance implications
+
+## Trigger Keywords
+api, server, endpoint, route, middleware, auth, jwt, backend, express, nestjs, fastapi, graphql
+
+## Workflow Pattern
+1. Understand the API contract or service requirement
+2. Check existing patterns in the codebase
+3. Implement with proper validation + error handling
+4. Add authentication/authorization if needed
+5. Suggest tests for critical paths
+6. Document the API contract

package/.kiro/skills/agents/agents/database-architect.md

@@ -0,0 +1,28 @@
+# @database-architect
+
+## Role
+Database design and optimization expert. Handles schemas, migrations, queries, and data modeling.
+
+## Skills
+- create (schema design, migrations)
+- deploy (database deployment)
+- enhance (query optimization)
+
+## Behavior
+- Design normalized schemas with proper relationships
+- Write efficient queries with appropriate indexes
+- Plan migrations that are safe and reversible
+- Consider data integrity constraints
+- Use ORM patterns matching the project (Prisma, TypeORM, Sequelize)
+- Always think about scalability and read/write patterns
+
+## Trigger Keywords
+database, schema, migration, query, sql, prisma, orm, model, index, relation, table, seed
+
+## Workflow Pattern
+1. Understand data requirements and relationships
+2. Design schema with normalization + indexes
+3. Plan migration strategy (reversible)
+4. Implement with ORM matching project conventions
+5. Optimize queries for performance
+6. Add seed data if needed