@wipal/agent-team 1.0.4 → 1.1.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 (124) hide show
  1. package/.claude/commands/skills/discover.md +127 -0
  2. package/.claude/commands/skills/install.md +225 -0
  3. package/.claude/commands/skills/review.md +234 -0
  4. package/.claude/commands/utils/learn.md +142 -0
  5. package/.claude/commands/utils/retrospect.md +62 -0
  6. package/.claude/commands/utils/switch.md +113 -0
  7. package/.claude/commands/utils/sync.md +183 -0
  8. package/.claude/rules/common/general-rules.md +6 -0
  9. package/.claude/rules/role-rules/dev-be-rules.md +241 -0
  10. package/.claude/rules/role-rules/dev-fe-rules.md +76 -0
  11. package/.claude/skills/SKILL-INDEX.md +24 -5
  12. package/.claude/skills/core/knowledge-graph/SKILL.md +214 -0
  13. package/.claude/skills/core/sequential-thinking/SKILL.md +112 -0
  14. package/.claude/skills/core/sequential-thinking/references/advanced.md +122 -0
  15. package/.claude/skills/core/sequential-thinking/references/examples.md +274 -0
  16. package/.claude/skills/domain/architecture/c4-architecture/SKILL.md +314 -0
  17. package/.claude/skills/domain/architecture/c4-architecture/references/advanced-patterns.md +552 -0
  18. package/.claude/skills/domain/architecture/c4-architecture/references/c4-syntax.md +492 -0
  19. package/.claude/skills/domain/architecture/c4-architecture/references/common-mistakes.md +437 -0
  20. package/.claude/skills/domain/architecture/mermaid-diagrams/SKILL.md +238 -0
  21. package/.claude/skills/domain/architecture/mermaid-diagrams/references/advanced-features.md +556 -0
  22. package/.claude/skills/domain/architecture/mermaid-diagrams/references/architecture-diagrams.md +192 -0
  23. package/.claude/skills/domain/architecture/mermaid-diagrams/references/c4-diagrams.md +410 -0
  24. package/.claude/skills/domain/architecture/mermaid-diagrams/references/class-diagrams.md +361 -0
  25. package/.claude/skills/domain/architecture/mermaid-diagrams/references/erd-diagrams.md +510 -0
  26. package/.claude/skills/domain/architecture/mermaid-diagrams/references/flowcharts.md +450 -0
  27. package/.claude/skills/domain/architecture/mermaid-diagrams/references/sequence-diagrams.md +394 -0
  28. package/.claude/skills/domain/backend/testing-be/SKILL.md +121 -17
  29. package/.claude/skills/domain/design/design-system/SKILL.md +169 -0
  30. package/.claude/skills/domain/design/html-css-output/SKILL.md +253 -0
  31. package/.claude/skills/domain/design/mockup-creation/SKILL.md +230 -0
  32. package/.claude/skills/domain/design/responsive-design/SKILL.md +207 -0
  33. package/.claude/skills/domain/design/ui-design/SKILL.md +124 -0
  34. package/.claude/skills/domain/frontend/testing-fe/SKILL.md +143 -38
  35. package/.claude/skills/domain/frontend/ui-ux-pro-max/README.md +45 -0
  36. package/.claude/skills/domain/frontend/ui-ux-pro-max/SKILL.md +404 -0
  37. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/charts.csv +26 -0
  38. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/colors.csv +97 -0
  39. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/icons.csv +101 -0
  40. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/landing.csv +31 -0
  41. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/products.csv +97 -0
  42. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/react-performance.csv +45 -0
  43. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/stacks/astro.csv +54 -0
  44. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  45. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
  46. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
  47. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
  48. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
  49. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
  50. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  51. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/stacks/react.csv +54 -0
  52. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
  53. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
  54. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  55. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/stacks/vue.csv +50 -0
  56. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/styles.csv +68 -0
  57. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/typography.csv +58 -0
  58. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
  59. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
  60. package/.claude/skills/domain/frontend/ui-ux-pro-max/data/web-interface.csv +31 -0
  61. package/.claude/skills/domain/frontend/ui-ux-pro-max/scripts/core.py +253 -0
  62. package/.claude/skills/domain/frontend/ui-ux-pro-max/scripts/design_system.py +1067 -0
  63. package/.claude/skills/domain/frontend/ui-ux-pro-max/scripts/search.py +114 -0
  64. package/.claude/skills/domain/product/requirements-clarity/SKILL.md +340 -0
  65. package/.claude/skills/skills-registry.yaml +103 -8
  66. package/README.md +107 -33
  67. package/README.npm.md +252 -0
  68. package/TUTORIAL.md +256 -0
  69. package/bin/agent-team.js +26 -7
  70. package/config/roles.yaml +107 -0
  71. package/docs/01-architecture.md +699 -0
  72. package/docs/02-setup-guide.md +634 -0
  73. package/docs/03-skills-guide.md +628 -0
  74. package/docs/04-workflows.md +792 -0
  75. package/docs/05-model-strategy.md +550 -0
  76. package/docs/06-extend-guide.md +1226 -0
  77. package/docs/07-quick-reference.md +578 -0
  78. package/docs/08-skills-discovery.md +342 -0
  79. package/docs/README.md +134 -0
  80. package/docs/rqm.md +560 -0
  81. package/package.json +9 -3
  82. package/scripts/postinstall.js +46 -0
  83. package/src/commands/add.js +131 -67
  84. package/src/commands/init.js +419 -9
  85. package/src/commands/list.js +20 -16
  86. package/src/commands/projects.js +127 -0
  87. package/src/commands/setup-hooks.js +261 -0
  88. package/src/index.js +0 -1
  89. package/src/utils/file-utils.js +147 -50
  90. package/src/utils/global-registry.js +224 -0
  91. package/templates/CLAUDE.md.tmpl +128 -20
  92. package/templates/MEMORY.md.tmpl +119 -0
  93. package/templates/agent.md.tmpl +205 -0
  94. package/templates/code/nestjs-controller.ts.tmpl +49 -0
  95. package/templates/code/nestjs-dto.ts.tmpl +63 -0
  96. package/templates/code/nestjs-service.ts.tmpl +45 -0
  97. package/templates/code/react-component.tsx.tmpl +24 -0
  98. package/templates/code/react-hook.ts.tmpl +54 -0
  99. package/templates/code/test.spec.ts.tmpl +50 -0
  100. package/templates/code/vue-component.vue.tmpl +49 -0
  101. package/templates/code/vue-composable.ts.tmpl +54 -0
  102. package/templates/knowledge.md.tmpl +152 -17
  103. package/templates/meeting-notes.md.tmpl +110 -0
  104. package/templates/memory/hooks.memory.json +50 -0
  105. package/templates/memory/settings.memory.json +16 -0
  106. package/templates/reports/bug-report.md.tmpl +164 -0
  107. package/templates/reports/code-review.md.tmpl +201 -0
  108. package/templates/reports/sprint-report.md.tmpl +218 -0
  109. package/templates/roles/ba.md +53 -0
  110. package/templates/roles/designer.md +82 -0
  111. package/templates/roles/dev-be.md +49 -0
  112. package/templates/roles/dev-fe.md +49 -0
  113. package/templates/roles/devops.md +53 -0
  114. package/templates/roles/pm.md +49 -0
  115. package/templates/roles/qa.md +53 -0
  116. package/templates/roles/sa.md +49 -0
  117. package/templates/roles/tech-lead.md +132 -0
  118. package/templates/skills/memory/memory-status.md +78 -0
  119. package/templates/skills/memory/recall.md +160 -0
  120. package/templates/skills/memory/reflect.md +168 -0
  121. package/templates/skills/memory/remember.md +105 -0
  122. package/templates/tasks/lessons.md.tmpl +77 -0
  123. package/templates/tasks/todo.md.tmpl +53 -0
  124. package/src/commands/switch.js +0 -53
package/docs/rqm.md ADDED
@@ -0,0 +1,560 @@
1
+ t đang dùng claude code, và muốn build 1 agent team
2
+ 1. Agent team này có nhiều roles khác nhau ví dụ PM, Dev FE, Dev BE, Dev Mobile, QA, DevOps, Designer, Marketing, Sales, Support, HR, Finance, Legal, Admin, etc.
3
+ 2. Mỗi role có thể có nhiều skills khác nhau, nó có thử sử dụng link hoạt và các skill có kết nối, bổ trợ cho nhau
4
+ 3. Mỗi role có thể có nhiều tools khác nhau
5
+ 4. Mỗi role có thể có memory khác nhau, và mỗi project sẽ có memory riêng, bộ nhớ dài hạn
6
+ 5. Mỗi role có thể có nhiều workflow khác nhau
7
+ 6. Mỗi role có thể có thể tự học và cải thiện khi làm việc và đc góp ý.
8
+ 7. Mỗi role có thể extract bộ nhớ kiến thức chung để update thanks skill hay known base của source code này
9
+ 8. Mỗi roles cũng sẽ có 1 vài MCP(cs thể ko có)
10
+ 9. Về phần agent team này sẽ là 1 template ban đầu và đc thêm dần, sau này mỗi dự án cần chỉ càn pick 1 ai đó trong agent team này vào là đc
11
+ 10. agent team là 1 bộ soủce code độc lập và có thể setup nhanh để chạy đc với claude code
12
+ 11. tôi có tham khảo qua 1 vài chỗ nó nói có thể bill dạng agent skills và dùng agent team của claude code, bạn có thể tham khảo
13
+ 12. TRước tiên tôi cần các roles sau trong agent team để có thể chạy đc project hiện tại của tôi
14
+ 1. PM - quản lý team, lên kế hoạch, giao việc, theo dõi tiến độ, báo cáo, etc.
15
+ 2. Dev FE(nodejs, reactjs, nextjs, tailwindcss, typescript, Vite, etc.) - phát triển giao diện người dùng, tương tác với người dùng, etc.
16
+ 3. Dev BE(nodejs, expressjs, typescript,Redis, Docker etc.) - phát triển logic nghiệp vụ, tương tác với cơ sở dữ liệu, etc.
17
+ 4. QA - kiểm thử ứng dụng, đảm bảo chất lượng, etc.
18
+ 5. DevOps - triển khai ứng dụng, quản lý hạ tầng, etc.
19
+ 6. Designer - thiết kế giao diện, trải nghiệm người dùng, etc.
20
+ 7. QA Lead - quản lý team QA, lên kế hoạch, giao việc, theo dõi tiến độ, báo cáo, etc. Biết nhiều về test strategy, test plan, test case, test report, etc, expert về các test tool automation như playwright, cypress, k6, jmeter, etc.
21
+ 8. Dev Lead - quản lý team Dev, lên kế hoạch, giao việc, theo dõi tiến độ, báo cáo, etc. Biết nhiều về các ngôn ngữ lập trình như java, python, go, nodejs, etc. và các framework như spring, django, flask, express, etc. và các database như mysql, postgres, mongodb, etc.
22
+ 9. QA Automation - viết test case, test script, test report, etc. Làm tốt về E2E, API, Performance, Security, dùng được các tool như Playwright, Cypress, K6, Jmeter
23
+ 10. Ngoài ra các role còn cần sử dụng tốt git, github, gitlab, etc. để quản lý mã nguồn và cộng tác với nhau
24
+ 13. source code này ko chỉ là setup agent team mà còn setup cả các skills,MCP, tools, etc. cho từng role
25
+ 14. về MCP luôn có context7 và các agent luôn phải tham khảo nó khi nào về code
26
+ 15. Team còn cần các template báo cáo, trao đổi, etc. để report cho tôi
27
+ 16. Source code cũng cần có các workflow để có thể chạy đc với claude code
28
+ 17. Source code có thể setup qua claude code bằng chat với claude code, và có thể update, cải thiện thông qua chat với claude code. sẽ có template để setup ví dự team bao nhiều người, những roles nào...
29
+ 18. source code cần 1 template về workflow để có thể setup nhanh 1 team làm việc có thứ tự ko bị lặp/chèn/bỏ sót..
30
+ 19. Về phần các skill và các workflow cần có tính liên kết và bổ trợ cho nhau, ví dụ Skill A có thể dùng skill B và F để có thêm thông tin và lmaf việc chính xác hiệu quả hơn, nhưng cẩn thận bị lặp vô hạn
31
+ 20. Về phần các MCP, tools, etc. cần có tính liên kết và bổ trợ cho nhau, ví dụ MCP A có thể dùng MCP B và F để có thêm thông tin và lmaf việc chính xác hiệu quả hơn, nhưng cẩn thận bị lặp vô hạn
32
+ Dưới đây là 1 mô tả về team tôi đang càn
33
+ ---
34
+ 1.2 Core Team Structure
35
+ ┌─────────────┐
36
+ │ Product │
37
+ │ Manager │
38
+ │ (Part-time│
39
+ │ or Owner) │
40
+ └──────┬──────┘
41
+
42
+ ┌────────────────┼────────────────┐
43
+ │ │ │
44
+ ┌─────┴─────┐ ┌─────┴─────┐ ┌─────┴─────┐
45
+ │ Business │ │ Technical │ │ Design │
46
+ │ Analyst │ │ Lead │ │ (Part │
47
+ │ │ │ │ │ -time) │
48
+ └─────┬─────┘ └─────┬─────┘ └───────────┘
49
+ │ │
50
+ │ ┌──────┼──────┐
51
+ │ │ │ │
52
+ │ ┌────┴──┐ ┌─┴───┐ ┌┴────┐
53
+ │ │ BE │ │ FE │ │ QA │
54
+ │ │ Dev │ │ Dev │ │ Eng │
55
+ │ │ x2 │ │ x2 │ │ x1 │
56
+ │ └───────┘ └─────┘ └─────┘
57
+
58
+ ┌─────┴─────┐
59
+ │ DevOps │
60
+ │ (Part-time│
61
+ │ or Out) │
62
+ └───────────┘
63
+ 1. Role Definitions
64
+ 2.1 Business Analyst (BA)
65
+ Overview
66
+ Attribute Value
67
+ Headcount 1
68
+ Employment Full-time
69
+ Experience 2-4 years
70
+ Priority High
71
+ Required Skills
72
+ Skill Level Description
73
+ Requirements Analysis Expert Elicit, document, validate requirements
74
+ Documentation Expert Write clear BRD, SRS, user stories
75
+ Process Mapping Advanced Create workflow diagrams, flowcharts
76
+ SQL/Database Basic Query data for analysis
77
+ Communication Expert Bridge between business and tech
78
+ Agile/Scrum Advanced Work in sprint-based environment
79
+ Nice-to-Have Skills
80
+ Skill Description
81
+ Logistics Domain Understanding of parking, warehouse operations
82
+ Figma/Design Tools Can review UI mockups
83
+ API Knowledge Understand REST APIs
84
+ Vietnamese Business Local business practices knowledge
85
+ Key Responsibilities
86
+ Analyze business requirements from stakeholders
87
+ Write user stories and acceptance criteria
88
+ Create process flow documentation
89
+ Validate requirements with development team
90
+ Support UAT (User Acceptance Testing)
91
+ Maintain documentation in specs/ folder
92
+ Deliverables
93
+ Deliverable Frequency
94
+ Business Requirements (BR) Per feature
95
+ User Stories (US) Per sprint
96
+ Process Diagrams As needed
97
+ UAT Test Cases Before release
98
+ Interview Questions
99
+ Technical Questions:
100
+
101
+ Describe your process for gathering requirements from non-technical stakeholders.
102
+ How do you handle conflicting requirements from different stakeholders?
103
+ What tools do you use for documentation and why?
104
+ How do you validate that requirements are complete?
105
+ Scenario Questions:
106
+
107
+ A user reports a bug that seems to conflict with the documented requirements. How do you handle this?
108
+ The client wants to add a major feature mid-sprint. What do you do?
109
+ Salary Range (Vietnam): 15-25M VND/month
110
+
111
+ 2.2 Technical Lead / Solution Architect (SA)
112
+ Overview
113
+ Attribute Value
114
+ Headcount 1
115
+ Employment Full-time
116
+ Experience 5-8 years
117
+ Priority Critical
118
+ Required Skills
119
+ Skill Level Description
120
+ System Design Expert Design scalable architectures
121
+ NestJS/Node.js Expert Backend development
122
+ React/TypeScript Advanced Frontend development
123
+ PostgreSQL Expert Database design, optimization
124
+ DevOps Advanced CI/CD, Docker, deployment
125
+ Team Leadership Expert Mentor, code review, technical decisions
126
+ Nice-to-Have Skills
127
+ Skill Description
128
+ Prisma ORM Type-safe database operations
129
+ Redis Caching strategies
130
+ Microservices Future architecture planning
131
+ Cloud (AWS/GCP) Infrastructure knowledge
132
+ Security OWASP, authentication patterns
133
+ Key Responsibilities
134
+ Design system architecture and make technical decisions
135
+ Lead code reviews and ensure code quality
136
+ Mentor junior developers
137
+ Make technology recommendations
138
+ Oversee deployment and infrastructure
139
+ Create technical documentation in specs/
140
+ Deliverables
141
+ Deliverable Frequency
142
+ Architecture Documents Per major feature
143
+ API Specifications Per endpoint
144
+ Code Review Daily
145
+ Technical Decisions As needed
146
+ Interview Questions
147
+ Technical Questions:
148
+
149
+ Explain how you would design a session management system that handles 100+ concurrent vehicle entries.
150
+ What's your approach to database schema design for a multi-tenant system?
151
+ How do you handle authentication and authorization in a web application?
152
+ Describe your CI/CD pipeline setup for a NestJS + React project.
153
+ Architecture Questions:
154
+
155
+ How would you scale this application if we need to handle 10x more traffic?
156
+ What's your approach to technical debt?
157
+ How do you balance feature delivery with code quality?
158
+ Salary Range (Vietnam): 40-60M VND/month
159
+
160
+ 2.3 Backend Developer (BE)
161
+ Overview
162
+ Attribute Value
163
+ Headcount 2
164
+ Employment Full-time
165
+ Experience 2-4 years
166
+ Priority High
167
+ Required Skills
168
+ Skill Level Description
169
+ TypeScript Advanced Strong typing, generics
170
+ NestJS Advanced Controllers, services, modules
171
+ Prisma/ORM Advanced Database operations
172
+ REST API Expert Design and implementation
173
+ SQL Advanced Query optimization
174
+ Testing Intermediate Unit, integration tests
175
+ Nice-to-Have Skills
176
+ Skill Description
177
+ Redis Caching
178
+ Docker Containerization
179
+ WebSocket Real-time features
180
+ Payment Integration Bank APIs, VNPay, MoMo
181
+ OCR Integration License plate recognition
182
+ Key Responsibilities
183
+ Implement API endpoints as per specifications
184
+ Write clean, maintainable TypeScript code
185
+ Create database migrations
186
+ Write unit and integration tests
187
+ Participate in code reviews
188
+ Document APIs using Swagger
189
+ Deliverables
190
+ Deliverable Frequency
191
+ API Endpoints Per sprint
192
+ Unit Tests Per feature
193
+ Database Migrations As needed
194
+ API Documentation Per endpoint
195
+ Interview Questions
196
+ Technical Questions:
197
+
198
+ Explain the difference between a service and a controller in NestJS.
199
+ How do you handle database transactions in Prisma?
200
+ What's your approach to error handling in APIs?
201
+ How do you secure an API endpoint?
202
+ Coding Challenge:
203
+
204
+ Create a simple CRUD API for managing vehicle sessions
205
+ Include input validation and error handling
206
+ Add basic authentication
207
+ Salary Range (Vietnam): 20-35M VND/month
208
+
209
+ 2.4 Frontend Developer (FE)
210
+ Overview
211
+ Attribute Value
212
+ Headcount 2
213
+ Employment Full-time
214
+ Experience 2-4 years
215
+ Priority High
216
+ Required Skills
217
+ Skill Level Description
218
+ TypeScript Advanced Strong typing
219
+ React 18+ Expert Hooks, context, performance
220
+ Vite Intermediate Build tooling
221
+ TailwindCSS Advanced Styling
222
+ TanStack Query Advanced Server state
223
+ Zustand/Redux Intermediate Client state
224
+ Testing Intermediate Vitest, React Testing Library
225
+ Nice-to-Have Skills
226
+ Skill Description
227
+ shadcn/ui Component library
228
+ React Hook Form Form handling
229
+ Zod Schema validation
230
+ PWA Progressive web app
231
+ i18n Internationalization
232
+ Key Responsibilities
233
+ Implement UI components as per design
234
+ Create responsive layouts
235
+ Integrate with backend APIs
236
+ Handle client-side state
237
+ Write component tests
238
+ Optimize application performance
239
+ Deliverables
240
+ Deliverable Frequency
241
+ UI Components Per sprint
242
+ Page Implementations Per feature
243
+ Component Tests Per component
244
+ Performance Reports Monthly
245
+ Interview Questions
246
+ Technical Questions:
247
+
248
+ Explain React's useEffect cleanup function and when to use it.
249
+ How do you handle API state with TanStack Query?
250
+ What's your approach to form validation in React?
251
+ How do you optimize React application performance?
252
+ Coding Challenge:
253
+
254
+ Create a vehicle search form with real-time results
255
+ Include loading, error, and empty states
256
+ Make it responsive for desktop and tablet
257
+ Salary Range (Vietnam): 20-35M VND/month
258
+
259
+ 2.5 QA Engineer
260
+ Overview
261
+ Attribute Value
262
+ Headcount 1
263
+ Employment Full-time
264
+ Experience 2-4 years
265
+ Priority Medium
266
+ Required Skills
267
+ Skill Level Description
268
+ Test Planning Expert Create test plans, test cases
269
+ Manual Testing Expert Functional, regression, UAT
270
+ API Testing Advanced Postman, REST client
271
+ E2E Testing Intermediate Playwright, Cypress
272
+ Bug Tracking Expert Jira, linear, bug lifecycle
273
+ Documentation Advanced Test reports, coverage
274
+ Nice-to-Have Skills
275
+ Skill Description
276
+ Performance Testing k6, Artillery
277
+ Security Testing OWASP basics
278
+ SQL Data verification
279
+ Automation Test automation frameworks
280
+ CI/CD Integration Automated testing in pipeline
281
+ Key Responsibilities
282
+ Create and maintain test plans
283
+ Execute manual testing for new features
284
+ Develop automated E2E tests
285
+ Report and track bugs
286
+ Verify bug fixes
287
+ Conduct regression testing
288
+ Deliverables
289
+ Deliverable Frequency
290
+ Test Plans Per feature
291
+ Test Cases Per sprint
292
+ Bug Reports As found
293
+ Test Reports Per release
294
+ E2E Tests Per feature
295
+ Interview Questions
296
+ Technical Questions:
297
+
298
+ How do you prioritize which tests to automate?
299
+ Describe your bug reporting process.
300
+ How do you handle a situation where developers can't reproduce a bug?
301
+ What's your approach to regression testing?
302
+ Scenario Questions:
303
+
304
+ A critical bug is found just before release. What do you do?
305
+ How do you test an API without documentation?
306
+ Salary Range (Vietnam): 15-25M VND/month
307
+
308
+ 2.6 UI/UX Designer (Part-time/Contract)
309
+ Overview
310
+ Attribute Value
311
+ Headcount 1
312
+ Employment Part-time / Contract
313
+ Experience 2-4 years
314
+ Priority Medium (Can start later)
315
+ Required Skills
316
+ Skill Level Description
317
+ Figma Expert Design tool
318
+ UI Design Expert Visual design, layouts
319
+ UX Design Advanced User flows, wireframes
320
+ Design Systems Advanced Components, tokens
321
+ Prototyping Intermediate Interactive prototypes
322
+ Nice-to-Have Skills
323
+ Skill Description
324
+ HTML/CSS Implementation knowledge
325
+ Accessibility WCAG guidelines
326
+ Motion Design Animations, transitions
327
+ User Research Interviews, testing
328
+ Key Responsibilities
329
+ Create UI mockups in Figma
330
+ Design user flows and wireframes
331
+ Build and maintain design system
332
+ Create interactive prototypes
333
+ Collaborate with developers
334
+ Deliverables
335
+ Deliverable Frequency
336
+ UI Mockups Per screen
337
+ Design System Initial + updates
338
+ Prototypes Per feature
339
+ Assets As needed
340
+ Interview Questions
341
+ Portfolio Review:
342
+
343
+ Walk us through your design process for a recent project.
344
+ How do you handle feedback from stakeholders?
345
+ How do you ensure designs are accessible?
346
+ Scenario Questions:
347
+
348
+ How would you design a form that needs to capture 20+ fields?
349
+ A developer says your design is too complex to implement. What do you do?
350
+ Salary Range (Vietnam): 15-25M VND/month (part-time: 8-15M)
351
+
352
+ 2.7 DevOps Engineer (Part-time/Outsource)
353
+ Overview
354
+ Attribute Value
355
+ Headcount 1
356
+ Employment Part-time / Contract
357
+ Experience 3-5 years
358
+ Priority Medium (Can start later)
359
+ Required Skills
360
+ Skill Level Description
361
+ Docker Expert Containerization
362
+ CI/CD Expert GitHub Actions, Jenkins
363
+ Linux Advanced Server administration
364
+ Nginx Advanced Web server, reverse proxy
365
+ PostgreSQL Intermediate Database administration
366
+ Monitoring Intermediate Logs, metrics, alerts
367
+ Nice-to-Have Skills
368
+ Skill Description
369
+ Kubernetes Container orchestration
370
+ AWS/GCP Cloud platforms
371
+ Terraform Infrastructure as code
372
+ Security Hardening, SSL/TLS
373
+ Key Responsibilities
374
+ Set up and maintain CI/CD pipelines
375
+ Configure Docker environments
376
+ Manage server infrastructure
377
+ Set up monitoring and logging
378
+ Handle deployments
379
+ Ensure system security
380
+ Deliverables
381
+ Deliverable Frequency
382
+ CI/CD Pipeline Initial setup
383
+ Docker Configs Per environment
384
+ Deployment Scripts Per release
385
+ Monitoring Setup Initial + updates
386
+ Interview Questions
387
+ Technical Questions:
388
+
389
+ Describe your CI/CD pipeline setup for a Node.js application.
390
+ How do you handle database migrations in production?
391
+ What's your approach to zero-downtime deployments?
392
+ How do you monitor application health?
393
+ Salary Range (Vietnam): 30-45M VND/month (part-time: 15-25M)
394
+
395
+ 2.8 Product Manager / Project Manager
396
+ Overview
397
+ Attribute Value
398
+ Headcount 1
399
+ Employment Full-time or Part-time
400
+ Experience 3-5 years
401
+ Priority Medium
402
+ Required Skills
403
+ Skill Level Description
404
+ Product Management Expert Roadmap, prioritization
405
+ Project Management Expert Timelines, resources
406
+ Stakeholder Management Expert Communication, alignment
407
+ Agile/Scrum Expert Sprint planning, ceremonies
408
+ Documentation Advanced PRDs, release notes
409
+ Nice-to-Have Skills
410
+ Skill Description
411
+ Technical Background Understanding of development
412
+ Logistics Domain Industry knowledge
413
+ Analytics Data-driven decisions
414
+ Vietnamese Business Local market knowledge
415
+ Key Responsibilities
416
+ Define product roadmap
417
+ Prioritize features and bug fixes
418
+ Manage sprint planning
419
+ Coordinate with stakeholders
420
+ Track project progress
421
+ Manage risks and blockers
422
+ Deliverables
423
+ Deliverable Frequency
424
+ Product Roadmap Quarterly
425
+ Sprint Plans Bi-weekly
426
+ Status Reports Weekly
427
+ Release Notes Per release
428
+ Interview Questions
429
+ Technical Questions:
430
+
431
+ How do you prioritize features when everything seems important?
432
+ Describe your process for gathering user feedback.
433
+ How do you handle scope creep?
434
+ Salary Range (Vietnam): 25-40M VND/month
435
+
436
+ 3. Team Phasing Plan
437
+ Phase 1: MVP (Months 1-3)
438
+ Role Headcount Start
439
+ Technical Lead 1 Week 1
440
+ Backend Developer 2 Week 1
441
+ Frontend Developer 1 Week 2
442
+ Business Analyst 1 Week 1
443
+ Total 5
444
+ Phase 2: Growth (Months 4-6)
445
+ Role Headcount Start
446
+ + Frontend Developer 1 Month 4
447
+ + QA Engineer 1 Month 4
448
+ + UI/UX Designer 0.5 Month 4
449
+ Total 7.5
450
+ Phase 3: Mature (Months 7+)
451
+ Role Headcount Start
452
+ + DevOps Engineer 0.5 Month 7
453
+ + Product Manager 1 Month 7
454
+ Total 9
455
+ 4. Hiring Timeline
456
+ Week 1-2: Technical Lead (CRITICAL)
457
+ Week 2-4: Backend Developers x2
458
+ Week 3-4: Frontend Developer
459
+ Week 1-4: Business Analyst
460
+ Month 2: QA Engineer
461
+ Month 3: UI/UX Designer (part-time)
462
+ Month 4+: DevOps (as needed)
463
+ 5. Interview Process
464
+ 5.1 Standard Process
465
+ Round Duration Focus
466
+ HR Screen 30 min Background, availability, salary
467
+ Technical 60 min Skills assessment, coding
468
+ Team Fit 45 min Culture, communication
469
+ Final 30 min Offer discussion
470
+ 5.2 Technical Assessment
471
+ Role Assessment Type
472
+ Technical Lead System design + Architecture review
473
+ Backend Dev Coding challenge + API design
474
+ Frontend Dev Coding challenge + UI implementation
475
+ QA Test plan creation + Bug hunting
476
+ BA Requirements analysis exercise
477
+ 6. Onboarding Checklist
478
+ Week 1
479
+ Access to GitHub repository
480
+ Access to project management tool (Linear/Jira)
481
+ Access to documentation (docs/)
482
+ Development environment setup
483
+ Introduction to team members
484
+ Review of project overview
485
+ Week 2
486
+ Code walkthrough with Tech Lead
487
+ First task assignment
488
+ Architecture overview
489
+ Deployment process walkthrough
490
+ Week 3-4
491
+ Full integration into sprint
492
+ Code review participation
493
+ Documentation contribution
494
+ 7. Salary Summary
495
+ Role Experience Range (M VND/mo) Avg
496
+ Technical Lead 5-8 yrs 40-60 50
497
+ Backend Dev 2-4 yrs 20-35 27.5
498
+ Frontend Dev 2-4 yrs 20-35 27.5
499
+ Business Analyst 2-4 yrs 15-25 20
500
+ QA Engineer 2-4 yrs 15-25 20
501
+ UI/UX Designer 2-4 yrs 15-25 20
502
+ DevOps 3-5 yrs 30-45 37.5
503
+ Product Manager 3-5 yrs 25-40 32.5
504
+ Estimated Monthly Burn (Phase 1 - 5 people): ~145M VND Estimated Monthly Burn (Phase 2 - 7.5 people): ~210M VND Estimated Monthly Burn (Phase 3 - 9 people): ~280M VND
505
+
506
+ 8. Job Postings Template
507
+ Backend Developer
508
+ TITLE: Backend Developer (NestJS/TypeScript)
509
+
510
+ ABOUT US:
511
+ KimThanhLogistics đang xây dựng hệ thống quản lý bãi xe container hiện đại.
512
+ Chúng tôi tìm kiếm Backend Developer để tham gia phát triển nền tảng core.
513
+
514
+ REQUIREMENTS:
515
+ - 2+ năm kinh nghiệm Node.js/TypeScript
516
+ - Có kinh nghiệm với NestJS framework
517
+ - Hiểu biết về PostgreSQL và ORM (Prisma ưu tiên)
518
+ - Có kinh nghiệm viết REST API
519
+ - Có kinh nghiệm với unit testing
520
+
521
+ NICE TO HAVE:
522
+ - Redis, Docker
523
+ - Payment gateway integration
524
+ - OCR integration
525
+
526
+ BENEFITS:
527
+ - Lương cạnh tranh (20-35M VND)
528
+ - Remote linh hoạt
529
+ - Bảo hiểm sức khỏe
530
+ - 13th month salary
531
+
532
+ CONTACT: [email]
533
+ Frontend Developer
534
+ TITLE: Frontend Developer (React/TypeScript)
535
+
536
+ ABOUT US:
537
+ KimThanhLogistics đang xây dựng hệ thống quản lý bãi xe container hiện đại.
538
+ Chúng tôi tìm kiếm Frontend Developer để xây dựng giao diện người dùng.
539
+
540
+ REQUIREMENTS:
541
+ - 2+ năm kinh nghiệm React
542
+ - TypeScript proficiency
543
+ - Có kinh nghiệm với TailwindCSS
544
+ - Hiểu biết về state management (Zustand, TanStack Query)
545
+ - Responsive design
546
+
547
+ NICE TO HAVE:
548
+ - shadcn/ui
549
+ - React Hook Form + Zod
550
+ - Vite
551
+ - Testing (Vitest, Playwright)
552
+
553
+ BENEFITS:
554
+ - Lương cạnh tranh (20-35M VND)
555
+ - Remote linh hoạt
556
+ - Bảo hiểm sức khỏe
557
+ - 13th month salary
558
+
559
+ CONTACT: [email]
560
+ ---
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@wipal/agent-team",
3
- "version": "1.0.4",
4
- "description": "CLI tool to add AI agent teams to existing projects with minimal setup",
3
+ "version": "1.1.0",
4
+ "description": "CLI tool to add AI agent teams to existing projects with specialized roles, skills, and workflows (v2.1 with OpenFang patterns)",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "agentteam": "./bin/cli.js"
@@ -15,10 +15,16 @@
15
15
  "src",
16
16
  "templates",
17
17
  "config",
18
+ "scripts",
18
19
  ".claude/skills",
19
- ".claude/rules"
20
+ ".claude/rules",
21
+ ".claude/commands",
22
+ "docs",
23
+ "README.md",
24
+ "TUTORIAL.md"
20
25
  ],
21
26
  "scripts": {
27
+ "postinstall": "node ./scripts/postinstall.js",
22
28
  "test": "echo \"Error: no test specified\" && exit 1"
23
29
  },
24
30
  "keywords": [
@@ -0,0 +1,46 @@
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * Postinstall script for @wipal/agent-team
5
+ * Displays setup information after npm install
6
+ */
7
+
8
+ const fs = require('fs');
9
+ const path = require('path');
10
+
11
+ // Check if current directory has .claude
12
+ const cwd = process.cwd();
13
+ const claudeDir = path.join(cwd, '.claude');
14
+ const hasClaudeDir = fs.existsSync(claudeDir);
15
+
16
+ console.log('');
17
+ console.log('\x1b[36m%s\x1b[0m', '🤖 @wipal/agent-team installed!');
18
+ console.log('');
19
+
20
+ if (hasClaudeDir) {
21
+ console.log('\x1b[32m%s\x1b[0m', '✓ This project is already initialized with agent-team.');
22
+ console.log('');
23
+ console.log('Available commands:');
24
+ console.log(' \x1b[36mnpx @wipal/agent-team list\x1b[0m - List all agents');
25
+ console.log(' \x1b[36mnpx @wipal/agent-team add <name> <role>\x1b[0m - Add a new agent');
26
+ console.log(' \x1b[36mnpx @wipal/agent-team projects\x1b[0m - Manage registered projects');
27
+ console.log(' \x1b[36mnpx @wipal/agent-team setup-hooks\x1b[0m - Configure Claude hooks');
28
+ console.log(' \x1b[36mnpx @wipal/agent-team ui\x1b[0m - Start web dashboard');
29
+ } else {
30
+ console.log('To get started:');
31
+ console.log('');
32
+ console.log(' \x1b[36mcd your-project\x1b[0m');
33
+ console.log(' \x1b[36mnpx @wipal/agent-team init\x1b[0m');
34
+ console.log('');
35
+ console.log('Available commands:');
36
+ console.log(' \x1b[36minit\x1b[0m - Initialize .claude/ structure');
37
+ console.log(' \x1b[36madd\x1b[0m - Add an AI agent');
38
+ console.log(' \x1b[36mlist\x1b[0m - List all agents');
39
+ console.log(' \x1b[36mprojects\x1b[0m - Manage registered projects');
40
+ console.log(' \x1b[36msetup-hooks\x1b[0m - Configure Claude hooks');
41
+ console.log(' \x1b[36mui\x1b[0m - Start web dashboard');
42
+ }
43
+
44
+ console.log('');
45
+ console.log('\x1b[90m%s\x1b[0m', 'Documentation: https://github.com/wipal/agent-team');
46
+ console.log('');