Skip to content

CAMEL-23702: Make jbang exported project more AI-relevant#24063

Open
k-krawczyk wants to merge 1 commit into
apache:mainfrom
k-krawczyk:CAMEL-23702-ai-relevant-export
Open

CAMEL-23702: Make jbang exported project more AI-relevant#24063
k-krawczyk wants to merge 1 commit into
apache:mainfrom
k-krawczyk:CAMEL-23702-ai-relevant-export

Conversation

@k-krawczyk

Copy link
Copy Markdown
Contributor

CAMEL-23702

The project generated by the Camel CLI (camel export) provided little context for users bootstrapping with coding assistants, which increases effort and the chance of hallucinations.

Changes

  • Added a "For AI coding assistants" section to the generated readme.md (both the JVM readme.md.ftl and the Quarkus native readme.native.md.ftl templates). It points at:
    • the Apache Camel LLM index https://camel.apache.org/llms.txt as the starting point,
    • the convention that any documentation page is available as Markdown by replacing .html with .md,
    • the Camel CLI and Camel MCP server for looking up components, options and the catalog instead of guessing endpoint URIs.
  • Added a new agents.md.ftl template and generate an AGENTS.md file at the exported project root (Export#copyAgents, invoked for all runtimes including the Quarkus override). It gives coding agents a concise "start here", project layout, and build/run guidance.

Testing

mvn test -pl dsl/camel-jbang/camel-jbang-core:

  • TemplateHelperTest (24) — templates render with no unresolved interpolations and contain the llms.txt link; new testAgentsTemplate.
  • ExportTest#shouldGenerateContent / shouldGenerateJavaContent (6) — AGENTS.md is generated for Camel Main, Spring Boot and Quarkus exports.

Relates to CAMEL-23701 (archetypes) and CAMEL-23700 (website agents.md / llms.txt).

Reported by Claude Code on behalf of Karol Krawczyk

Enhance the project generated by the Camel CLI export so that AI coding
assistants get useful context out of the box.

- Add a "For AI coding assistants" section to the generated readme.md
  (both JVM and Quarkus native templates) pointing at the Apache Camel
  LLM index (https://camel.apache.org/llms.txt), the .html->.md Markdown
  trick, and the Camel CLI / MCP server for looking up components.
- Generate an AGENTS.md file at the exported project root with
  project-specific guidance for coding agents (new agents.md.ftl template,
  written by Export#copyAgents for all runtimes including Quarkus).
- Extend TemplateHelperTest and ExportTest accordingly.
@k-krawczyk

Copy link
Copy Markdown
Contributor Author

cc @orpiske (reporter) @Croway @davsclaus for review — this generates an AGENTS.md and an AI-assistant section in the exported project's readme.md for all runtimes (Camel Main, Spring Boot, Quarkus).

Reported by Claude Code on behalf of Karol Krawczyk

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant