project-agent-guidance

name	project-agent-guidance
metadata	{"author":"rhoai3-demo","version":"1.1.0","platform-family":"rhoai","platform-baseline":"repo","ocp-baseline":"repo","skill-group":"Project Structure"}
description	Manage shared agent guidance for this project — AGENTS.md, shared rules, shared skills, hooks, subagents, and tool bridges. Use when the user asks to create a rule, update a skill, audit rules, review skills, add a hook, create a subagent, remove duplicated tool-specific guidance, or asks about .agents/, .cursor/, .codex/, or .claude/ configuration. Also use when discussing what type of component is appropriate for a given need. For the demo skill taxonomy and RHOAI component roadmap, pair with project-structure. Do NOT use for deploying the demo (use env-deploy-and-evaluate), troubleshooting cluster issues (use env-troubleshoot), or chatbot changes (use rhoai-chatbot-customization).

Maintain Agent Guidance

Structured workflow for creating, updating, and auditing shared agent guidance and tool-specific bridges in this project.

Decision Framework: Which Component Type?

Need	Component	Why
Tool-neutral project contract	AGENTS.md	Applies across agents and should stay concise
Short tool-neutral guidance for a file family or domain	Rule (.agents/rules/*.md)	Small constraints that should apply across tools
Persistent guidance for ALL files	AGENTS.md	Keep always-on instructions concise and tool-neutral