beaver

Write clear, user-focused documentation for the product, including concept explanations, tutorials, how-to guides, and onboarding content. Use when creating or improving documentation pages, help center content, user guides, setup instructions, feature explanations, or task-based walkthroughs. Trigger whenever documentation, docs portal, tutorials, guides, concepts, onboarding, help content, or user education are mentioned.

Analyze the codebase and produce a comprehensive implementation plan for the product documentation portal. Inspect the application's features, terminology, configuration, installation, authentication, subscriptions, permissions, and user workflows to design a documentation structure following industry best practices. Use when planning a documentation portal, defining its information architecture, creating a documentation roadmap, or identifying the documentation required before writing the content.

Write or update the public-facing API reference for API methods. Use when a new API controller is created, API routes are added or changed, or when the docs portal at /docs is out of sync with the codebase.

Build a complete API surface for a given model or concept. Use when the user asks to add API methods, expose a resource via API, or mirror a web controller as an API. Activates when user mentions API methods, API controller, API routes, or wants to expose an existing web resource via API.

Actions are what the user does within an application. Use when working with actions.

Add a new locale to the application. Use when the user wants to support an additional language, register a locale in config, and generate its lang/*.json translation file. Trigger whenever adding a language, new locale, or i18n support is mentioned.

Conventions for writing thin HTTP controllers that validate input and delegate to Actions. Use when creating or editing controllers in app/Http/Controllers (web, API, or marketing).

Use when creating or editing database migrations in the project.

Conventions for writing pull requests, including Conventional Commits titles and structured descriptions. Use when the user wants to create or open a pull request, or write a PR title or description. Trigger whenever a pull request, PR, or merge request is mentioned.

Update Laravel PHP translation files by fixing missing or empty translations in lang/**/*.php. Use when UI copy changes, new keys are added, or locale files are out of sync. Trigger whenever translation keys, lang files, i18n, or __() / @lang() strings are mentioned.