Configuration

MeowKit is configured through several files:

CLAUDE.md

The entry point Claude reads at session start. Contains:

• Philosophy and core principles
• Workflow phases (Phase 0-6)
• Agent roster with ownership
• Command index
• Model routing table
• Mode definitions
• Memory system description
• Security rules summary

Customize: Add project-specific conventions, adjust mode preferences. Do not modify: Security rules, gate definitions, agent roster structure.

.meowkit.config.json

Project-specific configuration generated by create-meowkit:

{
  "$schema": "https://meowkit.dev/schema/config.json",
  "version": "1.0.0",
  "project": { "name": "my-project", "stack": ["node", "react"] },
  "team": { "size": "solo" },
  "tool": { "primary": "claude-code" },
  "mode": { "default": "balanced" },
  "features": { "costTracking": true, "memory": true }
}

.claude/settings.json

Hook registrations and permission allowlists. See Hooks for details.

Rules

10 rule files in .claude/rules/, loaded in priority order:

Priority	Rule	Purpose
1	security-rules.md	Blocked patterns: secrets, any, SQL injection
2	injection-rules.md	10 prompt injection defense rules
3	gate-rules.md	Gate 1 + Gate 2 hard stops
4	tdd-rules.md	TDD enforcement (7 rules)
5	naming-rules.md	Per-platform naming conventions
6	development-rules.md	File management, code quality, git safety
7	context-ordering-rules.md	Long content first, context before constraint
8	model-selection-rules.md	Task type → model tier routing
9	output-format-rules.md	Response structure
10	orchestration-rules.md	Subagent delegation, file ownership

Modes

Mode	Gates	Security	Use for
default	Both	Full	Most work
strict	Both (no WARN)	Every file	Production, auth, payments
fast	Gate 1 only	BLOCK only	Prototypes
architect	N/A	N/A	Design-only sessions
audit	N/A	Comprehensive	Security reviews
document	N/A	N/A	Doc sprints
cost-saver	Gate 1	BLOCK only	High-volume routine