backlog

Manage user stories as structured JSON with role-based access control.

Updated Feb 7, 2026
One-click install
npx skills add https://github.com/VitorAndTxr/omni-sw --skill backlog-vitorandtxr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: backlog
Source: https://github.com/VitorAndTxr/omni-sw/tree/main/skills/backlog
Command: npx skills add https://github.com/VitorAndTxr/omni-sw --skill backlog-vitorandtxr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Backlog management system — Manages user stories as structured JSON with role-based access control, replacing markdown-based BACKLOG.md. Provides CRUD operations for user stories, status tracking, acceptance criteria, dependency maps, and auto-generated markdown summaries. Enforces agency permissions: only po/pm create stories, only po/pm/tl edit descriptions, all agents can change status. Supports migration from legacy markdown BACKLOG.md via review teams. Use when: (1) any agent needs to create, (2) agent mentions backlog, user story, US-, acceptance criteria, story status, (3) po/pm is producing backlog in Plan phase, (4) any agent needs to query stories by status/feature/priority, (5) generating BACKLOG.md summary from JSON data, (6) migrating an old docs/BACKLOG.md to the new JSON format.

Core Features & Use Cases

  • Structured JSON-based backlog living under agent_docs/backlog/ with backlog.json as the source of truth and BACKLOG.md auto-generated via render.
  • CRUD operations for user stories, status transitions, acceptance criteria, and dependency tracking.
  • Permission model and migration support from legacy docs to the JSON backlog.

Quick Start

Create your backlog using backlog.json and start mutating stories with backlog_manager.py.

Frequently Asked Questions about backlog

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a markdown BACKLOG.md to structured JSON user stories?

You can migrate legacy markdown BACKLOG.md to structured JSON using the system's built-in migration path via review teams. This converts flat markdown into structured JSON user stories with status tracking and dependencies.

What role-based permissions apply when editing user stories in a backlog?

Backlog user story permissions enforce that only po/pm roles create stories, po/pm/tl edit descriptions, and all agents update status. This role-based access control maintains structured backlog integrity.

Can I auto-generate a markdown summary from JSON-backed user stories?

Yes, the system auto-generates a markdown BACKLOG.md summary from the JSON-backed user stories. It uses backlog.json as the source of truth and renders a readable markdown view of the structured data.

Does the backlog system support dependency tracking and status transitions for agile user stories?

The backlog system supports dependency tracking and status transitions for agile user stories. It provides full CRUD operations across planning, implementation, and testing phases, mapping dependencies and tracking statuses within the JSON schema.

Why use JSON instead of markdown for managing agile user stories?

Using JSON instead of markdown for agile user stories enables structured data schemas, dependency maps, and role-based permissions. This replaces flat markdown files with a queryable source of truth for status tracking and audits.