core-workflows git:20261009.b6bc310B

Immutable. This exact content never changes and is served at /api/v1/blob/c20162955c220aec.

---
type: Playbook
title: Core Workflows
description: Use when you need to know how ai-rulez loads configuration, generates outputs, runs CRUD subcommands, validates, or serves MCP, and which internal package owns each step, before tracing or changing one of those flows.
x-ai-rulez:
  kind: skill
  id: core-workflows
  metadata:
    priority: high
    targets:
      - CLAUDE.md
      - .cursor/rules/*
      - GEMINI.md
---

## Core Workflows

1. Configuration loading reads `.ai-rulez/config.toml` via `internal/config`, scans content trees, and resolves includes.
2. Generation uses declarative specs in `internal/generator/providers/builtin/` plus specialized generators in `internal/generator/presets`, with `internal/templates` rendering outputs and `internal/gitignore` updating ignore rules.
3. CRUD subcommands in `cmd/commands` call `internal/crud` to create or update rules, context, skills, agents, domains, profiles, and includes.
4. Validation runs through `internal/config` (schema and structure) and `internal/lint` (content findings such as AR401).
5. MCP handlers in `internal/mcp` expose read, CRUD, generate, and validate operations to external tools.