---
description: Regenerate AI agent docs (AGENTS.md, CLAUDE.md, .cursorrules, etc.) across all repos
---

# Update Agent Docs Across Workspace

Regenerates all 8 AI agent configuration files across all repos in the workspace.

## Files Generated Per Repo

| File                              | Tool                                            |
| --------------------------------- | ----------------------------------------------- |
| `AGENTS.md`                       | Universal (OpenAI Codex, Claude, Copilot, etc.) |
| `CLAUDE.md`                       | Claude Code                                     |
| `.cursorrules`                    | Cursor AI                                       |
| `.github/copilot-instructions.md` | GitHub Copilot                                  |
| `.windsurfrules`                  | Windsurf / Cascade                              |
| `.clinerules`                     | Cline / Roo Code                                |
| `.aider.conf.yml`                 | Aider                                           |
| `.editorconfig`                   | All editors                                     |

## Steps

1. Run the update script:

```bash
cd /Users/sd9235/code/mygh/learning_ai_common_plat
./scripts/update-agent-docs.sh
```

The script reads `learning_ai_common_plat/.windsurf/workflows/repos.txt` as the canonical list of managed workspace repositories.

2. Review changes per repo:

```bash
while IFS= read -r repo; do
  [[ -z "$repo" || "$repo" =~ ^# ]] && continue
  cd /Users/sd9235/code/mygh/$repo && git diff --stat
done < /Users/sd9235/code/mygh/learning_ai_common_plat/.windsurf/workflows/repos.txt
```

3. Commit changes (if any):

```bash
cd /Users/sd9235/code/mygh/learning_voice_ai_agent
[ -n "$(git status --porcelain)" ] && git add -A && git commit -m "chore(docs): update agent configuration files"
```

## Notes

- The script scans each repo's structure and regenerates docs based on current state
- Only commits if there are actual changes
- Safe to run repeatedly (idempotent)
- Requires `learning_ai_common_plat` to be the source of truth for templates