# Introduction

LogiKFlow shows a GitHub pull request with its changed files in a reading order chosen by the author, instead of alphabetically. Files are grouped into sections, explained with notes, and paired with checklists that tell reviewers what to verify.

## Why

GitHub lists changed files by path. A reviewer opening a pull request usually meets the layout files and resources first, then the UI, and only at the end the model or feature flag everything else depends on. They end up reading the change backwards, or jumping around to rebuild the author's mental model.

The author already knows the right order. LogiKFlow lets them write it down once, or ask a coding agent to do it, so every reviewer reads the change the way it was built.

## What you get

- **A reading order.** Files appear in the order they should be read, usually in dependency order: contracts and flags first, then models, logic, storage, UI and resources.
- **Sections and notes.** Related files are grouped under a title, with a short note on what changed and why.
- **Review checklists.** Specific things to verify, such as "With the flag off, the list is unchanged". Each reviewer ticks their own, and everyone sees who checked what.
- **Viewed tracking.** Mark files as viewed. It's saved to your account, so it follows you across devices, and it resets for a file when that file changes.
- **History.** Every saved order is a version you can restore.
- **AI agents.** Connect Claude Code, Cursor or another MCP client and say "Arrange PR #123 in LogiKFlow". The agent reads the change, builds the order and gives you the link.

## How it fits your workflow

1. Finish the change and open the pull request on GitHub as usual.
2. Arrange it in LogiKFlow, either by hand in the web app or by asking your agent.
3. Share the LogiKFlow link with reviewers, or post it to the pull request with one click.
4. Reviewers follow the order, tick Viewed and checklist items, and leave their comments on GitHub as usual.

LogiKFlow doesn't replace GitHub reviews. Approvals, comments and merging stay on GitHub. LogiKFlow changes the order and adds context.

## Next steps

- [Quickstart](/docs/quickstart): sign in and arrange your first pull request.
- [Arrange with AI agents](/docs/agents): connect your coding agent.
- [Ordering guide](/docs/ordering-guide): the rules for a good reading order.