Open Source Data

Concursus Open Data Format

The Concursus data format is the human-readable backbone for managing epics, issues, and bugs. We are open sourcing it to help create more innovative AI agent native platforms and solutions.

View on GitHub → Back to overview

Data Structure

Files you can read, diff, and automate.

Every work item is a single YAML file with explicit workflow state, dependencies, and timestamps. Agents can pick up tasks without brittle context, and teams can version control everything.

Issues

Atomic units of work with progress, acceptance criteria, and agent context.

Epics

Parent structures that group issues and track larger initiatives.

Bugs

Defect records with reproduction steps, severity, and resolution flow.

Simplified schema

issue:
  id: CW-005
  title: Open source data format
  workflow:
    status: in-progress
    current_progress: "Drafting page..."
  relationships:
    epic_id: EPIC-001
    blocked_by: []
  timestamps:
    created_at: 2026-01-17T08:54:05Z
    updated_at: 2026-01-17T09:05:22Z

The full schema includes acceptance criteria, attachments, and AI agent support fields.

Why open source

Open by default so the ecosystem can build together.

We are open sourcing the Concursus data format to help create more innovative AI agent native platforms and solutions. Use it as a foundation for your own interfaces, automation, and workflows.

Portable files that work in Git, cloud drives, and local-first tools.
Clear workflow state so agents can report progress in real time.
Explicit relationships between epics, issues, and bugs.

Build with the format

Start with the schema, customize your UI, and let agents operate on clean data.

Explore repository →