Skip to content

Commit f17dce4

Browse files
committed
docs: client-section rhetoric fix — no 'we didn't build skills', no Zed affiliation
- #cli: drop the 'Agent skills' negative row; add a positive Skills paragraph pointing at the online catalog and inviting PRs - #what: rename to 'Client', frame crow-cli as ACP-speaking (any client works), offer the odellus/zed fork as preferred client with an explicit no-affiliation-with-Zed-Industries statement - trim stale table rows; rewrite meta description Session-Id: industrious-gay-phoenix-of-plenty
1 parent aa20c06 commit f17dce4

3 files changed

Lines changed: 74 additions & 16 deletions

File tree

‎PLAN.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,3 +78,17 @@ Trajectory: 1 → 2 → 3 → 4, in order.
7878
~/.agents/crow/prompts/system_prompt.jinja2, 2 new unit tests (138 total pass);
7979
3.3 llms.txt Docs section generated from site-src tree.
8080
- 4.x commits + push + live verification follow below.
81+
82+
## Phase 5 — landing rhetoric fix (2026-08-11, post-ship user feedback)
83+
84+
5.1 index.html `#cli`: remove "Agent skills" neg-table row; add positive Skills paragraph
85+
(catalog /docs/skills/, /llms.txt, open-a-PR pointer → crow-cli/crow-cli.github.io).
86+
5.2 index.html `#what`: rename to "Client" (h2 + nav label); rewrite intro — ACP = LSP for
87+
agents, any ACP client works (link get-started/clients registry), preferred = our Zed
88+
fork odellus/zed + /docs/zed/, explicit no-affiliation disclaimer; drop Sidex/VS-Code
89+
rows, keep Transparent/Cancellable/Orchestration.
90+
5.3 Verify: rg checks (no skills-under-didn't-build, no unintended zed/sidex/vscode refs);
91+
curl -o /dev/null -w "%{http_code}" every new href (clients page, odellus/zed, /docs/zed/,
92+
/docs/skills/, /llms.txt, crow-cli.github.io repo).
93+
5.4 Commit (Session-Id trailer) + push; poll deploy workflow; curl live landing and grep for
94+
the new copy ("no affiliation", "Open a PR").

‎TODO.md‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,3 +59,35 @@ User mandate (verbatim):
5959

6060
- `crow-cli skills sync` / init-clones-monorepo code: deferred in favor of the prompt-based
6161
llms.txt bootstrap (user's stated lean). Docs describe the clone step manually.
62+
63+
## Follow-up 2026-08-11 — post-ship user feedback (landing rhetoric)
64+
65+
User mandate (verbatim gist): we totally built skills — excise the "didn't build skills"
66+
rhetoric, point to the online skills, "open a PR to add to them today". And the Client
67+
section must not be named Zed: call it Client, link agentclientprotocol.com's clients page,
68+
offer our zed fork as preferred client, stress NO affiliation with Zed — it is just one of
69+
many ACP clients on the market.
70+
71+
- [ ] `#cli` section: delete the "Agent skills" row from the "What we didn't build" table;
72+
add a positive Skills block → catalog at /docs/skills/, machine-readable /llms.txt,
73+
"Open a PR to add to them today" linking crow-cli/crow-cli.github.io.
74+
Verify: `rg -n "Agent skills|didn't build" index.html` — only 3 legit neg rows remain.
75+
- [ ] `#what` section: h2 "Crow ADE" → "Client"; nav label "Crow ADE" → "Client". Copy:
76+
crow-cli speaks ACP (LSP for agents) and runs in ANY ACP client (link
77+
https://agentclientprotocol.com/get-started/clients); preferred client = our Zed fork
78+
(https://github.com/odellus/zed, /docs/zed/ setup guide); explicit no-affiliation-with-
79+
Zed-Industries disclaimer. Drop the stale Sidex/VS-Code-fork table rows (keep
80+
Transparent / Cancellable / Orchestration).
81+
Verify: `rg -in "zed|sidex|vs code" index.html` shows only intended mentions; hrefs 200.
82+
- [ ] Commit + push (Session-Id trailer); deploy workflow green; live landing shows new copy.
83+
84+
85+
BUG REPORT:
86+
87+
got a
88+
```
89+
Internal error: {
90+
"error": "memory error 413: Failed to buffer the request body: length limit exceeded"
91+
}
92+
```
93+
from the agent after calling read_image_file.

‎index.html‎

Lines changed: 28 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<meta charset="UTF-8">
55
<meta name="viewport" content="width=device-width, initial-scale=1.0">
66
<title>Crow ADE — multi-agent editor with shared memory and orchestration</title>
7-
<meta name="description" content="Crow ADE runs multiple AI agents in one native editor. Agents share a database, read each other's memory, and coordinate over ACP extension tools. Built on SideX.">
7+
<meta name="description" content="crow-cli is a stateful ACP-native coding agent with shared memory and orchestration. Runs in any ACP client — free and open source.">
88
<meta name="color-scheme" content="dark">
99
<meta property="og:type" content="website">
1010
<meta property="og:site_name" content="Crow ADE">
@@ -26,7 +26,7 @@
2626
</button>
2727
<div class="menu-links" id="site-menu-links" hidden>
2828
<a class="nav-link" href="#cli"><code>crow-cli</code></a>
29-
<a class="nav-link" href="#what">Crow ADE</a>
29+
<a class="nav-link" href="#what">Client</a>
3030
<a class="nav-link" href="#install">Install</a>
3131
<a class="nav-link" href="#orchestration">Orchestration</a>
3232
<a class="nav-link" href="#observability">Observability</a>
@@ -63,38 +63,50 @@ <h3>What we didn't build</h3>
6363
<td class="neg-item">Offline agent</td>
6464
<td class="neg-why">Every agent has <code>web_search</code> and <code>web_fetch</code> and is prompted to use them liberally.</td>
6565
</tr>
66-
<tr>
67-
<td class="neg-item">Agent skills</td>
68-
<td class="neg-why">Agents are never offline and are encouraged to take whatever they need from the internet. Once a task is accomplished, it's a few memory tool calls away from being reinjected into any session context. No static skill packages.</td>
69-
</tr>
7066
</tbody>
7167
</table>
68+
<h3>Skills</h3>
69+
<p>
70+
We ship a public skill catalog — reusable, versioned workflows that every agent can
71+
fetch and install on demand. Browse it at
72+
<a class="inline" href="/docs/skills/">crow-ai.dev/docs/skills</a> or start from the
73+
machine-readable index at <a class="inline" href="/llms.txt"><code>/llms.txt</code></a>;
74+
an agent with an empty skill directory is prompted to pull exactly what the task needs.
75+
Got a workflow worth sharing?
76+
<a class="inline" href="https://github.com/crow-cli/crow-cli.github.io" target="_blank" rel="noopener">Open a PR</a>
77+
to add to them today.
78+
</p>
7279
</section>
7380

7481

7582
<section id="what" class="snap-section">
7683
<div class="kicker">Client</div>
77-
<h2>Crow ADE</h2>
84+
<h2>Client</h2>
7885
<p>
79-
Crow is an Agent Development Environment built on top of <a href="https://github.com/crow-cli/crow-cli" class="inline" target="_blank" rel="noopener"><code>crow-cli</code></a> and <a href="https://github.com/Sidenai/sidex" target="_blank" rel="noopener" class="inline">Sidex</a> made for concurrent agent orchestration.
86+
<code>crow-cli</code> speaks the
87+
<a class="inline" href="https://agentclientprotocol.com" target="_blank" rel="noopener">Agent Client Protocol</a>
88+
— LSP for agents. That means it runs in
89+
<a class="inline" href="https://agentclientprotocol.com/get-started/clients" target="_blank" rel="noopener">any ACP client</a>,
90+
so bring whichever editor you already live in.
91+
</p>
92+
<p>
93+
Our preferred client is our fork of
94+
<a class="inline" href="https://github.com/odellus/zed" target="_blank" rel="noopener">Zed</a>
95+
(<a class="inline" href="/docs/zed/">setup guide</a>).
96+
To be abundantly clear: <strong>we have no affiliation with Zed Industries</strong>.
97+
Zed is an independent open-source editor, and our fork is just one of many ACP
98+
clients on the market — we borrowed their editor and wired our agent into it.
8099
</p>
81100
<table class="neg-table">
82101
<tbody>
83102
<tr>
84103
<td class="neg-item">Transparent</td>
85-
<td class="neg-why">Every agent works in the open. Tool calls, thinking, and decisions are all rendered live in the editor</td>
104+
<td class="neg-why">Every agent works in the open. Tool calls, thinking, and decisions are all rendered live in the editor.</td>
86105
</tr>
87106
<tr>
88107
<td class="neg-item">Cancellable</td>
89108
<td class="neg-why">Fine-grained supervision and control through cancellation.</td>
90109
</tr>
91-
<tr>
92-
<td class="neg-item">Agent Client Protocol</td>
93-
<td class="neg-why">ACP is LSP for agents, so we built an ACP client into a fork of VS Code.</td>
94-
<tr>
95-
<td class="neg-item">VS Code ecosystem</td>
96-
<td class="neg-why">Same editor, same terminal, same language servers.</td>
97-
</tr>
98110
<tr>
99111
<td class="neg-item">Orchestration</td>
100112
<td class="neg-why">Conditional loop engineering. Agents manage their own task loops, delegate to other agents, and control exit conditions — theirs and others'.</td>

0 commit comments

Comments
 (0)