Agent Skills: 🤖 AGENTS.md

🤖 AGENTS.md

Agent instruction ve conventions dosyaları oluşturma rehberi.

📋 AGENTS.md Nedir?

AGENTS.md, AI coding assistant'ların proje özelinde kurallara uymasını sağlayan convention dosyasıdır.

Kullanım Alanları

• Proje spesifik kurallar
• Kod stili conventions
• Dizin yapısı açıklamaları
• Yasaklı pattern'ler
• Önerilen yaklaşımlar

📁 Root AGENTS.md Template

# 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

📂 Nested AGENTS.md (Modül Bazlı)

src/components/AGENTS.md

# 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

src/api/AGENTS.md

# API Conventions

## Endpoint Yapısı
- RESTful naming
- Versioning: `/api/v1/`

## Error Handling
- Consistent error response format
- HTTP status codes doğru kullan

🗺️ Feature Map

## 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 Yapısı

# 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

🔄 Workflow

Kaynak: AGENTS.md Best Practices

Aşama 1: Context Extraction

• [ ] Read Project Config: package.json, tsconfig.json, .eslintrc.
• [ ] Map Directory Structure: Identify key folders (src, app, lib).
• [ ] Identify Unwritten Rules: Look at existing code for naming patterns (PascalCase vs camelCase).

Aşama 2: Root Creation (/AGENTS.md)

• [ ] Project Overview: One sentence goal description.
• [ ] Tech Stack: List core frameworks and libraries.
• [ ] Architecture: High-level map of the system.
• [ ] Conventions: Explicit naming and coding rules.

Aşama 3: Rule Definitions

• [ ] Must Haves: "Always use TypeScript strict mode", "Always use Zod".
• [ ] Must Nots: "No any", "No console.log in prod", "No class components".
• [ ] Preferred: "Prefer functional components", "Prefer arrow functions".

Aşama 4: Nested & Maintenance

• [ ] Sub-modules: Create specific AGENTS.md for src/components, src/api if complex.
• [ ] Sync: Update AGENTS.md when adding new tech or changing patterns.

Kontrol Noktaları

| 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) |