---
name: install-md
description: |
  Create install.md files optimized for AI agent execution. Use for ANY question
  about install.md files or request to create/review installation documentation
  for autonomous agent use.
triggers:
  # Direct invocations
  - install.md
  - /install-md
  - /install
  # Create
  - create install.md
  - write install.md
  - make install.md
  - add install.md
  - draft install.md
  # Edit / update
  - edit install.md
  - update install.md
  - improve install.md
  - fix install.md
  - review install.md
  # Alternative names
  - installation doc
  - installation guide
  - installation file
  - setup guide
  - setup doc
  - install file
  - install guide
  # Agent-specific context
  - agent installation
  - ai installation
  - autonomous install
  - agent setup
  - ai setup
  - agent-executable install
  - machine-readable install
  # Questions and capability discovery
  - how do I write install.md
  - how do I create install.md
  - what should install.md contain
  - what is install.md
  - how does install.md work
  - can I create install.md
  - install.md format
  - install.md spec
  - install.md best practices
  - install.md for agents
  - installation for agents
  - make installation agent-friendly
---

# install-md

Open `@references/guide.md` and follow it. Do not proceed without it.

Create install.md files that AI agents can execute autonomously. The output enables agents to install software without human intervention.

The guide contains:
- Spec requirements for autonomous execution
- Drafting process with validation gates
- 12 eval checks with pass criteria
- Failure modes from real-world friction