Piardify CLI & Visual Governance Engine (v2.13.0)

Official CLI & Agent Skill package for Piardify — AI PRD Generator, System Architecture Tracker, & Anti-Slop Visual Governance Engine.

⚡ What's New in v2.13.0

• 🚀 Lossless Context Densification Engine: Reduces context payload by ~65% via dense constraint syntax, unified UI governance (<ui_governance>), minified JSON, and active task windowing without losing 100% full context.
• 🎨 Dedicated Frontend Design Thinking Skill (frontend-design): Separated foundational studio design mindset (.agents/skills/frontend/SKILL.md) from modular taste skills to guide AI agents with grounded subject intent, distinctive typography, meaningful structure, and deliberate motion.
• ⚡ Dual-Skill Automatic Provisioning: npx piardify init automatically installs both piardify workflow skill and frontend design thinking skill into .agents/skills/.
• 🛡️ Mandatory AH-019 Gate: Added mandatory rule AH-019 to enforce loading frontend-design thinking before modifying any frontend UI/UX component.
• 💎 Dynamic Real-Time API Key Sync: Instant plaintext resolution and zero-friction copying in MCP Connect Modal & Developer Profile.

⚡ Quick Start

Run directly via npx (Zero Installation Required):

npx piardify --help

1. Authenticate

Authenticate using your API key from Piardify Settings:

npx piardify login --token <YOUR_PIARDIFY_API_KEY>

2. Connect Project & Install Agent Skills

Run inside your codebase workspace:

npx piardify init [--target web|mobile|iot|backend]

This automatically:

• Links your workspace to your Piardify Project.
• Generates Lossless Dense Context (.piardify/context.md).
• Generates 10ms native execution scripts (.piardify/sync).
• Installs Piardify Agent Skill (.agents/skills/piardify/SKILL.md).
• Installs Frontend Design Skill (.agents/skills/frontend/SKILL.md).

3. Check Status

Verify your connection and active project:

npx piardify status

🎨 Anti-Slop Visual Governance & Tooling

Piardify CLI enforces automated visual governance to ensure 100% human-designed aesthetics with zero AI slop:

1. Live Design Context & Tokens

Fetch live design tokens (colors, typography rules, radius hierarchy) directly from Piardify API:

npx piardify design

2. AST Static Analysis Anti-Slop Linter

Scan source code without runtime overhead for visual slop (gradient headlines, over-nested cards >2 levels, forbidden slop colors bg-slate-900/bg-black, icon container syndrome, indiscriminate rounded-2xl, slow motion latencies):

npx piardify validate-ui

3. On-Demand Taste Skill Fetcher

Fetch full design tokens and implementation guidelines on-demand when writing UI components:

npx piardify skill

4. Modular Theme Presets Generator

Generate Tailwind CSS preset (piardify.preset.js) and CSS variables (.piardify/theme.css):

npx piardify init-theme

5. Multi-Archetype Component Generator

Scaffold 100% Anti-Slop compliant UI components for 6 UI archetypes (card, hero, table, form, modal, bento):

npx piardify generate hero LandingHero
npx piardify generate table AuditTable
npx piardify generate form ProjectForm

6. Automated CI/CD & Git Guardrail Hooks

Install Git Pre-Commit Hook (.git/hooks/pre-commit) and NPM Pre-Build Script ("prebuild" in package.json) to block bad commits/builds automatically:

npx piardify hook

🛠️ CLI Command Reference Matrix

| Command | Category | Description | | :--- | :--- | :--- | | npx piardify login --token <t> | Auth | Authenticate CLI with Bearer API token | | npx piardify init [--target <t>] | Project Setup | Initialize workspace, context.md, and install Agent Skills | | npx piardify status | Health | Display connection status and project health | | npx piardify design | Visual Governance | Fetch live design context and color tokens | | npx piardify skill | Taste Skill | Fetch active Taste Skill specification on-demand | | npx piardify validate-ui | Quality QA | Run AST Anti-Slop Linter on workspace source files | | npx piardify init-theme | Theme | Generate Tailwind preset and CSS variables | | npx piardify generate [type] <Name> | Scaffolding | Scaffold Anti-Slop UI component (card, hero, table, form, modal, bento) | | npx piardify hook | CI/CD QA | Install Git pre-commit and NPM pre-build guardrails | | npx piardify project context | Agent API | Fetch lossless dense project context payload | | npx piardify task start <id> | Kanban Lifecycle | Claim and mark Kanban task as IN_PROGRESS (10ms) | | npx piardify task complete <id> | Kanban Lifecycle | Mark Kanban task as DONE (10ms) | | npx piardify kanban | Task Board | Query complete active Kanban board state |

📋 License

MIT © Piardify