Skip to content

Latest commit

 

History

History
36 lines (22 loc) · 2.11 KB

File metadata and controls

36 lines (22 loc) · 2.11 KB

AI agents and Codebar coding guidelines

This project uses codebar-ag/coding-guidelines (Composer dev dependency). Laravel Boost indexes the app and syncs editor/MCP assets; the guidelines supply shared rules and skills for assistants.

Git: .claude/, .cursor/, .junie/, root .mcp.json, and CLAUDE.md are gitignored (regenerated by Boost). This file stays in the repo as the project index; run php artisan boost:install and php artisan boost:update after composer install on a fresh clone so your editor and Claude Code receive skills and MCP config.

Canonical sources (read these first)

What Where
Rule index vendor/codebar-ag/coding-guidelines/RULES.md
Skill playbooks vendor/codebar-ag/coding-guidelines/resources/boost/skills/**/SKILL.md
Project overrides .ai/skills/{skill-name}/SKILL.md (optional; overrides package skills)

After composer install, vendor/codebar-ag/coding-guidelines resolves from this repo’s path package under packages/coding-guidelines.

Agent roles (prompt personas)

Use the same role set as upstream: ArchitectAgent, BackendImplementationAgent, FrontendImplementationAgent, ImplementationAgent, RefactorAgent, TestAgent, ReviewAgent, DocumentationAgent. Full descriptions and example prompts live in the package’s AGENTS.md (same paths as above, under vendor/.../AGENTS.md).

Example (ReviewAgent)

Ask your assistant:

Act as ReviewAgent. Using RULES.md and all skills under resources/boost/skills/**/SKILL.md from codebar-ag/coding-guidelines, review this diff and produce: (1) a short assessment, (2) a file-grouped refactor plan, (3) a few copy-pasteable suggestions.

Boost CLI

Register and refresh Boost’s guidelines/skills (from a local app environment—Boost does not load when APP_ENV=testing):

php artisan boost:install
php artisan boost:update

See the coding-guidelines README for Boost, MCP, and CI options.