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.