Rationalize proposals/: consolidate design docs into RFCs#69
Merged
Conversation
Move all design documents into a proposals/rfc/ directory and fix the two stale "proposals/design/..." display labels in the Supersedes lines of RFC-002 and RFC-003. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Clean up the proposals/ tree so rfc/ holds only the authoritative README + RFC-001..010: - Delete 8 top-level proposals fully superseded by RFCs (graph-classifier, graph-query, graph-mutation, graph-transform, pipeline-scenarios, scope-unification-proposal, representation-map-proposal, pattern-reconciliation). - Migrate PatternGraph design into RFC-004 Appendix A; delete pattern-graph.md. - Migrate DESIGN.md (deferred sketches) and pattern-category.md (categorical detail) into RFC-002 Appendices A/B; delete both. SEMANTICS.md and EXTENDED-SEMANTICS.md were fully covered by RFC-003 and are removed. - Elevate graph-value-instances.md to an indexed pre-RFC stub. - Move 5 non-RFC docs into new proposals/research/. - Fix the broken RFC-001 README row (frames-and-spans), rewrite the README index with absorbed-document provenance and a newcomer orientation section, and de-link all RFC Supersedes headers that pointed at removed files. - Repoint specs/ Input provenance lines to their superseding RFCs. Co-Authored-By: Claude Opus 4.8 <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
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.
Overview
Cleans up the
proposals/tree so it has a single clear organizing principle. After the earlier RFC restructure, the same designs lived in two places (older top-level proposals and the numbered RFCs that superseded them), the RFC index had a broken link, and supporting notes were mixed in with authoritative RFCs. This PR consolidates everything, with no design content lost — anything unique was migrated into RFC appendices before its source file was removed.Final structure
What changed
Removed (fully superseded, nothing unique lost):
SEMANTICS.mdandEXTENDED-SEMANTICS.md(fully covered by RFC-003)Migrated then removed (had unique content):
pattern-graph.md→ RFC-004 Appendix A (PatternGraph container design)DESIGN.md→ RFC-002 Appendix B (deferred design sketches behind the open questions)pattern-category.md→ RFC-002 Appendix A (value magma, layeredCategoryLens, worked example, applications)Reorganized:
proposals/research/directorygraph-value-instances.mdto an indexed pre-RFC stubFixed references:
RFC-001-strata-and-aspects.mdwith pre-rename "strata/aspects" terminology) — the last lingering trace of the strata→frames / aspects→spans renameSupersedes:headers that pointed at removed files (kept as plain provenance text)specs/Input:provenance lines to their superseding RFCs (original prompt text preserved, accurate pointer appended)Reviewer notes
proposals/design/→proposals/rfc/rename from the substantive consolidation, so the diff is easier to follow commit-by-commit.DESIGN.mdandpattern-category.mdwere gated on a verification pass confirming their unique content was carried into RFC-002's new appendices; thespecs/Input:lines were intentionally left as historical records with the pointer appended rather than rewritten.🤖 Generated with Claude Code