Foreman AI Harness

A lola module for the Foreman community. This repository curates the resources needed to effectively use AI coding agents across the Foreman ecosystem.

What This Module Provides

• Skills - Reusable AI agent skills tailored to Foreman development workflows
• Agents - Specialized agent configurations for Foreman projects
• Development Documentation - References for common development patterns, commands, and workflows across Foreman projects
• Architecture and Design Documentation - Architectural analysis and design documents for Foreman core, Katello, Smart Proxy, the installer, and related components

Installation

Using Lola

Install lola first, then add and install this module:

# Add the module to your lola registry
lola mod add https://github.com/theforeman/foreman-ai-harness.git

# Install to your AI assistant (e.g. Claude Code)
lola install foreman-dev-skills -a claude-code

See Installation Scope below for choosing between project and user scope.

From a Local Clone

git clone https://github.com/theforeman/foreman-ai-harness.git
cd foreman-ai-harness
lola mod add ./foreman-dev-skills
lola install foreman-dev-skills -a claude-code

Declarative Installation

Add this module to a .lola-req file in any project to install it automatically with lola sync:

https://github.com/theforeman/foreman-ai-harness.git

Then run:

lola sync

Use lola sync --dry-run to preview what would be installed.

Installation Scope

Lola supports two installation scopes that control where skills are available:

Project Scope (default)

lola install foreman-dev-skills -a claude-code

Skills are installed into the current project directory (e.g. .claude/skills/). Use project scope when:

• You only need the skills in a specific repository
• You want skills versioned alongside the project (the installed files appear in the project tree)
• Different projects need different skill versions

User Scope

lola install foreman-dev-skills -a claude-code --scope user

Skills are installed to your user-level assistant configuration (e.g. ~/.claude/skills/). Use user scope when:

• You want the skills available across all your projects without installing per-repo
• You work on many Foreman repositories and want a single shared set of skills
• You don’t want skill files showing up in project directories

Switching Scope

To move an installation from one scope to another, uninstall from the old scope and reinstall to the new one:

lola uninstall foreman-dev-skills --scope project
lola install foreman-dev-skills -a claude-code --scope user

Updating

When new skills or updates are released in this repository, update your local copy:

# Re-fetch the module source from git
lola mod update foreman-dev-skills