Skip to content
Cratis

Kit Directory Name

Context and Problem Statement

Section titled “Context and Problem Statement”

The kit needed a directory name for storing runtime files, prompts, and skills. Multiple names were being used inconsistently:

  • .cratis-build-kit/ — Used by the original installer
  • .build-kit-cratis-csharp/ — Used by prompts and skills
  • .build-kit/ — Used by some documentation

This inconsistency caused 13 defects (see Issue #9 D1, D2, D10) where the installer wrote to one directory but prompts read from another.

Decision Outcome

Section titled “Decision Outcome”

The kit directory must be .build-kit (not .cratis-build-kit or .build-kit-cratis-csharp).

Rationale

Section titled “Rationale”

  1. Platform Contract — The official Eventmodelers platform (Nebulit-GmbH/Eventmodelers-Build-Kits) uses .build-kit as the only valid kit directory name. This is hardcoded in cli.js at line 44: kitDirName: '.build-kit'.

  2. CLI Recognition — The upstream CLI’s run, status, and uninstall commands look for .build-kit specifically. Using any other name makes the installation invisible to the platform CLI.

  3. Simplicity — .build-kit is shorter, clearer, and follows the platform’s convention without unnecessary prefixes.

  4. Consistency — All build kits (Node, Supabase, Cratis C#, etc.) use the same directory name, making the platform predictable.

Consequences

Section titled “Consequences”

Positive

Section titled “Positive”
  • ✅ Installation is recognized by npx @eventmodelers/cli status
  • ✅ All prompts and skills use the same directory name
  • ✅ Platform CLI commands work correctly
  • ✅ Documentation and code are consistent

Negative

Section titled “Negative”
  • ⚠️ Requires updating all references from .cratis-build-kit to .build-kit
  • ⚠️ Requires updating all prompts and skills that reference the kit directory
  • ⚠️ Existing installations need to be migrated (manual process)

Status

Section titled “Status”

Accepted — The installer has been updated to use .build-kit, and all prompts and skills now reference this directory name.

References

Section titled “References”