Skip to content

CR-1000: move languages-ng's work tracking to the central ourPLCC/dev tracker - #21

Merged
StoneyJackson merged 5 commits into
mainfrom
cr-1000-migrate-to-central-tracker
Oct 11, 2026
Merged

StoneyJackson merged 5 commits into
mainfrom
cr-1000-migrate-to-central-tracker

Conversation

@StoneyJackson

Copy link
Copy Markdown
Member

CR-1000: move languages-ng's work tracking to the central ourPLCC/dev tracker.

languages-ng's 53 issues are now change requests CR-501 to CR-553 in ourPLCC/dev (old #N is CR-<N+500>, e.g. #12 is CR-512). This branch switches the repo over and retires the file-based tracker.

Changes

  • Devcontainer: clones ourPLCC/dev beside this repo as ../dev if missing, mounts it at /workspaces/dev, sets BACKLOG_CWD, and installs the pinned backlog CLI. ~/.claude becomes the languages-ng-claude named volume, so it survives rebuilds. bin/install/claude-imports.bash approves AGENTS.md's imports from ../dev. .plans/ is gitignored.
  • CLAUDE.md → AGENTS.md: imports ../dev/ORG-AGENTS.md, ../dev/CONTRIBUTING.md, then CONTRIBUTING.md, and keeps only the agent-only rules (reviewing shell in plans, verifying a subagent's commits).
  • CONTRIBUTING.md: opens with the link to the org developer guide and covers the ../dev setup and the +500 offset. The course-material impact log rule moves here from CLAUDE.md. The bin/issues/ rows are removed.
  • Links: links into dev-docs/issues/ now point at CR IDs. Links to the tracker's own files (issue-conventions.md, bin/issues/) are now plain text. Frozen specs and plans got link-only edits. Comments in .devcontainer/devcontainer.json, .releaserc.yaml, and bin/check-run-complete.bash now name the CR instead of an issue path.
  • Retired: dev-docs/issues/, dev-docs/issue-conventions.md, bin/issues/, and bin/tests/issues-*.bats.

Verification

  • bin/test.bash: 191 tests, 0 failures, exit 0.
  • Outside the frozen dev-docs/plans/, specs/, and reviews/, grep -rn 'dev-docs/issues' finds nothing (excluding .git).
  • Before merging: rebuild the container from this branch on the host and check that it starts, that backlog task list works, and that /memory lists ORG-AGENTS.md and both CONTRIBUTING.md files.

From this merge on, nothing is filed in dev-docs/issues/; new work goes in the tracker.

🤖 Generated with Claude Code

StoneyJackson and others added 4 commits October 11, 2026 10:19
… tracker

Clone ourPLCC/dev beside this repo on the host and mount it at
/workspaces/dev, point the backlog CLI at it, install the pinned
backlog, and assert git works in both repos. Mount ~/.claude as the
languages-ng-claude volume so assistant memory survives a rebuild, and
approve AGENTS.md's imports from ../dev on creation. Ignore .plans/.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
AGENTS.md imports ../dev/ORG-AGENTS.md, ../dev/CONTRIBUTING.md, then
CONTRIBUTING.md, and keeps only the agent-only rules: reviewing shell in
plans and verifying a subagent's commits. CONTRIBUTING.md opens with the
link to the org developer guide, describes the ../dev clone and the +500
offset for old issue numbers, and takes over the course-material impact
log rule. The memory, tracker, and spec-location sections are dropped:
the ~/.claude volume and the org guide replace them. Allow backlog in
the project's Claude settings.

Part of CR-1000.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Links into dev-docs/issues/ become CR-<N+500>, and links to the tracker's
own files (issue-conventions.md, bin/issues/, the roadmap) become plain
text. Frozen specs and plans get link-only edits; their prose is left
as written. Comments naming issue paths in the devcontainer, the release
config, and check-run-complete.bash now name the CR. The developer-docs
index drops its Issue Conventions entry.

Part of CR-1000.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Work is now tracked as change requests in ourPLCC/dev; languages-ng's
53 issues were converted there as CR-501 to CR-553. Delete
dev-docs/issues/, dev-docs/issue-conventions.md, bin/issues/, and their
bats tests.

Part of CR-1000.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI balanced review requested due to automatic review settings October 11, 2026 14:59

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟡 Changes recommended

The course-material impact log still links to the deleted CLAUDE.md, leaving live contributor documentation dangling.

1 open finding
What changed in this PR

Migrates languages-ng work tracking to the central ourPLCC/dev CR tracker and retires the repository-local issue system.

Changes:

  • Removes 53 local issue files, tracker scripts, and tests.
  • Adds central-tracker devcontainer integration and agent guidance.
  • Rewrites historical issue references to CR IDs.
File Description
.claude/​settings.json Allows backlog commands.
.devcontainer/​devcontainer.json Mounts and configures the central tracker.
.gitignore Ignores worktree-local plans.
.releaserc.yaml Replaces issue-path references with CR IDs.
AGENTS.md Imports organization guidance and retains agent-only rules.
CLAUDE.md Retires superseded agent guidance.
CONTRIBUTING.md Documents the central tracker and repository workflow.
bin/​check-run-complete.bash Replaces an issue-path reference with CR-531.
bin/​install/​claude-imports.bash Approves external Claude imports.
bin/​issues/​check.bash Removes local tracker validation.
bin/​issues/​close.bash Removes local issue closing.
bin/​issues/​list.bash Removes local issue listing.
bin/​issues/​new.bash Removes local issue creation.
bin/​tests/​issues-check.bats Removes tracker validation tests.
bin/​tests/​issues-close.bats Removes tracker closing tests.
bin/​tests/​issues-list.bats Removes tracker listing tests.
dev-docs/​course-material-impact.md Converts issue links to CR references.
dev-docs/​index.md Removes the retired conventions link.
dev-docs/​issue-conventions.md Removes obsolete local tracker documentation.
dev-docs/​issues/​.next-id.txt Removes the local issue counter.
dev-docs/​issues/​001-remove-unused-languages.md Migrated to the central tracker.
dev-docs/​issues/​002-migrate-v0-to-plcc-ng.md Migrated to the central tracker.
dev-docs/​issues/​003-python-run-return-value-quoted.md Migrated to the central tracker.
dev-docs/​issues/​004-js-var-field-reserved-word.md Migrated to the central tracker.
dev-docs/​issues/​005-migrate-v1-to-plcc-ng.md Migrated to the central tracker.
dev-docs/​issues/​006-multi-capture-alt-name-case-mismatch.md Migrated to the central tracker.
dev-docs/​issues/​007-migrate-v2-to-plcc-ng.md Migrated to the central tracker.
dev-docs/​issues/​008-update-plcc-ng-2.0.0.md Migrated to the central tracker.
dev-docs/​issues/​009-migrate-v3-to-plcc-ng.md Migrated to the central tracker.
dev-docs/​issues/​010-plcc-ng-arbno-drops-mid-body-terminal.md Migrated to the central tracker.
dev-docs/​issues/​011-devcontainer-image-stale-plcc-ng-version.md Migrated to the central tracker.
dev-docs/​issues/​012-ci-cannot-run-plcc-ng-migrated-languages.md Migrated to the central tracker.
dev-docs/​issues/​013-dev-docs-link-checker-not-fence-aware.md Migrated to the central tracker.
dev-docs/​issues/​014-migrate-v4-to-plcc-ng.md Migrated to the central tracker.
dev-docs/​issues/​015-gitignore-java-pattern-shadows-source-dirs.md Migrated to the central tracker.
dev-docs/​issues/​016-cross-target-integer-divergence.md Migrated to the central tracker.
dev-docs/​issues/​017-migrate-v5-to-plcc-ng.md Migrated to the central tracker.
dev-docs/​issues/​018-close-bash-rewrites-plan-prose.md Migrated to the central tracker.
dev-docs/​issues/​019-python-recursion-ceiling.md Migrated to the central tracker.
dev-docs/​issues/​020-close-bash-roadmap-awk-edge-cases.md Retired as obsolete tracker work.
dev-docs/​issues/​021-migrate-v6-to-plcc-ng.md Migrated to the central tracker.
dev-docs/​issues/​022-plcc-rep-parses-each-source-independently.md Migrated to the central tracker.
dev-docs/​issues/​023-migrate-set-to-plcc-ng.md Migrated to the central tracker.
dev-docs/​issues/​024-migrate-ref-to-plcc-ng.md Migrated to the central tracker.
dev-docs/​issues/​025-relocate-copies-stale-build-artifacts.md Migrated to the central tracker.
dev-docs/​issues/​026-apply-env-comment-missing-from-most-targets.md Migrated to the central tracker.
dev-docs/​issues/​027-use-spec-flag-instead-of-copying-tree.md Migrated to the central tracker.
dev-docs/​issues/​028-relocate-filter-hides-permission-errors.md Migrated to the central tracker.
dev-docs/​issues/​029-migrate-name-to-plcc-ng.md Migrated to the central tracker.
dev-docs/​issues/​030-migrate-need-to-plcc-ng.md Migrated to the central tracker.
dev-docs/​issues/​031-suite-exhausts-disk-and-reports-spurious-failure.md Migrated to the central tracker.
dev-docs/​issues/​032-migrate-type0-to-plcc-ng.md Migrated to the central tracker.
dev-docs/​issues/​033-test-bash-75-minute-run-and-lost-implementers.md Migrated to the central tracker.
dev-docs/​issues/​034-migrate-type1-to-plcc-ng.md Migrated to the central tracker.
dev-docs/​issues/​035-migrate-obj-to-plcc-ng.md Migrated to the central tracker.
dev-docs/​issues/​036-plcc-rep-deadlocks-on-partial-stdout-line.md Migrated to the central tracker.
dev-docs/​issues/​037-plcc-rep-lacks-output-and-clean-exit-records.md Migrated to the central tracker.
dev-docs/​issues/​038-plcc-ng-follow-set-omits-nullable-tail.md Migrated to the central tracker.
dev-docs/​issues/​039-putc-puts-diverge-across-targets.md Migrated to the central tracker.
dev-docs/​issues/​040-obj-test-coverage-gaps-and-example-sweep.md Migrated to the central tracker.
dev-docs/​issues/​041-obj-java-redundant-import-blocks-and-block-order.md Migrated to the central tracker.
dev-docs/​issues/​042-test-bash-75-minute-run-and-lost-implementers.md Migrated as a central draft.
dev-docs/​issues/​043-issues-new-bash-creates-issue-for-help-flag.md Retired as obsolete tracker work.
dev-docs/​issues/​044-relocate-swallows-git-failure-reason.md Migrated to the central tracker.
dev-docs/​issues/​045-release-workflow-uses-blocked-action.md Migrated to the central tracker.
dev-docs/​issues/​046-release-notes-generator-not-loaded.md Migrated to the central tracker.
dev-docs/​issues/​047-issue-conventions-claims-generated-changelog.md Migrated to the central tracker.
dev-docs/​issues/​048-release-success-step-resolves-file-issue-refs.md Migrated to the central tracker.
dev-docs/​issues/​049-retire-roadmap-open-issues-section.md Migrated to the central tracker.
dev-docs/​issues/​050-head-idiom-coupled-to-template-comment.md Retired as obsolete tracker work.
dev-docs/​issues/​051-close-bash-argument-paths-untested.md Retired as obsolete tracker work.
dev-docs/​issues/​052-upstream-issues-track-local-work-only.md Migrated to the central tracker.
dev-docs/​issues/​053-issue-refs-ambiguous-outside-frontmatter.md Retired as obsolete tracker work.
dev-docs/​issues/​TEMPLATE.md Removes the local issue template.
dev-docs/​issues/​index.md Removes the local issue index.
dev-docs/​plans/​* (18 files) Replaces historical issue links with CR references.
dev-docs/​specs/​* (17 files) Replaces historical issue links with CR references.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread CONTRIBUTING.md
they change something an instructor's slides, handouts, or lecture notes
would need to match (a renamed field referenced in a semantics
walkthrough, a changed output format, a renamed grammar symbol). Log
these in [dev-docs/course-material-impact.md](dev-docs/course-material-impact.md),
The course-material impact log pointed at CLAUDE.md for its same-commit
rule, which now lives in CONTRIBUTING.md; point it there. Frozen plans
and specs that linked CLAUDE.md or bin/tests/issues-check.bats keep the
name as plain text, as for the other retired tracker files.

Part of CR-1000.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@StoneyJackson
StoneyJackson merged commit 3d70715 into main Oct 11, 2026
1 check passed
@StoneyJackson
StoneyJackson deleted the cr-1000-migrate-to-central-tracker branch October 11, 2026 15:33
@StoneyJackson
StoneyJackson restored the cr-1000-migrate-to-central-tracker branch October 11, 2026 15:34
@StoneyJackson
StoneyJackson deleted the cr-1000-migrate-to-central-tracker branch October 11, 2026 15:35
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.

2 participants