agents-md

name	agents_md
description	AGENTS.md dosyaları oluşturma, monorepo yapılandırma ve agent instruction yönetimi rehberi.

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