AGENT SKILL

standard-architecture

Company software architecture, code design, and refactoring standards. Use when designing module boundaries, ports and adapters, use cases, writing architecture docs (arc42, C4, ADR), splitting large files, extracting libraries, or doing any refactoring larger than a rename.

使用场景视觉设计
License 许可
MIT
最近更新
2026-11-11
Stars
★ 0
Forks
0

01 前言 Front Matter

name
standard-architecture
description
Company software architecture, code design, and refactoring standards. Use when designing module boundaries, ports and adapters, use cases, writing architecture docs (arc42, C4, ADR), splitting large files, extracting libraries, or doing any refactoring larger than a rename.

03 SKILL.md 正文

standard-architecture

<!-- generated by standards.py from projectious-work/standards; do not edit -->

Binding company standard. The rules below are the summary; the linked file is authoritative. Read only the section the task needs.

Software architecture and code design standard

Ports in the core, adapters at the edge, dependencies inward (Hexagonal Architecture); rules in entities and use cases (Clean Architecture); feature Deep Modules own their data and talk only through module APIs. KISS Principle, YAGNI; Design by Contract inside, defensive checks at trust boundaries. The formatter and linter decide style. Document with arc42, C4-Diagrams, and ADR according to Nygard.

Full standard: .standards/software-architecture-and-code-design.md. Sections:

  • Purpose and scope
  • Principles
  • Boundaries: Hexagonal Architecture
  • Inside the core: Clean Architecture
  • Modules
  • Code conventions
  • Testing consequences
  • Architecture documentation

Refactoring standard

Name the Code Smells, learn why code exists (Chesterton's Fence), secure behavior with characterization tests, apply Refactoring Catalog steps one at a time with green tests at every commit, use the Mikado Method for large changes, extract Deep Modules, limit scope by the Boy Scout Rule, and keep behavior changes out of refactor: commits.

Full standard: .standards/refactoring.md. Sections:

  • Purpose and scope
  • Principles
  • Procedure
  • Commits and review

04 同仓库更多 Skills