do-work_skill

Overview

This skill provides an end-to-end implementation workflow for TypeScript projects, guiding you from exploration through validation and commit. It ensures changes are fully vetted with type checks and tests before committing. Use it to implement features, fix bugs, or make codebase changes with repeatable safety checks.

How this skill works

The workflow runs sequential validation phases: plan the change, implement code, and run automated checks. It enforces type checking (npm run typecheck) and unit/integration tests (npm test), requiring each check to pass before proceeding. Failures must be fixed and re-run until all checks are clean, then commit the validated changes.

When to use it

• Adding a new feature in a TypeScript codebase.
• Fixing bugs that require code changes and validation.
• Refactoring code that must preserve type safety and test coverage.
• Preparing a change for a pull request or release.

Best practices

• Plan the change and outline required code and tests before editing files.
• Run type checks locally (npm run typecheck) frequently during implementation.
• Write or update tests before finalizing implementation, then run npm test.
• Fix failing checks immediately; do not proceed with known failing type checks or tests.
• Keep commits focused and descriptive after all validations pass.

Example use cases

• Implementing a new API endpoint with request/response types and unit tests.
• Refactoring a module to improve maintainability while preserving existing behavior and tests.
• Fixing a customer-reported bug, verifying fix with targeted tests and type checks.
• Adding typing to previously untyped code and validating with the test suite.