hashicorp/terraform

GitHub
https://github.com/hashicorp/terraform

Terraform enables you to safely and predictably create, change, and improve infrastructure. It is a source-available tool that codifies APIs into declarative configuration files that can be shared amongst team members, treated as code, edited, reviewed, and versioned.

  • cloud
  • cloud-management
  • graph
  • infrastructure-as-code
  • terraform
Stars:
50.1k
Language:
Go
Default branch:
main
Last scored:
Overall

At a glance

Rank
#294 of 401
#34 of 40 Go repos
Checks passed
7 of 17
Full list below
Best set up for
Claude Code
Score 64.5
Needs most work for
Aider
Biggest fix: .aider.conf.yml (+14.1 pts)

What it has

What it's missing

What to fix first

Pick an AI agent

Showing fixes for Claude Code

  1. 1
    AGENTS.md / CLAUDE.md
    Add an AGENTS.md covering project goals, layout, setup commands, and conventions. Aim for 800+ chars of real guidance (not boilerplate).
    +13.2 pts
  2. 2
    Linter / formatter config
    Configure a linter/formatter (ESLint+Prettier, Biome, Ruff, rustfmt+clippy, golangci-lint) and commit the config.
    +7.9 pts
  3. 3
    Pre-commit / git hooks
    Set up pre-commit (.pre-commit-config.yaml), husky, or lefthook to run format+lint on every commit.
    +5.3 pts

Score for each AI agent

Each agent weighs the checks by its own docs. Under each score are its top three. How each agent is scored →

Claude Code
#287 of 401
64.5
  • ✗AGENTS.md / CLAUDE.md
  • ~Test suite
  • ✓Reproducible dev env
Devin
#261 of 401
63.7
  • ✓Reproducible dev env
  • ✓Dependency manifest
  • ~Test suite
Codex
#295 of 401
62.8
  • ✗AGENTS.md / CLAUDE.md
  • ✓README
  • ~Test suite
OpenHands
#261 of 401
60.7
  • ✓CI configuration
  • ✓Dependency manifest
  • ✓Reproducible dev env
Kimi Code CLI
#293 of 401
60.1
  • ✗AGENTS.md / CLAUDE.md
  • ~Test suite
  • ✓Dependency manifest
Gemini CLI
#282 of 401
57.9
  • ✗GEMINI.md
  • ✓README
  • ~Test suite
Pi
#320 of 401
56.4
  • ✗AGENTS.md / CLAUDE.md
  • ~Test suite
  • ✗Linter / formatter config
Cursor
#298 of 401
56.0
  • ✗Cursor rules (.cursor/rules)
  • ✓README
  • ✓Type configuration
Aider
#313 of 401
54.6
  • ✗.aider.conf.yml
  • ✗Linter / formatter config
  • ~Test suite

Does hashicorp/terraform have agent instructions?

An AGENTS.md (or CLAUDE.md) at the root tells AI coding agents how to build, test and work in the repo. A few agents also read a file of their own.

AGENTS.md / CLAUDE.md
None at the root (no AGENTS.md, CLAUDE.md, AGENT.md, .claude/CLAUDE.md or .claude/AGENTS.md)
Agent-specific files
None: no GEMINI.md, .cursor/rules, .openhands/setup.sh, .aider.conf.yml or .agents/skills
Repos that have one
23 of 40 Go repos · 221 of 401 repos on the leaderboard · See examples →
Get a starter AGENTS.md

From the files the checks found. Fill in the commands, then commit it at the root.

# AGENTS.md

Guidance for AI coding agents working in hashicorp/terraform. Terraform enables you to safely and predictably create, change, and improve infrastructure. Written mainly in Go.

## Where things are

- Dependencies are declared in `go.mod`.
- Test files are spread through the tree, e.g. `internal/addrs/action_test.go`.
- CI is defined in `.github/workflows`; read it for the exact install, lint and test steps.
- Common tasks are targets in `Makefile`.
- Follow the conventions in `.github/CONTRIBUTING.md`.

## Commands

<!-- Fill in the exact commands CI runs. -->
- Install: TODO
- Test: TODO
- Lint: TODO

All 17 checks · 7 passed

No .agents/skills/<name>/SKILL.md
No agent instructions file found
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
11 GitHub Actions workflows
No .cursor/rules/*.mdc or .cursorrules
Manifest present
2 env artifacts (Makefile, Dockerfile)
GEMINI.md· 0% pass
No GEMINI.md at repo root
License file· 100% pass
License present
No linter/formatter config found
No .openhands/setup.sh
No pre-commit / husky / lefthook found
README· 100% pass
README detailed (3,934 characters)
Manageable size· 20% pass
5260 files — very large
Test suite· 70% pass
Test files detected (internal/addrs/action_test.go)
Type configuration· 100% pass
Typed language (Go)

How hashicorp/terraform compares

vs leaderboard average
7.2 pts below
Average 66.8
vs Go average
11.4 pts below
Average 71.0
Stars among Go repos
#16 of 40

Missing here, and how many repos have it

  • Linter / formatter config · passed by 65% of leaderboard repos, 70% of Go repos
  • Pre-commit / git hooks · passed by 29% of leaderboard repos, 13% of Go repos
  • Skills (.agents/skills) · passed by 17% of leaderboard repos, 10% of Go repos

Passes checks most repos miss

  • Reproducible dev env · only 22% of repos pass it

One fix for the most agents: Linter / formatter config would raise the score for all 9 agents, by up to 14.1 points.

Similar repos

Same language and host as this repo, closest in overall score.

All Go repos →

Same topics, any language

Repos tagged with the same GitHub topics, most shared first.

Add a badge to your README

Paste this at the top of the README. It shows the score, and links back to this page.

Agent friendly score for github/hashicorp/terraform
[![Agent Friendly](https://agentfriendlycode.com/api/badge/github/hashicorp/terraform.svg)](https://agentfriendlycode.com/repo/github/hashicorp/terraform)

Check the score on every pull request

A GitHub Action posts one comment per pull request with how the score changed and why.