aif-rules

name	aif-rules
description	Add project-specific rules and conventions to .ai-factory/RULES.md. Each invocation appends new rules. These rules are automatically loaded by $aif-implement before execution. Use when user says "add rule", "remember this", "convention", or "always do X".
argument-hint	[rule text or topic]
allowed-tools	Read Write Edit Glob Grep AskUserQuestion Questions
disable-model-invocation	true

AI Factory Rules - Project Conventions

Add short, actionable rules and conventions for the current project. Rules are saved to .ai-factory/RULES.md and automatically loaded by $aif-implement before task execution.

Workflow

Step 1: Determine Mode

Check $ARGUMENTS:
├── Has text? → Mode A: Direct add
└── No arguments? → Mode B: Interactive

Mode A: Direct Add

User provided rule text as argument:

$aif-rules Always use DTO classes instead of arrays

→ Skip to Step 2 with the provided text as the rule.

Mode B: Interactive

No arguments provided:

$aif-rules

→ Ask via AskUserQuestion:

What rule or convention would you like to add?

Examples:
- Always use DTO classes instead of arrays for data transfer
- Routes must use kebab-case
- All database queries go through repository classes
- Never use raw SQL, always use the query builder
- Log every external API call with request/response

> ___

Step 2: Read or Create RULES.md

Check if .ai-factory/RULES.md exists:

Glob: .ai-factory/RULES.md

If file does NOT exist → create it with the header and first rule:

# Project Rules

> Short, actionable rules and conventions for this project. Loaded automatically by $aif-implement.

## Rules

- [new rule here]

If file exists → read it, then append the new rule at the end of the rules list.

Step 3: Write Rule

Use Edit to append the new rule as a - list item at the end of the ## Rules section.

Formatting rules:

• Each rule is a single - line
• Keep rules short and actionable (one sentence)
• No categories, headers, or sub-lists — flat list only
• No duplicates — if rule already exists (same meaning), tell user and skip
• If user provides multiple rules at once (separated by newlines or semicolons), add each as a separate line

Step 4: Confirm

✅ Rule added to .ai-factory/RULES.md:

- [the rule]

Total rules: [count]

Rules

1. One rule per line — flat list, no nesting
2. No categories — keep it simple, no headers inside the rules section
3. No duplicates — check for existing rules with the same meaning before adding
4. Actionable language — rules should be clear directives ("Always...", "Never...", "Use...", "Routes must...")
5. RULES.md location — always .ai-factory/RULES.md, create .ai-factory/ directory if needed