lutece-plugins

Lutecepowers

Claude Code plugin for Lutece 8 framework development.

🚀 New: lutece-migration-v8-agent-teams — v7→v8 migration redesigned for Agent Teams (Swarm Mode). Parallel teammates, 9 bash scripts, JSON-driven task decomposition. Enable with export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 then run /lutece-migration-v8-agent-teams.

Installation

/plugin marketplace add lutece-platform/lutece-dev-plugin-claude
/plugin install lutecepowers-v8
# install in user scope

What it does

At session start, the plugin automatically:

1. Clones/updates reference repos — 21 Lutece v8 repositories into ~/.lutece-references/
2. Copies rules — Detects if the current project is a Lutece plugin and copies coding constraint rules into .claude/rules/
3. Injects context — Bootstrap message with architecture patterns and available skills

Skills

Skill	Description
lutece-patterns	Architecture reference: layered design, CDI patterns, CRUD lifecycle, pagination, XPages, daemons, security checklist
lutece-migration-v8-agent-teams	Migration v7 → v8 via Agent Teams (Swarm Mode). Parallel teammates, 9 scripts, JSON-driven task decomposition. Requires export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
lutece-dao	DAO + Home layer patterns: DAOUtil lifecycle, SQL constants, CDI lookup
lutece-workflow	Workflow module patterns: tasks, CDI producers, components, templates
lutece-rbac	RBAC: entity permissions, ResourceIdService, plugin.xml, JspBean authorization
lutece-cache	Cache: AbstractCacheableService, CDI init, invalidation via CDI events
lutece-lucene-indexer	Plugin-internal Lucene search: custom index, daemon, CDI events
lutece-solr-indexer	Solr search module: SolrIndexer interface, CDI auto-discovery, batch indexing
lutece-elasticdata	Elasticsearch DataSource: DataSource/DataObject interfaces, two-daemon indexing
lutece-deep-review	Deep review via Agent Teams. Traces request lifecycle (template → bean → service → DAO → SQL), cross-references layers to find guaranteed bugs. Requires export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Agent

Agent	Model	Description
lutece-v8-reviewer	Opus	Read-only compliance reviewer. Runs scan-project.sh + verify-migration.sh, then semantic analysis (CDI scopes, singletons, producers, cache guards), then full build with tests. Produces a structured PASS/WARN/FAIL report.

Migration flow (/lutece-migration-v8-agent-teams)

Input: a Lutece v7 plugin/module/library (Spring, javax, XML context).

Architecture: Team Lead orchestrates, specialized teammates execute in parallel. 9 bash scripts handle mechanical work, AI handles intelligent decisions (CDI scopes, producers, events).

Phase	What	Who
A — Scan	scan-project.sh → JSON inventory, dependency v8 check	@lead
B — Task Decomposition	task-splitter.sh → per-teammate JSON task files	@lead
C — Spawn Teammates	@config-migrator, @java-migrator (×1-3), @template-migrator, @test-migrator, @verifier	@lead
D — Task Dependencies	@config-migrator → @java-migrator(s) → @template-migrator + @test-migrator → @verifier final build	@lead
E — Monitoring	progress-report.sh, mailbox messaging, blocker resolution	@lead
F — Final Gate	0 FAIL on verify-migration.sh, green build, v8-reviewer agent	@verifier + @lead

graph TD
    L(["@lead — orchestrator"])

    L -->|"delegates"| C["@config-migrator"]
    L -->|"delegates"| J["@java-migrator ×1-3"]
    L -->|"delegates"| T["@template-migrator"]
    L -->|"delegates"| TE["@test-migrator"]
    L -->|"delegates"| V["@verifier"]

    C -.->|"unblocks"| J
    J -.->|"unblocks"| T
    J -.->|"unblocks"| TE
    T -.->|"unblocks"| V
    TE -.->|"unblocks"| V
    V -->|"delegates"| R{{"lutece-v8-reviewer agent"}}

    R -.->|"findings"| V
    V -.->|"reports issues"| L

Teammates

Teammate	Count	Role
@config-migrator	1	POM, beans.xml, context XML → JSON, plugin descriptor, web.xml, SQL Liquibase
@java-migrator	1-3	migrate-java-mechanical.sh then CDI scopes, producers, events, cache, deprecated API
@template-migrator	0-1	migrate-template-mechanical.sh then JSP, admin/skin templates, jQuery→vanilla JS
@test-migrator	0-1	JUnit 4→5, mock renames, CDI test extensions
@verifier	1	Continuous verify-file.sh, final verify-migration.sh, mvn clean install, reviewer agent

Scripts