Skip to content

chore: reconcile setup + migrate local issues to GitHub#119

Merged
orioltf merged 7 commits into
developfrom
feature/chore/setup-fixes
May 22, 2026
Merged

chore: reconcile setup + migrate local issues to GitHub#119
orioltf merged 7 commits into
developfrom
feature/chore/setup-fixes

Conversation

@orioltf
Copy link
Copy Markdown
Member

@orioltf orioltf commented May 22, 2026

Summary

  • Reconcile AGENTS.md issue-tracker line (now GitHub Issues, ADO planned) and rename the duplicate ## Agent skills heading to ## Skill summary so it no longer collides with the unic-archon-dlc-managed block.
  • Seed the 8 triage labels (needs-triage → closed/rejected) plus 3 category labels (feature, refactor, release) and 11 feature/<slug> labels on GitHub. Removed the default wontfix (the 8-state vocabulary uses rejected).
  • Migrate 69 local NN-*.md issue files under docs/issues/<slug>/ to GitHub Issues [pr-review-rereview] Normalize bot signature #49–[pr-review-agents-not-discovered] 01-rename-agents-dir-and-fix-frontmatter #117 in oldest-file-first order, preserving content, rewriting the blocked-by graph to #<num> references, and recording each issue's PR history under **Touched by PRs:** ….
  • Close 52 of the new issues whose source **Status:** was closed/resolved/rejected; the remaining 17 stay open with their original state (ready-for-agent, needs-triage).
  • Delete the source NN-*.md files and the three folders that contained only one file with no PRD. PRDs stay as planning artifacts.

Why

The repo had two issue stores: GitHub Issues (per docs/agents/issue-tracker.md) and local markdown (per .claude/skills/implement-feature/). Matt Pocock's skills + the bridge toward unic-archon-dlc need GitHub to be authoritative for state. This PR consolidates on GitHub and cleans up the duplication. A future migration to Azure DevOps will follow the same pattern.

Tooling included

  • scripts/migrate-local-issues.mjs — plan mode regenerates docs/migration-plan.md; execute mode does the labels/issues/backfill/close/delete dance. Resumable via docs/migration-state.json.
  • docs/migration-state.json — audit trail (source path → GitHub issue #). Safe to delete after verification.

Test plan

  • Spot-check ~5 migrated issues for body fidelity, label correctness, and the new **Touched by PRs:** footer:
  • Confirm closed/resolved/rejected issues are CLOSED on GitHub; ready-for-agent/needs-triage issues are OPEN.
  • Confirm docs/issues/<slug>/ contains only PRD.md files (no NN-*.md) and the 3 single-file folders are gone.
  • Confirm GitHub label set includes all 8 triage labels + enhancement, bug, documentation, feature, refactor, release + feature/<slug> × 11, and that wontfix is gone.
  • After verification, delete docs/migration-state.json (and optionally scripts/migrate-local-issues.mjs + docs/migration-plan.md, since this is a one-shot).

🤖 Generated with Claude Code

orioltf and others added 4 commits May 22, 2026 13:19
@orioltf @claude
docs: reconcile issue tracker reference and dedupe agent skills heading
38b6a27 
Aligns the AGENTS.md summary with the actual issue tracker (GitHub Issues,
with planned Azure DevOps migration) and renames the narrative skills block
to "Skill summary" so it no longer collides with the unic-archon-dlc-managed
"## Agent skills" link block.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@orioltf @claude
chore: add migration script and plan for docs/issues → GitHub Issues
c559550 
Adds `scripts/migrate-local-issues.mjs` (plan + execute modes) and the
generated `docs/migration-plan.md` so the one-shot migration of 69 local
issue files is reviewable and replayable. Execute mode persists progress
to `docs/migration-state.json` so a crash mid-run can be resumed.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@orioltf @claude
chore: migrate 69 local issues to GitHub (#49–#117) and remove sources
63f5020 
Runs the one-shot migration: creates issues in oldest-file-first order
with [slug] title prefix, state + category + feature/<slug> labels,
backfills blocked-by refs to GitHub issue numbers, closes 52 issues whose
status was closed/resolved/rejected, and removes the original NN-*.md
files. PRDs and the now-empty single-file folders are kept/cleaned.

`docs/migration-state.json` is the audit trail (source path → issue #);
delete it once verified.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@orioltf @claude
chore: refresh migration plan with PR-touch metadata and tidied forma…
73e62f2 
…tting

Re-emits docs/migration-plan.md from the final script (after the PR-link
helpers were added), so the committed plan matches what execute consumed.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@orioltf orioltf requested a review from Copilot May 22, 2026 14:20
Copilot AI reviewed May 22, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Consolidates the repo’s issue-tracking workflow onto GitHub Issues by adding a one-shot migration tool + audit artifacts, updating contributor guidance, and removing the migrated local NN-*.md issue files under docs/issues/<slug>/ (leaving PRDs as planning artifacts).

Changes:

  • Add scripts/migrate-local-issues.mjs to generate a migration plan and (optionally) execute label/issue creation + backfill + close + delete steps with resumable state.
  • Commit the generated migration artifacts (docs/migration-plan.md, docs/migration-state.json) for traceability.
  • Update AGENTS.md to reflect GitHub Issues as authoritative and avoid heading collisions; delete migrated local issue markdown files.

Reviewed changes

Copilot reviewed 73 out of 73 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
scripts/migrate-local-issues.mjs Adds migration script for planning/executing local-issues → GitHub Issues move
docs/migration-state.json Stores resumable migration state + source→issue mapping audit trail
docs/migration-plan.md Generated plan documenting creation order, label mapping, and dependencies
AGENTS.md Updates issue-tracker guidance and renames the duplicate skills heading
docs/issues/unic-archon-dlc/16-qa-verify-pr-base.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/unic-archon-dlc/15-fix-interactive-loop-fresh-context.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/unic-archon-dlc/14-readme-and-documentation.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/unic-archon-dlc/13-cleanup-workflow.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/unic-archon-dlc/12-qa-workflow.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/unic-archon-dlc/11-build-self-contained-review-command.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/unic-archon-dlc/10-build-verification-goals-check-and-report.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/unic-archon-dlc/09-build-tdd-core-and-slopcheck.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/unic-archon-dlc/08-plan-checker-and-yaml-gen.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/unic-archon-dlc/07-plan-to-issues-and-nyquist.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/unic-archon-dlc/06-plan-specs-and-to-prd.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/unic-archon-dlc/05-explore-prototype-and-spike-gate.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/unic-archon-dlc/04-explore-parallel-research-and-synthesize.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/unic-archon-dlc/03-triage-workflow-and-tracker-adapter.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/unic-archon-dlc/02-full-install-hook-and-agent-docs.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/unic-archon-dlc/01-plugin-scaffold-and-tracer-install.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-rereview/09-version-bump-and-release.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-rereview/08-test-fixture-suite.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-rereview/07-summary-comment-policy.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-rereview/06-reply-to-threads.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-rereview/05-classify-existing-threads.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-rereview/04-incremental-diff-baseline.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-rereview/03-target-latest-iteration.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-rereview/02-detect-prior-review.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-rereview/01-normalize-bot-signature.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-pre-pr-default-branch-override/01-env-var-override.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-orchestrator-split/07-version-bump-and-release.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-orchestrator-split/06-compact-subagent-output.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-orchestrator-split/05-add-pre-pr-mode.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-orchestrator-split/04-refactor-orchestrator.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-orchestrator-split/03-create-re-review-coordinator-agent.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-orchestrator-split/02-create-ado-writer-agent.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-orchestrator-split/01-create-ado-fetcher-agent.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-doc-context-spawn-reliability/03-wire-up-and-housekeeping.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-doc-context-spawn-reliability/02-orchestrator-agent.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-doc-context-spawn-reliability/01-adr-and-synthesizer-agent.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-doc-context-enrichment/04-version-bump-and-docs.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-doc-context-enrichment/03-confluence-page-doc-context-enrichment.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-doc-context-enrichment/02-work-item-doc-context-enrichment.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-doc-context-enrichment/01-confluence-page-client.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/pr-review-agents-not-discovered/01-rename-agents-dir-and-fix-frontmatter.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/inbox-collision-check/01-fix-exit-code.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/20-prompt-template-and-step-cleanup.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/19-skill-agents-doc-crosslink.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/18-failure-loop-protection.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/17-prd-title-extraction-step-1.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/16-explicit-tdd-skill-invocation.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/15-ready-for-human-unsatisfied-dependency.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/14-smarter-auto-select.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/13-tdd-prompt-template-in-references.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/12-heredoc-note-in-references.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/11-quick-start.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/10-references-split.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/09-retry-on-tdd-failure.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/08-feature-runner-docs.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/07-auto-selection.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/06-dependency-graph.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/05-full-context-bundle.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/04-progress-reporting.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/03-pr-creation.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/02-failure-handling.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/feature-runner/01-skill-scaffold.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/auto-format-runners/04-version-bump.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/auto-format-runners/03-replace-runner-functions.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/auto-format-runners/02-runner-module.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/auto-format-runners/01-formatter-descriptor-type.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/auto-format-config/03-version-bump.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/auto-format-config/02-wire-up.md Removes migrated local issue file (now represented in GitHub Issues)
docs/issues/auto-format-config/01-config-module.md Removes migrated local issue file (now represented in GitHub Issues)

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread scripts/migrate-local-issues.mjs Outdated
Comment thread scripts/migrate-local-issues.mjs Outdated
orioltf and others added 3 commits May 22, 2026 16:37
@orioltf
style: satisfy Biome lint on migrate-local-issues script
af29b59 
Apply Biome auto-fixes flagged by `pnpm ci:check` on PR #119:
sort the `node:fs` named imports alphabetically and convert three
string-concatenation expressions to template literals
(`useTemplate`). No behaviour change.
@orioltf
fix: harden migrate-local-issues regex and dedup gh label call
129d803 
- Broaden the `## Blocked by` parser to capture bullet-list items even
  when the ref is not wrapped in backticks or missing the `.md`
  extension (e.g. `- 02-wire-up`). Free prose like
  "None — can start immediately." is still skipped.
- Extend downstream lookups (`collect()` and `buildBody()`) to try both
  the raw ref and a `.md`-suffixed variant so position/issue-number
  resolution works for either form. Backtick substitution in the body
  also rewrites both variants.
- Call `gh label list` once and cache the output before parsing,
  instead of invoking it twice (extra CLI call + risk of mid-flight
  drift).
@orioltf @claude
chore: remove one-shot migration script and audit artifacts
d984b30 
The migration completed successfully (#49–#117 verified on GitHub), so
the script, generated plan, and state file have no further use. Removing
keeps the repo focused on the harness it's meant to host.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@orioltf orioltf merged commit c1bfe05 into develop May 22, 2026
4 checks passed
@orioltf orioltf deleted the feature/chore/setup-fixes branch May 22, 2026 14:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@orioltf