| schema_version | 1.0.0 |
| name | finish-issue |
| title | Finish Issue Workflow |
| version | 1.0.0 |
| status | stable |
| objective | Prepare a GitHub issue branch for PR with quality checks, cleanup, and review recommendations |
| description | Prepare a GitHub issue branch for PR with quality checks, cleanup, and review recommendations. Use when user says "finish issue", "ready for PR", "prepare for review", "submit PR", "create PR", "finalize issue", or "wrap up". |
| authors | [object Object] |
| checksum | [object Object] |
Finish Issue Workflow
When the user wants to finalize their work on a GitHub issue and prepare a PR:
Prerequisites
- dossier-tools installed (
pip install dossier-tools) - On a feature/bug branch (not main/master)
- GitHub CLI (
gh) authenticated
Steps
- Verify we're on a feature/bug branch (not main/master)
- Run the finish workflow:
dossier run imboard-ai/development/git/finish-issue-workflow - Respond to prompts for each check category
- Confirm successful PR creation with the user
What This Does
- Git prep: Fetch latest, rebase onto main, check for conflicts
- Security scans: Detect secrets, hardcoded paths, files that should be gitignored
- Code cleanup: Find debug statements, commented code, unresolved TODOs
- Project checks: Run linter, formatter, type checker, tests
- Review recommendations: Suggest reviewers based on changed files (security, DB, ops, etc.)
- PR creation: Generate description from PLANNING.md + commits, link to issue, push and create PR