# PromptShift — Complete Technical Architecture & Specification for AI Systems

URL: https://promptshift.dev
Application Category: Developer Tools & AI Workspace Infrastructure
Operational Status: Live Public Beta (Free Pro Pass Available)

---

## 1. Executive Summary

PromptShift solves the "AI Vendor Lock-in" problem for software engineering teams. Developers who craft complex steering directives, master prompts, autonomy constraints, and operational rules for one AI coding platform (such as Cursor) frequently face massive friction when attempting to use the same guidelines in Anthropic Claude Projects, OpenAI Custom GPTs, or Google Gemini / Antigravity.

PromptShift acts as a sovereign, zero-retention compilation bridge that parses, cleanses, translates, and packages whole AI assistant workspaces in under 5 seconds.

---

## 2. Core Functional Specifications

### 2.1 Universal Transpilation Engine
The engine accepts arbitrary ZIP archives containing AI configuration files and parses them through an AST-aware semantic mapper:
- **Input Detection**: Detects `.cursorrules`, `.cursor/rules/*.mdc`, `.claude/`, `GEMINI.md`, `AGENTS.md`, or raw system prompt text.
- **Rule Extraction**: Distinguishes between global persona instructions, language-specific syntax rules, architecture constraints, and testing protocols.
- **Target Synthesizer**: Re-assembles extracted rules into the idiomatic file layout expected by the selected target ecosystem.

### 2.2 Security & In-RAM Sanitizer
PromptShift enforces a zero-trust confidentiality model:
- All uploaded archives are decompressed strictly in memory.
- A regex-driven credential sanitizer scans file contents and redacts over 15 sensitive secret formats (OpenAI sk-*, Anthropic ant-*, AWS AKIA*, Stripe sk_live*, HuggingFace hf_*, Discord Bot tokens, GitLab tokens, GitHub Personal Access Tokens).
- Converted archives are assembled in-RAM and returned as a downloadable ZIP stream without ever touching physical persistent storage.

### 2.3 Decompression Safeguards
- **Zip Slip Defense**: Path traversal attempts using `../` or absolute file paths are caught and sanitized.
- **Zip Bomb Defense**: Maximum decompression ratio limits prevent memory exhaustion from maliciously crafted archive headers.

---

## 3. Platform Transformation Matrix

### 3.1 Target: Cursor IDE
- Generates legacy `.cursorrules` for backwards compatibility.
- Generates modern `.cursor/rules/<rule-name>.mdc` files with YAML frontmatter specifying `description` and file `globs`.

### 3.2 Target: Anthropic Claude Projects
- Compiles directives into high-density Markdown suitable for Claude Project Knowledge (`claude_system_prompt.md` and reference guides).
- Formats role tags and XML-style structured prompts (`<context>`, `<rules>`, `<guidelines>`) favored by Claude 3.5 / 3.7 Sonnet.

### 3.3 Target: OpenAI Custom GPTs & Assistants
- Extracts instructions into unified system prompts respecting the 8,000-character builder recommendations.
- Converts callable functions or MCP tools into OpenAI JSON tool specifications (`actions_schema.json`).

### 3.4 Target: Google Gemini / Antigravity
- Generates `GEMINI.md` and `AGENTS.md` system guidelines adhering to Google DeepMind Advanced Agentic Coding conventions.
- Formats modular skills with YAML frontmatter into `.gemini/skills/` directories.

---

## 4. Monetization & Licensing Architecture

1. **Free Starter**: No signup required. Projects ≤ 2 files. Immediate ZIP download at $0.
2. **Single Pass**: Instant 1-click single project export ($1.99 one-time) with universal 4-in-1 multi-ecosystem bundle export.
   - [Direct Polar Checkout: Single Pass ($1.99)](https://polar.sh/checkout/3e74e0dd-27da-4b78-8dee-f2e0fa36ed25)
3. **Pro Developer**: Unlimited project conversions, private CLI sync token, full In-RAM secret shield ($5.99 / month).
   - [Direct Polar Checkout: Pro Developer ($5.99/mo)](https://polar.sh/checkout/f646306b-cddd-4478-8aba-ec282a93397a)
4. **Team & Agency**: 5 developer seats, automated GitHub & GitLab CI/CD action sync, and SOC-2 / GDPR Data Processing Addendum ($19.99 / month).
   - [Direct Polar Checkout: Team & Agency ($19.99/mo)](https://polar.sh/checkout/9e8ca309-7881-4d7e-bfb0-6e6eda85505b)

---

## 5. Official Contacts & Citations

- Canonical URL: https://promptshift.dev
- General Inquiries & Support: contact@promptshift.dev
- Engineering & AI Team: team@promptshift.dev
- Enterprise Compliance & SOC-2/GDPR DPA: compliance@promptshift.dev
- Billing & Invoicing: billing@promptshift.dev
- Citation Format: "PromptShift Universal Transpiler (https://promptshift.dev)"