en un clic
agents-md
AGENTS.md dosyaları oluşturma, monorepo yapılandırma ve agent instruction yönetimi rehberi.
Menu
AGENTS.md dosyaları oluşturma, monorepo yapılandırma ve agent instruction yönetimi rehberi.
Guide for conducting comprehensive accessibility audits of code to identify WCAG compliance issues and barriers to inclusive design. This skill should be used when reviewing accessibility, ARIA implementation, keyboard navigation, or screen reader compatibility.
Transform clarified user requests into structured delegation prompts optimized for specialist agents (cto-architect, strategic-cto-mentor, cv-ml-architect). Use after clarification is complete, before routing to specialist agents. Ensures agents receive complete context for effective work.
p5.js ile generative art, flow fields ve interactive visuals oluşturma rehberi.
API tasarımı, GraphQL schema, OpenAPI spec, versioning. ⚠️ Tasarım aşaması için kullan. Uygulama/security için → backend-api.
ADR template, database selection, capacity planning ve scalability.
Architecture patterns - monolith vs microservices, layered, event-driven, CQRS.
| name | agents_md |
| description | AGENTS.md dosyaları oluşturma, monorepo yapılandırma ve agent instruction yönetimi rehberi. |
Agent instruction ve conventions dosyaları oluşturma rehberi.
AGENTS.md, AI coding assistant'ların proje özelinde kurallara uymasını sağlayan convention dosyasıdır.
# AGENTS.md
Bu proje için AI assistant kuralları.
## Proje Genel Bakış
[Projenin kısa açıklaması]
## Tech Stack
- Framework: Next.js 15
- Language: TypeScript
- Styling: Tailwind CSS
- Database: PostgreSQL
## Dizin Yapısı
\`\`\`
src/
├── app/ # Next.js App Router pages
├── components/ # React components
├── lib/ # Utility functions
├── hooks/ # Custom React hooks
└── types/ # TypeScript types
\`\`\`
## Kod Conventions
### Naming
- Components: PascalCase (`UserProfile.tsx`)
- Hooks: camelCase with `use` prefix (`useAuth.ts`)
- Utils: camelCase (`formatDate.ts`)
### Imports
- Absolute imports: `@/components/...`
- Group order: React > External > Internal > Types
## Yasaklar
- ❌ `any` type kullanma
- ❌ `console.log` production'da
- ❌ Inline styles
## Tercih Edilenler
- ✅ Server Components (default)
- ✅ Zod validation
- ✅ Error boundaries
# Components Conventions
## Component Yapısı
\`\`\`tsx
// 1. Imports
// 2. Types
// 3. Component
// 4. Export
\`\`\`
## Props
- Interface ile tanımla
- `Props` suffix kullan
## Styling
- Tailwind class'ları kullan
- `cn()` utility ile merge
# API Conventions
## Endpoint Yapısı
- RESTful naming
- Versioning: `/api/v1/`
## Error Handling
- Consistent error response format
- HTTP status codes doğru kullan
## Feature: User Authentication
### Paths
- Entry: `src/app/(auth)/login/page.tsx`
- API: `src/app/api/auth/[...nextauth]/route.ts`
- Components: `src/components/auth/`
- Hooks: `src/hooks/useAuth.ts`
### Tests
- Unit: `__tests__/auth/`
- E2E: `e2e/auth.spec.ts`
### Docs
- `docs/auth.md`
# Monorepo AGENTS.md
## Packages
| Package | Path | Purpose |
|---------|------|---------|
| @acme/web | apps/web | Next.js frontend |
| @acme/api | apps/api | Express backend |
| @acme/ui | packages/ui | Shared components |
| @acme/utils | packages/utils | Shared utilities |
## Cross-Package Rules
- UI components: `@acme/ui` kullan
- Utils: `@acme/utils` kullan
- Duplicate code yasak
AGENTS.md v1.0 - Convention Over Configuration
Kaynak: AGENTS.md Best Practices
package.json, tsconfig.json, .eslintrc.src, app, lib)./AGENTS.md)any", "No console.log in prod", "No class components".AGENTS.md for src/components, src/api if complex.AGENTS.md when adding new tech or changing patterns.| Aşama | Doğrulama |
|---|---|
| 1 | Proje yapısı doğru anlaşılmış |
| 2 | Root dosya mevcut ve okunabilir |
| 3 | AI kuralları ihlal etmiyor (test et) |