100xprism 2.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rajit Saha
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,196 @@
+<div align="center">
+
+<img src="assets/100xprism-logo.svg" alt="100xPrism logo" width="120" />
+
+# 100xPrism
+
+### Stop vibe coding. Ship production-grade software.
+
+[![Version](https://img.shields.io/github/v/release/rajitsaha/100xprism?style=flat-square&label=version&color=brightgreen)](https://github.com/rajitsaha/100xprism/releases/latest)
+[![npm](https://img.shields.io/npm/v/100xprism?style=flat-square&color=red)](https://www.npmjs.com/package/100xprism)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)](LICENSE)
+
+**One source of truth.** 66 modules generate native config for **Claude Code · Cursor · Codex · Windsurf · Copilot · Gemini · Antigravity**. Quality gates run on every commit.
+
+<img src="assets/100xprism-hero.svg" alt="100xPrism — one config, every AI coding tool · 13 plugins, 26 slash commands, 40 auto-trigger skills" width="100%" />
+
+</div>
+
+---
+
+## Install
+
+**npm (any platform — macOS, Linux, Windows):**
+```bash
+npm install -g 100xprism && 100xprism install
+```
+
+**curl (macOS / Linux):**
+```bash
+curl -fsSL https://raw.githubusercontent.com/rajitsaha/100xprism/main/get.sh | bash
+source ~/.zshrc   # or ~/.bashrc — activates the 100xprism command
+```
+
+Either way, `100xprism install` clones the toolkit to `~/100xprism` and provisions your AI tools. The npm package is a thin launcher — the modules, hooks, and plugins live in that clone, which `100xprism update` keeps current.
+
+> **Windows:** plugin sync works, but native Windows module emit is being reworked ([#54](https://github.com/rajitsaha/100xprism/issues/54)). For full module support today, install under **WSL** with either method above.
+
+**Set up a project:**
+```bash
+cd your-project && 100xprism init
+```
+
+**Keep up to date:**
+```bash
+100xprism update                    # pull latest, then add/update/remove skills + plugins
+100xprism update --plugins-only     # refresh plugins only (repo already current)
+npm install -g 100xprism@latest     # (optional) upgrade the launcher itself
+```
+
+`install` and `update` are **fully reconciling**, not append-only — every run:
+- **adds** newly shipped skills, slash commands, and curated plugins,
+- **updates** changed ones in place, and
+- **removes** skills, slash-command aliases, and 100xprism-managed plugins that were deleted or merged upstream.
+
+Your own hand-authored skills/commands and any plugins you enabled yourself are never touched. See [docs/USAGE.md](docs/USAGE.md#keeping-up-to-date) for details.
+
+> **Cloned to a custom path?** The default install lives at `~/100xprism`. If you cloned elsewhere, update your shell + Claude Code config — see [Custom install location](docs/USAGE.md#custom-install-location).
+
+---
+
+## The pipeline
+
+```
+/understand → /context → /issue → /spec → /fix → /commit
+                                                    ↓
+              /techdebt ← /gate → /grill → /pr → /push → /release
+```
+
+Every `/commit` and `/push` runs a 5-point gate — tests, security, build, Docker, cloud. Nothing ships without passing.
+
+---
+
+## What you get
+
+| | |
+|---|---|
+| **66 modules** | 26 slash commands + 40 auto-trigger skills — see [full reference below](#slash-commands) |
+| **13 Claude Code plugins** | superpowers, playwright, github, hookify, claude-mem, understand-anything, ui-ux-pro-max, and more |
+| **7 database engines** | Postgres, Cloud SQL, Snowflake, Databricks, Athena, Presto, Oracle — one `/db` interface |
+| **27 SaaS CLIs** | `/connect` installs + authenticates GitHub, AWS, Stripe, Supabase, and more from `.env` |
+| **4 project templates** | node-fullstack · node-frontend · python-api · docker-compose |
+| **CI/Release pipelines** | Drop-in GitHub Actions for lint + real-DB tests + E2E + semantic-release |
+
+---
+
+## Slash commands
+
+The following 26 slash commands are available. Run them inside Claude Code. In Codex, use the generated repo skill by name instead, for example `$gate`, `$commit`, or `/skills`.
+
+### Lifecycle
+
+| Command | What it does |
+|:--------|:-------------|
+| `/branch` | Create a conventional feature branch (`feat/`, `fix/`, `chore/`) |
+| `/commit` | Gate → stage → conventional commit |
+| `/grill` | Adversarial code review before opening a PR |
+| `/pr` | Gate → push branch → create PR |
+| `/push` | Gate → push → monitor CI → verify production health |
+| `/release patch\|minor\|major` | Semantic versioning + publish to PyPI/npm/Docker Hub |
+| `/launch` | Full deploy pipeline in one command |
+
+### Quality
+
+| Command | What it does |
+|:--------|:-------------|
+| `/gate` | **Mandatory** 5-point quality gate (tests, security, build, Docker, cloud) |
+| `/test` | All test layers (unit, integration, E2E) — loops until 95% coverage |
+| `/lint` | Auto-detect and fix all lint errors (ESLint, TypeScript, ruff) |
+| `/security` | Vulnerability + secrets scan, auto-fix where possible |
+| `/cloud-security` | GCP IAM, networking, PII, and compliance scan |
+| `/eval` | Run module evals — check triggers and output quality |
+
+### Engineering
+
+| Command | What it does |
+|:--------|:-------------|
+| `/spec` | Turn a vague request into an implementation-ready spec |
+| `/fix` | Autonomous bug fixer — CI failures, docker logs, Slack pastes |
+| `/orchestrate` | Plan-first methodology for complex multi-step tasks |
+| `/techdebt` | Dead code, duplication, stale TODOs |
+| `/context` | 7-day git + GitHub activity dump — orient before coding |
+| `/update-claude` | Write a CLAUDE.md rule after any correction |
+
+### Data & Infrastructure
+
+| Command | What it does |
+|:--------|:-------------|
+| `/db` | Query any of 7 database engines from one interface |
+| `/query` | Plain-English analytics — describe what you want, get SQL |
+| `/connect` | Install + auth 27 SaaS CLIs from `.env` |
+
+### Documentation & Architecture
+
+| Command | What it does |
+|:--------|:-------------|
+| `/docs` | Detect code changes and update documentation |
+| `/issue` | Investigate a bug and create a detailed GitHub issue |
+| `/architect` | Architectural Q&A and decision matrices |
+| `/enterprise-design` | Full technical blueprint — IA, API, data model, stack |
+
+### Auto-trigger skills (39)
+
+These modules activate automatically when you describe a relevant task — no slash command needed.
+
+| Category | Modules |
+|:---------|:--------|
+| **Marketing copy** | copywriting, copy-editing, cold-email, email-sequence, ad-creative, social-content |
+| **SEO** | seo-audit, ai-seo, programmatic-seo, schema-markup, site-architecture |
+| **CRO & conversion** | page-cro, signup-flow-cro, onboarding-cro, form-cro, popup-cro, paywall-upgrade-cro |
+| **Growth & strategy** | content-strategy, marketing-ideas, marketing-psychology, launch-strategy, referral-program, churn-prevention, free-tool-strategy, ab-test-setup, analytics-tracking, pricing-strategy |
+| **Sales** | sales-enablement, competitor-alternatives, paid-ads, revops, product-marketing-context |
+| **Design** | enterprise-design, visual-system-architect, interaction-engineer, figma-translator |
+| **Engineering** | subagents, terminal-setup |
+
+---
+
+## How it works in your tool
+
+| Tool | Generated artifact | Auto-trigger? |
+|:-----|:-------------------|:--------------|
+| **Claude Code** | `~/.claude/skills/<slug>/` + slash command aliases | Yes — per description |
+| **Cursor** | `.cursor/rules/<slug>.mdc` (one file per module) | Yes — per description |
+| **Codex** | `AGENTS.md` + `.agents/skills/<slug>/` + `.codex/hooks.json` | Yes — repo skills |
+| **Antigravity** | `ANTIGRAVITY.md` (core inlined + on-demand index) | Core only |
+| **Windsurf** | `.windsurfrules` (size-budgeted) | Core only |
+| **Copilot / Gemini** | `.github/copilot-instructions.md` / `GEMINI.md` | Core only |
+
+Modules with `tier: core` (26) inline into single-file tools; `tier: on-demand` (39) appear as a compact index. In Claude Code, Cursor, and Codex, modules are also available as native skills/rules so full bodies load on demand. Claude Code plugins remain Claude-specific; use Codex `/plugins` for Codex-native plugins.
+
+---
+
+## Common CI traps it fixes
+
+`npm install` 404 inside Docker · `useState(false)` opacity-0 breaking Playwright · integration tests silently excluded from the gate. [Full breakdown →](docs/ci-traps.md)
+
+---
+
+## More
+
+- [Full usage guide](docs/USAGE.md) — daily patterns, multi-project setup, CI templates, project config, troubleshooting
+- [Architecture](docs/v2-refactor.md) — why modules replaced workflows + skills
+- [Token usage & optimization](docs/token-optimization.md) — audit your plugin/skill footprint and monitor token spend with the local dashboard
+- [Changelog](CHANGELOG.md) · [Roadmap](ROADMAP.md) · [Issues](https://github.com/rajitsaha/100xprism/issues)
+
+---
+
+<div align="center">
+
+Built by [Rajit Saha](https://www.linkedin.com/in/rajsaha/) · 20+ years in enterprise data at Udemy, Experian, LendingClub, VMware, Yahoo
+
+[![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-blue?style=for-the-badge&logo=linkedin)](https://www.linkedin.com/in/rajsaha/)
+[![GitHub](https://img.shields.io/badge/GitHub-Follow-black?style=for-the-badge&logo=github)](https://github.com/rajitsaha)
+
+If this saves you time, **[star the repo](https://github.com/rajitsaha/100xprism)**.
+
+</div>

package/VERSION

@@ -0,0 +1 @@
+2.3.1

package/adapters/antigravity.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -e
+
+# shellcheck disable=SC1091
+source "$(dirname "${BASH_SOURCE[0]}")/lib/shared.sh"
+
+install_project() {
+  _run_generate "${1:-.}" "ANTIGRAVITY.md" "Antigravity" \
+    "Note: Antigravity adapter is provisional — update when format is confirmed."
+}
+
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  install_project "${1:-.}"
+fi

package/adapters/claude-code.sh

@@ -0,0 +1,160 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+MODULES_PY="$REPO_DIR/adapters/lib/modules.py"
+CLAUDE_DIR="$HOME/.claude"
+COMMANDS_DIR="$CLAUDE_DIR/commands"
+SETTINGS_FILE="$CLAUDE_DIR/settings.json"
+
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# install_global — install all 100xprism modules into Claude Code.
+# Each module becomes a skill at ~/.claude/skills/<slug>/SKILL.md.
+# Modules with a slash_command also get an alias at ~/.claude/commands/<name>.md.
+install_global() {
+  echo ""
+  echo "Installing modules for Claude Code..."
+
+  if [ -d "$COMMANDS_DIR" ] && [ "$(ls -A "$COMMANDS_DIR" 2>/dev/null)" ]; then
+    BACKUP="$CLAUDE_DIR/commands.bak.$(date +%Y%m%d_%H%M%S)"
+    cp -r "$COMMANDS_DIR" "$BACKUP"
+    echo -e "  ${YELLOW}→ Backed up existing commands to $(basename "$BACKUP")${NC}"
+  fi
+
+  python3 "$MODULES_PY" emit-claude-code
+
+  echo -e "  ${GREEN}→ Modules installed to ~/.claude/skills/ + slash aliases in ~/.claude/commands/ ✓${NC}"
+  echo -e "  ${CYAN}→ Restart Claude Code to load new modules${NC}"
+}
+
+install_project() {
+  local project_path="${1:-.}"
+  local instruction_file=""
+
+  for f in CLAUDE.md AGENTS.md .cursorrules .windsurfrules GEMINI.md; do
+    if [ -f "$project_path/$f" ]; then
+      instruction_file="$project_path/$f"
+      break
+    fi
+  done
+  if [ -f "$project_path/.github/copilot-instructions.md" ]; then
+    instruction_file="$project_path/.github/copilot-instructions.md"
+  fi
+
+  if [ -n "$instruction_file" ]; then
+    echo -e "  ${CYAN}→ Instruction file already exists: $instruction_file (skipping scaffold)${NC}"
+    return
+  fi
+
+  local target="$project_path/CLAUDE.md"
+  local project_name
+  project_name="$(basename "$(cd "$project_path" && pwd)")"
+
+  cat > "$target" << SCAFFOLD
+# $project_name — Project Instructions
+
+<!-- Generated by 100xprism. Fill in the sections below so modules like /db, /gate, /launch have project context. -->
+
+## Project
+
+<!-- Describe what this project does in 2-3 sentences. Used by /architect and /enterprise-design. -->
+description: TODO
+
+## Database
+
+<!-- Used by /db and /query. Remove if not applicable. -->
+# engine: postgres          # postgres | mysql | sqlite | snowflake | bigquery | athena | databricks | presto | oracle | cloud-sql
+# connection: default       # name of the connection block below
+# connections:
+#   default:
+#     host: localhost
+#     port: 5432
+#     name: mydb
+#     user: myuser
+#     auth: env:DB_PASSWORD  # env:VAR_NAME | secret:SECRET_NAME | prompt
+
+## Cloud (GCP)
+
+<!-- Used by /gate, /cloud-security, /launch. Remove if not on GCP. -->
+# gcp_project: my-gcp-project
+# cloud_run_service: my-service
+# region: us-central1
+
+## Production
+
+<!-- Used by /launch and /push for health checks and smoke tests. -->
+# production_url: https://example.com
+# health_url: https://example.com/health
+
+## Security Exceptions
+
+<!-- Known findings to skip in /security scans. One per line. -->
+# security_exceptions:
+#   - CVE-2023-XXXX: false positive in test dependency
+
+## Rules
+
+<!-- Add project-specific rules for Claude here. /update-claude appends to this section. -->
+
+SCAFFOLD
+
+  echo -e "  ${GREEN}→ Scaffolded CLAUDE.md in $project_path ✓${NC}"
+  echo -e "  ${YELLOW}→ Edit $target to fill in db/cloud/production config${NC}"
+}
+
+check_bun() {
+  if ! command -v bun &>/dev/null; then
+    echo ""
+    echo -e "  ${YELLOW}⚠ Bun is required by the claude-mem plugin but is not installed.${NC}"
+    echo ""
+    read -rp "  Install Bun now? (recommended) [Y/n]: " install_bun
+    install_bun="${install_bun:-Y}"
+    if [[ "$install_bun" =~ ^[Yy]$ ]]; then
+      echo "  Installing Bun..."
+      curl -fsSL https://bun.sh/install | bash
+      export BUN_INSTALL="$HOME/.bun"
+      export PATH="$BUN_INSTALL/bin:$PATH"
+      if command -v bun &>/dev/null; then
+        echo -e "  ${GREEN}→ Bun installed ✓${NC}"
+      else
+        echo -e "  ${YELLOW}→ Bun installed — restart your terminal to activate it${NC}"
+      fi
+    else
+      echo -e "  ${YELLOW}→ Skipping Bun install. claude-mem hooks will show errors until Bun is available.${NC}"
+    fi
+  fi
+}
+
+install_plugins() {
+  echo ""
+  echo "Installing plugins for Claude Code..."
+  mkdir -p "$CLAUDE_DIR"
+
+  check_bun
+
+  PLUGINS_FILE="$REPO_DIR/plugins/plugins.json"
+
+  if [ ! -f "$SETTINGS_FILE" ]; then
+    echo '{}' > "$SETTINGS_FILE"
+  fi
+
+  # Reconcile plugins (adds new, removes 100xprism-managed plugins dropped from
+  # plugins.json) — the same helper the update path uses, so install and update
+  # stay in agreement.
+  python3 "$REPO_DIR/adapters/lib/sync_plugins.py" \
+    --settings "$SETTINGS_FILE" --plugins "$PLUGINS_FILE"
+
+  echo -e "  ${GREEN}→ Plugins merged into ~/.claude/settings.json ✓${NC}"
+  echo -e "  ${CYAN}→ Restart Claude Code to activate new plugins${NC}"
+}
+
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  case "${1:-}" in
+    --plugins) install_plugins ;;
+    *) install_global ;;
+  esac
+fi

package/adapters/codex.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -e
+
+# shellcheck disable=SC1091
+source "$(dirname "${BASH_SOURCE[0]}")/lib/shared.sh"
+
+install_project() {
+  _run_codex "${1:-.}"
+}
+
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  install_project "${1:-.}"
+fi

package/adapters/copilot.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -e
+
+# shellcheck disable=SC1091
+source "$(dirname "${BASH_SOURCE[0]}")/lib/shared.sh"
+
+install_project() {
+  _run_generate "${1:-.}" ".github/copilot-instructions.md" "GitHub Copilot"
+}
+
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  install_project "${1:-.}"
+fi

package/adapters/cursor.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -e
+
+# shellcheck disable=SC1091
+source "$(dirname "${BASH_SOURCE[0]}")/lib/shared.sh"
+
+install_project() {
+  _run_cursor "${1:-.}"
+}
+
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  install_project "${1:-.}"
+fi

package/adapters/gemini.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -e
+
+# shellcheck disable=SC1091
+source "$(dirname "${BASH_SOURCE[0]}")/lib/shared.sh"
+
+install_project() {
+  _run_generate "${1:-.}" "GEMINI.md" "Gemini CLI"
+}
+
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  install_project "${1:-.}"
+fi