Skip to content

docs(design): park design, research and go-to-market notes - #13

Open
mmabrouk wants to merge 1 commit into
parked-notes-basefrom
docs/parked-design-and-gtm-notes
Open

docs(design): park design, research and go-to-market notes#13
mmabrouk wants to merge 1 commit into
parked-notes-basefrom
docs/parked-design-and-gtm-notes

Conversation

@mmabrouk

Copy link
Copy Markdown
Owner

Why this exists

The main working tree had accumulated 1017 uncommitted entries. Almost all of it
turned out to be a byte-for-byte duplicate of work already under review, but 27
files held content that existed nowhere in git. If the working tree had been
cleaned without this branch, that content would have been gone.

This pull request lives on the fork on purpose. None of it is ready for the main
repository. It is a durable parking place so the material can be picked up later.

What is in here

Design and research notes, under docs/design/agent-workflows/:

File What it covers
projects/selfhost-hardening/plan.md Plan for hardening self-hosted deployments
projects/runner-desloppify-redo/engine-quality-roadmap.md Roadmap for making the sandbox-agent engine well written
scratch/research-client-tools-and-concurrent-hitl.md How client tools are delivered per harness and sandbox, and concurrent human-in-the-loop approvals
scratch/desloppify-round2-assessment.md What the first desloppify pass left untouched
scratch/debug-warm-resume-execution-failure.md Root cause: warm resume never executes the approved command
scratch/debug-frontend-approval-dispatch.md Root cause: why the second approval card never dispatches
scratch/pr-5400-drive-mounts-review-handoff.md Review brief for the PR Agenta-AI#5400 mounts and files backend
scratch/pr-5400-drive-mounts-review-report.md Findings from that review
scratch/pr-5400-fix-implementation-brief.md The fix brief written against those findings
scratch/retheme-hex-audit-2026-07-19.md Audit of hard-coded hex colors against the warm brand palette
scratch/stale-llmops-positioning-sweep-2026-07-23.md Stale positioning language found outside docs/

Go-to-market material, under docs/design/gtm/. These four were sitting loose
at the repository root or in website/, so they are moved into one folder:

File Was What it is
gtm-wiki.md gtm.txt The living go-to-market wiki
readme-rewrite-draft.md readme.new.md A full README rewrite for the agent-platform positioning
pricing-page-revision-3.json website/new-pricing.json Pricing page copy, revision 3. Nothing in website/ reads it, so it is a draft
signin-redesign-handoff/ design_handoff_signin_redesign/ Sign-in redesign handoff: logos, design tokens, and a rendered comparison page

README-draft.md and signup-redesign-brief.md were already under docs/design/gtm/.

What was deliberately left out

QA run output and transient status logs are not here. The v0.105.4 regression
notes, the v0.105.5 web acceptance failures, the 17 July pull-request runway log,
the 18 July rebase sweep, and the runner self-hosting handoff (whose own title
says "LOCAL, do not commit") were moved to a local scratch folder instead. So were
69 MB of QA screenshots and recordings.

Base branch

The base is parked-notes-base, which is upstream commit 5ceca94311. That is the
commit this work was written against. Basing on the fork's main would have shown
hundreds of unrelated upstream commits in the diff.

Collects design and go-to-market material that was sitting uncommitted in the
working tree so it survives a workspace cleanup.

Design and research notes (docs/design/agent-workflows/):
- selfhost-hardening plan and the runner engine-quality roadmap
- research on client-tool delivery and concurrent human-in-the-loop approvals
- the desloppify round-two assessment
- root-cause writeups for warm-resume execution and frontend approval dispatch
- the PR Agenta-AI#5400 mounts review handoff, review report and fix brief
- the retheme hex audit and the stale positioning sweep

Go-to-market material (docs/design/gtm/), moved out of the repo root:
- the go-to-market wiki (was gtm.txt)
- the README rewrite draft (was readme.new.md)
- pricing page revision 3 (was website/new-pricing.json, unreferenced by the site)
- the sign-in redesign handoff with its logos and design tokens
@mmabrouk
mmabrouk force-pushed the docs/parked-design-and-gtm-notes branch from 4c28598 to cc7bb61 Compare July 27, 2026 19:15
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