Skip to content
cccskills
FreePublished on GitHub

architecture

Modular design, interface stability, dependency management, AI-code health. Triggers: architecture, design, structure, modules, dependencies, coupling, system design.

The English summary is being prepared. Showing the original description.

See how to install

Files included (6)

  • SKILL.md2.3 KB
  • reference/api-research.md10.7 KB
  • reference/api.md5.7 KB
  • reference/architecture-research.md5.3 KB
  • reference/backend-research.md15.6 KB
  • reference/backend.md4.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

<skill id="architecture"> <purpose> Architecture is about managing change over time. Good architecture makes easy things easy and hard things possible. AI-generated code amplifies existing patterns—good or bad. </purpose> <prerequisite> Understand existing codebase structure before proposing changes. Check for established patterns. Follow them unless explicitly changing. </prerequisite> <reference> Skill-specific: skills/architecture/reference/architecture-research.md </reference>

<core_principles>

  1. FOLLOW EXISTING PATTERNS: Don't introduce new patterns without justification.
  2. INTERFACE STABILITY: Changing interfaces breaks everything. Stabilize them first.
  3. MODULAR BOUNDARIES: Clear separation. Each module has one reason to change.
  4. DEPENDENCY DIRECTION: Depend on abstractions, not concretions. Core doesn't know about edges.
  5. SMALLEST CHANGE: Prefer minimal changes that achieve the goal. </core_principles>

<ai_code_health_nexus> From research: 30%+ defect risk when AI applied to unhealthy code. AI amplifies existing patterns. If code is messy, AI makes it messier. Before adding AI to a codebase:

  1. Identify health score (coupling, complexity, test coverage)
  2. Fix critical health issues first
  3. Establish clear interfaces
  4. Then apply AI within those boundaries </ai_code_health_nexus>

<design_heuristics>

  • If you can't explain it simply, the design is too complex
  • Three concrete examples before abstraction
  • Composition over inheritance
  • Make illegal states unrepresentable
  • Parse, don't validate </design_heuristics>

<anti_patterns>

  • Premature abstraction (abstract before 3 concrete uses)
  • Leaky abstractions (implementation details bleeding through)
  • Circular dependencies
  • God objects (one class doing everything)
  • Feature envy (methods that use another class more than their own) </anti_patterns>

<on_complete> agentdb write-end '{"skill":"architecture","decision":"X","coupling_reduced":true,"adr":"path|none"}' </on_complete>

</skill>

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Use AtomLane to compile and execute safe atomic parallel plans on macOS and native Windows Preview for worthwhile independent argv tasks, dependency DAGs, supported platform entrypoints, or Apple-silicon operators. Use at task start or an execution boundary when structured local work may contain two or more worthwhile units; skip plain answers, one quick command, and work whose effects cannot be safely bounded.

The English summary is being prepared. Showing the original description.

hashgraph-online/awesome-codex-plugins1.4KUpdated Oct 20, 2026

add

Free

Register a deferred decision in the debt registry. Trigger by judgment, not a marker scan, whenever a future reader would ask "why this way?": an unmade decision, stub, loosened type, bypassed check, swallowed error, a default picked "for now", or a TODO/FIXME/HACK/XXX marker. Trigger immediately whenever you defer work, or when the user invokes $add. Over-register freely; the developer drops with "drop A", "drop A,C", or "drop all".

The English summary is being prepared. Showing the original description.

hashgraph-online/awesome-codex-plugins1.4KUpdated Oct 20, 2026

ADK 框架适配层。为 LangChain / EINO / AutoGen / AgentScope / CrewAI 提供框架特定的 代码模板、惯用模式、API 映射和项目结构,供 agent-dev-workshop Phase 5 代码生成使用。 每个框架 reference 文件标注 verified_date 用于版本锁定。

The English summary is being prepared. Showing the original description.

hashgraph-online/awesome-codex-plugins1.4KUpdated Oct 20, 2026

中文调试修复技能。用于报错、测试失败、页面异常、功能不符合预期、需要定位根因并做最小修复时。触发语包括"进入调试模式""帮我修问题""报错了""测试失败""页面坏了""找根因"。

The English summary is being prepared. Showing the original description.

hashgraph-online/awesome-codex-plugins1.4KUpdated Oct 20, 2026

交互式 AI Agent 开发工作坊:通过 6 阶段深度协作对话,引导用户完成 Agent 需求分析、架构设计、 工具定义、Prompt 与编排设计、代码生成、验证迭代,产出可直接运行的 Agent 项目。 框架无关设计优先,支持 LangChain / EINO / AutoGen / AgentScope / CrewAI 等 ADK 框架。

The English summary is being prepared. Showing the original description.

hashgraph-online/awesome-codex-plugins1.4KUpdated Oct 20, 2026

中文漂移审计技能。用于项目或学习过程变乱、上下文漂移、任务分叉、多个方案冲突、命名不一致、Codex 可能顺手改多了时。触发语包括"漂移检查""感觉跑偏了""项目变乱了""检查是否失控""分叉太多""上下文漂移"。

The English summary is being prepared. Showing the original description.

hashgraph-online/awesome-codex-plugins1.4KUpdated Oct 20, 2026

See all skills by hashgraph-online

Report a problem with this skill