# AGENTS.md ## Project Structure - `src/main.rs` - All application logic (init, add, ls, show, mv commands) - `src/command.rs` - CLI argument definitions using clap derive - `tests/` - Integration tests using `assert_cmd` and `assert_fs` - Ticket files stored as `.md` in `.worklane//` directories ## Commands | Command | Description | |---------|-------------| | `worklane init` | Creates `.worklane/` with backlog, committed, reviewing, done directories | | `worklane add` | Creates a ticket in backlog with `--title`, `--description`, `--acceptance`, `--plan`, `--tags`, `--due`, `--owner` flags | | `worklane ls` | Lists tickets, optionally filtered by `--status` | | `worklane show ` | Shows ticket by UUID prefix or title | | `worklane mv --status [-f]` | Moves ticket between statuses. Default: forward only, one stage at a time. `-f` bypasses both restrictions | ## Ticket File Format Filenames: `_.md` Metadata fields parsed: `ID`, `Tags`, `Due`, `Owner`, `Created At`, `Status` ## Status Workflow `backlog` -> `committed` -> `reviewing` -> `done` ## Testing Run: `cargo test` Tests create temporary `.worklane` directories with all four status folders pre-created via `setup_worklane()`. Ticket helper `create_ticket()` writes fully-formed markdown files directly. ## Key Implementation Notes - No database or index - tickets resolved by scanning all status directories - `resolve_ticket()` matches by UUID prefix (8+ chars), title substring, or filename substring - Ambiguous searches (multiple matches) exit with list of options - Ticket metadata uses `**Field**:` format for parsing - Color output uses ANSI escape codes in `content_trim_colored()` ## Agent workflow - When working on a ticket use `worklane show [ticketID]` to read the ticket. - If the ticket is in the backlog, move it to committed using `worklane mv --status committed [ticketID]`. - When your changes meet the acceptance criteria and the code compiles, move the ticket to reviewing using `worklane mv --status reviewing [ticketID]` - If you need more information on how to use `worklane`, use the worklane kanban skill