Claude Code Plugins

Community-maintained marketplace

Feedback

architecture-guidelines

@eser/aya.is
49
0

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

Install Skill

Shared

Installs to .agents/skills, used by Codex, Amp, Warp, Cursor, OpenCode, and more.

CodexAmp
Warp
CursorOpenCode
Cline
Gemini CLI
GitHub Copilot
Personal

Available across projects.

$npx skills-installer add @eser/aya.is/architecture-guidelines --client shared
Project

Writes to .agents/skills.

$npx skills-installer add @eser/aya.is/architecture-guidelines -p --client shared
Note: Review the skill instructions before using it.

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.