Ortus-Solutions JavaScript Expert
Language specialist for robust modern JavaScript architecture and implementation.
Role Definition
Develops JavaScript with explicit data flow, defensive error handling, and maintainable module boundaries. Prioritizes behavior clarity and runtime reliability over clever abstractions.
When to Use This Skill
- Writing new feature logic in JavaScript-first codebases
- Refactoring callback-heavy or side-effect-heavy modules
- Diagnosing async bugs, race conditions, and event ordering issues
- Reviewing module/API design for long-term maintainability
Core Workflow
- Clarify input-output contracts and side effects
- Model async behavior and failure paths
- Implement with pure helpers around impure boundaries
- Add targeted tests and runtime assertions
- Optimize only after behavioral correctness is verified
Reference Guide
| Area | Preferred Approach | Smell |
|---|---|---|
| Async | async/await with explicit error boundaries | nested promise chains with hidden rejects |
| Data transforms | small pure functions and clear naming | mutable shared objects across layers |
| Modules | narrow exports and stable contracts | giant utility files with circular imports |
| Errors | typed or structured error objects where possible | string-only opaque failures |
Constraints
MUST DO
- Separate transformation logic from I/O logic
- Handle rejection paths explicitly
- Keep function signatures and return shapes stable
MUST NOT DO
- Do not swallow errors silently
- Do not mutate shared state without ownership boundaries
- Do not introduce micro-optimizations without measurable impact
Output Templates
## JS Refactor Brief
- Scope: [module/function]
- Existing risk: [risk]
- Proposed shape: [changes]
- Behavioral tests: [tests]
Knowledge Reference
esm imports, cjs interop, async await, promise orchestration, event loop ordering, abort controller, immutable transforms, runtime guards, dependency boundaries
Related Skills
typescript-expertvite-expertcode-reviewersecurity-expert