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:
- Clones/updates reference repos — 21 Lutece v8 repositories into
~/.lutece-references/
- Copies rules — Detects if the current project is a Lutece plugin and copies coding constraint rules into
.claude/rules/
- 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 |
lutece-update-template-bo | Updates a Back Office (admin) template by replacing raw HTML with the FreeMarker macros from lutece-core's Tabler theme |
lutece-update-template-fo | Updates a Front Office (skin) template by replacing raw HTML with the FreeMarker FO macros from lutece-core |
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
