My/Pref/Dev/AI/Config/Management/Rulesync

• My Dev AI Config Management - Rulesync

  • see My/Pref/Dev/AI/Config/Management for the overview policy

  • Targets

    • generate for agentsskills, claudecode, and codexcli
      • agentsskills covers most non-Claude tools via the AgentSkills standard
      • claudecode generates Claude-specific outputs where needed; direct AGENTS.md loading is covered in My/Pref/Dev/AI/Config/Management/Use AGENTS.md Without Symlinks
      • codexcli is included solely because agentsskills does not generate AGENTS.md

  • Features

    • enable only rules and skills
    • do not enable commands because they are generally deprecated in favor of skills

  • Clean Regeneration

    • set delete: true in rulesync.jsonc — each run removes stale generated files before writing

  • Project Scope

    • use outputRoots: ["."] — project-scoped only
    • never write to user-global locations such as ~/.claude

  • Rule Philosophy

    • keep .rulesync/rules/ minimal: a single root rule that defers to skills for behavior
    • rationale: rules add to every-request context; skills load on demand

  • Instruction files and Windows

    • Follow My/Pref/Dev/AI/Config/Management/Use AGENTS.md Without Symlinks: prefer the neutral instruction file and generate additional client files when needed, without a mandatory symlink setup.

  • Declarative skill sources

    • Prefer rulesync/Skill/Declarative Source for shared external skills: declare sources in rulesync.jsonc, run mise x -- rulesync install, then mise x -- rulesync generate.
    • The dotfiles global configuration already uses this installation path rather than a separate installer per client.

  • Regeneration hooks

    • The dotfiles use Lefthook post-checkout and post-merge hooks to install declared sources and regenerate configuration. The repository's mise enter hook installs Lefthook hooks.
    • Hooks must be installed in each clone; merely committing a hook configuration does not activate it for everyone. Keep generated files checked in where clients need them before generation can run.