Skip to content

Commit 3821869

Browse files
abdoutclaude
abdout
and
claude
committed
feat: add Claude Code team configuration
- 29 agents including product repos (hogwarts, souq, mkan, shifa) - 17 slash commands (/repos, /atom, /template, /block, etc.) - Memory files for atoms, templates, blocks, repositories - Install/sync scripts for macOS, Linux, Windows - MCP server configuration (28 servers) - Repository monitoring for upstream dependencies Team install: macOS/Linux: curl -fsSL https://raw.githubusercontent.com/databayt/codebase/main/.claude/scripts/install.sh | bash Windows: irm https://raw.githubusercontent.com/databayt/codebase/main/.claude/scripts/install.ps1 | iex Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent a26d39e commit 3821869

80 files changed

Lines changed: 17284 additions & 0 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.claude/CLAUDE.md‎

Lines changed: 467 additions & 0 deletions
Large diffs are not rendered by default.

‎.claude/agents/_index.md‎

Lines changed: 209 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,209 @@
1+
# Agent Registry
2+
3+
**Global agents for all projects** | **Location**: `~/.claude/agents/`
4+
5+
## Quick Stats
6+
7+
- **Total Agents**: 27
8+
- **Model**: opus (all agents)
9+
- **Stack**: Next.js 16 + React 19 + Prisma 6 + TypeScript 5
10+
11+
---
12+
13+
## Agent Categories
14+
15+
### Stack (7)
16+
17+
| Agent | Purpose | Version |
18+
|-------|---------|---------|
19+
| **nextjs** | App Router, Server Components, Server Actions | 16.0.7 |
20+
| **react** | Hooks, Suspense, Concurrent Features | 19.2.0 |
21+
| **typescript** | Strict Mode, Generics, Zod Validation | 5.x |
22+
| **tailwind** | Semantic Tokens, RTL/LTR, Responsive | 4.x |
23+
| **prisma** | Schema Design, Queries, Multi-tenant | 6.16.2 |
24+
| **shadcn** | Registry (82 Sources), MCP, Radix | latest |
25+
| **authjs** | NextAuth v5, OAuth, JWT, Sessions | 5.x |
26+
27+
### Design (4)
28+
29+
| Agent | Purpose | Handoff |
30+
|-------|---------|---------|
31+
| **orchestration** | Multi-agent coordination, complex tasks | all agents |
32+
| **architecture** | Mirror pattern, Prisma, multi-tenant design | pattern, structure |
33+
| **pattern** | Code conventions, anti-patterns, best practices | structure |
34+
| **structure** | File organization, naming, project layout | nextjs |
35+
36+
### UI (4)
37+
38+
| Agent | Purpose | Handoff |
39+
|-------|---------|---------|
40+
| **shadcn** | Registry, Radix primitives, MCP | atom |
41+
| **atom** | Composed components (2+ UI primitives) | template |
42+
| **template** | Page layouts (hero, sidebar, auth) | block |
43+
| **block** | Functional UI (DataTable, Forms, Wizards) | - |
44+
45+
### DevOps (3)
46+
47+
| Agent | Purpose | Handoff |
48+
|-------|---------|---------|
49+
| **build** | Turbopack, TypeScript validation, bundles | deploy |
50+
| **deploy** | Vercel, monitoring, rollback, staging | - |
51+
| **test** | Vitest, Playwright, 95% coverage target | - |
52+
53+
### VCS (2)
54+
55+
| Agent | Purpose | Handoff |
56+
|-------|---------|---------|
57+
| **git** | Branching, commits, conventional format | github |
58+
| **github** | PRs, Issues, Actions, MCP integration | - |
59+
60+
### Specialized (7)
61+
62+
| Agent | Purpose | Handoff |
63+
|-------|---------|---------|
64+
| **middleware** | Edge runtime, auth checks, i18n routing | nextjs |
65+
| **internationalization** | Arabic RTL, English LTR, dictionaries | - |
66+
| **semantic** | Semantic HTML, color tokens, accessibility | tailwind |
67+
| **sse** | Server-side exception diagnosis, debugging | nextjs, react |
68+
| **optimize** | Feature automation, integration, time savings | architecture, prisma |
69+
| **performance** | Core Web Vitals, profiling, runtime optimization | nextjs, react, prisma, build, tailwind |
70+
| **comment** | Code comments, WHY over WHAT, Clean Code | pattern, typescript |
71+
72+
---
73+
74+
## Handoff Protocol
75+
76+
When delegating to another agent:
77+
78+
1. **State the reason**: Why you are handing off
79+
2. **Provide context**: What you've done so far
80+
3. **Specify the task**: What the target agent should do
81+
4. **Return control**: Continue after delegation completes
82+
83+
### Example Handoff
84+
85+
```
86+
Handing off to `react` agent:
87+
- Reason: Need to optimize component re-renders
88+
- Context: Created server action for data fetching
89+
- Task: Implement useMemo and useCallback for list component
90+
```
91+
92+
---
93+
94+
## Inter-Agent Relationships
95+
96+
```
97+
orchestration (master coordinator)
98+
│
99+
├── Design Chain
100+
│ └── architecture → pattern → structure
101+
│
102+
├── Stack Chain
103+
│ └── nextjs → react → typescript
104+
│
105+
├── UI Chain
106+
│ └── shadcn → atom → template → block
107+
│
108+
├── DevOps Chain
109+
│ └── build → deploy
110+
│
111+
└── Standalone
112+
└── test, git → github
113+
114+
Cross-references:
115+
tailwind ↔ semantic ↔ shadcn
116+
middleware → nextjs → architecture
117+
sse → nextjs + react (debugging)
118+
prisma → architecture (schema design)
119+
authjs → middleware (auth flow)
120+
optimize → architecture + prisma (feature analysis)
121+
performance → nextjs + react + prisma + build (runtime optimization)
122+
```
123+
124+
---
125+
126+
## Technology Versions
127+
128+
Keep agents updated with latest stable versions:
129+
130+
| Technology | Current | Check Command |
131+
|------------|---------|---------------|
132+
| Next.js | 16.0.7 | `npm view next version` |
133+
| React | 19.2.0 | `npm view react version` |
134+
| TypeScript | 5.8.x | `npm view typescript version` |
135+
| Tailwind | 4.1.x | `npm view tailwindcss version` |
136+
| Prisma | 6.16.2 | `npm view prisma version` |
137+
| Zod | 3.25.x | `npm view zod version` |
138+
| NextAuth | 5.x | `npm view next-auth version` |
139+
140+
---
141+
142+
## Reference Codebase
143+
144+
All agents reference production patterns from:
145+
146+
- **Local**: `/Users/abdout/codebase`
147+
- **GitHub**: `databayt/codebase`
148+
- **Registry**: 82 shadcn registries via MCP
149+
150+
---
151+
152+
## Self-Improvement Triggers
153+
154+
Agents should suggest updates when:
155+
156+
1. New major version released
157+
2. Breaking changes in dependencies
158+
3. New patterns emerge in official docs
159+
4. Anti-patterns discovered in practice
160+
161+
---
162+
163+
## Usage
164+
165+
### In Prompts
166+
167+
```
168+
Use the nextjs agent to create a new page with server actions.
169+
Use the architecture agent to design the multi-tenant data model.
170+
Use the build agent to fix TypeScript errors.
171+
```
172+
173+
### Task Delegation
174+
175+
```
176+
@orchestration: Coordinate this complex feature
177+
@architecture: Design the data model
178+
@shadcn: Add required UI components
179+
@build: Validate and build the feature
180+
@deploy: Ship to production
181+
```
182+
183+
### Quick Reference
184+
185+
| Need | Use Agent |
186+
|------|-----------|
187+
| New page/route | nextjs |
188+
| Component optimization | react |
189+
| Type errors | typescript |
190+
| Styling/tokens | tailwind |
191+
| Database schema | prisma |
192+
| UI components | shadcn |
193+
| Authentication | authjs |
194+
| System design | architecture |
195+
| File organization | structure |
196+
| Code review | pattern |
197+
| Build issues | build |
198+
| Deployment | deploy |
199+
| Testing | test |
200+
| Git workflow | git, github |
201+
| i18n/RTL | internationalization |
202+
| Server errors | sse |
203+
| Feature optimization | optimize |
204+
| Runtime performance | performance |
205+
| Code comments | comment |
206+
207+
---
208+
209+
**Rule**: Use specialized agents. Follow handoff chains. Keep versions current.

0 commit comments

Comments
 (0)