@musashishao/agent-kit 1.6.2 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/.agent/rules/CODEX.md +8 -7
  2. package/.agent/rules/CODE_RULES.md +15 -0
  3. package/.agent/rules/REFERENCE.md +7 -2
  4. package/.agent/skills/brainstorming/SKILL.md +52 -0
  5. package/.agent/skills/frontend-design/SKILL.md +30 -0
  6. package/.agent/skills/git-worktrees/SKILL.md +181 -0
  7. package/.agent/skills/parallel-agents/SKILL.md +89 -0
  8. package/.agent/skills/react-patterns/SKILL.md +31 -0
  9. package/.agent/skills/react-patterns/bundle-patterns.md +129 -0
  10. package/.agent/skills/react-patterns/rerender-patterns.md +163 -0
  11. package/.agent/skills/react-patterns/server-patterns.md +146 -0
  12. package/.agent/skills/react-patterns/waterfall-patterns.md +102 -0
  13. package/.agent/skills/reader-testing/SKILL.md +183 -0
  14. package/.agent/skills/verification-gate/SKILL.md +129 -0
  15. package/.agent/skills/web-interface-guidelines/SKILL.md +94 -0
  16. package/.agent/skills/web-interface-guidelines/animation.md +153 -0
  17. package/.agent/skills/web-interface-guidelines/anti-patterns.md +204 -0
  18. package/.agent/skills/web-interface-guidelines/focus-states.md +104 -0
  19. package/.agent/skills/web-interface-guidelines/forms.md +154 -0
  20. package/.agent/skills/web-interface-guidelines/touch-interaction.md +150 -0
  21. package/.agent/workflows/autofix.md +4 -1
  22. package/.agent/workflows/brainstorm.md +1 -1
  23. package/.agent/workflows/context.md +3 -1
  24. package/.agent/workflows/create.md +1 -1
  25. package/.agent/workflows/dashboard.md +4 -1
  26. package/.agent/workflows/debug.md +1 -1
  27. package/.agent/workflows/deploy.md +1 -1
  28. package/.agent/workflows/enhance.md +1 -1
  29. package/.agent/workflows/next.md +4 -1
  30. package/.agent/workflows/orchestrate.md +1 -1
  31. package/.agent/workflows/plan.md +1 -1
  32. package/.agent/workflows/preview.md +1 -1
  33. package/.agent/workflows/quality.md +1 -1
  34. package/.agent/workflows/spec.md +1 -1
  35. package/.agent/workflows/status.md +1 -1
  36. package/.agent/workflows/test.md +1 -1
  37. package/.agent/workflows/ui-ux-pro-max.md +1 -1
  38. package/README.md +3 -3
  39. package/package.json +1 -1
@@ -0,0 +1,150 @@
1
+ # Touch & Interaction Guidelines
2
+
3
+ > Mobile-first patterns for touch interfaces.
4
+
5
+ ---
6
+
7
+ ## Touch Action
8
+
9
+ **Prevent double-tap zoom delay.**
10
+
11
+ ```css
12
+ /* ✅ On interactive elements */
13
+ button, a, [role="button"] {
14
+ touch-action: manipulation;
15
+ }
16
+ ```
17
+
18
+ | Value | Effect |
19
+ |-------|--------|
20
+ | `manipulation` | Disables double-tap zoom |
21
+ | `pan-x` | Only horizontal scroll |
22
+ | `pan-y` | Only vertical scroll |
23
+ | `none` | Disable all gestures |
24
+
25
+ ---
26
+
27
+ ## Tap Highlight
28
+
29
+ **Set intentionally, not accidentally.**
30
+
31
+ ```css
32
+ /* ✅ Remove or customize */
33
+ button {
34
+ -webkit-tap-highlight-color: transparent;
35
+ /* Or: -webkit-tap-highlight-color: rgba(0, 0, 0, 0.1); */
36
+ }
37
+ ```
38
+
39
+ ---
40
+
41
+ ## Overscroll Behavior
42
+
43
+ **Contain scroll in modals and drawers.**
44
+
45
+ ```css
46
+ /* ✅ Modal content */
47
+ .modal-content {
48
+ overscroll-behavior: contain;
49
+ }
50
+
51
+ /* ✅ Drawer/sheet */
52
+ .drawer {
53
+ overscroll-behavior-y: contain;
54
+ }
55
+ ```
56
+
57
+ This prevents:
58
+ - Pull-to-refresh triggering inside modal
59
+ - Scroll chaining to body
60
+ - Rubber-band bounce on iOS
61
+
62
+ ---
63
+
64
+ ## Safe Areas
65
+
66
+ **Full-bleed layouts need notch handling.**
67
+
68
+ ```css
69
+ /* ✅ Account for notch/home indicator */
70
+ .full-bleed {
71
+ padding-left: env(safe-area-inset-left);
72
+ padding-right: env(safe-area-inset-right);
73
+ padding-bottom: env(safe-area-inset-bottom);
74
+ }
75
+
76
+ /* ✅ Fixed bottom bar */
77
+ .bottom-bar {
78
+ padding-bottom: max(1rem, env(safe-area-inset-bottom));
79
+ }
80
+ ```
81
+
82
+ | Device | Safe Area Needed |
83
+ |--------|------------------|
84
+ | iPhone X+ | Notch, home indicator |
85
+ | Android | Navigation bar |
86
+ | iPad | Corners on newer models |
87
+
88
+ ---
89
+
90
+ ## Drag Interactions
91
+
92
+ **Disable selection during drag.**
93
+
94
+ ```tsx
95
+ // ✅ During drag operations
96
+ const handleDragStart = () => {
97
+ document.body.style.userSelect = 'none';
98
+ };
99
+
100
+ const handleDragEnd = () => {
101
+ document.body.style.userSelect = '';
102
+ };
103
+ ```
104
+
105
+ Also use `inert` on dragged elements:
106
+ ```tsx
107
+ <div inert={isDragging}>
108
+ {/* Content that shouldn't be interactive while dragging */}
109
+ </div>
110
+ ```
111
+
112
+ ---
113
+
114
+ ## AutoFocus
115
+
116
+ **Use sparingly, desktop only.**
117
+
118
+ ```tsx
119
+ // ✅ Single primary input, desktop
120
+ <input autoFocus={!isMobile} />
121
+
122
+ // ❌ Avoid on mobile (keyboard popup)
123
+ <input autoFocus /> // Opens keyboard unexpectedly
124
+ ```
125
+
126
+ | Use autoFocus | Avoid autoFocus |
127
+ |---------------|-----------------|
128
+ | Search modal | Mobile forms |
129
+ | Command palette | Multi-step forms |
130
+ | Login (desktop) | Login (mobile) |
131
+
132
+ ---
133
+
134
+ ## Touch Target Size
135
+
136
+ **Minimum 44x44px for touch targets.**
137
+
138
+ ```css
139
+ /* ✅ Comfortable touch target */
140
+ button {
141
+ min-height: 44px;
142
+ min-width: 44px;
143
+ padding: 12px 16px;
144
+ }
145
+
146
+ /* ✅ Icon button with adequate padding */
147
+ .icon-button {
148
+ padding: 12px;
149
+ }
150
+ ```
@@ -1,9 +1,12 @@
1
1
  ---
2
- description: Autonomous Self-Healing Loop to fix failing commands
2
+ description: Vòng lặp tự sửa lỗi autonomous cho các lệnh thất bại
3
3
  ---
4
4
 
5
5
  # /autofix - Autonomous Self-Healing Loop
6
6
 
7
+ $ARGUMENTS
8
+
9
+
7
10
  ## Purpose
8
11
  Attempts to automatically fix a failing command (test, build, or script) by entering a "Run -> Analyze -> Fix -> Verify" loop. This workflow leverages the Agent's ability to read error logs and edit code autonomously.
9
12
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Structured brainstorming for projects and features. Explores multiple options before implementation.
2
+ description: Brainstorming cấu trúc cho dự án và tính năng. Khám phá nhiều phương án trước khi triển khai.
3
3
  ---
4
4
 
5
5
  # /brainstorm - Structured Idea Exploration
@@ -1,9 +1,11 @@
1
1
  ---
2
- description: Auto-generate optimized context for complex tasks using Context Engineering strategies.
2
+ description: Tự động tạo context tối ưu cho các tác vụ phức tạp sử dụng chiến lược Context Engineering.
3
3
  ---
4
4
 
5
5
  # Context Optimization Workflow
6
6
 
7
+ $ARGUMENTS
8
+
7
9
  This workflow automates the "Context Engineering" process. It analyzes your request, maps the project structure, summarizes relevant files, and wraps everything in a high-performance XML prompt structure for the AI.
8
10
 
9
11
  **Trigger:** `/context [your task description]`
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Create new application command. Triggers App Builder skill and starts interactive dialogue with user.
2
+ description: Lệnh tạo ứng dụng mới. Kích hoạt skill App Builder bắt đầu đối thoại với người dùng.
3
3
  ---
4
4
 
5
5
  # /create - Create Application
@@ -1,9 +1,12 @@
1
1
  ---
2
- description: Generate and view the visual project dashboard
2
+ description: Tạo xem dashboard trực quan của dự án
3
3
  ---
4
4
 
5
5
  # /dashboard - Visual Project Overview
6
6
 
7
+ $ARGUMENTS
8
+
9
+
7
10
  ## Purpose
8
11
  Generates a rich, interactive HTML dashboard that visualizes the project's status, agents, active plans, and dependency graphs. Provides a high-level view for "Vibe Coders" and stakeholders.
9
12
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Debugging command. Activates DEBUG mode for systematic problem investigation.
2
+ description: Lệnh debug. Kích hoạt chế độ DEBUG để điều tra vấn đề có hệ thống.
3
3
  ---
4
4
 
5
5
  # /debug - Systematic Problem Investigation
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Deployment command for production releases. Pre-flight checks and deployment execution.
2
+ description: Lệnh deploy cho production. Kiểm tra pre-flight thực thi deployment.
3
3
  ---
4
4
 
5
5
  # /deploy - Production Deployment
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Add or update features in existing application. Used for iterative development.
2
+ description: Thêm hoặc cập nhật tính năng trong ứng dụng hiện có. Dùng cho phát triển lặp.
3
3
  ---
4
4
 
5
5
  # /enhance - Update Application
@@ -1,9 +1,12 @@
1
1
  ---
2
- description: Suggest the immediate next step for the developer
2
+ description: Đề xuất bước tiếp theo cho developer
3
3
  ---
4
4
 
5
5
  # /next - What Should I Do Next?
6
6
 
7
+ $ARGUMENTS
8
+
9
+
7
10
  ## Purpose
8
11
  This command analyzes the current project state, active plans, and recent context to determine the most impactful immediate next step. Use this when you are stuck, returning to a project after a break, or unsure of the priority.
9
12
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Coordinate multiple agents for complex tasks. Use for multi-perspective analysis, comprehensive reviews, or tasks requiring different domain expertise.
2
+ description: Điều phối nhiều agents cho các tác vụ phức tạp. Dùng cho phân tích đa góc nhìn, review toàn diện, hoặc các tác vụ cần nhiều chuyên môn khác nhau.
3
3
  ---
4
4
 
5
5
  # Multi-Agent Orchestration
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Create project plan using project-planner agent. No code writing - only plan file generation.
2
+ description: Tạo project plan sử dụng project-planner agent. Chỉ tạo file plan - không viết code.
3
3
  ---
4
4
 
5
5
  # /plan - Project Planning Mode
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Preview server start, stop, and status check. Local development server management.
2
+ description: Quản lý preview server: start, stop, kiểm tra trạng thái. Quản lý local development server.
3
3
  ---
4
4
 
5
5
  # /preview - Preview Management
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Optimize context and output quality for Codex CLI. Use for complex tasks requiring high-quality results.
2
+ description: Tối ưu hóa context chất lượng output cho Codex CLI. Dùng cho các tác vụ phức tạp cần kết quả chất lượng cao.
3
3
  ---
4
4
 
5
5
  # /quality - Quality Optimization Workflow
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Generate specification document before planning. Use for complex features requiring clear requirements before implementation.
2
+ description: Tạo tài liệu đặc tả (specification) trước khi lập kế hoạch. Dùng cho các tính năng phức tạp cần yêu cầu rõ ràng trước khi triển khai.
3
3
  ---
4
4
 
5
5
  # /spec - Specification Writing Mode
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Display agent and project status. Progress tracking and status board.
2
+ description: Hiển thị trạng thái project và agent. Theo dõi tiến độ và bảng trạng thái.
3
3
  ---
4
4
 
5
5
  # /status - Show Status
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Test generation and test running command. Creates and executes tests for code.
2
+ description: Tạo test chạy test. Tạo thực thi các test cho code.
3
3
  ---
4
4
 
5
5
  # /test - Test Generation and Execution
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Plan and implement UI
2
+ description: Lập kế hoạch và triển khai UI/UX chuyên nghiệp
3
3
  ---
4
4
 
5
5
  # UI/UX Pro Max - Design Intelligence
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  > 🚀 The Ultimate AI Agent System for Modern Development
4
4
  >
5
- > **16 Agents** • **42 Skills** • **13 Workflows** • **Multi-Platform Support**
5
+ > **16 Agents** • **58 Skills** • **13 Workflows** • **Multi-Platform Support**
6
6
 
7
7
  [![npm version](https://badge.fury.io/js/@musashishao%2Fagent-kit.svg)](https://www.npmjs.com/package/@musashishao/agent-kit)
8
8
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -27,8 +27,8 @@ This installs the `.agent` folder containing all templates into your project.
27
27
  | Component | Count | Description |
28
28
  |-----------|-------|-------------|
29
29
  | **Agents** | 16 | Specialist AI personas (frontend, backend, security, etc.) |
30
- | **Skills** | 42 | Domain-specific knowledge modules |
31
- | **Intelligence** | 3 | RAG, Knowledge Graph, and **Memory System** |
30
+ | **Skills** | 58 | Domain-specific knowledge modules |
31
+ | **Intelligence** | 4 | RAG, Knowledge Graph, Memory, and **Verification Gate** |
32
32
  | **Workflows** | 13 | Slash command procedures |
33
33
  | **Templates** | 4 | Project templates (web, mobile, backend) |
34
34
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@musashishao/agent-kit",
3
- "version": "1.6.2",
3
+ "version": "1.8.0",
4
4
  "description": "AI Agent templates - Skills, Agents, Workflows, and AI-Ready Data Infrastructure Gateway",
5
5
  "main": "index.js",
6
6
  "bin": {