🧠 VEYRA AGENT: The Original One-Man Army for Vibe Coders

Architected & Engineered by Muhammad Talha Farid
UNDERSTAND • ARCHITECT • BUILD • VERIFY • PRODUCTION-READY
Intent-Driven • Resource-Aware • Credit-Efficient • Zero External Dependencies

VEYRA AGENT is the definitive standalone engineering brain that transforms any vibe coder into a disciplined, self-sufficient one-man software company.

Drop the single VEYRA/ engine into any project to instantly unlock an executive AI orchestrator, 7 core engineering superpowers, zero-dependency production primitives, an embedded visual database studio, and an automated credit economy engine.

⚡ Quickstart • ✨ 7 Superpowers • 🛠️ Production Primitives • 💻 Visual Studio • 🛡️ Multi-Vector QA • 📁 Structure

💡 Why VEYRA? The Problem vs. The Solution

Vibe coders love moving fast with generative AI, but uncapped AI agents inevitably trigger fatal engineering bottlenecks:

Standard AI Vibe Coding Flaws ❌	The VEYRA Engineered Solution 🛡️
Token & Credit Bleed: Agents scan 50+ files repeatedly, wasting 80% of context and token budgets on redundant directory reads.	Credit Economy Engine: Automatically compiles project memory into `.veyra/manifest.json`, reducing context footprint by 70–85%.
Fake Latency Stubs: AI places `setTimeout` or `Future.delayed` to simulate async operations without real backends.	Directive 24 Anti-Mock Sentinel: Hard failure guards block fake timers, dummy logins, and placeholder `// TODO` stubs.
Monetization Roadblocks: Inability to safely implement or verify Stripe webhooks and checkout flows without massive npm packages.	Native Payments Primitive: Constant-time HMAC-SHA256 signature verification and checkout session creation using standard `node:crypto`.
Database Blindness: AI hallucinates queries with zero visibility into live SQLite tables or schema constraints during dev.	Embedded Database Studio: Live web-based table explorer and row inspector running directly on native SQLite with zero config.
Infinite Code Thrashing: AI spins in doom-loops attempting random trial-and-error fixes.	Systematic Debugging & Circuit Breaker: 4-layer root-cause isolation (Directive 49 halts repetitive loops after 2 attempts).

⚡ The 7 Vibe-Coding Superpowers

Every superpower can be invoked through standard CLI terminal commands, modular AI agent skills, or the embedded visual web studio:

                  ┌─────────────────────────────────────────┐
                  │          VIBE INTAKE / USER RAW IDEA    │
                  └────────────────────┬────────────────────┘
                                       │
            ┌──────────────────────────▼──────────────────────────┐
            │  SUPERPOWER 1: BRAINSTORMER (Socratic Exploration)   │
            │  User Journey Mapping • Relational Data Entities    │
            └──────────────────────────┬──────────────────────────┘
                                       │
            ┌──────────────────────────▼──────────────────────────┐
            │  SUPERPOWER 2: PLAN WRITER (Architectural Engine)   │
            │  4 Atomic Phases • Automated Verification Gates     │
            └──────────────────────────┬──────────────────────────┘
                                       │
            ┌──────────────────────────▼──────────────────────────┐
            │  SUPERPOWER 3: EXECUTION SENTINEL                   │
            │  Directive 49 Circuit Breaker • Anti-Loop Sentinel  │
            └──────────────────────────┬──────────────────────────┘
                                       │
            ┌──────────────────────────▼──────────────────────────┐
            │  SUPERPOWER 4: SYSTEMATIC SCIENTIFIC DEBUGGER       │
            │  State → Network → Backend → Database Isolation     │
            └──────────────────────────┬──────────────────────────┘
                                       │
            ┌──────────────────────────▼──────────────────────────┐
            │  SUPERPOWER 5: TEST-DRIVEN QA & ANTI-MOCK GUARD     │
            │  Real Functionality • Zero Stubs • Secret Sanity    │
            └──────────────────────────┬──────────────────────────┘
                                       │
            ┌──────────────────────────▼──────────────────────────┐
            │  SUPERPOWER 6: ANTI-GENERIC UI SYSTEM               │
            │  Bespoke HSL Tokens • Reactive Signals & Rollbacks  │
            └──────────────────────────┬──────────────────────────┘
                                       │
            ┌──────────────────────────▼──────────────────────────┐
            │  SUPERPOWER 7: SCAFFOLDER & PRODUCTION DEPLOYER     │
            │  SaaS / API / Flutter • Hardened Docker • CI/CD     │
            └─────────────────────────────────────────────────────┘

Superpower	Command	What It Delivers
1. Brainstormer	`node VEYRA/veyra-brain.mjs brainstorm "<vibe>"`	Transforms informal vibe concepts into relational schemas, edge cases, user journeys, and API contracts.
2. Plan Writer	`node VEYRA/veyra-brain.mjs plan "<task>"`	Produces a verifiable 4-phase technical roadmap. Banned: vague "implement the rest" shortcuts.
3. Execution Sentinel	`node VEYRA/veyra-brain.mjs execute`	Monitors task progress and halts repetitive execution loops via Directive 49 circuit breaker.
4. Systematic Debugger	`node VEYRA/veyra-brain.mjs debug "<error>"`	Isolates issues across 4 failure domains (Client State, Network, Backend, DB) before touching code.
5. Anti-Mock Sentinel	`node VEYRA/veyra-brain.mjs guard`	Automated scanner enforcing Directive 24; fails immediately if fake delays, dummy auth, or leaked secrets exist.
6. Anti-Generic UI	`node VEYRA/veyra-brain.mjs ui`	Bespoke HSL color tokens, micro-interactions, responsive CSS components, and fine-grained reactive signals.
7. Production Scaffolder	`node VEYRA/veyra-brain.mjs scaffold <stack> "<name>"`	1-click generators for full-stack SaaS, REST APIs, 2026 Flutter apps, landing pages, and Docker deployments.

🛠️ Zero-Dependency Production Primitives

Every primitive operates exclusively on Node.js standard libraries (node:crypto, node:sqlite, node:http, node:fs). Zero npm install needed:

1. Cryptographic Authentication & RBAC (`primitives/auth.mjs`)

Salted PBKDF2/scrypt password hashing with unique per-user salts.
HMAC-SHA256 stateless JWT generation and verification.
Constant-time equality checks (crypto.timingSafeEqual) preventing timing attacks.
Role-based access control (RBAC) middleware for multi-role SaaS.

2. Native SQLite WAL Engine (`primitives/db.mjs`)

Powered by native node:sqlite with Write-Ahead Logging (PRAGMA journal_mode = WAL).
Enforces relational foreign keys (PRAGMA foreign_keys = ON).
Automated idempotent migration tracking table (_veyra_migrations).

3. High-Performance HTTP Router (`primitives/router.mjs`)

Parameterized route matching with regex path extractors (/api/users/:id).
1MB streaming body limit guarding against payload-overflow DoS attacks.
Built-in preflight CORS handling, res.json(), and standardized res.error().

4. Fine-Grained Reactive Store & Signals (`primitives/reactive.mjs`)

createSignal(value): Reactive primitive with subscriber notifications for zero-build frontends.
createStore(initialState): Action-based state management with automatic optimistic UI rollback upon server rejections.
bindDOM(selector, signal): Declarative two-way DOM binding without virtual DOM overhead.

5. Native Payments & Webhook Verifier (`primitives/payments.mjs`)

Native Stripe checkout session dispatcher via standard HTTPS requests.
Cryptographic stripe-signature verification using HMAC-SHA256 constant-time comparison with timestamp drift tolerance.

6. Anti-Generic Design Tokens & UI Kit (`primitives/ui-kit.css` & `components.html`)

Handcrafted fluid HSL design tokens (dark-mode first, WCAG AA compliant).
Accessible modals, buttons, forms, badges, and responsive containers.

🚀 Quickstart & Installation

Option 1: Drop into Any Existing Project

You can integrate VEYRA into any existing project in 10 seconds:

# 1. Copy the VEYRA folder into your project root
cp -r /path/to/VEYRA ./my-project/VEYRA

# 2. Run 1-click activation (links agent rules, skills, and manifest)
# Windows:
VEYRA\activate.bat

# macOS / Linux:
bash VEYRA/activate.sh

Option 2: Run Standalone CLI Commands

# 1. ⚡ Superpower 1: Turn any vibe into a complete engineering spec
node VEYRA/veyra-brain.mjs brainstorm "AI-powered invoice manager"

# 2. 📋 Superpower 2: Generate an atomic, verifiable implementation roadmap
node VEYRA/veyra-brain.mjs plan "Implement Stripe subscription portal"

# 3. 🔍 Superpower 4: Zero-guesswork scientific debugging
node VEYRA/veyra-brain.mjs debug "TypeError: Cannot read properties of undefined (reading 'userId')"

# 4. 💾 Credit Economy: Index project into .veyra/manifest.json (saves 80% AI tokens)
node VEYRA/veyra-brain.mjs manifest

# 5. 🗄️ Embedded Database Studio: Inspect tables and live rows
node VEYRA/veyra-brain.mjs db          # Lists all tables and row counts
node VEYRA/veyra-brain.mjs db users    # Displays rows from users table

# 6. 🛡️ Anti-Mock Guard: Scans and blocks fake timers, stubs, and leaked secrets
node VEYRA/veyra-brain.mjs guard

# 7. 🚀 Scaffold a complete production stack
node VEYRA/veyra-brain.mjs scaffold saas "MySaaS"          # Full-Stack SaaS (Auth + DB + UI)
node VEYRA/veyra-brain.mjs scaffold api "PaymentService"  # High-performance REST API
node VEYRA/veyra-brain.mjs scaffold flutter "veyra_app"   # 2026 Flutter (Riverpod + GoRouter)
node VEYRA/veyra-brain.mjs scaffold website "LaunchSite"  # Responsive Landing Page

# 8. 🛡️ Run the multi-vector automated test harness
node VEYRA/veyra-brain.mjs test

# 9. 📦 Generate hardened Dockerfile, docker-compose, and GitHub Actions CI/CD
node VEYRA/veyra-brain.mjs deploy

💻 Embedded Visual Web Studio

Launch the full visual engineering cockpit locally:

node VEYRA/veyra-brain.mjs studio

Open http://localhost:4422 in your browser to access:

Interactive Vibe-to-Spec Brainstormer: Real-time relational entity generator.
Phased Plan Generator: Atomic 4-phase checklists with copyable markdown.
Root-Cause Debugger Assistant: 4-layer diagnostic questionnaire.
1-Click Codebase Scaffolder: Interactive visual project generator.
Live Database Studio: Visual SQLite table explorer and live record inspector.
Credit Economy & Manifest Inspector: 1-click "Copy AI Context" button for ChatGPT, Claude, and Antigravity.

🛡️ Multi-Vector Automated QA Audit

VEYRA includes a built-in automated QA testing harness that verifies your codebase against the 55 Master Directives:

node VEYRA/veyra-brain.mjs test

Verified Audit Vectors:

Directive 24 (Anti-Mock Sentinel): Prohibits fake setTimeout, Future.delayed, and mock promises.
Directive 23 (Security & Sanitization): Validates zero hardcoded API keys, secrets, or unhashed passwords.
Directive 28 (Accessibility): Enforces WCAG AA form labels, inputs, and interactive element contracts.
Directive 20 (Relational Integrity): Validates primary keys, foreign keys, and migration tables in SQLite.
Directive 44 (Vibe-Coder Sanity): Rejects // TODO stubs, empty catch blocks, and dummy placeholders.

🤝 Supported AI Coding Environments

VEYRA natively configures cognitive directives and skills for:

Google Antigravity & Gemini IDE: Native .agents/skills and GEMINI.md directives.
Anthropic Claude Code: High-density CLAUDE.md / AGENTS.md rule set.
Cursor / Windsurf: Custom .cursorrules integration via node VEYRA/veyra-brain.mjs activate.
ChatGPT & GitHub Copilot: Zero-token manifest summaries ready for prompt injection.

📁 Repository Structure

.
├── .agents/                   # Native agent rules and modular skills
│   ├── rules/veyra-agent.md   # Complete 55 Master Directives
│   └── skills/                # 7 Atomic engineering skills
├── .github/workflows/         # Production CI/CD automated pipeline
│   └── deploy.yml             # GitHub Actions verify-and-build workflow
├── .veyra/                    # Credit economy project memory
│   └── manifest.json          # Cached schemas, routes, and tokens
├── bin/                       # Global CLI executables
│   ├── veyra.mjs              # Command line runner
│   └── veyra-core.mjs         # Core CLI engine
├── src/                       # High-performance React web orchestrator
├── VEYRA/                     # Standalone Zero-Dependency Engine
│   ├── AGENTS.md              # Cognitive brain protocol
│   ├── GEMINI.md              # Antigravity directive set
│   ├── RULES.md               # 55 Master Directives reference
│   ├── SKILL.md               # Cheatsheet & orchestration index
│   ├── LICENSE                # MIT License
│   ├── veyra-brain.mjs        # Master CLI launcher
│   ├── engines/               # Scaffolder, Manifest, Superpowers, QA, Deployer
│   ├── primitives/            # Auth, SQLite WAL, Router, Signals, Stripe Payments
│   ├── skills/                # 7 Standalone modular skills
│   └── studio/                # Visual Web Cockpit (http://localhost:4422)
├── Dockerfile                 # Multi-stage hardened production container
├── docker-compose.yml         # Container orchestration
├── package.json               # Project manifest
└── LICENSE                    # Open-source MIT License

⚖️ Creator & License

Architect & Lead Engineer: Muhammad Talha Farid
License: MIT License. Open for indie hackers, vibe coders, and commercial teams worldwide.

Navigation Menu

Repository files navigation

🧠 VEYRA AGENT: The Original One-Man Army for Vibe Coders

💡 Why VEYRA? The Problem vs. The Solution

⚡ The 7 Vibe-Coding Superpowers

🛠️ Zero-Dependency Production Primitives

1. Cryptographic Authentication & RBAC (`primitives/auth.mjs`)

2. Native SQLite WAL Engine (`primitives/db.mjs`)

3. High-Performance HTTP Router (`primitives/router.mjs`)

4. Fine-Grained Reactive Store & Signals (`primitives/reactive.mjs`)

5. Native Payments & Webhook Verifier (`primitives/payments.mjs`)

6. Anti-Generic Design Tokens & UI Kit (`primitives/ui-kit.css` & `components.html`)

🚀 Quickstart & Installation

Option 1: Drop into Any Existing Project

Option 2: Run Standalone CLI Commands

💻 Embedded Visual Web Studio

🛡️ Multi-Vector Automated QA Audit

Verified Audit Vectors:

🤝 Supported AI Coding Environments

📁 Repository Structure

⚖️ Creator & License

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
.agents		.agents
.github/workflows		.github/workflows
.veyra		.veyra
VEYRA		VEYRA
bin		bin
src		src
.env.example		.env.example
.gitignore		.gitignore
AGENTS.md		AGENTS.md
Dockerfile		Dockerfile
GEMINI.md		GEMINI.md
LICENSE		LICENSE
README.md		README.md
docker-compose.yml		docker-compose.yml
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.js		tailwind.config.js
tsconfig.json		tsconfig.json
vite.config.ts		vite.config.ts

Latest commit

History

Folders and files

Repository files navigation

🧠 VEYRA AGENT: The Original One-Man Army for Vibe Coders

💡 Why VEYRA? The Problem vs. The Solution

⚡ The 7 Vibe-Coding Superpowers

🛠️ Zero-Dependency Production Primitives

1. Cryptographic Authentication & RBAC (primitives/auth.mjs)

2. Native SQLite WAL Engine (primitives/db.mjs)

3. High-Performance HTTP Router (primitives/router.mjs)

4. Fine-Grained Reactive Store & Signals (primitives/reactive.mjs)

5. Native Payments & Webhook Verifier (primitives/payments.mjs)

6. Anti-Generic Design Tokens & UI Kit (primitives/ui-kit.css & components.html)

🚀 Quickstart & Installation

Option 1: Drop into Any Existing Project

Option 2: Run Standalone CLI Commands

💻 Embedded Visual Web Studio

🛡️ Multi-Vector Automated QA Audit

Verified Audit Vectors:

🤝 Supported AI Coding Environments

📁 Repository Structure

⚖️ Creator & License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

1. Cryptographic Authentication & RBAC (`primitives/auth.mjs`)

2. Native SQLite WAL Engine (`primitives/db.mjs`)

3. High-Performance HTTP Router (`primitives/router.mjs`)

4. Fine-Grained Reactive Store & Signals (`primitives/reactive.mjs`)

5. Native Payments & Webhook Verifier (`primitives/payments.mjs`)

6. Anti-Generic Design Tokens & UI Kit (`primitives/ui-kit.css` & `components.html`)