Skip to content

docs: rewrite positioning, readme, and paper narrative#81

Open
nerdsane wants to merge 1 commit intomainfrom
docs/positioning-rewrite
Open

docs: rewrite positioning, readme, and paper narrative#81
nerdsane wants to merge 1 commit intomainfrom
docs/positioning-rewrite

Conversation

@nerdsane
Copy link
Owner

Summary

  • POSITIONING.md: Unified narrative from two disjointed halves into a single derivation chain (tools → state machines → descriptions → constructor → skills → governance → evolution → trust). Von Neumann architecture emerges from the derivation instead of restarting it. Tools/skills terminology transition happens once and sticks. Status sections merged into one honest assessment.
  • README.md: Paperclip-style approachable structure. Implementation details (Cedar, OData, IOA, crate table) moved to collapsible section. Skills terminology throughout.
  • PAPER.md: Von Neumann framing in abstract and intro, updated references, GEPA and skill system introduced.

Test plan

  • Read through POSITIONING.md for narrative flow and consistency
  • Read through README.md for approachability and accuracy
  • Verify PAPER.md references and citations
  • Check that "tools" vs "skills" terminology is used consistently across all three docs

🤖 Generated with Claude Code

Restructure all three documents around a single derivation chain:
agents build tools → tools are state machines → state machines are
descriptions → descriptions need a constructor → verified descriptions
are skills → skills need governance → skills must evolve → evolution
needs trust calibration.

Key changes:
- POSITIONING: unified narrative (was two disjointed halves), Von Neumann
  architecture emerges from the derivation instead of restarting it,
  tools/skills terminology transition happens once and sticks, section 8
  merges status/limitations/layers into one honest assessment
- README: Paperclip-style approachable structure, implementation details
  in collapsible section, skills terminology throughout
- PAPER: Von Neumann framing in abstract and intro, updated references,
  GEPA and skill system introduced

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@nerdsane nerdsane force-pushed the docs/positioning-rewrite branch from 9f9db22 to a0e6b5e Compare March 24, 2026 00:05
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.

2 participants