@bitforgehq/ai-instructions

AI coding instruction files and CLI tool for syncing standards to consumer projects. Features a comprehensive Angular 22 architecture guide and website guide (Astro + Payload) with standalone components, signals, signal forms, and resource-based data patterns — compatible with Claude (CLAUDE.md).

Supplementary reference: Angular's official AI guidance at https://angular.dev/ai — our guide takes precedence where they differ.

Installation

bun add -D @bitforgehq/ai-instructions

Usage

CLI Tool

The standards CLI syncs two things to your project:

1. Instructions (one or more guides) → .ai/ folder
2. Claude rules (CLAUDE.md) → project root

Which guides you get depends on --type:

| --type | Guides synced to .ai/ | Claude rules stack | | --------- | -------------------------------- | ------------------ | | web | AI_GUIDE.md | angular | | ionic | AI_GUIDE.md + IONIC_GUIDE.md | ionic | | website | WEBSITE_GUIDE.md | website |

Web Projects

bunx standards sync-ai --type web

Ionic Projects

bunx standards sync-ai --type ionic

Syncs both AI_GUIDE.md and IONIC_GUIDE.md. The Ionic guide layers on top of the Angular one rather than replacing it, so Angular architecture rules live in exactly one place and the Ionic guide carries only Ionic and Capacitor specifics (safe areas, page/header structure, tabs routing, Capacitor boundaries, native project handling).

Website Projects (Astro + Payload)

bunx standards sync-ai --type website

Syncs WEBSITE_GUIDE.md → .ai/ and the website CLAUDE.md → project root.

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 — Angular architecture: engineering principles and guidelines (web, ionic)
• IONIC_GUIDE.md — Ionic + Capacitor rules, layered on top of AI_GUIDE.md (ionic)
• WEBSITE_GUIDE.md — Astro + Payload website stack (website)

Claude Rules → project root

• CLAUDE.md — Claude-specific rules that reference the guides for that stack

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.