software-architecture

software-architecture is a skill for Claude Code, Codex from liyecom/liye-ai. It costs 12 tokens per session (1,215 once invoked), scanned A, original, Apache-2.0.

Guidance for designing software structure and choosing common patterns, including Clean Architecture, SOLID principles, and GoF design patterns. Clean Architecture separates business rules from interfaces such as databases and user screens.

In plain words
What is it for?
Use it to design systems, reorganize existing code, choose design patterns, write architecture decision records, or review the quality of a codebase's structure.
Why use it?
It helps keep large codebases understandable and makes changes less likely to break unrelated parts. It also provides a shared way to discuss design decisions.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: reads .claude/ paths.

Good fit Use it to design systems, reorganize existing code, choose design patterns, write architecture decision records, or review the quality of a codebase's structure.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/liyecom/liye-ai/software-architecture
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add liyecom/liye-ai --skill software-architecture
Clone the repo
git clone --depth 1 https://github.com/liyecom/liye-ai

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for software-architecture

README.md
[![agentmods](https://agentmods.dev/badge/skills/liyecom/liye-ai/software-architecture/github.svg)](https://agentmods.dev/skills/liyecom/liye-ai/software-architecture)
Your own site
<a href="https://agentmods.dev/skills/liyecom/liye-ai/software-architecture"><img src="https://agentmods.dev/badge/skills/liyecom/liye-ai/software-architecture/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for software-architecture

Your own site · 80×15
<a href="https://agentmods.dev/skills/liyecom/liye-ai/software-architecture"><img src="https://agentmods.dev/badge/skills/liyecom/liye-ai/software-architecture.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 12 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,215 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00012 $0.01215
Opus 5 $0.00006 $0.00607
Sonnet 5 $0.00002 $0.00243
Haiku 4.5 $0.00001 $0.00121

Measured 8d ago against content hash f5bc0645e95f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

software-architecture scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Skills/00_Core_Utilities/meta/software-architecture/SKILL.md · 167 lines

How it starts

The opening of the file, as written. The whole thing — 167 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Software Architecture

来源: ComposioHQ/awesome-claude-skills 适配: LiYe OS 三层架构

实现设计模式,包括 Clean Architecture、SOLID 原则、GoF 设计模式等软件设计最佳实践。

When to Use This Skill

当需要架构设计指导时:

  • 设计新系统架构
  • 重构现有代码结构
  • 应用设计模式
  • 编写架构决策记录 (ADR)
  • 评审代码架构质量

Core Capabilities

1. Clean Architecture

┌─────────────────────────────────────────┐
│           External Interfaces           │
│  (UI, DB, Web, Devices, External APIs)  │
├─────────────────────────────────────────┤
│          Interface Adapters             │
│   (Controllers, Gateways, Presenters)   │
├─────────────────────────────────────────┤
│           Application Layer             │
│          (Use Cases, Services)          │
├─────────────────────────────────────────┤
│            Domain Layer                 │
│     (Entities, Business Rules)          │
└─────────────────────────────────────────┘

2. SOLID 原则

原则 含义 示例
Single Responsibility 单一职责 一个类只做一件事
Open/Closed 开闭原则 对扩展开放,对修改关闭
Liskov Substitution 里氏替换 子类可替换父类
Interface Segregation 接口隔离 细粒度接口
Dependency Inversion 依赖倒置 依赖抽象而非实现

3. GoF 设计模式

创建型模式:

  • Factory, Abstract Factory
  • Builder, Prototype
  • Singleton

结构型模式:

  • Adapter, Bridge, Composite
  • Decorator, Facade
  • Flyweight, Proxy

行为型模式:

  • Chain of Responsibility
  • Command, Iterator
  • Observer, Strategy
  • Template Method, Visitor

4. 架构决策记录 (ADR)

# ADR-001: 选择 PostgreSQL 作为主数据库

## 状态
已接受

## 背景
需要选择生产环境数据库...

## 决策
选择 PostgreSQL 因为...

## 后果
正面: ...
负面: ...

5. 代码组织模式

  • 分层架构 (Layered)
  • 六边形架构 (Hexagonal)
  • 微服务架构
  • 事件驱动架构
  • CQRS 模式

Usage Examples

示例 1: 新项目架构

用户: 帮我设计一个电商后端的架构
Claude: [使用 software-architecture 设计分层结构、定义边界、选择模式]

示例 2: 代码重构

用户: 这个模块太复杂了,帮我重构
Claude: [使用 software-architecture 识别问题、应用 SOLID、提取模式]

示例 3: 架构评审

用户: 帮我评审这个项目的架构
Claude: [使用 software-architecture 检查依赖方向、职责划分、扩展性]

Dependencies

无外部依赖,纯方法论技能。

Read the full file on GitHub · 167 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 167 lines · 12 tokens per session scan A f5bc0645e95f

Subscribe to this mod's changes

software-architecture is a skill published in the GitHub repository liyecom/liye-ai (33 stars, last pushed yesterday), licensed Apache-2.0. It adds 12 tokens to every session and 1,215 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.