Haraps (Hara XY Project Scaffolder)

Haraps is a high-performance, automated project scaffolding CLI tailored for the Hara XY ecosystem. It rapidly provisions a new repository with everything an AI Coding Agent needs to execute at a senior engineering level.

With a single command, Haraps injects standardized development scripts, deployment workflows, and aggressive AI alignment rules into your repository.

Usage

In any new or empty repository, simply run:

npx --yes haraps

No installation or configuration is required. The CLI will dynamically generate the environment in the current working directory.

What it Generates

When you run Haraps, it creates the following structure:

1. Dev & Deploy Scripts

• dev.sh / dev.ps1: Highly optimized local development runners that concurrently launch your Next.js frontend (port 3000) and Rust Cloudflare Worker backend (port 8787). Includes aggressive auto-cleanup for orphaned ports and a custom terminal dashboard.
• deploy.sh / deploy.ps1: Standardized production deployment scripts mapping the backend to Cloudflare Wrangler and the frontend to Vercel.

2. High-Performance Engineering Standards

• AGENTS.md: Injects 20 hardcore engineering rules instructing the AI to prioritize edge-first execution, strict typing, zero-warning linting, security-first principles, and accessibility.

3. Start Project Protocol

When you open your Coding Agent in a newly scaffolded directory and type "start project", the agent is hardcoded to:

1. Ask you for the project name and description.
2. Initialize the Next.js frontend and Rust backend adhering to your high-performance standards.
3. Automatically initialize a new Git repository and make the first commit.

4. Specialized Agent Skills & Workflows

• Ponytail (Lazy Senior Dev Mode): Enforces "the best code is the code never written", mandating deletion over addition and standard library usage over new dependencies.
• Security Review: Equips the agent to reason like a security researcher, scanning for deep data flow vulnerabilities before deploying.
• Kill AI Slop: Strips out cliché AI-generated aesthetics (e.g., indigo gradients, excessive emojis) in favor of clean, accessible UI.
• UI Sniper Telegram: Sets up a webhook-based UI feedback loop straight to a Telegram group.
• Workflows: Includes git-it (safe atomic rebasing and pushing) and deploy-and-talk (deployment with Telegram notifications).

Publishing Updates

To publish an update to the Haraps CLI:

1. Update the scaffolding logic in bin/index.js.
2. Bump the version in package.json.
3. Run npm publish in the package directory.