architecture-guidelines

eser 的头像作者 eser

高级系统架构,包括模块系统、项目结构、架构决策记录(ADRs)和测试策略。在设计系统、审查结构或讨论架构时使用。

📖 中文导读:高级系统架构,包括模块系统、项目结构、架构决策记录(ADRs)和测试策略。在设计系统、审查结构或讨论架构时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: architecture-guidelines description: System architecture: modules, project structure, ADRs, and testing. Use when designing or reviewing systems.

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.