Skip to content

chore(planning): move the work tracker to the GitHub Project - #372

Merged
vidit-admin merged 7 commits into
mainfrom
claude/cleanup-changelog-next-a39e46
Oct 4, 2026
Merged

vidit-admin merged 7 commits into
mainfrom
claude/cleanup-changelog-next-a39e46

Conversation

@vidit-admin

@vidit-admin vidit-admin commented Oct 3, 2026 •

Copy link
Copy Markdown
Member

Summary

  • Moves the work tracker to the GitHub Project: issues in vidithq/vidit with a native type (Feature, Debt, Task, Bug) and the Status, Priority (P0 to P3), Version (v0.6 to v1.0, or Unscheduled) and Area fields.
  • Deletes planning/next.md and planning/backlog.md. The rows pruned during triage (shipped, superseded, duplicate) went with the files; git history keeps both.
  • Narrows the docs-pairing CI job to require a docs/ touch only, since planning/ now holds only roadmap.md. The Dependabot and no-docs-needed exemptions are unchanged. The check is renamed PR touches docs/; it is not a required status check.
  • Fixes docs/engineering.md: it cited extract_client_ip, which no longer exists. The rate limiter reads the right-most XFF entry through rate_limit_key, and the auth-events audit log stores no IP.

Pointer updates

Test plan

  • git grep -e next.md -e backlog.md returns only CHANGELOG.md hits.
  • Every relative markdown link in the changed files resolves.
  • ci.yml parses as YAML; the extracted docs-pairing check passes with a docs/ change and fails without one.
  • docs-pairing passes on this PR.

🤖 Generated with Claude Code

Remove 38 rows from planning/next.md: 14 already shipped, 13 superseded or
no longer accurate, and 11 older split rows that a merged row already covers.
Move the Requests board triage row from P1 to P2.

Fix docs/engineering.md: the client-IP helper it cited no longer exists; the
rate limiter reaches the right-most XFF entry through rate_limit_key, and the
auth-events audit log stores no IP.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: vidit-admin <admin@vidit.app>
@vidit-admin
vidit-admin force-pushed the claude/cleanup-changelog-next-a39e46 branch from ad7d557 to 3a605fa Compare October 3, 2026 22:56
…g.md

next.md had grown to 145 rows and about 100 KB, too long to plan from.

- planning/backlog.md holds all 145 rows with their original text, under
  the same version, Refactors and Unscheduled candidates sections, plus
  the cross-cutting rules. The empty v0.6.4 section is dropped.
- planning/next.md keeps the v0.6 rows and the v0.7 P0 and P1 rows (14
  rows), each reduced to a one-sentence outcome that links to its full
  row in backlog.md.
- CONTRIBUTING.md states the row rule and extends the shipped and
  descoped steps to backlog.md; AGENTS.md lists backlog.md.
- References that pointed at moved content (roadmap work breakdowns,
  README, issue and PR templates, CI comments, .gitattributes union
  merge, engineering.md tree, code comments) now point at backlog.md.
- One stale link in a backlog row (OverflowMenu.tsx, removed in #293)
  is unlinked.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: vidit-admin <admin@vidit.app>
@vidit-admin vidit-admin changed the title chore(planning): prune next.md of shipped, stale and duplicate rows chore(planning): prune next.md and split the detail into backlog.md Oct 3, 2026
vidit-admin and others added 2 commits October 4, 2026 01:05
The union merge strategy on planning/next.md reinserted the pre-split rows
when main (#371) edited them. Restore the short next.md and apply #371's
planning edits to backlog.md instead: the services/events package links and
the dropped services map row.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: vidit-admin <admin@vidit.app>
vidit-admin and others added 2 commits October 4, 2026 14:25
The work tracker now lives in the GitHub Project (vidithq/projects/1):
issues in vidithq/vidit with a native type (Feature, Debt, Task, Bug)
and the Status, Priority, Version and Area fields. planning/next.md and
planning/backlog.md are deleted; git history keeps them.

Pointers updated:
- AGENTS.md: the tracker row names the Project, the backlog row is gone,
  doc rules 2 and 3 point tracker content and hedge prose at the Project.
- CONTRIBUTING.md: new work is an issue with type, Priority, Version and
  Area; a shipping PR says Closes #N; the row-writing rules are gone.
- README.md, planning/roadmap.md (work breakdown links filter the
  Backlog view by version), the PR and feature-request templates,
  docs/engineering.md repo tree, .gitattributes (CHANGELOG union merge
  only).
- docs/backups.md, docs/engineering.md, docs/ingestion.md and code
  comments link the matching issue (#396, #429, #475, #476, #505, #515).

docs-pairing: the job now requires a docs/ touch only (planning/ holds
only roadmap.md). Exemptions are unchanged; the check is renamed
"PR touches docs/" (not a required status check).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: vidit-admin <admin@vidit.app>
@vidit-admin vidit-admin changed the title chore(planning): prune next.md and split the detail into backlog.md chore(planning): move the work tracker to the GitHub Project Oct 4, 2026
…log-next-a39e46

Signed-off-by: vidit-admin <admin@vidit.app>

# Conflicts:
#	.github/ISSUE_TEMPLATE/feature_request.md
#	.github/PULL_REQUEST_TEMPLATE.md
#	CONTRIBUTING.md
#	README.md
#	backend/app/models/event.py
#	docs/backups.md
#	docs/engineering.md
#	docs/ingestion.md
#	frontend/src/app/requests/page.tsx
#	planning/next.md
@vidit-admin
vidit-admin merged commit f6cb355 into main Oct 4, 2026
12 checks passed
@vidit-admin
vidit-admin deleted the claude/cleanup-changelog-next-a39e46 branch October 4, 2026 13:37
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