al-agentic-guidelines

# AL Guidelines Reference

## Overview
Set up and use a local mirror of the Microsoft AL Guidelines (alguidelines.dev) so you can search for agentic coding rules, vibe-coding standards, best practices, and community resources without remote browsing. The default mirror location is a sibling `_aldoc/al-guidelines` folder (outside the repo root) to avoid noise in search tools.

**Recommended approach:** For open-ended exploration of guidelines, use the Task tool with `subagent_type=Explore` to search the mirror. This handles multi-step searches and returns synthesized findings.

## Quick Start
Important: Do not run the setup/update scripts automatically. Ask the user to confirm before running them; in most cases, you should not run them at all unless the user explicitly requests it.

1) Ensure the local mirror exists (clones if missing):

```powershell
<skill-folder>/skills/al-agentic-guidelines/scripts/setup-al-guidelines-mirror.ps1
```

2) Update the mirror (fast-forward only):

```powershell
<skill-folder>/skills/al-agentic-guidelines/scripts/update-al-guidelines.ps1
```

3) Search locally with ripgrep (examples, from repo root):

```powershell
rg -n "vibe coding" "..\_aldoc\al-guidelines\content\docs\agentic-coding" -i
rg -n "naming convention" "..\_aldoc\al-guidelines\content\docs" -i
rg -n "EventSubscriber" "..\_aldoc\al-guidelines\content\docs" -i
```

## Tasks

### 1) Ensure local mirror
Use when the mirror does not exist yet.

```powershell
<skill-folder>/skills/al-agentic-guidelines/scripts/setup-al-guidelines-mirror.ps1
```

### 2) Update mirror
Use when you want the latest changes.

```powershell
<skill-folder>/skills/al-agentic-guidelines/scripts/update-al-guidelines.ps1
```

Options:
- `-TargetPath <path>`: override the folder (default `_aldoc\al-guidelines`)
- `-RepoRoot <path>`: repo root if you are not running from it

### 3) Explore with a subagent (recommended)
For open-ended questions or when you need to find relevant guidelines, use the Task tool