Skip to main content

0009: Project Rename to Citadel

Date: 2025-08-11

Status: Accepted

Context

The project was initially named "Citadel". The term "ERP" (Enterprise Resource Planning) is strongly associated with monolithic, legacy systems. This does not accurately reflect the project's modern, composable, microservice-based architecture. The goal is to adopt a name that better represents a strong, foundational platform upon which other applications and services can be built.

Decision

We will rename the project from "Citadel" to "Castlecraft Citadel".

  • The official public-facing name will be Castlecraft Citadel.
  • The internal codename and primary directory name will be citadel.
  • All instances of Citadel and citadel in the codebase, documentation, and configuration will be replaced with Citadel and citadel respectively.

Consequences

Positive

  • The new name is more evocative and memorable, aligning better with the "Castlecraft" brand.
  • It accurately reflects the project's architectural vision of providing a secure, foundational core of services.
  • It sheds the legacy connotations of the term "ERP".

Negative

  • This requires a significant, one-time refactoring effort across the entire codebase, CI/CD pipelines, and GitLab project settings.
  • All developers will need to update their local clones and any bookmarks pointing to the old GitLab project URL.