Back to Ag Grid

ag-shared Sync Log

external/ag-shared/docs/SYNC-LOG.md

100.0.07.1 KB
Original Source

ag-shared Sync Log

Migration log for external/ag-shared/ changes. Each entry documents what changed and what companion actions consuming repos need to perform when syncing.

Newest entries first. Generated by /ag-shared-sync-log.


2026-03-17 -- Migrate nx-performance skill to ag-shared

Branch: latest

Changes

  • [prompts/skills] Migrated nx-performance skill from ag-charts-local to ag-shared — generalized AG Charts-specific language to "AG product monorepos" while preserving concrete examples
  • [prompts/skills] Skill structure: SKILL.md + references/ subdirectory with caching-strategy.md, build-and-dev.md, ci-patterns.md, gotchas.md

Migration Actions

  • ag-charts: Replace .rulesync/skills/nx-performance/ directory with symlink → ../../external/ag-shared/prompts/skills/nx-performance/
  • ag-grid: Add .rulesync/skills/nx-performance symlink → ../../external/ag-shared/prompts/skills/nx-performance/
  • ag-studio: Add .rulesync/skills/nx-performance symlink → ../../external/ag-shared/prompts/skills/nx-performance/
  • Run ./external/ag-shared/scripts/setup-prompts/setup-prompts.sh
  • Run ./external/ag-shared/scripts/setup-prompts/verify-rulesync.sh

2026-03-12 -- Context optimisation, plunker multi-product, symlinked repo support

Branch: latest Commits: 8bc421d714..e0195dbbcd (3 commits)

Changes

  • [prompts/skills] Migrated 4 large auto-loading rules (docs-pages, docs-checklist, examples, examples-framework-patterns) from ~90KB monoliths to ~4KB slim pointer rules that load full content via skills on demand
  • [prompts/skills] Made plunker skill multi-product with auto-detection — added ag-grid-guide.md and ag-studio-guide.md
  • [prompts/skills] Migrated examples-guide.md (635 lines) and framework-patterns.md (719 lines) into example/ag-charts/ skill subdirectory
  • [prompts/skills] Added context: fork to 12 skills for context isolation
  • [prompts/skills] Enhanced pr-create skill with symlinked repo scanning (Step 2: companion branch/PR creation for external/ repos)
  • [prompts/patches] Added rulesync+7.0.0.patch to pass through context field to .claude/ output
  • [scripts/setup-prompts] Added branch mismatch detection for symlinked repos with stash/checkout/unstash workflow

Migration Actions

  • Replace large .rulesync/rules/ files (docs-pages.md, docs-checklist.md, examples.md, examples-framework-patterns.md) with slim pointer versions
  • Run ./external/ag-shared/scripts/setup-prompts/setup-prompts.sh
  • Run ./external/ag-shared/scripts/setup-prompts/verify-rulesync.sh

2026-03-11 -- Prompts audit, guide-to-skill migrations, monolith decomposition

Branch: latest Commits: 9cf1f336db..6d2a38a7ec (2 commits)

Changes

  • [prompts/skills] Created website-css skill (5 files: SKILL.md + colour-palette, dark-mode, design-tokens, utility-classes) — replaces monolithic guide
  • [prompts/skills] Created website-astro skill (4 files: SKILL.md + content-collections, page-patterns, shared-components) — replaces monolithic guide
  • [prompts/skills] Decomposed plan-review skill into SKILL.md + 5 sub-docs (agent-prompts-quick, agent-prompts-thorough, discovered-work, external-tools, output-format)
  • [prompts/skills] Decomposed plan-implementation-review skill into SKILL.md + 3 sub-docs (agent-prompts, discovered-work, output-format)
  • [prompts/guides] Slimmed website-css.md and website-astro-pages.md guides (content moved to skills)
  • [prompts/agents] Deleted code-reviewer.md agent (unused)
  • [prompts/commands] Removed analyze-jira-issue.md, docs-create.md, sonar-fix.md commands (migrated to skills)

Migration Actions

  • Remove .rulesync/commands/analyze-jira-issue.md, docs-create.md, sonar-fix.md symlinks (targets deleted)
  • Add .rulesync/skills/website-css directory symlink → ../../external/ag-shared/prompts/skills/website-css/
  • Add .rulesync/skills/website-astro directory symlink → ../../external/ag-shared/prompts/skills/website-astro/
  • Add .rulesync/skills/docs-create directory symlink → ../../external/ag-shared/prompts/skills/docs-create/
  • Add .rulesync/skills/sonar-fix directory symlink → ../../external/ag-shared/prompts/skills/sonar-fix/
  • Run ./external/ag-shared/scripts/setup-prompts/setup-prompts.sh
  • Run ./external/ag-shared/scripts/setup-prompts/verify-rulesync.sh

2026-03-09 -- Rulesync skill, worktree hooks, skill optimisations

Branch: latest Commits: c2255312a5..1d93d98522 (8 commits)

Changes

  • [prompts/skills] Added rulesync skill to replace the rulesync guide — comprehensive configuration reference for .rulesync/ directory management
  • [prompts/guides] Removed rulesync.md guide (superseded by the rulesync skill)
  • [prompts/skills] Optimised dev-server skill — added multi-repo URL table, troubleshooting section, removed redundant _dev-server-core.md partial
  • [prompts/skills] Optimised plunker skill — extracted CSS into assets/ag-example-styles.css, slimmed guide, improved description
  • [prompts/skills] Enhanced git-conventions skill — expanded description for better auto-triggering, added PR base branch guidance
  • [prompts/skills] Enhanced pr-create skill — improved PR creation guidelines
  • [prompts/config] Added WorktreeCreate and WorktreeRemove hooks to .claude-settings.json for automated worktree lifecycle management
  • [scripts/setup-prompts] Updated verify-rulesync.sh to include files in skill subdirectories (e.g. assets/) in the expected inventory
  • [scripts] Added scripts/setup-worktree/claude-worktree-create.sh and claude-worktree-remove.sh for Claude Code worktree lifecycle

Migration Actions

  • Remove .rulesync/rules/rulesync.md file symlink (target guide was deleted)
  • Add .rulesync/skills/rulesync directory symlink -> ../../external/ag-shared/prompts/skills/rulesync/
  • Run ./external/ag-shared/scripts/setup-prompts/setup-prompts.sh
  • Run ./external/ag-shared/scripts/setup-prompts/verify-rulesync.sh

Post-Migration Verification

  • Confirm /rulesync skill is available (type /rulesync help in Claude Code)
  • Confirm the old rulesync rule no longer loads (check .claude/rules/ for stale rulesync.md)
  • Test worktree creation: run /worktree <branch-name> in Claude Code and verify the hook creates the worktree under ~/.worktrees/<repo>/
  • Test worktree removal: exit the worktree session and verify cleanup runs without errors
  • Verify dev-server skill still triggers correctly (/dev-server help)

Notes

The rulesync guide-to-skill migration is a structural change: consuming repos that had a .rulesync/rules/rulesync.md file symlink pointing to ../../external/ag-shared/prompts/guides/rulesync.md must remove it (the target no longer exists) and add a directory symlink at .rulesync/skills/rulesync instead. The new worktree hook scripts (scripts/setup-worktree/) are referenced from .claude-settings.json and do not need .rulesync/ symlinks.