Problem/Motivation

Applying this recipe has a step that is easy to miss. Varbase's Fast 404 answers 404 for /llms.txt unless its extension list in settings.php is changed, so the recipe looks applied while the file is not served. It needs no AI provider, which is also easy to get wrong when planning the apply order.

An AI coding assistant working on a site that uses the recipe has no guidance for any of this.

Steps to reproduce

  • N/A

Proposed resolution

Ship two files in the recipe repository, written from the recipe's own code:

  • .claude/skills/varbase-ai-readable/SKILL.md: what the recipe installs, the apply commands, the steps after applying, browser checks and known traps.
  • .claude/agents/varbase-ai-readable.md: a thin operator that reads the skill and applies, repairs or verifies the recipe on a DDEV site.

No runtime code or config change. Sites that do not use Claude Code are not affected.

AI-Generated: Yes. Drafted with Claude Code.

Remaining tasks

  • ✅ File an issue
  • ❌ Addition/Change/Update/Fix
  • ❌ Testing to ensure no regression
  • ➖ Automated unit/functional testing coverage
  • ❌ Developer Documentation support
  • ➖ User Guide Documentation support
  • ➖ UX/UI designer responsibilities
  • ➖ Accessibility and Readability
  • ❌ Reviewed by a human
  • ❌ Code review by maintainers
  • ❌ Full testing and approval
  • ❌ Credit contributors
  • ❌ Review with the product owner
  • ✅ Update Release Notes
  • ✅ Release varbase-11.0.x, varbase_ai_readable_base-1.0.0-beta2

User interface changes

  • N/A

API changes

  • N/A

Data model changes

  • N/A

Release notes snippet

  • Added a Claude Code agent and skill for applying and verifying Varbase AI Readable.
Command icon Show commands

Start within a Git clone of the project using the version control instructions.

Or, if you do not have SSH keys set up on git.drupalcode.org:

Comments

rajab natshah created an issue. See original summary.

rajab natshah’s picture

Status: Active » Needs review

Opened MR !10: adds the agent and skill files under .claude/, documentation only. Pipeline green. Ready for review.

  • rajab natshah committed b51c6368 on 1.0.x
    docs: #3633909 Add a Claude Code agent and skill for applying and...
rajab natshah’s picture

rajab natshah’s picture

Issue summary: View changes
Status: Needs review » Fixed

Now that this issue is closed, review the contribution record.

As a contributor, attribute any organization that helped you, or if you volunteered your own time.

Maintainers, credit people who helped resolve this issue.