From dbd37a1e83d95a4a7792a40ca94069d9ee652fdd Mon Sep 17 00:00:00 2001 From: Daniele Martinoli Date: Tue, 16 Jun 2026 17:36:52 +0200 Subject: [PATCH] Renamed CLAUDE.md to AGENTS.md --- .../agentic-contribution-skill/SKILL.md | 6 +-- .../docs/examples.md | 6 +-- .claude/skills/collection-compliance/SKILL.md | 4 +- .claude/skills/create-collection/SKILL.md | 4 +- .github/gemini-review-prompt.md | 2 +- .github/pull_request_template.md | 4 +- .github/workflows/README.md | 4 +- .github/workflows/skill-code-review.yml | 8 ++-- CLAUDE.md | 8 ++-- COLLECTION_SPEC.md | 12 ++--- CONTRIBUTING.md | 6 +-- FEDERATION_REQUEST_GUIDE.md | 2 +- FEDERATION_REVIEW_GUIDE.md | 6 +-- README.md | 2 +- SKILL_DESIGN_PRINCIPLES.md | 14 +++--- ocp-admin/.catalog/collection.json | 2 +- ocp-admin/.catalog/collection.yaml | 4 +- ocp-admin/.catalog/deploy_and_use.md | 2 +- ocp-admin/.catalog/mcp_section.md | 2 +- ocp-admin/{CLAUDE.md => AGENTS.md} | 0 rh-ai-engineer/.catalog/collection.json | 2 +- rh-ai-engineer/.catalog/collection.yaml | 4 +- rh-ai-engineer/.catalog/deploy_and_use.md | 2 +- rh-ai-engineer/.catalog/mcp_section.md | 2 +- rh-ai-engineer/{CLAUDE.md => AGENTS.md} | 0 rh-automation/.catalog/collection.json | 26 +++++----- rh-automation/.catalog/collection.yaml | 40 ++++++++-------- rh-automation/.catalog/deploy_and_use.md | 2 +- rh-automation/.catalog/mcp_section.md | 2 +- rh-automation/{CLAUDE.md => AGENTS.md} | 0 rh-basic/.catalog/collection.yaml | 2 +- rh-basic/.catalog/deploy_and_use.md | 2 +- rh-basic/.catalog/documentation_section.md | 2 +- rh-basic/.catalog/mcp_section.md | 2 +- rh-basic/.catalog/security_model.md | 2 +- rh-basic/{CLAUDE.md => AGENTS.md} | 0 rh-basic/README.md | 2 +- rh-developer/.catalog/collection.yaml | 2 +- rh-developer/.catalog/deploy_and_use.md | 2 +- .../.catalog/documentation_section.md | 4 +- rh-developer/.catalog/mcp_section.md | 2 +- rh-developer/.catalog/security_model.md | 2 +- rh-developer/{CLAUDE.md => AGENTS.md} | 0 rh-sre/.catalog/collection.yaml | 2 +- rh-sre/.catalog/deploy_and_use.md | 2 +- rh-sre/.catalog/documentation_section.md | 4 +- rh-sre/.catalog/mcp_section.md | 2 +- rh-sre/.catalog/security_model.md | 2 +- rh-sre/{CLAUDE.md => AGENTS.md} | 0 rh-virt/.catalog/collection.json | 22 ++++----- rh-virt/.catalog/collection.yaml | 24 +++++----- rh-virt/.catalog/deploy_and_use.md | 2 +- rh-virt/.catalog/mcp_section.md | 2 +- rh-virt/{CLAUDE.md => AGENTS.md} | 0 scripts/bootstrap_catalog.py | 10 ++-- scripts/validate_structure.py | 47 +++++++++++++------ 56 files changed, 169 insertions(+), 152 deletions(-) rename ocp-admin/{CLAUDE.md => AGENTS.md} (100%) rename rh-ai-engineer/{CLAUDE.md => AGENTS.md} (100%) rename rh-automation/{CLAUDE.md => AGENTS.md} (100%) rename rh-basic/{CLAUDE.md => AGENTS.md} (100%) rename rh-developer/{CLAUDE.md => AGENTS.md} (100%) rename rh-sre/{CLAUDE.md => AGENTS.md} (100%) rename rh-virt/{CLAUDE.md => AGENTS.md} (100%) diff --git a/.claude/skills/agentic-contribution-skill/SKILL.md b/.claude/skills/agentic-contribution-skill/SKILL.md index 7de3ff99..5804cc46 100644 --- a/.claude/skills/agentic-contribution-skill/SKILL.md +++ b/.claude/skills/agentic-contribution-skill/SKILL.md @@ -172,7 +172,7 @@ Ask concisely, validate before proceeding. Make additional questions if needed t 2. **Add missing sections**: Per DP6/DP7 — Prerequisites, When to Use, Workflow, Common Issues, Dependencies. Keep existing content, add structure around it 3. **Validate naming**: kebab-case, check uniqueness: `test -d /skills//` 4. **Place file**: Copy to `/skills//SKILL.md` -5. **Update routing**: Add entry to `/CLAUDE.md` intent routing table +5. **Update routing**: Add entry to `/AGENTS.md` intent routing table 6. **Show changes**: Present summary of all modifications to user, wait for confirmation After confirmation → proceed to Phase 5 (Validation & Iteration). @@ -242,10 +242,10 @@ mkdir -p /skills//docs/ - `docs/common-issues.md` - Detailed troubleshooting with full KB article content - `docs/examples.md` - Comprehensive usage examples - `docs/external-resources.md` - Any external docs/links/KB articles mentioned by user -3. **Update /CLAUDE.md**: Add intent routing entry +3. **Update /AGENTS.md**: Add intent routing entry 4. **Create /mcps.json**: If new MCP server needed (use `${ENV_VAR}` format) 5. **Update marketplace/rh-agentic-collection.yml**: If new pack (register pack for Lola installation) -6. **Create pack structure**: If new pack (README.md, CLAUDE.md, skills/ directory) +6. **Create pack structure**: If new pack (README.md, AGENTS.md, skills/ directory) Generate SKILL.md following the mandatory section template in SKILL_DESIGN_PRINCIPLES.md (already consulted in Phase 3). If SKILL.md becomes too long, move detailed content to `docs/` with references in main file. diff --git a/.claude/skills/agentic-contribution-skill/docs/examples.md b/.claude/skills/agentic-contribution-skill/docs/examples.md index 45bec2fa..4e8e78ab 100644 --- a/.claude/skills/agentic-contribution-skill/docs/examples.md +++ b/.claude/skills/agentic-contribution-skill/docs/examples.md @@ -98,7 +98,7 @@ Reading SKILL_DESIGN_PRINCIPLES.md for compliant generation... Generating skill with production-ready quality... ✅ Generated: rh-virt/skills/vm-backup-create/SKILL.md -✅ Updated: rh-virt/CLAUDE.md (intent routing) +✅ Updated: rh-virt/AGENTS.md (intent routing) Running validation... @@ -182,7 +182,7 @@ Adapting skill: ✅ Fixed section ordering per DP7 Placing file: ocp-admin/skills/cluster-backup/SKILL.md -Updating: ocp-admin/CLAUDE.md (intent routing) +Updating: ocp-admin/AGENTS.md (intent routing) Summary of changes: - Frontmatter: added model, color, metadata @@ -202,7 +202,7 @@ Running validation... Files: ✅ ocp-admin/skills/cluster-backup/SKILL.md (210 lines) -✅ ocp-admin/CLAUDE.md (intent routing updated) +✅ ocp-admin/AGENTS.md (intent routing updated) Ready to commit? (yes/no) > yes diff --git a/.claude/skills/collection-compliance/SKILL.md b/.claude/skills/collection-compliance/SKILL.md index 5e984fc2..78e409bd 100644 --- a/.claude/skills/collection-compliance/SKILL.md +++ b/.claude/skills/collection-compliance/SKILL.md @@ -47,12 +47,12 @@ allowed-tools: Read Glob Grep Bash - Compare each pack's catalog metadata and referenced fragments against golden sources: - `skills/*/SKILL.md` (names, descriptions, scope, orchestration intent) - `README.md` (installation, prerequisites, env variables, usage caveats) - - `CLAUDE.md` (persona, routing, global rules, MCP posture) + - `AGENTS.md` (persona, routing, global rules, MCP posture) - `marketplace/rh-agentic-collection.yml` (module `path`, module name/description/tags) - Fail review if any of these drift conditions are found: - Installation steps differ in substance (for example Lola module IDs/paths mismatch) - Required env vars in `mcps.json` are missing or inconsistent in `deploy_and_use` - - Skill inventory/routing intent in catalog contradicts `skills/` + `CLAUDE.md` + - Skill inventory/routing intent in catalog contradicts `skills/` + `AGENTS.md` - Fragment prose overstates/understates capabilities versus README/skills - Remediate via create-collection workflow and then regenerate JSON mirror. diff --git a/.claude/skills/create-collection/SKILL.md b/.claude/skills/create-collection/SKILL.md index b9754e3f..a2887da7 100644 --- a/.claude/skills/create-collection/SKILL.md +++ b/.claude/skills/create-collection/SKILL.md @@ -1,7 +1,7 @@ --- name: create-collection description: | - Author or refresh `/.catalog/collection.yaml` and related `.catalog/` artifacts from golden sources (SKILL.md, README, CLAUDE.md, Lola marketplace). Use when: + Author or refresh `/.catalog/collection.yaml` and related `.catalog/` artifacts from golden sources (SKILL.md, README, AGENTS.md, Lola marketplace). Use when: - Adding a new pack or refreshing the collection catalog for GitHub Pages / tooling - Aligning catalog narrative, sample workflows, and decision guide with skills on disk - Preparing a PR after changing skills or marketplace metadata @@ -37,7 +37,7 @@ allowed-tools: Read Glob Grep Bash 2. **Read sources in order** (precedence): - `skills/*/SKILL.md` (frontmatter + body for summaries and orchestration hints) - `/README.md` - - `/CLAUDE.md` (intent routing → `skills_decision_guide` ideas) + - `/AGENTS.md` (intent routing → `skills_decision_guide` ideas) - Matching row in `marketplace/rh-agentic-collection.yml` (`path` == pack) 3. **Classify skills** — place each skill in `contents.skills` or `contents.orchestration_skills` using maintainer judgment. Optional hint: `metadata.collection.role: orchestration` in `SKILL.md` frontmatter. Names in YAML **must** match the `skills//` directory name. diff --git a/.github/gemini-review-prompt.md b/.github/gemini-review-prompt.md index b0b57bd9..75c755b9 100644 --- a/.github/gemini-review-prompt.md +++ b/.github/gemini-review-prompt.md @@ -17,7 +17,7 @@ Check the diff against the project rules injected in PROJECT RULES REFERENCE (fr - **Security**: no hardcoded credentials, no exposed secret values, `${ENV_VAR}` references only - **Skill invocation**: use `/skill-name` slash format, never call MCP tools directly - **Human-in-the-Loop**: required for create/delete/modify/restore/execute ops, not for read-only -- **Pack-persona alignment**: when reviewing new skills, verify that the skill's purpose aligns with the pack's persona (defined in the opening paragraph of the pack's CLAUDE.md). Flag any skill that appears to belong in a different pack +- **Pack-persona alignment**: when reviewing new skills, verify that the skill's purpose aligns with the pack's persona (defined in the opening paragraph of the pack's AGENTS.md). Flag any skill that appears to belong in a different pack - **New packs**: must add pack name to `PACK_DIRS` in `scripts/validate_structure.py`; `docs/data.json` must NOT be committed - **Build reminder**: if skills, agents, or `mcps.json` changed, remind author to run `make validate` diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 8e867398..1b67d014 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,6 +1,6 @@ @@ -39,7 +39,7 @@ -## CLAUDE.md compliance +## AGENTS.md compliance - [ ] Agents orchestrate skills; no direct MCP/tool calls in agents - [ ] Skills are single-purpose task executors diff --git a/.github/workflows/README.md b/.github/workflows/README.md index e2a5541f..c1695014 100644 --- a/.github/workflows/README.md +++ b/.github/workflows/README.md @@ -363,7 +363,7 @@ gh workflow run skill-security-scan.yml -f pr_number=42 ### 5. `skill-code-review.yml` - Skill Code Review -**Purpose**: Automated code review using Google Gemini, validating PR diffs against project rules (`CLAUDE.md`, `SKILL_DESIGN_PRINCIPLES.md`, and pack-level `CLAUDE.md` files). +**Purpose**: Automated code review using Google Gemini, validating PR diffs against project rules (`CLAUDE.md`, `SKILL_DESIGN_PRINCIPLES.md`, and pack-level `AGENTS.md` files). **Trigger methods**: @@ -378,7 +378,7 @@ Both `/skill-code-review` and `/skill-security-scan` can be written in **a singl **What it does**: 1. Fetches the PR diff (truncated to 200KB if larger) -2. Collects project rules: root `CLAUDE.md`, `SKILL_DESIGN_PRINCIPLES.md`, and pack-level `CLAUDE.md` for changed packs +2. Collects project rules: root `CLAUDE.md`, `SKILL_DESIGN_PRINCIPLES.md`, and pack-level `AGENTS.md` for changed packs 3. Sends diff + rules to Gemini with the review prompt (`.github/gemini-review-prompt.md`) 4. Posts review as a collapsible PR comment (updates the same comment on re-runs) diff --git a/.github/workflows/skill-code-review.yml b/.github/workflows/skill-code-review.yml index cc2a1367..d6140489 100644 --- a/.github/workflows/skill-code-review.yml +++ b/.github/workflows/skill-code-review.yml @@ -1,7 +1,7 @@ # Skill Code Review Workflow # # Automated code review using Google Gemini, validating PRs against project -# rules (CLAUDE.md, SKILL_DESIGN_PRINCIPLES.md, pack-level CLAUDE.md). +# rules (CLAUDE.md, SKILL_DESIGN_PRINCIPLES.md, pack-level AGENTS.md). # # Trigger methods: # 1. PR comment: Maintainer comments "/skill-code-review" @@ -180,11 +180,11 @@ jobs: CHANGED_PACKS=$(grep -oP '^diff --git a/([^/]+)/' /tmp/pr.diff | sort -u | sed 's|diff --git a/||;s|/||') for pack in $CHANGED_PACKS; do - if [ -f "$pack/CLAUDE.md" ]; then + if [ -f "$pack/AGENTS.md" ]; then { echo "" - echo "=== PACK RULES: $pack/CLAUDE.md ===" - cat "$pack/CLAUDE.md" + echo "=== PACK RULES: $pack/AGENTS.md ===" + cat "$pack/AGENTS.md" } >> /tmp/project_rules.txt fi done diff --git a/CLAUDE.md b/CLAUDE.md index ff70132d..9bc8352b 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -23,7 +23,7 @@ Packs follow the [Lola](https://github.com/LobsterTrap/lola) package manager for Each pack follows this structure: ``` / -├── CLAUDE.md # Claude Code instruction routing (persona, skills, rules) +├── AGENTS.md # Lola AI Context Module instruction routing (persona, skills, rules) ├── README.md # Pack description, persona, target marketplaces ├── mcps.json # MCP server configurations (uses env vars for credentials) ├── .catalog/ # collection.yaml + collection.json (COLLECTION_SPEC.md, catalog/schema.yaml) @@ -61,7 +61,7 @@ There are two ways to add skills to this project: ### Repository catalog skills (`.catalog/`) -Packs listed in `union(marketplace/rh-agentic-collection.yml modules[].path, docs/plugins.json keys)` maintain **`/.catalog/collection.yaml`** (and a deterministic **`collection.json`** mirror). Golden sources remain `SKILL.md`, `README.md`, `CLAUDE.md`, and marketplace YAML—**never** generated from catalog back into those files. +Packs listed in `union(marketplace/rh-agentic-collection.yml modules[].path, docs/plugins.json keys)` maintain **`/.catalog/collection.yaml`** (and a deterministic **`collection.json`** mirror). Golden sources remain `SKILL.md`, `README.md`, `AGENTS.md`, and marketplace YAML—**never** generated from catalog back into those files. - **`create-collection`** (`.claude/skills/create-collection/`) — workflow to author or refresh catalog YAML under `.catalog/`. - **`collection-compliance`** (`.claude/skills/collection-compliance/`) — interpret `make validate-collection-compliance` failures and fix drift. @@ -170,7 +170,7 @@ last_updated: YYYY-MM-DD 1. Create pack folder: `/` 2. Add `README.md` with description, persona, marketplaces -3. Add `CLAUDE.md` with persona, skill-first rule, intent routing table, MCP servers, and global rules (see [rh-ai-engineer/CLAUDE.md](rh-ai-engineer/CLAUDE.md) for reference) +3. Add `AGENTS.md` with persona, skill-first rule, intent routing table, MCP servers, and global rules (see [rh-ai-engineer/AGENTS.md](rh-ai-engineer/AGENTS.md) for reference) 4. Create `skills/` directory 5. Add `mcps.json` when the pack integrates MCP servers (use `${VAR}` for secrets) 6. Register the pack in [`marketplace/rh-agentic-collection.yml`](marketplace/rh-agentic-collection.yml) so `lola install -f ` can resolve it @@ -190,7 +190,7 @@ last_updated: YYYY-MM-DD - Workflow with precise parameters - Dependencies declaration 4. Include concrete examples and complete error handling -5. Update the pack's `CLAUDE.md` intent routing table to include the new skill +5. Update the pack's `AGENTS.md` intent routing table to include the new skill 6. Test with `Skill` tool invocation 7. Validate with `./scripts/run-skill-linter.sh skills//` diff --git a/COLLECTION_SPEC.md b/COLLECTION_SPEC.md index d0da5617..05978797 100644 --- a/COLLECTION_SPEC.md +++ b/COLLECTION_SPEC.md @@ -1,8 +1,8 @@ # Collection catalog specification -This repository uses a **pack-local collection catalog**: curated metadata and summaries live under **`/.catalog/`** (YAML as the source of record, JSON as a deterministic mirror for consumers that prefer it). **Golden sources** are pack `SKILL.md` files, `README.md`, `CLAUDE.md`, and [`marketplace/rh-agentic-collection.yml`](marketplace/rh-agentic-collection.yml). Catalog files **describe** the collection for tooling and documentation; they are **authored** primarily via the [**create-collection**](.claude/skills/create-collection/SKILL.md) skill (assistant + maintainer + PR review) and must not overwrite READMEs or marketplace YAML. +This repository uses a **pack-local collection catalog**: curated metadata and summaries live under **`/.catalog/`** (YAML as the source of record, JSON as a deterministic mirror for consumers that prefer it). **Golden sources** are pack `SKILL.md` files, `README.md`, `AGENTS.md`, and [`marketplace/rh-agentic-collection.yml`](marketplace/rh-agentic-collection.yml). Catalog files **describe** the collection for tooling and documentation; they are **authored** primarily via the [**create-collection**](.claude/skills/create-collection/SKILL.md) skill (assistant + maintainer + PR review) and must not overwrite READMEs or marketplace YAML. -**Machine validation:** [`catalog/schema.yaml`](catalog/schema.yaml) (JSON Schema expressed in YAML) and [`scripts/validate_collection_compliance.py`](scripts/validate_collection_compliance.py). These checks are primarily structural and cannot fully evaluate semantic parity with golden-source docs. **Required review gate:** run an AI semantic alignment review (via [`.claude/skills/collection-compliance/SKILL.md`](.claude/skills/collection-compliance/SKILL.md)) to confirm catalog metadata/fragments remain aligned with `SKILL.md`, `README.md`, `CLAUDE.md`, and marketplace module metadata. **Pack list (registry):** union of Lola marketplace `modules[].path` and keys of [`docs/plugins.json`](docs/plugins.json), limited to directories that exist on disk — see [`scripts/pack_registry.py`](scripts/pack_registry.py). **GitHub Pages / bundled catalog listing:** only packs whose **`maturity`** is **`GREEN`** are included in site generation (`docs/data.json`, collection pages, MCP bundle for docs); **`ORANGE`** means the pack remains installable from source/Lola but is not promoted on the public catalog until reviewers raise maturity. +**Machine validation:** [`catalog/schema.yaml`](catalog/schema.yaml) (JSON Schema expressed in YAML) and [`scripts/validate_collection_compliance.py`](scripts/validate_collection_compliance.py). These checks are primarily structural and cannot fully evaluate semantic parity with golden-source docs. **Required review gate:** run an AI semantic alignment review (via [`.claude/skills/collection-compliance/SKILL.md`](.claude/skills/collection-compliance/SKILL.md)) to confirm catalog metadata/fragments remain aligned with `SKILL.md`, `README.md`, `AGENTS.md`, and marketplace module metadata. **Pack list (registry):** union of Lola marketplace `modules[].path` and keys of [`docs/plugins.json`](docs/plugins.json), limited to directories that exist on disk — see [`scripts/pack_registry.py`](scripts/pack_registry.py). **GitHub Pages / bundled catalog listing:** only packs whose **`maturity`** is **`GREEN`** are included in site generation (`docs/data.json`, collection pages, MCP bundle for docs); **`ORANGE`** means the pack remains installable from source/Lola but is not promoted on the public catalog until reviewers raise maturity. ### `maturity` (required) @@ -37,7 +37,7 @@ Consumers read **`deploy_and_use`** (resolved from inline YAML or from **`#deplo **When `/mcps.json` defines one or more MCP servers**, the prose behind **`deploy_and_use`** (inline or fragment) **must** cover, in substance: -1. **Prerequisites** — Cluster/product access, CLIs, operators, or accounts needed before install, aligned with **`README.md`** / **`CLAUDE.md`**. +1. **Prerequisites** — Cluster/product access, CLIs, operators, or accounts needed before install, aligned with **`README.md`** / **`AGENTS.md`**. 2. **Environment setup** — Example **`export VAR=...`** (or host env equivalent) for **every** environment variable **name** referenced in **`mcps.json`** via **`${VAR}`** in `command`, `args`, or `env`. Variable **names** must match **`mcps.json`** exactly. State that secrets are never committed and must not be echoed in assistant output. 3. **MCP configuration** — Server definitions live in **`mcps.json`** at the pack root; use **`${...}`** placeholders only; briefly note isolation/network/credentials posture if it affects the user (see existing pack fragments). 4. **Installation** — At minimum **Lola** (`lola install -f `) and the module **`path:`** in **`marketplace/rh-agentic-collection.yml`**. If **`marketplaces`** in the catalog includes **Claude Code** or **Cursor**, include install notes for those hosts (copy the pattern from **`rh-sre/.catalog/deploy_and_use.md`**). @@ -54,7 +54,7 @@ When multiple sources could supply the same logical field: 1. **`skills/*/SKILL.md`** (per-skill `name`, `description`, body for `summary_markdown` hints) 2. **`/README.md`** -3. **`/CLAUDE.md`** (intent routing for decision-guide hints, personas) +3. **`/AGENTS.md`** (intent routing for decision-guide hints, personas) **Lola marketplace:** the module whose `path` equals `` supplies `version`, module `name`, module `description`, and `tags` for listing-oriented fields. **Never** write back to marketplace YAML from automation or the create-collection workflow. @@ -62,7 +62,7 @@ When multiple sources could supply the same logical field: | Artifact | Banner | |----------|--------| -| `collection.yaml` | Leading `#` comment block: must mention **create-collection** workflow and **golden sources** (SKILL, README, CLAUDE, marketplace). | +| `collection.yaml` | Leading `#` comment block: must mention **create-collection** workflow and **golden sources** (SKILL, README, AGENTS, marketplace). | | `.catalog/*.md` fragments | Leading HTML `` with the same intent. | | `collection.json` | **No** embedded banner; **CI** regenerates from YAML and fails if the committed file differs. | @@ -72,7 +72,7 @@ When multiple sources could supply the same logical field: ## Completeness and CI -All **required** schema fields must be present on merge to `main` (no empty placeholders, no `TODO:` / `TBD` in `sample_workflows.workflow`). Author field values so they stay aligned with **`CLAUDE.md`**, **`mcps.json`**, and **`README.md`** where those sources define behavior; fragment refs follow [External references](#external-references-md-on-the-same-field). CI runs **`make validate`** (includes structure + **collection compliance**). +All **required** schema fields must be present on merge to `main` (no empty placeholders, no `TODO:` / `TBD` in `sample_workflows.workflow`). Author field values so they stay aligned with **`AGENTS.md`**, **`mcps.json`**, and **`README.md`** where those sources define behavior; fragment refs follow [External references](#external-references-md-on-the-same-field). CI runs **`make validate`** (includes structure + **collection compliance**). ## Related diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1cba13bf..ba68c3c7 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -28,7 +28,7 @@ The fastest way to contribute is using `/agentic-contribution-skill` in Claude C 2. Open the project in Claude Code 3. Run `/agentic-contribution-skill` and follow the prompts -The skill handles pack selection, CLAUDE.md routing, validation (Tier 1 + Tier 2), and git workflow automatically. +The skill handles pack selection, AGENTS.md routing, validation (Tier 1 + Tier 2), and git workflow automatically. ## Pack Selection @@ -52,7 +52,7 @@ If you prefer to create skills manually: 1. Read the standards: [SKILL_DESIGN_PRINCIPLES.md](SKILL_DESIGN_PRINCIPLES.md) 2. Create `/skills//SKILL.md` following the template -3. Update `/CLAUDE.md` intent routing table +3. Update `/AGENTS.md` intent routing table 4. Validate Tier 1: `./scripts/run-skill-linter.sh /skills//` 5. Validate Tier 2: `make validate-skill-design-changed` @@ -64,7 +64,7 @@ Both tiers must pass before submitting a PR. - [ ] Tier 2 validation passed (design principles) - [ ] Skill doc links validated: `uv run python scripts/validate_skill_doc_links.py /skills//SKILL.md` - [ ] Skill doc tree links validated: `uv run python scripts/validate_docs_tree_links.py /skills//SKILL.md` -- [ ] Pack CLAUDE.md intent routing updated +- [ ] Pack AGENTS.md intent routing updated - [ ] Tested skill locally by invoking it in Claude Code - [ ] No credentials hardcoded (use `${ENV_VAR}` format) - [ ] Human-in-the-loop confirmation for destructive operations diff --git a/FEDERATION_REQUEST_GUIDE.md b/FEDERATION_REQUEST_GUIDE.md index dd6cfd9b..a181ee41 100644 --- a/FEDERATION_REQUEST_GUIDE.md +++ b/FEDERATION_REQUEST_GUIDE.md @@ -52,7 +52,7 @@ flowchart TB | Requirement | Details | CI | |-------------|---------|-----| -| **Lola pack** | `CLAUDE.md`, `README.md`, `skills/` at declared `path` | Blocks | +| **Lola pack** | `AGENTS.md`, `README.md`, `skills/` at declared `path` | Blocks | | **License** | Apache-2.0–compatible LICENSE in your repo | Manual | | **Tier 1** | [agentskills.io](https://agentskills.io/specification) linter | Blocks | | **Tier 2** | [SKILL_DESIGN_PRINCIPLES.md](SKILL_DESIGN_PRINCIPLES.md) | **Warns** | diff --git a/FEDERATION_REVIEW_GUIDE.md b/FEDERATION_REVIEW_GUIDE.md index e127c093..c1c786f9 100644 --- a/FEDERATION_REVIEW_GUIDE.md +++ b/FEDERATION_REVIEW_GUIDE.md @@ -23,7 +23,7 @@ flowchart TB SKILL["/federation-review"] GUIDE["This guide"] M1["License + owner/contact"] - M2["AI agent compatibility
(CLAUDE.md, Cursor, ChatGPT)"] + M2["AI agent compatibility
(AGENTS.md, Cursor, ChatGPT)"] M3["Catalog quality spot-check"] CAT --> PATH PATH -->|recommended| SKILL --> M1 @@ -85,7 +85,7 @@ uv run python scripts/validate_federation_catalog.py \ - [ ] Owner/contact provided on the PR or issue - [ ] LICENSE in external repo is Apache-2.0–compatible -- [ ] Declared agents supported (`CLAUDE.md` routing, Cursor/ChatGPT config as claimed) +- [ ] Declared agents supported (`AGENTS.md` routing, Cursor/ChatGPT config as claimed) - [ ] Destructive skill operations require human confirmation - [ ] Full pack at `path` is appropriate — no per-skill subset in marketplace YAML @@ -94,7 +94,7 @@ Clone at pinned commit when inspecting by hand: ```bash git clone --no-checkout /tmp/federation-review cd /tmp/federation-review && git checkout -# ... inspect skills/, mcps.json, CLAUDE.md ... +# ... inspect skills/, mcps.json, AGENTS.md ... rm -rf /tmp/federation-review ``` diff --git a/README.md b/README.md index bcdddaa7..2a1d1a1d 100644 --- a/README.md +++ b/README.md @@ -493,7 +493,7 @@ lola install -f rh-sre ### Validate packs (recommended) ```bash -# Structure, mcps.json, CLAUDE.md, skill frontmatter; validates plugin.json only when present +# Structure, mcps.json, AGENTS.md, skill frontmatter; validates plugin.json only when present make validate ``` diff --git a/SKILL_DESIGN_PRINCIPLES.md b/SKILL_DESIGN_PRINCIPLES.md index e242262b..56fc1153 100644 --- a/SKILL_DESIGN_PRINCIPLES.md +++ b/SKILL_DESIGN_PRINCIPLES.md @@ -6,7 +6,7 @@ Repository-specific design principles for creating skills and agents in agentic **Distribution (Lola):** Packs are installed with the [Lola](https://github.com/LobsterTrap/lola) package manager from the registry in [`marketplace/rh-agentic-collection.yml`](marketplace/rh-agentic-collection.yml). Layout and install flow are documented in [CLAUDE.md](CLAUDE.md) and the root [README.md](README.md). -**Collection catalog (pack-local):** Each pack may include **`/.catalog/collection.yaml`** and a **`collection.json`** mirror so tooling and docs can show a structured view of the collection. Authors follow [COLLECTION_SPEC.md](COLLECTION_SPEC.md) and the **create-collection** skill; field constraints are defined in **[`catalog/schema.yaml`](catalog/schema.yaml)** (JSON Schema in YAML). Pack **`SKILL.md`**, **`README.md`**, **`CLAUDE.md`**, and **`marketplace/rh-agentic-collection.yml`** stay the **sources of truth**; the catalog aggregates and summarizes them and does **not** replace or regenerate README or marketplace content. +**Collection catalog (pack-local):** Each pack may include **`/.catalog/collection.yaml`** and a **`collection.json`** mirror so tooling and docs can show a structured view of the collection. Authors follow [COLLECTION_SPEC.md](COLLECTION_SPEC.md) and the **create-collection** skill; field constraints are defined in **[`catalog/schema.yaml`](catalog/schema.yaml)** (JSON Schema in YAML). Pack **`SKILL.md`**, **`README.md`**, **`AGENTS.md`**, and **`marketplace/rh-agentic-collection.yml`** stay the **sources of truth**; the catalog aggregates and summarizes them and does **not** replace or regenerate README or marketplace content. **MCP configuration:** Use `/mcps.json` for MCP server definitions (never hardcode secrets; use `${VAR}` references). The deprecated filename `.mcp.json` is not used in this repository. @@ -379,9 +379,9 @@ One clear purpose per skill. --- -### 11. Pack-Level CLAUDE.md +### 11. Pack-Level AGENTS.md -Every pack with skills MUST have a `CLAUDE.md` in its root directory. This file acts as the instruction router for Claude Code. +Every pack with skills MUST have an `AGENTS.md` in its root directory. This file is the [Lola AI Context Module](https://lobstertrap.org/lola/guides/creating-modules/#add-an-agentsmd) instruction router for the pack persona, intent routing, and global rules. Do **not** use pack-level `CLAUDE.md` — Lola manages `AGENTS.md`, not `CLAUDE.md`. **Required Sections:** - `## Skill-First Rule` — enforce skill invocation over direct MCP tool calls @@ -389,11 +389,11 @@ Every pack with skills MUST have a `CLAUDE.md` in its root directory. This file - `## MCP Servers` — list available MCP servers with descriptions - `## Global Rules` — credential safety, confirmation requirements, next-step suggestions -**When adding a new skill**, update the pack's `CLAUDE.md` intent routing table to include it. +**When adding a new skill**, update the pack's `AGENTS.md` intent routing table to include it. -**Reference:** [rh-ai-engineer/CLAUDE.md](rh-ai-engineer/CLAUDE.md) +**Reference:** [rh-ai-engineer/AGENTS.md](rh-ai-engineer/AGENTS.md) -**Validated by:** `scripts/validate_structure.py` (automated — checks existence, required sections, and intent routing completeness) +**Validated by:** `scripts/validate_structure.py` (automated — checks existence, required sections, intent routing completeness, and rejects deprecated pack-level `CLAUDE.md`) --- @@ -566,7 +566,7 @@ Ask: "Proceed?" Wait for confirmation. 8. **Single Responsibility** - One purpose per skill 9. **Naming Conventions** - kebab-case 10. **Content Quality** - Production-ready examples -11. **Pack-Level CLAUDE.md** - Instruction routing for every pack with skills +11. **Pack-Level AGENTS.md** - Instruction routing for every pack with skills (Lola convention) --- diff --git a/ocp-admin/.catalog/collection.json b/ocp-admin/.catalog/collection.json index 9d076f75..0c5a0939 100644 --- a/ocp-admin/.catalog/collection.json +++ b/ocp-admin/.catalog/collection.json @@ -175,7 +175,7 @@ "workflow": "User: \"Does CVE-2025-61726 affect CoreOS in OCP 4.20.16?\"\n- `/coreos-cve-validator` extracts RPMs, finds affected package, checks VEX under OCP and RHEL EUS CPEs\n" } ], - "summary": "The ocp-admin collection covers Assisted Installer cluster creation, multi-cluster discovery across self-managed and managed\nOpenShift, kubeconfig-backed fleet health reporting, and security validation for Red Hat container images and CoreOS using\nofficial SBOMs and VEX data. Use CLAUDE.md intent routing to pick the right skill.\n", + "summary": "The ocp-admin collection covers Assisted Installer cluster creation, multi-cluster discovery across self-managed and managed\nOpenShift, kubeconfig-backed fleet health reporting, and security validation for Red Hat container images and CoreOS using\nofficial SBOMs and VEX data. Use AGENTS.md intent routing to pick the right skill.\n", "support_level": "Unknown", "version": "0.1.0" } diff --git a/ocp-admin/.catalog/collection.yaml b/ocp-admin/.catalog/collection.yaml index 1cc9f06a..8a3fb6d8 100644 --- a/ocp-admin/.catalog/collection.yaml +++ b/ocp-admin/.catalog/collection.yaml @@ -1,5 +1,5 @@ # Catalog: maintained via create-collection workflow (assistant + maintainer + PR review). -# Golden sources: skills/*/SKILL.md, README.md, CLAUDE.md, marketplace/rh-agentic-collection.yml +# Golden sources: skills/*/SKILL.md, README.md, AGENTS.md, marketplace/rh-agentic-collection.yml # Do not edit ad hoc — follow COLLECTION_SPEC.md and the create-collection skill. id: openshift-administration @@ -28,7 +28,7 @@ description: Automation capabilities for OpenShift Container Platform cluster ma summary: | The ocp-admin collection covers Assisted Installer cluster creation, multi-cluster discovery across self-managed and managed OpenShift, kubeconfig-backed fleet health reporting, and security validation for Red Hat container images and CoreOS using - official SBOMs and VEX data. Use CLAUDE.md intent routing to pick the right skill. + official SBOMs and VEX data. Use AGENTS.md intent routing to pick the right skill. contents: description: | The pack provides seven skills for cluster lifecycle, fleet visibility, and security validation on OpenShift, diff --git a/ocp-admin/.catalog/deploy_and_use.md b/ocp-admin/.catalog/deploy_and_use.md index c24b6863..ab1b3634 100644 --- a/ocp-admin/.catalog/deploy_and_use.md +++ b/ocp-admin/.catalog/deploy_and_use.md @@ -1,6 +1,6 @@ ### Prerequisites diff --git a/ocp-admin/.catalog/mcp_section.md b/ocp-admin/.catalog/mcp_section.md index 68c429e0..a4243d07 100644 --- a/ocp-admin/.catalog/mcp_section.md +++ b/ocp-admin/.catalog/mcp_section.md @@ -1,6 +1,6 @@ | Server | Role | diff --git a/ocp-admin/CLAUDE.md b/ocp-admin/AGENTS.md similarity index 100% rename from ocp-admin/CLAUDE.md rename to ocp-admin/AGENTS.md diff --git a/rh-ai-engineer/.catalog/collection.json b/rh-ai-engineer/.catalog/collection.json index 9f768662..3bf233a2 100644 --- a/rh-ai-engineer/.catalog/collection.json +++ b/rh-ai-engineer/.catalog/collection.json @@ -15,7 +15,7 @@ "GPU" ], "contents": { - "description": "The pack provides 10 skills and 1 orchestration skill for OpenShift AI workflows on Red Hat platforms; see CLAUDE.md\nfor intent routing.\n", + "description": "The pack provides 10 skills and 1 orchestration skill for OpenShift AI workflows on Red Hat platforms; see AGENTS.md\nfor intent routing.\n", "orchestration_skills": [ { "description": "Configure TrustyAI Guardrails Orchestrator for LLM input/output content safety on OpenShift AI.", diff --git a/rh-ai-engineer/.catalog/collection.yaml b/rh-ai-engineer/.catalog/collection.yaml index 43638197..786c0d14 100644 --- a/rh-ai-engineer/.catalog/collection.yaml +++ b/rh-ai-engineer/.catalog/collection.yaml @@ -1,5 +1,5 @@ # Catalog: maintained via create-collection workflow (assistant + maintainer + PR review). -# Golden sources: skills/*/SKILL.md, README.md, CLAUDE.md, marketplace/rh-agentic-collection.yml +# Golden sources: skills/*/SKILL.md, README.md, AGENTS.md, marketplace/rh-agentic-collection.yml # Do not edit ad hoc — follow COLLECTION_SPEC.md and the create-collection skill. id: rh-ai-engineer @@ -30,7 +30,7 @@ summary: | guardrails, and inference troubleshooting across 11 skills. contents: description: | - The pack provides 10 skills and 1 orchestration skill for OpenShift AI workflows on Red Hat platforms; see CLAUDE.md + The pack provides 10 skills and 1 orchestration skill for OpenShift AI workflows on Red Hat platforms; see AGENTS.md for intent routing. skills: - name: ai-observability diff --git a/rh-ai-engineer/.catalog/deploy_and_use.md b/rh-ai-engineer/.catalog/deploy_and_use.md index be741568..1cebc492 100644 --- a/rh-ai-engineer/.catalog/deploy_and_use.md +++ b/rh-ai-engineer/.catalog/deploy_and_use.md @@ -1,6 +1,6 @@ ### Prerequisites diff --git a/rh-ai-engineer/.catalog/mcp_section.md b/rh-ai-engineer/.catalog/mcp_section.md index 097127af..690b2f13 100644 --- a/rh-ai-engineer/.catalog/mcp_section.md +++ b/rh-ai-engineer/.catalog/mcp_section.md @@ -1,6 +1,6 @@ | Server | Role | diff --git a/rh-ai-engineer/CLAUDE.md b/rh-ai-engineer/AGENTS.md similarity index 100% rename from rh-ai-engineer/CLAUDE.md rename to rh-ai-engineer/AGENTS.md diff --git a/rh-automation/.catalog/collection.json b/rh-automation/.catalog/collection.json index 17b1f857..50042ec8 100644 --- a/rh-automation/.catalog/collection.json +++ b/rh-automation/.catalog/collection.json @@ -13,64 +13,64 @@ "Execution" ], "contents": { - "description": "The pack provides 8 skills and 3 orchestration skills for rh automation workflows on Red Hat platforms; see CLAUDE.md for intent routing.\n", + "description": "The pack provides 8 skills and 3 orchestration skills for rh automation workflows on Red Hat platforms; see AGENTS.md for intent routing.\n", "orchestration_skills": [ { "description": "Orchestrates forensic analysis of failed jobs with event extraction, host correlation, and resolution advisory.", "name": "forensic-troubleshooter", - "summary_markdown": "Orchestrates forensic analysis of failed jobs with event extraction, host correlation, and resolution advisory.\n**Use when:**\n- \"Job #X failed\"\n- \"Analyze the failure\"\n- \"Root cause analysis of job #X\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Orchestrates forensic analysis of failed jobs with event extraction, host correlation, and resolution advisory.\n**Use when:**\n- \"Job #X failed\"\n- \"Analyze the failure\"\n- \"Root cause analysis of job #X\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Orchestrates AAP governance readiness assessments -- full platform audit or scoped to specific domains.", "name": "governance-assessor", - "summary_markdown": "Orchestrates AAP governance readiness assessments -- full platform audit or scoped to specific domains.\n**Use when:**\n- \"What should I fix before executing jobs?\"\n- \"See CLAUDE.md intent routing\"\n- \"See CLAUDE.md intent routing\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Orchestrates AAP governance readiness assessments -- full platform audit or scoped to specific domains.\n**Use when:**\n- \"What should I fix before executing jobs?\"\n- \"See AGENTS.md intent routing\"\n- \"See AGENTS.md intent routing\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Orchestrates governed job execution with risk analysis, check mode, approval, and rollback.", "name": "governance-executor", - "summary_markdown": "Orchestrates governed job execution with risk analysis, check mode, approval, and rollback.\n**Use when:**\n- \"Execute job template X\"\n- \"See CLAUDE.md intent routing\"\n- \"See CLAUDE.md intent routing\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Orchestrates governed job execution with risk analysis, check mode, approval, and rollback.\n**Use when:**\n- \"Execute job template X\"\n- \"See AGENTS.md intent routing\"\n- \"See AGENTS.md intent routing\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" } ], "skills": [ { "description": "Validate that required AAP MCP servers are accessible before executing automation skills.", "name": "aap-mcp-validator", - "summary_markdown": "Validate that required AAP MCP servers are accessible before executing automation skills.\n**Use when:**\n- \"Validate AAP MCP\"\n- \"Verify AAP connection\"\n- \"See CLAUDE.md intent routing\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Validate that required AAP MCP servers are accessible before executing automation skills.\n**Use when:**\n- \"Validate AAP MCP\"\n- \"Verify AAP connection\"\n- \"See AGENTS.md intent routing\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Analyze execution risk by classifying inventory, scanning extra_vars for secrets, and assessing scope.", "name": "execution-risk-analyzer", - "summary_markdown": "Analyze execution risk by classifying inventory, scanning extra_vars for secrets, and assessing scope.\n**Use when:**\n- \"Execute on production\"\n- \"Is this execution safe?\"\n- \"Check execution risk\"\n- \"Validate the execution target\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Analyze execution risk by classifying inventory, scanning extra_vars for secrets, and assessing scope.\n**Use when:**\n- \"Execute on production\"\n- \"Is this execution safe?\"\n- \"Check execution risk\"\n- \"Validate the execution target\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Generate concise execution audit reports tracking documents consulted, MCP tools used, decisions made, and outcomes.", "name": "execution-summary", - "summary_markdown": "Generate concise execution audit reports tracking documents consulted, MCP tools used, decisions made, and outcomes.\n**Use when:**\n- \"Generate execution summary\"\n- \"Create execution report\"\n- \"Show workflow audit trail\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Generate concise execution audit reports tracking documents consulted, MCP tools used, decisions made, and outcomes.\n**Use when:**\n- \"Generate execution summary\"\n- \"Create execution report\"\n- \"Show workflow audit trail\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Assess AAP platform governance readiness -- full 7-domain audit or scoped to specific domains.", "name": "governance-readiness-assessor", - "summary_markdown": "Assess AAP platform governance readiness -- full 7-domain audit or scoped to specific domains.\n**Use when:**\n- \"What should I fix before executing jobs?\"\n- \"Assess my AAP configuration\"\n- \"See CLAUDE.md intent routing\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Assess AAP platform governance readiness -- full 7-domain audit or scoped to specific domains.\n**Use when:**\n- \"What should I fix before executing jobs?\"\n- \"Assess my AAP configuration\"\n- \"See AGENTS.md intent routing\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Execute governed job launches with check mode, approval gates, phased rollout, and rollback.", "name": "governed-job-launcher", - "summary_markdown": "Execute governed job launches with check mode, approval gates, phased rollout, and rollback.\n**Use when:**\n- \"Launch with check mode first\"\n- \"Execute the job\"\n- \"Rollback the failed job\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Execute governed job launches with check mode, approval gates, phased rollout, and rollback.\n**Use when:**\n- \"Launch with check mode first\"\n- \"Execute the job\"\n- \"Rollback the failed job\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Correlate job failures with host system facts to determine platform drift and resource issues.", "name": "host-fact-inspector", - "summary_markdown": "Correlate job failures with host system facts to determine platform drift and resource issues.\n**Use when:**\n- \"Check the system facts for failed hosts\"\n- \"Is the host healthy?\"\n- \"Why is the service failing on this host?\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Correlate job failures with host system facts to determine platform drift and resource issues.\n**Use when:**\n- \"Check the system facts for failed hosts\"\n- \"Is the host healthy?\"\n- \"Why is the service failing on this host?\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Extract and analyze failure events from AAP jobs to classify errors and reconstruct failure timelines.", "name": "job-failure-analyzer", - "summary_markdown": "Extract and analyze failure events from AAP jobs to classify errors and reconstruct failure timelines.\n**Use when:**\n- \"Job #X failed\"\n- \"Analyze the failed job\"\n- \"Show me the failure details\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Extract and analyze failure events from AAP jobs to classify errors and reconstruct failure timelines.\n**Use when:**\n- \"Job #X failed\"\n- \"Analyze the failed job\"\n- \"Show me the failure details\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Provide Red Hat documentation-backed resolution recommendations for classified job errors.", "name": "resolution-advisor", - "summary_markdown": "Provide Red Hat documentation-backed resolution recommendations for classified job errors.\n**Use when:**\n- \"What does Red Hat recommend for this error?\"\n- \"What's the fix for privilege escalation timeout?\"\n- \"Is this a known AAP issue?\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Provide Red Hat documentation-backed resolution recommendations for classified job errors.\n**Use when:**\n- \"What does Red Hat recommend for this error?\"\n- \"What's the fix for privilege escalation timeout?\"\n- \"Is this a known AAP issue?\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" } ], "skills_decision_guide": [ @@ -155,7 +155,7 @@ "workflow": "User: \"I only want risk analysis before I approve launch\"\n- `/aap-mcp-validator` confirms MCP reachability\n- `/execution-risk-analyzer` classifies targets and variables\n- `/governed-job-launcher` runs with the agreed mode and gates\n" } ], - "summary": "The rh-automation collection ships 11 catalogued skills for Red Hat automation workflows described in README and CLAUDE.md; orchestration entries coordinate sub-skills with explicit approvals.\n", + "summary": "The rh-automation collection ships 11 catalogued skills for Red Hat automation workflows described in README and AGENTS.md; orchestration entries coordinate sub-skills with explicit approvals.\n", "support_level": "Unknown", "version": "0.1.0" } diff --git a/rh-automation/.catalog/collection.yaml b/rh-automation/.catalog/collection.yaml index 9050b05a..19a6a089 100644 --- a/rh-automation/.catalog/collection.yaml +++ b/rh-automation/.catalog/collection.yaml @@ -1,5 +1,5 @@ # Catalog: maintained via create-collection workflow (assistant + maintainer + PR review). -# Golden sources: skills/*/SKILL.md, README.md, CLAUDE.md, marketplace/rh-agentic-collection.yml +# Golden sources: skills/*/SKILL.md, README.md, AGENTS.md, marketplace/rh-agentic-collection.yml # Do not edit ad hoc — follow COLLECTION_SPEC.md and the create-collection skill. id: rh-automation @@ -23,10 +23,10 @@ support_level: Unknown maturity: ORANGE description: "Ansible Automation Platform governance, execution safety, and forensic troubleshooting tools for Red Hat automation engineers." summary: | - The rh-automation collection ships 11 catalogued skills for Red Hat automation workflows described in README and CLAUDE.md; orchestration entries coordinate sub-skills with explicit approvals. + The rh-automation collection ships 11 catalogued skills for Red Hat automation workflows described in README and AGENTS.md; orchestration entries coordinate sub-skills with explicit approvals. contents: description: | - The pack provides 8 skills and 3 orchestration skills for rh automation workflows on Red Hat platforms; see CLAUDE.md for intent routing. + The pack provides 8 skills and 3 orchestration skills for rh automation workflows on Red Hat platforms; see AGENTS.md for intent routing. skills: - name: aap-mcp-validator description: "Validate that required AAP MCP servers are accessible before executing automation skills." @@ -35,10 +35,10 @@ contents: **Use when:** - "Validate AAP MCP" - "Verify AAP connection" - - "See CLAUDE.md intent routing" + - "See AGENTS.md intent routing" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: execution-risk-analyzer description: "Analyze execution risk by classifying inventory, scanning extra_vars for secrets, and assessing scope." summary_markdown: | @@ -50,7 +50,7 @@ contents: - "Validate the execution target" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: execution-summary description: "Generate concise execution audit reports tracking documents consulted, MCP tools used, decisions made, and outcomes." summary_markdown: | @@ -61,7 +61,7 @@ contents: - "Show workflow audit trail" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: governance-readiness-assessor description: "Assess AAP platform governance readiness -- full 7-domain audit or scoped to specific domains." summary_markdown: | @@ -69,10 +69,10 @@ contents: **Use when:** - "What should I fix before executing jobs?" - "Assess my AAP configuration" - - "See CLAUDE.md intent routing" + - "See AGENTS.md intent routing" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: governed-job-launcher description: "Execute governed job launches with check mode, approval gates, phased rollout, and rollback." summary_markdown: | @@ -83,7 +83,7 @@ contents: - "Rollback the failed job" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: host-fact-inspector description: "Correlate job failures with host system facts to determine platform drift and resource issues." summary_markdown: | @@ -94,7 +94,7 @@ contents: - "Why is the service failing on this host?" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: job-failure-analyzer description: "Extract and analyze failure events from AAP jobs to classify errors and reconstruct failure timelines." summary_markdown: | @@ -105,7 +105,7 @@ contents: - "Show me the failure details" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: resolution-advisor description: "Provide Red Hat documentation-backed resolution recommendations for classified job errors." summary_markdown: | @@ -116,7 +116,7 @@ contents: - "Is this a known AAP issue?" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. orchestration_skills: - name: forensic-troubleshooter description: "Orchestrates forensic analysis of failed jobs with event extraction, host correlation, and resolution advisory." @@ -128,29 +128,29 @@ contents: - "Root cause analysis of job #X" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: governance-assessor description: "Orchestrates AAP governance readiness assessments -- full platform audit or scoped to specific domains." summary_markdown: | Orchestrates AAP governance readiness assessments -- full platform audit or scoped to specific domains. **Use when:** - "What should I fix before executing jobs?" - - "See CLAUDE.md intent routing" - - "See CLAUDE.md intent routing" + - "See AGENTS.md intent routing" + - "See AGENTS.md intent routing" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: governance-executor description: "Orchestrates governed job execution with risk analysis, check mode, approval, and rollback." summary_markdown: | Orchestrates governed job execution with risk analysis, check mode, approval, and rollback. **Use when:** - "Execute job template X" - - "See CLAUDE.md intent routing" - - "See CLAUDE.md intent routing" + - "See AGENTS.md intent routing" + - "See AGENTS.md intent routing" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. skills_decision_guide: - user_request: "\"Governance audit\" or \"production readiness\"" skill_to_use: governance-assessor diff --git a/rh-automation/.catalog/deploy_and_use.md b/rh-automation/.catalog/deploy_and_use.md index 1a1b3fde..054a6d09 100644 --- a/rh-automation/.catalog/deploy_and_use.md +++ b/rh-automation/.catalog/deploy_and_use.md @@ -1,6 +1,6 @@ ### Prerequisites diff --git a/rh-automation/.catalog/mcp_section.md b/rh-automation/.catalog/mcp_section.md index f605ca86..da9f2bba 100644 --- a/rh-automation/.catalog/mcp_section.md +++ b/rh-automation/.catalog/mcp_section.md @@ -1,6 +1,6 @@ | Server | Role | diff --git a/rh-automation/CLAUDE.md b/rh-automation/AGENTS.md similarity index 100% rename from rh-automation/CLAUDE.md rename to rh-automation/AGENTS.md diff --git a/rh-basic/.catalog/collection.yaml b/rh-basic/.catalog/collection.yaml index 14e8dc27..df4a317c 100644 --- a/rh-basic/.catalog/collection.yaml +++ b/rh-basic/.catalog/collection.yaml @@ -1,5 +1,5 @@ # Catalog: maintained via create-collection workflow (assistant + maintainer + PR review). -# Golden sources: skills/*/SKILL.md, README.md, CLAUDE.md, marketplace/rh-agentic-collection.yml +# Golden sources: skills/*/SKILL.md, README.md, AGENTS.md, marketplace/rh-agentic-collection.yml # Do not edit ad hoc — follow COLLECTION_SPEC.md and the create-collection skill. id: rh-basic diff --git a/rh-basic/.catalog/deploy_and_use.md b/rh-basic/.catalog/deploy_and_use.md index caea0a9a..f7fbddd4 100644 --- a/rh-basic/.catalog/deploy_and_use.md +++ b/rh-basic/.catalog/deploy_and_use.md @@ -1,6 +1,6 @@ ### Prerequisites diff --git a/rh-basic/.catalog/documentation_section.md b/rh-basic/.catalog/documentation_section.md index d1c85720..9b491e3e 100644 --- a/rh-basic/.catalog/documentation_section.md +++ b/rh-basic/.catalog/documentation_section.md @@ -1,6 +1,6 @@ Skills source authoritative content from official Red Hat documentation at runtime using `WebFetch`. No offline doc corpus is bundled; the pack stays lean and always reflects current Red Hat guidance. diff --git a/rh-basic/.catalog/mcp_section.md b/rh-basic/.catalog/mcp_section.md index 0d258c19..7c190ace 100644 --- a/rh-basic/.catalog/mcp_section.md +++ b/rh-basic/.catalog/mcp_section.md @@ -1,6 +1,6 @@ ### red-hat-security — Red Hat Security MCP diff --git a/rh-basic/.catalog/security_model.md b/rh-basic/.catalog/security_model.md index 947304df..3d26d2ee 100644 --- a/rh-basic/.catalog/security_model.md +++ b/rh-basic/.catalog/security_model.md @@ -1,6 +1,6 @@ - **Credentials:** Browser SSO only for `red-hat-security`; no API keys or client secrets are required for `mcps.json`. diff --git a/rh-basic/CLAUDE.md b/rh-basic/AGENTS.md similarity index 100% rename from rh-basic/CLAUDE.md rename to rh-basic/AGENTS.md diff --git a/rh-basic/README.md b/rh-basic/README.md index abd0b2c6..140315de 100644 --- a/rh-basic/README.md +++ b/rh-basic/README.md @@ -147,7 +147,7 @@ Provides CVE, advisory, and errata data from the Red Hat Security API. ``` rh-basic/ ├── README.md -├── CLAUDE.md +├── AGENTS.md ├── mcps.json └── skills/ ├── red-hat-cve-explainer/SKILL.md diff --git a/rh-developer/.catalog/collection.yaml b/rh-developer/.catalog/collection.yaml index cd72ea41..9e45acba 100644 --- a/rh-developer/.catalog/collection.yaml +++ b/rh-developer/.catalog/collection.yaml @@ -1,5 +1,5 @@ # Catalog: maintained via create-collection workflow (assistant + maintainer + PR review). -# Golden sources: skills/*/SKILL.md, README.md, CLAUDE.md, marketplace/rh-agentic-collection.yml +# Golden sources: skills/*/SKILL.md, README.md, AGENTS.md, marketplace/rh-agentic-collection.yml # Do not edit ad hoc — follow COLLECTION_SPEC.md and the create-collection skill. id: rh-developer diff --git a/rh-developer/.catalog/deploy_and_use.md b/rh-developer/.catalog/deploy_and_use.md index 1223a49c..b11b723b 100644 --- a/rh-developer/.catalog/deploy_and_use.md +++ b/rh-developer/.catalog/deploy_and_use.md @@ -1,6 +1,6 @@ ### Prerequisites diff --git a/rh-developer/.catalog/documentation_section.md b/rh-developer/.catalog/documentation_section.md index bea3a80a..f6a5509c 100644 --- a/rh-developer/.catalog/documentation_section.md +++ b/rh-developer/.catalog/documentation_section.md @@ -1,6 +1,6 @@ ### Why use skills instead of raw MCP tools? @@ -15,4 +15,4 @@ See **`docs/`** for deep dives: `prerequisites.md`, `human-in-the-loop.md`, `ima ### Routing -Use **`CLAUDE.md`** intent routing to pick a single skill; use **`/containerize-deploy`** when the user wants an end-to-end guided path with checkpoints. +Use **`AGENTS.md`** intent routing to pick a single skill; use **`/containerize-deploy`** when the user wants an end-to-end guided path with checkpoints. diff --git a/rh-developer/.catalog/mcp_section.md b/rh-developer/.catalog/mcp_section.md index b416ad93..1e922078 100644 --- a/rh-developer/.catalog/mcp_section.md +++ b/rh-developer/.catalog/mcp_section.md @@ -1,6 +1,6 @@ | Server | Role | diff --git a/rh-developer/.catalog/security_model.md b/rh-developer/.catalog/security_model.md index 63e9122e..0eda4c3f 100644 --- a/rh-developer/.catalog/security_model.md +++ b/rh-developer/.catalog/security_model.md @@ -1,6 +1,6 @@ - Never echo tokens, kubeconfig contents, or registry passwords — only whether variables appear set. diff --git a/rh-developer/CLAUDE.md b/rh-developer/AGENTS.md similarity index 100% rename from rh-developer/CLAUDE.md rename to rh-developer/AGENTS.md diff --git a/rh-sre/.catalog/collection.yaml b/rh-sre/.catalog/collection.yaml index 0d74e6c1..549cc8df 100644 --- a/rh-sre/.catalog/collection.yaml +++ b/rh-sre/.catalog/collection.yaml @@ -1,5 +1,5 @@ # Catalog: maintained via create-collection workflow (assistant + maintainer + PR review). -# Golden sources: skills/*/SKILL.md, README.md, CLAUDE.md, marketplace/rh-agentic-collection.yml +# Golden sources: skills/*/SKILL.md, README.md, AGENTS.md, marketplace/rh-agentic-collection.yml # Do not edit ad hoc — follow COLLECTION_SPEC.md and the create-collection skill. id: rh-sre diff --git a/rh-sre/.catalog/deploy_and_use.md b/rh-sre/.catalog/deploy_and_use.md index 5ad2cdd0..fd3ae409 100644 --- a/rh-sre/.catalog/deploy_and_use.md +++ b/rh-sre/.catalog/deploy_and_use.md @@ -1,6 +1,6 @@ ### Prerequisites diff --git a/rh-sre/.catalog/documentation_section.md b/rh-sre/.catalog/documentation_section.md index fa32b1fa..7934d82b 100644 --- a/rh-sre/.catalog/documentation_section.md +++ b/rh-sre/.catalog/documentation_section.md @@ -1,6 +1,6 @@ ### Why use this collection instead of calling MCP tools directly? @@ -17,4 +17,4 @@ This pack ships an AI-oriented knowledge base under **`docs/`**. Start at **[doc ### Configuration and architecture - Environment variables for Lightspeed and AAP are declared only as `${VAR}` placeholders in **`mcps.json`**. -- Orchestration (**`/remediation`**) chains impact, validation, context, playbook generation, execution, and verification; see pack **CLAUDE.md** for routing when you need a single step only. +- Orchestration (**`/remediation`**) chains impact, validation, context, playbook generation, execution, and verification; see pack **AGENTS.md** for routing when you need a single step only. diff --git a/rh-sre/.catalog/mcp_section.md b/rh-sre/.catalog/mcp_section.md index 7f20179c..5bfc00c1 100644 --- a/rh-sre/.catalog/mcp_section.md +++ b/rh-sre/.catalog/mcp_section.md @@ -1,6 +1,6 @@ | Server | Role | diff --git a/rh-sre/.catalog/security_model.md b/rh-sre/.catalog/security_model.md index 8b1be467..32134a86 100644 --- a/rh-sre/.catalog/security_model.md +++ b/rh-sre/.catalog/security_model.md @@ -1,6 +1,6 @@ - Do **not** expose `LIGHTSPEED_CLIENT_ID`, `LIGHTSPEED_CLIENT_SECRET`, AAP tokens, or any API credentials in chat—only whether they appear configured. diff --git a/rh-sre/CLAUDE.md b/rh-sre/AGENTS.md similarity index 100% rename from rh-sre/CLAUDE.md rename to rh-sre/AGENTS.md diff --git a/rh-virt/.catalog/collection.json b/rh-virt/.catalog/collection.json index cc7ff621..df83cfd4 100644 --- a/rh-virt/.catalog/collection.json +++ b/rh-virt/.catalog/collection.json @@ -11,58 +11,58 @@ "Virt" ], "contents": { - "description": "The pack provides 10 skills for rh virt workflows on Red Hat platforms; see CLAUDE.md for intent routing.\n", + "description": "The pack provides 10 skills for rh virt workflows on Red Hat platforms; see AGENTS.md for intent routing.\n", "orchestration_skills": [], "skills": [ { "description": "Clone existing virtual machines for testing, scaling, or creating templates.", "name": "vm-clone", - "summary_markdown": "Clone existing virtual machines for testing, scaling, or creating templates.\n**Use when:**\n- \"Clone VM [source] to [target]\"\n- \"Create a copy of VM [name]\"\n- \"Duplicate VM [name] for testing\"\n- \"Create 3 copies of template-vm\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Clone existing virtual machines for testing, scaling, or creating templates.\n**Use when:**\n- \"Clone VM [source] to [target]\"\n- \"Create a copy of VM [name]\"\n- \"Duplicate VM [name] for testing\"\n- \"Create 3 copies of template-vm\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Create new virtual machines in OpenShift Virtualization with automatic instance type resolution and OS selection.", "name": "vm-create", - "summary_markdown": "Create new virtual machines in OpenShift Virtualization with automatic instance type resolution and OS selection.\n**Use when:**\n- \"Create a new VM\"\n- \"Deploy a virtual machine with [OS]\"\n- \"Set up a VM in namespace [name]\"\n- \"Provision a [size] VM\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Create new virtual machines in OpenShift Virtualization with automatic instance type resolution and OS selection.\n**Use when:**\n- \"Create a new VM\"\n- \"Deploy a virtual machine with [OS]\"\n- \"Set up a VM in namespace [name]\"\n- \"Provision a [size] VM\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Permanently delete virtual machines and their associated resources from OpenShift Virtualization.", "name": "vm-delete", - "summary_markdown": "Permanently delete virtual machines and their associated resources from OpenShift Virtualization.\n**Use when:**\n- \"Delete VM [name]\"\n- \"Remove virtual machine [name]\"\n- \"Destroy VM [name]\"\n- \"Clean up VM [name]\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Permanently delete virtual machines and their associated resources from OpenShift Virtualization.\n**Use when:**\n- \"Delete VM [name]\"\n- \"Remove virtual machine [name]\"\n- \"Destroy VM [name]\"\n- \"Clean up VM [name]\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "List and view virtual machines across namespaces with status, resource usage, and health information.", "name": "vm-inventory", - "summary_markdown": "List and view virtual machines across namespaces with status, resource usage, and health information.\n**Use when:**\n- \"List all VMs\"\n- \"Show VMs in namespace [name]\"\n- \"What VMs are running?\"\n- \"Get details of VM [name]\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "List and view virtual machines across namespaces with status, resource usage, and health information.\n**Use when:**\n- \"List all VMs\"\n- \"Show VMs in namespace [name]\"\n- \"What VMs are running?\"\n- \"Get details of VM [name]\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Manage virtual machine lifecycle operations including start, stop, and restart.", "name": "vm-lifecycle-manager", - "summary_markdown": "Manage virtual machine lifecycle operations including start, stop, and restart.\n**Use when:**\n- \"Start VM [name]\"\n- \"Stop the virtual machine [name]\"\n- \"Restart VM [name]\"\n- \"Power on/off VM [name]\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Manage virtual machine lifecycle operations including start, stop, and restart.\n**Use when:**\n- \"Start VM [name]\"\n- \"Stop the virtual machine [name]\"\n- \"Restart VM [name]\"\n- \"Power on/off VM [name]\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Orchestrate VM migrations across cluster nodes for load balancing, maintenance, and resource optimization.", "name": "vm-rebalance", - "summary_markdown": "Orchestrate VM migrations across cluster nodes for load balancing, maintenance, and resource optimization.\n**Use when:**\n- \"Move VM database-01 to worker-03\"\n- \"Rebalance VMs to optimize CPU load\"\n- \"Drain worker-02 for maintenance\"\n- \"Automatically rebalance the cluster\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Orchestrate VM migrations across cluster nodes for load balancing, maintenance, and resource optimization.\n**Use when:**\n- \"Move VM database-01 to worker-03\"\n- \"Rebalance VMs to optimize CPU load\"\n- \"Drain worker-02 for maintenance\"\n- \"Automatically rebalance the cluster\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Create virtual machine snapshots for backup and recovery.", "name": "vm-snapshot-create", - "summary_markdown": "Create virtual machine snapshots for backup and recovery.\n**Use when:**\n- \"Create a snapshot of VM [name]\"\n- \"Backup VM [name] before upgrade\"\n- \"Take a snapshot of [vm]\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Create virtual machine snapshots for backup and recovery.\n**Use when:**\n- \"Create a snapshot of VM [name]\"\n- \"Backup VM [name] before upgrade\"\n- \"Take a snapshot of [vm]\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Permanently delete virtual machine snapshots to free storage space.", "name": "vm-snapshot-delete", - "summary_markdown": "Permanently delete virtual machine snapshots to free storage space.\n**Use when:**\n- \"Delete snapshot [snapshot-name]\"\n- \"Remove old snapshots for VM [name]\"\n- \"Free up snapshot storage\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Permanently delete virtual machine snapshots to free storage space.\n**Use when:**\n- \"Delete snapshot [snapshot-name]\"\n- \"Remove old snapshots for VM [name]\"\n- \"Free up snapshot storage\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "List virtual machine snapshots across namespaces with status, age, and recovery information.", "name": "vm-snapshot-list", - "summary_markdown": "List virtual machine snapshots across namespaces with status, age, and recovery information.\n**Use when:**\n- \"List snapshots for VM [name]\"\n- \"Show snapshots in namespace [name]\"\n- \"What snapshots exist for [vm]?\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "List virtual machine snapshots across namespaces with status, age, and recovery information.\n**Use when:**\n- \"List snapshots for VM [name]\"\n- \"Show snapshots in namespace [name]\"\n- \"What snapshots exist for [vm]?\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" }, { "description": "Restore virtual machines from snapshots with strict safety confirmations to prevent data loss.", "name": "vm-snapshot-restore", - "summary_markdown": "Restore virtual machines from snapshots with strict safety confirmations to prevent data loss.\n**Use when:**\n- \"Restore VM [name] from snapshot [snapshot-name]\"\n- \"Roll back VM [name] to snapshot\"\n- \"Recover VM [name] from backup\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with CLAUDE.md chaining when users need follow-on skills.\n" + "summary_markdown": "Restore virtual machines from snapshots with strict safety confirmations to prevent data loss.\n**Use when:**\n- \"Restore VM [name] from snapshot [snapshot-name]\"\n- \"Roll back VM [name] to snapshot\"\n- \"Recover VM [name] from backup\"\n**What it does:**\n- Runs the documented workflow with MCP access only through the skill and required confirmations.\n- Aligns with AGENTS.md chaining when users need follow-on skills.\n" } ], "skills_decision_guide": [ diff --git a/rh-virt/.catalog/collection.yaml b/rh-virt/.catalog/collection.yaml index 76cc07ff..c402295d 100644 --- a/rh-virt/.catalog/collection.yaml +++ b/rh-virt/.catalog/collection.yaml @@ -1,5 +1,5 @@ # Catalog: maintained via create-collection workflow (assistant + maintainer + PR review). -# Golden sources: skills/*/SKILL.md, README.md, CLAUDE.md, marketplace/rh-agentic-collection.yml +# Golden sources: skills/*/SKILL.md, README.md, AGENTS.md, marketplace/rh-agentic-collection.yml # Do not edit ad hoc — follow COLLECTION_SPEC.md and the create-collection skill. id: openshift-virtualization @@ -24,7 +24,7 @@ summary: | The rh-virt collection ships 10 skills for OpenShift Virtualization operations with confirmations on destructive steps. contents: description: | - The pack provides 10 skills for rh virt workflows on Red Hat platforms; see CLAUDE.md for intent routing. + The pack provides 10 skills for rh virt workflows on Red Hat platforms; see AGENTS.md for intent routing. skills: - name: vm-clone description: "Clone existing virtual machines for testing, scaling, or creating templates." @@ -37,7 +37,7 @@ contents: - "Create 3 copies of template-vm" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: vm-create description: "Create new virtual machines in OpenShift Virtualization with automatic instance type resolution and OS selection." summary_markdown: | @@ -49,7 +49,7 @@ contents: - "Provision a [size] VM" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: vm-delete description: "Permanently delete virtual machines and their associated resources from OpenShift Virtualization." summary_markdown: | @@ -61,7 +61,7 @@ contents: - "Clean up VM [name]" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: vm-inventory description: "List and view virtual machines across namespaces with status, resource usage, and health information." summary_markdown: | @@ -73,7 +73,7 @@ contents: - "Get details of VM [name]" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: vm-lifecycle-manager description: "Manage virtual machine lifecycle operations including start, stop, and restart." summary_markdown: | @@ -85,7 +85,7 @@ contents: - "Power on/off VM [name]" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: vm-rebalance description: "Orchestrate VM migrations across cluster nodes for load balancing, maintenance, and resource optimization." summary_markdown: | @@ -97,7 +97,7 @@ contents: - "Automatically rebalance the cluster" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: vm-snapshot-create description: "Create virtual machine snapshots for backup and recovery." summary_markdown: | @@ -108,7 +108,7 @@ contents: - "Take a snapshot of [vm]" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: vm-snapshot-delete description: "Permanently delete virtual machine snapshots to free storage space." summary_markdown: | @@ -119,7 +119,7 @@ contents: - "Free up snapshot storage" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: vm-snapshot-list description: "List virtual machine snapshots across namespaces with status, age, and recovery information." summary_markdown: | @@ -130,7 +130,7 @@ contents: - "What snapshots exist for [vm]?" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. - name: vm-snapshot-restore description: "Restore virtual machines from snapshots with strict safety confirmations to prevent data loss." summary_markdown: | @@ -141,7 +141,7 @@ contents: - "Recover VM [name] from backup" **What it does:** - Runs the documented workflow with MCP access only through the skill and required confirmations. - - Aligns with CLAUDE.md chaining when users need follow-on skills. + - Aligns with AGENTS.md chaining when users need follow-on skills. orchestration_skills: [] skills_decision_guide: - user_request: "\"Create VM\"" diff --git a/rh-virt/.catalog/deploy_and_use.md b/rh-virt/.catalog/deploy_and_use.md index 16f3a2a5..f2479f39 100644 --- a/rh-virt/.catalog/deploy_and_use.md +++ b/rh-virt/.catalog/deploy_and_use.md @@ -1,6 +1,6 @@ ### Prerequisites diff --git a/rh-virt/.catalog/mcp_section.md b/rh-virt/.catalog/mcp_section.md index 0ae104a3..4b2890e9 100644 --- a/rh-virt/.catalog/mcp_section.md +++ b/rh-virt/.catalog/mcp_section.md @@ -1,6 +1,6 @@ | Server | Role | diff --git a/rh-virt/CLAUDE.md b/rh-virt/AGENTS.md similarity index 100% rename from rh-virt/CLAUDE.md rename to rh-virt/AGENTS.md diff --git a/scripts/bootstrap_catalog.py b/scripts/bootstrap_catalog.py index a427eff8..530e91bb 100644 --- a/scripts/bootstrap_catalog.py +++ b/scripts/bootstrap_catalog.py @@ -3,7 +3,7 @@ Bootstrap /.catalog/collection.yaml for every union-registry pack (initial CI-friendly content). Intended for first-time repo setup; refine catalogs via the create-collection skill and PRs. -Does not modify README, SKILL, CLAUDE, or marketplace files. +Does not modify README, SKILL, AGENTS, or marketplace files. """ from __future__ import annotations @@ -21,7 +21,7 @@ REPO_ROOT = Path(__file__).resolve().parent.parent CATALOG_YAML_BANNER = """# Catalog: maintained via create-collection workflow (assistant + maintainer + PR review). -# Golden sources: skills/*/SKILL.md, README.md, CLAUDE.md, marketplace/rh-agentic-collection.yml +# Golden sources: skills/*/SKILL.md, README.md, AGENTS.md, marketplace/rh-agentic-collection.yml # Do not edit ad hoc — follow COLLECTION_SPEC.md and the create-collection skill. """ @@ -66,7 +66,7 @@ def _skill_entries(pack_dir: str, root: Path) -> Tuple[List[Dict[str, Any]], Lis if len(desc) > 220: desc = desc[:217] + "..." sm = ( - f"**Use when:** See the skill description and CLAUDE.md intent routing.\n\n" + f"**Use when:** See the skill description and AGENTS.md intent routing.\n\n" f"**What it does:** {desc or 'See SKILL.md for workflow and prerequisites.'}" ) entry = {"name": name, "description": desc or f"Skill `{name}` in pack `{pack_dir}`.", "summary_markdown": sm} @@ -84,7 +84,7 @@ def _decision_rows(pack_dir: str, regular: List[Dict[str, Any]], orch: List[Dict { "user_request": f'User: "I need help related to {s["name"]}"', "skill_to_use": s["name"], - "reason": f"Use `{s['name']}` for workflows described in that skill and in CLAUDE.md.", + "reason": f"Use `{s['name']}` for workflows described in that skill and in AGENTS.md.", } ) return rows @@ -119,7 +119,7 @@ def build_collection_data(pack_dir: str, root: Path) -> Dict[str, Any]: "name": "Choose the right skill", "workflow": ( 'User: "I have a task for this collection"\n' - "- Open CLAUDE.md intent routing and match your request to a skill name.\n" + "- Open AGENTS.md intent routing and match your request to a skill name.\n" "- Invoke that skill and follow its workflow and prerequisites.\n" ), } diff --git a/scripts/validate_structure.py b/scripts/validate_structure.py index f60caa7f..9fa2bff9 100644 --- a/scripts/validate_structure.py +++ b/scripts/validate_structure.py @@ -1,6 +1,6 @@ #!/usr/bin/env python3 """ -Validate agentic collection pack structure (mcps.json, CLAUDE.md; plugin.json optional). +Validate agentic collection pack structure (mcps.json, AGENTS.md; plugin.json optional). Skill-level validation (frontmatter, sections, security) is handled by validate-skills.sh and run-skill-linter.sh. @@ -17,6 +17,9 @@ # Union of Lola marketplace paths and docs/plugins.json keys (existing dirs only) PACK_DIRS = pack_registry.get_union_pack_dirs() +AGENTS_MD_FILENAME = "AGENTS.md" +AGENTS_MD_DEPRECATED = "CLAUDE.md" + def validate_plugin_json(pack_dir: str) -> List[str]: """ @@ -103,7 +106,7 @@ def validate_mcp_json(pack_dir: str) -> List[str]: return errors -CLAUDE_MD_REQUIRED_SECTIONS = [ +AGENTS_MD_REQUIRED_SECTIONS = [ "Skill-First Rule", "Intent Routing", "MCP Servers", @@ -111,12 +114,13 @@ def validate_mcp_json(pack_dir: str) -> List[str]: ] -def validate_claude_md(pack_dir: str) -> List[str]: +def validate_agents_md(pack_dir: str) -> List[str]: """ - Validate CLAUDE.md presence and structure. + Validate AGENTS.md presence and structure. Required for any pack that has skills. Checks for required sections and verifies that all skills appear in the intent routing content. + Errors if deprecated pack-level CLAUDE.md exists (Lola manages AGENTS.md). Args: pack_dir: Pack directory name @@ -125,25 +129,38 @@ def validate_claude_md(pack_dir: str) -> List[str]: List of error messages (empty if valid) """ errors = [] - claude_path = Path(pack_dir) / 'CLAUDE.md' - skills_dir = Path(pack_dir) / 'skills' + pack_path = Path(pack_dir) + deprecated_path = pack_path / AGENTS_MD_DEPRECATED + agents_path = pack_path / AGENTS_MD_FILENAME + skills_dir = pack_path / 'skills' has_skills = skills_dir.exists() and any(skills_dir.glob('*/SKILL.md')) - if not claude_path.exists(): + if deprecated_path.exists(): + errors.append( + f"{pack_dir}: deprecated pack-level {AGENTS_MD_DEPRECATED} found; " + f"rename to {AGENTS_MD_FILENAME} (Lola AI Context Module convention)" + ) + return errors + + if not agents_path.exists(): if has_skills: - errors.append(f"{pack_dir}: Missing CLAUDE.md (required for packs with skills)") + errors.append( + f"{pack_dir}: Missing {AGENTS_MD_FILENAME} (required for packs with skills)" + ) return errors try: - with open(claude_path, 'r', encoding='utf-8') as f: + with open(agents_path, 'r', encoding='utf-8') as f: content = f.read() # Check required sections headings = re.findall(r'^## (.+)$', content, re.MULTILINE) - for section in CLAUDE_MD_REQUIRED_SECTIONS: + for section in AGENTS_MD_REQUIRED_SECTIONS: if not any(section in h for h in headings): - errors.append(f"{pack_dir}: CLAUDE.md missing required section '## {section}'") + errors.append( + f"{pack_dir}: {AGENTS_MD_FILENAME} missing required section '## {section}'" + ) # Check intent routing completeness if has_skills: @@ -151,11 +168,11 @@ def validate_claude_md(pack_dir: str) -> List[str]: for skill_name in skill_names: if skill_name not in content: errors.append( - f"{pack_dir}: CLAUDE.md intent routing missing skill '{skill_name}'" + f"{pack_dir}: {AGENTS_MD_FILENAME} intent routing missing skill '{skill_name}'" ) except Exception as e: - errors.append(f"{pack_dir}: Error reading CLAUDE.md: {e}") + errors.append(f"{pack_dir}: Error reading {AGENTS_MD_FILENAME}: {e}") return errors @@ -183,8 +200,8 @@ def validate_pack(pack_dir: str) -> List[str]: # Validate mcps.json errors.extend(validate_mcp_json(pack_dir)) - # Validate CLAUDE.md - errors.extend(validate_claude_md(pack_dir)) + # Validate AGENTS.md + errors.extend(validate_agents_md(pack_dir)) return errors