learning_ai_common_plat/.windsurf/workflows/repo_update-agent-docs.md
2026-03-24 16:05:12 -07:00

2.1 KiB

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:
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.

  1. Review changes per repo:
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
  1. Commit changes (if any):
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