CLAUDE.md - Contributor Guide

CLAUDE.md - Contributor Guide

**For End Users:** See [README.md](README.md) for installation and usage.

**This file** is for contributors, maintainers, and skill developers.

What This Is

This repository contains a **Claude Code skill** - executable documentation that Claude loads to provide Terraform/OpenTofu expertise. Think of it as:

undefined

Repository Structure

terraform-skill/
├── .claude-plugin/
│   └── marketplace.json                  # Marketplace and plugin metadata
├── SKILL.md                              # Core skill file (~524 lines)
├── references/                           # Reference files (progressive disclosure)
│   ├── ci-cd-workflows.md                # CI/CD templates (~473 lines)
│   ├── code-patterns.md                  # Code patterns & modern features (~859 lines)
│   ├── module-patterns.md                # Module best practices (~1,126 lines)
│   ├── quick-reference.md                # Command cheat sheets (~600 lines)
│   ├── security-compliance.md            # Security guidance (~470 lines)
│   └── testing-frameworks.md             # Testing guides (~563 lines)
├── README.md                             # For GitHub/marketplace users
├── CLAUDE.md                             # For contributors (YOU ARE HERE)
└── LICENSE                               # Apache 2.0

File Roles

File	Audience	Purpose
.claude-plugin/marketplace.json	Claude Code	Marketplace and plugin metadata
SKILL.md	Claude Code	Core skill (~524 lines, ~4.4K tokens)
references/*.md	Claude Code	Reference files loaded on demand (6 files, ~26K tokens)
README.md	End users	Installation, usage examples, what it covers
CLAUDE.md	Contributors	Development guidelines, architecture decisions
LICENSE	Everyone	Apache 2.0 legal terms

How Claude Skills Work

Progressive Disclosure

User: "Create a Terraform module with tests"
       ↓
Claude: Scans skill metadata (~100 tokens)
       ↓
Claude: "This matches terraform-skill activation triggers"
       ↓
Claude: Loads full SKILL.md (~4,400 tokens)
       ↓
Claude: Applies testing framework decision matrix
       ↓
Response: Code following best practices

**Key Insight:** Skills only load when relevant, minimizing token usage.

Token Budget

undefined