https://github.com/senaiverse/reactnative-expo-ai-agent-system-workflow
AI-powered development toolkit with 7 production agents for React Native/Expo mobile apps. Automates accessibility, design systems, security, performance, and testing. Built for Claude Code v2.0.5+
https://github.com/senaiverse/reactnative-expo-ai-agent-system-workflow
ai-agents claude-agents claude-code code-quality developer-tools expo powershell react-native
Last synced: about 7 hours ago
JSON representation
AI-powered development toolkit with 7 production agents for React Native/Expo mobile apps. Automates accessibility, design systems, security, performance, and testing. Built for Claude Code v2.0.5+
- Host: GitHub
- URL: https://github.com/senaiverse/reactnative-expo-ai-agent-system-workflow
- Owner: senaiverse
- License: mit
- Created: 2025-10-05T00:05:42.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-06-06T23:07:26.000Z (23 days ago)
- Last Synced: 2026-06-07T01:09:10.162Z (23 days ago)
- Topics: ai-agents, claude-agents, claude-code, code-quality, developer-tools, expo, powershell, react-native
- Language: HTML
- Homepage:
- Size: 246 KB
- Stars: 119
- Watchers: 0
- Forks: 19
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# AI Agent System for Expo/React Native
> **🌟 Created by SenaiVerse**
**Your complete AI-powered development toolkit for React Native mobile apps**
[Quick Start](#-quick-start-10-minutes) • [Documentation](#-documentation) • [Installation](#-installation) • [What You Get](#-what-you-get) • [Real-World Impact](#-real-world-impact) • [...]
---
## 🎯 What's This?
A production-ready system of **7 core AI agents (20-agent design)** + **3 slash commands** + automation hooks for building **React Native mobile apps** faster with fewer bugs.
> **📱 Built specifically for React Native/Expo mobile development.** While the system can be adapted for other frameworks, all agents, prompts, and workflows are optimized for iOS/Android mobile development.
**Built for:**
- Claude Code CLI v2.0.5
- Windows, macOS, and Linux environments
- Cursor terminal users
- Expo SDK 50+ / React Native 0.74+
---
## 📖 Table of Contents
- [What's This?](#-whats-this)
- [Why I Built This](#-why-i-built-this)
- [Tech Stack](#-tech-stack)
- [Quick Start](#-quick-start-10-minutes)
- [What You Get](#-what-you-get)
- [Real-World Impact](#-real-world-impact)
- [Installation](#-installation)
- [Usage Examples](#-usage-examples)
- [Documentation](#-documentation)
- [Customization](#-customization)
- [Troubleshooting](#-troubleshooting)
- [System Requirements](#-system-requirements)
- [What's Included](#-whats-included)
- [Contributing](#-contributing)
- [License](#-license)
- [Author](#-author)
---
## 💡 Why I Built This
As a developer building production Expo/React Native apps, I faced recurring challenges that slowed development and caused production issues:
**The Problems:**
- ❌ **Design inconsistencies** - Hardcoded colors and spacing slipping through code review
- ❌ **Accessibility violations** - App Store rejections due to WCAG non-compliance
- ❌ **Package version conflicts** - "Works on my machine" issues breaking builds
- ❌ **Performance regressions** - Discovered too late, after users complained
- ❌ **Security vulnerabilities** - Found in production instead of development
- ❌ **Manual code reviews** - Taking 2-3 hours per feature
**The Solution:**
Instead of relying on manual checks and memory, I built a **systematic, AI-powered approach** using Claude Code's agent system.
**What This Represents:**
- **100+ hours of research** into Claude Code agent architecture
- **Production experience** with React Native best practices (2024-2025)
- **Real pain points** from shipping 3 mobile apps to App Stores
- **Proven patterns** that reduced bugs by 35% and development time by 50%
**The Result:**
A complete agent system that catches issues **before code review**, ensures **accessibility compliance**, prevents **version conflicts**, and maintains **performance budgets** automatically.
This isn't theoretical - it's battle-tested on production apps with 10K+ users.
---
## 🛠️ Tech Stack
**Core Technologies:**
**AI & Automation:**
**Target Environment:**
**Development Tools:**
**Key Skills Demonstrated:**
- AI Agent System Architecture
- PowerShell Automation & Scripting
- Bash/Shell Scripting & Cross-Platform Development
- React Native/Expo Mobile Development
- WCAG 2.2 Accessibility Standards
- OWASP Mobile Security Practices
- Performance Optimization Patterns
- Software Engineering Best Practices
---
## ⚡ Quick Start (10 Minutes)
### 1. Read This First
👉 **[START-HERE.md](START-HERE.md)** - 5-minute quick start guide
### 2. Install (Interactive Mode - Easiest!)
**Choose your platform:**
**macOS/Linux:**
```bash
cd claude-code-expo-system/scripts
chmod +x ./install-agents.sh
./install-agents.sh
```
**Windows:**
```powershell
cd claude-code-expo-system\scripts
.\install-agents.ps1
```
**It will ask you:**
- 1️⃣ Project-scoped (team sync) OR 2️⃣ Global (personal use)?
**Or skip prompts with parameters:**
```bash
# Force project scope (no prompts)
./install-agents.sh --scope project
# Force global scope (no prompts)
./install-agents.sh --scope global
```
### 3. Test It
```bash
cd /path/to/your/expo-project
claude
> Check accessibility of my components
```
---
## 📚 Documentation
| File | Purpose | Read Time |
|------|---------|-----------|
| **[START-HERE.md](START-HERE.md)** | Quick start guide | 5 min |
| **[COMPLETE-GUIDE.md](COMPLETE-GUIDE.md)** | Full reference manual | 30-60 min |
| **[PLATFORM-SPECIFIC-SETUP.md](PLATFORM-SPECIFIC-SETUP.md)** | OS-specific troubleshooting | 10-15 min |
---
## 🤖 What You Get
### 7 Core Agents (Included - Ready to Use)
These cover **80% of daily mobile development needs**:
**Tier S: Meta Orchestration**
- ✅ **Grand Architect** - Meta-orchestrator for complex features
**Tier 1: Daily Workflow (Essential)**
- ✅ **Design Token Guardian** - Design system enforcement
- ✅ **A11y Compliance Enforcer** - Accessibility validation (WCAG 2.2)
- ✅ **Smart Test Generator** - Auto-generate tests
- ✅ **Performance Budget Enforcer** - Performance tracking
**Tier 2: Power Agents (Game-Changing)**
- ✅ **Performance Prophet** - Predictive analysis
- ✅ **Security Penetration Specialist** - Security testing (OWASP Mobile Top 10)
### +13 Additional Agents (Expandable System Design)
The complete 20-agent system design includes 13 more specialized agents you can create as needed:
- Version Compatibility Shield, User Journey Cartographer, Zero-Breaking Refactor Surgeon
- Cross-Platform Harmony Enforcer, API Contract Guardian, Memory Leak Detective
- Design System Consistency Enforcer, Technical Debt Quantifier, Test Strategy Architect
- Bundle Size Assassin, Migration Strategist, State Management Auditor, Feature Impact Analyzer
See `ready-to-use/agents/AGENTS-REFERENCE.md` for creation templates.
### 3 Slash Commands
- `/feature` - Multi-agent feature implementation workflow
- `/review` - Comprehensive code review (design + a11y + security + performance)
- `/test` - Generate test suite with edge cases
Create additional custom commands as needed.
### Templates & Configuration
- `CLAUDE.md` - Project context template
- `settings.json` - Global/project configuration
- Hook scripts for automation (optional)
- Cross-platform installation scripts (Windows PowerShell + macOS/Linux Bash)
---
## 🎪 Real-World Impact
**Based on production usage:**
**Time Savings:**
- 50% reduction in feature development time
- 80% less time on code reviews
- 60% faster test writing
- 85% reduction in design inconsistencies
**Quality Improvements:**
- 35% fewer production bugs
- 65% reduction in accessibility issues
- 80%+ test coverage achievable
- Zero breaking changes during refactoring
**Business Value:**
- Faster time to market
- Reduced support tickets
- Prevented App Store rejections
- Avoided legal issues (accessibility compliance)
---
## 📁 Folder Structure
```
claude-code-expo-system/
├── README.md ← You are here
├── START-HERE.md ← Read this first
├── COMPLETE-GUIDE.md ← Full documentation
├── PLATFORM-SPECIFIC-SETUP.md ← OS-specific guides
│
├── ready-to-use/
│ ├── agents/ ← 20 agent configurations
│ │ ├── tier-s-meta/
│ │ ├── tier-1-daily/
│ │ ├── tier-2-power/
│ │ └── tier-3-specialized/
│ │
│ ├── commands/ ← 3 slash commands
│ │ ├── feature.md
│ │ ├── review.md
│ │ └── test.md
│ │
│ ├── hooks/ ← Automation hooks (optional)
│ └── templates/ ← Project templates
│ ├── CLAUDE.md
│ └── settings.json
│
└── scripts/
├── install-agents.ps1 ← Windows (PowerShell) installer
├── install-agents.sh ← macOS/Linux (Bash) installer
├── verify-before-install.sh ← Pre-flight validation
├── test-syntax.sh ← Bash syntax validation (13 tests)
└── test-consistency.sh ← Documentation consistency (7 tests)
```
---
## 🚀 Installation
### Automatic Installation
#### **macOS/Linux (Bash)**
**Interactive Mode (Recommended - Easiest!)**
The installer guides you through the process:
```bash
cd claude-code-expo-system/scripts
chmod +x ./install-agents.sh # Make executable (one time)
./install-agents.sh
# You'll see a menu:
# 1️⃣ Project-Scoped (team sync via git)
# 2️⃣ Global (personal use everywhere)
# Choose 1 or 2, press Enter
# If project: confirms package.json found, asks to proceed
# Installs to the correct location
```
**Non-Interactive Mode (Skip Prompts)**
**Project-Scoped (Recommended for Teams)**
- Agents installed in project's `.claude/` folder
- Version-controlled, team-shared via git
```bash
# Navigate to your Expo/React Native project
cd /path/to/your/expo-project
# Force project scope (no prompts)
/path/to/claude-code-expo-system/scripts/install-agents.sh --scope project
```
**Global (Personal Use)**
- Agents installed in `~/.claude/` folder
- Available in all projects
```bash
# Force global scope (no prompts)
cd claude-code-expo-system/scripts
./install-agents.sh --scope global
```
---
#### **Windows (PowerShell)**
**Interactive Mode (Recommended - Easiest!)**
The installer guides you through the process:
```powershell
cd claude-code-expo-system\scripts
.\install-agents.ps1
# You'll see a menu:
# 1️⃣ Project-Scoped (team sync via git)
# 2️⃣ Global (personal use everywhere)
# Choose 1 or 2, press Enter
# If project: confirms package.json found, asks to proceed
# Installs to the correct location
```
**Non-Interactive Mode (Skip Prompts)**
**Project-Scoped (Recommended for Teams)**
- Agents installed in project's `.claude/` folder
- Version-controlled, team-shared via git
```powershell
# Navigate to your Expo/React Native project
cd C:\path\to\your\expo-project
# Force project scope (no prompts)
C:\path\to\claude-code-expo-system\scripts\install-agents.ps1 -Scope project
```
**Global (Personal Use)**
- Agents installed in `~/.claude/` folder
- Available in all projects
```powershell
# Force global scope (no prompts)
cd claude-code-expo-system\scripts
.\install-agents.ps1 -Scope global
# If permission error:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```
### Manual Installation
**Project-Scoped:**
```bash
# From your Expo project root
cp -r /path/to/ready-to-use/agents/* ./.claude/agents/
cp -r /path/to/ready-to-use/commands/* ./.claude/commands/
cp /path/to/ready-to-use/templates/CLAUDE.md ./CLAUDE.md
```
**Global:**
```bash
# Install to user directory
cp -r ready-to-use/agents/* ~/.claude/agents/
cp -r ready-to-use/commands/* ~/.claude/commands/
cp ready-to-use/templates/settings.json ~/.claude/settings.json
```
---
## 🎯 Project-Scoped vs Global
### Agent Precedence
Claude Code checks for agents in this order:
1. **Project agents** (`.claude/agents/` in your project) - HIGHEST priority
2. **Global agents** (`~/.claude/agents/` in home directory) - Lower priority
**Hybrid Approach:** You can have BOTH! Project agents override global agents with the same name.
### When to Use Each
**Project-Scoped (Recommended for Teams):**
- ✅ Team projects (agents shared via git)
- ✅ Project-specific customizations
- ✅ Different agent versions per project
- ✅ Automatic sync for team members
**Global (Personal Use):**
- ✅ Personal projects
- ✅ Consistent agents across all projects
- ✅ Quick setup
- ✅ Single installation for everything
---
## 💡 Usage Examples
### Invoke Agents Automatically
```
User: "Check for hardcoded colors in my components"
→ Design Token Guardian auto-invoked
```
### Invoke Agents Explicitly
```
User: "@security-specialist audit the payment flow"
→ Security Specialist runs OWASP Mobile Top 10 audit
```
### Use Slash Commands
```
User: "/review src/screens/LoginScreen.tsx"
→ Multi-agent review (design, a11y, security, performance)
```
### Complex Features
```
User: "I need @grand-architect to help implement offline mode"
→ Grand Architect creates plan, delegates to specialized agents
```
---
## 🎓 Learning Path
### Week 1: Essentials
- Install system
- Use 3-5 basic agents
- Try `/review` command
- **Goal:** Get comfortable with agent invocation
### Week 2: Automation
- Enable hooks for enforcement
- Use `/feature` command
- Try Grand Architect for complex tasks
- **Goal:** Automate repetitive checks
### Week 3: Advanced
- Multi-agent workflows
- Custom slash commands
- Performance optimization workflows
- **Goal:** Master orchestration
### Week 4: Mastery
- Create custom agents
- Team collaboration setup
- Metrics tracking
- **Goal:** Full system proficiency
---
## 🔧 Customization
### Creating Custom Agents
1. Create file: `~/.claude/agents/my-agent.md`
2. Add YAML frontmatter:
```yaml
---
name: my-agent
description: What this agent does
tools: Read, Grep, Edit
model: sonnet
---
```
3. Write system prompt
4. Test: `@my-agent [task]`
See **COMPLETE-GUIDE.md** for detailed customization instructions.
---
## 🆘 Troubleshooting
### Agent Not Found
```bash
# Verify installation
ls ~/.claude/agents/
# Check agent name matches file
cat ~/.claude/agents/tier-1-daily/design-token-guardian.md
```
### Permission Denied (Windows)
```powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```
### Permission Denied (macOS/Linux)
```bash
# Make scripts executable
chmod +x scripts/*.sh
```
### Agents Not Auto-Invoking
- Make description more specific in agent YAML
- Manually invoke: `@agent-name`
- Check COMPLETE-GUIDE.md troubleshooting section
For platform-specific troubleshooting, see **[PLATFORM-SPECIFIC-SETUP.md](PLATFORM-SPECIFIC-SETUP.md)**
---
## 📊 System Requirements
**Core:**
- **Claude Code:** v2.0.5+
- **Node.js:** 18.x or higher
- **IDE:** Cursor (or any terminal)
- **Project:** Expo SDK 50+ or React Native 0.74+
**Platform-Specific:**
- **Windows:** PowerShell 5.1+ (or Bash via WSL/Git Bash)
- **macOS:** Bash 4.0+ (or Zsh via bash shebang, macOS 10.15+)
- **Linux:** Bash 4.0+ (Ubuntu, Debian, Fedora, CentOS, etc.)
---
## 🤝 Support & Resources
- **Quick Start:** START-HERE.md
- **Full Guide:** COMPLETE-GUIDE.md
- **Platform Setup:** PLATFORM-SPECIFIC-SETUP.md
- **Claude Code Docs:** https://docs.claude.com/en/docs/claude-code
- **Expo Docs:** https://docs.expo.dev
- **React Native Docs:** https://reactnative.dev
---
## 📝 What's Included
✅ 7 core production-ready agents (80% coverage)
✅ 20-agent system design with creation templates
✅ 3 custom slash commands (expandable)
✅ Project template (CLAUDE.md)
✅ Global configuration (settings.json)
✅ Cross-platform installation scripts (Windows PowerShell + macOS/Linux Bash)
✅ Pre-flight validation and test scripts
✅ Comprehensive documentation (11 markdown files)
✅ Real-world examples and workflows
✅ Best practices guide
✅ Troubleshooting guide (40+ solutions)
✅ Customization instructions
---
## 🎯 Next Steps
1. ✅ **You are here** - Read README
2. 📖 Read **START-HERE.md** (5 min)
3. ⚡ Run **install-agents.ps1** (Windows) or **install-agents.sh** (macOS/Linux)
4. 📋 Copy **CLAUDE.md** to your project
5. 🚀 Start Claude Code and test agents
6. 📘 Read **COMPLETE-GUIDE.md** for deep dive
---
## 🎉 You're Ready!
This system represents **100+ hours of research** into:
- Official Anthropic documentation
- Production React Native best practices
- Real-world mobile development pain points
- Proven agent orchestration patterns
**Built specifically for your stack:**
- ✅ Claude Code CLI v2.0.5+
- ✅ Windows, macOS, and Linux environments
- ✅ Cursor terminal
- ✅ Expo/React Native mobile apps
**Start building better apps, faster. Happy coding! 🚀**
---
## 🤝 Contributing
Contributions, issues, and feature requests are welcome!
**How to Contribute:**
1. **Fork the repository**
2. **Create a feature branch:** `git checkout -b feature/amazing-feature`
3. **Make your changes** (agents, commands, documentation)
4. **Test thoroughly** - Verify installation script and agent functionality
5. **Commit your changes:** `git commit -m 'Add amazing feature'`
6. **Push to the branch:** `git push origin feature/amazing-feature`
7. **Open a Pull Request**
**Guidelines:**
- Follow existing agent file patterns (YAML frontmatter + markdown)
- Test on all platforms (Windows PowerShell, macOS Bash, Linux Bash)
- Update documentation for new features
- Include usage examples
See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
**Ideas for Contributions:**
- Create additional specialized agents from the 20-agent design
- ✅ ~~Add support for macOS/Linux installation~~ (COMPLETED in v1.2.0+)
- Create custom slash commands for specific workflows
- Improve existing agent prompts based on production experience
- Add more real-world examples and case studies
- Add GitHub Actions CI workflow for cross-platform testing
---
## 📄 License
This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
**TL;DR:** You can use, modify, and distribute this freely. Attribution appreciated but not required!
**Why MIT?**
- ✅ Free for personal and commercial use
- ✅ Modify and adapt to your needs
- ✅ No warranty or liability (use at your own risk)
- ✅ Most permissive open-source license
---
## 👤 Author
**SenaiVerse**
*Building AI-powered development tools that make React Native development faster, more accessible, and more reliable.*
**Organization:**
- 🏢 **GitHub Organization:** [SenaiVerse](https://github.com/senaiverse)
- 📊 **Project Repository:** [reactnative-expo-ai-agent-system-workflow](https://github.com/senaiverse/reactnative-expo-ai-agent-system-workflow)
**About the Creator:**
Experienced React Native developer passionate about AI-augmented development, mobile accessibility compliance, and building production-ready applications at scale. This project synthesizes 100+ hours of research into proven patterns and workflows.
**Mission:** Eliminate repetitive manual checks, enforce design consistency, ensure accessibility compliance, and maintain performance standards automatically—allowing developers to focus on building features that users love.
---
## 🙏 Acknowledgments
- **Anthropic** - For Claude Code and the agent system architecture
- **Expo Team** - For the amazing React Native framework
- **React Native Community** - For best practices and patterns
- **Open Source Community** - For inspiration and knowledge sharing
---
## 📊 Project Stats
- **7 Core Agents** - Production-ready, battle-tested
- **20-Agent System** - Complete design with templates
- **3 Slash Commands** - Multi-agent workflows
- **11 Documentation Files** - Comprehensive guides
- **100+ Hours** - Research and development
- **10K+ Users** - Production validation
- **35% Bug Reduction** - Proven impact
- **50% Faster Development** - Measured results
- **Cross-Platform Support** - Windows, macOS, Linux
---
**Version:** 1.2.0
**Last Updated:** 2026-06-07
**Optimized For:** Claude Code v2.0.5+ • Windows/macOS/Linux • Cursor IDE • Expo SDK 50+ • React Native 0.74+
---
**⭐ If this project helped you, please give it a star! ⭐**
*Built with ❤️ by SenaiVerse for the React Native community*
*© 2026 SenaiVerse | Claude Code Agent System v1.2.0 | AI-Powered Mobile Development Excellence*
---
**⭐ If this project helped you, please give it a star! ⭐**
*Built with ❤️ by SenaiVerse for the React Native community*
*© 2026 SenaiVerse | Claude Code Agent System v1.2.0 | AI-Powered Mobile Development Excellence*