architecture-patterns

Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use when architecting complex backend systems or refactoring existing applications for better maintainability.

Install with Tessl CLI

npx tessl i github:wshobson/agents --skill architecture-patterns

What are skills?

Overall
score

75%

Review — 70%

Does it follow best practices?

If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:

npx tessl skill review --optimize ./path/to/skill

Learn more

Evaluation — 97%

↓ 0.98x

Agent success when using this skill

Validation — 14 / 16 Passed

Validation for skill structure

SKILL.md

Review

Evals

Evaluation results

100%

Subscription Service Backend — Initial Architecture Setup

Clean Architecture layer structure

Criteria

Without context

With context

domain/ directory exists

100%

use_cases/ directory exists

100%

adapters/ directory exists

86%

100%

infrastructure/ directory exists

100%

Abstract repository interface in domain

100%

Concrete repo in adapters

75%

100%

Use case depends on interface

100%

No framework import in domain

100%

Business logic in entity

100%

Controller delegates to use case

100%

No direct DB/repo call in use case

100%

No business logic in controller

100%

Without context: $0.6707 · 2m 29s · 32 turns · 28 in / 9,511 out tokens

With context: $2.0193 · 5m 45s · 61 turns · 220 in / 21,388 out tokens

91%

-9%

Warehouse Inventory Domain Model

DDD tactical patterns

Criteria

Without context

With context

Quantity is immutable

100%

Quantity arithmetic validates units

100%

Product is immutable

100%

StockLedger has business methods

100%

Capacity invariant enforced

100%

Reservation invariant enforced

100%

Domain events collected on entity

100%

Event dataclasses defined

100%

Abstract repository defined

100%

Repo publishes events after save

100%

No ORM types in domain

100%

Ledger is aggregate root

100%

86%

Without context: $0.4595 · 1m 58s · 16 turns · 627 in / 8,039 out tokens

With context: $1.2921 · 4m 4s · 42 turns · 91 in / 14,902 out tokens

100%

Notification Dispatch Service

Hexagonal Architecture ports and adapters

Criteria

Without context

With context

Domain core has no infra imports

100%

Ports are abstract interfaces

100%

Core depends only on ports

100%

Concrete adapters implement ports

100%

Mock adapters provided

100%

Test uses only mock adapters

100%

Adapters separate from core

100%

Swap-ability demonstrated

100%

No business logic in adapters

100%

Test runs without API keys

100%

Interface segregation

100%

Without context: $0.3860 · 1m 38s · 15 turns · 16 in / 6,212 out tokens

With context: $1.1424 · 4m · 39 turns · 87 in / 14,484 out tokens

Evaluated: about 4 hours ago
Agent: Claude Code

Table of Contents

Subscription Service Backend — Initial Architecture Setup Warehouse Inventory Domain Model Notification Dispatch Service

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.