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

1. Verify we're on a feature/bug branch (not main/master)
2. Run the finish workflow:

   dossier run imboard-ai/development/git/finish-issue-workflow
   

3. Respond to prompts for each check category
4. 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