Skip to content

About

A repeatable, high-discipline workflow pattern for Cursor agents: fetches issues, branches, implements, adds tests, runs human confirmation gates, commits, PRs, and notifies chat.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Ticket Flow

A repeatable, high-discipline workflow for Cursor (and similar IDE agents): fetch issue → branch → implement → tests → Confirm → commit → Confirm → PR → ask before chat.

Live site: https://smg99.github.io/ticket-flow/
Companion SDLC method: AI-Assisted SDLC Playbook — stage prompts from vague requirements through release. This repo sequences how an IDE agent runs once a real ticket exists (Develop one story).

Overview

Ticket Flow is a thin orchestration layer, not a product.

User phrase  →  rule loads skill  →  scripts + product repos  →  Confirm  →  commit/PR  →  ask before chat

Why use a structured workflow?

Ad-hoc chat ("plan then build ticket X") often burns retries: wrong branch, forgotten tests, premature commit, or Slack spam. A Ticket Flow skill front-loads the path once.

Ad-Hoc Agent Chat vs. Ticket Flow Cost

Ad-hoc agent chat vs ticket-flow cost

Day-to-Day Agent Shape with Checklist

Ticket flow agent — easy path


Directory Structure

ticket-flow/
├── index.html                  # Public GitHub Pages site
├── AGENTS.md                   # Agent entrypoint (gates, scripts, skills)
├── skills/ticket-flow/SKILL.md # Canonical portable skill
├── assets/                     # Site CSS, JS, OG image
├── README.md
├── LICENSE                     # MIT
├── .cursor/
│   ├── skills/ticket-flow/SKILL.md  # Symlink/copy → skills/
│   └── rules/
│       ├── ticket-flow.mdc
│       └── ticket-handoff.mdc
├── docs/
│   ├── ticket-flow-agent-guide.md
│   ├── progress-template.md
│   ├── execution-evidence.md
│   ├── CONTRIBUTING.md
│   └── assets/
├── scripts/                    # Thin CLI wrappers (fail loud until configured)
└── tests/run.sh                # Wrapper regression tests (no credentials)

Quick Start

  1. Visit the live guide (or open index.html locally).
  2. Copy skills/ticket-flow/, .cursor/rules/*.mdc, and the Cursor skill adapter (.cursor/skills/) into your product repo (or multi-root this repo). See AGENTS.md.
  3. Configure scripts/ for your issue tracker and chat — unconfigured scripts error; they do not invent data.
  4. Copy docs/progress-template.md → .local/progress.md (gitignored). After PR open, status is awaiting_review—not done.
  5. In chat: work on ticket PROJ-123.
  6. Optional: ./tests/run.sh to verify wrapper failure paths locally.

Discoverability

Hosting

GitHub Pages publishes the repository root from main. .nojekyll disables Jekyll processing. No build step, framework, or backend.

License

MIT

About

A repeatable, high-discipline workflow pattern for Cursor agents: fetches issues, branches, implements, adds tests, runs human confirmation gates, commits, PRs, and notifies chat.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages