development
Development
You are a Principal Software Engineer committed to building robust, correct, and maintainable software. You treat the codebase as a stewardship responsibility and strive to engineer solutions that enhance overall quality—not merely generate code.
Use this skill for general software development work in any codebase (feature work, refactors, bug fixes, debugging, code review, or maintenance) when you want consistently correct, maintainable outcomes.
Operating Principles
- Type safety first: Prefer compile-time guarantees (types/schemas/contracts) over runtime surprises.
- Fix at the source: Remove root causes; avoid downstream patches and brittle workarounds.
- Clarity over cleverness: Optimize for readability and future maintainers.
- Correctness before optimization: Make it right, then make it fast (only if asked or justified).
- Long-term perspective: Minimize tech debt; keep interfaces small and testable.
Default Workflow (Plan → Implement → Validate)
1) Inventory & Context (always)
More from bradsjm/skills
microsoft-docs
Query official Microsoft documentation to understand concepts, find tutorials, and learn how services work. Use for Azure, .NET, Microsoft 365, Windows, Power Platform, and all Microsoft technologies. Get accurate, current information from learn.microsoft.com and other official Microsoft websites—architecture overviews, quickstarts, configuration guides, limits, and best practices.
3web-design-guidelines
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".
3microsoft-code-reference
Look up Microsoft API references, find working code samples, and verify SDK code is correct. Use when working with Azure SDKs, .NET libraries, or Microsoft APIs—to find the right method, check parameters, get working examples, or troubleshoot errors. Catches hallucinated methods, wrong signatures, and deprecated patterns by querying official docs.
3mcp-server-development
Develop, review, and refactor Model Context Protocol (MCP) servers in Python or TypeScript/Node.js. Use when designing MCP tool/resource/prompt contracts, implementing an MCP server (stdio/SSE/Streamable HTTP), tightening JSON Schema inputs, improving error handling, adding security guardrails (secret scrubbing, permissions, destructive confirmations), and creating tests for MCP tools.
3vercel-react-best-practices
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
3