ln-770-crosscutting-setup

Coordinates logging, error handling, CORS, health checks, and API docs

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "ln-770-crosscutting-setup" with this command: npx skills add levnikolaevich/claude-code-skills/levnikolaevich-claude-code-skills-ln-770-crosscutting-setup

Paths: File paths (shared/, references/, ../ln-*) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root.

ln-770-crosscutting-setup

Type: L2 Domain Coordinator Category: 7XX Project Bootstrap Parent: ln-700-project-bootstrap

Coordinates cross-cutting concerns configuration for .NET and Python projects.


Overview

AspectDetails
InputProject root directory
OutputConfigured logging, error handling, CORS, health checks, API docs
Workersln-771 to ln-775
Stacks.NET (ASP.NET Core), Python (FastAPI)

Phase 1: Detect Project Stack

Determine the technology stack by scanning project files.

Detection Rules:

File PatternStackFramework
*.csproj.NETASP.NET Core
pyproject.toml or requirements.txt + FastAPIPythonFastAPI

Actions:

  1. Glob for *.csproj files
  2. If not found, Glob for pyproject.toml or requirements.txt
  3. If Python, check for FastAPI in dependencies
  4. Store detected stack in Context Store

Context Store Initial:

{
  "STACK": ".NET" | "Python",
  "FRAMEWORK": "ASP.NET Core" | "FastAPI",
  "PROJECT_ROOT": "/path/to/project",
  "FRAMEWORK_VERSION": "8.0" | "0.109.0"
}

Phase 2: Check Existing Configuration

Scan for already configured cross-cutting concerns.

Detection Patterns:

Concern.NET PatternPython Pattern
LoggingSerilog in *.csproj, UseSerilog in Program.csstructlog in requirements, logging config
Error HandlingGlobalExceptionMiddleware, UseExceptionHandler@app.exception_handler, exception_handlers.py
CORSAddCors, UseCorsCORSMiddleware
Health ChecksAddHealthChecks, MapHealthChecks/health routes
API DocsAddSwaggerGen, UseSwaggerFastAPI auto-generates

Actions:

  1. Grep for each pattern
  2. Mark configured concerns as skip: true
  3. Update Context Store with findings

Context Store Updated:

{
  "concerns": {
    "logging": { "configured": false },
    "errorHandling": { "configured": false },
    "cors": { "configured": true, "skip": true },
    "healthChecks": { "configured": false },
    "apiDocs": { "configured": false }
  }
}

Phase 3: Invoke Workers (Conditional)

Delegate to workers only for unconfigured concerns.

Worker Invocation Order:

OrderWorkerConditionSkill Call
1ln-771-logging-configuratorlogging.configured == false/skill ln-771-logging-configurator
2ln-772-error-handler-setuperrorHandling.configured == false/skill ln-772-error-handler-setup
3ln-773-cors-configuratorcors.configured == false/skill ln-773-cors-configurator
4ln-774-healthcheck-setuphealthChecks.configured == false/skill ln-774-healthcheck-setup
5ln-775-api-docs-generatorapiDocs.configured == false/skill ln-775-api-docs-generator

Pass Context Store to each worker.

Worker Response Format:

{
  "status": "success" | "skipped" | "error",
  "files_created": ["path/to/file.cs"],
  "packages_added": ["Serilog.AspNetCore"],
  "message": "Configured structured logging with Serilog"
}

Phase 4: Generate Aggregation File

Create a single entry point for all cross-cutting services.

.NET: Extensions/ServiceExtensions.cs

Generate based on configured workers:

// Structure only - actual code generated via MCP ref
public static class ServiceExtensions
{
    public static IServiceCollection AddCrosscuttingServices(
        this IServiceCollection services,
        IConfiguration configuration)
    {
        // Calls added based on configured workers:
        // services.AddLogging(configuration);      // if ln-771 ran
        // services.AddCorsPolicy(configuration);   // if ln-773 ran
        // services.AddHealthChecks();              // if ln-774 ran
        // services.AddSwaggerServices();           // if ln-775 ran
        return services;
    }
}

Python: middleware/init.py

Generate based on configured workers:

# Structure only - actual code generated via MCP ref
def configure_middleware(app):
    # Middleware added based on configured workers:
    # configure_logging(app)        # if ln-771 ran
    # configure_error_handlers(app) # if ln-772 ran
    # configure_cors(app)           # if ln-773 ran
    # configure_health_routes(app)  # if ln-774 ran
    pass

Phase 5: Summary Report

Display summary of all configured concerns.

Output Format:

Cross-cutting Setup Complete
============================
Stack: .NET (ASP.NET Core 8.0)

Configured:
  ✓ Logging (Serilog) - Extensions/LoggingExtensions.cs
  ✓ Error Handling - Middleware/GlobalExceptionMiddleware.cs
  ✓ CORS - Extensions/CorsExtensions.cs
  ✓ Health Checks - Extensions/HealthCheckExtensions.cs
  ✓ API Docs (Swagger) - Extensions/SwaggerExtensions.cs

Skipped (already configured):
  - None

Entry Point: Extensions/ServiceExtensions.cs
  Add to Program.cs: builder.Services.AddCrosscuttingServices(builder.Configuration);

Packages to Install:
  dotnet add package Serilog.AspNetCore
  dotnet add package Swashbuckle.AspNetCore

Workers

WorkerPurposeStacks
ln-771-logging-configuratorStructured logging.NET (Serilog), Python (structlog)
ln-772-error-handler-setupGlobal exception middleware.NET, Python
ln-773-cors-configuratorCORS policy configuration.NET, Python
ln-774-healthcheck-setup/health endpoints.NET, Python
ln-775-api-docs-generatorSwagger/OpenAPI.NET (Swashbuckle), Python (FastAPI built-in)

Context Store Interface

Workers receive and return via Context Store:

Input to Workers:

{
  "STACK": ".NET",
  "FRAMEWORK": "ASP.NET Core",
  "FRAMEWORK_VERSION": "8.0",
  "PROJECT_ROOT": "/path/to/project",
  "ENVIRONMENT": "Development"
}

Output from Workers:

{
  "status": "success",
  "files_created": [],
  "packages_added": [],
  "registration_code": "services.AddLogging(configuration);"
}

Idempotency

This skill is idempotent:

  • Phase 2 detects existing configuration
  • Workers skip if already configured
  • Aggregation file preserves existing entries

Critical Rules

  • Skip already configured concerns — Phase 2 detection must gate worker invocation (set skip: true)
  • Pass Context Store to every worker — workers depend on STACK, FRAMEWORK, PROJECT_ROOT
  • Generate aggregation file only for workers that ran — do not add registration calls for skipped concerns
  • Support only .NET and Python — detect via *.csproj or pyproject.toml/requirements.txt + FastAPI
  • Idempotent execution — re-running must not duplicate configs or break existing setup

Definition of Done

  • Project stack detected and stored in Context Store
  • Existing configurations detected (Phase 2 complete)
  • All unconfigured concerns delegated to workers (ln-771 through ln-775)
  • Aggregation entry point generated (ServiceExtensions.cs or middleware/__init__.py)
  • Summary report displayed with configured/skipped concerns and package install commands

Reference Files

  • Worker skills: ln-771-logging-configurator/SKILL.md through ln-775-api-docs-generator/SKILL.md

Version: 2.0.0 Last Updated: 2026-01-10

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

Coding

ln-782-test-runner

No summary provided by upstream source.

Repository SourceNeeds Review
Coding

ln-140-test-docs-creator

No summary provided by upstream source.

Repository SourceNeeds Review
Coding

ln-110-project-docs-coordinator

No summary provided by upstream source.

Repository SourceNeeds Review
Coding

ln-150-presentation-creator

No summary provided by upstream source.

Repository SourceNeeds Review