thachvd-kit 1.0.15 → 1.0.16

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.
@@ -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.
@@ -2,206 +2,44 @@
2
2
  trigger: always_on
3
3
  ---
4
4
 
5
- # GEMINI.md — Universal Agent Kit
5
+ # GEMINI.md
6
6
 
7
- > Cross-platform agent protocol. Works with: Antigravity · Claude Code · Codex · OpenCode
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
- ## UNIVERSAL RULES (Always Active)
109
-
110
- ### Language
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
- ## EXECUTION WORKFLOW
17
+ ## Routing
126
18
 
127
- **BUILD tasks — 7-step flow:**
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
- ## FINAL CHECK
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
- ## CROSS-PLATFORM NOTES
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
- | Platform | Rules File | Skills Dir | Workflows |
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
- > Run `thachvd-kit init --scan` to generate AGENTS.md and copy the `.agent/` folder automatically.
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: Skill for project reconnaissance and Ground Truth establishment. Automatically scans project structure, tech stack, and logic to create or update PROJECT_CONTEXT.md.
4
- allowed-tools: list_dir, grep_search, find_by_name, view_file, write_to_file
5
- ---
6
-
7
- # Project Onboarding Skill
8
-
9
- > Establish a Ground Truth map for any project before writing code.
10
-
11
- ---
12
-
13
- ## 🎯 Objectives
14
- - **Reconnaissance:** Understand the directory structure, technology stack, and core business logic.
15
- - **Ground Truth:** Create `PROJECT_CONTEXT.md` to serve as the project's primary reference.
16
- - **Continuity:** Ensure all future sessions have a map to follow.
17
-
18
- ---
19
-
20
- ## 📑 Process
21
-
22
- 1. **Scan Filesystem:**
23
- - Run `list_dir` on root.
24
- - Run `find_by_name` for configuration files (`package.json`, `tsconfig.json`, `tailwind.config.js`, etc.).
25
- 2. **Identify Tech Stack:**
26
- - Detect frameworks (React, Next.js, Vite, etc.).
27
- - Detect database/storage (SQL, NoSQL, client-side DB).
28
- - Detect styling and UI libraries.
29
- 3. **Analyze Structure:**
30
- - Identify where pages, components, logic, and state management live.
31
- 4. **Identify Core Logic:**
32
- - `grep` for main keywords (e.g., patient, pharmacy, etc.) to find business rules.
33
- 5. **Create/Update Map:**
34
- - Generate `PROJECT_CONTEXT.md` in root using the `PROJECT_CONTEXT.template.md` as a guide.
35
-
36
- ---
37
-
38
- ## ✅ Onboarding Checklist
39
-
40
- Before completing onboarding:
41
-
42
- - [ ] **Scanned root directory?**
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.