tomevault-io Executing Development Issues
Purpose
Complete workflow: branch → code → tests → PR → merge. Works for GitHub and local issues (ISSUES.LOCAL/).
Core principle: One issue at a time, full lifecycle before next.
Uses
Standard Interface: aug-just/justfile-interface (Level 0+1)
just test-watch # Continuous testing
just check-all # Quality gate before merge
Quick Reference
# 1. Get issue
gh issue view [NUMBER] # GitHub
cat ISSUES.LOCAL/LOCAL###-Title.md # Local
# 2. Branch (if not in worktree)
git checkout -b [ISSUE_ID]-description
# 3. Implement with TDD
just test-watch
# 4. Quality gate
just check-all
# 5. PR (GitHub only)
gh pr create --draft
gh pr ready
# 6. Merge
gh pr merge --squash --delete-branch # GitHub
git merge --squash BRANCH # Local
Worktree vs Main
Check:
git rev-parse --git-dir # .git = main, worktrees/name = worktree
In worktree: Already on feature branch, work normally
Not in worktree: git checkout -b [ISSUE_ID]-description
Branch Naming
- GitHub:
42-add-user-auth - Local:
LOCAL001-fix-parser
Implementation
1. Read acceptance criteria
- Understand "done"
- Note all requirements
- Identify edge cases
2. TDD cycle
- Write test
- Implement
- Refactor while green
- Commit frequently
3. Commit messages
git commit -m "feat: specific change
Refs #42"
4. Draft PR early (GitHub)
gh pr create --draft --title "feat: description" --body "Closes #42"
Definition of Done
- ✅ All acceptance criteria met
- ✅ Tests written and passing
- ✅ Coverage >= 96%
- ✅
just check-allpasses - ✅ Documentation updated
- ✅ Self-review completed (self-reviewing-code skill)
- ✅ Merged to main
- ✅ Issue closed
Merging
GitHub:
gh pr ready
gh pr merge --squash --delete-branch
Local:
sed -i '' 's/^status: ready$/status: closed/' ISSUES.LOCAL/LOCAL###-Title.md
git checkout main
git merge --squash BRANCH
git commit -m "feat: description
Closes LOCAL###"
git branch -d BRANCH
Converted and distributed by TomeVault — claim your Tome and manage your conversions.