Codex: نصائح Codex المتقدمة

# Alice handles three independent modules simultaneously

Task 1: Refactor src/auth/ module
Task 2: Add Swagger docs to src/api/
Task 3: Optimize src/utils/ performance

# Three tasks modify different directories — can run in parallel
# Estimated time savings: 60%

# Good practice
/add src/auth/login.ts          # Only add relevant files
/add src/types/auth.ts          # Add type definitions

# Bad practice
/add src/**/*.ts                # Too many files, wastes context

# AGENTS.md
## Project Structure
- src/auth/ - Authentication module
- src/api/ - API routes
- src/utils/ - Utility functions

## Conventions
- Use TypeScript strict mode
- All APIs need error handling

# Bob working on a large project
/status                    # View: context 75% used

# Optimize
/remove src/legacy/        # Remove irrelevant files
/compact                   # Compress history

# Still not enough
/new                       # Start new session
/add src/payments/         # Only add current task-related files

# Scenario: Codex runs tests and they fail
> Codex: Tests failed, 3 cases did not pass
> You: View details of failed cases, fix them one by one

# Scenario: Codex modified the wrong file
> Codex: Modified config.ts (should have modified constants.ts)
> You: Revert config.ts changes, modify constants.ts

# View changes
git diff

# Revert specific file
git checkout -- src/wrong-file.ts

# Revert all changes
git checkout -- .

# Go back to previous commit
git reset --hard HEAD~1

# First attempt
> "Migrate Express to Fastify"
  Result: Some routes not correctly converted

# Append correction
> "Check the /api/users route, the conversion syntax is wrong, refer to Fastify official docs"
  Result: Route fix completed

# Continue correcting
> "Middleware conversion also has issues, error handling needs Fastify's setNotFoundHandler"
  Result: Middleware fix completed

# Fix Bug Template
"Fix <Bug-description> in <file>.
Error message: <error-log>
Expected behavior: <correct-behavior>
Ensure <verify-command> passes."

# Add Feature Template
"Add <feature> to <module>.
Follow the code style of <existing-file>.
Include input validation and error handling.
Write unit tests."

# Refactor Template
"Refactor <old-impl> to <new-impl>.
Maintain the external interface.
Ensure all existing tests pass.
Add new tests covering the new implementation."

# One command: code fix → test → commit
codex --full-auto "Fix all lint errors, run tests, if passing then git commit -m 'fix: lint errors'"