Skip to content

docs(readme): rewrite positioning, add evaluation architecture, and motivation - #38

Merged
theonly1me merged 4 commits into
mainfrom
docs/positioning-and-readme
Sep 6, 2026
Merged

docs(readme): rewrite positioning, add evaluation architecture, and motivation#38
theonly1me merged 4 commits into
mainfrom
docs/positioning-and-readme

Conversation

@theonly1me

@theonly1me theonly1me commented Sep 6, 2026

Copy link
Copy Markdown
Owner

What changed

  • Rewrite README.md to lead with the falsifiable behavioral claim and the shadowclone eval command.
  • Define architectural scope explicitly as a memory and alignment compiler rather than an agent runtime.
  • Document ground-truth privacy guarantees including sliced secret redaction, Shannon entropy filtering, and categorical tool result exclusions.
  • Document enterprise governance ceilings via root-owned managed configuration files.
  • Author open-source motivation and design philosophy in docs/motivation.md.
  • Add replay evaluation architecture doc in docs/architecture/09-evaluation.md and update architecture index.

Why

Leading with falsifiable behavioral metrics gives engineers a concrete reason to trust shadowclone over uncalibrated memory tools. Clarifying that shadowclone compiles memory for existing CLIs rather than replacing them prevents category confusion. Documenting privacy architectures and managed policies gives security reviewers verified claims they can audit directly against the source.

How to verify

bun run check

Data handling

  • Any new capture source has an opt-in flag and a README entry in this PR
  • Everything that reaches the network passes redactSecrets
  • No raw capture in a log line, an error message, or a test fixture
  • A test exercises the real entry point, not just the redaction function

Comment thread docs/marketing/launch-brief.md Outdated

## Core messages

**Your agent has amnesia. Your disk does not.**

@theonly1me theonly1me Sep 6, 2026

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We already have claude code auto-memory for this, I think what we're solving isn't solved by that.

@theonly1me theonly1me changed the title docs(readme): rewrite positioning, add evaluation architecture, and launch brief docs(readme): rewrite positioning, add evaluation architecture, and motivation Sep 6, 2026
@theonly1me
theonly1me force-pushed the docs/positioning-and-readme branch from 08e7406 to dfd6c33 Compare September 6, 2026 11:25
@theonly1me
theonly1me force-pushed the docs/positioning-and-readme branch from dfd6c33 to e6feba5 Compare September 6, 2026 11:25
@theonly1me
theonly1me force-pushed the docs/positioning-and-readme branch from e6feba5 to 138e3f8 Compare September 6, 2026 11:25
@theonly1me
theonly1me force-pushed the docs/positioning-and-readme branch from 138e3f8 to d722212 Compare September 6, 2026 11:25
@theonly1me
theonly1me force-pushed the docs/positioning-and-readme branch from d722212 to bf9f619 Compare September 6, 2026 11:25
Base automatically changed from feat/repo-hygiene to main September 6, 2026 11:25
@theonly1me
theonly1me force-pushed the docs/positioning-and-readme branch from bf9f619 to b7107d6 Compare September 6, 2026 11:25
@theonly1me
theonly1me merged commit 4750129 into main Sep 6, 2026
2 checks passed
@theonly1me
theonly1me deleted the docs/positioning-and-readme branch September 6, 2026 11:26
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.

1 participant