# irfanlovefront

> The human-grade frontend and taste engineering skill suite for AI coding assistants. Universal npx CLI, 8 specialized agent skills, zero generic templates, and zero em-dashes.

irfanlovefront is an open-source development ecosystem created by Raja Irfan Ahmed that elevates AI coding agents into principal frontend engineers. It eliminates AI-templated web slop by enforcing deterministic seed math, Emil Kowalski fluid interface physics, WCAG AA accessibility, and codified conversion foundations.

## Universal CLI Installation

Install and transpile the skill suite into your active workspace using one terminal command:

- Universal Interactive Setup: `npx irfanlovefront`
- Claude Code (.claude/skills/ + CLAUDE.md): `npx irfanlovefront --claude`
- Cursor Rules 2.0 (.cursor/rules/*.mdc): `npx irfanlovefront --cursor`
- Google Antigravity (.agents/skills/): `npx irfanlovefront --antigravity`
- Windsurf Cascade (.windsurf/rules/): `npx irfanlovefront --windsurf`
- GitHub Copilot (.github/copilot-instructions.md): `npx irfanlovefront --copilot`
- Full Ecosystem Deployment: `npx irfanlovefront --all`

## The 5-Stage Engineering Lifecycle

1. Stage 0: Pre-Architecture Consultation and Taste Brief (/taste-design-engineer)
2. Stage 1: Design Tokens, Substrate Theme and Vector Brand Emblem (/frontend-architect)
3. Stage 2: Persistent Navigation, 2-Line Hero Section and Bento Shell (/creative-layout-engineer)
4. Stage 3: Downstream Interactive Primitives and Motion Choreography (/interactive-component-engineer)
5. Stage 4: 45-Point Production Pre-Flight, 320px Mobile Audit and SEO (/experience-qa-auditor)

## The 8 Specialized Agent Skills

- /irfanlovefront: Master 5-stage lifecycle orchestrator.
- /taste-design-engineer: Formulates aesthetic briefs, animation curves, and 7 conversion rules.
- /frontend-architect: Generates fluid clamp scales, design tokens, and pure vector brand assets.
- /creative-layout-engineer: Crafts macro layouts, single-line navigation, and 2-line hero sections.
- /interactive-component-engineer: Builds double-bezel cards, spring physics, and 44px touch targets.
- /experience-qa-auditor: Executes 45-point pre-flight check, mobile audits, and technical SEO.
- /build-error-resolver: Surgical rapid recovery for lockfile, package, and TypeScript errors.
- /github-readme-writer: Technical documentation based on the Daytona open-source framework.

## Core Architectural Guarantees

- Zero Em-Dash Policy: Absolute ban on em-dash and en-dash characters across all copy.
- The 7 Conversion Foundations: Hero mini-site, squint test, point-of-doubt proof, 44px thumb targets.
- Double-Bezel Hardware Radii: Concentric outer shell and inner core radius mathematics.
- 100% Offline Compatible: Zero external telemetry, zero tracking, complete privacy.
- Standardized Day Theme: Warm utilitarian minimalist daylight substrate (#FAF9F5).

## Official Links & Repositories

- Public Skill Repository: https://github.com/rajairfanahmed/irfanlovefront
- Official Documentation: https://github.com/rajairfanahmed/irfanlovefront#readme
- Release 2.0.0 Notes: https://github.com/rajairfanahmed/irfanlovefront/releases/tag/2.0.0
- Full LLM Knowledge Base: https://irfanlovefront.vercel.app/llms-full.txt
- Author: Raja Irfan Ahmed
- License: Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)