Skip to content

[Audit Follow-up] Fix stale internal references in governance documentation #424

Closed

Description

@ashleyshaw

Summary

Resolve stale internal links and incorrect file-path references identified by governance audit #20.

Scope

  • Review and repair stale internal links in:
    • AGENTS.md
    • .github/custom-instructions.md
    • CONTRIBUTING.md
    • README.md
    • docs/AUTOMATION_GOVERNANCE.md
  • Keep changes docs-only and scoped to link/reference correctness.

Acceptance Criteria

  • All in-scope files have valid internal links.
  • No references to removed/migrated files remain without replacement.
  • markdownlint and diff whitespace checks pass.

Parent

Activity

  1. linear-code commented on May 27, 2026

    @linear-code
  2. self-assigned this
    on May 27, 2026
  3. ashleyshaw commented on May 27, 2026

    @ashleyshaw
    MemberAuthor

    Triage complete: moved to status:ready and assigned to @ashleyshaw.\n\nDependency order agreed for execution: #422 -> #423 -> #424.\n- #422 defines canonical reference policy first (single source of truth + examples).\n- #423 implements the governance revision log process based on #422 policy.\n- #424 performs stale-link/path sweep after #422/#423 wording lands.

  4. added this to the milestone on May 27, 2026
  5. ashleyshaw commented on May 27, 2026

    @ashleyshaw
    MemberAuthor

    Progress update: completed an in-scope stale-reference pass and validated link targets locally, but GitHub currently reports no commit delta against develop for this branch (the fixes appear already present in develop history). I am re-verifying live state before deciding whether to close this issue as completed or post a narrower follow-up diff.

  6. ashleyshaw commented on May 27, 2026

    @ashleyshaw
    MemberAuthor

    Follow-up closeout after merge of #439:\n\n- #422 is now merged/closed and canonical instruction reference policy is established.\n- #424 stale-reference sweep can proceed against the finalised policy wording.\n\nStatus: keep open and execute after #423 per dependency order.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Fields

Priority

None yet

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions