thachvd-kit 1.0.15 → 1.0.17
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/agents/frontend-specialist.md +2 -2
- package/.agent/agents/mobile-developer.md +4 -4
- package/.agent/docs/architecture.md +22 -0
- package/.agent/docs/conventions.md +21 -0
- package/.agent/docs/project.md +40 -0
- package/.agent/docs/workflow.md +24 -0
- package/.agent/rules/GEMINI.md +31 -193
- package/.agent/skills/desktop-design/SKILL.md +25 -25
- package/.agent/skills/project-onboarding/SKILL.md +42 -62
- package/.agent/skills/react-frontend/SKILL.md +25 -25
- package/LICENSE +21 -21
- package/README.md +37 -71
- package/agents/frontend-specialist.md +2 -2
- package/agents/mobile-developer.md +4 -4
- package/bin/cli.js +1276 -1409
- package/kit/PROMPT_RECIPE.md +30 -52
- package/kit/README.md +29 -33
- package/package.json +51 -51
- package/rules/GEMINI.md +43 -207
- package/skills/desktop-design/SKILL.md +25 -25
- package/skills/project-onboarding/SKILL.md +42 -62
- package/skills/react-frontend/SKILL.md +25 -25
- package/kit/PROJECT_CONTEXT.template.md +0 -35
- package/scripts/init.py +0 -1047
|
@@ -3,7 +3,7 @@ name: frontend-specialist
|
|
|
3
3
|
description: Senior Frontend Architect who builds maintainable React/Next.js systems with performance-first mindset. Use when working on UI components, styling, state management, responsive design, or frontend architecture. Triggers on keywords like component, react, vue, ui, ux, css, tailwind, responsive.
|
|
4
4
|
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
5
5
|
model: inherit
|
|
6
|
-
skills: clean-code, react-frontend, nextjs-react-expert, web-design-guidelines, tailwind-patterns, frontend-design, lint-and-validate
|
|
6
|
+
skills: clean-code, react-frontend, nextjs-react-expert, web-design-guidelines, tailwind-patterns, frontend-design, lint-and-validate
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
# Senior Frontend Architect
|
|
@@ -575,7 +575,7 @@ After editing any file:
|
|
|
575
575
|
|
|
576
576
|
---
|
|
577
577
|
|
|
578
|
-
> **Note:** This agent loads relevant skills (`react-frontend`, `nextjs-react-expert`, etc.) for detailed guidance. Apply behavioral principles from those skills rather than copying patterns.
|
|
578
|
+
> **Note:** This agent loads relevant skills (`react-frontend`, `nextjs-react-expert`, etc.) for detailed guidance. Apply behavioral principles from those skills rather than copying patterns.
|
|
579
579
|
|
|
580
580
|
---
|
|
581
581
|
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: mobile-developer
|
|
3
|
-
description: Expert in React Native, Flutter, and Tauri-style app development. Use for cross-platform mobile or desktop apps, native features, and platform-specific UI patterns. Triggers on mobile, desktop, tauri, react native, flutter, ios, android, app store, expo.
|
|
2
|
+
name: mobile-developer
|
|
3
|
+
description: Expert in React Native, Flutter, and Tauri-style app development. Use for cross-platform mobile or desktop apps, native features, and platform-specific UI patterns. Triggers on mobile, desktop, tauri, react native, flutter, ios, android, app store, expo.
|
|
4
4
|
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
5
5
|
model: inherit
|
|
6
|
-
skills: clean-code, mobile-design, desktop-design
|
|
6
|
+
skills: clean-code, mobile-design, desktop-design
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
# Mobile Developer
|
|
10
10
|
|
|
11
|
-
Expert app developer specializing in React Native, Flutter, and Tauri-style cross-platform development.
|
|
11
|
+
Expert app developer specializing in React Native, Flutter, and Tauri-style cross-platform development.
|
|
12
12
|
|
|
13
13
|
## Your Philosophy
|
|
14
14
|
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Architecture Notes
|
|
2
|
+
|
|
3
|
+
## Current Map
|
|
4
|
+
|
|
5
|
+
- `bin/cli.js`: Main Node.js CLI. Handles scan detection, prompts, file generation, and `.agent/` copy.
|
|
6
|
+
- `.agent/`: Installed kit content copied into target projects.
|
|
7
|
+
- `agents/`, `skills/`, `workflows/`, `rules/`: Source mirrors for kit content.
|
|
8
|
+
- `kit/`: Human-facing kit docs and prompt recipes.
|
|
9
|
+
- `scripts/`: Helper scripts used by generated workflows.
|
|
10
|
+
|
|
11
|
+
## Output Model
|
|
12
|
+
|
|
13
|
+
`thachvd-kit init` creates thin root entry files and puts project-specific knowledge in `.agent/docs/`:
|
|
14
|
+
|
|
15
|
+
- `AGENTS.md`: shared instructions for Codex, Antigravity, and Claude Code.
|
|
16
|
+
- `CLAUDE.md`: imports `AGENTS.md` for Claude Code.
|
|
17
|
+
- `GEMINI.md`: Antigravity entry that points to `AGENTS.md`.
|
|
18
|
+
- `.agent/docs/*.md`: stack, architecture, conventions, and workflow.
|
|
19
|
+
|
|
20
|
+
## Maintenance Rule
|
|
21
|
+
|
|
22
|
+
Keep root entry files short. Add project-specific details to `.agent/docs/*` and reusable behavior to `.agent/skills/*` or `.agent/workflows/*`.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Coding Conventions
|
|
2
|
+
|
|
3
|
+
## JavaScript CLI
|
|
4
|
+
|
|
5
|
+
- Keep CLI behavior in `bin/cli.js` unless a helper becomes clearly reusable.
|
|
6
|
+
- Prefer simple filesystem APIs from Node.js standard library.
|
|
7
|
+
- Keep generated Markdown ASCII-only unless the target file already requires non-ASCII.
|
|
8
|
+
- Avoid adding dependencies for small formatting or path operations.
|
|
9
|
+
|
|
10
|
+
## Docs And Rules
|
|
11
|
+
|
|
12
|
+
- Root `AGENTS.md`, `CLAUDE.md`, and `GEMINI.md` should stay concise.
|
|
13
|
+
- Put scan-specific or project-specific detail in `.agent/docs/`.
|
|
14
|
+
- Keep `.agent/rules/GEMINI.md` and `rules/GEMINI.md` aligned.
|
|
15
|
+
- Keep mirrored source folders and `.agent/` content aligned when changing kit assets.
|
|
16
|
+
|
|
17
|
+
## Verification
|
|
18
|
+
|
|
19
|
+
- Syntax-check `bin/cli.js` after edits.
|
|
20
|
+
- Run `npm test`.
|
|
21
|
+
- Run `npm pack --dry-run` for package output changes.
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Project Rules
|
|
2
|
+
|
|
3
|
+
Generated by thachvd-kit.
|
|
4
|
+
|
|
5
|
+
## Summary
|
|
6
|
+
|
|
7
|
+
- Name: thachvd-kit
|
|
8
|
+
- Description: Project rules bootstrap kit for Codex, Antigravity, and Claude Code.
|
|
9
|
+
- Type: CLI package
|
|
10
|
+
- App root: `.`
|
|
11
|
+
|
|
12
|
+
## Stack
|
|
13
|
+
|
|
14
|
+
- Language: JavaScript
|
|
15
|
+
- Runtime: Node.js
|
|
16
|
+
- Package manager: npm
|
|
17
|
+
- CLI entry: `bin/cli.js`
|
|
18
|
+
- Published package files: `.agent`, `agents`, `bin`, `kit`, `rules`, `scripts`, `skills`, `workflows`, `README.md`, `LICENSE`
|
|
19
|
+
|
|
20
|
+
## Commands
|
|
21
|
+
|
|
22
|
+
- Install: `npm install`
|
|
23
|
+
- Test: `npm test`
|
|
24
|
+
- Package dry run: `npm pack --dry-run`
|
|
25
|
+
- Publish: `npm publish`
|
|
26
|
+
|
|
27
|
+
## Agent Routing
|
|
28
|
+
|
|
29
|
+
| Task Type | Agent | Primary Skills |
|
|
30
|
+
|-----------|-------|----------------|
|
|
31
|
+
| CLI behavior | `backend-specialist` | `nodejs-best-practices`, `clean-code` |
|
|
32
|
+
| Docs/rules | `documentation-writer` | `documentation-templates` |
|
|
33
|
+
| Workflow design | `project-planner` | `plan-writing`, `executing-plans` |
|
|
34
|
+
| Security/release | `security-auditor` / `devops-engineer` | `vulnerability-scanner`, `deployment-procedures` |
|
|
35
|
+
|
|
36
|
+
## Verification
|
|
37
|
+
|
|
38
|
+
- Run `node --check bin/cli.js` after CLI edits.
|
|
39
|
+
- Run `npm test` before claiming code changes are complete.
|
|
40
|
+
- Run `npm pack --dry-run` before release-oriented changes.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# Agent Workflow
|
|
2
|
+
|
|
3
|
+
## Before Every Task
|
|
4
|
+
|
|
5
|
+
1. Read `AGENTS.md`.
|
|
6
|
+
2. Read `.agent/docs/project.md`.
|
|
7
|
+
3. Classify the request.
|
|
8
|
+
4. Load only the relevant agent, skill, or workflow docs.
|
|
9
|
+
|
|
10
|
+
## Implementation Flow
|
|
11
|
+
|
|
12
|
+
1. State assumptions and success criteria when the task is not trivial.
|
|
13
|
+
2. Inspect dependent files before editing.
|
|
14
|
+
3. Make the smallest coherent change.
|
|
15
|
+
4. Add or update focused tests when behavior changes.
|
|
16
|
+
5. Run verification.
|
|
17
|
+
6. Summarize changed files and verification evidence.
|
|
18
|
+
|
|
19
|
+
## Release Flow
|
|
20
|
+
|
|
21
|
+
1. Update package metadata when changing publish behavior.
|
|
22
|
+
2. Run `npm test`.
|
|
23
|
+
3. Run `npm pack --dry-run`.
|
|
24
|
+
4. Review tarball contents before publish.
|
package/.agent/rules/GEMINI.md
CHANGED
|
@@ -2,206 +2,44 @@
|
|
|
2
2
|
trigger: always_on
|
|
3
3
|
---
|
|
4
4
|
|
|
5
|
-
# GEMINI.md
|
|
5
|
+
# GEMINI.md
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Antigravity-compatible entry rules for thachvd-kit projects.
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
## MANDATORY FIRST ACTION
|
|
12
|
-
|
|
13
|
-
**At session start — before anything else:**
|
|
14
|
-
|
|
15
|
-
```
|
|
16
|
-
1. Read AGENTS.md (at project root) → load stack, agents, constraints
|
|
17
|
-
2. If missing → ask user to run: thachvd-kit init --scan
|
|
18
|
-
3. Confirm: "Context loaded: [Project Name] | Stack: [Stack] | Ready."
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
> All routing decisions below depend on AGENTS.md.
|
|
22
|
-
> Without it, ask user to run: `thachvd-kit init --scan`
|
|
23
|
-
|
|
24
|
-
---
|
|
25
|
-
|
|
26
|
-
## STEP 1 — CLASSIFY REQUEST
|
|
27
|
-
|
|
28
|
-
| Type | Triggers | Action |
|
|
29
|
-
|------|----------|--------|
|
|
30
|
-
| **QUESTION** | "what", "how", "explain", "why" | Direct answer |
|
|
31
|
-
| **SURVEY** | "analyze", "list", "overview", "check" | Analysis only, no code |
|
|
32
|
-
| **SIMPLE FIX** | "fix", "add", "change" (single file) | Inline edit |
|
|
33
|
-
| **BUILD** | "build", "create", "implement", "refactor" | Agent + `{task-slug}.md` |
|
|
34
|
-
| **DESIGN/UI** | "design", "UI", "page", "dashboard" | Agent + `{task-slug}.md` |
|
|
35
|
-
|
|
36
|
-
---
|
|
37
|
-
|
|
38
|
-
## STEP 2 — AUTO-SELECT AGENT
|
|
39
|
-
|
|
40
|
-
**Protocol:**
|
|
41
|
-
1. Read `## Project Overview` from AGENTS.md → detect language and frameworks
|
|
42
|
-
2. Match to agent table below
|
|
43
|
-
3. Announce before responding:
|
|
44
|
-
|
|
45
|
-
```
|
|
46
|
-
🤖 Applying knowledge of `@[agent-name]`...
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
### Agent Routing Table
|
|
50
|
-
|
|
51
|
-
| Domain | Agent | Skills to Load |
|
|
52
|
-
|--------|-------|---------------|
|
|
53
|
-
| Web frontend (any framework) | `frontend-specialist` | `frontend-design` + framework skill from AGENTS.md |
|
|
54
|
-
| Backend API (any language) | `backend-specialist` | language skill + `api-design` |
|
|
55
|
-
| Database / Schema | `database-architect` | `database-design` |
|
|
56
|
-
| Mobile / Desktop (Tauri, RN, Flutter) | `mobile-developer` | platform skill from AGENTS.md |
|
|
57
|
-
| DevOps / Cloud / CI | `devops-engineer` | `docker-patterns`, `deployment-procedures` |
|
|
58
|
-
| Security audit | `security-auditor` | `vulnerability-scanner` |
|
|
59
|
-
| Debug / RCA | `debugger` | `systematic-debugging` |
|
|
60
|
-
| Planning / Discovery | `project-planner` | `brainstorming`, `plan-writing` |
|
|
61
|
-
| Multi-domain | `orchestrator` | `dispatching-parallel-agents` |
|
|
62
|
-
|
|
63
|
-
**Framework-specific skill mapping** (reference AGENTS.md stack):
|
|
64
|
-
|
|
65
|
-
| Framework/Language | Load Skill |
|
|
66
|
-
|-------------------|-----------|
|
|
67
|
-
| Vue | `frontend-design` (+ Vue-specific if available) |
|
|
68
|
-
| React | `react-frontend` |
|
|
69
|
-
| Next.js | `nextjs-react-expert` |
|
|
70
|
-
| Laravel | `laravel-patterns` + `laravel-security` |
|
|
71
|
-
| Node.js | `nodejs-best-practices` |
|
|
72
|
-
| Python | `python-patterns` |
|
|
73
|
-
| Go | `golang-patterns` |
|
|
74
|
-
| Rust | `rust-pro` |
|
|
75
|
-
| Tauri | `desktop-design` + `rust-pro` |
|
|
76
|
-
| Docker | `docker-patterns` |
|
|
77
|
-
|
|
78
|
-
> If stack not in mapping → use agent's general skill set + `clean-code`.
|
|
79
|
-
|
|
80
|
-
**MANDATORY checklist before any code:**
|
|
81
|
-
- [ ] Agent identified from AGENTS.md stack?
|
|
82
|
-
- [ ] Agent `.md` file read/recalled?
|
|
83
|
-
- [ ] Announcement `🤖 Applying knowledge of @[agent]...` written?
|
|
84
|
-
|
|
85
|
-
> 🔴 Code without announcement = **PROTOCOL VIOLATION**
|
|
86
|
-
|
|
87
|
-
---
|
|
88
|
-
|
|
89
|
-
## STEP 3 — SOCRATIC GATE
|
|
90
|
-
|
|
91
|
-
**Trigger: BUILD or DESIGN/UI requests only**
|
|
92
|
-
|
|
93
|
-
| Scenario | Action |
|
|
94
|
-
|----------|--------|
|
|
95
|
-
| New feature / greenfield | Ask **3 questions**: Purpose · Users · Must-have vs Nice-to-have |
|
|
96
|
-
| Code edit / bug fix | Confirm scope + 1 impact question |
|
|
97
|
-
| Vague request | Ask Purpose + Constraints |
|
|
98
|
-
| User gave full spec | **Proceed immediately** |
|
|
99
|
-
| User says "proceed" / "just do it" | **DO IT — no more questions** |
|
|
100
|
-
|
|
101
|
-
**Rules:**
|
|
102
|
-
- Max 3 questions at once
|
|
103
|
-
- Never ask edge case questions after user already answered
|
|
104
|
-
- Reference `@[skills/brainstorming]` for question format
|
|
9
|
+
## Startup
|
|
105
10
|
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
- Respond in user's language (auto-detect from prompt)
|
|
112
|
-
- Code comments/variables always in English
|
|
113
|
-
|
|
114
|
-
### Code Quality
|
|
115
|
-
- `@[skills/clean-code]` applies to ALL code, ALL languages
|
|
116
|
-
- Tests mandatory: Unit > Integration > E2E
|
|
117
|
-
- `@[skills/verification-before-completion]` before claiming "done"
|
|
118
|
-
|
|
119
|
-
### File Changes
|
|
120
|
-
- Identify dependent files before modifying
|
|
121
|
-
- Update ALL affected files together
|
|
122
|
-
|
|
123
|
-
---
|
|
11
|
+
1. Read `AGENTS.md` at the project root.
|
|
12
|
+
2. Read `.agent/docs/project.md` for stack, commands, and routing.
|
|
13
|
+
3. Read `.agent/docs/workflow.md` before editing.
|
|
14
|
+
4. Read `.agent/docs/architecture.md` and `.agent/docs/conventions.md` before planning non-trivial code changes.
|
|
15
|
+
5. If any `.agent/docs/*.md` file contains `TODO: refine`, update that doc from the real code before product code changes.
|
|
124
16
|
|
|
125
|
-
##
|
|
17
|
+
## Routing
|
|
126
18
|
|
|
127
|
-
|
|
19
|
+
- Frontend/UI: `.agent/agents/frontend-specialist.md`
|
|
20
|
+
- Backend/API: `.agent/agents/backend-specialist.md`
|
|
21
|
+
- Database/schema: `.agent/agents/database-architect.md`
|
|
22
|
+
- Mobile/desktop: `.agent/agents/mobile-developer.md`
|
|
23
|
+
- DevOps/CI/deploy: `.agent/agents/devops-engineer.md`
|
|
24
|
+
- Debug/RCA: `.agent/agents/debugger.md`
|
|
25
|
+
- Security: `.agent/agents/security-auditor.md`
|
|
26
|
+
- Multi-domain: `.agent/agents/orchestrator.md`
|
|
128
27
|
|
|
129
|
-
|
|
130
|
-
1. brainstorming → Clarify (Socratic Gate)
|
|
131
|
-
2. plan-writing → Create {task-slug}.md
|
|
132
|
-
3. using-git-worktrees → Isolated workspace
|
|
133
|
-
4. subagent-driven-development → Implement + 2-stage review
|
|
134
|
-
5. requesting-code-review → After each major task
|
|
135
|
-
6. verification-before-completion → Before claiming done
|
|
136
|
-
7. finishing-a-development-branch → Merge / PR / keep
|
|
137
|
-
```
|
|
138
|
-
|
|
139
|
-
**SIMPLE FIX:** Skip to step 4, no worktree needed.
|
|
140
|
-
|
|
141
|
-
---
|
|
142
|
-
|
|
143
|
-
## MODE BEHAVIOR
|
|
144
|
-
|
|
145
|
-
| Mode | Behavior |
|
|
146
|
-
|------|----------|
|
|
147
|
-
| **plan** | Analysis → Planning → Architecture → NO CODE until confirmed |
|
|
148
|
-
| **ask** | Questions and analysis only |
|
|
149
|
-
| **edit** | Execute. Multi-file → create `{task-slug}.md`. Single-file → proceed. |
|
|
150
|
-
|
|
151
|
-
---
|
|
28
|
+
Load only the agent, skill, or workflow files relevant to the current task.
|
|
152
29
|
|
|
153
|
-
##
|
|
154
|
-
|
|
155
|
-
**Trigger:** "final check", "deploy check", "kiểm tra cuối", "done?"
|
|
156
|
-
|
|
157
|
-
```bash
|
|
158
|
-
python scripts/checklist.py .
|
|
159
|
-
```
|
|
160
|
-
|
|
161
|
-
Priority: Security → Lint → Tests → UX → SEO
|
|
162
|
-
|
|
163
|
-
---
|
|
164
|
-
|
|
165
|
-
## PATHS
|
|
166
|
-
|
|
167
|
-
```
|
|
168
|
-
agents/ → agents/{agent}.md
|
|
169
|
-
skills/ → skills/{skill}/SKILL.md
|
|
170
|
-
workflows/ → workflows/{command}.md
|
|
171
|
-
scripts/ → scripts/init.py, checklist.py, verify_all.py
|
|
172
|
-
```
|
|
173
|
-
|
|
174
|
-
---
|
|
175
|
-
|
|
176
|
-
## QUICK SKILL REFERENCE
|
|
177
|
-
|
|
178
|
-
| Need | Skill |
|
|
179
|
-
|------|-------|
|
|
180
|
-
| Clean code (any lang) | `clean-code` |
|
|
181
|
-
| Plan a task | `plan-writing` → `executing-plans` |
|
|
182
|
-
| Parallel agents | `dispatching-parallel-agents` |
|
|
183
|
-
| Code review | `requesting-code-review` / `receiving-code-review` |
|
|
184
|
-
| Git isolation | `using-git-worktrees` |
|
|
185
|
-
| Agent-based dev | `subagent-driven-development` |
|
|
186
|
-
| Verify done | `verification-before-completion` |
|
|
187
|
-
| Finish branch | `finishing-a-development-branch` |
|
|
188
|
-
| Write new skill | `writing-skills` |
|
|
189
|
-
| API design | `api-design` |
|
|
190
|
-
| Docker | `docker-patterns` |
|
|
191
|
-
| Laravel | `laravel-patterns`, `laravel-security`, `laravel-tdd` |
|
|
192
|
-
| Go | `golang-patterns`, `golang-testing` |
|
|
193
|
-
| Debugging | `systematic-debugging` |
|
|
194
|
-
| Security | `vulnerability-scanner` |
|
|
195
|
-
|
|
196
|
-
---
|
|
30
|
+
## Execution
|
|
197
31
|
|
|
198
|
-
|
|
32
|
+
- Questions and analysis: answer directly; do not edit code.
|
|
33
|
+
- Simple fix: inspect dependencies, make the smallest change, verify.
|
|
34
|
+
- Feature or refactor: state assumptions, define success criteria, plan, implement, verify.
|
|
35
|
+
- UI work: use relevant frontend design skills before editing.
|
|
36
|
+
- Security or deploy work: run the matching checklist before claiming done.
|
|
199
37
|
|
|
200
|
-
|
|
201
|
-
|----------|-----------|-----------|-----------|
|
|
202
|
-
| **Antigravity** | `rules/GEMINI.md` (this file) | `skills/` | `workflows/` |
|
|
203
|
-
| **Claude Code** | `CLAUDE.md` at project root | `.agent/skills/` | `.agent/workflows/` |
|
|
204
|
-
| **Codex / OpenCode** | `AGENTS.md` at project root | `.agent/skills/` | `.agent/workflows/` |
|
|
205
|
-
| **Cursor** | `.cursorrules` or `.agent/rules/GEMINI.md` | `.agent/skills/` | `.agent/workflows/` |
|
|
38
|
+
## Standards
|
|
206
39
|
|
|
207
|
-
|
|
40
|
+
- Respond in the user's language.
|
|
41
|
+
- Keep code, identifiers, and code comments in English.
|
|
42
|
+
- Prefer existing project patterns over new abstractions.
|
|
43
|
+
- Keep changes surgical.
|
|
44
|
+
- Tests or equivalent verification are mandatory.
|
|
45
|
+
- Update `.agent/docs/*` when stack, architecture, workflow, or conventions change.
|
|
@@ -1,25 +1,25 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: desktop-design
|
|
3
|
-
description: Desktop and cross-platform app design guidance for Tauri and similar desktop shells. Use when building desktop-first interfaces, windowed workflows, keyboard-heavy UX, or cross-platform desktop UI behavior.
|
|
4
|
-
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Desktop Design
|
|
8
|
-
|
|
9
|
-
This skill covers desktop-first product thinking where `mobile-design` is the wrong default.
|
|
10
|
-
|
|
11
|
-
Use it for Tauri and other desktop-oriented apps with window management, keyboard shortcuts, dense layouts, or multi-panel workflows.
|
|
12
|
-
|
|
13
|
-
## Guidance
|
|
14
|
-
|
|
15
|
-
- Design for pointer + keyboard, not touch-first.
|
|
16
|
-
- Use information density deliberately; desktop screens can support richer sidebars and multi-column layouts.
|
|
17
|
-
- Respect platform conventions for menus, shortcuts, dialogs, file pickers, and drag/drop.
|
|
18
|
-
- Assume resizing, multiple windows, and long-running sessions are normal.
|
|
19
|
-
- Pair with `rust-pro` for Tauri backend/native concerns and `frontend-design` for UI execution.
|
|
20
|
-
|
|
21
|
-
## Related Skills
|
|
22
|
-
|
|
23
|
-
- `mobile-design` for touch-first mobile products
|
|
24
|
-
- `frontend-design` for visual and interaction design
|
|
25
|
-
- `rust-pro` for Rust and Tauri implementation details
|
|
1
|
+
---
|
|
2
|
+
name: desktop-design
|
|
3
|
+
description: Desktop and cross-platform app design guidance for Tauri and similar desktop shells. Use when building desktop-first interfaces, windowed workflows, keyboard-heavy UX, or cross-platform desktop UI behavior.
|
|
4
|
+
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Desktop Design
|
|
8
|
+
|
|
9
|
+
This skill covers desktop-first product thinking where `mobile-design` is the wrong default.
|
|
10
|
+
|
|
11
|
+
Use it for Tauri and other desktop-oriented apps with window management, keyboard shortcuts, dense layouts, or multi-panel workflows.
|
|
12
|
+
|
|
13
|
+
## Guidance
|
|
14
|
+
|
|
15
|
+
- Design for pointer + keyboard, not touch-first.
|
|
16
|
+
- Use information density deliberately; desktop screens can support richer sidebars and multi-column layouts.
|
|
17
|
+
- Respect platform conventions for menus, shortcuts, dialogs, file pickers, and drag/drop.
|
|
18
|
+
- Assume resizing, multiple windows, and long-running sessions are normal.
|
|
19
|
+
- Pair with `rust-pro` for Tauri backend/native concerns and `frontend-design` for UI execution.
|
|
20
|
+
|
|
21
|
+
## Related Skills
|
|
22
|
+
|
|
23
|
+
- `mobile-design` for touch-first mobile products
|
|
24
|
+
- `frontend-design` for visual and interaction design
|
|
25
|
+
- `rust-pro` for Rust and Tauri implementation details
|
|
@@ -1,62 +1,42 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: project-onboarding
|
|
3
|
-
description:
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
- [ ]
|
|
43
|
-
- [ ] **Identified Frontend/Backend stack?**
|
|
44
|
-
- [ ] **Mapped primary folder structure?**
|
|
45
|
-
- [ ] **Found core business logic entry points?**
|
|
46
|
-
- [ ] **Created/Updated PROJECT_CONTEXT.md?**
|
|
47
|
-
- [ ] **Stated: "Ground Truth identified/established. Ready to proceed."?**
|
|
48
|
-
|
|
49
|
-
---
|
|
50
|
-
|
|
51
|
-
## ❌ Anti-Patterns
|
|
52
|
-
|
|
53
|
-
**DON'T:**
|
|
54
|
-
- Skip onboarding for "simple" fixes.
|
|
55
|
-
- Assume structure based on generic templates.
|
|
56
|
-
- Start writing code before `PROJECT_CONTEXT.md` exists.
|
|
57
|
-
- Leave the context file empty or vague.
|
|
58
|
-
|
|
59
|
-
**DO:**
|
|
60
|
-
- Perform deep directory analysis.
|
|
61
|
-
- Read core configuration files.
|
|
62
|
-
- Document any project-specific constraints found in existing code.
|
|
1
|
+
---
|
|
2
|
+
name: project-onboarding
|
|
3
|
+
description: Scan the repository and refine `.agent/docs/*` so all supported AI tools share accurate project rules.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Project Onboarding
|
|
7
|
+
|
|
8
|
+
Use this skill when a project has just run `thachvd-kit init`, when `.agent/docs/*` contains `TODO: refine`, or when the stack/architecture has changed.
|
|
9
|
+
|
|
10
|
+
## Goal
|
|
11
|
+
|
|
12
|
+
Create or update the shared project docs used by Codex, Antigravity, and Claude Code:
|
|
13
|
+
|
|
14
|
+
- `.agent/docs/project.md`
|
|
15
|
+
- `.agent/docs/architecture.md`
|
|
16
|
+
- `.agent/docs/conventions.md`
|
|
17
|
+
- `.agent/docs/workflow.md`
|
|
18
|
+
|
|
19
|
+
Do not create a legacy root context file.
|
|
20
|
+
|
|
21
|
+
## Process
|
|
22
|
+
|
|
23
|
+
1. Read `AGENTS.md`.
|
|
24
|
+
2. Inspect repository structure, package/build config, test config, entry points, and representative source files.
|
|
25
|
+
3. Update `.agent/docs/project.md` with stack, app root, commands, test/lint tooling, and routing.
|
|
26
|
+
4. Update `.agent/docs/architecture.md` with major directories, entry points, boundaries, and important decisions.
|
|
27
|
+
5. Update `.agent/docs/conventions.md` with real naming, formatting, API, state, styling, and testing patterns.
|
|
28
|
+
6. Update `.agent/docs/workflow.md` only when the repository needs project-specific workflow steps.
|
|
29
|
+
|
|
30
|
+
## Rules
|
|
31
|
+
|
|
32
|
+
- Keep docs concise and factual.
|
|
33
|
+
- Mark unknowns as `TODO: refine` only when the codebase does not provide evidence.
|
|
34
|
+
- Do not implement product code during onboarding.
|
|
35
|
+
- Do not overwrite unrelated user-maintained notes.
|
|
36
|
+
|
|
37
|
+
## Completion Checklist
|
|
38
|
+
|
|
39
|
+
- [ ] `.agent/docs/project.md` reflects actual stack and commands.
|
|
40
|
+
- [ ] `.agent/docs/architecture.md` maps the current codebase.
|
|
41
|
+
- [ ] `.agent/docs/conventions.md` captures observed patterns.
|
|
42
|
+
- [ ] `.agent/docs/workflow.md` has the task flow agents should follow.
|
|
@@ -1,25 +1,25 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: react-frontend
|
|
3
|
-
description: React-focused frontend guidance for component architecture, state flow, rendering boundaries, and maintainable UI systems. Use for plain React apps that are not specifically Next.js-first.
|
|
4
|
-
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# React Frontend
|
|
8
|
-
|
|
9
|
-
This skill is the React-first counterpart to `nextjs-react-expert`.
|
|
10
|
-
|
|
11
|
-
Use it when the project uses React without needing Next.js-specific assumptions such as SSR, App Router, or server components.
|
|
12
|
-
|
|
13
|
-
## Guidance
|
|
14
|
-
|
|
15
|
-
- Prefer the existing project architecture over introducing a new pattern.
|
|
16
|
-
- Keep state ownership shallow and explicit.
|
|
17
|
-
- Separate presentational UI from data-fetching and side effects when it improves maintainability.
|
|
18
|
-
- Optimize rendering only after confirming an actual bottleneck.
|
|
19
|
-
- Pair with `frontend-design` for UI/UX decisions.
|
|
20
|
-
|
|
21
|
-
## Related Skills
|
|
22
|
-
|
|
23
|
-
- `nextjs-react-expert` for Next.js-specific performance and routing concerns
|
|
24
|
-
- `frontend-design` for layout, visual hierarchy, and responsive design
|
|
25
|
-
- `clean-code` for naming, file boundaries, and readability
|
|
1
|
+
---
|
|
2
|
+
name: react-frontend
|
|
3
|
+
description: React-focused frontend guidance for component architecture, state flow, rendering boundaries, and maintainable UI systems. Use for plain React apps that are not specifically Next.js-first.
|
|
4
|
+
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# React Frontend
|
|
8
|
+
|
|
9
|
+
This skill is the React-first counterpart to `nextjs-react-expert`.
|
|
10
|
+
|
|
11
|
+
Use it when the project uses React without needing Next.js-specific assumptions such as SSR, App Router, or server components.
|
|
12
|
+
|
|
13
|
+
## Guidance
|
|
14
|
+
|
|
15
|
+
- Prefer the existing project architecture over introducing a new pattern.
|
|
16
|
+
- Keep state ownership shallow and explicit.
|
|
17
|
+
- Separate presentational UI from data-fetching and side effects when it improves maintainability.
|
|
18
|
+
- Optimize rendering only after confirming an actual bottleneck.
|
|
19
|
+
- Pair with `frontend-design` for UI/UX decisions.
|
|
20
|
+
|
|
21
|
+
## Related Skills
|
|
22
|
+
|
|
23
|
+
- `nextjs-react-expert` for Next.js-specific performance and routing concerns
|
|
24
|
+
- `frontend-design` for layout, visual hierarchy, and responsive design
|
|
25
|
+
- `clean-code` for naming, file boundaries, and readability
|
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 thachvd
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 thachvd
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|