Managing Modules

Modules are markdown files containing specific instructions for AI assistants.

Module Types

Global Modules - Stored in modules/core/ - Shared across all organizations by default - Organizations can override with custom versions

Organization Overrides - Stored in overrides/<org-id>/ - Organization-specific versions of global modules - Take precedence over global modules

Organization-Specific Modules - Custom modules unique to one organization - Not based on any global template

Modules List Page

URL: /modules

Displays all global modules with: - Module name - Number of organizations using the module - Number of overrides - Last modified date - Action buttons (View, Edit, Versions)

Create Module button creates a new global module (admin only).

Module Detail View

Shows: - Module content (rendered markdown) - List of organizations using this module - Organizations with overrides - Version history (if version control enabled)

Edit Module Page

Markdown editor for module content.

Edit affects: - Global edit: All organizations using the module (unless they have overrides) - Override edit: Only the specific organization

Save creates: - New version snapshot (if version control enabled) - "Stale" badges on existing overrides

Module Versions

URL: /modules/<name>/versions

Lists all versions with: - Timestamp - Author - Commit message - View button to see that version's content

Compare View

URL: /organization/<org-id>/compare/<module-name>

Side-by-side diff showing: - Left: Global module version - Right: Organization override version - Highlighted differences

Last updated: February 2026