docs(readme): reframe PSE as post-symbolic cognitive substrate#85
Merged
Conversation
The previous README described PSE in terms of its original data-analysis
pipeline identity ("streaming computation engine that detects structural
events in observation streams"). This was accurate for the core engine
before the traversal stack was built, but no longer reflects what the
system is.
Rewrite to accurately reflect the current architecture:
- Opening: PSE is a post-symbolic cognitive substrate, not a stream
detector. It sits between symbolic and connectionist computation,
reducing to neither.
- Architecture section: three-tier model (Core Engine / Traversal Agent
Stack / Governance) with layer table and ADAMANT protocol explained.
- Layer detail sections: each layer gets its own section with the
correct pipeline diagram and invariants (previously only described
in a "What's new" changelog block at the bottom).
- Status table: added ADAMANT v1.0.0 and productive-task validation
as explicit rows.
- Eval matrix status: surface the diagnostic results (PSE 100% recall,
Raw 52-63%) and the productive_agent_validated=false status honestly.
- Specifications table: replaces scattered inline references with a
single structured table mapping each document to its layer.
- Removed: the "What's new since the last README" changelog section
(content belongs in CHANGELOG.md, not the primary README).
No technical content was removed; all CLI commands, benchmark numbers,
crate descriptions, and quality/CI tables are preserved.
https://claude.ai/code/session_01K5AN3s9TnGo1Az4jYwagtw
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.
The previous README described PSE in terms of its original data-analysis pipeline identity ("streaming computation engine that detects structural events in observation streams"). This was accurate for the core engine before the traversal stack was built, but no longer reflects what the system is.
Rewrite to accurately reflect the current architecture:
No technical content was removed; all CLI commands, benchmark numbers, crate descriptions, and quality/CI tables are preserved.
https://claude.ai/code/session_01K5AN3s9TnGo1Az4jYwagtw