Skip to content

Clarify documentation authority and provenance - #292

Merged
witbrock merged 1 commit into
mainfrom
agent/document-authority-governance
Jul 12, 2026
Merged

witbrock merged 1 commit into
mainfrom
agent/document-authority-governance

Conversation

@witbrock

Copy link
Copy Markdown
Member

What changed

  • adds a canonical design and engineering document index
  • routes coding agents through the index from AGENTS.md
  • distinguishes current guidance, target design, dated evidence, and historical material
  • adds evidence-boundary banners to the highest-risk stale documents
  • repairs machine-local and incorrect relative documentation links
  • keeps private research syntheses and the Von compendium out of the public repository

Why

Von's flat engineering-document corpus mixed mandatory guidance, dated status snapshots, design proposals, and historical Jira implementation records. Confident stale wording could mislead coding agents about current authority or implementation state.

Validation

  • git diff --cached --check
  • repository-relative Markdown link existence scan across every changed document
  • added-line credential-pattern scan
  • independent documentation authority and commit-scope reviews

This PR is documentation-only.

@witbrock
witbrock marked this pull request as ready for review July 12, 2026 07:01
@witbrock
witbrock merged commit 2a9e45b into main Jul 12, 2026
4 checks passed
@witbrock
witbrock deleted the agent/document-authority-governance branch July 12, 2026 07:06
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