# Software Craft — MDRSS feed

> Languages, architecture, testing and the daily developer toolkit. Page 1 of 4; 179 matching cards.
> Canonical feed: https://mdrss.com/s/software-craft

## Cards (50)

### [mattpocock/skills / .agents/adr/0002-ship-as-a-claude-code-plugin.md — Architecture decision record explaining why the collection ships as a](https://mdrss.com/software-craft/developer-tooling/901534/901534.md)

Architecture decision record explaining why the collection ships as a Claude Code plugin and why no Codex plugin exists yet. Useful context for anyone packaging their own skills for more than one harness.

Classification: software-craft/developer-tooling · Feed: software-craft · Updated: 2026-08-07T09:27:01.749Z · Version: 1

### [mattpocock/skills / .agents/adr/0001-explicit-setup-pointer-only-for-hard-dependencies.md — Architecture decision record: a skill may point](https://mdrss.com/software-craft/developer-tooling/901533/901533.md)

Architecture decision record: a skill may point at a setup step only when it is a hard dependency, not as general advice. Documents the reasoning and the consequences for how skills reference each other.

Classification: software-craft/developer-tooling · Feed: software-craft · Updated: 2026-08-07T09:26:55.995Z · Version: 1

### [mattpocock/skills / .agents/install-block.md — The canonical install instructions, copied verbatim wherever installation is documented so th](https://mdrss.com/software-craft/developer-tooling/901532/901532.md)

The canonical install instructions, copied verbatim wherever installation is documented so the steps never drift between README and docs. Covers the Claude Code plugin route and the marketplace fallback.

Classification: software-craft/developer-tooling · Feed: software-craft · Updated: 2026-08-07T09:26:50.138Z · Version: 1

### [mattpocock/skills / .agents/writing-docs.md — Template and procedure for the human-facing docs page every promoted skill carries](https://mdrss.com/software-craft/developer-tooling/901531/901531.md)

Template and procedure for the human-facing docs page every promoted skill carries. Fixes the four required sections — what it does, when to reach for it, common questions, it's working if — plus section order and where to source the questions.

Classification: software-craft/developer-tooling · Feed: software-craft · Updated: 2026-08-07T09:26:44.465Z · Version: 1

### [mattpocock/skills / .agents/invocation.md — Defines the two invocation modes every SKILL](https://mdrss.com/software-craft/developer-tooling/901530/901530.md)

Defines the two invocation modes every SKILL.md must declare: user-invoked, reachable only by a human via slash command, or model-invoked, which the agent may trigger on its own. Explains the frontmatter and the openai.yaml policy flags that enforce each.

Classification: software-craft/developer-tooling · Feed: software-craft · Updated: 2026-08-07T09:26:38.695Z · Version: 1

### [mattpocock/skills / skills/engineering/ask-matt/SKILL.md — The router skill: maps every user-reachable skill and how they relate, so an agen](https://mdrss.com/software-craft/developer-tooling/901529/901529.md)

The router skill: maps every user-reachable skill and how they relate, so an agent can pick the right one instead of guessing. Kept in sync whenever a skill is added, renamed or removed, on the principle that a router which lies is worse than none.

Classification: software-craft/developer-tooling · Feed: software-craft · Updated: 2026-08-07T09:26:33.000Z · Version: 1

### [mattpocock/skills / CONTEXT.md — Shared domain vocabulary for the repository](https://mdrss.com/software-craft/developer-tooling/901528/901528.md)

Shared domain vocabulary for the repository. Defines Issue tracker, Issue, Decision ticket and Triage role, lists the terms to avoid, maps how the entities relate and records resolved ambiguities, so agent and human use one language instead of drifting synonyms.

Classification: software-craft/developer-tooling · Feed: software-craft · Updated: 2026-08-07T09:26:27.315Z · Version: 1

### [mattpocock/skills / CLAUDE.md — The repository contract, auto-loaded by Claude Code and reachable as AGENTS](https://mdrss.com/software-craft/developer-tooling/901527/901527.md)

The repository contract, auto-loaded by Claude Code and reachable as AGENTS.md through a symlink so Codex-style agents read the same file. Defines the five skill buckets, the promotion rules that keep README, plugin manifest and docs in sync, and the invocation model.

Classification: software-craft/developer-tooling · Feed: software-craft · Updated: 2026-08-07T09:26:21.549Z · Version: 1

### [mattpocock/skills / skills/productivity/README.md — Index of the productivity bucket: seven skills for non-code workflow, each linked to its](https://mdrss.com/software-craft/developer-tooling/901526/901526.md)

Index of the productivity bucket: seven skills for non-code workflow, each linked to its SKILL.md. Covers grill-me, grilling, handoff, teach, to-questionnaire, wait-what and writing-for-agents.

Classification: software-craft/developer-tooling · Feed: software-craft · Updated: 2026-08-07T09:26:15.800Z · Version: 1

### [mattpocock/skills / skills/engineering/README.md — Index of the engineering bucket: eighteen skills for daily code work, each with a one-lin](https://mdrss.com/software-craft/developer-tooling/901525/901525.md)

Index of the engineering bucket: eighteen skills for daily code work, each with a one-line description linked to its SKILL.md. Includes tdd, code-review, diagnosing-bugs, codebase-design, domain-modeling, implement, research, triage and wayfinder.

Classification: software-craft/developer-tooling · Feed: software-craft · Updated: 2026-08-07T09:26:09.054Z · Version: 1

### [mattpocock/skills / CHANGELOG.md — Full release history of the skills collection, maintained with changesets](https://mdrss.com/software-craft/developer-tooling/901524/901524.md)

Full release history of the skills collection, maintained with changesets. Records every skill added, renamed, promoted between buckets or deprecated, which is the fastest way to see how the set has evolved and what is currently moving.

Classification: software-craft/developer-tooling · Feed: software-craft · Updated: 2026-08-07T09:26:03.304Z · Version: 1

### [mattpocock/skills / README.md — Front door of the pack: what these skills are, how to install them into Claude Code or another harness, and](https://mdrss.com/software-craft/developer-tooling/901523/901523.md)

Front door of the pack: what these skills are, how to install them into Claude Code or another harness, and a linked index of all promoted skills split into user-invoked and model-invoked. Start here to see what the collection actually contains.

Classification: software-craft/developer-tooling · Feed: software-craft · Updated: 2026-08-07T09:25:57.407Z · Version: 1

### [mattpocock/skills: the .md map — 35 agent skills, humans and agents separated](https://mdrss.com/software-craft/developer-tooling/901522/901522.md)

Navigation across mattpocock/skills with measured metrics: 101 markdown files out of 151, 88% of the repo by bytes, 35 SKILL.md across five buckets. Covers the promotion contract, the user-invoked vs model-invoked split, the AGENTS.md symlink trick and a single MIT license zone.

Classification: software-craft/developer-tooling · Feed: software-craft · Updated: 2026-08-07T09:25:51.571Z · Version: 1

### [GitHub Issue Resolution Expert](https://mdrss.com/software-craft/api-backend-and-databases/901454/901454.md)

A curated reference on api, backend & databases centered on GitHub Issue Resolution Expert. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/api-backend-and-databases · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [TDD Cycle Orchestrator](https://mdrss.com/software-craft/testing-and-documentation/901453/901453.md)

You MUST follow these rules exactly. Violating any of them is a failure. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/testing-and-documentation · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [UV Package Manager — Advanced Reference](https://mdrss.com/software-craft/programming-and-runtime/901410/901410.md)

Advanced workflows including Docker integration, lockfile management, performance optimization, tool comparison, common workflows, tool integration, troubleshooting, best practices, migration guides, and command reference. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [UV Package Manager](https://mdrss.com/software-craft/programming-and-runtime/901409/901409.md)

Comprehensive guide to using uv, an extremely fast Python package installer and resolver written in Rust, for modern Python project management and dependency workflows. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [python-testing-patterns — detailed patterns and worked examples](https://mdrss.com/software-craft/programming-and-runtime/901408/901408.md)

For advanced patterns including async testing, monkeypatching, temporary files, conftest setup, property-based testing, database testing, CI/CD integration, and configuration files, see references/advanced-patterns.md. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Python Testing Patterns — Advanced Reference](https://mdrss.com/software-craft/programming-and-runtime/901407/901407.md)

Advanced testing patterns including async code, monkeypatching, temporary files, conftest setup, property-based testing, database testing, CI/CD integration, and configuration. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Python Testing Patterns](https://mdrss.com/software-craft/programming-and-runtime/901406/901406.md)

Comprehensive guide to implementing robust testing strategies in Python using pytest, fixtures, mocking, parameterization, and test-driven development practices. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Python Project Structure & Module Architecture](https://mdrss.com/software-craft/programming-and-runtime/901405/901405.md)

Design well-organized Python projects with clear module boundaries, explicit public interfaces, and maintainable directory structures. Good organization makes code discoverable and changes predictable. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [python-performance-optimization — detailed patterns and worked examples](https://mdrss.com/software-craft/programming-and-runtime/901404/901404.md)

For advanced optimization techniques including NumPy vectorization, caching, memory management, parallelization, async I/O, database optimization, and benchmarking tools, see references/advanced-patterns.md. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Python Performance Optimization — Advanced Reference](https://mdrss.com/software-craft/programming-and-runtime/901403/901403.md)

Advanced optimization techniques including NumPy vectorization, caching, memory management, parallelization, async I/O, database optimization, and benchmarking tools. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [python-design-patterns — detailed patterns and worked examples](https://mdrss.com/software-craft/programming-and-runtime/901402/901402.md)

Before adding complexity, ask: does a simpler solution work?. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Python Code Style & Documentation](https://mdrss.com/software-craft/programming-and-runtime/901401/901401.md)

Consistent code style and clear documentation make codebases maintainable and collaborative. This skill covers modern Python tooling, naming conventions, and documentation standards. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Python Background Jobs & Task Queues](https://mdrss.com/software-craft/programming-and-runtime/901400/901400.md)

Decouple long-running or unreliable work from request/response cycles. Return immediately to the user while background workers handle the heavy lifting asynchronously. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Python Anti-Patterns Checklist](https://mdrss.com/software-craft/programming-and-runtime/901399/901399.md)

A reference checklist of common mistakes and anti-patterns in Python code. Review this before finalizing implementations to catch issues early. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [async-python-patterns — detailed worked examples](https://mdrss.com/software-craft/programming-and-runtime/901398/901398.md)

Never block the event loop with synchronous operations. A single blocking call stalls all concurrent tasks. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Async Python Patterns](https://mdrss.com/software-craft/programming-and-runtime/901397/901397.md)

Comprehensive guidance for implementing asynchronous Python applications using asyncio, concurrent programming patterns, and async/await for building high-performance, non-blocking systems. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [helm-chart-scaffolding — detailed patterns and worked examples](https://mdrss.com/software-craft/api-backend-and-databases/901334/901334.md)

helm-chart-scaffolding — detailed patterns and worked examples captures reusable agent playbook guidance for api, backend & databases. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/api-backend-and-databases · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Helm Chart Structure Reference](https://mdrss.com/software-craft/api-backend-and-databases/901333/901333.md)

Complete guide to Helm chart organization, file conventions, and best practices. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/api-backend-and-databases · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [typescript-advanced-types — detailed worked examples](https://mdrss.com/software-craft/programming-and-runtime/901332/901332.md)

typescript-advanced-types — detailed worked examples captures reusable agent playbook guidance for programming & runtime. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [TypeScript Advanced Types](https://mdrss.com/software-craft/programming-and-runtime/901331/901331.md)

Comprehensive guidance for mastering TypeScript's advanced type system including generics, conditional types, mapped types, template literal types, and utility types for building robust, type-safe applications. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [nodejs-backend-patterns — detailed patterns and worked examples](https://mdrss.com/software-craft/programming-and-runtime/901330/901330.md)

Use a DI container to wire up repositories, services, and controllers. For a full container implementation, see references/advanced-patterns.md. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Node.js Advanced Patterns](https://mdrss.com/software-craft/programming-and-runtime/901329/901329.md)

Advanced patterns for dependency injection, database integration, authentication, caching, and API response formatting. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [modern-javascript-patterns — detailed patterns and worked examples](https://mdrss.com/software-craft/programming-and-runtime/901328/901328.md)

Functional programming in JavaScript centers on pure functions, immutability, and composable transformations. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Advanced Modern JavaScript Patterns](https://mdrss.com/software-craft/programming-and-runtime/901327/901327.md)

Advanced patterns covering functional programming, modern class features, ES6 modules, iterators, generators, modern operators, and performance optimization. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Advanced JavaScript Testing Patterns](https://mdrss.com/software-craft/programming-and-runtime/901326/901326.md)

Advanced patterns for integration testing, frontend component testing, fixtures, snapshot testing, coverage, and common test utilities. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [JavaScript Testing Patterns](https://mdrss.com/software-craft/programming-and-runtime/901325/901325.md)

Comprehensive guide for implementing robust testing strategies in JavaScript/TypeScript applications using modern testing frameworks and best practices. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [TypeScript Project Scaffolding](https://mdrss.com/software-craft/programming-and-runtime/901324/901324.md)

You are a TypeScript project architecture expert specializing in scaffolding production-ready Node.js and frontend applications. Generate complete project structures with modern tooling (pnpm, Vite, Next.js), type safety, testing setup, and configuration following current best pr. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Onboard](https://mdrss.com/software-craft/testing-and-documentation/901316/901316.md)

You are an expert onboarding specialist and knowledge transfer architect with deep experience in remote-first organizations, technical team integration, and accelerated learning methodologies. Your role is to ensure smooth, comprehensive onboarding that transforms new team me. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/testing-and-documentation · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Full-Stack Feature Orchestrator](https://mdrss.com/software-craft/api-backend-and-databases/901312/901312.md)

You MUST follow these rules exactly. Violating any of them is a failure. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/api-backend-and-databases · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Database Migration](https://mdrss.com/software-craft/programming-and-runtime/901300/901300.md)

Master database schema and data migrations across ORMs (Sequelize, TypeORM, Prisma), including rollback strategies and zero-downtime deployments. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/programming-and-runtime · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Dependency Upgrade Strategy](https://mdrss.com/software-craft/api-backend-and-databases/901298/901298.md)

You are a dependency management expert specializing in safe, incremental upgrades of project dependencies. Plan and execute dependency updates with minimal risk, proper testing, and clear migration paths for breaking changes. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/api-backend-and-databases · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Error Analysis and Resolution](https://mdrss.com/software-craft/architecture-and-distributed-systems/901295/901295.md)

You are an expert error analysis specialist with deep expertise in debugging distributed systems, analyzing production incidents, and implementing comprehensive observability solutions. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/architecture-and-distributed-systems · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [OpenAPI Code-First Generation and Tooling](https://mdrss.com/software-craft/api-backend-and-databases/901289/901289.md)

Advanced patterns for generating OpenAPI specs from code (Python/FastAPI, TypeScript/tsoa), validation, linting, and SDK generation. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/api-backend-and-databases · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Architecture Decision Records](https://mdrss.com/software-craft/architecture-and-distributed-systems/901288/901288.md)

Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the context and rationale behind significant technical decisions. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/architecture-and-distributed-systems · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Api documenter](https://mdrss.com/software-craft/testing-and-documentation/901287/901287.md)

You are an expert API documentation specialist mastering modern developer experience through comprehensive, interactive, and AI-enhanced documentation. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/testing-and-documentation · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [Turborepo Caching](https://mdrss.com/software-craft/testing-and-documentation/901280/901280.md)

Turborepo Caching captures reusable agent playbook guidance for testing & documentation. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/testing-and-documentation · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1

### [sql-optimization-patterns — detailed patterns and worked examples](https://mdrss.com/software-craft/testing-and-documentation/901279/901279.md)

sql-optimization-patterns — detailed patterns and worked examples captures reusable agent playbook guidance for testing & documentation. Use it to give an agent explicit responsibilities, steps and constraints.

Classification: software-craft/testing-and-documentation · Feed: software-craft · Updated: 2026-08-04T13:54:51.641Z · Version: 1