Skip to content

Commit 5f841a8

Browse files
committed
docs: add owner next actions checklist
1 parent 75a0fde commit 5f841a8

4 files changed

Lines changed: 107 additions & 0 deletions

File tree

docs/launch/index.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -331,6 +331,7 @@ <h2 id="links">Links</h2>
331331
<li><a href="../debug-browser-agent-failure.html">Debugging walkthrough</a></li>
332332
<li><a href="press-kit.md">Press kit source</a></li>
333333
<li><a href="directory-submission-sheet.md">Directory submission sheet</a></li>
334+
<li><a href="owner-next-actions.md">Owner next actions</a></li>
334335
<li><a href="github-profile-readme.md">GitHub profile README draft</a></li>
335336
<li><a href="https://github.com/aaronlab/browsertrace/releases/tag/v0.1.10">Release v0.1.10</a></li>
336337
<li><a href="https://github.com/aaronlab/browsertrace/releases/download/v0.1.10/browsertrace-demo-public.html">Public-safe demo export</a></li>

docs/launch/metrics-log.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,3 +89,4 @@ uv run --python 3.11 python scripts/launch_metrics.py --json
8989
| 2026-05-09T12:16:00+00:00 | 3 | 998 | 0 | 0 | 10 | 0 | 4 | after good first issue opened for first-run demo troubleshooting: https://github.com/aaronlab/browsertrace/issues/14; traffic views 48/25 unique, clones 100/52 unique |
9090
| 2026-05-09T12:18:11+00:00 | 3 | 998 | 0 | 0 | 10 | 0 | 4 | after profile and good-first issues added to v0.2 milestone; traffic views 48/25 unique, clones 100/52 unique |
9191
| 2026-05-09T12:20:02+00:00 | 3 | 998 | 0 | 0 | 10 | 0 | 4 | after changelog public-safe release asset note added; traffic views 48/25 unique, clones 100/52 unique |
92+
| 2026-05-09T12:21:48+00:00 | 3 | 998 | 0 | 0 | 10 | 0 | 4 | after shortest owner next-actions checklist added; traffic views 48/25 unique, clones 100/52 unique |

docs/launch/owner-next-actions.md

Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
# BrowserTrace Owner Next Actions
2+
3+
This is the shortest owner-facing checklist. Use it when the repo is ready and
4+
the owner can perform account/login actions personally.
5+
6+
Do not ask for stars, upvotes, reposts, vote swaps, or artificial engagement.
7+
Ask for workflow feedback from people building browser agents.
8+
9+
## 1. Unblock PyPI
10+
11+
This is the highest-friction launch blocker. Public posts convert better after
12+
the install command becomes:
13+
14+
```bash
15+
pip install "browsertrace[ui]"
16+
```
17+
18+
Configure PyPI Trusted Publisher:
19+
20+
| Field | Value |
21+
|---|---|
22+
| PyPI project | `browsertrace` |
23+
| GitHub owner | `aaronlab` |
24+
| GitHub repository | `browsertrace` |
25+
| Workflow filename | `publish.yml` |
26+
| Environment name | `pypi` |
27+
28+
Then run:
29+
30+
```bash
31+
gh workflow run Publish --repo aaronlab/browsertrace
32+
```
33+
34+
Verification after publish:
35+
36+
```bash
37+
python -m pip index versions browsertrace
38+
pipx run --spec "browsertrace[ui]" browsertrace --help
39+
```
40+
41+
Tracking issue: https://github.com/aaronlab/browsertrace/issues/5
42+
43+
## 2. Fix The GitHub Profile README
44+
45+
The old public profile README repo is `aaronlab/aaronagent`, which no longer
46+
matches the renamed account. The profile README should be `aaronlab/aaronlab`.
47+
48+
Use this draft once the profile repository is available:
49+
50+
```text
51+
docs/launch/github-profile-readme.md
52+
```
53+
54+
Keep BrowserTrace as the first featured project during launch.
55+
56+
Tracking issue: https://github.com/aaronlab/browsertrace/issues/13
57+
58+
## 3. Publish Day 1 Posts
59+
60+
Use this packet:
61+
62+
```text
63+
docs/launch/day-1-publish-packet.md
64+
```
65+
66+
Recommended order:
67+
68+
1. X
69+
2. LinkedIn
70+
3. One or two relevant WeChat AI-builder groups
71+
4. Jike
72+
73+
Use `docs/demo.mp4` as primary media and `docs/demo-poster.png` as backup.
74+
75+
Tracking issue: https://github.com/aaronlab/browsertrace/issues/9
76+
77+
## 4. Submit Directories And Newsletters
78+
79+
Use:
80+
81+
```text
82+
docs/launch/directory-submission-sheet.md
83+
docs/launch/outreach-targets.md
84+
```
85+
86+
Submit once per target. Do not repeatedly submit or ask for votes.
87+
88+
Tracking issue: https://github.com/aaronlab/browsertrace/issues/10
89+
90+
## 5. Record Metrics After Each Action
91+
92+
After every public post, profile update, PyPI publish, or directory submission:
93+
94+
```bash
95+
uv run --python 3.11 python scripts/launch_metrics.py --append --note "after <action>: <URL or note>"
96+
uv run --python 3.11 python scripts/launch_metrics.py --json
97+
```
98+
99+
The goal remains incomplete until GitHub reports more than 1000 stars:
100+
101+
```bash
102+
gh repo view aaronlab/browsertrace --json stargazerCount,url,homepageUrl,owner
103+
```

docs/launch/owner-publish-queue.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,8 @@ people building browser agents.
1717
- Launch discussion: https://github.com/aaronlab/browsertrace/discussions/6
1818
- Feedback issue: https://github.com/aaronlab/browsertrace/issues/3
1919

20+
Shortest owner checklist: `docs/launch/owner-next-actions.md`
21+
2022
## Media
2123

2224
- Primary video: `docs/demo.mp4`

0 commit comments

Comments
 (0)