Skip to content

Commit ab73564

Browse files
KrosebrookKrosebrook
authored
Merge pull request #50 from Krosebrook/copilot/analyze-repository-for-agents
Add 12 repository-specific custom coding agents
2 parents 128fe6e + c514a91 commit ab73564

14 files changed

+6652
-0
lines changed

‎.github/agents/README.md‎

Lines changed: 350 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,350 @@
1+
# Custom Coding Agents for Interact Platform
2+
3+
This directory contains specialized coding agents that understand the Interact platform's architecture, patterns, and conventions.
4+
5+
**Last Updated:** February 9, 2026
6+
**Total Agents:** 12
7+
8+
---
9+
10+
## Overview
11+
12+
These agents are designed specifically for the Interact employee engagement platform. Each agent references actual file paths, coding patterns, and conventions found in this repository.
13+
14+
## How to Use These Agents
15+
16+
1. **Read the agent file** to understand its capabilities
17+
2. **Provide context** from the agent instructions when asking for help
18+
3. **Reference specific sections** when you need targeted assistance
19+
20+
Example:
21+
> "Using the react-component-builder agent guidelines, create a new BadgeDisplay component that shows earned badges with animations."
22+
23+
---
24+
25+
## Available Agents
26+
27+
### 🎨 Frontend Development
28+
29+
#### 1. React Component Builder
30+
**File:** `react-component-builder.agent.md`
31+
**Purpose:** Creates React components following Interact's exact patterns
32+
33+
**Specializations:**
34+
- Functional components with hooks
35+
- Radix UI primitives integration
36+
- TailwindCSS styling patterns
37+
- TanStack Query for data fetching
38+
- React Hook Form + Zod for forms
39+
- Framer Motion animations
40+
- Error handling & loading states
41+
42+
**When to Use:**
43+
- Building new UI components
44+
- Creating page layouts
45+
- Implementing feature components
46+
47+
---
48+
49+
#### 2. React Hooks Fixer
50+
**File:** `react-hooks-fixer.agent.md`
51+
**Purpose:** Identifies and fixes React Hooks violations
52+
53+
**Specializations:**
54+
- Rules of Hooks enforcement
55+
- Dependency array corrections
56+
- Hook ordering fixes
57+
- Custom hooks creation
58+
- Stale closure prevention
59+
60+
**When to Use:**
61+
- Fixing the 2 critical hooks violations in codebase
62+
- Preventing hooks-related runtime errors
63+
- Refactoring components with hook issues
64+
65+
---
66+
67+
#### 3. Form & Validation Expert
68+
**File:** `form-validation-expert.agent.md`
69+
**Purpose:** Creates forms using React Hook Form + Zod validation
70+
71+
**Specializations:**
72+
- Zod schema definitions
73+
- Form field components
74+
- Multi-step forms
75+
- Custom validation rules
76+
- Integration with UI components
77+
78+
**When to Use:**
79+
- Building data entry forms
80+
- Implementing user input validation
81+
- Creating multi-step wizards
82+
83+
---
84+
85+
#### 4. TanStack Query Expert
86+
**File:** `tanstack-query-expert.agent.md`
87+
**Purpose:** Implements data fetching, caching, and mutations
88+
89+
**Specializations:**
90+
- Query patterns and keys
91+
- Mutation with optimistic updates
92+
- Cache invalidation strategies
93+
- Prefetching and pagination
94+
- Error handling and retries
95+
96+
**When to Use:**
97+
- Fetching data from Base44 backend
98+
- Implementing CRUD operations
99+
- Optimizing data loading performance
100+
101+
---
102+
103+
### 🔧 Backend Development
104+
105+
#### 5. Base44 Function Builder
106+
**File:** `base44-function-builder.agent.md`
107+
**Purpose:** Creates serverless functions using Base44 SDK
108+
109+
**Specializations:**
110+
- Base44 SDK patterns (0.8.3)
111+
- Authentication & authorization
112+
- Entity CRUD operations
113+
- AI service integrations
114+
- Third-party API integrations
115+
116+
**When to Use:**
117+
- Creating new API endpoints
118+
- Implementing business logic
119+
- Integrating external services
120+
121+
---
122+
123+
#### 6. AI Integration Specialist
124+
**File:** `ai-integration-specialist.agent.md`
125+
**Purpose:** Implements AI features using OpenAI, Claude, and Gemini
126+
127+
**Specializations:**
128+
- OpenAI GPT-4 integration
129+
- Anthropic Claude integration
130+
- Google Gemini integration
131+
- Prompt engineering
132+
- Streaming responses
133+
- Cost management
134+
135+
**When to Use:**
136+
- Building AI-powered features
137+
- Generating content with AI
138+
- Creating intelligent recommendations
139+
140+
---
141+
142+
### 🎮 Domain-Specific
143+
144+
#### 7. Gamification Expert
145+
**File:** `gamification-expert.agent.md`
146+
**Purpose:** Implements gamification features (points, badges, leaderboards)
147+
148+
**Specializations:**
149+
- Points system implementation
150+
- Badge creation and awarding
151+
- Leaderboard calculations
152+
- Challenge tracking
153+
- Reward system
154+
- Gamification animations
155+
156+
**When to Use:**
157+
- Building engagement features
158+
- Implementing achievement systems
159+
- Creating competitive elements
160+
161+
---
162+
163+
### 🧪 Quality Assurance
164+
165+
#### 8. Unit Test Writer
166+
**File:** `test-writer.agent.md`
167+
**Purpose:** Writes comprehensive unit tests using Vitest + RTL
168+
169+
**Specializations:**
170+
- Vitest test patterns
171+
- React Testing Library
172+
- Component testing
173+
- Hook testing
174+
- Mock data creation
175+
- Coverage optimization
176+
177+
**When to Use:**
178+
- Writing tests for new code
179+
- Improving test coverage (target: 30%+)
180+
- Testing React components and hooks
181+
182+
---
183+
184+
#### 9. Code Quality & Linter
185+
**File:** `code-quality-linter.agent.md`
186+
**Purpose:** Fixes ESLint violations and enforces coding standards
187+
188+
**Specializations:**
189+
- ESLint error fixes
190+
- Unused import removal
191+
- Code style enforcement
192+
- Import organization
193+
- React-specific linting rules
194+
195+
**When to Use:**
196+
- Fixing the 100+ ESLint warnings/errors
197+
- Cleaning up unused imports
198+
- Enforcing code standards
199+
200+
---
201+
202+
#### 10. Security Auditor
203+
**File:** `security-auditor.agent.md`
204+
**Purpose:** Reviews code for security vulnerabilities
205+
206+
**Specializations:**
207+
- Authentication & authorization checks
208+
- Input validation
209+
- XSS prevention
210+
- Secret management
211+
- OWASP Top 10 awareness
212+
- npm vulnerability fixes
213+
214+
**When to Use:**
215+
- Maintaining 100/100 security score
216+
- Reviewing security-sensitive code
217+
- Fixing vulnerability reports
218+
219+
---
220+
221+
### 📚 Documentation & DevOps
222+
223+
#### 11. Documentation Writer
224+
**File:** `documentation-writer.agent.md`
225+
**Purpose:** Creates technical documentation matching Interact's standards
226+
227+
**Specializations:**
228+
- API documentation
229+
- Component documentation
230+
- Technical guides
231+
- Architecture documentation
232+
- Maintaining 98/100 doc score
233+
234+
**When to Use:**
235+
- Documenting new features
236+
- Creating API references
237+
- Writing how-to guides
238+
239+
---
240+
241+
#### 12. CI/CD Pipeline Manager
242+
**File:** `cicd-pipeline-manager.agent.md`
243+
**Purpose:** Manages GitHub Actions workflows
244+
245+
**Specializations:**
246+
- Workflow creation and maintenance
247+
- Pipeline failure debugging
248+
- Caching optimization
249+
- Build performance tuning
250+
- Deployment automation
251+
252+
**When to Use:**
253+
- Fixing CI/CD failures
254+
- Optimizing build times
255+
- Adding new workflow steps
256+
257+
---
258+
259+
## Agent Selection Guide
260+
261+
### By Task Type
262+
263+
**Creating New Features:**
264+
1. Start with `react-component-builder` for frontend
265+
2. Use `base44-function-builder` for backend
266+
3. Apply `form-validation-expert` if forms needed
267+
4. Add `gamification-expert` for engagement features
268+
5. Finish with `test-writer` for tests
269+
270+
**Fixing Issues:**
271+
1. Use `react-hooks-fixer` for hooks violations
272+
2. Apply `code-quality-linter` for linting errors
273+
3. Use `security-auditor` for security issues
274+
4. Reference `cicd-pipeline-manager` for build failures
275+
276+
**Improving Quality:**
277+
1. `test-writer` - Increase coverage from 0.09% to 30%+
278+
2. `code-quality-linter` - Fix 100+ linting issues
279+
3. `documentation-writer` - Maintain 98/100 doc score
280+
4. `security-auditor` - Keep 100/100 security score
281+
282+
### By Experience Level
283+
284+
**Junior Developers:**
285+
- `react-component-builder` - Learn component patterns
286+
- `test-writer` - Understand testing practices
287+
- `form-validation-expert` - Master form handling
288+
289+
**Mid-Level Developers:**
290+
- `base44-function-builder` - Backend development
291+
- `tanstack-query-expert` - Advanced data fetching
292+
- `gamification-expert` - Domain logic
293+
294+
**Senior Developers:**
295+
- `ai-integration-specialist` - AI features
296+
- `security-auditor` - Security reviews
297+
- `cicd-pipeline-manager` - Infrastructure
298+
299+
---
300+
301+
## Technical Context
302+
303+
### Tech Stack
304+
- **Frontend:** React 18, Vite 6, TailwindCSS, Radix UI
305+
- **State:** React Context + TanStack Query 5.84.1
306+
- **Forms:** React Hook Form 7.54.2 + Zod 3.24.2
307+
- **Backend:** Base44 SDK 0.8.3 (serverless TypeScript)
308+
- **Testing:** Vitest 4.0.17 + React Testing Library
309+
- **AI:** OpenAI GPT-4, Claude 3, Gemini Pro
310+
311+
### Project Stats
312+
- **Pages:** 47 application pages
313+
- **Components:** 42+ component categories
314+
- **Backend Functions:** 61 TypeScript functions
315+
- **Test Coverage:** 0.09% (target: 30%+ by Q1 2026)
316+
- **Security Score:** 100/100 ✅
317+
- **Documentation Score:** 98/100 ✅
318+
319+
### Known Issues
320+
- 100+ ESLint warnings/errors
321+
- 2 critical React Hooks violations
322+
- Low test coverage (0.09%)
323+
- Need TypeScript migration (Q2-Q3 2026)
324+
325+
---
326+
327+
## Contributing
328+
329+
When adding new agents:
330+
331+
1. **Follow the template** format in existing agents
332+
2. **Reference actual code** from the repository
333+
3. **Include specific file paths** and patterns
334+
4. **Provide working examples** from the codebase
335+
5. **Update this README** with agent details
336+
337+
---
338+
339+
## Related Documentation
340+
341+
- [Copilot Instructions](../copilot-instructions.md) - Repository-wide guidelines
342+
- [Setup Steps](../copilot-setup-steps.yml) - Environment setup
343+
- [CONTRIBUTING.md](../../CONTRIBUTING.md) - Contribution guidelines
344+
- [TESTING.md](../../TESTING.md) - Testing strategy
345+
- [CODEBASE_AUDIT.md](../../CODEBASE_AUDIT.md) - Technical audit
346+
347+
---
348+
349+
**Maintained by:** Krosebrook
350+
**Questions?** Create an issue or refer to [AGENTS.md](../../AGENTS.md)

0 commit comments

Comments
 (0)