|
1 | 1 | --- |
2 | 2 | name: "Agent Idea" |
3 | | -about: Suggest an agent concept for others to build |
| 3 | +about: Suggest an agent idea for others to build |
4 | 4 | title: "[Agent] <agent name>" |
5 | 5 | labels: ["agent-idea"] |
6 | 6 | --- |
7 | 7 |
|
8 | | -**If you like this idea, vote with a 👍 reaction on this issue.** |
| 8 | +_If this idea excites you, vote with a 👍 so the community knows it’s worth building._ |
9 | 9 |
|
10 | | ---- |
11 | | - |
12 | | -## 1. What it does (1–2 sentences) |
13 | | -Describe the core idea and why it is interesting. |
| 10 | +### 1. What it does |
| 11 | +Give a short description of the agent and why it’s interesting (1–2 sentences). |
14 | 12 |
|
15 | | -_Example:_ |
16 | | -A Q&A Builder that watches Slack and Discord, detects new questions, retrieves answers from project docs, and proposes new Q&A entries for review. |
17 | | - |
18 | | ---- |
| 13 | +_Example: A Q&A Builder that watches Slack and Discord, spots new questions, retrieves answers from project docs, and proposes new Q&A entries for review._ |
19 | 14 |
|
20 | | -## 2. Why this is valuable |
| 15 | +### 2. Why this is valuable |
| 16 | +Explain the motivation: |
21 | 17 | - What problem does it solve? |
22 | | -- Who benefits from it? |
| 18 | +- Who benefits from it? |
23 | 19 |
|
24 | | -_Example:_ |
25 | | -Repeated questions across channels, answers drifting from the docs, and no central Q&A database. |
| 20 | +_Example: Teams repeat answers across channels, answers drift from the docs, and there’s no central Q&A source of truth._ |
26 | 21 |
|
27 | | ---- |
28 | | - |
29 | | -## 3. How it behaves |
| 22 | +### 3. How it behaves |
| 23 | +Describe how the agent works in practice: |
30 | 24 | - Triggers (when does it run?) |
31 | 25 | - Inputs (what does it look at?) |
32 | 26 | - Outputs (what does it produce?) |
33 | | -- Human in the loop? (optional) |
34 | | - |
35 | | -_Example:_ |
36 | | -Trigger when a new message ends with a question mark. Retrieve context from docs. Draft answer. Send to a reviewer if confidence is low. |
| 27 | +- Human in the loop? |
37 | 28 |
|
38 | | ---- |
39 | | - |
40 | | -## 4. What the agent needs access to |
41 | | -List the key sources or tools it relies on. |
| 29 | +_Example: Trigger when a message ends with a question mark. Retrieve context from docs. Draft an answer. Send to a reviewer if confidence is low._ |
42 | 30 |
|
43 | | -_Examples:_ |
44 | | -- Slack channels |
45 | | -- Discord channels |
46 | | -- Docs folder |
47 | | -- GitHub issues |
48 | | -- Knowledge base entries |
| 31 | +### 4. What the agent needs access to |
| 32 | +List the main sources, tools, or systems the agent depends on. |
49 | 33 |
|
50 | | ---- |
| 34 | +_Examples: Slack channels, Discord channels, Docs folder, GitHub issues, Knowledge base entries_ |
51 | 35 |
|
52 | | -## 5. Rough architecture (very high level) |
53 | | -Bullet points or simple diagrams are fine. |
| 36 | +### 5. Rough architecture (very high level) |
| 37 | +Share the big picture. Bullet points or simple diagrams are perfect. |
54 | 38 |
|
55 | | -_Example:_ |
56 | | -- Detect question |
57 | | -- Retrieve context |
58 | | -- Draft answer with citations |
59 | | -- Send to review |
60 | | -- Publish to Q&A database |
| 39 | +_Example: Detect question → Retrieve context → Draft answer with citations → Send to review → Publish to Q&A database_ |
61 | 40 |
|
62 | | ---- |
| 41 | +### 6. Open questions |
| 42 | +List anything that’s intentionally unscoped or needs discussion. |
63 | 43 |
|
64 | | -## 6. Open questions |
65 | | -Anything intentionally unscoped or still under consideration. |
66 | | - |
67 | | -_Example:_ |
68 | | -Should outdated Q&A items be auto-detected and refreshed? |
69 | | - |
70 | | ---- |
| 44 | +_Example: Should outdated Q&A items be auto-detected and refreshed?_ |
71 | 45 |
|
72 | | -## 7. Who could build this? |
73 | | -(Optional) Tag people or teams who might pick it up. |
| 46 | +### 7. Who could build this? |
| 47 | +(Optional) Tag people or teams who might be excited to take this on. |
0 commit comments