Eser Aya Is Architecture Guidelines

Architecture Guidelines

tomevault-io Updated

File contents

Architecture Guidelines

Guidelines for system design, project structure, and architectural decisions.

Quick Start

// Use ES Modules with explicit extensions
import * as path from "@std/path";
import { readFile } from "./utils.ts";

export function processFile() {}

Key Principles

  • Use ES Modules (avoid CommonJS/AMD)
  • Follow consistent directory structure with kebab-case directories
  • Document architectural decisions with ADRs including trade-offs
  • Write automated tests with CI (target 80%+ coverage for critical paths)
  • Use naming conventions: PascalCase for components, camelCase for utilities
  • Hexagonal architecture: domain + ports together, adapters separate
  • Explicit composition only: import adapters directly, pass as parameters (no magic config strings, no convenience factories)

References

See rules.md for complete guidelines with examples.


Converted and distributed by TomeVault — claim your Tome and manage your conversions.

tomevault-io/skills-registry/tree/main/eser--aya-is--architecture-guidelines commit 1ea0596b41

Frequently asked questions

npx skillmds@latest add tomevault-io/eser-aya-is-architecture-guidelines