PHPackages                             pepperfm/ai-guidelines - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. pepperfm/ai-guidelines

ActiveLibrary

pepperfm/ai-guidelines
======================

Personal Codex/Boost AI guidelines installer (symlink/copy into .ai/guidelines)

1.5.0(1mo ago)0280↓50%MITPHPPHP ^8.3

Since Dec 13Pushed 1mo agoCompare

[ Source](https://github.com/pepperfm/ai-guidelines)[ Packagist](https://packagist.org/packages/pepperfm/ai-guidelines)[ RSS](/packages/pepperfm-ai-guidelines/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (2)Versions (32)Used By (0)

pepperfm/ai-guidelines
======================

[](#pepperfmai-guidelines)

Небольшой Composer‑пакет для установки **личных AI‑гайдлайнов (Codex / Boost)** в проект.

Пакет хранит 2 пресета (по одному `core.md`):

- `laravel` — Codex — Laravel/Sail/MCP Guidelines (Personal Overrides)
- `nuxt-ui` — Nuxt UI — Project Guidelines (Laravel 12 + Vite + Inertia + Tailwind v4)

CLI умеет:

- выбрать пресеты интерактивно (Laravel Prompts),
- создать **symlink** или **copy** в `.ai/guidelines/...`,
- (опционально) запустить `php artisan boost:update` через флаг `--boost-update`, если проект Laravel.

Установка
---------

[](#установка)

```
composer r --dev pepperfm/ai-guidelines
```

Быстрый старт (интерактивно)
----------------------------

[](#быстрый-старт-интерактивно)

Из корня проекта:

```
vendor/bin/pfm-guidelines
```

Команда:

1. спросит какие пресеты подключить,
2. если выбран `laravel`, спросит публиковать ли `laravel/macros.md`,
3. спросит раскладку (layout): `flat-numbered` или `folders`,
4. спросит режим (symlink/copy),
5. спросит путь назначения (target; по умолчанию зависит от layout),
6. создаст/обновит файлы.

Пример для layout `flat-numbered` (по умолчанию target: `.ai/guidelines`):

```
.ai/guidelines/01-core.md
.ai/guidelines/10-laravel.md
.ai/guidelines/11-nuxt-ui.md
.ai/guidelines/011-laravel-macros.md   (опционально)

```

Пример для layout `folders` (по умолчанию target: `.ai/guidelines/pepperfm`):

```
.ai/guidelines/pepperfm/_core/core.md
.ai/guidelines/pepperfm/laravel/core.md
.ai/guidelines/pepperfm/laravel/macros.md   (опционально)
.ai/guidelines/pepperfm/nuxt-ui/core.md

```

Опционально: skills в `.ai/skills` (по умолчанию включено).

Также создаст конфиг в корне проекта: `.pfm-guidelines.json`.

Синхронизация (после composer update)
-------------------------------------

[](#синхронизация-после-composer-update)

```
vendor/bin/pfm-guidelines sync
```

Без интерактива (CI / scripts)
------------------------------

[](#без-интерактива-ci--scripts)

```
vendor/bin/pfm-guidelines sync --no-interaction --mode=copy --presets=laravel,nuxt-ui
```

С автозапуском Boost обновления (если есть `artisan`):

```
vendor/bin/pfm-guidelines sync --boost-update
```

Доступные параметры:

- `--presets=laravel,nuxt-ui`
- `--preset=laravel` (можно указывать несколько раз)
- `--mode=symlink|copy`
- `--layout=flat-numbered|folders`
- `--target=.ai/guidelines`
- `--laravel-macros`
- `--skills[=true|false]`
- `--skills-target=.ai/skills`
- `--write-config`
- `--force` (перезаписывать существующие файлы)
- `--dry-run` (ничего не менять, только показать действия)
- `--no-interaction`
- `--boost-update` (после успешного `sync` запустить `./vendor/bin/sail artisan boost:update`, если есть Sail; иначе `php artisan boost:update`)
- `--config=.pfm-guidelines.json` (путь к конфигу)
- `-V`, `--version`

Связка с Boost / Codex
----------------------

[](#связка-с-boost--codex)

Если проект использует **Laravel Boost**, то после установки гайдлайнов можно выполнить:

```
php artisan boost:update
```

Если в проекте есть **Laravel Sail**, безопаснее выполнять через:

```
./vendor/bin/sail artisan boost:update
```

Boost прочитает `.ai/guidelines/*` и пересоберёт `AGENTS.md` и другие файлы. Для пакетов третьих сторон актуальный контракт по-прежнему опирается на `resources/boost/guidelines/core.blade.php` и `resources/boost/skills/*/SKILL.md`.

Команды
-------

[](#команды)

- `pfm-guidelines` (без аргументов) → alias для `init`
- `pfm-guidelines init` → интерактивная настройка + sync
- `pfm-guidelines sync` → применить конфиг/параметры, создать symlink/copy
- `pfm-guidelines list` → показать доступные пресеты
- `pfm-guidelines help` → справка
- `pfm-guidelines -V` / `pfm-guidelines --version` → версия CLI

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance89

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Recently: every ~12 days

Total

31

Last Release

55d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/87b33c1f84ded521a768afdbd204f1a1c2cd7519477a2f8bdb2e8b7cba030d09?d=identicon)[PepperFM](/maintainers/PepperFM)

---

Top Contributors

[![pepperfm](https://avatars.githubusercontent.com/u/36007880?v=4)](https://github.com/pepperfm "pepperfm (43 commits)")

### Embed Badge

![Health badge](/badges/pepperfm-ai-guidelines/health.svg)

```
[![Health](https://phpackages.com/badges/pepperfm-ai-guidelines/health.svg)](https://phpackages.com/packages/pepperfm-ai-guidelines)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.7k509.9M17.0k](/packages/laravel-framework)[livewire/livewire

A front-end framework for Laravel.

23.5k75.5M1.8k](/packages/livewire-livewire)[laravel/octane

Supercharge your Laravel application's performance.

4.0k21.5M159](/packages/laravel-octane)[drush/drush

Drush is a command line shell and scripting interface for Drupal, a veritable Swiss Army knife designed to make life easier for those of us who spend some of our working hours hacking away at the command prompt.

2.4k57.4M685](/packages/drush-drush)[laravel/boost

Laravel Boost accelerates AI-assisted development by providing the essential context and structure that AI needs to generate high-quality, Laravel-specific code.

3.5k10.6M274](/packages/laravel-boost)[statamic/cms

The Statamic CMS Core Package

4.8k3.2M720](/packages/statamic-cms)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)