resilient-nestjs-patterns SKILL.md skillA

resilient-nestjs-patterns from hive-academy/ptahcode is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add hive-academy/ptahcode/resilient-nestjs-patterns@git:20261025.e12e11b

Pins git:20261025.e12e11b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
hive-academy/ptahcode
Path
.claude/skills/resilient-nestjs-patterns/SKILL.md
Versions recorded
4
Latest version
git:20261025.e12e11b, committed Oct 25, 2026
First version recorded
Aug 31, 2026
Size
3,543 bytes
Repository stars
34
License
MIT

NestJS service decomposition and resilience. Use when splitting an orchestrator service into layers, adding retries or fallbacks, wiring EventEmitter events or SSE, or designing forRoot/forTesting dynamic modules. Persistence, auth, RBAC and repositories are nestjs-backend-patterns. Webhook plumbing is webhook-architecture. A task that both persists and retries may load both skills.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Resilient NestJS Patterns

## Apply

- Use during a Stage B module task when the module needs orchestration, reliability, events, or configurable wiring.
- Keep controllers at the HTTP boundary, domain services responsible for business rules, and database services responsible for persistence and transactions.
- Retry only transient external failures with a bounded policy; make fallback behavior explicit. Keep side effects behind events when they should not block the core transaction.
- Expose configuration through a dynamic module when provider choices vary by environment or tests.
- When patterns compose, a thin controller calls a business orchestrator; it delegates persistence to a DbService, external calls to a resilient adapter, and emits a domain event only after the transaction succeeds. Event listeners handle email or SSE; the module exports the orchestrator and supplies production and test providers through `forRoot` and `forTesting`.

## Selection and adoption

| Current problem | Route |
| --- | --- |
| Controller calls Prisma, owns transactions, or mixes HTTP mapping with business rules | [Domain service layering](references/domain-service-layering.md) first |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add hive-academy/ptahcode/resilient-nestjs-patterns@sha256:ce73d3d1b6ce4ef7

The line at the top of this page pins the label git:20261025.e12e11b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_unwczbtezho6z7l5.svg)](https://markdownregistry.com/a/art_unwczbtezho6z7l5)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Aug 31, 2026 and Oct 25, 2026, about one every 18 days.

versioncommittedcommitsizeaudit
git:20261025.e12e11b latest2026-10-25 e12e11b 3,543 BA view · diff
git:20261018.e46f9182026-10-18 e46f918 3,411 BA view · diff
git:20260914.5e8ef0f2026-09-14 5e8ef0f 10,757 BA view · diff
git:20260831.84892c02026-08-31 84892c0 11,136 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3543 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

hive-academy/ptahcode · 34 stars · license MIT · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_unwczbtezho6z7l5
GET https://markdownregistry.com/api/v1/resolve?ref=hive-academy/ptahcode/resilient-nestjs-patterns
GET https://markdownregistry.com/api/v1/blob/ce73d3d1b6ce4ef79e4186d74f8611dfda5255e42e08cb5d18c1af66520f855c

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from hive-academy/ptahcode

agent-lanes SKILL.md skill
hive-academy/ptahcode · .claude/skills/agent-lanes/SKILL.md · Contract for background CLI agent lanes via the ptah_agent_* tools. Use when a task spawns or resumes a lane, or…
git:20261106.6843d5d · audit A · 34 stars
angular-3d-scene-crafter SKILL.md skill
hive-academy/ptahcode · .claude/skills/angular-3d-scene-crafter/SKILL.md · Designs Angular 3D scenes with @hive-academy/angular-3d, including in-scene motion and animation tuning. Use for 3D…
git:20261025.e12e11b · audit A · 34 stars
angular-frontend-patterns SKILL.md skill
hive-academy/ptahcode · .claude/skills/angular-frontend-patterns/SKILL.md · Angular component and state patterns built on signals. Use when building Angular components, signal state, RxJS…
git:20261025.e12e11b · audit A · 34 stars
angular-gsap-animation-crafter SKILL.md skill
hive-academy/ptahcode · .claude/skills/angular-gsap-animation-crafter/SKILL.md · Designs scroll, parallax and timeline motion for @hive-academy/angular-gsap. Use for scroll-triggered or viewport…
git:20261025.e12e11b · audit A · 34 stars
ddd-architecture SKILL.md skill
hive-academy/ptahcode · .claude/skills/ddd-architecture/SKILL.md · Domain-Driven Design for complex business domains. Use when deciding whether DDD is warranted, defining bounded…
git:20261025.e12e11b · audit A · 34 stars
execute-phase-gated-task SKILL.md skill
hive-academy/ptahcode · .claude/skills/execute-phase-gated-task/SKILL.md · Execute a complex, multi-phase project from a detailed specification with checkpoint validation, strategic commit…
git:20261022.d1f793f · audit A · 34 stars
frontend-design SKILL.md skill
hive-academy/ptahcode · .claude/skills/frontend-design/SKILL.md · Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with…
git:20261028.bbaa97b · audit A · 34 stars
humanize-library SKILL.md skill
hive-academy/ptahcode · .claude/skills/humanize-library/SKILL.md · Behavior-preserving refactor that makes an existing library, module or folder readable — small focused files, no…
git:20261018.5dfc7cd · audit A · 34 stars
nestjs-backend-patterns SKILL.md skill
hive-academy/ptahcode · .claude/skills/nestjs-backend-patterns/SKILL.md · NestJS backend architecture for multi-tenant SaaS. Use for third-party API providers, Prisma or ZenStack setup…
git:20261018.e46f918 · audit A · 34 stars
nestjs-deployment SKILL.md skill
hive-academy/ptahcode · .claude/skills/nestjs-deployment/SKILL.md · Productionizes NestJS apps for containers. Use for multi-stage Docker builds of NestJS or Nx apps, webpack externals…
git:20261018.e46f918 · audit A · 34 stars
nx-workspace-architect SKILL.md skill
hive-academy/ptahcode · .claude/skills/nx-workspace-architect/SKILL.md · Nx monorepo architecture for Angular and NestJS. Use when creating a workspace, organizing or naming libraries, tags…
git:20261018.e46f918 · audit A · 34 stars
orchestration SKILL.md skill
hive-academy/ptahcode · .claude/skills/orchestration/SKILL.md · Default workflow for any engineering task (feature, bugfix, refactor, docs, research, devops, SaaS init, creative) —…
git:20261107.05d3bb1 · audit A · 34 stars

Every file in hive-academy/ptahcode

Browse by kind, by grade A, or by owner.