# Gemstack

> The high-velocity AI agent orchestration framework, natively optimized for Antigravity (v2.0).

- **Type:** MCP server
- **Install:** `agentstack add mcp-arvarik-gemstack`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [arvarik](https://agentstack.voostack.com/s/arvarik)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [arvarik](https://github.com/arvarik)
- **Source:** https://github.com/arvarik/gemstack
- **Website:** https://arvarik.com/gemstack

## Install

```sh
agentstack add mcp-arvarik-gemstack
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 💎 Gemstack

**The high-velocity AI agent orchestration framework, natively optimized for Antigravity.**

[](https://github.com/arvarik/gemstack/actions)
[](https://github.com/arvarik/gemstack/releases)
[](LICENSE)

---

## 🚀 Gemstack 2.0: The Antigravity Release

Gemstack has evolved. Version 2.0 is a fundamental architectural shift that moves beyond simple prompt-stitching into **Native Agentic Orchestration**. It is designed specifically to harness the full power of the **Antigravity (`agy`) CLI**.

### What makes 2.0 different?

*   **🧠 XML-Structured Mindsets**: Every expert role (Architect, SDET, DevOps, etc.) now uses a high-precision XML-tagged mindset. This ensures perfect instruction following and eliminates "Logic Drift" when working with Gemini 1.5 Pro and 2.0.
*   **🤖 Autonomous Subagents**: Roles are now **Subagent-Aware**. The framework no longer just tells the AI what to do; it gives the AI the tools to delegate. The Architect can now autonomously spawn a Security subagent to audit a schema before it ever reaches your codebase.
*   **📊 Native Artifact Integration**: We've deprecated manual planning files in favor of native Antigravity artifacts. `IMPLEMENTATION_PLAN.md`, `task.md`, and `walkthrough.md` are now the living, breathing heart of your project, providing real-time visual progress tracking.
*   **📐 Modern Topology Guardrails**: Topologies have been refreshed for the 2025 stack. 
    *   **Backend**: Drizzle ORM + Playwright integration.
    *   **Frontend**: Next.js 15 Server Components & Server Actions.
    *   **Infrastructure**: Proxmox/LXC resource limits and Caddy DNS-01 automation.
*   **🔍 Deterministic Phase Routing**: The new `agy` routing engine replaces the old status-file check with a high-fidelity artifact monitor, ensuring you never skip a step in the lifecycle.

---

## 🏗️ The 5-Step Lifecycle

Gemstack enforces a rigorous, contract-driven engineering process:

1. **Step 1: Spec** → Define the feature, design UX, and lock in executable contracts (Architect).
2. **Step 2: Trap** → Write failing automated tests that "trap" the requirement before coding (SDET).
3. **Step 3: Build** → Implement the logic until the "traps" pass (Principal Engineers).
4. **Step 4: Audit** → Security, performance, and accessibility review (Security Engineer).
5. **Step 5: Ship** → Deployment, infrastructure provisioning, and post-flight checks (DevOps Engineer).

---

## 📦 Installation

```bash
# Recommended: Install everything (AI, MCP, TUI)
pipx install "gemstack[all]"

# Or via uv (fastest)
uv tool install "gemstack[all]"
```

---

## 📖 Documentation

*   [Getting Started](docs/getting-started.md) — From zero to your first v2.0 workflow.
*   [The 5-Step Lifecycle](docs/the-5-step-lifecycle.md) — How the orchestration engine works.
*   [Topology Guardrails](docs/topologies.md) — Domain-specific rules for every project type.
*   [MCP Server & IDE Integration](docs/mcp-server.md) — Connecting Gemstack to Cursor and Claude.

---

## 🤝 Contributing

We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for our v2.0 XML prompting standards and development guidelines.

---

## ⚖️ License

Apache 2.0. See [LICENSE](LICENSE) for details.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [arvarik](https://github.com/arvarik)
- **Source:** [arvarik/gemstack](https://github.com/arvarik/gemstack)
- **License:** Apache-2.0
- **Homepage:** https://arvarik.com/gemstack

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-arvarik-gemstack
- Seller: https://agentstack.voostack.com/s/arvarik
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.