GitHub Agentic Workflows Demo

A Task Tracker API demonstrating GitHub's Agentic Workflows — AI-powered automation written in natural language Markdown that lets GitHub Copilot act as an autonomous agent inside your CI/CD pipeline.

What Are GitHub Agentic Workflows?

GitHub Agentic Workflows allow you to define CI/CD automation in plain Markdown instead of YAML. Copilot reads your natural language instructions and autonomously executes multi-step tasks — triaging issues, reviewing PRs, updating docs, and more — directly within GitHub Actions.

• 📖 Official Documentation
• 📢 Announcement (Technical Preview)

Workflows in This Repo

Workflow	Trigger	What It Does
Issue Triage	New issue opened	AI classifies, labels, and prioritizes issues
PR Reviewer	New pull request	AI reviews code changes and suggests improvements
Docs Updater	PR merged / manual	AI updates API documentation automatically
Weekly Digest	Weekly schedule	AI summarizes repo activity into a digest

🚧 Coming soon — Agentic workflow files will be added as the project evolves.

The API

This repo includes a simple Task Tracker REST API used as the codebase that the agentic workflows operate on.

Endpoints

Method	Route	Description
GET	/api/tasks	List all tasks (optional ?status= filter)
GET	/api/tasks/:id	Get a single task by ID
POST	/api/tasks	Create a new task
PUT	/api/tasks/:id	Update an existing task
DELETE	/api/tasks/:id	Delete a task
GET	/health	Health check

Task Schema

{
  "id": "uuid",
  "title": "string",
  "description": "string",
  "status": "pending | in-progress | done",
  "createdAt": "ISO 8601 timestamp",
  "updatedAt": "ISO 8601 timestamp"
}

Status Filter

Filter tasks by status with the query parameter:

GET /api/tasks?status=pending
GET /api/tasks?status=in-progress
GET /api/tasks?status=done

Getting Started

git clone https://github.com/htekdev/github-agentic-workflows-demo.git
cd github-agentic-workflows-demo
npm install
npm run dev

The API starts on http://localhost:3000 by default. Set the PORT environment variable to change it.

Running Tests

npm test

Tests use Vitest with Supertest for HTTP assertions.

Project Structure

github-agentic-workflows-demo/
├── .github/
│   └── copilot-instructions.md
├── src/
│   ├── app.js                  # Express app setup
│   ├── index.js                # Server entry point
│   ├── middleware/
│   │   └── errorHandler.js     # Global error handler
│   ├── routes/
│   │   └── tasks.js            # Task CRUD routes
│   └── store/
│       └── taskStore.js        # In-memory task store
├── .gitignore
├── .nvmrc
├── CONTRIBUTING.md
├── LICENSE
├── package.json
└── README.md

License

MIT © 2026 Hector Flores

Author

Built by @htekdev — companion repo for the article on htek.dev.