docs: Add Working Model and Local Guidance Convention#2
Open
davidfsol5 wants to merge 1 commit into
Open
Conversation
Captures the evolving conceptual model of polycentric knowledge processing refined through Experiments 1-3: Working Model: - Polycentricity vs Distribution distinction - The Seam: shared referent IRIs enabling join without collapse - Sharing as Projection: 4-field model (include_types, stub_types, edge_predicates, exclude_nodes) - Non-Collapse Invariant: perspectives must remain distinct - Operational principles: immutable input, reproducible experiments, heterogeneous deployment, "just enough" sharing Local Guidance Convention: - Two-tier system: version-controlled CLAUDE.md + local .claude/CLAUDE.md - Semantics: scope, inheritance, precedence rules - Coherence checks on commit/PR with promotion path - Purpose: engineering room for working models before team consumption Also updates .gitignore to use **/.claude/ pattern for nested directories. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
davidfsol5
pushed a commit
that referenced
this pull request
Jun 4, 2026
Documents the session covering: - PR #1 review and approval (polycentric-experiments) - Working model analysis (7 conceptual refinements identified) - Local Guidance Convention design discussion - PR #1 merge - PR #2 creation (working-model-guidance) 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
1 participant
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
Following the merge of PR #1 (
polycentric-experiments), this PR codifies the conceptual insights derived from reviewing that work into the project'sCLAUDE.md.Working Model Section
Captures the evolving conceptual model of polycentric knowledge processing:
include_types,stub_types,edge_predicates,exclude_nodes) operating over any RDF vocabularyLocal Guidance Convention Section
Establishes a two-tier guidance system for Claude Code:
CLAUDE.md— authoritative, team-shared.claude/CLAUDE.md— working notes, gitignored, supplements (does not override).gitignore Update
Changes
.claude/to**/.claude/to support the convention that local guidance directories can exist at any level in the repo.Context
This PR emerged from the review of PR #1, where we identified that mzargham's experiments implicitly refined several conceptual elements of the project's working model. Rather than leaving these insights uncodified, we're promoting them to the shared
CLAUDE.md.The Local Guidance Convention addresses the need for "engineering room" — a place for working models and observations before they're ready for team consumption.
Test Plan
.gitignorepattern tested:**/.claude/correctly matches nested directoriesGenerated with Claude Code