Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

system-design-principles

/system-design-principles

Określa granice modułów, kierunek zależności, własność danych, odporność i kompromisy systemów rozproszonych przy decyzjach o architekturze, granicach usług i sprzężeniu.

Licencja
MIT
Ostatnia zmiana repozytorium
22.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
6
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 22.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Określa granice modułów, kierunek zależności, własność danych, odporność i kompromisy systemów rozproszonych przy decyzjach o architekturze, granicach usług i sprzężeniu.

Oryginalny opis (EN)

Define module boundaries, dependency direction, data ownership, resilience, and distributed-system trade-offs. Use for architecture, service boundaries, coupling, scalability, or failure-cascade decisions; defer session facilitation to system-design-methodology.

Jak działa

  1. Priority: P0 (CRITICAL)
  2. Workflow: Evaluate Architecture for New Feature
  3. Architectural Principles
  4. Modularity & Coupling
  5. Common Patterns
  6. Distributed Systems
  7. Documentation & Evolution
  8. References
  9. Anti-Patterns
Sekcje z nagłówków SKILL.md, w oryginale · 62 linii, 418 słów
Podgląd SKILL.md
---
name: system-design-principles
description: "Define module boundaries, dependency direction, data ownership, resilience, and distributed-system trade-offs. Use for architecture, service boundaries, coupling, scalability, or failure-cascade decisions; defer session facilitation to system-design-methodology."
metadata:
  triggers:
    keywords:
      - architecture
      - scalability
      - microservice
      - microservices
      - module boundary
      - coupling
      - bounded context
      - dependency direction
      - clean architecture
      - cap theorem
      - idempotency
---

# System Design Principles

## **Priority: P0 (CRITICAL)**

## Workflow: Evaluate Architecture for New Feature

1. Identify bounded contexts and module boundaries
2. Name the data owner and define dependency direction (outer layers depend on inner)
3. Select communication pattern (sync REST, async event, or hybrid) and failure behavior
4. Validate CAP trade-offs only for distributed components
5. Record boundary, trade-off, and rollback in an ADR

For a failing synchronous dependency, keep the critical path explicit: timeout and circuit-break the dependency, return a defined degraded/fallback result where safe, and move non-critical notifications to an asynchronous event.

## Architectural Principles

- **SoC**: Divide into distinct sections per concern.
- **SSOT**: One source, reference elsewhere.
- **Fail Fast**: Fail visibly when errors occur.
- **Graceful Degradation**: Core functional even if secondary fails.

## Modularity & Coupling

- **High Cohesion**: Related functionality in one module.
- **Loose Coupling**: Use interfaces for communication.
- **DI**: Inject dependencies, don't hardcode.

See [implementation examples](references/implementation.md) for dependency flow diagrams.

## Common Patterns

- **Layered**: Presentation -> Logic -> Data.
- **Event-Driven**: Async communication between decoupled components.
- **Clean/Hexagonal**: Core logic independent of frameworks.
- **Statelessness**: Favor stateless for scaling/testing.
- **Monolith first**: Start modular-monolith; split a service out only when a module needs independent scaling, release cadence, or ownership.

## Distributed Systems

- **CAP**: Apply only to behavior during a network partition in a distributed data system. See [CAP & Consistency Patterns](references/distributed-systems.md); consistency, availability, and partition tolerance are not product labels or uptime percentages.
- **Idempotency**: Preserve one intended effect for retries of the same business operation. Use the [idempotency contract](references/idempotency-contract.md), not “without side effects” or a fresh key per transport attempt.
- **Circuit Breaker**: Fail fast on failing services. See [Resilience Patterns](references/resilience-patterns.md).
- **Eventual Consistency**: State a freshness/convergence objective, how it is measured, and behavior when it is missed; do not promise a generic convergence time.

## Documentation & Evolution

- **Design Docs**: Write specs before major implementations.
- **Versioning**: Version APIs/schemas for backward compatibility.
- **Extensibility**: Use Strategy/Factory for future changes.

## References

- [Distributed Systems & CAP Theorem](references/distributed-systems.md)
- [Resilience Patterns (Circuit Breaker, Bulkhead, Retry)](references/resilience-patterns.md)

## Anti-Patterns

- **No god classes**: Single Responsibility — one reason to change per module.
- **No blanket synchronous-coupling ban**: choose synchronous, asynchronous, or hybrid communication from the boundary's consistency, latency, failure, and coupling requirements. A bounded synchronous transaction can protect an immediate invariant; independent notifications may remain asynchronous. State the trade-offs and failure behavior.
- **No premature abstraction**: Design for current load; scale when proven needed.
Pliki w paczce (6)
  • LICENSE 1 KB
  • SKILL.md 4 KB
  • references/distributed-systems.md 3 KB
  • references/idempotency-contract.md 6 KB
  • references/implementation.md 1 KB
  • references/resilience-patterns.md 4 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · HoangNguyen0403/agent-skills-standard100MIT
HoangNguyen0403/agent-skills-standard100MIT

Identyczna treść występuje jeszcze w 4 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki 6890c50933c6 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90bec-architecture-design
    Projektuje lub przegląda granice modułów backendu, własność danych, kierunki zależności i kompromisy architektoniczne.
  • 100microservices
    Opisuje wzorce mikroserwisów i systemów rozproszonych: granice serwisów, sagi, CQRS, odporność i kompromisy względem monolitu.
  • 90uds-architecture
    Pomaga wybrać lub przejrzeć strukturę aplikacji, granice modułów, kierunek zależności, własność logiki i decyzje architektoniczne.
  • 90architecture
    Projektuje lub przegląda architekturę nowych systemów, większe refaktoryzacje, granice usług, własność danych i plany migracji.
  • 100design-expert
    Doradza w projektowaniu systemów, wzorcach architektonicznych, skalowalności i systemach rozproszonych.
  • 100microservices-architecture
    Pomaga projektować, recenzować i refaktoryzować granice mikroserwisów, komunikację, własność usług, niezależność wdrożeń, odporność i rozproszone przepływy danych.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.