aiup-alfresco

aiup-alfresco

A Claude Code plugin and portable prompt pack for Alfresco extension development. It packages the workflow as command specs, skills, and agents so the same repository guidance can be reused from Claude, Codex, OpenClaw, or another coding agent.

AIUP (AI Unified Process) is a spec-driven approach to AI-assisted development. This project applies AIUP principles to Alfresco extensions.

If this project keeps expanding in scope and quality, it may eventually supersede the guidance currently collected in alfresco-developer-series.

Prerequisites

• Java 17+
• Maven 3.9+
• Docker & Docker Compose
• Claude Code CLI installed and configured if you want native slash commands

Installation

claude plugin install aborroy/aiup-alfresco

Or for local development:

claude --plugin-dir /path/to/aiup-alfresco

If you are using Codex, OpenClaw, or another agent, installation is optional; you can use the portable renderer below directly from the repository checkout.

Portable Use Outside Claude

The slash-command UX is Claude-specific, but the command logic is portable because it lives in commands/*.md and AGENTS.md.

List the available commands:

./scripts/aiup-command.sh list

Render a Codex-compatible prompt for /requirements:

./scripts/aiup-command.sh render --agent codex requirements \
  "We need to manage technical documents with categories and review dates"

Render an OpenClaw-compatible prompt for /scaffold:

./scripts/aiup-command.sh render --agent openclaw scaffold

The renderer emits a plain prompt that tells the target agent to:

• read AGENTS.md
• execute the requested commands/<name>.md
• handle any referenced skills/ or agents/ files manually

See PORTABILITY.md for the non-Claude workflow.

Quick Start

Run the workflow inside Claude Code:

In-Process extensions (behaviours, web scripts, actions, workflows — deployed as JAR/AMP inside ACS):

/requirements        # Gather requirements + decide project architecture
/scaffold            # Generate pom.xml, module.properties, module-context.xml
/content-model       # Generate content model XML
/workflow            # Generate Activiti BPMN process + workflow task model (optional)
/web-scripts         # Generate Web Script descriptors & controllers
/behaviours          # Scaffold behaviours/policies
/actions             # Scaffold action executors
/scheduled-jobs      # Generate cluster-safe Quartz scheduled job + unit test
/docker-compose      # Generate full ACS stack compose.yaml
/test                # Generate integration tests

Out-of-Process extensions (event listeners — deployed as a separate Spring Boot app):

/requirements        # Gather requirements + decide project architecture
/scaffold            # Generate pom.xml, Application.java, application.properties
/events              # Generate Spring Boot event listener
/docker-compose      # Generate full ACS stack + listener service compose.yaml
/test                # Generate integration tests

Mixed extensions (both in-process and out-of-process components):

/requirements        # Gather requirements + decide project architecture
/scaffold            # Generate aggregator POM + both sub-module skeletons
/content-model       # Generate content model XML  (platform sub-module)
/behaviours          # Scaffold behaviours/policies (platform sub-module)
/events              # Generate Spring Boot event listener (events sub-module)
/docker-compose      # Generate full ACS stack compose.yaml
/test                # Generate integration tests for both modules

Legacy Share/UI extensions (Share-tier addons such as share-config-custom.xml, Surf, Aikau):

/requirements        # Gather requirements + decide whether Share is really the UI target
/scaffold            # Generate a Share-only project or a mixed repo+share/events layout
/share-config       # Generate Share forms and share-config-custom.xml
/surf               # Generate Surf pages, components, and extension metadata
/aikau              # Generate Aikau pages, widget models, and dashlet-style UI

Share-tier architecture is now modeled explicitly at the planning and scaffolding level. /share-config, /surf, and /aikau are available now.

Commands