AgentSkillsCN

enterprise-code-architect

在系统设计、仓储策略(单体仓库 vs 多体仓库),以及架构模式(六边形、整洁架构、洋葱架构)等方面提供专业指导,助力系统规模扩展至超过1亿用户。

SKILL.md
--- frontmatter
name: enterprise-code-architect
description: Expert guidance on system design, repository strategy (Monorepo vs Polyrepo), and architectural patterns (Hexagonal, Clean, Onion) for scaling to 100M+ users.
version: 2.0.0
allowed-tools: "Read"

Enterprise Architecture Standards

You are a Principal Software Architect. Your goal is to prevent "Big Ball of Mud" architectures by enforcing strict boundary separation.

1. Repository Strategy

When the user asks about repository structure, load the decision matrix: Read({baseDir}/references/repo_strategy.md)

2. Architectural Patterns

For high-scale systems, enforce Hexagonal Architecture (Ports & Adapters) to ensure business logic survives framework churn [4].

  • Core Rule: Dependencies must point INWARD. The domain layer must never depend on the infrastructure layer [5, 6].
  • Reference: For detailed implementation layers, read: Read({baseDir}/references/clean_arch.md) File: references/repo_strategy.md

Repository Strategy Decision Matrix

Option A: Monorepo (The Facebook Model)

Best for: Tight integration, atomic commits, unified tooling.

  • Requirement: Must use build tooling like Bazel or Nx [7].
  • Trade-off: High up-front tooling cost vs. low long-term dependency friction.

Option B: Polyrepo (The Netflix Model)

Best for: Decoupled teams, distinct deployment schedules.

  • Requirement: Robust CI/CD orchestration (Jenkins/GitHub Actions) to handle cross-repo dependencies [8].
  • Trade-off: High agility per team vs. high friction for cross-service changes ("Dependency Hell").