@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.
- package/.agent/rules/CODEX.md +8 -7
- package/.agent/rules/CODE_RULES.md +15 -0
- package/.agent/rules/REFERENCE.md +7 -2
- package/.agent/skills/brainstorming/SKILL.md +52 -0
- package/.agent/skills/frontend-design/SKILL.md +30 -0
- package/.agent/skills/git-worktrees/SKILL.md +181 -0
- package/.agent/skills/parallel-agents/SKILL.md +89 -0
- package/.agent/skills/react-patterns/SKILL.md +31 -0
- package/.agent/skills/react-patterns/bundle-patterns.md +129 -0
- package/.agent/skills/react-patterns/rerender-patterns.md +163 -0
- package/.agent/skills/react-patterns/server-patterns.md +146 -0
- package/.agent/skills/react-patterns/waterfall-patterns.md +102 -0
- package/.agent/skills/reader-testing/SKILL.md +183 -0
- package/.agent/skills/verification-gate/SKILL.md +129 -0
- package/.agent/skills/web-interface-guidelines/SKILL.md +94 -0
- package/.agent/skills/web-interface-guidelines/animation.md +153 -0
- package/.agent/skills/web-interface-guidelines/anti-patterns.md +204 -0
- package/.agent/skills/web-interface-guidelines/focus-states.md +104 -0
- package/.agent/skills/web-interface-guidelines/forms.md +154 -0
- package/.agent/skills/web-interface-guidelines/touch-interaction.md +150 -0
- package/.agent/workflows/autofix.md +1 -1
- package/.agent/workflows/brainstorm.md +1 -1
- package/.agent/workflows/context.md +1 -1
- package/.agent/workflows/create.md +1 -1
- package/.agent/workflows/dashboard.md +1 -1
- package/.agent/workflows/debug.md +1 -1
- package/.agent/workflows/deploy.md +1 -1
- package/.agent/workflows/enhance.md +1 -1
- package/.agent/workflows/next.md +1 -1
- package/.agent/workflows/orchestrate.md +1 -1
- package/.agent/workflows/plan.md +1 -1
- package/.agent/workflows/preview.md +1 -1
- package/.agent/workflows/quality.md +1 -1
- package/.agent/workflows/spec.md +1 -1
- package/.agent/workflows/status.md +1 -1
- package/.agent/workflows/test.md +1 -1
- package/.agent/workflows/ui-ux-pro-max.md +1 -1
- package/README.md +3 -3
- 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:
|
|
2
|
+
description: Structured brainstorming for projects and features. Explore multiple options before implementation.
|
|
3
3
|
---
|
|
4
4
|
|
|
5
5
|
# /brainstorm - Structured Idea Exploration
|
package/.agent/workflows/next.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
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
|
package/.agent/workflows/plan.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
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
|
package/.agent/workflows/spec.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
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
|
package/.agent/workflows/test.md
CHANGED
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** • **
|
|
5
|
+
> **16 Agents** • **58 Skills** • **13 Workflows** • **Multi-Platform Support**
|
|
6
6
|
|
|
7
7
|
[](https://www.npmjs.com/package/@musashishao/agent-kit)
|
|
8
8
|
[](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** |
|
|
31
|
-
| **Intelligence** |
|
|
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
|
|