skills.rest
c-sonnier
c-sonnierCOMMUNITY
Explore all skills by this author →
𝕏@c_sonnierGitHub

convergence-architecture

Map codebase components into four layers and detect upward dependency violations.

2|Updated Mar 31, 2026
Search Tags:#architecture#refactor#code-quality#code-review#software-design#layering#god-objects
One-click install
npx skills add https://github.com/c-sonnier/convergence --skill convergence-architecture
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: convergence-architecture
Source: https://github.com/c-sonnier/convergence/tree/main/plugins/convergence/skills/architecture
Command: npx skills add https://github.com/c-sonnier/convergence --skill convergence-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture health often deteriorates due to layer violations, hidden god objects, and inconsistent boundary rules. This skill provides a repeatable, quantifiable approach to map a codebase into layers, detect violations, score critical constructs, and guide safer refactors.

Core Features & Use Cases

  • Layer mapping: classify codebase components into Presentation, Application, Domain, and Infrastructure layers.
  • Violation detection: identify upward dependencies that breach layer rules and flag model/service/controller issues.
  • Callback scoring: apply a 1-5 score per callback to surface architectural concerns.
  • God object detection: highlight high-churn files with complexity metrics to pinpoint responsibilities clusters.
  • Quality gates: enforce target metrics to guide quality improvements before refactors.
  • Use cases: onboarding a new team, planning major refactors, or quarterly health checks.

Quick Start

Analyze a repository by running the architecture analysis workflow to generate a health-check report you can review and action.

Frequently Asked Questions about convergence-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect upward dependencies that violate codebase layering rules?▼

To detect upward dependencies that violate layering rules, map your codebase into Presentation, Application, Domain, and Infrastructure layers to identify breaches where lower layers improperly reference higher ones. This architecture analysis flags model, service, and controller violations for review.

What is the best way to identify god objects in a software architecture?▼

Identifying god objects in a software architecture involves analyzing churn and complexity metrics to pinpoint responsibility clusters. This skill highlights high-churn files with elevated complexity to reveal hidden god objects requiring refactoring.

How do I evaluate callback quality for a safe code refactor?▼

Evaluating callback quality for a safe code refactor involves applying a 1-5 scoring scheme to each callback to surface architectural concerns. This skill systematically scores critical constructs to guide safer refactoring decisions.

Can I use architecture health checks for onboarding new engineering teams?▼

Yes, you can use architecture health checks for onboarding new engineering teams. This skill assesses codebase architecture, detects violations, and produces a structured report with actionable recommendations to help new members understand structural boundaries quickly.

How do I enforce quality gates before planning major code refactors?▼

Enforcing quality gates before planning major code refactors requires verifying target metrics to guide quality improvements prior to structural changes. This skill checks architectural health to ensure your codebase meets baseline quality thresholds before refactoring.

Related Skills

Explore More Software Engineering Skills→
CANTAGESTUDIOCANTAGESTUDIO
3

refactor-arch-hotspots

Detect architectural hotspots by analyzing churn, coupling, and layer violations.

Community
Advanced
MadBomberMadBomber
11

layered-rails

Analyze Rails applications for layered architecture violations and refactoring fixes.

Community
Advanced
haginothaginot

architecture-guardian

Validate TypeScript layer dependencies and report import violations.

Community
Advanced
ShubhamsabooShubhamsaboo
131.7k

python-expert

Review Python code for correctness, type safety, performance, and style.

Community
Basic