CHATBOTS
Answer in Slack, then file a Linear doc-gap ticket on miss
Answers a Slack /askdocs question from ReadMe, and when no page adequately covers the topic.
How it runs
The automated pipeline, trigger to output.
- TriggerSlack /askdocs slash command receivedSlack
- ActionSearch ReadMe for candidate pagesReadMe
- ActionJudge coverage and draft answer or gap briefOpenAI
- LogicBranch on coverage verdict (answered vs gap)
- ActionCreate Linear doc-gap ticket on missLinear
- OutputReply in Slack with answer and ticket noteSlack
What it does
Responds to a `/askdocs` Slack command using your ReadMe content, then closes the loop on missing documentation. When retrieval shows the question isn't well covered, it creates a Linear issue in your docs project containing the original question, the closest existing pages, and an LLM-drafted outline of what the new or updated doc should say.
When to use it
When you want your docs backlog to be driven by real unanswered questions instead of guesswork. Every time the bot can't confidently answer, your writers get a concrete, prioritized ticket.
How it works
- 1Slack sends the `/askdocs` payload to the webhook endpoint.
- 2ReadMe search returns the closest candidate pages.
- 3OpenAI judges coverage and writes either a cited answer or a doc-gap brief.
- 4A logic branch routes on the coverage verdict.
- 5On a miss, a Linear ticket is created with the question and suggested doc outline.
- 6The bot replies in Slack with the best-effort answer and notes the ticket.
Set it up
What you configure once, before turning it on.
- 1Connect SlackChannels, DMs, threads, mentions.
- 2Connect ReadMeAPI docs, changelog, auth.
- 3Connect OpenAIModels, embeddings, files.
- 4Connect LinearIssues, projects, cycles, triage.
- 5Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
- 6Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
- 7Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.
More Chatbots workflows
Discord WAF False-Positive Triage from Ray ID
When a user posts a Cloudflare ray ID in a Discord support channel, the bot looks up the blocked request's WAF event, classifies whether it looks like a genuine false positive.
Agentic WAF Investigator with Discord Approval Gate
An autonomous agent investigates a Discord-reported WAF block end to end: pulls Cloudflare logs, correlates with PagerDuty incidents, decides if an allowlist is safe.
Discord Onboarding Completion to CRM Sync
The moment a member finishes Discord onboarding, captures their submitted profile answers, creates or updates a contact in HubSpot.
Draft WAF Allowlist Proposal to Linear from Discord Report
Lets a support engineer confirm a Discord WAF report is a false positive, then auto-drafts a scoped Cloudflare allowlist rule proposal and files it as a Linear ticket…
Discord FAQ Free-Text Answer Grader
When a member submits a free-text answer in their onboarding thread, an agent grades it against the canonical FAQ knowledge base, replies with targeted feedback.
Discord FAQ-Gated Role Concierge
Greets each new Discord member in a private onboarding thread, walks them through required FAQ steps one at a time.
Run it inside a business
This workflow drops into a full company template. Import the org, and this is one of the playbooks its agents run.
Run this workflow in your colony.
14-day trial. No DevOps. No Sales call. Provisioned in under a minute.