# Agents HQ

Agents HQ (http://agents.tractionstudio.ai) is the Laravel control plane for a local-first AI
agent organization setup. Laravel hosts prompts, policy assets, account tokens,
company linking, connector settings, and legacy interview/export surfaces.

## Getting Started

Copy the setup prompt into an LLM with shell access:

  Setup prompt: https://agents.tractionstudio.ai/setup.txt

The local CLI agent runs the setup against the user's filesystem and Paperclip
server. Default Paperclip URL: http://127.0.0.1:3100

Prompt manifest: https://agents.tractionstudio.ai/prompts/manifest.json
Product-spec manifest: https://agents.tractionstudio.ai/product-specs/manifest.json

## Prompt Assets

- Full Local-First Setup
  URL: https://agents.tractionstudio.ai/setup.txt
  Key: setup.index
  Version: 92e2ca7de915
  Purpose: Complete Step 1-4 setup entrypoint for CLI agents.
  Source: docs/superpowers/plans/2026-04-28-laravel-product-spec-refactor-merged-execution-plan.md
- Copy Setup Instruction
  URL: https://agents.tractionstudio.ai/setup/copy-instruction.txt
  Key: setup.copy-instruction
  Version: df7c948d7a3c
  Purpose: Short copy-paste instruction that points CLI agents to llms.txt and setup.txt.
  Source: docs/superpowers/plans/2026-04-28-laravel-product-spec-refactor-merged-execution-plan.md
- Legacy One-Shot Setup
  URL: https://agents.tractionstudio.ai/setup-legacy.txt
  Key: setup.legacy
  Version: aeb213d0ecce
  Purpose: Recoverable legacy setup prompt for the prior interview/provisioning flow.
  Source: laravel/resources/prompts/setup-prompt.md
- Legacy Interview Prompt
  URL: https://agents.tractionstudio.ai/prompt.txt
  Key: interview.legacy
  Version: d0a700f0ec90
  Purpose: Legacy guided interview prompt for the upload/review flow.
  Source: laravel/resources/prompts/interview-prompt.md
- Step 1: System Setup
  URL: https://agents.tractionstudio.ai/setup/step-1.txt
  Key: setup.step-1
  Version: 76c704a4673d
  Purpose: Create local filesystem layout, verify Paperclip/governor, seed policies, and provision Blast Radius Specialist.
  Source: laravel/resources/prompts/_source/STEP-1-SYSTEM-SETUP.md
- Step 2: Artifacts Pipeline
  URL: https://agents.tractionstudio.ai/setup/step-2.txt
  Key: setup.step-2
  Version: c0d02f751adf
  Purpose: Parse, classify, and synthesize artifacts into policies, goals, CEO, and C-level drafts.
  Source: laravel/resources/prompts/_source/STEP-2-ARTIFACTS-PIPELINE.md
- Step 3: First C-Level Activation
  URL: https://agents.tractionstudio.ai/setup/step-3.txt
  Key: setup.step-3
  Version: d529e22f60c7
  Purpose: Run CEO-led bucket routing and activate one C-level agent.
  Source: laravel/resources/prompts/_source/STEP-3-FIRST-CLEVEL.md
- Step 4: Department Buildout
  URL: https://agents.tractionstudio.ai/setup/step-4.txt
  Key: setup.step-4
  Version: b067f8dab864
  Purpose: Approve hires, author AGENTS.md files, register agents, and verify first tasks.
  Source: laravel/resources/prompts/_source/STEP-4-DEPARTMENT-BUILDOUT.md
- Blast Radius Policy
  URL: https://agents.tractionstudio.ai/policies/blast-radius.txt
  Key: policy.blast-radius
  Version: 02316d9d318e
  Purpose: BR1-BR5 classification rules, ceilings, overrides, and escalation contract.
  Source: laravel/resources/prompts/_source/BLAST-RADIUS.md
- Reviewer Policy
  URL: https://agents.tractionstudio.ai/policies/reviewer-policy.txt
  Key: policy.reviewer-policy
  Version: 7ba2e70cf224
  Purpose: Evidence-based review gates, scoring formula, thresholds, no-go, and persistence schema.
  Source: laravel/resources/prompts/_source/REVIEWER-POLICY.md
- Dream Cycle Policy
  URL: https://agents.tractionstudio.ai/policies/dream-cycle.txt
  Key: policy.dream-cycle
  Version: c126afe689e9
  Purpose: Weekly synthesis contract for rollups, patterns, recommendations, and applied changes.
  Source: laravel/resources/prompts/_source/DREAM-CYCLE.md
- Blast Radius Auto-Detection Rules
  URL: https://agents.tractionstudio.ai/downloads/policies/blast-radius-rules.md
  Key: policy.blast-radius-rules
  Version: 53864855b98a
  Purpose: Default tool floor table owned by the Blast Radius Specialist.
  Source: laravel/resources/prompts/_source/BLAST-RADIUS.md
- Blast Radius Auto-Detection Rules JSON
  URL: https://agents.tractionstudio.ai/downloads/policies/blast-radius-rules.json
  Key: policy.blast-radius-rules-json
  Version: 78cc644e7b8c
  Purpose: Machine-readable tool floor table for blast-radius enforcement.
  Source: laravel/resources/prompts/_source/BLAST-RADIUS.md
- Blast Radius Overrides Template
  URL: https://agents.tractionstudio.ai/downloads/policies/blast-radius-overrides.md
  Key: policy.blast-radius-overrides
  Version: 5fb33a522bb3
  Purpose: Empty user override template for BR rule exceptions.
  Source: laravel/resources/prompts/_source/BLAST-RADIUS.md
- Blast Radius Overrides JSON
  URL: https://agents.tractionstudio.ai/downloads/policies/blast-radius-overrides.json
  Key: policy.blast-radius-overrides-json
  Version: 7f9b96813638
  Purpose: Machine-readable override template for tool floors, agent ceiling raises, and threshold overrides.
  Source: laravel/resources/prompts/_source/BLAST-RADIUS.md
- Blast Radius Task Metadata Schema
  URL: https://agents.tractionstudio.ai/downloads/policies/blast-radius-task-schema.md
  Key: policy.blast-radius-task-schema
  Version: a704fc9c54bc
  Purpose: Task metadata schema for declared/effective blast radius, overrides, reviewer raises, decisions, and tool gates.
  Source: laravel/resources/prompts/_source/BLAST-RADIUS.md
- Company Policy Template
  URL: https://agents.tractionstudio.ai/downloads/policies/company-policy.md
  Key: template.company-policy
  Version: 286bd82577e1
  Purpose: Company-wide standards stub seeded during Step 1.
  Source: laravel/resources/prompts/_source/STEP-1-SYSTEM-SETUP.md
- Bucket Policy Template
  URL: https://agents.tractionstudio.ai/downloads/policies/bucket-policy.md
  Key: template.bucket-policy
  Version: f853e767ba9e
  Purpose: Reusable six-bucket policy stub.
  Source: laravel/resources/prompts/_source/STEP-2-ARTIFACTS-PIPELINE.md
- Bucket Goals Template
  URL: https://agents.tractionstudio.ai/downloads/policies/bucket-goals.md
  Key: template.bucket-goals
  Version: 7728c0c79d17
  Purpose: Reusable six-bucket goals stub with evidence and gap sections.
  Source: laravel/resources/prompts/_source/STEP-2-ARTIFACTS-PIPELINE.md
- CEO AGENTS.md Template
  URL: https://agents.tractionstudio.ai/downloads/policies/ceo-agents.md
  Key: template.ceo-agents
  Version: 10390819f228
  Purpose: CEO agent template for Step 2 grounding.
  Source: laravel/resources/prompts/_source/STEP-2-ARTIFACTS-PIPELINE.md
- C-Level AGENTS.md Template
  URL: https://agents.tractionstudio.ai/downloads/policies/c-level-agents.md
  Key: template.c-level-agents
  Version: 9b730447bd9f
  Purpose: C-level template for Step 3 activation.
  Source: laravel/resources/prompts/_source/STEP-3-FIRST-CLEVEL.md
- AGENTS.md Template
  URL: https://agents.tractionstudio.ai/downloads/policies/agents-md-template.md
  Key: template.agents-md
  Version: 459074719590
  Purpose: Canonical Identity, Context, Standards, Workflow, and Handoff template.
  Source: laravel/resources/prompts/_source/STEP-4-DEPARTMENT-BUILDOUT.md
- Hired Agent AGENTS.md Template
  URL: https://agents.tractionstudio.ai/downloads/policies/hire-agents.md
  Key: template.hire-agents
  Version: a46a3558a65d
  Purpose: Step 4 hired-agent template for approved specialists and managers.
  Source: laravel/resources/prompts/_source/STEP-4-DEPARTMENT-BUILDOUT.md
- Blast Radius Specialist AGENTS.md
  URL: https://agents.tractionstudio.ai/downloads/policies/blast-radius-specialist-agents-md.md
  Key: template.blast-radius-specialist
  Version: 9f6a192c90d7
  Purpose: Pre-written AGENTS.md for `specialist-of-blast-radius`.
  Source: laravel/resources/prompts/_source/BLAST-RADIUS.md
- Dream Cycle Weekly Template
  URL: https://agents.tractionstudio.ai/downloads/policies/dream-cycle-weekly.md
  Key: template.dream-cycle-weekly
  Version: 05adab8587a5
  Purpose: Weekly Dream Cycle synthesis report template.
  Source: laravel/resources/prompts/_source/DREAM-CYCLE.md
- Reviewer Score Helper
  URL: https://agents.tractionstudio.ai/downloads/policies/review-score-helper.py
  Key: helper.review-score
  Version: be266b411d3f
  Purpose: Deterministic helper for Reviewer Policy evidence scoring.
  Source: laravel/resources/prompts/_source/REVIEWER-POLICY.md

## REST API

Base URL: http://agents.tractionstudio.ai/api
Production API: https://agents.tractionstudio.ai/api
Auth: Authorization: Bearer <token>
Token: Create at http://agents.tractionstudio.ai/profile (API Tokens section)

### Endpoints

GET  /api/interviews                        - list all interviews with status
GET  /api/blueprint                         - compiled company blueprint
GET  /api/phases/{phase}                    - raw phase data
GET  /api/agent-hierarchy                   - directors and specialist agents
POST /api/v1/companies/from-paperclip       - link local Paperclip company to Laravel

## Downloads

Agents HQ skill: https://agents.tractionstudio.ai/downloads/agents-hq.skill
Connector plugin worker: https://agents.tractionstudio.ai/downloads/paperclip-connector-plugin

## Runtime Boundary

Laravel hosts prompts and configuration. The CLI creates local files under
`~/Agents/{company-prefix}/`. Paperclip owns runtime agents, goals, projects,
tasks, queues, and execution.