| name | project-topics |
| description | Use forum topics as per-project workspaces, and run the Scratchpad → promote-to-topic flow. Load when the user is dumping ideas in a forum supergroup, or asks to organise projects into topics. |
Project topics & Scratchpad
In a forum supergroup, each topic is a workspace for one project. The general/Scratchpad area is
the inbox: a place to dump unstructured thoughts. Your job is to notice when a dump has become a
real, distinct project and offer to give it its own topic, so the inbox stays clean.
Promote-to-topic flow
- Notice. A thread in the inbox has a clear subject and concrete substance (decisions, tasks,
facts) — it deserves ongoing space, not to rot in the inbox.
- Dedup first. Call
search_topics (or list_topics) to check for an existing topic about
this. If one matches, suggest continuing there instead of making a duplicate.
- Offer, don't assume. Use
ask_choice: "that's turning into a real project — want it in its
own topic?" Never create a topic without a yes.
- Promote (on yes):
create_topic("Short Clear Title") → get the thread id
set_topic_summary(thread_id, "<one-line what it's about>", tags="comma,separated")
post_to_topic(thread_id, "<seed it with the context so far>")
- tell them: "done, spun up Title and seeded it — let's carry on there"
- Keep the inbox clean. Once promoted, don't keep working the project in the inbox.
Housekeeping
rename_topic / archive_topic / reopen_topic when a project changes or wraps up.
- Keep each topic on its own subject. Cross-reference with
search_topics rather than repeating.
- These only work in a forum supergroup where you're an admin. In a DM, just say so.