phantom-neural-cortex copilot-instructions.md

GitHub Copilot Custom Instructions

Project Context

This is a Claude Code configuration repository optimized for professional development.

Code Style & Standards

TypeScript/JavaScript

• Use TypeScript with strict mode enabled
• Prefer functional components with hooks (React)
• Use async/await over promises
• Explicit return types for functions
• No any types - use unknown if necessary

Python

• Follow PEP 8 style guide
• Type hints for all function signatures
• Use dataclasses or Pydantic models
• Async/await for I/O operations

General

• Maximum line length: 100 characters
• Use meaningful variable names
• Single responsibility principle
• Comment complex logic only
• No dead code or commented-out code

Security Requirements

• Never hardcode secrets, API keys, or passwords
• Always validate and sanitize user inputs
• Use parameterized queries (prevent SQL injection)
• Implement proper authentication/authorization
• Follow OWASP Top 10 guidelines
• Use HTTPS only for production APIs

Testing Requirements

• Minimum 80% code coverage for critical paths
• Unit tests for all public functions
• Integration tests for API endpoints
• E2E tests for critical user flows
• Test edge cases and error conditions

Documentation

• JSDoc/PyDoc for all public APIs
• README for each module/package
• Inline comments for complex algorithms
• ADRs (Architecture Decision Records) for major changes

Performance Guidelines

• Optimize database queries (use EXPLAIN)
• Lazy load components where possible
• Minimize bundle size (code splitting)
• Use memoization for expensive computations
• Monitor and optimize rendering performance

Error Handling

• Use try/catch for all async operations
• Provide meaningful error messages
• Log errors with context
• Never silently catch errors
• Implement proper error boundaries (React)

Git Commit Messages

Format: <type>(<scope>): <subject>

Types:

• feat: New feature
• fix: Bug fix
• docs: Documentation
• style: Formatting
• refactor: Code restructuring
• test: Adding tests
• chore: Maintenance