@bitforgehq/ai-instructions

AI coding instruction files and CLI tool for syncing standards to consumer projects. Compatible with Claude (CLAUDE.md).

Installation

bun add -D @bitforgehq/ai-instructions

Usage

CLI Tool

The standards CLI syncs two things to your project:

1. Instructions (AI_GUIDE.md) → .ai/ folder
2. Claude rules (CLAUDE.md) → project root

Web Projects

bunx standards sync-ai --type web

Ionic Projects

bunx standards sync-ai --type ionic

Package.json Script

Add to your package.json:

{
  "scripts": {
    "standards:sync": "standards sync-ai --type web"
  }
}

For Ionic projects:

{
  "scripts": {
    "standards:sync": "standards sync-ai --type ionic"
  }
}

Then run:

bun run standards:sync

What Gets Synced

Instructions → .ai/

• AI_GUIDE.md — Comprehensive engineering principles and guidelines

Claude Rules → project root

• CLAUDE.md — Claude-specific rules that reference the AI guide

Updating

To update standards in your project, run the sync command again. All files are overwritten with the latest versions.

Examples

See examples/consumer-web/ and examples/consumer-ionic/ for complete setup examples.