⚠️ This is a brand new repo, the structure and contents may change frequently as AI Tooling and standards evolve.

⚠️ As with all AI tools, careful human review is needed.

A repository of Lola modules for Ansible automation development following Red Hat Communities of Practice (CoP) automation good practices.

This repository provides AI assistant skills and commands for developing Ansible content that follows industry best practices. Using the Lola package manager, you can install these modules to any AI coding assistant (Claude Code, Cursor, Gemini CLI, OpenCode, etc.) and get expert guidance for creating, reviewing, and improving Ansible automation.

# Install Lola package manager
pip install lola-ai

# Install this repository's marketplace
lola market add ansible-content https://raw.githubusercontent.com/ansible-community/ai-forge/main/lola-market.yml

### alternatively, you can install from a local file:
### lola market add ansible-content ./lola-market.yml

## Clone the repository
git clone https://github.com/ansible-community/ai-forge.git

## Install all modules to Claude Code
lola install ansible-collection-standards -a claude-code
lola install ansible-role -a claude-code
lola install ansible-collection-sdlc -a claude-code

# Or install directly from GitHub
lola mod add https://github.com/ansible-community/ai-forge/ansible-collection-standards
lola mod add https://github.com/ansible-community/ai-forge/ansible-role
lola mod add https://github.com/ansible-community/ai-forge/ansible-collection-sdlc
lola install ansible-collection-standards -a claude-code
lola install ansible-role -a claude-code
lola install ansible-collection-sdlc -a claude-code

# Or install globally (available in all projects)
lola install ansible-collection-standards -a claude-code ~
lola install ansible-role -a claude-code ~
lola install ansible-collection-sdlc -a claude-code ~

To manage the modules recommended for your project declaratively:

1. Install lola and this repository's marketplace, as described in the quickstart section.

2. Create a .lola-req file in your project. For example:

   # .lola-req - AI context modules for this project
   
   # Modules from https://raw.githubusercontent.com/ansible-community/ai-forge/main/lola-market.yml
   @ansible-content/ai-forge/ansible-collection-sdlc
   @ansible-content/ai-forge/ansible-collection-standards
   

3. Install the modules if needed, lola sync

Standards and guidelines compliance, scaffolding. Includes the ansible-zen skill and commands for CoP review, collection scaffolding, and inclusion review.

Full documentation

Role scaffolding tools with interactive builders for creating CoP-compliant roles.

Full documentation

Full lifecycle: commits, PRs, releases, tests. Includes skills for changelog fragments, conventional commits, PR reviews, releases, testing, and SonarCloud integration.

Skills:

• changelog-fragment - Create and update changelog fragments
• commit - Conventional commits with FQCN scopes
• create-branch - Create feature branches following conventions
• create-pr - Create draft PRs with pre-flight checks and validation
• pr-review - PR review against Ansible collection standards
• release - Guided collection release process
• remove-deprecations - Find and remove overdue deprecations
• run-tests - Run and write tests using ansible-test
• python-virtual-env - Create or validate a project-local Python virtual environment for local pip installs and tooling
• sonarcloud-remediation - Fetch, analyze, and fix SonarCloud issues with end-to-end automation
• next-release - Calculate next patch/minor/major versions for version_added tags
• current-release - Fetch current release version (helper)
• get-branch-changes - Determine merge-base and changed files (helper)
• get-pr-action-results - Get GitHub Actions/GitLab CI results and analyze failures (helper)
• get-pr-number - Find PR number for branch (helper)
• get-upstream-info - Determine upstream repository info (helper)

Commands:

• /setup-python-venv - Set up or validate a project-local Python virtual environment

Full documentation

Ansible content authoring and testing: module development, playbook/role writing, unit and integration tests, Molecule scenarios.

Skills:

• write-module - Scaffold and review Python-based Ansible modules
• write-content - Write playbooks, tasks, handlers, templates, and variables following CoP good practices
• write-module-tests - Write unit (pytest) and integration (ansible-test) tests for modules
• write-content-tests - Write Molecule scenarios for functional testing of roles and playbooks

Full documentation

See SKILLS.md for the complete auto-generated index of all available skills.

Lola is a universal AI package manager that allows you to write skills and commands once, then install them to any AI assistant. Think of it as DNF/YUM for AI tools.

We welcome contributions from the community. See CONTRIBUTING.md for detailed instructions on:

• Setting up pre-commit hooks and linting
• Adding new skills or commands
• Making skills available via Lola

This project follows the Red Hat Communities of Practice contributing guidelines.

Open an issue on GitHub for bug reports, feature requests, or rule updates.

GPL-3.0-or-later