Pickup Issue
Complete lifecycle: read issue, branch, implement, verify, PR.
Workflow
1. Read the Issue
gh issue view <NUMBER>
Understand the requirements, acceptance criteria, and any linked issues or discussions.
2. Create a Branch
Derive the branch name from the issue:
git checkout -b feature/issue-<NUMBER>-short-description main
Use fix/ prefix for bug reports, feature/ for enhancements.
3. Implement
Follow the implement skill:
- Make changes following project conventions
- Write/update tests with embedded LISP phylum and testify assertions
- Lint:
golangci-lint run ./... - Test:
make test
4. Verify
Run the verify skill to mirror CI:
golangci-lint run ./... && make citest
5. Commit and Push
git add <changed-files>
git commit -m "Description matching issue intent"
git push -u origin HEAD
6. Create PR Linking the Issue
gh pr create --base main \
--title "Short title describing the change" \
--body "Fixes #<NUMBER>
Description of what was changed and why."
Using Fixes #N in the body auto-closes the issue when the PR merges.
7. Monitor CI
gh pr checks --watch
Key Reminders
- Always read the full issue before starting implementation
- Link the PR to the issue using
Fixes #NorCloses #N - For large changes, comment on the issue with your approach before implementing (per CONTRIBUTING.md)
- Run
make pluginif the substrate binary isn't already present
Checklist
- Issue requirements understood
- Branch created from
main - Implementation follows project conventions
- Tests written/updated
-
verifyskill passes - PR created and linked to issue
- CI checks pass
Converted and distributed by TomeVault — claim your Tome and manage your conversions.