Skip to content

Add 12 repository-specific custom coding agents #50

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Krosebrook merged 3 commits into from
Feb 9, 2026
Merged

Add 12 repository-specific custom coding agents #50

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
6255bff
Initial plan
Copilot Feb 9, 2026
bcd0c90
Add 12 custom coding agents and setup file for Interact platform
Copilot Feb 9, 2026
c514a91
Add agents README with comprehensive documentation
Copilot Feb 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
350 changes: 350 additions & 0 deletions .github/agents/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,350 @@
# Custom Coding Agents for Interact Platform

This directory contains specialized coding agents that understand the Interact platform's architecture, patterns, and conventions.

**Last Updated:** February 9, 2026
**Total Agents:** 12

---

## Overview

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.

## How to Use These Agents

1. **Read the agent file** to understand its capabilities
2. **Provide context** from the agent instructions when asking for help
3. **Reference specific sections** when you need targeted assistance

Example:
> "Using the react-component-builder agent guidelines, create a new BadgeDisplay component that shows earned badges with animations."

---

## Available Agents

### 🎨 Frontend Development

#### 1. React Component Builder
**File:** `react-component-builder.agent.md`
**Purpose:** Creates React components following Interact's exact patterns

**Specializations:**
- Functional components with hooks
- Radix UI primitives integration
- TailwindCSS styling patterns
- TanStack Query for data fetching
- React Hook Form + Zod for forms
- Framer Motion animations
- Error handling & loading states

**When to Use:**
- Building new UI components
- Creating page layouts
- Implementing feature components

---

#### 2. React Hooks Fixer
**File:** `react-hooks-fixer.agent.md`
**Purpose:** Identifies and fixes React Hooks violations

**Specializations:**
- Rules of Hooks enforcement
- Dependency array corrections
- Hook ordering fixes
- Custom hooks creation
- Stale closure prevention

**When to Use:**
- Fixing the 2 critical hooks violations in codebase
- Preventing hooks-related runtime errors
- Refactoring components with hook issues

---

#### 3. Form & Validation Expert
**File:** `form-validation-expert.agent.md`
**Purpose:** Creates forms using React Hook Form + Zod validation

**Specializations:**
- Zod schema definitions
- Form field components
- Multi-step forms
- Custom validation rules
- Integration with UI components

**When to Use:**
- Building data entry forms
- Implementing user input validation
- Creating multi-step wizards

---

#### 4. TanStack Query Expert
**File:** `tanstack-query-expert.agent.md`
**Purpose:** Implements data fetching, caching, and mutations

**Specializations:**
- Query patterns and keys
- Mutation with optimistic updates
- Cache invalidation strategies
- Prefetching and pagination
- Error handling and retries

**When to Use:**
- Fetching data from Base44 backend
- Implementing CRUD operations
- Optimizing data loading performance

---

### 🔧 Backend Development

#### 5. Base44 Function Builder
**File:** `base44-function-builder.agent.md`
**Purpose:** Creates serverless functions using Base44 SDK

**Specializations:**
- Base44 SDK patterns (0.8.3)
- Authentication & authorization
- Entity CRUD operations
- AI service integrations
- Third-party API integrations

**When to Use:**
- Creating new API endpoints
- Implementing business logic
- Integrating external services

---

#### 6. AI Integration Specialist
**File:** `ai-integration-specialist.agent.md`
**Purpose:** Implements AI features using OpenAI, Claude, and Gemini

**Specializations:**
- OpenAI GPT-4 integration
- Anthropic Claude integration
- Google Gemini integration
- Prompt engineering
- Streaming responses
- Cost management

**When to Use:**
- Building AI-powered features
- Generating content with AI
- Creating intelligent recommendations

---

### 🎮 Domain-Specific

#### 7. Gamification Expert
**File:** `gamification-expert.agent.md`
**Purpose:** Implements gamification features (points, badges, leaderboards)

**Specializations:**
- Points system implementation
- Badge creation and awarding
- Leaderboard calculations
- Challenge tracking
- Reward system
- Gamification animations

**When to Use:**
- Building engagement features
- Implementing achievement systems
- Creating competitive elements

---

### 🧪 Quality Assurance

#### 8. Unit Test Writer
**File:** `test-writer.agent.md`
**Purpose:** Writes comprehensive unit tests using Vitest + RTL

**Specializations:**
- Vitest test patterns
- React Testing Library
- Component testing
- Hook testing
- Mock data creation
- Coverage optimization

**When to Use:**
- Writing tests for new code
- Improving test coverage (target: 30%+)
- Testing React components and hooks

---

#### 9. Code Quality & Linter
**File:** `code-quality-linter.agent.md`
**Purpose:** Fixes ESLint violations and enforces coding standards

**Specializations:**
- ESLint error fixes
- Unused import removal
- Code style enforcement
- Import organization
- React-specific linting rules

**When to Use:**
- Fixing the 100+ ESLint warnings/errors
- Cleaning up unused imports
- Enforcing code standards

---

#### 10. Security Auditor
**File:** `security-auditor.agent.md`
**Purpose:** Reviews code for security vulnerabilities

**Specializations:**
- Authentication & authorization checks
- Input validation
- XSS prevention
- Secret management
- OWASP Top 10 awareness
- npm vulnerability fixes

**When to Use:**
- Maintaining 100/100 security score
- Reviewing security-sensitive code
- Fixing vulnerability reports

---

### 📚 Documentation & DevOps

#### 11. Documentation Writer
**File:** `documentation-writer.agent.md`
**Purpose:** Creates technical documentation matching Interact's standards

**Specializations:**
- API documentation
- Component documentation
- Technical guides
- Architecture documentation
- Maintaining 98/100 doc score

**When to Use:**
- Documenting new features
- Creating API references
- Writing how-to guides

---

#### 12. CI/CD Pipeline Manager
**File:** `cicd-pipeline-manager.agent.md`
**Purpose:** Manages GitHub Actions workflows

**Specializations:**
- Workflow creation and maintenance
- Pipeline failure debugging
- Caching optimization
- Build performance tuning
- Deployment automation

**When to Use:**
- Fixing CI/CD failures
- Optimizing build times
- Adding new workflow steps

---

## Agent Selection Guide

### By Task Type

**Creating New Features:**
1. Start with `react-component-builder` for frontend
2. Use `base44-function-builder` for backend
3. Apply `form-validation-expert` if forms needed
4. Add `gamification-expert` for engagement features
5. Finish with `test-writer` for tests

**Fixing Issues:**
1. Use `react-hooks-fixer` for hooks violations
2. Apply `code-quality-linter` for linting errors
3. Use `security-auditor` for security issues
4. Reference `cicd-pipeline-manager` for build failures

**Improving Quality:**
1. `test-writer` - Increase coverage from 0.09% to 30%+
2. `code-quality-linter` - Fix 100+ linting issues
3. `documentation-writer` - Maintain 98/100 doc score
4. `security-auditor` - Keep 100/100 security score

### By Experience Level

**Junior Developers:**
- `react-component-builder` - Learn component patterns
- `test-writer` - Understand testing practices
- `form-validation-expert` - Master form handling

**Mid-Level Developers:**
- `base44-function-builder` - Backend development
- `tanstack-query-expert` - Advanced data fetching
- `gamification-expert` - Domain logic

**Senior Developers:**
- `ai-integration-specialist` - AI features
- `security-auditor` - Security reviews
- `cicd-pipeline-manager` - Infrastructure

---

## Technical Context

### Tech Stack
- **Frontend:** React 18, Vite 6, TailwindCSS, Radix UI
- **State:** React Context + TanStack Query 5.84.1
- **Forms:** React Hook Form 7.54.2 + Zod 3.24.2
- **Backend:** Base44 SDK 0.8.3 (serverless TypeScript)
- **Testing:** Vitest 4.0.17 + React Testing Library
- **AI:** OpenAI GPT-4, Claude 3, Gemini Pro

### Project Stats
- **Pages:** 47 application pages
- **Components:** 42+ component categories
- **Backend Functions:** 61 TypeScript functions
- **Test Coverage:** 0.09% (target: 30%+ by Q1 2026)
- **Security Score:** 100/100 ✅
- **Documentation Score:** 98/100 ✅

### Known Issues
- 100+ ESLint warnings/errors
- 2 critical React Hooks violations
- Low test coverage (0.09%)
- Need TypeScript migration (Q2-Q3 2026)

---

## Contributing

When adding new agents:

1. **Follow the template** format in existing agents
2. **Reference actual code** from the repository
3. **Include specific file paths** and patterns
4. **Provide working examples** from the codebase
5. **Update this README** with agent details

---

## Related Documentation

- [Copilot Instructions](../copilot-instructions.md) - Repository-wide guidelines
- [Setup Steps](../copilot-setup-steps.yml) - Environment setup
- [CONTRIBUTING.md](../../CONTRIBUTING.md) - Contribution guidelines
- [TESTING.md](../../TESTING.md) - Testing strategy
- [CODEBASE_AUDIT.md](../../CODEBASE_AUDIT.md) - Technical audit

---

**Maintained by:** Krosebrook
**Questions?** Create an issue or refer to [AGENTS.md](../../AGENTS.md)
Copy link

@cubic-dev-ai cubic-dev-ai bot Feb 9, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P3: The link points to AGENTS.md, but that file does not exist in the repository, so the documentation link is broken. Remove the link or update it to an existing document.

Prompt for AI agents 
Check if this issue is valid — if so, understand the root cause and fix it. At .github/agents/README.md, line 350:

<comment>The link points to `AGENTS.md`, but that file does not exist in the repository, so the documentation link is broken. Remove the link or update it to an existing document.</comment>

<file context>
@@ -0,0 +1,350 @@
+---
+
+**Maintained by:** Krosebrook  
+**Questions?** Create an issue or refer to [AGENTS.md](../../AGENTS.md)
</file context>
Fix with Cubic

Loading
Loading