# Ansible Development Guidelines

> Objective: Define standards for writing idempotent, secure, and maintainable Ansible playbooks and roles.

::: tip Source File
View the full rule: [`.agent/rules/ansible.md`](https://github.com/snowdreamtech/template/blob/main/.agent/rules/ansible.md)
:::

## Sections

- 1. Idempotency
- 1. Structure & Organization
- 1. Variables & Secrets
- 1. Naming & Style
- 1. Conditional Logic (Type Safety)
- 1. Execution Safety
- 1. File & Template Operations
- 1. Error Handling & Verification
- 1. Tags & Always Tag
- 1. Cross-Platform & macOS Compatibility
- 1. Delivery & Maintenance
- 1. Testing & Linting
- 1. App Development Standards (Multi-Distribution)
- 1. Scenario Design Patterns
- 1. Container Volume Configuration (Cross-Platform)
- 1. Shell Script Standards (POSIX Compatibility)
- 1. Windows Platform Standards
