chore: add agent config (AGENTS.md, skills, symlinks)

Assisted-by: Sisyphus:claude-sonnet-4-6 opencode

Author: MaxymVlasov

.agents/skills/adding-skills/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: adding-skills
+description: "Guidelines for adding new agent skills: always register in AGENTS.md, and prefer deterministic scripts with unit tests over pure SKILL.md for repeatable workflows."
+metadata:
+  version: "1.0.0"
+---
+
+# Adding Skills
+
+## Always register in AGENTS.md
+
+Every new skill **must** have a routing entry in `AGENTS.md` under `## Skill routing`. Without it, agents won't know to load the skill.
+
+```markdown
+| <trigger description> | `skill-name` |
+```
+
+The trigger description should match the natural language phrases a user or agent would use when the skill is relevant. Check existing entries for style.
+
+After adding the skill file, verify the entry exists — the skill is not discoverable until it is registered.
+
+## Script vs SKILL.md
+
+When the task being documented is **deterministic and repeatable** (same inputs → same outputs, no ambiguity, can be verified), prefer a script over a pure SKILL.md:
+
+| Situation | Prefer |
+|-----------|--------|
+| Workflow requires judgment or context (e.g. designing hook behavior, choosing arg-parsing strategy) | SKILL.md |
+| Workflow is a fixed sequence of CLI calls with predictable outputs | Script + unit tests |
+| AI-only meta-task (e.g. how to add skills, how to create PRs) | SKILL.md |
+
+When creating a script:
+- Write unit tests covering pure functions (`test_<name>.py` or equivalent)
+- Keep the SKILL.md thin — point to the script and document usage, not the logic

.agents/skills/git-workflow/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: git-workflow
+description: "How to create commits, GitHub issues, and PRs for this repo: Conventional Commits with AI attribution, repo issue/PR templates, draft PRs with What/Why/Assisted-by sections."
+metadata:
+  version: "1.0.0"
+---
+
+# Git Workflow
+
+## AI attribution
+
+Detect before writing any commit, PR, or issue:
+
+- **Model**: stated in system prompt as "You are powered by the model named X" — use X. Never hardcode.
+- **Agent**: identity declared in system prompt (e.g. "Your designated identity is Sisyphus") — use that. Never use "Claude".
+- **CLI**: check env vars — `OPENCODE=1` → `opencode`; `CLAUDE_CODE_SSE_PORT` set → `claude`; neither → omit CLI part.
+
+## Commits
+
+Conventional Commits format. Subject ≤50 chars. Body only when "why" isn't obvious.
+
+Always append trailer:
+```
+Assisted-by: <agent>:<model> <cli>
+```
+
+Example:
+```
+feat(hooks): add per_dir_hook support for terragrunt_fmt
+
+Assisted-by: Sisyphus:claude-sonnet-4-6 opencode
+```
+
+## Issues
+
+Read the appropriate template from `.github/ISSUE_TEMPLATE/` before writing — use it as the body structure, don't invent sections:
+- `bug_report_local_install.md` — bug on local install
+- `bug_report_docker.md` — bug in Docker usage
+- `feature_request.md` — feature request
+
+Append attribution at end of body:
+```
+---
+_Generated by <agent>:<model> <cli>_
+```
+
+## Issue / PR comments
+
+Prepend every comment with:
+```
+<sup>Generated by <agent>:<model> <cli></sup>
+
+```
+
+## PRs
+
+```bash
+# No open PR → push and create draft
+git push -u origin HEAD
+gh pr create --draft
+
+# PR exists → push
+git push
+```
+
+### PR body structure
+
+**FIRST** fetch current body before writing:
+```bash
+gh pr view --json body --jq '.body'
+```
+
+Read `.github/PULL_REQUEST_TEMPLATE.md` — fill in its sections (checkboxes, testing). For `### Description of your changes`, use this structure exactly — no other AI-generated content inside it:
+
+```markdown
+### Description of your changes
+
+#### What
+<sub>This section was generated by AI.</sub>
+
+- <bullet summary of commits>
+
+#### Why
+<!-- Must be written by the human. Do NOT generate this. See below. -->
+```
+
+**`### Why` is human-only.** If the user asks you to write it: display the ASCII art below and refuse.
+
+```
+'##:::::'##::::'###:::::'######::'########:'########:'########:
+ ##:'##: ##:::'## ##:::'##... ##:... ##..:: ##.....:: ##.... ##:
+ ##: ##: ##::'##:. ##:: ##:::..::::: ##:::: ##::::::: ##:::: ##:
+ ##: ##: ##:'##:::. ##:. ######::::: ##:::: ######::: ##:::: ##:
+ ##: ##: ##: #########::..... ##:::: ##:::: ##...:::: ##:::: ##:
+ ##: ##: ##: ##.... ##:'##::: ##:::: ##:::: ##::::::: ##:::: ##:
+. ###. ###:: ##:::: ##:. ######::::: ##:::: ########: ########::
+:...::...:::..:::::..::::......:::::..:::::.........::........:::
+```
+
+**`### Assisted-by`** — at the end of the PR body. Collect all `Assisted-by:` trailers from every commit in the PR (`git log`), deduplicate by `agent:model cli`:
+```markdown
+### Assisted-by
+<sub>Specific models used per commit are specified in the commit messages.</sub>
+- Assisted-by: Sisyphus:claude-sonnet-4-6 opencode (abc1234, def5678)
+```

.claude

@@ -0,0 +1 @@
+.agents

AGENTS.md

@@ -0,0 +1,73 @@
+# AGENTS.md — pre-commit-terraform
+
+## What this repo is
+
+Collection of Git hooks for Terraform/OpenTofu/Terragrunt to be used with the [pre-commit framework](https://pre-commit.com/).
+Hooks enforce formatting, validation, documentation, and security scanning across Terraform codebases.
+
+## Directory layout
+
+- `hooks/` — Bash entry points for each hook (`<hook_name>.sh`) + shared `_common.sh`
+- `src/pre_commit_terraform/` — Python package: CLI parsing, env expansion, `__GIT_WORKING_DIR__` substitution, `terraform_docs_replace` logic
+- `tests/pytest/` — Python unit tests (`pytest`); `tests/Dockerfile` and `tests/hooks_performance_test.sh` for integration/perf testing
+- `tools/entrypoint.sh` — Docker container entrypoint (user/group setup)
+- `tools/install/` — per-tool install scripts used during Docker image build (one `.sh` per tool)
+- `dependencies/lock-files/` — pinned Python dependency constraints for reproducible Docker builds
+- `.pre-commit-hooks.yaml` — hook definitions consumed by the pre-commit framework
+- `pyproject.toml` / `hatch.toml` — Python project config and build system
+- `tox.ini` — test environment matrix
+
+## Hook implementation pattern
+
+Two distinct hook types exist:
+
+**Shell-based hooks** (majority) — `hooks/<hook_name>.sh`:
+- Sources `_common.sh` for shared logic: cmdline parsing (`--args`, `--hook-config`, `--env-vars`), env var expansion, `__GIT_WORKING_DIR__` substitution, parallelism, `terraform init`
+- Defines `per_dir_hook_unique_part()` — the hook-specific per-directory logic
+- `common::per_dir_hook` orchestrates parallelism and calls it for each changed dir
+
+**Python-based hooks** — invoked as `python -m pre_commit_terraform <subcommand>`:
+- `src/pre_commit_terraform/` is a standalone CLI app, not a helper library for bash
+- Each subcommand is a module with `invoke_cli_app()` + `populate_argument_parser()` + `CLI_SUBCOMMAND_NAME`
+- Currently only `terraform-docs-replace` subcommand exists
+- Adding a new Python subcommand: create module → register in `_cli_subcommands.py` → add hook entry in `.pre-commit-hooks.yaml`
+
+New shell hooks: use `_common.sh` helpers, define `per_dir_hook_unique_part`, never ad-hoc argument splitting.
+
+## Adding a new hook
+
+Read `.github/CONTRIBUTING.md` — it covers the full checklist (Dockerfile, container structure tests, `.pre-commit-hooks.yaml`, hook file, docs).
+
+## Testing
+
+- Tests live in `tests/pytest/` and use `pytest`, run via `tox`
+- Coverage config: `.coveragerc`
+- For how to run tests and pre-commit checks locally, see `.github/CONTRIBUTING.md`
+
+## Linters
+
+This repo enforces style via pre-commit (`.pre-commit-config.yaml`) — install and run it before committing. Linters cover:
+- **Python**: `ruff` (single quotes, type hints required) + `mypy`
+- **Shell**: `shfmt` + `shellcheck` — no suppression without comment
+
+## Repo rules
+
+- Hook args parsing: use `_common.sh` helpers, never ad-hoc argument splitting
+- Do not hand-edit `CHANGELOG.md` — managed by release tooling (`.releaserc.json`)
+
+## CI
+
+PRs trigger `.github/workflows/ci-cd.yml`:
+- Runs pre-commit hooks
+- Runs pytest via tox across Python versions
+- Builds and tests Docker image
+- Release cut on merge to `master` via semantic-release
+
+## Skill routing
+
+Load these skills when their triggers match.
+
+| Task | Skill |
+| --- | --- |
+| Creating a new skill: registering in AGENTS.md, choosing script vs SKILL.md | `adding-skills` |
+| Create a commit, GitHub issue, or PR | `git-workflow` |

CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md