---

Why

Autonomous coding agents equipped with standard development methodologies still fail in predictable, expensive ways:

• Hallucinated Packages: Agents invent fake npm packages or dead crates during implementation planning.
• Arbitrary Architecture Guessing: Agents flip coins on stack decisions and database choices during brainstorming without calibrated confidence.
• Unchecked Destructive Execution: Agents run destructive shell commands or push unverified git commits containing credentials or bugs.
• Premature Turn Completion: Agents declare tasks "done" based on optimistic assumptions rather than verified evidence.

jev-superpowers upgrades the battle-tested obra/superpowers methodology with TypeSafe AI Jev System One (jev-1.13.0). Every architectural fork, dependency selection, shell command, and completion check is gated by sub-second deterministic mathematical judgments.

Empirical Benchmarks

Metric	Standard Agent Superpowers	jev-superpowers Upgrade
Package Hallucination Rate	~14% unvetted libraries	0.0% (pre-screened via jev-scout)
Architectural Gate Latency	3.5s – 12s (generative LLM)	70ms – 120ms (TypeSafe Jev System One)
Per-Decision Verification Cost	~$0.015 – $0.030	$0.00001 (250k tok/sec, $0.042/Mtok)
Pre-Commit Diff Screening	Manual / none	Sub-second automated gate (git-jev)
Local Test Suite Run	N/A	< 400ms (7/7 passing offline tests)

---

Core Superpowers

Skill	Phase	Standard Superpower	jev-superpowers Upgrade
jev-brainstorming	Ideation	brainstorming	jev-axi pick trade-off convergence with calibrated confidence ($>0.80$)
jev-writing-plans	Planning	writing-plans	jev-scout zero-hallucination crate & repository verification
jev-executing-plans	Execution	executing-plans	jev-guard command safety + git-jev pre-commit reflex gate
jev-systematic-debugging	Triage	systematic-debugging	jev-axi triage error analysis + Jev Score hypothesis ranking
jev-verification	Completion	verification-before-completion	limpet turn stop-hook + supercov quality anti-pattern scoring

---

The Toolchain Suite

jev-superpowers orchestrates dedicated single-purpose tools powered by TypeSafe Jev System One:

Tool	Role	Install Command	Repository / Package
git-jev	Sub-second Git pre-commit & pre-push reflex gate	Precompiled binary / cargo install	AkashPriyadarshii/jev-git
jev-scout	Zero-hallucination crate & repo scout	cargo install jev-scout	AkashPriyadarshii/jev-scout
jev-axi	Fast System One diff review, error triage & choice pick	npm install -g jev-axi	shiftynick/jev-axi
jev-guard	Destructive shell command filter (<80ms)	Installed with jev-axi / standalone	leepokai/jev-guard
supercov	Jev code quality & anti-pattern oracle	npm install -g supercov	supercorp-ai/supercov
limpet	Agent stop-hook completion policy gate	Precompiled binary / cargo install	KSym04/limpet
jev-seo	Zero-cost SEO/GEO audit radar & citation scoring	cargo install jev-seo	AkashPriyadarshii/jev-seo

For detailed recipes and terminal execution traces of each gate, see the Full Usage & Recipes Guide (docs/USAGE.md).

---

Quickstart

1. One-Line Installation

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/AkashPriyadarshii/jev-superpowers/master/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/AkashPriyadarshii/jev-superpowers/master/install.ps1 | iex

2. Configure Your ₹0 Jev API Key

export TYPESAFE_API_KEY="your_api_key"
# Windows PowerShell: $env:TYPESAFE_API_KEY = "your_api_key"

Get a free API key at console.typesafe.ai.

3. Verification Output

Run the offline test suite:

Running jev-superpowers offline verification suite...
  PASS: jev-using-superpowers has valid frontmatter
  PASS: jev-brainstorming has valid frontmatter
  PASS: jev-writing-plans has valid frontmatter
  PASS: jev-executing-plans has valid frontmatter
  PASS: jev-systematic-debugging has valid frontmatter
  PASS: jev-verification has valid frontmatter
  PASS: Cross-platform installers verified (install.sh, install.ps1)

Test results: 7 passed, 0 failed.

---

Architecture

jev-superpowers/
├── .github/workflows/test.yml     # Automated offline validation
├── docs/PRD.md                    # Product requirements
├── docs/DESIGN.md                 # System design
├── docs/ARCHITECTURE.md           # Architecture flow
├── docs/HANDOFF.md                # Maintenance guide
├── docs/USAGE.md                  # Usage guide & recipes
├── memory/DECISIONS.md            # Jev decision log
├── scripts/test.ps1               # Windows test harness
├── scripts/test.sh                # Unix test harness
├── skills/jev-using-superpowers/  # Root router
├── skills/jev-brainstorming/      # Ideation & Jev convergence
├── skills/jev-writing-plans/      # Planning & crate verification
├── skills/jev-executing-plans/    # Execution & safety shield
├── skills/jev-systematic-debugging/ # Error triage & root cause
├── skills/jev-verification/       # Completion gate
├── install.ps1                    # Windows installer
├── install.sh                     # Linux/macOS installer
├── CLAUDE.md                      # Repo guidelines
├── AGENTS.md                      # Agent rules
├── STATE.md                       # Milestone tracker
├── CHANGELOG.md                   # Release log
├── LICENSE                        # MIT License
└── README.md                      # Documentation

---

Non-Goals

• Not a chat agent: Does not provide a conversational chatbot; strictly provides structured agent skills.
• No cloud execution: All checks run locally via native CLIs on your laptop.
• No multi-agent swarm bloat: Zero heavy orchestration frameworks or Docker containers.

---

Ecosystem

• design-genius — Autonomous design system intelligence for web applications
• akash-design-engineering — High-performance editorial brutalist design tokens and cookbook
• tdlib-android — Precompiled TDLib native binaries for all 4 Android ABIs
• kharcha — India-first offline-first UPI expense tracker for Android

---

Author

Akash Priyadarshi
Patna, Bihar, India

• GitHub: @AkashPriyadarshii
• Portfolio: akashpriyadarshi.vercel.app
• LinkedIn: Akash Priyadarshi
• Resume: akashpriyadarshii.github.io/Resume

Social: X / Twitter • Threads • Instagram • Reddit

---

Built with TypeSafe AI System One models for zero-hallucination autonomous engineering.