Skip to content

Add logIssue skill; migrate tech debt to GitHub Issues; add license - #23

Merged
davecoulter merged 1 commit into
mainfrom
feature/log-issue-skill
Jul 21, 2026
Merged

davecoulter merged 1 commit into
mainfrom
feature/log-issue-skill

Conversation

@davecoulter

Copy link
Copy Markdown
Owner

Summary

  • Added the logIssue skill (.claude/skills/log_issue.md) — files GitHub Issues directly via gh issue create, no branch/commit/PR required. For backlog items with no in-flight code change, as opposed to debt discovered mid-implementation on an active branch.
  • Migrated every open docs/tech_debt.md item to GitHub Issues (Remove setuptools<81 pin once OTel drops pkg_resources #18–Publish multi-arch (linux/amd64 + linux/arm64) images #22, labeled tech-debt) and deleted the file. Updated CLAUDE.md's Technical Debt reference and docs/conf.py's exclude_patterns to match — GitHub Issues is now the sole tech-debt tracking mechanism.
  • Added LICENSE (BSD-3-Clause) and a matching CITATION.cff (with ORCID), plus a License section in the README — now that the repo is tagged as a forkable base, it needs both.
  • Fixed a test-isolation bug found during QA: test_sysadmin_seeding_links_step_definition_to_user's cleanup deleted StepDefinition and User rows but never accounted for JobConfiguration rows referencing that user, causing an intermittent FK violation (fk_job_configurations_user_id) if any such row existed at cleanup time.

CLI Verification

  • Branch confirmed: feature/log-issue-skill
  • CITATION.cff validated as well-formed YAML
  • Sphinx build passed (local, -W, zero warnings), including after tech_debt.md's deletion and the exclude_patterns cleanup
  • gh issue list --label tech-debt — confirmed all 5 issues (Remove setuptools<81 pin once OTel drops pkg_resources #18–Publish multi-arch (linux/amd64 + linux/arm64) images #22) filed and correctly labeled
  • Full test suite passed (in-container): docker compose exec api uv run pytest --cov=src --cov-fail-under=90 -q — 115 passed, 1 skipped, 98.25% coverage, after fixing the test-isolation bug found mid-run
  • N/A migrations — no model changes
  • N/A docs/diagrams/infrastructure_topology.md — no service topology or data-flow changes

Application QA

  • logIssue exercised live, not just written — used to file all 5 tech-debt issues, confirmed correct titles, bodies, and labels on GitHub
  • Read the Docs site (diffpype-claude.readthedocs.io) confirmed live and current via direct fetch, ready to link from the repo's "About" section

🤖 Generated with Claude Code

Moves tech-debt tracking from a markdown file requiring a full
branch+PR cycle to GitHub Issues, filed via a new logIssue skill.
Also adds licensing/citation metadata now that the repo is tagged
as a forkable base, and fixes a test-isolation bug found during QA.
@github-actions

Copy link
Copy Markdown

Test Results

117 tests  ±0   117 ✅ ±0   4s ⏱️ -3s
  1 suites ±0     0 💤 ±0 
  1 files   ±0     0 ❌ ±0 

Results for commit fb33329. ± Comparison against base commit 7194a34.

@davecoulter
davecoulter merged commit eb2963b into main Jul 21, 2026
3 checks passed
@davecoulter
davecoulter deleted the feature/log-issue-skill branch July 21, 2026 02:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant