docs: refresh README for B2B investors and partners

.agent/context/20261008T163453Z-readme-b2b-positioning.md

@@ -0,0 +1,80 @@
+# Session Context: B2B README positioning
+
+## Date/time
+
+- UTC: 2026-10-08T16:34:53Z
+
+## User goal
+
+Refresh README for investors and partners and create a PR.
+
+## Original prompt/request
+
+Create a more structured startup README. Interview clarified B2B agent builders
+as initial focus, internal agent operators as prospective buyers, and service
+platforms as prospective partners. No customers or pilot feedback yet. Use
+work@kapustazh.dev for enquiries; website changes come later.
+
+## Assumptions
+
+- Invite customer discovery, integration discussions, and early pilots.
+- Retain documented testnet evidence without claiming new live validation.
+
+## Plan
+
+1. Rewrite overview; preserve technical reference in developer guide.
+2. Validate documentation, commit, push draft PR and observe CI.
+   User explicitly requested skipping FreePi on continuation.
+
+## Key decisions
+
+- Explain duplicate payment recovery rather than blockchain double spending.
+- No accelerator relationship or traction claim.
+- No implementation, deployment, or payment changes.
+
+## Files/components touched
+
+- README.md: B2B problem, buyer, evidence, stage, contact, documentation links.
+- docs/DEVELOPER_GUIDE.md: existing technical README content with corrected links.
+- This context record.
+
+## Commands/checks
+
+- Local Markdown link existence check: PASS.
+- git diff --check: PASS.
+- corepack pnpm install --frozen-lockfile: PASS.
+- corepack pnpm lint, typecheck, and format:check: PASS.
+- Runtime: Node 22.23.2; repository pins 24.19.0, CI must verify pinned runtime.
+- Prettier --check and repository-configured markdownlint-cli2: PASS.
+- Default markdownlint-cli initially reported inherited table/HTML conventions;
+  rerun with repository CLI2 configuration passed after removing emphasis-as-heading.
+- Test matrix: behavior cases not applicable to documentation-only changes.
+
+## External-doc findings
+
+- No integration/version changes. Claims grounded in existing live evidence.
+
+## Unresolved questions
+
+- Pricing and customer demand remain unvalidated.
+
+## Git and PR state
+
+- Branch: feature/readme-b2b-positioning
+- Base: origin/develop a60836b1acdb4a71aa1aaffd09f0a40f25903924
+- Documentation commit: bbb72194687b8e9604f06c8ef0d9a276723ddf5a.
+- PR: https://github.com/SWOFART/OneShot/pull/148 (draft, targets develop).
+- CI: triggered; repository-policy, Markdown/Mermaid, ESLint/TypeScript,
+  browser acceptance, and Workers build pending at creation.
+- This context-only follow-up records PR state; CI must validate final head.
+
+## Review gates
+
+- Gate A: SKIPPED at explicit user instruction: "we don't need freepi here. chill".
+- Gate B: SKIPPED at the same instruction. No passing review is claimed.
+- Deviation from .agent/IMPLEMENTATION_LOOP.md is explicit; PR remains draft.
+
+## Handoff/next steps
+
+1. PR created; local validation passed. CI remains pending at handoff.
+2. A human reviews and merges; do not mark ready or merge automatically.