Consolidate agent governance under .agent directory

[2-Coatl]

Summary

• move the automation agent catalog from .github/agents into .agent/agents and add a root README that links planning, documentation, and executable agents
• update issue templates, README, and governance docs to point to the new .agent/agents location and align guidance for contributors
• tighten documentation alignment tests so templates, README, and the agent catalog assert the new structure and links to docs/scripts

Testing

• pytest docs/testing/test_documentation_alignment.py

---

Codex Task

[chatgpt-codex-connector]

💡 Codex Review

https://github.com/2-Coatl/IACT---project/blob/6c5c4eb8e25103c345be154a282f32020b28eb64/scripts/coding/ai/shared/env_loader.py#L22-L29
Fix env_loader root discovery

The newly added load_env_file() never reaches the repository’s real .env file. At lines 22‑24 you compute project_root = Path(__file__).parent.parent.parent.parent, which stops at the scripts/ directory, so the loader looks for scripts/.env. Because .env actually lives at the repo root, env_path.exists() is always false and nothing is loaded. As a result every invocation of get_llm_config_from_env() or verify_api_keys() runs with empty environment variables (even when .env is present), so the tool constantly reports missing API keys and cannot auto‑detect providers. Bump the traversal one level higher (parents[4]/.parent.parent.parent.parent.parent) or otherwise point to the repo root before appending .env so the loader can actually read the intended file.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".