Skip to content

Add vibecodex — production clean architecture bible for FastAPI, Next.js, Go#139

Open
yerdaulet-damir wants to merge 1 commit intomehdihadeli:mainfrom
yerdaulet-damir:add-vibecodex
Open

Add vibecodex — production clean architecture bible for FastAPI, Next.js, Go#139
yerdaulet-damir wants to merge 1 commit intomehdihadeli:mainfrom
yerdaulet-damir:add-vibecodex

Conversation

@yerdaulet-damir
Copy link
Copy Markdown

vibecodex

🔗 https://github.com/yerdaulet-damir/vibecodex

Production architecture bible — 54 principles covering clean architecture and hexagonal patterns across FastAPI, Next.js 15, and Go 1.22+.

Patterns covered:

  • Clean Architecture — strict Router→Service→Repository layers
  • Hexagonal / Ports & Adapters — services depend on Protocol/interface, not concrete implementations
  • Anti-Corruption Layer (ACL) — providers return typed domain objects, never raw dict/map
  • Bulkhead Isolation — per-provider connection pools, one failure doesn't cascade
  • Single-Writer Principle — exactly one module owns safety-critical writes
  • Idempotency — every side-effect operation accepts an idempotency key

54 numbered, citable principles (A1–F10) with reference implementations, working tests, and an architecture lint script.

MIT licensed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant