README

Nectar — AI-powered development context for Pollora

About Nectar

Nectar feeds AI agents with the context they need to write high-quality Pollora code. Built on top of Laravel Boost, it provides AI guidelines, agent skills, and a dedicated MCP server tailored to the Pollora framework and WordPress integration.

What it provides

Feature	Description
AI Guidelines	Pollora architecture, PHP attributes, WordPress routing, Blade theming — injected into your agent's context via Boost
8 Agent Skills	On-demand knowledge for post types, taxonomies, theming, hooks, blocks, REST API, scheduling, and modules
10 MCP Tools	Live introspection of your WordPress & Pollora environment directly from your AI agent
Upgrade Prompts	Step-by-step MCP prompts for upgrading between Pollora major versions (e.g., 12→13)

Installation

composer require pollora/nectar --dev

Then run Boost to install guidelines and skills:

php artisan boost:install

Select pollora/nectar when prompted for third-party packages, or add it manually to boost.json:

{
    "packages": ["pollora/nectar"]
}

Then update:

php artisan boost:update

MCP Server

Nectar registers a pollora-nectar MCP server that gives AI agents live access to your WordPress and Pollora environment.

Starting the server

php artisan nectar:mcp

Or register it in your .mcp.json:

{
    "mcpServers": {
        "pollora-nectar": {
            "command": "php",
            "args": ["artisan", "nectar:mcp"]
        }
    }
}

Available MCP Tools

Tool	Description
`pollora_status`	PHP, Laravel, Pollora & WordPress versions, active theme, discovery cache status
`wordpress_info`	WordPress version, plugins, theme, multisite status, constants, locale
`post_types_info`	All registered custom post types with supports, taxonomies, and configuration
`taxonomies_info`	All registered taxonomies with associated post types
`registered_hooks`	Hooks discovered via `#[Action]` and `#[Filter]` attributes
`active_theme_info`	Theme structure, service providers, config files, Vite/Tailwind status, blocks
`discovered_components`	All auto-discovered components grouped by type (post types, taxonomies, hooks, schedules, REST routes)
`wordpress_routes`	All routes including `Route::wp()` with WordPress conditions and middleware
`modules_info`	Installed Laravel Modules with status
`wp_option`	Read any WordPress option by key

AI Guidelines

Guidelines are loaded automatically when Boost runs. They cover:

Pollora architecture (Laravel + WordPress bridge)
PHP 8 attributes (#[PostType], #[Taxonomy], #[Action], #[Filter], #[Schedule], #[WpRestRoute])
WordPress routing with Route::wp() and template hierarchy
Blade templating with Sage Directives
Theme development conventions
Available Artisan commands

Agent Skills

Skills are activated on-demand when working on specific tasks:

Skill	When it activates
`pollora-post-types`	Creating custom post types with attributes
`pollora-taxonomies`	Creating custom taxonomies
`pollora-theming`	Theme development (Blade, Vite, Tailwind, assets)
`pollora-hooks`	Registering WordPress actions & filters
`pollora-blocks`	Gutenberg block development with JSX & Tailwind
`pollora-rest-api`	REST API endpoints with `#[WpRestRoute]`
`pollora-scheduling`	Scheduled tasks with `#[Schedule]`
`pollora-modules`	Laravel Modules with auto-discovery

Upgrade Assistance

Nectar provides MCP upgrade prompts that guide AI agents through Pollora major version upgrades. Prompts are automatically registered when the current project version matches.

Prompt	Available when	Covers
`upgrade-pollora-v13`	Pollora 12.x detected	Loop facade removal, config registration removal, CSRF middleware rename, Vite theme.json setup, WordPress 7.0, and more

The upgrade prompt includes:

Step-by-step process (assess → safety net → analyze → apply → update deps → clean up)
All breaking changes with search patterns and before/after code examples
Theme build pipeline updates (@roots/vite-plugin, wordpressThemeJson)
Post-upgrade cleanup (wp transient delete --all)

Configuration

Publish the config file:

php artisan vendor:publish --tag=nectar-config

// config/nectar.php
return [
    'enabled' => env('NECTAR_ENABLED', true),

    'mcp' => [
        'tools' => [
            'exclude' => [],   // Tool class names to exclude
            'include' => [],   // Additional tool class names to include
        ],
    ],
];

Requirements

PHP ^8.3
Laravel 12.x or 13.x
Pollora Framework (any version)
Laravel Boost ^2.0

License

Nectar is open-sourced software licensed under the GPL-2.0-or-later.

pollora / nectar

Maintainers

Package info

Statistics

Security