> ## Documentation Index
> Fetch the complete documentation index at: https://social-b97141fb-auto-generate-llmstxt.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Vise

> Give your AI coding agent a grounded, verifiable workflow for building social.plus features.

Vise helps AI coding agents integrate social.plus without guessing SDK APIs or stopping at code that merely looks finished. You ask for a feed, chat, communities, stories, or another product outcome; the agent plans, implements, checks, and explains the work.

After setup, you talk to your agent—not to Vise.

When you return to an existing project, `vise status . --format human` is the read-only front door. It routes the agent to one of three jobs—finish the build, assess a Day-2 change, or prepare release review—while keeping compliance, runtime proof, SDK assurance, organization policy, advisory review, Passport verification, and human approval as separate claims.

## Get started

<Info>
  Vise requires Node.js 20 or newer.
</Info>

<Steps>
  <Step title="Install Vise">
    ```sh theme={null}
    npm install -g @amityco/social-plus-vise
    ```
  </Step>

  <Step title="Add the skill to your coding agent">
    ```sh theme={null}
    vise install-skill --target claude     # Claude Code
    vise install-skill --target cursor .   # Cursor
    vise install-skill --target vscode .   # VS Code
    vise install-skill --target copilot .  # GitHub Copilot
    vise install-skill --target codex      # OpenAI Codex
    ```

    For another agent, use `vise print-skill` and paste the result into its instructions.
  </Step>

  <Step title="Ask for an outcome">
    ```text theme={null}
    Add a social feed to this app using social.plus.
    ```

    Your agent inspects the app and asks for decisions such as region, target screen, identity source, and feature scope before editing.
  </Step>
</Steps>

## What to expect

1. **A grounded plan.** The agent uses real social.plus documentation and SDK facts.
2. **Implementation with checks.** Vise checks SDK usage, lifecycle behavior, feature completeness, and the project's own validation commands.
3. **An honest handoff.** The result says what passed, what still needs a decision, whether the intended surface worked at runtime, and who owns the smallest next action.

The contract and evidence live in `sp-vise/` so reviewers and CI can reproduce the result after the conversation ends. See [How Vise works](/ai-mcp/vise/how-it-works) for the complete loop and result states.

<Warning>
  **Preview release.** Vise provides strong guardrails for AI-assisted integration, but it does not replace code review, product QA, security review, or a real launch on your tenant data.
</Warning>

<Info>
  Vise runs locally and does not upload your source code, file contents, or search queries. The hosted [docs MCP server](/ai-mcp/overview) is different: it helps assistants search the documentation, while Vise guides and validates work inside your project.
</Info>

## Choose your next step

<CardGroup cols={2}>
  <Card title="Try Vise in 15 minutes" icon="stopwatch" href="/ai-mcp/vise/evaluate">
    Review a grounded plan without changing code or using credentials.
  </Card>

  <Card title="Choose how to build" icon="route" href="/ai-mcp/vise/choose-integration-path">
    Compare a prebuilt UIKit surface with a custom SDK experience.
  </Card>

  <Card title="Maintain an existing integration" icon="screwdriver-wrench" href="/ai-mcp/vise/brownfield-day2">
    Add a feature, diagnose a problem, or upgrade the SDK safely.
  </Card>

  <Card title="Keep it verified in CI" icon="code-branch" href="/ai-mcp/vise/ci-verification">
    Protect current and previously completed social.plus features.
  </Card>

  <Card title="Review and release" icon="clipboard-check" href="/ai-mcp/vise/release-assurance">
    Prepare a verifiable handoff without confusing readiness with approval.
  </Card>

  <Card title="How Vise works" icon="gears" href="/ai-mcp/vise/how-it-works">
    Understand the loop, evidence, and result states.
  </Card>
</CardGroup>
