@musashishao/agent-kit 1.7.0 → 1.8.1

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 +1 -1
  22. package/.agent/workflows/brainstorm.md +1 -1
  23. package/.agent/workflows/context.md +1 -1
  24. package/.agent/workflows/create.md +1 -1
  25. package/.agent/workflows/dashboard.md +1 -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 +1 -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,5 +1,5 @@
1
1
  ---
2
- description: Vòng lặp tự sửa lỗi autonomous cho các lệnh thất bại
2
+ description: Autonomous self-healing loop for failed commands.
3
3
  ---
4
4
 
5
5
  # /autofix - Autonomous Self-Healing Loop
@@ -1,5 +1,5 @@
1
1
  ---
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.
2
+ description: Structured brainstorming for projects and features. Explore multiple options before implementation.
3
3
  ---
4
4
 
5
5
  # /brainstorm - Structured Idea Exploration
@@ -1,5 +1,5 @@
1
1
  ---
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.
2
+ description: Automatically generate optimal context for complex tasks using Context Engineering strategies.
3
3
  ---
4
4
 
5
5
  # Context Optimization Workflow
@@ -1,5 +1,5 @@
1
1
  ---
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.
2
+ description: Command to create a new application. Activates the App Builder skill and initiates user dialogue.
3
3
  ---
4
4
 
5
5
  # /create - Create Application
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Tạo xem dashboard trực quan của dự án
2
+ description: Create and view visual project dashboards.
3
3
  ---
4
4
 
5
5
  # /dashboard - Visual Project Overview
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Lệnh debug. Kích hoạt chế độ DEBUG để điều tra vấn đề có hệ thống.
2
+ description: Debug command. Activates DEBUG mode to systematically investigate issues.
3
3
  ---
4
4
 
5
5
  # /debug - Systematic Problem Investigation
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Lệnh deploy cho production. Kiểm tra pre-flight thực thi deployment.
2
+ description: Production deployment command. Performs pre-flight checks and executes deployment.
3
3
  ---
4
4
 
5
5
  # /deploy - Production Deployment
@@ -1,5 +1,5 @@
1
1
  ---
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.
2
+ description: Add or update features in an existing application. Used for iterative development.
3
3
  ---
4
4
 
5
5
  # /enhance - Update Application
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Đề xuất bước tiếp theo cho developer
2
+ description: Suggest the next steps for the developer.
3
3
  ---
4
4
 
5
5
  # /next - What Should I Do Next?
@@ -1,5 +1,5 @@
1
1
  ---
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.
2
+ description: Coordinate multiple agents for complex tasks. Used for multi-perspective analysis, comprehensive reviews, or tasks requiring different expertise.
3
3
  ---
4
4
 
5
5
  # Multi-Agent Orchestration
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Tạo project plan sử dụng project-planner agent. Chỉ tạo file plan - không viết code.
2
+ description: Create a project plan using the project-planner agent. Only creates plan files - does not write code.
3
3
  ---
4
4
 
5
5
  # /plan - Project Planning Mode
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Quản preview server: start, stop, kiểm tra trạng thái. Quản local development server.
2
+ description: Manage preview server: start, stop, and status check. Manages local development server.
3
3
  ---
4
4
 
5
5
  # /preview - Preview Management
@@ -1,5 +1,5 @@
1
1
  ---
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.
2
+ description: Optimize context and output quality for Codex CLI. Used for complex tasks requiring high-quality results.
3
3
  ---
4
4
 
5
5
  # /quality - Quality Optimization Workflow
@@ -1,5 +1,5 @@
1
1
  ---
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.
2
+ description: Create specification documents before planning. Used for complex features requiring clear requirements before implementation.
3
3
  ---
4
4
 
5
5
  # /spec - Specification Writing Mode
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Hiển thị trạng thái project agent. Theo dõi tiến độ và bảng trạng thái.
2
+ description: Display project and agent status. Track progress and status boards.
3
3
  ---
4
4
 
5
5
  # /status - Show Status
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Tạo test chạy test. Tạo thực thi các test cho code.
2
+ description: Create and run tests. Create and execute tests for the code.
3
3
  ---
4
4
 
5
5
  # /test - Test Generation and Execution
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Lập kế hoạch và triển khai UI/UX chuyên nghiệp
2
+ description: Professional UI/UX planning and implementation.
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.7.0",
3
+ "version": "1.8.1",
4
4
  "description": "AI Agent templates - Skills, Agents, Workflows, and AI-Ready Data Infrastructure Gateway",
5
5
  "main": "index.js",
6
6
  "bin": {