aem-refresh

name	aem-refresh
description	Refresh .ai/project/ seed data files from a local path or remote ADO docs repo. Use when project knowledge files need updating.
when_to_use	Use when project knowledge files are outdated, when the user says 'refresh project data', 'update seed data', 'reload project knowledge', or 'sync docs from the remote repo'.
argument-hint	[local-path-to-docs | blank for remote]
allowed-tools	["read","edit","search","write","agent","ado/*","AEM/*","playwright/*"]

You refresh .ai/project/ data files from an external source. This updates the project knowledge that agents use for component lookups, file resolution, and market-scoped searches.

Source Resolution (three-source fallback)

1. User-provided local path (argument)

If the user passes a local path as argument:

1. Verify the path exists
2. Look for known file structure (see file table below)
3. Copy files to .ai/project/

2. Remote ADO docs repo

If no argument provided:

1. Read .ai/config.yaml → aem.docs-repo for the ADO repo URL
2. If set, use mcp__ado__search_code or ADO MCP file content tools to fetch each file by path
3. Default source paths in the docs repo (configurable via aem.docs-repo-paths in config.yaml):

Source Path (in docs repo)	Destination	Mandatory
docs/components/component-index.md	.ai/project/component-index-project.md	yes
docs/project.yaml	.ai/project/project.yaml	yes
docs/file-patterns.yaml	.ai/project/file-patterns.yaml	yes
docs/content-paths.yaml	.ai/project/content-paths.yaml	no
docs/architecture.md	.ai/project/architecture.md	yes
docs/features.md	.ai/project/features.md	yes

If aem.docs-repo-paths is set in config.yaml, use those paths instead.

3. No source available

If neither a local path nor aem.docs-repo is configured:

• Report error: "No seed data source available. Pass a local path as argument, or set aem.docs-repo in .ai/config.yaml via /aem-init."
• Do NOT fall back to bundled data — there is no bundled seed data.

Copy Procedure

For each file in the table:

1. Check if source file exists at the expected path
2. If exists: copy to .ai/project/ destination
3. If not exists and mandatory: report warning
4. If not exists and optional: skip silently

Create .ai/project/ directory if it doesn't exist.

Never overwrite component-index.md (the aem-init auto-generated local index). Only write to component-index-project.md (the enriched cross-repo index).

Verification

After copying, report:

## Seed Data Refreshed

| File | Lines | Status |
|------|-------|--------|
| component-index-project.md | <N> | Updated (<M> components) |
| project.yaml | <N> | Updated |
| file-patterns.yaml | <N> | Updated |
| content-paths.yaml | <N> | Updated |
| architecture.md | <N> | Updated |
| features.md | <N> | Updated |

**Source:** <local path or ADO repo URL>

For component-index-project.md, count table rows to report component count (grep for ^| lines excluding header).

Rules

• Never touches config.yaml — this is data-only refresh. Brand/market/repo config is the user's responsibility (set by /aem-init).
• Never overwrites component-index.md — only writes to component-index-project.md
• Three-source fallback — local path → ADO docs repo → error. No bundled data.
• Report line counts — always report file sizes after copy for verification
• Mandatory files — warn if mandatory files are missing from source
• Load MCP tools — if using ADO MCP, call ToolSearch("select:mcp__ado__search_code") first

Examples

1. /aem-refresh — Detects local seed data path from plugin config. Copies updated project.yaml (45 lines), file-patterns.yaml (32 lines), content-paths.yaml (18 lines), architecture.md (120 lines), and features.md (85 lines) to .ai/project/. Reports line counts for each file.

2. /aem-refresh --source /path/to/docs-repo — Uses the specified local path instead of the default. Finds all 6 seed files, copies them, and reports that component-index-project.md was updated with 52 components.

3. /aem-refresh (source not found locally, falls back to ADO) — Local path doesn't exist. Falls back to ADO docs repo via MCP, fetches seed files from the remote repository. Downloads and saves each file to .ai/project/ with line counts reported.

Troubleshooting

• "Source path not found and ADO repo not configured" Cause: Neither a local seed data path nor an ADO docs repo is configured. Fix: Run /aem-init to configure the seed data source in .ai/config.yaml, or provide a path explicitly with --source.

• Mandatory files missing from source Cause: The source directory or repo doesn't contain all expected seed files. Fix: Check the source for project.yaml, file-patterns.yaml, content-paths.yaml, architecture.md, and features.md. If files are missing from the docs repo, they need to be added there first.

• Component index not updated Cause: /aem-refresh only copies component-index-project.md — it does not regenerate it from AEM. Fix: To regenerate the component index from a live AEM instance, run /aem-init with the component scan option. /aem-refresh only syncs pre-built seed data files.