Complete Example Agent Manifests for All Runtime Types

Complete Example Manifests

Objective

Provide comprehensive, production-ready example agent manifests for every supported runtime type and common use cases.

Current Gap

• Only 2-3 basic examples exist
• Missing examples for: serverless, edge runtimes
• No complex multi-capability examples
• No examples showing integrations (MCP, ACAP, etc.)

Required Examples

By Runtime Type

• Docker Runtime: Simple containerized agent
• Kubernetes: Full deployment with resources, health checks
• Serverless: Lambda/Cloud Function agent
• Edge: IoT/edge computing agent
• Local: Development/testing agent

By Use Case

• Compliance Agent: FedRAMP scanner with policies
• Chat Agent: Conversational AI with context
• Workflow Orchestrator: Multi-step automation
• Data Processing: ETL/transformation agent
• Integration Agent: API gateway/proxy pattern

Advanced Patterns

• Multi-capability agent (3+ capabilities)
• Agent with MCP integration
• Agent with ACAP protocol support
• Kubernetes CRD-based deployment
• Agent with observability (metrics, traces)

Acceptance Criteria

• All examples validate against ossa-1.0.schema.json
• Each example includes inline comments explaining choices
• README in examples/ explaining organization
• Examples demonstrate best practices
• CI validates all examples on every commit

File Structure

``` spec/examples/ ├── by-runtime/ │ ├── docker-basic.yaml │ ├── kubernetes-prod.yaml │ ├── serverless-lambda.yaml │ └── edge-iot.yaml ├── by-use-case/ │ ├── compliance-fedramp.yaml │ ├── chat-conversational.yaml │ └── workflow-orchestrator.yaml └── advanced/ ├── multi-capability.yaml ├── mcp-integration.yaml └── observability.yaml ```

Labels

`documentation`, `examples`, `specification`

Milestone

v0.2.x - Specification Stability