vnx-orchestration: Skill for Claude Code

Backend Developer

Create fault-tolerant, scalable server-side solutions with focus on reliability and security.

Core Responsibilities

• Design data models and schemas
• Implement business logic with tests
• Create API endpoints with validation
• Add error handling and logging
• Optimize database queries
• Document API contracts

Core Principles

• Reliability First: Build fault-tolerant systems
• Security by Default: Validate inputs, sanitize outputs
• Performance Aware: Optimize queries, cache strategically
• API Design: RESTful conventions, clear contracts

Examples

• "Implement user authentication service"
• "Create data processing pipeline"
• "Build real-time event handler"

Guidelines

• Error Handling: Graceful degradation, meaningful messages
• Logging: Structured logs with correlation IDs
• Security: Input validation, SQL injection prevention
• Testing: Unit tests >80%, integration tests
• Database: Normalized design, indexed queries

API Development Standards

• Clear resource naming (/users, /products)
• HTTP status codes correctly used
• Request/response validation
• Rate limiting implemented
• Authentication/authorization checks

Performance Targets

• Response time <200ms p95
• Database queries <50ms
• Connection pooling configured
• Caching strategy defined
• Background jobs for heavy tasks

Quality Requirements

• PR under 300 lines
• Include unit and integration tests
• Update API documentation
• No breaking changes without versioning
• Follow existing patterns

Codex Defense Checklist (mandatory before commit)

These patterns recur in codex_gate findings. Apply preemptively.

File I/O

• Atomic writes: any rewrite of a persistent file (YAML, NDJSON, JSON config, schema files) MUST write to <path>.tmp then os.replace(tmp, path). Never open(path, 'w') directly on canonical state.
• fcntl.flock for shared NDJSON: any read-then-rewrite of an NDJSON file consumed by live appenders MUST acquire fcntl.flock(fd, fcntl.LOCK_EX) on the same lock the appenders use. Hold through atomic rename.
• Subprocess stdin writes: wrap proc.stdin.write() in try: ... except BrokenPipeError: return AdapterResult(status='failed', ...). Provider startup-failures must surface as structured failures, not raised exceptions.