Ontology-Driven System Builder
sharptoolbox/ontology-driven-dev
Runs a three-step pipeline, requirement exploration, seven-model ontology YAML, then app build, on a Flask, SQLite, and React stack with sign-off gates.
Agent skill
Architecture Design Principles
by davidYichengWei in davidYichengWei/agentic-engineering-framework
Gives architecture design principles for system design discussions and code review: module boundaries, dependency direction, data ownership and interface rules, plus a checklist.
SKILL.md written in Chinese; this summary is our English description.
Install Architecture Design Principles
$ npx skills add davidYichengWei/agentic-engineering-framework --skill bp-architecture-design -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install davidYichengWei/agentic-engineering-framework bp-architecture-design --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/davidYichengWei/agentic-engineering-framework.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bp-architecture-design .claude/skills/bp-architecture-design && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "bp-architecture-design" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/bp-architecture-design into .claude/skills/bp-architecture-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bp-architecture-design", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/bp-architecture-designType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add davidYichengWei/agentic-engineering-framework --skill bp-architecture-design -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install davidYichengWei/agentic-engineering-framework bp-architecture-design --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidYichengWei/agentic-engineering-framework.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/bp-architecture-design .agents/skills/bp-architecture-design && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "bp-architecture-design" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/bp-architecture-design into .agents/skills/bp-architecture-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bp-architecture-design", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add davidYichengWei/agentic-engineering-framework --skill bp-architecture-design -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install davidYichengWei/agentic-engineering-framework bp-architecture-design --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidYichengWei/agentic-engineering-framework.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/bp-architecture-design .cursor/skills/bp-architecture-design && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "bp-architecture-design" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/bp-architecture-design into .cursor/skills/bp-architecture-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bp-architecture-design", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/davidYichengWei/agentic-engineering-framework.git --path skills/bp-architecture-design--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add davidYichengWei/agentic-engineering-framework --skill bp-architecture-design -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install davidYichengWei/agentic-engineering-framework bp-architecture-design --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidYichengWei/agentic-engineering-framework.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/bp-architecture-design .gemini/skills/bp-architecture-design && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "bp-architecture-design" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/bp-architecture-design into .gemini/skills/bp-architecture-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bp-architecture-design", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install davidYichengWei/agentic-engineering-framework bp-architecture-designInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add davidYichengWei/agentic-engineering-framework --skill bp-architecture-design -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/davidYichengWei/agentic-engineering-framework.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/bp-architecture-design .github/skills/bp-architecture-design && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "bp-architecture-design" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/bp-architecture-design into .github/skills/bp-architecture-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bp-architecture-design", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add davidYichengWei/agentic-engineering-framework --skill bp-architecture-design -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install davidYichengWei/agentic-engineering-framework bp-architecture-design --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidYichengWei/agentic-engineering-framework.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/bp-architecture-design .opencode/skills/bp-architecture-design && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "bp-architecture-design" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/bp-architecture-design into .opencode/skills/bp-architecture-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bp-architecture-design", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
bp-architecture-design- GitHub stars
- 158
- Token cost
- ~545 tokens
- SKILL.md length
- 153 words
- Files
- 1
- Skills in repo
- 14
- Repo updated
- First seen
- Licence
- MIT
At a glance
Gives architecture design principles for system design discussions and code review: module boundaries, dependency direction, data ownership and interface rules, plus a checklist.
- Works in 3 steps: 应用层 - 业务逻辑、用例编排 → 领域层 - 核心抽象、接口定义 → 基础设施层 - 具体实现（RocksDB、网络等）
- Drafting the solution overview section of a design spec
- SKILL.md covers 第一性原理, 设计前：回顾 spec.md 前三节, 模块划分 and 依赖管理, plus 5 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Written in Chinese, this skill supports the solution overview section (4.1) of a spec.md in a design workflow, and it can also be used to judge architecture during code review. Before proposing anything, the agent should have understood the spec's background, goals and non-goals, functional requirements and non-functional constraints, quantifying those constraints where possible. Its framing is that architecture means choosing the best trade-off under constraints to meet business goals.
The principles cover dividing modules by business capability with high cohesion, low coupling and clear ownership of data and invariants; one-way, acyclic dependencies that run from application logic to domain abstractions to infrastructure and rely on interfaces; data decisions on ownership, consistency model and schema evolution; and interface rules to keep them minimal, avoid leaking internals through dedicated DTOs and stay backward compatible. A checklist for the overview section asks for the core idea, modules, dependency direction, data flow and key trade-offs, and an anti-pattern table covers circular dependencies, blurred boundaries, over-abstraction and big balls of mud.
When your agent uses it
- Drafting the solution overview section of a design spec
- Judging module boundaries and dependency direction in a code review
- Spotting circular dependencies or unclear data ownership
Example prompts
- “Review the module split in this design and check the dependency direction.”
- “Help me fill in the solution overview of spec.md: modules, data flow and key trade-offs.”
- “Find any circular dependencies or shared data ownership problems in this architecture.”
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- 应用层 - 业务逻辑、用例编排
- 领域层 - 核心抽象、接口定义
- 基础设施层 - 具体实现（RocksDB、网络等）
What it can do on your machine
Read from SKILL.md and the folder at commit 1f7ac0f. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are cpp).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Architecture Design Principles loads about 545 tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 153 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from davidYichengWei/agentic-engineering-framework at commit 1f7ac0f, republished under its MIT licence (© davidYichengWei). 153 words, ~545 tokens.
Download SKILL.mdSave it as
.claude/skills/bp-architecture-design/SKILL.md (or your agent's skills folder).- name
- bp-architecture-design
- description
- 提供架构设计原则，包括模块划分、依赖管理、数据架构、接口设计。在系统设计阶段讨论方案概览时使用，或在 code review 中评估架构合理性时使用。
架构设计
使用场景：
workflow-system-designskill 在讨论 spec.md 4.1 方案概览 时加载本 skill。
第一性原理
架构设计的本质：在约束条件下，选择最优的 trade-off 来满足业务目标。
设计前：回顾 spec.md 前三节
在提出架构方案前，确保已理解：
| spec.md 章节 | 要回答的问题 |
|---|---|
| 1. 背景 | 要解决什么问题？现状是怎样的？ |
| 2. 目标 & 非目标 | 成功的标准是什么？什么不做？ |
| 3.1 功能性需求 | 系统需要具备哪些能力？ |
| 3.2 非功能性需求 | 性能、兼容性、可维护性约束？ |
如果非功能性需求可以量化，尽量量化（如 p99 延迟 < 100ms），但不强制要求所有场景都能量化。
模块划分
好的划分 = 减少协调成本 + 包含变化。
划分原则
| 原则 | 说明 | 检查点 |
|---|---|---|
| 按功能域划分 | 围绕业务能力而非技术层 | 相关的代码是否在一起？ |
| 高内聚 | 一起变化的代码放一起 | 修改一个功能要改几个模块？ |
| 低耦合 | 模块间依赖最小化 | 模块能否独立理解和测试？ |
| 明确所有权 | 每个模块有明确的数据和不变量 | 谁负责维护这块数据的一致性？ |
边界定义
// ✅ 明确的模块边界
namespace compaction {
// 公开接口
class CompactionScheduler { ... };
// 内部实现（不暴露）
namespace internal {
class CompactionTask { ... };
}
}依赖管理
依赖方向
层次结构（从高到低）：
- 应用层 - 业务逻辑、用例编排
- 领域层 - 核心抽象、接口定义
- 基础设施层 - 具体实现（RocksDB、网络等）
依赖原则：高层依赖低层，依赖抽象接口而非具体实现
依赖规则
| 规则 | 说明 |
|---|---|
| 单向依赖 | 只能向下依赖，禁止向上依赖 |
| 禁止循环 | A→B→C→A 必须打破 |
| 依赖抽象 | 依赖接口而非具体实现 |
数据架构
数据决策决定正确性和运维复杂度。
| 决策点 | 需要明确 |
|---|---|
| 数据所有权 | 哪个模块是这份数据的 source of truth？ |
| 一致性模型 | 强一致 vs 最终一致？ |
| Schema 演进 | 向前/向后兼容？回滚方案？ |
接口设计
架构层关注接口原则，详细设计参见
bp-component-design的 4.2.2 节。
| 原则 | 说明 |
|---|---|
| 最小化 | 只暴露必要的接口 |
| 不泄露内部 | 使用专用 DTO |
| 版本兼容 | 接口变更需考虑向后兼容 |
与其他 Skill 协同
| 场景 | 加载 Skill |
|---|---|
| 涉及网络通信、多节点、一致性、故障恢复 | bp-distributed-systems |
| 涉及类/接口详细设计 | bp-component-design（4.2 节使用） |
4.1 方案概览 Checklist
在 spec.md 4.1 节，确认以下内容已讨论：
- 整体思路：用 1-2 句话描述方案核心
- 模块划分：涉及哪些模块？边界在哪？
- 依赖方向：模块间的依赖关系
- 数据流：数据如何流转？
- 关键 trade-off：为什么这样设计？牺牲了什么？
反模式
| 反模式 | 改进 |
|---|---|
| 循环依赖 (A→B→C→A) | 引入接口打破循环 |
| 边界模糊（多模块修改同一份数据） | 明确数据所有权 |
| 过度抽象 | 简单优先，按需抽象 |
| Big Ball of Mud | 逐步引入边界 |
© davidYichengWei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/bp-architecture-design of davidYichengWei/agentic-engineering-framework.
Open the folder on GitHubat commit 1f7ac0f
Compare with similar skills
Architecture Design Principles next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Architecture Design Principles this skilldavidYichengWei/agentic-engineering-framework | 158 | — | ~545 | Automated safety check: Pass | MIT | |
| Ontology-Driven System Buildersharptoolbox/ontology-driven-dev | 433 | — | ~1.5k | Automated safety check: Pass | MIT | |
| MVP Technical DesignKhazP/vibe-coding-prompt-template | 3.1k | — | ~512 | Automated safety check: Pass | MIT | |
| Architecture Reviewowainlewis/blueprint | 412 | — | ~1.2k | Automated safety check: Pass | MIT | |
| SPARC Methodologyruvnet/agentic-flow | 817 | 6 repos | ~6.3k | Automated safety check: Pass | None | |
| Architect Build Specsjsmastery-pro/skills | 1.5k | — | ~7k | Automated safety check: Notes | MIT |
Similar skills
MVP Technical Design
KhazP/vibe-coding-prompt-template
Writes an MVP technical design from agreed requirements, covering architecture, data ownership, integration contracts, deployment and tradeoffs, then hands off to the next stage.
Architecture Review
owainlewis/blueprint
Reviews a technical proposal before implementation through an independent subagent, returning findings, open questions and a verdict without rewriting it.
SPARC Methodology
ruvnet/agentic-flow
Structures complex feature work into five planning-first phases (specification, pseudocode, architecture, refinement and completion) driven through claude-flow commands.
Architect Build Specs
jsmastery-pro/skills
Runs a structured design conversation on a feature, tech stack or enhancement, recommends an answer and records it as a build spec in docs/specs.
Feature Specification
owainlewis/blueprint
Writes one implementation-ready spec for a feature or major change, settling behavior, technical design, failure handling and acceptance checks before delivery.
More from davidYichengWei/agentic-engineering-framework
All 14 skills in this repoGeneral Coding Best Practices
davidYichengWei/agentic-engineering-framework
A checklist of language-neutral rules for writing and reviewing code: naming, function design, control flow, resource safety, comments and logging.
Component Design Principles
davidYichengWei/agentic-engineering-framework
Chinese-language checklists for component-level design: class and module structure, public interfaces, data models, concurrency and error handling.
Skill Authoring Guide (Chinese)
davidYichengWei/agentic-engineering-framework
Chinese-language guide to writing and improving SKILL.md files: frontmatter rules, concise writing, progressive disclosure, common patterns and a pre-release checklist.
Self-Refinement from Corrections
davidYichengWei/agentic-engineering-framework
Turns mistakes you correct into proposed updates to persistent Rules and Skills so the same error does not recur in later sessions, triggered automatically or with /reflect.
Root-Cause Troubleshooting
davidYichengWei/agentic-engineering-framework
Diagnoses compile errors, runtime exceptions, failing tests, pipeline failures and production alerts from code and logs, giving a root cause before any fix.
Workflow Code Generation
davidYichengWei/agentic-engineering-framework
代码文件修改的统一入口。当用户请求任何代码变更（新功能、优化、Bug 修复、重构）时必须首先调用此 skill。仅适用于代码文件（如 .cc/.cpp/.h/.go/.py 等），修改 .md 等非代码文件时不需要调用。它会评估复杂度、检查 spec.md、生成 tasks.md、并逐个任务执行。
Related
Categories
Questions about Architecture Design Principles
What does Architecture Design Principles do?
Gives architecture design principles for system design discussions and code review: module boundaries, dependency direction, data ownership and interface rules, plus a checklist. md in a design workflow, and it can also be used to judge architecture during code review. Before proposing anything, the agent should have understood the spec's background, goals and non-goals, functional requirements and non-functional constraints, quantifying those constraints where possible.
When should I use Architecture Design Principles?
Architecture Design Principles fits situations like: drafting the solution overview section of a design spec; judging module boundaries and dependency direction in a code review; spotting circular dependencies or unclear data ownership.
How do I install Architecture Design Principles in Claude Code?
Run `npx skills add davidYichengWei/agentic-engineering-framework --skill bp-architecture-design -a claude-code`. Or copy the skill folder (skills/bp-architecture-design in davidYichengWei/agentic-engineering-framework) into .claude/skills/bp-architecture-design in your project. Claude Code loads it when a task matches its description.
How do I install Architecture Design Principles in Codex?
Run `npx skills add davidYichengWei/agentic-engineering-framework --skill bp-architecture-design -a codex`. Or copy the skill folder (skills/bp-architecture-design in davidYichengWei/agentic-engineering-framework) into .agents/skills/bp-architecture-design in your project. Codex loads it when a task matches its description.
Can I use Architecture Design Principles in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davidYichengWei/agentic-engineering-framework --skill bp-architecture-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bp-architecture-design, .gemini/skills/bp-architecture-design, .github/skills/bp-architecture-design and .opencode/skills/bp-architecture-design in your project.
What does Architecture Design Principles need to run?
SKILL.md names no scripts, command-line tools or credentials: Architecture Design Principles is instructions for the agent only.
Does Architecture Design Principles access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Architecture Design Principles safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Architecture Design Principles use?
Architecture Design Principles is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Architecture Design Principles use?
About 545 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Architecture Design Principles?
Skills that share tags, products or a category with Architecture Design Principles: Ontology-Driven System Builder (sharptoolbox/ontology-driven-dev, 433 stars), MVP Technical Design (KhazP/vibe-coding-prompt-template, 3.1k stars), Architecture Review (owainlewis/blueprint, 412 stars) and SPARC Methodology (ruvnet/agentic-flow, 817 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Architecture Design Principles?
davidYichengWei (a GitHub user) maintains it in davidYichengWei/agentic-engineering-framework, which has 158 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on March 25, 2026.
Source: davidYichengWei/agentic-engineering-framework on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.