agents_md
AGENTS.md dosyaları oluşturma, monorepo yapılandırma ve agent instruction yönetimi rehberi.
>_
Quick Installnpxskills add vuralserhat86/antigravity-agentic-skills--skill agents_mdInstructions
Loading…
AGENTS.md dosyaları oluşturma, monorepo yapılandırma ve agent instruction yönetimi rehberi.
npxskills add vuralserhat86/antigravity-agentic-skills--skill agents_mdLoading…
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) |
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).