aboleon/metaframework-codex

Reusable Codex agent rules for Laravel and Aboleon MetaFramework applications

Maintainers

Package info

github.com/aboleon/metaframework-codex

pkg:composer/aboleon/metaframework-codex

Transparency log

Statistics

Installs: 3

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v0.2.2 2026-07-03 08:01 UTC

Requires

MIT 2b7ba74e3f91b756a074d07549c0465d735f4ca2

laravelagentscodexsveltemetaframework

Published on Packagist.org on 2026-07-03 08:01 UTC

This package is auto-updated.

Last update: 2026-07-03 08:02:10 UTC

README

Reusable Codex/agent rules for Laravel applications using the Aboleon MetaFramework ecosystem.

Install

composer require --dev aboleon/metaframework-codex
vendor/bin/mfw-codex-agents install

Install this package as a dev dependency. Its normal Composer dependencies intentionally include Laravel Boost, Laravel PAO, and the Laravel AI SDK so upstream guideline, skill, boost:update, and agent-optimized command-output tooling are available while developing agent rules.

If a consuming application uses Laravel AI SDK at runtime, that application must still require laravel/ai in its own root require section. Do not rely on this dev-only agents package to provide runtime AI dependencies in production installs.

The installer adds a managed include block to the consuming project's AGENTS.md. Existing local project instructions are preserved.

Use a custom target when needed:

vendor/bin/mfw-codex-agents install --target=docs/AGENTS.md

Preview without writing:

vendor/bin/mfw-codex-agents install --dry-run

Consumer Contract

The consuming project's AGENTS.md should keep project-specific facts and overrides. The managed block points agents to mfw-codex-agents.md, which then loads supporting files conditionally:

  • Always: core runtime, repository, delivery quality, and code complexity rules.
  • Code quality: cyclomatic complexity budget, refactoring guidance, acceptable exceptions, and branch-aware testing expectations.
  • Laravel/backend: architecture, Boost, and Laravel best-practice skill rules.
  • MetaFramework/MFW/CSSCrush: project rules.
  • Svelte: Svelte instructions and Svelte-island UI rules.
  • Laravel AI SDK: AI SDK skill.

Do not copy project-specific generated rules into this package. Add only normalized rules that can apply across projects.

Updating Upstream Skills

Laravel, PAO, and AI SDK skill/tooling content is sourced from Laravel packages. To refresh it, update Composer dependencies in a disposable branch or scratch app, run php artisan boost:update --no-interaction, then sync the generated upstream skill directories into this package and review the diff before tagging a new package release.

Package Layout

  • mfw-codex-agents.md: shared entrypoint for downstream projects.
  • .agents/rules/: modular rule files loaded by stack/task.
  • .agents/instructions/: focused instructions for Laravel Boost, MetaFramework/MFW, and Svelte.
  • .agents/skills/: reusable Codex skills.
  • bin/mfw-codex-agents: installer command.