ports-and-adapters SKILL.md skillA

ports-and-adapters from dev-toolings/superpowers-symfony is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add dev-toolings/superpowers-symfony/ports-and-adapters@git:20261005.2187271

Pins git:20261005.2187271 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
dev-toolings/superpowers-symfony
Path
content/skills/ports-and-adapters/SKILL.md
Versions recorded
3
Latest version
git:20261005.2187271, committed Oct 5, 2026
First version recorded
Sep 17, 2026
Size
1,772 bytes
Repository stars
231
License
MIT

Implement Hexagonal Architecture (Ports and Adapters) in Symfony; separate domain logic from infrastructure with clear boundaries.

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

# Ports And Adapters (Symfony)

## Use when
- Domain rules must not depend on Doctrine, HTTP, or a vendor SDK.
- An infrastructure dependency (storage, payment, mail provider) must be swappable or faked.
- Structuring a bounded context into Domain, Application and Infrastructure layers.

## Default workflow
1. Model the domain in plain PHP: entities and value objects without ORM attributes.
2. Declare ports as interfaces inside the domain, such as a repository interface.
3. Write use cases in the application layer as commands and handlers that depend only on ports.
4. Implement adapters in infrastructure (Doctrine repository, API client) and map entities outside the domain, with XML mapping.
5. Bind each port to its adapter in the service configuration; controllers live in infrastructure.

## Guardrails
- Nothing under `src/Domain/` imports Symfony, Doctrine or vendor SDK classes.
- Dependencies point inward: infrastructure knows the domain, never the reverse.
- Do not add the layers to a CRUD module with no business rules.
- Test the domain with plain unit tests and the adapters with integration tests.

## Progressive disclosure
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add dev-toolings/superpowers-symfony/ports-and-adapters@sha256:85fb7c609d445021

The line at the top of this page pins the label git:20261005.2187271, 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_uqh33o2kkv22lmqb.svg)](https://markdownregistry.com/a/art_uqh33o2kkv22lmqb)

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

Versions

The registry has recorded 3 versions of this file, between Sep 17, 2026 and Oct 5, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
git:20261005.2187271 latest2026-10-05 2187271 1,772 BA view · diff
git:20261005.042befb2026-10-05 042befb 1,188 BA view · diff
git:20260917.3d83f4c2026-09-17 3d83f4c 1,217 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 (1772 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

dev-toolings/superpowers-symfony · 231 stars · license MIT · pushed 2026-10-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_uqh33o2kkv22lmqb
GET https://markdownregistry.com/api/v1/resolve?ref=dev-toolings/superpowers-symfony/ports-and-adapters
GET https://markdownregistry.com/api/v1/blob/85fb7c609d44502101136ce54e1f0d6be3421cf725d2c311d1d1efac7fb23a43

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 dev-toolings/superpowers-symfony

AGENTS.md AGENTS.md file
dev-toolings/superpowers-symfony · AGENTS.md
git:20261005.459bcd0 · audit A · 231 stars
api-platform-dto-resources SKILL.md skill
dev-toolings/superpowers-symfony · content/skills/api-platform-dto-resources/SKILL.md · Map entities to API DTOs in API Platform (v5, 4.4, 4.3) with the Symfony Object Mapper (#[Map], stateOptions) for…
git:20261005.9484d25 · audit A · 231 stars
api-platform-filters SKILL.md skill
dev-toolings/superpowers-symfony · content/skills/api-platform-filters/SKILL.md · Implement API Platform filters - Parameters API (QueryParameter, v5/4.4/4.3) and the #[ApiFilter] attribute deprecated…
git:20261005.3a708e4 · audit A · 231 stars
api-platform-resources SKILL.md skill
dev-toolings/superpowers-symfony · content/skills/api-platform-resources/SKILL.md · Configure API Platform resources (v5, 4.4, 4.3) with explicit operations, pagination, and typed OpenAPI for clean…
git:20261005.d654b3c · audit A · 231 stars
api-platform-security SKILL.md skill
dev-toolings/superpowers-symfony · content/skills/api-platform-security/SKILL.md · Secure API Platform resources with security expressions, voters, securityPostValidation, and operation-level access…
git:20261005.7b53095 · audit A · 231 stars
api-platform-serialization SKILL.md skill
dev-toolings/superpowers-symfony · content/skills/api-platform-serialization/SKILL.md · Control API Platform serialization with groups, #[Context], IRI links (readableLink/writableLink), and custom context…
git:20261005.7b53095 · audit A · 231 stars
api-platform-state-providers SKILL.md skill
dev-toolings/superpowers-symfony · content/skills/api-platform-state-providers/SKILL.md · Master API Platform State Providers and Processors (v5, 4.4, 4.3) (ProviderInterface/ProcessorInterface) to decouple…
git:20261005.d654b3c · audit A · 231 stars
api-platform-tests SKILL.md skill
dev-toolings/superpowers-symfony · content/skills/api-platform-tests/SKILL.md · Test API Platform resources with ApiTestCase; assert collections, items, filters, JSON schema, and authentication
git:20261005.9484d25 · audit A · 231 stars
api-platform-versioning SKILL.md skill
dev-toolings/superpowers-symfony · content/skills/api-platform-versioning/SKILL.md · Evolve API Platform APIs via deprecation (deprecationReason/sunset, RFC 8594/9745), the recommended alternative to…
git:20261005.7b53095 · audit A · 231 stars
bootstrap-check SKILL.md skill
dev-toolings/superpowers-symfony · content/skills/bootstrap-check/SKILL.md · Verify Symfony project configuration including .env, services.yaml, doctrine settings, and framework requirements
git:20261005.6632a97 · audit B · 231 stars
brainstorming SKILL.md skill
dev-toolings/superpowers-symfony · content/skills/brainstorming/SKILL.md · Structured brainstorming for Symfony projects - explore requirements, identify components, and plan architecture…
git:20261005.e6a4c05 · audit A · 231 stars
config-env-parameters SKILL.md skill
dev-toolings/superpowers-symfony · content/skills/config-env-parameters/SKILL.md · Manage Symfony configuration with .env files, parameters, secrets vault, and environment-specific settings
git:20261005.6632a97 · audit A · 231 stars

Every file in dev-toolings/superpowers-symfony

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