architecture

Review Cortana plugin projects for layered architecture and AOT safety.

46|7|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/sunyonghuan/Netor.Madorin --skill architecture-sunyonghuan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/sunyonghuan/Netor.Madorin/tree/main/Plugins/Samples/ReminderPlugin/.github/skills/plugin-development/subskills/architecture
Command: npx skills add https://github.com/sunyonghuan/Netor.Madorin --skill architecture-sunyonghuan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you design and review Cortana plugin projects so the codebase stays modular, maintainable, and safe for AOT-friendly deployment.

Core Features & Use Cases

  • Layered Architecture Guidance: Defines clear boundaries for Entry, Tools, Application, Domain or Contracts, and Infrastructure.
  • Dependency Injection Rules: Ensures constructor injection, composition-root registration, and no service locator usage.
  • AOT Safety Checks: Highlights restrictions around dynamic reflection, JSON context registration, and package compatibility.
  • Quality Gate Validation: Uses a checklist and PowerShell validator to verify required project structure and architecture readiness.

Quick Start

Use the architecture skill to review this plugin project for layered structure, dependency injection, AOT safety, and validation readiness.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I validate my Cortana plugin architecture for AOT safety?

To validate Cortana plugin architecture for AOT safety, use a checklist-driven PowerShell script that reviews project structure, enforces layered design rules, checks JsonSerializerContext registration, and flags dynamic reflection restrictions.

What is layered design in Cortana plugin development?

Layered design in Cortana plugin development defines clear boundaries for Entry, Tools, Application, Domain or Contracts, and Infrastructure to ensure clean separation of concerns and maintainable project structure.

How do I set up dependency injection for a Cortana plugin project?

Setting up dependency injection for a Cortana plugin project requires using constructor injection at the composition root, ensuring proper service registration, and avoiding service locator patterns to maintain modularity.

Why does my Cortana plugin fail AOT compilation?

Cortana plugin AOT compilation fails when the architecture includes dynamic reflection, lacks JsonSerializerContext registration, uses incompatible packages, or violates separation of concerns between infrastructure and domain boundaries.

Does the architecture validator support PowerShell scripts for CI integration?

The architecture validator includes a PowerShell script that performs checklist-driven validation of project structure and architecture readiness, which can be integrated into continuous integration pipelines for automated quality gate checks.

What's the best way to structure a Cortana plugin for maintainability?

The best way to structure a Cortana plugin for maintainability is enforcing layered architecture with distinct Entry, Tools, Application, Domain, and Infrastructure boundaries, using constructor injection and AOT-safe patterns validated by automated checks.