koan-bootstrap

Automate service and module registration by scanning assemblies for IKoanAutoRegistrar implementations.

4|3|Updated Aug 18, 2025
One-click install
npx skills add https://github.com/sylin-org/koan-framework --skill koan-bootstrap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: koan-bootstrap
Source: https://github.com/sylin-org/koan-framework/tree/main/.claude/skills/bootstrap
Command: npx skills add https://github.com/sylin-org/koan-framework --skill koan-bootstrap

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Setting up a new .NET application often involves extensive manual configuration, dependency injection setup, and middleware registration. This Skill streamlines the entire bootstrap process, allowing you to get a fully functional application with a single line of code.

Core Features & Use Cases

  • One-Line Setup: builder.Services.AddKoan() automatically discovers and registers all framework modules, data adapters, AI providers, and more.
  • "Reference = Intent": Simply add a NuGet package reference (e.g., for MongoDB or AI) and the functionality is automatically enabled, no manual Program.cs changes needed.
  • Auto-Registration for App Services: Use IKoanAutoRegistrar to register your application-specific services, ensuring they are discovered and initialized by the framework.
  • Boot Report Diagnostics: Get a detailed snapshot of all loaded modules, configurations, and potential warnings for easy debugging.
  • Use Case: Start a new web project, add Koan.Core, Koan.Web, and Koan.Data.Connector.Sqlite packages, and your Program.cs remains minimal while providing a full web API with data persistence.

Quick Start

To bootstrap your Koan application with all framework features, your Program.cs needs only these lines: using Koan.Core; var builder = WebApplication.CreateBuilder(args); builder.Services.AddKoan(); var app = builder.Build(); app.Run();

Frequently Asked Questions about koan-bootstrap

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

FAQPage Schema
How do I automatically configure dependency injection and middleware in a .NET application?

Auto-configure your app by calling `builder.Services.AddKoan()` in Program.cs. This single line discovers and registers all framework modules, data adapters, and services automatically, eliminating manual wiring of dependency injection and middleware setup.

Can I add NuGet packages like MongoDB or AI providers without modifying Program.cs?

Yes. With auto-registration, simply add NuGet package references—MongoDB, AI providers, or other Koan modules—and they're automatically discovered and enabled. No manual Program.cs changes required; reference itself signals intent to the framework.

How do I register my application-specific services to be auto-discovered during bootstrap?

Implement `IKoanAutoRegistrar` in your application services. The bootstrap process scans assemblies for these implementations, invokes Initialize(), and registers your services automatically alongside framework modules.

What information does the boot report provide for debugging startup issues?

The boot report diagnostic snapshot displays all loaded modules, configurations, and potential warnings. This reveals initialization state and issues, helping you troubleshoot boot failures and verify that framework modules loaded correctly.

Do I need to manually register data connectors or framework extensions in my application?

No. The auto-registration system eliminates manual registration. Add framework packages to your project, and the bootstrap process automatically discovers and initializes data connectors, extensions, and framework features without explicit configuration.

What's the minimal setup required to create a fully functional .NET web application?

A complete web API with data persistence requires only adding `Koan.Core`, `Koan.Web`, and data connector packages (like `Koan.Data.Connector.Sqlite`), then calling `AddKoan()` in Program.cs. All services, middleware, and configuration are auto-discovered and registered.