Jinal-Sarvaiya commented on code in PR #189: URL: https://github.com/apache/camel-kit/pull/189#discussion_r4616005486
########## docs/modules/ROOT/pages/architecture.adoc: ########## @@ -59,6 +58,45 @@ front matter against it. See xref:skills.adoc[], xref:mcp.adoc[], xref:knowledge.adoc[], xref:graph.adoc[] and xref:forage.adoc[] for each layer. +[[camel-yaml-guidance]] +=== Camel YAML DSL guidance + +The development snapshot includes fifteen Camel 4.22 YAML DSL rules in the generated agent instructions. These rules +cover placement and value types, `routeConfiguration`, HTTP and mail headers, dependency loading, and ActiveMQ +acknowledgement modes. The +https://github.com/apache/camel-kit/blob/main/kit/camel-kit-core/src/main/resources/templates/shared/agents-md.md#camel-422-rules[maintained +rule list] lives in the shared template and is copied into agent-specific templates during the build. + +**Coverage by agent:** + +* *Claude Code, Bob 2, Qwen, OpenCode*: Use the shared template (`templates/shared/agents-md.md`). These agents load +the rules from their entry file (`CLAUDE.md`, `AGENTS.md`, `QWEN.md`) immediately when the project is opened, before +any skill invocation. +* *Antigravity, Codex CLI, GitHub Copilot CLI, Pi*: Use agent-specific templates +(`templates/{antigravity,codex,copilot,pi}/agents-md.md`) that include the same rule set. Loading behavior varies: +** *Antigravity and Codex CLI*: Rules are available from `AGENTS.md` when the project is opened. +** *GitHub Copilot CLI*: Rules load from `.github/copilot-instructions.md` on first invocation or when the +instructions are refreshed. +** *Pi*: Rules are loaded when Pi reads `AGENTS.md` as project context, typically on first skill invocation or when +the project is explicitly trusted. + +**Schema validation vs. runtime verification:** + +Rule 4 instructs the agent to run `camel validate` on the final YAML file after the last edit. This validates the Review Comment: fixed- "Use camel_validate_yaml_dsl or, with the validate plugin installed, run camel validate yaml <file>" ########## docs/modules/ROOT/pages/architecture.adoc: ########## @@ -59,6 +58,45 @@ front matter against it. See xref:skills.adoc[], xref:mcp.adoc[], xref:knowledge.adoc[], xref:graph.adoc[] and xref:forage.adoc[] for each layer. +[[camel-yaml-guidance]] +=== Camel YAML DSL guidance + +The development snapshot includes fifteen Camel 4.22 YAML DSL rules in the generated agent instructions. These rules +cover placement and value types, `routeConfiguration`, HTTP and mail headers, dependency loading, and ActiveMQ +acknowledgement modes. The +https://github.com/apache/camel-kit/blob/main/kit/camel-kit-core/src/main/resources/templates/shared/agents-md.md#camel-422-rules[maintained +rule list] lives in the shared template and is copied into agent-specific templates during the build. + +**Coverage by agent:** + +* *Claude Code, Bob 2, Qwen, OpenCode*: Use the shared template (`templates/shared/agents-md.md`). These agents load +the rules from their entry file (`CLAUDE.md`, `AGENTS.md`, `QWEN.md`) immediately when the project is opened, before +any skill invocation. Review Comment: fixed- Qwen has its own bullet explaining it reads both QWEN.md and AGENTS.md with trust enabled ########## docs/modules/ROOT/pages/architecture.adoc: ########## @@ -59,6 +58,45 @@ front matter against it. See xref:skills.adoc[], xref:mcp.adoc[], xref:knowledge.adoc[], xref:graph.adoc[] and xref:forage.adoc[] for each layer. +[[camel-yaml-guidance]] +=== Camel YAML DSL guidance + +The development snapshot includes fifteen Camel 4.22 YAML DSL rules in the generated agent instructions. These rules +cover placement and value types, `routeConfiguration`, HTTP and mail headers, dependency loading, and ActiveMQ +acknowledgement modes. The +https://github.com/apache/camel-kit/blob/main/kit/camel-kit-core/src/main/resources/templates/shared/agents-md.md#camel-422-rules[maintained +rule list] lives in the shared template and is copied into agent-specific templates during the build. + +**Coverage by agent:** + +* *Claude Code, Bob 2, Qwen, OpenCode*: Use the shared template (`templates/shared/agents-md.md`). These agents load +the rules from their entry file (`CLAUDE.md`, `AGENTS.md`, `QWEN.md`) immediately when the project is opened, before +any skill invocation. +* *Antigravity, Codex CLI, GitHub Copilot CLI, Pi*: Use agent-specific templates +(`templates/{antigravity,codex,copilot,pi}/agents-md.md`) that include the same rule set. Loading behavior varies: +** *Antigravity and Codex CLI*: Rules are available from `AGENTS.md` when the project is opened. +** *GitHub Copilot CLI*: Rules load from `.github/copilot-instructions.md` on first invocation or when the +instructions are refreshed. +** *Pi*: Rules are loaded when Pi reads `AGENTS.md` as project context, typically on first skill invocation or when +the project is explicitly trusted. Review Comment: fixed- "Pi loads the root AGENTS.md as project context at startup, before project trust or skill invocation" -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
