New Adapter

New Adapter

Instructions

Complete workflow for adding support for a new AI tool to AIS.

Prerequisites

Before starting, gather this information:

• Tool name (e.g., "windsurf", "mcp")
• Rule/config types supported (e.g., rules, commands, skills)
• Default source directory (e.g., .windsurf/rules/)
• Target directory (usually same as source)
• File mode: file or directory

Steps

1. Create Adapter File

Create src/adapters/-.ts:

import { createBaseAdapter } from './base.js';

export const myToolAdapter = createBaseAdapter({
  name: '-',
  tool: '',
  subtype: '',
  configPath: ['', ''],
  defaultSourceDir: './',
  targetDir: './',
  mode: 'directory', // or 'file'
});

2. Register Adapter

In src/adapters/index.ts:

• Import the new adapter
• Register in DefaultAdapterRegistry constructor

3. Update Project Config

In src/project-config.ts:

• Add tool section to ProjectConfig interface
• Add tool to SourceDirConfig interface if needed

4. Wire CLI Commands

In src/cli/register.ts:

• Add tool subcommand group
• Register add/remove/install/import commands

5. Update Completion

In src/completion.ts:

• Add tool to completion types
• Add subtype completions

In src/completion/scripts.ts:

• Update bash/zsh/fish completion scripts

6. Add Tests

Create src/__tests__/-.test.ts:

• Test adapter properties
• Test add/remove operations
• Test config path resolution

7. Update Documentation

• README.md: Add to supported sync types table
• README_ZH.md: Sync changes (use /sync-readme)
• CLAUDE.md: Update if architectural changes

8. Verify

# Build
npm run build

# Run tests
npm test

# Test manually
node dist/index.js   add 
node dist/index.js   remove 

Checklist

• [ ] Adapter file created
• [ ] Adapter registered
• [ ] ProjectConfig updated
• [ ] CLI commands wired
• [ ] Completion updated
• [ ] Tests written and passing
• [ ] README.md updated
• [ ] README_ZH.md synced
• [ ] Manual testing complete

Examples

Request: Add support for a new AI tool with rules and skills Result: Complete adapter implementation with tests passing

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: lbb00
• Source: lbb00/ai-rules-sync
• License: Unlicense
• Homepage: https://lbb00.github.io/ai-rules-sync

Install and usage instructions live in the source repository linked above.