Commit2afb411unknown_key
docs(help): document the new AI-native flow surfaces
docs(help): document the new AI-native flow surfaces The /help page documented the gate runs + AI reviewer pipeline but never mentioned the AI-native UX features users now have direct access to. Adds a new "AI-native flow" section with five panels: - Issue → PR in one click (Build with AI button + Closes #N footer) - AI-drafted PR descriptions (Suggest description with AI button) - Auto-review on PR open (summary + inline + AI Triage) - Repo-wide AI surfaces (Explain · Ask · Spec · Tests · semantic search) with the ANTHROPIC_API_KEY graceful-degrade note - Scheduled workflows (cron via on: schedule) Linked from the on-this-page nav at the top. Reachable without auth (softAuth only) so first-time visitors see what they're getting. https://claude.ai/code/session_0163vJChUuZqqtBBznUW6xBU
1 file changed+59−02afb411638f643d7c9015119a302a60008aa0b2f
1 changed file+59−0
Modifiedsrc/routes/help.tsx+59−0View fileUnifiedSplit
@@ -44,6 +44,7 @@ help.get("/help", (c) => {
4444 <a href="#webhooks">Webhooks</a> ·{" "}
4545 <a href="#tokens">Personal access tokens</a> ·{" "}
4646 <a href="#gates">Gates & AI review</a> ·{" "}
47 <a href="#ai-native">AI-native flow</a> ·{" "}
4748 <a href="#shortcuts">Keyboard shortcuts</a> ·{" "}
4849 <a href="#api">API</a>
4950 </nav>
@@ -264,6 +265,64 @@ help.get("/help", (c) => {
264265 </div>
265266 </section>
266267
268 <section id="ai-native" style="margin-bottom: 32px">
269 <h2 style="margin-bottom: 12px; font-size: 20px">
270 AI-native flow
271 </h2>
272 <div class="panel">
273 <div class="panel-item">
274 <div>
275 <strong>Issue → PR in one click.</strong> Open any issue you
276 own and hit <em>Build with AI</em> in the header. The spec
277 form pre-fills with the issue title + body and a{" "}
278 <code>Closes #N</code> footer; Claude drafts the diff, opens
279 a draft PR, and the merge auto-closes the originating issue.
280 </div>
281 </div>
282 <div class="panel-item">
283 <div>
284 <strong>AI-drafted PR descriptions.</strong> The new-PR form
285 has a <em>Suggest description with AI</em> button that runs
286 <code> generatePrSummary</code> against{" "}
287 <code>git diff base...head</code> and fills the description
288 with a structured summary (Why · Key changes · Test plan ·
289 Risks).
290 </div>
291 </div>
292 <div class="panel-item">
293 <div>
294 <strong>Auto-review on PR open.</strong> Non-draft PRs get a
295 summary comment plus inline file/line annotations from the
296 AI reviewer. A second comment posts label + reviewer +
297 priority suggestions (the <em>AI Triage</em> block). All
298 suggestions; nothing applied automatically.
299 </div>
300 </div>
301 <div class="panel-item">
302 <div>
303 <strong>Repo-wide AI surfaces.</strong>{" "}
304 <a href="/help#explore">Explain</a> a codebase, run{" "}
305 <a href="/help#explore">semantic search</a>, ask the chat
306 anything about the repo, generate failing test stubs from a
307 source file (the <em>Tests</em> link in the repo nav), and
308 draft full PRs from a plain-English spec via{" "}
309 <em>Spec to PR</em>. All require{" "}
310 <code>ANTHROPIC_API_KEY</code>; without it the surfaces
311 degrade gracefully to deterministic fallbacks.
312 </div>
313 </div>
314 <div class="panel-item">
315 <div>
316 <strong>Scheduled workflows.</strong> Drop{" "}
317 <code>on: schedule: [{`{cron: "0 * * * *"}`}]</code> into any
318 <code> .gluecron/workflows/*.yml</code>. The autopilot
319 ticker fires the cron from the same node that handles your
320 pushes — no external scheduler needed.
321 </div>
322 </div>
323 </div>
324 </section>
325
267326 <section id="shortcuts" style="margin-bottom: 32px">
268327 <h2 style="margin-bottom: 12px; font-size: 20px">
269328 Keyboard shortcuts
270329