Promptless for Agent Instructions

Promptless Instruction Governance (PIG) helps teams maintain the instructions their AI agents use. Keep shared skills, rules, commands, and tool configuration in a versioned Instruction Hub. Publish them as plugins, then use evidence from real sessions to improve them.

You can start with instruction publishing on its own. When you are ready to learn from agent sessions, deploy the trace analyzer in your infrastructure and enroll the hosts that should send it traces.

Instruction HubPublish shared instructions

Published pluginsthen

AI agentUse instructions in real work

Session tracesthen

Trace analyzerFind instruction problems

Findingsthen

Promptless DashboardReview evidence and improvements

Reviewed instruction updates → Instruction Hub

Publish instructions on their own, or add trace analysis to learn from sessions. Review proposed improvements and publish accepted changes back through your hub.

See How it works for the full architecture, ownership boundaries, and data flow.

What you can do with PIG

• Give instructions a shared home. Replace scattered copies with reviewed source files, clear ownership, and a release history.
• Distribute them to different agents. The pig toolchain builds agent-specific plugins from the same hub. Authors maintain the source; each agent receives a supported format.
• Find failures from real work. The trace analyzer examines sessions for missing, stale, conflicting, or ineffective instructions and records findings with supporting evidence.
• Review improvements before they reach your team. Findings can lead to proposed changes in your hub. Your team reviews pull requests and publishes accepted changes through its usual Git workflow.

For example, Acme’s writers and developers share a review-docs skill. A finding shows that an older skill release omits prerequisite checks, leading agents to approve guides with missing setup steps. A reviewer checks the cited session evidence, merges a correction, and publishes a new release for the team to install.

Choose how much to set up

Hub guides are written for technical writers and developers. Deployment guides cover the Kubernetes, identity, storage, and operational decisions that DevOps and GitOps teams manage. You do not need to understand the deployment details to begin authoring instructions.

To hand setup to Claude Code, Codex, or another coding agent, start with Set up PIG with a coding agent. It has a prompt for the whole setup, and each setup guide has a prompt for its own phase.

Publish instructions first

An Instruction Hub needs a Git repository, the pig toolchain, a publishing pipeline, and an agent that can install the output. It does not need a trace analyzer, database, bucket, or model-provider account. New hubs have managed trace ingestion disabled by default.

Use this path to establish your source of truth, test the authoring workflow, and get useful instructions into your team’s agents. Create a hub or migrate existing instructions.

Add evidence from sessions

For trace analysis, deploy the analyzer and connect PostgreSQL and your cloud’s object storage. Configure a model provider and your hub repository, then enable host enrollment. Raw traces stay in your storage. The configured model provider receives analysis input, and Promptless receives trace metadata and findings that can include session-derived detail.

The trace analyzer updates automatically to stable releases by default. You can pause updates or pin a release. See Manage updates and recovery.

Read the trust and data model with your deployment team before enabling collection.

Find your path

Author and publish instructions

Author, publish, and install shared instructions without deploying a trace analyzer.

How it worksSee the components, dependencies, and data flow, from publishing an instruction to learning from a session.

Key conceptsLook up hubs, assets, plugins, marketplaces, hosts, traces, findings, and releases.

Set up your Instruction HubCreate shared instructions and validate a first release your team can install.

Migrate existing instructionsConsolidate scattered skills and configuration into one reviewed hub.

Publish and install pluginsBuild a release to publish, or install a published plugin in your agent.

Set up PIG with a coding agentHand the setup to your coding agent, from the hub and plugins to optional trace analysis.

Supported agentsCompare instruction distribution and native trace collection support.

Deploy trace analysis

Deploy the analyzer, enroll hosts, and act on the findings it produces.

Trust and data modelSee which systems receive your data and which credentials connect them.

Plan your deploymentPlan the infrastructure and access that trace analysis needs.

Install the trace analyzerSet up trace analysis in your cluster with automatic updates, then verify your first session.

Enroll your hostsEnable optional trace collection and authorize a Claude or Codex host.

Understand findingsEvaluate and triage evidence-backed instruction problems.

Remediate findingsReview a proposed instruction change and publish it through your Git workflow.