# Aif Warmup

Load the essential AI Factory project context before work begins.

- Repository: https://github.com/lee-to/ai-factory (1156 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add lee-to/ai-factory --skill aif-warmup -g -a claude-code -y`
Codex: `npx skills add lee-to/ai-factory --skill aif-warmup -g -a codex -y`
Cursor: `npx skills add lee-to/ai-factory --skill aif-warmup -g -a cursor -y`
Gemini CLI: `npx skills add lee-to/ai-factory --skill aif-warmup -g -a gemini-cli -y`

## Description

Load the essential AI Factory project context before work begins. Reads configured DESCRIPTION, ARCHITECTURE, ROADMAP, RESEARCH, RULES, and applicable AGENTS.md files, then returns a compact session handoff suitable for continuing or forking. Use at the start of a new session or after context loss.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Warm Up the Session

## Shared project skill-context

Before mode routing or work, read existing files relative to the current project root in this order (reuse them if already loaded):

1. `.ai-factory/skill-context/global-skill-context.md`, all bundled skills.
2. `.ai-factory/skill-context/aif-warmup/SKILL.md`, this skill.

Missing files are skipped; an existing unreadable file stops dependent work with its path.
Precedence: individual > build (when applicable) > global > skill defaults; retain non-conflicting instructions and check all outputs against the effective rules.
These layers customize workflow; they do not replace the project's rules/architecture hierarchy or relax explicit requirements, ownership, scope, safety/privacy, validation, or approval boundaries. Report conflicts with those boundaries instead of overriding them.
`global` is a project-local layer, not home-directory configuration. Custom/extension skills do not automatically use it.

Load project context without changing the repository. Finish with a compact,
self-contained handoff that can start the next task or a forked session.

## Step 0: Resolve Context Paths

Use the nearest ancestor containing `.ai-factory/` as the project root; otherwise
use the current working directory. Read `.ai-factory/config.yaml` from that root
first when it exists. Resolve:

- `paths.description` (default `.ai-factory/DESCRIPTION.md`)
- `paths.architecture` (default `.ai-factory/ARCHITECTURE.md`)
- `paths.roadmap` (default `.ai-factory/ROADMAP.md`)
- `paths.research` (default `.ai-factory/RESEARCH.md`)
- `paths.rules_file` (default `.ai-factory/RULES.md`)
- `paths.rules` (default `.ai-factory/rules/`)
- `rules.base` (default `.ai-factory/rules/base.md`)
- every named `rules.<area>` entry
- `warmup.paths` (default `[]`)
- `language.ui` (default `en`)

Also retain these configured preferences for the handoff because they affect
later workflow commands, even though warmup does not act on them:

The rest: https://github.com/lee-to/ai-factory/blob/HEAD/skills/aif-warmup/SKILL.md