Skip to content

feat: add comprehensive replication skills for AEM 6… #48

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
abhishekgarg18 merged 5 commits into from
Apr 14, 2026
Merged

feat: add comprehensive replication skills for AEM 6… #48

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
964be7f
feat(aem-replication): add comprehensive replication skills for AEM 6…
Apr 9, 2026
426a4c6
fix: address security and compatibility issues in replication skills
Apr 9, 2026
7351e78
fix: correct Maven dependencies - focus on 6.5 LTS, not specific vers…
Apr 9, 2026
218c101
refactor: add references architecture and orchestrator, enhance docum…
Apr 9, 2026
4392619
docs: polish AEM replication skills with minor enhancements
Apr 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 47 additions & 14 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Repository of Adobe skills for AI coding agents.
# Install all AEM as a Cloud Service skills (create-component + workflow + dispatcher) in one command
/plugin install aem-cloud-service@adobe-skills

# Install all AEM 6.5 LTS skills (workflow + dispatcher) in one command
# Install all AEM 6.5 LTS skills (workflow + dispatcher + replication) in one command
/plugin install aem-6-5-lts@adobe-skills
```

Expand All @@ -29,7 +29,7 @@ npx skills add https://github.com/adobe/skills/tree/main/skills/aem/edge-deliver
# Install all AEM as a Cloud Service skills (create-component + workflow + dispatcher) in one command
npx skills add https://github.com/adobe/skills/tree/beta/skills/aem/cloud-service --all

# Install all AEM 6.5 LTS skills (workflow + dispatcher) in one command
# Install all AEM 6.5 LTS skills (workflow + dispatcher + replication) in one command
npx skills add https://github.com/adobe/skills/tree/beta/skills/aem/6.5-lts --all

# Install for a single agent (pick ONE flavor only)
Expand Down Expand Up @@ -57,7 +57,7 @@ gh upskill adobe/skills --path skills/aem/edge-delivery-services --all
# Install all AEM as a Cloud Service skills (create-component + workflow + dispatcher)
gh upskill adobe/skills --path skills/aem/cloud-service --all

# Install all AEM 6.5 LTS skills (workflow + dispatcher)
# Install all AEM 6.5 LTS skills (workflow + dispatcher + replication)
gh upskill adobe/skills --path skills/aem/6.5-lts --all

# Install a specific skill
Expand Down Expand Up @@ -139,6 +139,28 @@ Current dispatcher flavors:
Each flavor contains parallel capability groups (workflow orchestration, config authoring, technical advisory, incident response, performance tuning, and security hardening).
Shared advisory logic is centralized under each flavor's `dispatcher/shared/references/` to reduce duplication and drift.

### AEM Replication

Replication skills for AEM 6.5 LTS cover the full content distribution lifecycle from agent configuration to troubleshooting.

**Location:** `skills/aem/6.5-lts/skills/aem-replication`

The aem-replication skill contains four specialist sub-skills:

| Sub-Skill | Purpose |
|---|---|
| `configure-replication-agent` | Configure replication agents for publishing, dispatcher flush, and reverse replication |
| `replicate-content` | Activate and deactivate content using UI, workflows, and package manager |
| `replication-api` | Use the Replication API programmatically in custom code with complete Java examples |
| `troubleshoot-replication` | Diagnose and fix blocked queues, connectivity failures, and distribution problems |

**Key features:**
- All skills based on official AEM 6.5 LTS documentation
- Complete coverage of public Replication API (Replicator, ReplicationOptions, AgentManager, ReplicationQueue, etc.)
- 49 Java code examples for OSGi services, servlets, and workflow steps
- 12+ troubleshooting scenarios with step-by-step resolution
- 3,575 lines of comprehensive documentation

### AEM as a Cloud Service — Best Practices & Migration

Under `skills/aem/cloud-service/skills/`, **`best-practices/`** is the **general-purpose** Cloud Service skill: pattern modules, Java baseline references (SCR→OSGi DS, resolver/logging, and related refs), and day-to-day Cloud Service alignment. Use it **without** loading **migration** for greenfield or maintainability work. **`migration/`** (BPA/CAM orchestration) is **scoped to legacy AEM → AEM as a Cloud Service** (not Edge Delivery or 6.5 LTS); it **delegates** concrete refactors to **`best-practices`** (`references/`). **Installing the AEM as a Cloud Service plugin** (`aem-cloud-service`, or the `skills/aem/cloud-service` path with `npx skills` / `gh upskill`) **includes both**; the agent should load the appropriate `SKILL.md` for the task. Use **`gh upskill` / `npx skills` with `--skill`** when you need a specific bundled skill (see **Installation** above).
Expand Down Expand Up @@ -233,17 +255,28 @@ skills/
| |-- workflow-debugging/
| |-- workflow-triaging/
| \-- workflow-orchestrator/
|-- ensure-agents-md/
\-- dispatcher/
|-- SKILL.md <-- discovered by npx skills (router)
|-- config-authoring/
| |-- SKILL.md <-- specialist (bundled inside dispatcher)
| \-- references/
|-- technical-advisory/
|-- incident-response/
|-- performance-tuning/
|-- security-hardening/
\-- workflow-orchestrator/
|-- dispatcher/
| |-- SKILL.md <-- discovered by npx skills (router)
| |-- config-authoring/
| | |-- SKILL.md <-- specialist (bundled inside dispatcher)
| | \-- references/
| |-- technical-advisory/
| |-- incident-response/
| |-- performance-tuning/
| |-- security-hardening/
| \-- workflow-orchestrator/
|-- aem-replication/
| |-- README.md
| |-- SKILL.md <-- discovered by npx skills (router)
| |-- configure-replication-agent/
| | \-- SKILL.md <-- specialist (bundled inside aem-replication)
| |-- replicate-content/
| | \-- SKILL.md <-- specialist (bundled inside aem-replication)
| |-- replication-api/
| | \-- SKILL.md <-- specialist (bundled inside aem-replication)
| \-- troubleshoot-replication/
| \-- SKILL.md <-- specialist (bundled inside aem-replication)
\-- ensure-agents-md/
```

## Contributing
Expand Down
4 changes: 2 additions & 2 deletions skills/aem/6.5-lts/.claude-plugin/plugin.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
{
"name": "aem-6-5-lts",
"description": "All AEM 6.5 LTS skills: Workflow model design, development, triggering, launchers, debugging, and triaging, plus Dispatcher config authoring, advisory, incident response, performance tuning, and security hardening for AEM 6.5 LTS and AMS environments.",
"description": "All AEM 6.5 LTS skills: Workflow model design, development, triggering, launchers, debugging, and triaging; Dispatcher config authoring, advisory, incident response, performance tuning, and security hardening; and Replication agent configuration, content activation, API usage, and troubleshooting for AEM 6.5 LTS and AMS environments.",
"version": "1.0.0",
"author": {
"name": "Adobe"
},
"repository": "https://github.com/adobe/skills",
"license": "Apache-2.0",
"keywords": ["aem", "aem6.5", "6.5-lts", "ams", "dispatcher", "httpd", "apache", "workflow", "adobe"]
"keywords": ["aem", "aem6.5", "6.5-lts", "ams", "dispatcher", "httpd", "apache", "workflow", "replication", "adobe"]
}
99 changes: 99 additions & 0 deletions skills/aem/6.5-lts/skills/aem-replication/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
# AEM 6.5 LTS Replication Skills

Comprehensive replication skills for Adobe Experience Manager 6.5 LTS, covering agent configuration, content activation, programmatic API usage, and troubleshooting.

## Skills Included

### 1. Configure Replication Agent
Configure replication agents for content publishing, dispatcher cache flushing, and reverse replication.

**Key capabilities:**
- Default agent setup (Author → Publish)
- Dispatcher Flush agent configuration
- Reverse replication (Publish → Author)
- Multiple publish instance configuration
- Security best practices

**Typical use cases:**
- Initial AEM instance setup
- Adding new publish instances
- Setting up disaster recovery
- Configuring load-balanced environments

### 2. Replicate Content
Activate and deactivate content using various methods from simple Quick Publish to advanced workflows.

**Key capabilities:**
- Quick Publish for simple activation
- Manage Publication for advanced control
- Tree Activation for hierarchical publishing
- Package-based replication
- Workflow-based approval publishing
- Scheduled activation/deactivation
- DAM asset replication

**Typical use cases:**
- Daily content publishing operations
- Marketing campaign launches
- Scheduled content releases
- Bulk content migration

### 3. Replication API
Use the AEM 6.5 LTS Replication API for programmatic content distribution in custom code.

**Key capabilities:**
- Replicator interface methods
- ReplicationOptions configuration
- ReplicationStatus queries
- AgentManager for agent inspection
- ReplicationQueue management
- ReplicationListener for event monitoring
- Complete Java code examples

**Typical use cases:**
- Custom OSGi services
- Workflow process steps
- Servlets with replication logic
- Bulk content operations
- Integration with external systems

### 4. Troubleshoot Replication
Diagnose and fix common replication issues including blocked queues and connectivity failures.

**Key capabilities:**
- Blocked queue diagnosis and resolution
- Connection error troubleshooting
- Authentication and SSL issues
- Dispatcher cache invalidation problems
- Event queue management
- Performance optimization

**Typical use cases:**
- Production incidents
- Content not appearing on Publish
- Slow or stuck replication
- Agent configuration issues
- Queue management

## Documentation Sources

All skills are based on official Adobe AEM 6.5 LTS documentation:

- **Official Replication Guide**: https://experienceleague.adobe.com/en/docs/experience-manager-65-lts/content/implementing/deploying/configuring/replication
- **Troubleshooting Guide**: https://experienceleague.adobe.com/en/docs/experience-manager-65-lts/content/implementing/deploying/configuring/troubleshoot-rep
- **API Reference**: https://developer.adobe.com/experience-manager/reference-materials/6-5-lts/javadoc/com/day/cq/replication/package-summary.html

## Getting Started

1. **For first-time setup**: Start with [Configure Replication Agent](./configure-replication-agent/SKILL.md)
2. **For daily operations**: Use [Replicate Content](./replicate-content/SKILL.md)
3. **For custom code**: Reference [Replication API](./replication-api/SKILL.md)
4. **For issues**: Consult [Troubleshoot Replication](./troubleshoot-replication/SKILL.md)

## Total Documentation

- **4 comprehensive skills**
- **3,575 lines** of documentation
- **49 Java code examples**
- **12+ common troubleshooting scenarios**
- **100% based on official Adobe documentation**
133 changes: 133 additions & 0 deletions skills/aem/6.5-lts/skills/aem-replication/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,133 @@
---
name: aem-replication
description: |
Single entry point for all AEM 6.5 LTS Replication skills. Covers configuring replication agents,
activating/deactivating content, using the Replication API programmatically, and troubleshooting
distribution issues for Adobe Experience Manager 6.5 LTS.
license: Apache-2.0
compatibility: Requires AEM 6.5 LTS or Adobe Managed Services (AMS). NOT compatible with AEM as a Cloud Service (use Sling Distribution API instead).
metadata:
version: "1.0"
aem_version: "6.5 LTS"
---

# AEM 6.5 LTS Replication

Route user requests to the appropriate specialist skill based on intent.

## Intent Router

| User Intent | Skill | Path |
|---|---|---|
| Configure replication agents (default, dispatcher flush, reverse replication) | Configure Replication Agent | [configure-replication-agent/SKILL.md](./configure-replication-agent/SKILL.md) |
| Activate or deactivate content using UI or workflows | Replicate Content | [replicate-content/SKILL.md](./replicate-content/SKILL.md) |
| Use Replication API programmatically in custom code | Replication API | [replication-api/SKILL.md](./replication-api/SKILL.md) |
| Diagnose blocked queues, connectivity issues, or distribution problems | Troubleshoot Replication | [troubleshoot-replication/SKILL.md](./troubleshoot-replication/SKILL.md) |
| End-to-end workflows: new environment setup, incident response, performance optimization | Replication Orchestrator | [replication-orchestrator/SKILL.md](./replication-orchestrator/SKILL.md) |

## How to Use

1. Match the user's request to one row in the Intent Router table above.
2. Read the linked SKILL.md for that specialist skill.
3. Follow the workflow and guidance defined in that skill.
4. For complex scenarios spanning multiple skills (e.g., configure agent then troubleshoot), start with the primary intent and cross-reference as needed.

## Skill Overview

### Configure Replication Agent

Set up and configure replication agents for:
- **Default agents**: Author to Publish content distribution
- **Dispatcher Flush agents**: Cache invalidation
- **Reverse replication**: Publish to Author user-generated content flow
- **Multiple publish instances**: Load balancing and high availability

**When to use:** First-time setup, adding new publish instances, reconfiguring agents

### Replicate Content

Activate and deactivate content through:
- **Quick Publish**: Simple one-click activation
- **Manage Publication**: Advanced scheduling and approval workflows
- **Tree Activation**: Hierarchical bulk publishing
- **Package Manager**: Specific content set distribution
- **Workflows**: Approval-based publishing
- **Scheduled Activation**: Time-based content publishing

**When to use:** Publishing pages, assets, or DAM content; unpublishing content

### Replication API

Programmatic replication using official AEM 6.5 LTS public APIs:
- **Replicator interface**: Core replication methods
- **ReplicationOptions**: Configure synchronous/asynchronous, agent filtering
- **ReplicationStatus**: Query replication state
- **AgentManager, ReplicationQueue, ReplicationListener**: Advanced queue management and monitoring

**When to use:** Custom code integration, bulk operations, workflow process steps, servlets

### Troubleshoot Replication

Diagnose and fix common issues:
- **Blocked queues**: FIFO queue failures
- **Connection errors**: Network, authentication, SSL issues
- **Content not appearing**: Dispatcher cache, permissions
- **Agent configuration**: URI, credentials, triggers
- **Event queue issues**: Stuck replication jobs

**When to use:** Replication failures, performance issues, content not distributing

### Replication Orchestrator

Coordinates end-to-end replication workflows spanning multiple sub-skills:
- **New Environment Setup**: Configure agents → Test replication → Troubleshoot
- **Production Incident Response**: Diagnose → Fix → Verify
- **Performance Optimization**: Monitor → Tune → Validate
- **Migration Preparation**: Audit → Plan → Execute

**When to use:** Multi-step scenarios requiring coordination across configure, replicate, API, and troubleshoot skills

## Common Workflows

### First-Time Setup
1. Use **Configure Replication Agent** to set up default agent
2. Use **Replicate Content** to test with a sample page
3. If issues occur, use **Troubleshoot Replication**

### Production Operations
1. Use **Replicate Content** for day-to-day publishing
2. Use **Replication API** for automated/bulk operations
3. Use **Troubleshoot Replication** when issues arise

### Advanced Integration
1. Use **Replication API** to understand available methods
2. Use **Configure Replication Agent** to understand agent configuration
3. Use **Troubleshoot Replication** for debugging custom replication code

## Foundation References

Shared reference materials used across all replication skills:

- **[Agent Types](./references/replication-foundation/agent-types.md)**: Default, Dispatcher Flush, Reverse, and Static agents
- **[Queue Mechanics](./references/replication-foundation/queue-mechanics.md)**: FIFO processing, retry logic, queue management
- **[AEM 6.5 LTS Guardrails](./references/replication-foundation/65-lts-guardrails.md)**: Service users, timeouts, batch limits, best practices
- **[API Quick Reference](./references/replication-foundation/api-reference.md)**: Replicator, ReplicationOptions, ReplicationStatus methods

## Official Documentation

All skills reference official Adobe AEM 6.5 LTS documentation:
- [Replication Documentation](https://experienceleague.adobe.com/en/docs/experience-manager-65-lts/content/implementing/deploying/configuring/replication)
- [Replication Troubleshooting](https://experienceleague.adobe.com/en/docs/experience-manager-65-lts/content/implementing/deploying/configuring/troubleshoot-rep)
- [Replication API JavaDoc](https://developer.adobe.com/experience-manager/reference-materials/6-5-lts/javadoc/com/day/cq/replication/package-summary.html)

## Related Skills

- **AEM Workflow**: Integrate replication with approval workflows
- **Dispatcher**: Configure Dispatcher Flush agents for cache invalidation

## Migration to AEM as a Cloud Service

AEM as a Cloud Service uses the **Sling Distribution API** instead of replication agents. If planning migration:
- Review [Cloud Service Distribution Documentation](https://experienceleague.adobe.com/docs/experience-manager-cloud-service/content/operations/distribution.html)
- For code migration patterns, see `skills/aem/cloud-service/skills/best-practices/references/replication.md`
- Avoid agent-specific coupling (filter by agent ID) to reduce migration complexity
Loading