docs(standards): document canonical source principle in code-style-conventions#710
Merged
Merged
Conversation
…nventions Add Canonical Source Principle section to code-style-conventions.md: - Define what makes a document canonical (4 criteria) - Provide do/don't guidance for referencing canonical sources - List current canonical sources with formal markers - List de-facto authoritative sources - Document process for creating new canonical sources This formalizes the single-source-of-truth pattern already used by SESSION-PROTOCOL.md and PROJECT-CONSTRAINTS.md. Closes #675 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Contributor
|
Note Gemini is unable to generate a review for this pull request due to the file types involved not being currently supported. |
Contributor
PR Validation ReportTip ✅ Status: PASS Description Validation
QA Validation
Powered by PR Validation workflow |
rjmurillo-bot
added a commit
that referenced
this pull request
Dec 31, 2025
Session completed 4 PRs from priority issues: - PR #708: Issue #700 - ConvertFrom-Json error handling - PR #709: Issue #699 - GITHUB_OUTPUT error handling - PR #710: Issue #675 - Canonical source principle - PR #711: Issue #686 - Trust-based compliance antipattern 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
18 tasks
rjmurillo
pushed a commit
that referenced
this pull request
Dec 31, 2025
* docs(governance): document trust-based compliance antipattern Create PROTOCOL-ANTIPATTERNS.md documenting: - Trust-based compliance antipattern with evidence from PR #669 - Verification-based enforcement replacement pattern - Three case studies (branch verification, session init, test execution) - Design guidelines and implementation checklist Also adds links from SESSION-PROTOCOL.md and AGENT-INSTRUCTIONS.md to the new antipatterns document. Closes #686 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * docs(session): add session 112 log for autonomous development Session completed 4 PRs from priority issues: - PR #708: Issue #700 - ConvertFrom-Json error handling - PR #709: Issue #699 - GITHUB_OUTPUT error handling - PR #710: Issue #675 - Canonical source principle - PR #711: Issue #686 - Trust-based compliance antipattern 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> --------- Co-authored-by: rjmurillo[bot] <rjmurillo-bot@users.noreply.github.com> Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Add formal documentation of the Canonical Source Principle to code-style-conventions.md, formalizing the single-source-of-truth pattern already used by SESSION-PROTOCOL.md and PROJECT-CONSTRAINTS.md.
Specification References
Changes
Type of Change
Testing
Agent Review
Security Review
Other Agent Reviews
Critic Review: PASS after corrections - Fixed filename typo and split canonical sources into formal/de-facto categories.
Checklist
Related Issues
Closes #675