Persona Guides

PermaShip fits into many workflows. These guides show how to get the most out of the platform based on your role.

Vibe Coder (Claude Code User)

Use Claude Code to architect and prototype locally, then delegate the heavy lifting to PermaShip for implementation, testing, and deployment.

Workflow

1

Architect locally — design the solution with Claude Code in your terminal.

2

Delegate via API ticket — send the implementation task to PermaShip through the API.

3

Review PR when done — PermaShip opens a pull request once the work is complete.

Setup

export PERMASHIP_API_KEY="cc_..."

Then tell Claude Code:

"You have access to the PermaShip API at https://control.permaship.ai/api. My Org ID is [UUID] and Project ID is [UUID]. Use my PERMASHIP_API_KEY to create tickets when I ask."

Why it works: parallelism across repos, isolated verification environments, and full context preservation between sessions.

Product Manager

Use PermaShip as an autonomous engineering department. Go from idea to pull request without writing code.

Workflow

1

High-level intent — describe what you want in the chat or ticket form.

2

Strategy Session — UX, QA, and CISO agents collaborate to plan the implementation.

3

Steer & approve — review the plan, provide feedback, and approve when ready.

4

Review results — visual diffs, acceptance checklists, and PR links delivered to you.

Tips:

  • Use Preview Triage to get a complexity estimate before committing
  • Enable !autonomous on for small, low-risk changes
  • Upload detailed specs to the Knowledge Base for richer context

SRE & Ops Engineer

The SRE Agent monitors your infrastructure (ECS, RDS, ALB) and logs, correlating signals to surface actionable insights.

Deep Investigation

The SRE agent can correlate logs and metrics, inspect source code, and analyze traffic patterns to identify root causes.

/investigate "The checkout service is returning 500s. Check the logs for 'ECONNREFUSED' and see if the Redis connection string is correct in the task definition."

Capabilities:

  • Infrastructure self-healing — detect and remediate common failures automatically
  • Automated patching — apply security and dependency patches across services
  • Drift detection — identify configuration drift between environments

Security Auditor (CISO)

The CISO Agent provides continuous security, not just periodic checkpoints.

Continuous Hardening

Scans for hardcoded secrets, insecure patterns (SQL injection, CSRF), and vulnerable dependencies. When issues are found, it proposes fix tickets automatically.

Security Blocks

Monitors active tickets and blocks high-risk plans — for example, a public endpoint without authentication. The agent explains the risk, suggests alternatives, and requires a human override to proceed.

Targeted Audits

/investigate "Review the src/auth directory for any improper use of JWT signing keys..."

Enterprise Architect

Governance tools for multi-team, multi-repo organizations.

Capabilities:

  • Project Rules — enforce coding standards and conventions across all teams
  • Approval Policies — require human sign-off for sensitive changes
  • Knowledge Base — centralize architecture decisions and API references
  • Audit Logs — full traceability of who changed what, when
  • Centralized secrets — encrypted vault with secrets injected at runtime without logging

Open Source Maintainer

A 24/7 triager and automated contributor for your open source projects.

QA-first bug triage

Analyzes incoming bug reports, writes reproduction tests, confirms bugs, and labels issues — all before a human needs to look at them.

"Good First Issue" drafts

Automatically generates draft fix PRs for issues labeled "good first issue", lowering the barrier for new contributors.

Idle discovery

Scans for technical debt, outdated dependencies, and missing documentation during quiet periods.

Public visibility

Use !public #channel to give your community a transparent view into what PermaShip is working on.