bun-sticky-faf is now live on npm. A Bun-native FAF scoring CLI with zero dependencies, pure Bun APIs, and 333 championship-grade tests.

bunx bun-sticky-faf score

Built the Anthropic Way

We followed four principles:

  • First principles: No frameworks, no abstractions. Just the problem and the solution.
  • Zero dependencies: Pure Bun APIs only. No node_modules. No supply chain risk.
  • Native Bun: TypeScript runs directly. No build step. No transpilation.
  • TypeScript native: Full type safety without the toolchain overhead.

The result: a 25.5 kB package that cold starts in under 50ms and scores your project in under 100ms.

Wolfejam Slot-Based Scoring

bun-sticky-faf uses the same scoring system as faf-cli: 21 slots across 5 categories, with type-aware counting.

Project

3 slots

name, goal, main_language

Frontend

4 slots

frontend, css_framework, ui_library, state_management

Backend

5 slots

backend, api_type, runtime, database, connection

Universal

3 slots

hosting, build, cicd

Human

6 slots

who, what, why, where, when, how

Type-aware: A CLI project only needs 9 slots (project + human). A fullstack app needs all 21. The formula adjusts automatically.

Score = (Filled Slots / Applicable Slots) × 100

Tier System

Your score maps to a tier:

🏆 Trophy 100%
🥇 Gold 99%+
🥈 Silver 95%+
🥉 Bronze 85%+
🟢 Green 70%+
🟡 Yellow 55%+
🔴 Red <55%

Bronze (85%+) is the launch threshold. Below that, your AI context needs work.

333 Championship-Grade Tests

bun-sticky-faf has a WJTTC-certified test suite covering:

  • test.each - Parametrized tests
  • test.concurrent - Parallel execution
  • mock, spyOn - Full mocking
  • Lifecycle hooks - beforeAll, afterEach, etc.
  • Custom matchers - toBeValidScore(), toBeValidTier()
  • Snapshots - Regression protection
bun test
# 333 tests, 328 pass

Commands

faf score      # Show FAF score + tier
faf init myapp # Create project.faf
faf sync       # Sync to CLAUDE.md
faf help       # Show commands

The sync command now preserves your existing CLAUDE.md content - it only updates the score badge.

Installation

# Run directly
bunx bun-sticky-faf score

# Install globally
npm install -g bun-sticky-faf
bun add -g bun-sticky-faf

FAF Ecosystem

bun-sticky-faf joins the FAF family:

  • faf-cli - Node.js CLI (15,000+ downloads)
  • claude-faf-mcp - Official MCP server
  • bun-sticky-faf - Bun-native CLI (you are here)
  • bun-sticky-zig - Zig-native CLI (77KB binary)

Same format. Same scoring. Different runtimes for different needs.

Links

GitHub npm

Zero dependencies. Pure Bun. 333 tests.

🏎️⚡ FAF Format Authority
🥐 Built for Bun
🆓 Open Source MIT