Skip to content

[Governance] Define canonical instruction reference policy (.github/instructions vs instructions) #422

Closed

Description

@ashleyshaw

Summary

Establish one explicit rule for when governance docs must reference repo-local instruction paths under .github/instructions versus portable instruction paths under top-level instructions.

Scope

  • Document the policy in one canonical location.
  • Update AGENTS.md and docs/AUTOMATION_GOVERNANCE.md to align with that policy.
  • Add examples for maintainers to avoid future drift.

Acceptance Criteria

  • Policy exists and is easy to find.
  • Cross-references in AGENTS.md and governance docs are aligned.
  • No contradictory guidance remains in audited governance files.

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
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