@ekkos/cli 0.2.0

package/templates/claude-plugins-admin/AGENT_TEAM_PROPOSALS.md

@@ -0,0 +1,819 @@
+# ekkOS Dev Team: Autonomous Agents
+
+**Building ekkOS with AI Team Members**
+
+Instead of hiring a full team, create autonomous agents that act like specialized team members, each handling their domain of the massive ekkOS project.
+
+---
+
+## Team Architecture
+
+```
+                    ┌─────────────────┐
+                    │   Tech Lead     │
+                    │  (Orchestrator) │
+                    └────────┬────────┘
+                             │
+          ┌──────────────────┼──────────────────┐
+          │                  │                  │
+    ┌─────▼─────┐     ┌─────▼─────┐     ┌─────▼─────┐
+    │ Frontend  │     │  Backend  │     │  DevOps   │
+    │   Agent   │     │   Agent   │     │   Agent   │
+    └─────┬─────┘     └─────┬─────┘     └─────┬─────┘
+          │                  │                  │
+    ┌─────▼─────┐     ┌─────▼─────┐     ┌─────▼─────┐
+    │    QA     │     │   Docs    │     │ Security  │
+    │   Agent   │     │   Agent   │     │   Agent   │
+    └───────────┘     └───────────┘     └───────────┘
+```
+
+---
+
+## 🎯 Tech Lead Agent (Orchestrator)
+
+**Role:** Project manager + architect who coordinates all other agents
+
+**Responsibilities:**
+- Assigns tasks to specialist agents
+- Tracks progress on features/bugs
+- Makes architectural decisions
+- Prioritizes work
+- Reviews PRs before merge
+- Coordinates releases
+
+**Triggers:**
+- `/lead plan` - Plan a new feature
+- `/lead assign` - Assign work to specialist agents
+- `/lead review` - Review all pending work
+- `/lead release` - Coordinate a release
+
+**Tools Used:**
+- `ekkOS_Plan` - Create feature implementation plans
+- `ekkOS_Plans` - Track all ongoing work
+- `ekkOS_Search` - Find relevant patterns
+- `ekkOS_Codebase` - Understand current code
+- `GitHub API` - PR management
+- `Bash(git)` - Repository operations
+
+**Example:**
+```bash
+/lead plan "Add Teams feature to platform"
+
+🎯 Tech Lead Agent: Planning Feature
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Feature: Teams functionality
+Complexity: High (8-10 days)
+
+Breaking down into tasks...
+
+Tasks Created:
+  1. Backend Agent: Design teams database schema
+  2. Backend Agent: Build teams API endpoints
+  3. Frontend Agent: Create Teams UI components
+  4. Frontend Agent: Integrate teams in dashboard
+  5. QA Agent: Write integration tests
+  6. Docs Agent: Document Teams feature
+  7. Security Agent: Audit permissions system
+
+Plan saved: plan_teams_abc123
+
+Assigning to agents...
+  ✅ Backend Agent: Tasks 1-2 assigned
+  ✅ Frontend Agent: Tasks 3-4 assigned
+  ✅ QA Agent: Task 5 pending (after backend)
+  ✅ Docs Agent: Task 6 pending (after MVP)
+  ✅ Security Agent: Task 7 in parallel
+
+Estimated completion: 8 days
+Next check-in: Daily standup via /lead status
+```
+
+**Value:**
+- You don't need to break down features yourself
+- Agents work in parallel on different parts
+- Automatic dependency management
+- Progress tracking built-in
+
+---
+
+## 🎨 Frontend Agent
+
+**Role:** React/Next.js developer who builds UI
+
+**Responsibilities:**
+- Build new UI components
+- Update existing pages
+- Implement designs
+- Handle Tailwind styling
+- Optimize performance
+- Fix frontend bugs
+
+**Triggers:**
+- `/frontend build` - Build new component/page
+- `/frontend fix` - Fix frontend bug
+- `/frontend optimize` - Performance optimization
+- `/frontend review` - Review frontend code
+
+**Tools Used:**
+- `ekkOS_Search` - Find UI patterns
+- `ekkOS_Codebase` - Understand component structure
+- `Read/Edit/Write` - Code manipulation
+- `Bash(npm)` - Run dev server, tests
+- `Glob` - Find components
+
+**Example:**
+```bash
+/frontend build "Teams settings page"
+
+🎨 Frontend Agent: Building Component
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Task: Teams settings page
+Location: apps/web/app/teams/settings/page.tsx
+
+Searching for patterns...
+  ✅ Found: "Settings page layout" (95% success)
+  ✅ Found: "Form with Tailwind" (92% success)
+
+Analyzing existing code...
+  📂 apps/web/app/settings/page.tsx (reference)
+  📂 components/SettingsLayout.tsx (reusable)
+
+Building component...
+
+[████████████████████] 100%
+
+✅ Created: apps/web/app/teams/settings/page.tsx
+✅ Created: components/teams/TeamSettingsForm.tsx
+✅ Updated: types/teams.ts
+
+Code follows patterns:
+  • Uses SettingsLayout wrapper
+  • Tailwind for styling
+  • React Hook Form for state
+  • Proper TypeScript types
+
+Ready to test:
+  npm run dev
+  Navigate to: http://localhost:3000/teams/settings
+
+Next:
+  • Test the UI
+  • /frontend review (self-check)
+  • Assign to QA Agent for testing
+```
+
+**Value:**
+- Builds UI components automatically
+- Follows existing patterns
+- Consistent with codebase style
+- You just review, not write
+
+---
+
+## ⚙️ Backend Agent
+
+**Role:** API/database developer
+
+**Responsibilities:**
+- Design database schemas
+- Build API endpoints
+- Write business logic
+- Handle authentication
+- Optimize queries
+- Fix backend bugs
+
+**Triggers:**
+- `/backend api` - Create new API endpoint
+- `/backend schema` - Design database schema
+- `/backend fix` - Fix backend bug
+- `/backend optimize` - Optimize queries
+
+**Tools Used:**
+- `ekkOS_Search` - Find backend patterns
+- `ekkOS_IndexSchema` - Store schema designs
+- `supabase_*` - Database operations
+- `Read/Edit/Write` - Code manipulation
+- `Bash` - Run migrations
+
+**Example:**
+```bash
+/backend schema "Teams feature"
+
+⚙️ Backend Agent: Designing Schema
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Task: Teams database schema
+Context: Multi-user teams with roles
+
+Searching for patterns...
+  ✅ Found: "Multi-tenant schema design" (89% success)
+  ✅ Found: "Role-based permissions" (94% success)
+
+Proposed Schema:
+
+Table: teams
+  - id: uuid (PK)
+  - name: text
+  - owner_id: uuid (FK users.id)
+  - created_at: timestamp
+  - updated_at: timestamp
+
+Table: team_members
+  - id: uuid (PK)
+  - team_id: uuid (FK teams.id)
+  - user_id: uuid (FK users.id)
+  - role: enum(owner, admin, member)
+  - joined_at: timestamp
+
+Table: team_invites
+  - id: uuid (PK)
+  - team_id: uuid (FK teams.id)
+  - email: text
+  - role: enum(admin, member)
+  - token: text (unique)
+  - expires_at: timestamp
+
+Indexes:
+  - team_members(team_id, user_id) UNIQUE
+  - team_invites(token) UNIQUE
+  - team_invites(email, team_id) UNIQUE
+
+RLS Policies:
+  - teams: Users see only their teams
+  - team_members: Users see members of their teams
+  - team_invites: Only team admins can manage
+
+Migration created: supabase/migrations/20260107_create_teams.sql
+
+Ready to apply:
+  supabase db push
+
+Next:
+  • Review schema
+  • Apply migration
+  • /backend api "Teams CRUD endpoints"
+```
+
+**Value:**
+- Designs schemas based on best practices
+- Considers security (RLS)
+- Creates migrations automatically
+- You review, not design from scratch
+
+---
+
+## 🧪 QA Agent (Quality Assurance)
+
+**Role:** Tester who ensures quality
+
+**Responsibilities:**
+- Write integration tests
+- Run test suites
+- Catch bugs before production
+- Validate edge cases
+- Performance testing
+- Generate test reports
+
+**Triggers:**
+- `/qa test` - Run test suite
+- `/qa write` - Write tests for feature
+- `/qa regression` - Regression testing
+- `/qa performance` - Performance testing
+
+**Tools Used:**
+- `Bash(npm test)` - Run tests
+- `Read/Edit/Write` - Write test files
+- `ekkOS_Search` - Find test patterns
+- `ekkOS_Forge` - Capture test patterns
+
+**Example:**
+```bash
+/qa write "Teams API endpoints"
+
+🧪 QA Agent: Writing Tests
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Target: Teams API endpoints
+Location: apps/web/tests/api/teams.test.ts
+
+Analyzing API...
+  Endpoints found:
+    - POST /api/teams (create)
+    - GET /api/teams (list)
+    - GET /api/teams/[id] (get)
+    - PATCH /api/teams/[id] (update)
+    - DELETE /api/teams/[id] (delete)
+    - POST /api/teams/[id]/members (add member)
+    - DELETE /api/teams/[id]/members/[userId] (remove)
+
+Writing tests...
+
+[████████████████████] 100%
+
+✅ Created: tests/api/teams.test.ts (247 lines)
+
+Test Coverage:
+  ✅ Happy paths (create, read, update, delete)
+  ✅ Edge cases (empty name, duplicate team)
+  ✅ Auth checks (unauthenticated, unauthorized)
+  ✅ Permissions (only owner can delete)
+  ✅ Validation (invalid IDs, missing fields)
+
+Total: 28 test cases
+
+Running tests...
+
+PASS  tests/api/teams.test.ts
+  Teams API
+    ✓ creates team successfully (234ms)
+    ✓ requires authentication (45ms)
+    ✓ validates team name (67ms)
+    ... 25 more tests ...
+
+Test Suites: 1 passed, 1 total
+Tests:       28 passed, 28 total
+
+✅ All tests passing!
+
+Coverage: 94% (target: 90%+)
+```
+
+**Value:**
+- Tests written automatically
+- Comprehensive coverage
+- Catches bugs before you ship
+- Regression testing built-in
+
+---
+
+## 📝 Docs Agent (Technical Writer)
+
+**Role:** Documentation writer
+
+**Responsibilities:**
+- Write API documentation
+- Update user guides
+- Create internal docs
+- Document patterns
+- Keep docs in sync with code
+- Write READMEs
+
+**Triggers:**
+- `/docs api` - Document API endpoints
+- `/docs guide` - Write user guide
+- `/docs update` - Update existing docs
+- `/docs review` - Review all docs
+
+**Tools Used:**
+- `Read` - Understand code
+- `Write/Edit` - Update docs
+- `ekkOS_Search` - Find doc patterns
+- `Glob` - Find existing docs
+
+**Example:**
+```bash
+/docs api "Teams endpoints"
+
+📝 Docs Agent: Writing API Documentation
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Target: Teams API endpoints
+Output: apps/docs/content/api/teams.mdx
+
+Analyzing API code...
+  Found: apps/web/app/api/teams/route.ts
+  Endpoints: 7 total
+
+Extracting:
+  • Request/response types
+  • Authentication requirements
+  • Example requests
+  • Error codes
+
+Writing documentation...
+
+✅ Created: apps/docs/content/api/teams.mdx
+
+Preview:
+
+# Teams API
+
+Manage teams and team memberships.
+
+## Create Team
+
+`POST /api/teams`
+
+Create a new team.
+
+**Authentication:** Required
+
+**Request Body:**
+```typescript
+{
+  name: string  // Team name (3-50 chars)
+}
+```
+
+**Response (201):**
+```typescript
+{
+  id: string
+  name: string
+  owner_id: string
+  created_at: string
+}
+```
+
+**Errors:**
+- 400: Invalid team name
+- 401: Unauthorized
+- 409: Team name already exists
+
+[... 6 more endpoints documented ...]
+
+Documentation complete!
+View: http://localhost:3000/docs/api/teams
+```
+
+**Value:**
+- Docs stay in sync with code
+- API docs generated automatically
+- Consistent documentation style
+- You don't have to write docs manually
+
+---
+
+## 🔒 Security Agent
+
+**Role:** Security engineer
+
+**Responsibilities:**
+- Audit code for vulnerabilities
+- Check authentication/authorization
+- Scan dependencies
+- Review RLS policies
+- Test for OWASP Top 10
+- Generate security reports
+
+**Triggers:**
+- `/security audit` - Full security audit
+- `/security rls` - Check RLS policies
+- `/security deps` - Scan dependencies
+- `/security review` - Review PR for security
+
+**Tools Used:**
+- `ekkOS_Search` - Security patterns
+- `Bash(npm audit)` - Dependency scanning
+- `supabase_execute_sql` - Check RLS
+- `Read` - Code analysis
+
+**Example:**
+```bash
+/security audit "Teams feature"
+
+🔒 Security Agent: Security Audit
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Target: Teams feature (all files)
+Scope: Full security review
+
+Scanning...
+
+───────────────────────────────────────────────────────────────────
+✅ Authentication
+
+✓ All API endpoints require authentication
+✓ Tokens validated correctly
+✓ Session management secure
+
+───────────────────────────────────────────────────────────────────
+⚠️  Authorization
+
+✓ Team creation restricted to authenticated users
+⚠️ ISSUE: Missing permission check in PATCH /api/teams/[id]
+  Location: apps/web/app/api/teams/[id]/route.ts:45
+  Risk: Medium
+  Issue: Any team member can update team name, should be admin only
+
+  Fix: Add role check:
+  ```typescript
+  if (member.role !== 'admin' && member.role !== 'owner') {
+    return new Response('Forbidden', { status: 403 })
+  }
+  ```
+
+───────────────────────────────────────────────────────────────────
+✅ Input Validation
+
+✓ Team name validated (length, format)
+✓ User IDs validated (UUID format)
+✓ SQL injection prevented (parameterized queries)
+
+───────────────────────────────────────────────────────────────────
+✅ RLS Policies
+
+Checked 5 policies:
+  ✓ teams: SELECT (users see only their teams)
+  ✓ teams: INSERT (authenticated users can create)
+  ✓ teams: UPDATE (owners/admins only)
+  ✓ teams: DELETE (owners only)
+  ✓ team_members: SELECT (team members only)
+
+All policies secure ✅
+
+───────────────────────────────────────────────────────────────────
+✅ Dependencies
+
+Scanned package.json:
+  0 high vulnerabilities
+  0 moderate vulnerabilities
+  2 low vulnerabilities (non-critical)
+
+───────────────────────────────────────────────────────────────────
+📊 Security Score: 92/100 (Good)
+
+Issues Found: 1 medium
+Required Actions: Fix authorization check
+
+Recommendation: Fix issue before production deploy
+```
+
+**Value:**
+- Security issues caught early
+- Automated vulnerability scanning
+- Best practices enforced
+- Prevents security bugs
+
+---
+
+## 🚀 DevOps Agent
+
+**Role:** Infrastructure engineer
+
+**Responsibilities:**
+- Manage deployments
+- Monitor services
+- Optimize performance
+- Handle incidents
+- Manage secrets
+- Infrastructure as code
+
+**Triggers:**
+- `/devops deploy` - Deploy services
+- `/devops monitor` - Monitor infrastructure
+- `/devops incident` - Handle incident
+- `/devops optimize` - Performance optimization
+
+**Tools Used:**
+- All the tools from Deploy Guardian, Memory Monitor, MCP Manager
+- `Bash(vercel)` - Deployments
+- `Bash(railway)` - Worker management
+- `supabase_*` - Database operations
+
+**(We already designed this one above!)**
+
+---
+
+## 📊 Data Agent (Memory Engineer)
+
+**Role:** Data engineer specializing in memory system
+
+**Responsibilities:**
+- Optimize 11-layer memory
+- Tune vector searches
+- Manage pattern quality
+- Run brain workers
+- Data integrity
+- Performance tuning
+
+**Triggers:**
+- `/data optimize` - Optimize memory layers
+- `/data quality` - Check pattern quality
+- `/data migrate` - Run data migrations
+- `/data analyze` - Analyze memory usage
+
+**Tools Used:**
+- All the tools from Memory System Monitor
+- `ekkOS_Stats` - Memory metrics
+- Vector DB operations
+- Pattern management tools
+
+**(We already designed this one above!)**
+
+---
+
+## 🎯 Product Agent
+
+**Role:** Product manager
+
+**Responsibilities:**
+- Prioritize features
+- Track user feedback
+- Analyze usage metrics
+- Plan roadmap
+- Make product decisions
+- A/B testing
+
+**Triggers:**
+- `/product prioritize` - Prioritize backlog
+- `/product metrics` - Analyze usage data
+- `/product feedback` - Review user feedback
+- `/product roadmap` - Plan next quarter
+
+**Tools Used:**
+- `ekkOS_Search` - Find user feedback patterns
+- `ekkOS_Stats` - Usage statistics
+- Analytics APIs
+- User feedback tools
+
+**Example:**
+```bash
+/product prioritize
+
+🎯 Product Agent: Feature Prioritization
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Analyzing backlog...
+
+Features (23 total):
+  - Teams functionality
+  - Export memory data
+  - API rate limiting
+  - Dark mode
+  ... 19 more ...
+
+Analyzing each feature:
+  • User demand (from feedback)
+  • Business impact
+  • Engineering effort
+  • Dependencies
+
+───────────────────────────────────────────────────────────────────
+🏆 Top Priority (Do First)
+
+1. Teams Functionality
+   User Demand: 🔥🔥🔥🔥🔥 (89 requests)
+   Business Impact: $15K MRR potential
+   Effort: High (8-10 days)
+   ROI Score: 9.2/10
+   Reason: Most requested, unlocks Enterprise tier
+
+2. Export Memory Data
+   User Demand: 🔥🔥🔥🔥 (67 requests)
+   Business Impact: Retention +15%
+   Effort: Low (2-3 days)
+   ROI Score: 8.8/10
+   Reason: Quick win, high retention impact
+
+3. API Rate Limiting
+   User Demand: 🔥🔥🔥 (34 requests)
+   Business Impact: Reduce abuse, cost savings
+   Effort: Medium (4-5 days)
+   ROI Score: 7.9/10
+   Reason: Necessary for scaling
+
+───────────────────────────────────────────────────────────────────
+Recommended Q1 Roadmap:
+
+Week 1-2: Teams functionality
+Week 3: Export memory data
+Week 4-5: API rate limiting
+Week 6: Performance optimization
+Week 7-8: Mobile app MVP
+
+Assign to Tech Lead: /lead plan "Teams functionality"
+```
+
+**Value:**
+- Data-driven prioritization
+- You make product decisions based on data
+- ROI calculated automatically
+- Roadmap planning automated
+
+---
+
+## Summary: Your AI Dev Team
+
+| Agent | Role | Time Savings | Replaces |
+|-------|------|--------------|----------|
+| **Tech Lead** | Orchestrator | 80% planning | Project manager |
+| **Frontend** | UI Developer | 70% coding | React developer |
+| **Backend** | API Developer | 70% coding | Backend developer |
+| **QA** | Tester | 90% testing | QA engineer |
+| **Docs** | Writer | 95% docs | Technical writer |
+| **Security** | Security Engineer | 85% audits | Security specialist |
+| **DevOps** | Infrastructure | 80% ops | DevOps engineer |
+| **Data** | Memory Engineer | 75% optimization | Data engineer |
+| **Product** | Product Manager | 60% analysis | Product manager |
+
+**Total:** ~9 specialized team members automated
+
+---
+
+## Implementation Plan
+
+### Phase 1: Core Team (Weeks 1-2)
+1. Tech Lead Agent (orchestrator)
+2. Frontend Agent (most UI work)
+3. Backend Agent (most API work)
+
+**Impact:** 70% of development work automated
+
+### Phase 2: Quality & Ops (Weeks 3-4)
+4. QA Agent (testing)
+5. DevOps Agent (infrastructure)
+6. Security Agent (audits)
+
+**Impact:** +20% (90% total automated)
+
+### Phase 3: Polish & Product (Weeks 5-6)
+7. Docs Agent (documentation)
+8. Data Agent (memory optimization)
+9. Product Agent (prioritization)
+
+**Impact:** +10% (100% team automated!)
+
+---
+
+## Usage Example: Building Teams Feature
+
+```bash
+# 1. Product Agent analyzes and prioritizes
+/product prioritize
+→ "Teams" is #1 priority
+
+# 2. Tech Lead creates plan
+/lead plan "Add Teams feature"
+→ Breaks into 7 tasks across agents
+
+# 3. Backend Agent designs schema
+/backend schema "Teams"
+→ Creates migrations, RLS policies
+
+# 4. Backend Agent builds API
+/backend api "Teams CRUD"
+→ Creates all endpoints
+
+# 5. Frontend Agent builds UI
+/frontend build "Teams pages"
+→ Creates team dashboard, settings
+
+# 6. QA Agent writes tests
+/qa write "Teams feature"
+→ 28 test cases, 94% coverage
+
+# 7. Security Agent audits
+/security audit "Teams"
+→ Finds 1 issue, suggests fix
+
+# 8. Docs Agent documents
+/docs api "Teams endpoints"
+→ Full API docs generated
+
+# 9. DevOps Agent deploys
+/devops deploy "Teams feature"
+→ Safely deploys to production
+
+# 10. Product Agent tracks
+/product metrics "Teams adoption"
+→ Shows 23% of users created teams
+```
+
+**Total time:** 8 days → 2 days (with agents)
+**Your involvement:** Review & approve each step
+**Agents do:** 90% of the work
+
+---
+
+## Cost Analysis
+
+**Without agents:**
+- Senior React Dev: $150K/year
+- Senior Backend Dev: $160K/year
+- QA Engineer: $120K/year
+- DevOps Engineer: $170K/year
+- Technical Writer: $100K/year
+- Security Engineer: $180K/year
+- Product Manager: $140K/year
+- **Total: $1,020,000/year**
+
+**With agents:**
+- Claude Code + API costs: ~$500/month = $6,000/year
+- Your time saved: 80%+
+- **Savings: $1,014,000/year**
+
+**ROI:** 17,000% 🚀
+
+---
+
+## Next Steps
+
+1. **Start with Tech Lead Agent** - Get orchestration working
+2. **Add Frontend + Backend Agents** - Cover 70% of coding
+3. **Layer in QA + DevOps** - Ensure quality and reliability
+4. **Add remaining specialists** - Complete the team
+
+**You become the CEO, agents are your team.** 🎯