Skip to content

docs: remove forward references from drift tasks - #68

Merged
retr0h merged 1 commit into
mainfrom
fix/drift-forward-references
Aug 16, 2026
Merged

docs: remove forward references from drift tasks#68
retr0h merged 1 commit into
mainfrom
fix/drift-forward-references

Conversation

@retr0h

@retr0h retr0h commented Aug 16, 2026

Copy link
Copy Markdown
Contributor

correct-documentation-drift carried two tasks for work that belongs to changes not yet written. CONTRIBUTING is explicit about why that is wrong:

A task list must therefore contain only this change's own work. Do not add a task for follow-up work in another change: the archive step verifies every task is checked, so a forward reference blocks the change from ever archiving.

I added them in specs#67. This removes them.

Both findings are preserved in design.md under Found, not covered, which is where the archive keeps reasoning:

  • gohai's collector legend defines twice and declares a ⚠️ state no row uses. A document contradicting itself is neither an unresolved reference nor a miscount, so no requirement here reaches it.
  • Repositories disagree on where plans live (docs/superpowers/ vs docs/plans/). Each now says the directory is created on first use, which satisfies the requirement; picking one location is a standardization decision, and repo-standards deliberately imposes no section structure on AGENTS.md.

correct-documentation-drift is now 38/38 and ready to archive.

🤖 Generated with Claude Code

CONTRIBUTING requires a task list to carry only its own change's work,
because archive verifies every task is checked — a forward reference
blocks the change from archiving. Two findings were recorded as tasks
that belong to changes not yet written. Move both to design.md, where
the archive keeps reasoning.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

Thank you for contributing to this project! 😊🕹️

@retr0h
retr0h merged commit 215db89 into main Aug 16, 2026
6 checks passed
@retr0h
retr0h deleted the fix/drift-forward-references branch August 16, 2026 04:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant