Codex: قواعد Codex و Hooks

# AGENTS.md

## Project Overview
Project Name: E-Commerce API
Tech Stack: FastAPI + PostgreSQL + Redis
Code Standards: PEP 8 + Black formatter

## Code Rules
- All functions must have type annotations
- All API endpoints must have input validation
- Use dependency injection
- Use custom exception classes for error handling

## File Structure
- src/api/ - API routes
- src/models/ - Data models
- src/services/ - Business logic
- src/tests/ - Test files

## Prohibited Operations
- Do not modify .env files
- Do not delete existing tests
- Do not install new dependencies (requires human confirmation)
- Do not modify existing migrations in database/migrations/

# AGENTS.md

## Project Overview
Next.js 14 e-commerce site, using App Router + TypeScript + Prisma

## Code Rules
- Components use functional components + TypeScript
- Use server actions instead of API routes
- Data fetching uses RSC (React Server Components)
- Styling uses Tailwind CSS
- Forms use React Hook Form + Zod validation

## Directory Conventions
- app/ - Pages and routes
- components/ - Reusable components
- lib/ - Utility functions and configuration
- types/ - TypeScript type definitions

## Prohibited Operations
- Do not use 'use client' unless necessary
- Do not install new UI libraries (use existing shadcn/ui)
- Do not modify existing models in prisma/schema.prisma (only add new ones)
- Do not modify middleware.ts

# .codex/config.toml

[hooks]
# Auto-run tests after task completion
post-task = "npm test"

# Auto-format before commit
pre-commit = "npm run format && npm run lint"

# Send notification on error
on-error = "curl -X POST https://hooks.slack.com/xxx -d 'Codex error'"

# .codex/hooks/post-task.sh
#!/bin/bash

# Run tests
npm test
if [ $? -ne 0 ]; then
  echo "Tests failed! Fixing..."
  codex --full-auto "Fix all failing tests"
fi

# Format code
npm run format

# Check lint
npm run lint

# Bob's hook configuration
[hooks]
post-task = "bash .codex/hooks/post-task.sh"

# .codex/hooks/post-task.sh
#!/bin/bash
npm test                    # Run tests
npm run lint -- --fix       # Fix lint
npm run format              # Format
echo "Hook: post-task completed"

project/
├── AGENTS.md              # Global rules
├── src/
│   ├── AGENTS.md          # src directory rules
│   ├── api/
│   │   └── AGENTS.md      # API module rules
│   └── auth/
│       └── AGENTS.md      # Auth module rules

Subdirectory AGENTS.md > Parent directory AGENTS.md > Root AGENTS.md

<!-- src/api/AGENTS.md -->
# API Module Rules
- All endpoints must have Swagger documentation
- Use Pydantic for request/response validation
- Return standard response format: { data: ..., error: ... }

AGENTS.md subdirectory > AGENTS.md root > Skills > Config files > Default behavior