Agent Platform Examples¶

@meta {
  id: "checkout-agent-platform"
  syntax: "1.5.0"
  tags: ["payments", "typescript"]
}

@identity {
  """
  You are working on a payment service.
  Preserve transaction integrity and auditability.
  """
}

@standards {
  code: ["Use strict TypeScript", "Write tests for business rules"]
}

@skills {
  security-review: {
    description: "Review payment changes for security risks"
    allowedTools: ["Read", "Grep", "Bash"]
    content: """
      Inspect authentication, authorization, secrets, and payment data handling.
      Report findings by severity and include concrete remediation steps.
    """
  }
}

@mcpServers {
  issue-tracker: {
    transport: "stdio"
    command: ["node", "./tools/issues.mjs"]
    timeoutMs: 30000
  }
}

@agents {
  reviewer: {
    description: "Review changes before merge"
    tools: ["Read", "Grep", "Glob", "Bash"]
    model: "sonnet"
    skills: ["security-review"]
    mcpServers: ["issue-tracker"]
    content: "Review changed code, tests, and operational impact."
  }
}

@hooks {
  validate-changes: {
    event: "post-tool-use"
    matcher: "Edit|Write"
    command: ["pnpm", "run", "typecheck"]
    timeoutMs: 120000
    statusMessage: "Checking TypeScript"
  }
}

@workflows {
  release: {
    description: "Validate and prepare a release"
    content: """
      1. Review changes since the previous release
      2. Run formatting, linting, type checks, and tests
      3. Summarize changes and prepare release metadata
      4. Stop before publishing and request approval
    """
  }
}

@plugins {
  payment-engineering: {
    description: "Payment engineering capability bundle"
    version: "1.0.0"
    skills: ["security-review"]
    hooks: ["validate-changes"]
    mcpServers: ["issue-tracker"]
  }
}

@meta {
  id: "field-replacement"
  syntax: "1.3.0"
}

@identity {
  """
  You are a TypeScript development assistant.
  """
}

@standards {
  testing: ["Use Jest", "Use integration tests"]
  linting: ["Use ESLint"]
  deployment: {
    platform: "Kubernetes"
    regions: ["us-east-1"]
  }
}

@extend standards {
  testing!: ["Use Vitest", "Follow the AAA pattern"]
  linting: ["Run lint checks before commits"]
  deployment!: {
    platform: "Cloud Run"
    regions: ["us-central1", "europe-west1"]
  }
}

@meta {
  id: "payments-team"
  syntax: "1.5.0"
  tags: ["payments"]
}

@identity {
  """
  You work on the ACME payments platform.
  Preserve transaction integrity and auditability.
  """
}

@standards {
  code: ["Use strict TypeScript", "Write tests for business rules"]
  testing: ["Use Vitest with the AAA pattern", "Cover failure and retry paths"]
}

@restrictions {
  - "Never log PAN, CVV, or raw webhook secrets"
}

@meta {
  id: "payments-api"
  syntax: "1.5.0"
}

@inherit ./team

@context {
  service: "payments-api"
  framework: "Fastify"
  owns: ["authorization", "retries"]
}

@agents {
  api-reviewer: {
    description: "Review payments-api changes before merge"
    tools: ["Read", "Grep", "Glob", "Bash"]
    model: "sonnet"
    content: "Inspect handlers, tests, and migration impact. Reject changes that weaken idempotency."
  }
}

@meta {
  id: "checkout-web"
  syntax: "1.5.0"
}

@inherit ./team

@context {
  service: "checkout-web"
  framework: "React 18"
  owns: ["checkout flow", "payment forms"]
}

@skills {
  payment-forms: {
    description: "Review payment form changes for PCI and a11y risk"
    allowedTools: ["Read", "Grep"]
    content: "Check card-data handling, error states, and keyboard access in checkout forms."
  }
}