clean-architecture-guardian

Validate F# and C# codebases for Clean Architecture conformance.

1|Updated Jun 27, 2025
One-click install
npx skills add https://github.com/d-kishi/ubiquitous-lang-mng --skill clean-architecture-guardian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-architecture-guardian
Source: https://github.com/d-kishi/ubiquitous-lang-mng/tree/main/.claude/skills/clean-architecture-guardian
Command: npx skills add https://github.com/d-kishi/ubiquitous-lang-mng --skill clean-architecture-guardian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solves? Maintaining strict Clean Architecture principles (like layer separation, dependency rules, and namespace hierarchy) in complex F# + C# projects is challenging and prone to human error. This Skill automates compliance checks, preventing architectural decay and ensuring high code quality.

Core Features & Use Cases

  • Dependency Rule Enforcement: Automatically checks for forbidden F# → C# dependencies and circular references, maintaining a clear architectural flow.
  • Namespace Hierarchy Validation: Ensures Bounded Context-specific and layered namespace structures are maintained, improving code organization and discoverability.
  • F# Compilation Order Check: Verifies correct F# file ordering to prevent compilation errors due to forward referencing constraints.
  • Use Case: Before merging a new feature or completing a development phase, use this Skill to automatically verify that all new code adheres to Clean Architecture, ensuring zero warnings and errors, and maintaining a 97+ quality score without manual review.

Quick Start

Check the current project for Clean Architecture compliance, focusing on layer separation, namespace hierarchy, and F# compilation order.

Frequently Asked Questions about clean-architecture-guardian

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

FAQPage Schema
How do I enforce clean architecture layer separation in C# and F# projects?

Clean architecture layer separation enforces unidirectional dependency rules between code layers. This Skill automatically validates that dependencies flow correctly—C# to F# is allowed from UI/Application layers to Domain, while F# to C# cross-layer calls are blocked—preventing architectural decay and circular references across your codebase.

Can I validate namespace hierarchy and bounded contexts automatically during development?

Yes. Namespace hierarchy validation ensures your code adheres to bounded-context-specific and layered structures, improving organization. This Skill checks namespace conformance during new implementations and refactoring, catching violations before code review and maintaining clean separation of concerns without manual inspection.

What's the best way to prevent F# compilation order errors in mixed C# and F# codebases?

F# compilation order errors occur when files reference code not yet compiled due to forward references. This Skill verifies correct F# file ordering automatically, detecting compilation order violations before they cause build failures and ensuring your mixed-language project compiles without warnings.

How do I achieve zero warnings and 97+ quality scores in architectural compliance?

Architectural compliance scoring depends on layer separation, dependency direction rules, namespace hierarchy, and build cleanliness. This Skill automates conformance checks against Phase B1 standards, detecting violations during feature completion and issue remediation to reach and maintain 97+ quality scores without manual review.

Does this work with circular dependency detection in complex projects?

Yes. Circular dependency detection identifies bidirectional or multi-hop dependency cycles that violate clean architecture. This Skill scans your F# and C# codebase for forbidden circular references across layers and namespaces, flagging violations to break cycles before they compromise system design.