@dedesfr/prompter 0.9.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (225) hide show
  1. package/CHANGELOG.md +35 -0
  2. package/README.md +105 -77
  3. package/dist/cli/index.js +25 -1
  4. package/dist/cli/index.js.map +1 -1
  5. package/dist/commands/init.d.ts.map +1 -1
  6. package/dist/commands/init.js +35 -9
  7. package/dist/commands/init.js.map +1 -1
  8. package/dist/commands/login.d.ts +4 -0
  9. package/dist/commands/login.d.ts.map +1 -0
  10. package/dist/commands/login.js +56 -0
  11. package/dist/commands/login.js.map +1 -0
  12. package/dist/commands/logout.d.ts +4 -0
  13. package/dist/commands/logout.d.ts.map +1 -0
  14. package/dist/commands/logout.js +14 -0
  15. package/dist/commands/logout.js.map +1 -0
  16. package/dist/commands/update.d.ts +0 -2
  17. package/dist/commands/update.d.ts.map +1 -1
  18. package/dist/commands/update.js +19 -48
  19. package/dist/commands/update.js.map +1 -1
  20. package/dist/commands/whoami.d.ts +4 -0
  21. package/dist/commands/whoami.d.ts.map +1 -0
  22. package/dist/commands/whoami.js +42 -0
  23. package/dist/commands/whoami.js.map +1 -0
  24. package/dist/core/auth-store.d.ts +10 -0
  25. package/dist/core/auth-store.d.ts.map +1 -0
  26. package/dist/core/auth-store.js +39 -0
  27. package/dist/core/auth-store.js.map +1 -0
  28. package/dist/core/config.d.ts +0 -7
  29. package/dist/core/config.d.ts.map +1 -1
  30. package/dist/core/config.js +0 -128
  31. package/dist/core/config.js.map +1 -1
  32. package/dist/core/registry.d.ts +18 -0
  33. package/dist/core/registry.d.ts.map +1 -0
  34. package/dist/core/registry.js +94 -0
  35. package/dist/core/registry.js.map +1 -0
  36. package/package.json +7 -1
  37. package/AGENTS.md +0 -123
  38. package/CLAUDE.md +0 -17
  39. package/build.js +0 -20
  40. package/convex-setup.md +0 -403
  41. package/dist/core/prompt-templates.d.ts +0 -23
  42. package/dist/core/prompt-templates.d.ts.map +0 -1
  43. package/dist/core/prompt-templates.js +0 -3485
  44. package/dist/core/prompt-templates.js.map +0 -1
  45. package/prompt/ai-humanizer.md +0 -45
  46. package/prompt/api-contract-generator.md +0 -234
  47. package/prompt/apply.md +0 -17
  48. package/prompt/archive.md +0 -21
  49. package/prompt/design-system.md +0 -210
  50. package/prompt/document-explainer.md +0 -149
  51. package/prompt/epic-generator.md +0 -198
  52. package/prompt/epic-single.md +0 -47
  53. package/prompt/erd-generator.md +0 -130
  54. package/prompt/fsd-generator.md +0 -157
  55. package/prompt/prd-agent-generator.md +0 -147
  56. package/prompt/prd-generator.md +0 -195
  57. package/prompt/product-brief.md +0 -289
  58. package/prompt/proposal.md +0 -22
  59. package/prompt/qa-test-scenario.md +0 -133
  60. package/prompt/skill-creator.md +0 -350
  61. package/prompt/story-generator.md +0 -278
  62. package/prompt/story-single.md +0 -70
  63. package/prompt/tdd-generator.md +0 -294
  64. package/prompt/tdd-lite-generator.md +0 -224
  65. package/prompt/wireframe-generator.md +0 -219
  66. package/skills/ai-context-generator/SKILL.md +0 -54
  67. package/skills/ai-context-generator/references/AGENTS.template.md +0 -83
  68. package/skills/ai-context-generator/references/CLAUDE.template.md +0 -39
  69. package/skills/ai-context-generator/references/behavioral-guidelines.md +0 -71
  70. package/skills/ai-context-generator/references/discovery-checklist.md +0 -40
  71. package/skills/ai-context-generator/references/examples/AGENTS.good.md +0 -103
  72. package/skills/ai-context-generator/references/extraction-checklist.md +0 -23
  73. package/skills/ai-context-generator/references/overlays/laravel.md +0 -44
  74. package/skills/ai-humanizer/SKILL.md +0 -50
  75. package/skills/api-contract-generator/SKILL.md +0 -243
  76. package/skills/apply/SKILL.md +0 -23
  77. package/skills/archive/SKILL.md +0 -27
  78. package/skills/cerebro/SKILL.md +0 -187
  79. package/skills/cerebro/references/agents.md +0 -213
  80. package/skills/code-review/SKILL.md +0 -373
  81. package/skills/code-review/assets/report-template-agent.md +0 -212
  82. package/skills/code-review/assets/report-template-compact.md +0 -81
  83. package/skills/code-review/assets/report-template-full.md +0 -264
  84. package/skills/code-review/assets/report-template-human.md +0 -168
  85. package/skills/code-review/references/universal-patterns.md +0 -495
  86. package/skills/design-md/README.md +0 -34
  87. package/skills/design-md/SKILL.md +0 -172
  88. package/skills/design-md/examples/DESIGN.md +0 -154
  89. package/skills/design-system/SKILL.md +0 -216
  90. package/skills/design-system-generator/SKILL.md +0 -324
  91. package/skills/design-system-generator/assets/design-system-template.md +0 -348
  92. package/skills/design-system-generator/references/extraction-patterns.md +0 -321
  93. package/skills/doc-builder/SKILL.md +0 -115
  94. package/skills/doc-builder/references/ui-patterns.md +0 -394
  95. package/skills/document-explainer/SKILL.md +0 -155
  96. package/skills/document-translator/SKILL.md +0 -58
  97. package/skills/enhance/SKILL.md +0 -47
  98. package/skills/enhance-prompt/README.md +0 -34
  99. package/skills/enhance-prompt/SKILL.md +0 -204
  100. package/skills/enhance-prompt/references/KEYWORDS.md +0 -114
  101. package/skills/epic-generator/SKILL.md +0 -204
  102. package/skills/epic-single/SKILL.md +0 -63
  103. package/skills/erd-generator/SKILL.md +0 -138
  104. package/skills/feature-planner/SKILL.md +0 -305
  105. package/skills/feature-planner/assets/implementation-plan-template.md +0 -85
  106. package/skills/frontend-design/LICENSE.txt +0 -177
  107. package/skills/frontend-design/SKILL.md +0 -42
  108. package/skills/fsd-generator/SKILL.md +0 -163
  109. package/skills/gamma-builder/SKILL.md +0 -134
  110. package/skills/laravel-code-review/SKILL.md +0 -383
  111. package/skills/laravel-code-review/assets/report-template-agent.md +0 -195
  112. package/skills/laravel-code-review/assets/report-template-compact.md +0 -79
  113. package/skills/laravel-code-review/assets/report-template-full.md +0 -253
  114. package/skills/laravel-code-review/assets/report-template-human.md +0 -159
  115. package/skills/laravel-code-review/references/laravel-patterns.md +0 -571
  116. package/skills/laravel-code-review/references/php84-features.md +0 -442
  117. package/skills/mcp-builder/LICENSE.txt +0 -202
  118. package/skills/mcp-builder/SKILL.md +0 -236
  119. package/skills/mcp-builder/reference/evaluation.md +0 -602
  120. package/skills/mcp-builder/reference/mcp_best_practices.md +0 -249
  121. package/skills/mcp-builder/reference/node_mcp_server.md +0 -970
  122. package/skills/mcp-builder/reference/python_mcp_server.md +0 -719
  123. package/skills/mcp-builder/scripts/connections.py +0 -151
  124. package/skills/mcp-builder/scripts/evaluation.py +0 -373
  125. package/skills/mcp-builder/scripts/example_evaluation.xml +0 -22
  126. package/skills/mcp-builder/scripts/requirements.txt +0 -2
  127. package/skills/meeting-notes/SKILL.md +0 -159
  128. package/skills/meeting-notes/evals/evals.json +0 -23
  129. package/skills/prd-agent-generator/SKILL.md +0 -132
  130. package/skills/prd-generator/SKILL.md +0 -211
  131. package/skills/product-brief/SKILL.md +0 -141
  132. package/skills/project-orchestrator/SKILL.md +0 -487
  133. package/skills/project-orchestrator/assets/caddy-vps-setup.md +0 -180
  134. package/skills/project-orchestrator/assets/plan-summary-template.md +0 -159
  135. package/skills/prompter-specs/SKILL.md +0 -115
  136. package/skills/prompter-workflow/SKILL.md +0 -166
  137. package/skills/prompter-workflow/evals/evals.json +0 -89
  138. package/skills/proposal/SKILL.md +0 -28
  139. package/skills/qa-test-scenario/SKILL.md +0 -149
  140. package/skills/skill-creator/SKILL.md +0 -173
  141. package/skills/sph-generator/SKILL.md +0 -488
  142. package/skills/story-generator/SKILL.md +0 -285
  143. package/skills/story-single/SKILL.md +0 -86
  144. package/skills/tdd-generator/SKILL.md +0 -300
  145. package/skills/tdd-lite-generator/SKILL.md +0 -230
  146. package/skills/ui-ux-pro/SKILL.md +0 -199
  147. package/skills/ui-ux-pro/assets/design-spec-template.md +0 -173
  148. package/skills/ui-ux-pro/references/component-patterns.md +0 -255
  149. package/skills/ui-ux-pro/references/design-principles.md +0 -167
  150. package/skills/wireframe-generator/SKILL.md +0 -227
  151. package/src/cli/index.ts +0 -223
  152. package/src/commands/archive.ts +0 -302
  153. package/src/commands/change.ts +0 -292
  154. package/src/commands/config.ts +0 -233
  155. package/src/commands/guide.ts +0 -50
  156. package/src/commands/init.ts +0 -597
  157. package/src/commands/list.ts +0 -194
  158. package/src/commands/show.ts +0 -138
  159. package/src/commands/spec.ts +0 -251
  160. package/src/commands/update.ts +0 -129
  161. package/src/commands/upgrade.ts +0 -30
  162. package/src/commands/validate.ts +0 -326
  163. package/src/core/artifact-graph/graph.ts +0 -167
  164. package/src/core/artifact-graph/index.ts +0 -44
  165. package/src/core/artifact-graph/instruction-loader.ts +0 -302
  166. package/src/core/artifact-graph/resolver.ts +0 -226
  167. package/src/core/artifact-graph/schema.ts +0 -124
  168. package/src/core/artifact-graph/state.ts +0 -64
  169. package/src/core/artifact-graph/types.ts +0 -65
  170. package/src/core/completions/command-registry.ts +0 -382
  171. package/src/core/completions/completion-provider.ts +0 -128
  172. package/src/core/completions/generators/bash-generator.ts +0 -191
  173. package/src/core/completions/generators/fish-generator.ts +0 -188
  174. package/src/core/completions/generators/powershell-generator.ts +0 -223
  175. package/src/core/completions/generators/zsh-generator.ts +0 -281
  176. package/src/core/completions/templates/bash-templates.ts +0 -24
  177. package/src/core/completions/templates/fish-templates.ts +0 -40
  178. package/src/core/completions/templates/powershell-templates.ts +0 -25
  179. package/src/core/completions/templates/zsh-templates.ts +0 -36
  180. package/src/core/completions/types.ts +0 -90
  181. package/src/core/config-schema.ts +0 -230
  182. package/src/core/config.ts +0 -181
  183. package/src/core/configurators/slash/antigravity.ts +0 -10
  184. package/src/core/configurators/slash/base.ts +0 -109
  185. package/src/core/configurators/slash/claude.ts +0 -10
  186. package/src/core/configurators/slash/codex.ts +0 -10
  187. package/src/core/configurators/slash/droid.ts +0 -10
  188. package/src/core/configurators/slash/forge.ts +0 -10
  189. package/src/core/configurators/slash/github-copilot.ts +0 -10
  190. package/src/core/configurators/slash/index.ts +0 -10
  191. package/src/core/configurators/slash/kilocode.ts +0 -10
  192. package/src/core/configurators/slash/opencode.ts +0 -10
  193. package/src/core/configurators/slash/registry.ts +0 -51
  194. package/src/core/converters/json-converter.ts +0 -62
  195. package/src/core/global-config.ts +0 -136
  196. package/src/core/parsers/change-parser.ts +0 -234
  197. package/src/core/parsers/markdown-parser.ts +0 -237
  198. package/src/core/parsers/requirement-blocks.ts +0 -234
  199. package/src/core/prompt-templates.ts +0 -3504
  200. package/src/core/schemas/base.schema.ts +0 -20
  201. package/src/core/schemas/change.schema.ts +0 -42
  202. package/src/core/schemas/index.ts +0 -20
  203. package/src/core/schemas/spec.schema.ts +0 -17
  204. package/src/core/skill-discovery.ts +0 -68
  205. package/src/core/specs-apply.ts +0 -483
  206. package/src/core/styles/palette.ts +0 -8
  207. package/src/core/templates/agents-template.ts +0 -459
  208. package/src/core/templates/claude-template.ts +0 -2
  209. package/src/core/templates/index.ts +0 -3
  210. package/src/core/templates/project-template.ts +0 -32
  211. package/src/core/validation/constants.ts +0 -48
  212. package/src/core/validation/types.ts +0 -19
  213. package/src/core/validation/validator.ts +0 -449
  214. package/src/core/view.ts +0 -219
  215. package/src/index.ts +0 -1
  216. package/src/utils/change-metadata.ts +0 -171
  217. package/src/utils/change-utils.ts +0 -131
  218. package/src/utils/file-system.ts +0 -252
  219. package/src/utils/index.ts +0 -12
  220. package/src/utils/interactive.ts +0 -29
  221. package/src/utils/item-discovery.ts +0 -66
  222. package/src/utils/match.ts +0 -26
  223. package/src/utils/shell-detection.ts +0 -62
  224. package/src/utils/task-progress.ts +0 -43
  225. package/tsconfig.json +0 -28
@@ -1,159 +0,0 @@
1
- ---
2
- name: meeting-notes
3
- description: Transform raw meeting notes, transcripts, or informal notes into a structured, actionable to-do list ready for AI agent execution. Automatically extracts tasks, categorizes by priority and context, and formats output for direct copy-paste into Claude or other AI agents. Use this skill whenever a user pastes meeting notes, a transcript, a brain dump, or unstructured notes and wants tasks extracted — even if they just say "here are my meeting notes" or "can you turn this into tasks". Also triggers when users want to organize action items from a meeting, sync-up, standup, retrospective, or planning session.
4
- ---
5
-
6
- # Meeting Notes → Structured To-Do List
7
-
8
- Convert raw, informal meeting notes into a clean, actionable task list formatted for direct execution by an AI agent. Each output task is self-contained — the agent executing it should never need to reference the original notes.
9
-
10
- ## Step 1: Accept Input
11
-
12
- Accept notes in any format:
13
- - Pasted plain text or markdown
14
- - A file path (read the file)
15
- - A transcript with speaker labels
16
- - Bullet-pointed jottings or a brain dump
17
-
18
- If the user hasn't provided notes yet, ask: "Please paste your meeting notes or provide a file path."
19
-
20
- ---
21
-
22
- ## Step 2: Check for Project Context (If in a Repo)
23
-
24
- Before extracting tasks, check whether you're inside a project repository. This context helps align output with the project's conventions.
25
-
26
- 1. Look for `CLAUDE.md` or `prompter/CLAUDE.md` — project guidelines, naming conventions, tech stack
27
- 2. Look for `AGENTS.md` — workflow context and existing structure
28
- 3. Check for existing task files: `TODO.md`, `tasks.md`, `.taskmaster/`, or similar
29
- 4. Run `git log --oneline -10` to understand current work in flight
30
-
31
- Use this context to:
32
- - Align task titles with project conventions (e.g., `feat(auth):` prefixes, snake_case names)
33
- - Flag tasks that likely duplicate existing in-progress work
34
- - Reference specific files or modules from the repo when the notes mention them
35
-
36
- If no repo context is found, proceed with general formatting.
37
-
38
- ---
39
-
40
- ## Step 3: Extract Tasks
41
-
42
- Scan the notes for everything that implies work to be done.
43
-
44
- **Extract these:**
45
- - Explicit action items: "we need to…", "John will…", "TODO:", "action item:"
46
- - Decisions requiring implementation: "we decided to X — someone needs to build it"
47
- - Open questions needing resolution: "TBD", "to figure out", "need to check"
48
- - Implicit commitments: "before the release", "I'll handle it", "by next week"
49
-
50
- **Skip these:**
51
- - Background context with no next step
52
- - Already-completed work: "we shipped X last week"
53
- - Opinions with no concrete follow-through
54
-
55
- For each task, capture:
56
- - **Title** — short imperative verb phrase: "Set up CI pipeline for mobile builds"
57
- - **Description** — what needs to happen, with enough context for execution without the notes
58
- - **Owner** — who's responsible (leave blank if not mentioned)
59
- - **Priority** — see Priority Guide below
60
- - **Category** — see Categories below
61
- - **Due date** — only if explicitly mentioned
62
-
63
- ### Priority Guide
64
-
65
- | Priority | Signals |
66
- |----------|---------|
67
- | **High** | "blocker", "urgent", "ASAP", "before launch", "critical", deadline within ~1 week |
68
- | **Medium** | "should", "this sprint", "next week", general items with no urgency signal |
69
- | **Low** | "nice to have", "eventually", "backlog", "when we get to it", open questions with no deadline |
70
-
71
- ### Categories
72
-
73
- Choose the best fit:
74
- - **Development** — coding, implementation, bug fixes
75
- - **Design** — UI/UX, wireframes, visual assets
76
- - **Research** — investigation, spikes, discovery
77
- - **DevOps/Infra** — CI/CD, deployments, infrastructure
78
- - **Product** — requirements, roadmap, stakeholder decisions
79
- - **Testing/QA** — test writing, QA passes, review
80
- - **Documentation** — docs, READMEs, guides
81
- - **Communication** — follow-up emails, meetings to schedule
82
- - **Admin/Other** — anything else
83
-
84
- ---
85
-
86
- ## Step 4: Format Output
87
-
88
- Produce two blocks.
89
-
90
- ### Block 1: Summary Table
91
-
92
- A markdown table for quick scanning:
93
-
94
- ```
95
- | # | Task | Owner | Priority | Category | Due |
96
- |---|------|-------|----------|----------|-----|
97
- | 1 | Set up CI pipeline for mobile builds | @alice | High | DevOps/Infra | Mar 22 |
98
- | 2 | ... |
99
- ```
100
-
101
- ### Block 2: AI-Agent-Ready Task List
102
-
103
- Each task as a standalone, copy-pasteable prompt block. The goal is that someone can paste any single block directly into an AI agent and it will know exactly what to do — no additional context needed.
104
-
105
- Use this template for each task:
106
-
107
- ---
108
-
109
- **TASK [N] · [Priority] · [Category]**
110
- **[Title]**
111
-
112
- > **Context:** [1–2 sentences explaining why this task exists and what decision or discussion led to it]
113
-
114
- **What to do:**
115
- - [Concrete imperative step 1]
116
- - [Concrete imperative step 2]
117
- - [Add more as needed]
118
-
119
- **Assignee:** [owner or "Unassigned"]
120
- **Due:** [date or "Not specified"]
121
-
122
- ---
123
-
124
- **Writing good task blocks — the key principles:**
125
- - The title is an imperative verb phrase, not a noun phrase ("Fix the auth bug" not "Auth bug fix")
126
- - The Context block carries the *why*, so the agent understands the goal, not just the mechanics
127
- - "What to do" steps are concrete and specific — name files, tools, systems, and outputs by name when the notes mention them
128
- - Self-contained means: no pronouns without antecedents, no references to "the meeting", no unexplained abbreviations
129
-
130
- ---
131
-
132
- ## Step 5: Validate Against Project Context (If Applicable)
133
-
134
- If you gathered project context in Step 2, do a final pass before printing output:
135
-
136
- 1. **Naming alignment** — rewrite task titles to match project conventions
137
- 2. **Duplicate detection** — if a task matches something in git history or existing task files, flag it: `⚠️ Possible duplicate: [reference]`
138
- 3. **File/module references** — replace vague references ("the auth module") with actual repo paths when you can identify them
139
- 4. **Missing context** — if a task needs project knowledge not present in the notes, flag it: `ℹ️ Context needed: [what's unclear]`
140
-
141
- ---
142
-
143
- ## Step 6: Present and Offer to Save
144
-
145
- 1. Print the Summary Table
146
- 2. Print the AI-Agent-Ready Task List
147
- 3. Offer to save to a file (default: `meeting-tasks-YYYY-MM-DD.md`)
148
-
149
- If the user wants changes — reordering, reprioritization, a missing task, merging two tasks — iterate quickly.
150
-
151
- ---
152
-
153
- ## Edge Cases
154
-
155
- - **No clear tasks found** — Tell the user and ask whether to extract implicit decisions or discussion points that might need follow-up
156
- - **Very long meeting (many items)** — Ask if they want to filter by owner, topic, or priority tier
157
- - **Ambiguous owner** — Write "Unassigned"; never guess
158
- - **Conflicting priority signals** — Use the most urgent signal
159
- - **Non-English notes** — Process and output in the same language
@@ -1,23 +0,0 @@
1
- {
2
- "skill_name": "meeting-notes-to-todo",
3
- "evals": [
4
- {
5
- "id": 1,
6
- "prompt": "hey can you turn these into a task list?\n\n---\nProduct sync – March 18 2026\nAttendees: Sarah (PM), Dev (backend), Mia (design), Tom (QA)\n\nWe talked about the upcoming v2.1 release. Launch is March 28.\n\n- Sarah said the onboarding flow redesign needs to be done before we release. Mia is handling the wireframes, needs to be done by March 21 so dev can implement.\n- Dev mentioned the payment webhook is still broken on sandbox. He'll fix it this week, it's a blocker.\n- Tom hasn't started regression testing yet – needs to start by March 24 at the latest or we'll miss the launch window.\n- We need to write release notes before launch. Sarah said she'll draft them but needs input from dev on what changed technically.\n- Someone (nobody claimed it) needs to update the docs for the new API endpoints. Mia suggested we do a quick loom video too.\n- The analytics dashboard is broken in Safari – not a launch blocker but should be fixed soon. Dev will look into it after the release.\n- Sarah wants a go/no-go meeting on March 26. She'll send the invite.\n---\n\ncan you make each task ready to paste into claude so it can do the work?",
7
- "expected_output": "A summary table with all 7+ tasks, each with owner, priority, and due date where specified. Followed by individual AI-agent-ready task blocks — each self-contained with context, concrete steps, assignee, and due date. High priority on the payment webhook fix and Mia's wireframes due to blockers/deadline. Go/no-go meeting invite should be a Communication task.",
8
- "files": []
9
- },
10
- {
11
- "id": 2,
12
- "prompt": "here are my notes from today's backend team standup, can you extract the action items and make a proper todo list?\n\nStandup notes 3/18:\n- alice: finished auth refactor PR, waiting on review from bob. also discovered that the session token TTL logic has a bug where it doesn't handle timezone offsets correctly — filed issue #847\n- bob: reviewing alice's PR today. blocked on the redis cluster upgrade because ops team hasn't provisioned the new nodes yet. bob will ping ops (jake) about it\n- carol: working on the data export feature. the CSV generation is done, still need to wire up the S3 upload and add retry logic. estimates 2 more days\n- team decision: we're going to use structured logging (pino) across all new services starting now. carol will add it to the data export service as she finishes. alice will document the convention in the backend README\n- also need to add integration tests for the auth refactor before it can merge — bob mentioned this\n- reminder: sprint review is friday, everyone should have their items demoed or marked done",
13
- "expected_output": "A clean task list covering: reviewing alice's PR (bob, high), pinging ops about redis nodes (bob, medium), finishing S3 upload + retry logic for data export (carol, medium), adding pino structured logging to data export service (carol, medium), documenting logging convention in README (alice, medium), adding integration tests for auth refactor (medium, before merge), preparing sprint review items (friday deadline). Summary table plus AI-agent-ready blocks with clear context.",
14
- "files": []
15
- },
16
- {
17
- "id": 3,
18
- "prompt": "I just got out of a long planning session, my brain is fried. here are my rough notes — lots of things mixed together, some things were just discussed but a few are actual todos. can you sort it all out and give me a clean task list formatted so I can paste each task into claude to work on?\n\n=== planning session notes ===\ntalked about Q2 roadmap. main themes: retention, performance, mobile parity\n\nretention:\n- churn is at 8% which is bad. need to understand why. -> spike: analyze churn data from mixpanel, look at cohorts from jan-mar. who's churning and at what point in lifecycle?\n- idea: add email drip campaign for users who haven't logged in for 7 days. not sure if this is the right move. needs product sign-off from lisa\n- subscription cancellation page — we should add a \"pause instead of cancel\" option. this one is approved and prioritized. design + dev work needed.\n\nperformance:\n- homepage loads in 4.2s on mobile, goal is sub-2s. jake looked at it and thinks it's the hero image and 3 blocking JS scripts. -> optimize hero image (webp, lazy load) and defer non-critical JS\n- database query for user feed is N+1, has been on the backlog forever. now it's causing timeouts on accounts with >1000 connections. urgent fix needed.\n- CDN caching headers are wrong, static assets are being re-fetched every request. quick fix, someone just needs to do it\n\nmobile:\n- ios app is missing the notifications tab that android has. 3 sprints of work estimated.\n- push notifications are broken on ios 17.4+ (regression from last month). super urgent, lots of user complaints\n- android: dark mode looks bad on samsung devices specifically (OLED screens). medium priority, aesthetic issue\n\nother:\n- we never documented the data retention policy after legal asked us to. someone needs to write that doc. probably high priority given compliance.\n- offsite planning in april, need to book venue\n===",
19
- "expected_output": "Should separate actual tasks from pure discussion. High-priority items: fix N+1 query, fix iOS push notification regression, write data retention policy doc. Medium: optimize homepage performance, fix CDN caching, pause-vs-cancel feature (design + dev). Low/research: churn analysis spike, email drip campaign (needs sign-off), Samsung dark mode fix. Long-horizon: iOS notifications tab (3 sprints), book offsite venue. Each task should be clearly scoped as an AI-agent-ready block with context and concrete steps.",
20
- "files": []
21
- }
22
- ]
23
- }
@@ -1,132 +0,0 @@
1
- ---
2
- name: prd-agent-generator
3
- description: Generate a PRD with autonomous assumptions (non-interactive mode)
4
- ---
5
-
6
- # PRD Generator (Non-Interactive Mode)
7
-
8
- Create detailed Product Requirements Documents that are clear, actionable, and suitable for implementation based solely on the user's initial input.
9
-
10
- ---
11
-
12
- ## The Job
13
-
14
- 1. Receive a feature description from the user
15
- 2. Analyze the input and make reasonable assumptions where details are missing
16
- 3. Generate a structured PRD based on the input
17
-
18
- ---
19
-
20
- ## Handling Ambiguity
21
-
22
- When the user's input lacks specific details:
23
-
24
- - **Make reasonable assumptions** based on common patterns and best practices
25
- - **Document assumptions** in the PRD under "Assumptions Made"
26
- - **Flag critical unknowns** in the "Open Questions" section
27
- - **Err on the side of MVP scope** when scope is unclear
28
- - **Default to standard patterns** (e.g., CRUD operations, standard UI components)
29
-
30
- ---
31
-
32
- ## PRD Structure
33
-
34
- Generate the PRD with these sections:
35
-
36
- ### 1. Introduction/Overview
37
- Brief description of the feature and the problem it solves.
38
-
39
- ### 2. Assumptions Made
40
- List key assumptions made due to missing details in the original request:
41
- - "Assumed target users are [X] based on feature context"
42
- - "Assumed MVP scope since no specific scope mentioned"
43
- - "Assumed standard authentication is already in place"
44
-
45
- ### 3. Goals
46
- Specific, measurable objectives (bullet list).
47
-
48
- ### 4. User Stories
49
- Each story needs:
50
- - **Title:** Short descriptive name
51
- - **Description:** "As a [user], I want [feature] so that [benefit]"
52
- - **Acceptance Criteria:** Verifiable checklist of what "done" means
53
-
54
- Each story should be small enough to implement in one focused session.
55
-
56
- **Format:**
57
- ```markdown
58
- ### US-001: [Title]
59
- **Description:** As a [user], I want [feature] so that [benefit].
60
-
61
- **Acceptance Criteria:**
62
- - [ ] Specific verifiable criterion
63
- - [ ] Another criterion
64
- - [ ] Typecheck/lint passes
65
- - [ ] **[UI stories only]** Verify in browser using dev-browser skill
66
- ```
67
-
68
- **Important:**
69
- - Acceptance criteria must be verifiable, not vague. "Works correctly" is bad. "Button shows confirmation dialog before deleting" is good.
70
- - **For any story with UI changes:** Always include "Verify in browser using dev-browser skill" as acceptance criteria. This ensures visual verification of frontend work.
71
-
72
- ### 5. Functional Requirements
73
- Numbered list of specific functionalities:
74
- - "FR-1: The system must allow users to..."
75
- - "FR-2: When a user clicks X, the system must..."
76
-
77
- Be explicit and unambiguous.
78
-
79
- ### 6. Non-Goals (Out of Scope)
80
- What this feature will NOT include. Critical for managing scope.
81
-
82
- ### 7. Design Considerations (Optional)
83
- - UI/UX requirements
84
- - Link to mockups if available
85
- - Relevant existing components to reuse
86
-
87
- ### 8. Technical Considerations (Optional)
88
- - Known constraints or dependencies
89
- - Integration points with existing systems
90
- - Performance requirements
91
-
92
- ### 9. Success Metrics
93
- How will success be measured?
94
- - "Reduce time to complete X by 50%"
95
- - "Increase conversion rate by 10%"
96
-
97
- ### 10. Open Questions
98
- Remaining questions or areas needing clarification. This is where you document:
99
- - Critical unknowns that affect implementation
100
- - Areas where the original request was ambiguous
101
- - Decisions that may need stakeholder input
102
-
103
- ---
104
-
105
- ## Writing for Junior Developers
106
-
107
- The PRD reader may be a junior developer or AI agent. Therefore:
108
-
109
- - Be explicit and unambiguous
110
- - Avoid jargon or explain it
111
- - Provide enough detail to understand purpose and core logic
112
- - Number requirements for easy reference
113
- - Use concrete examples where helpful
114
-
115
- ---
116
-
117
- ## Output
118
-
119
- - **Format:** Markdown (`.md`)
120
-
121
- ---
122
-
123
- ## WORKFLOW STEPS
124
- 1. Read the user's input about the feature
125
- 2. Generate a unique, URL-friendly slug from the feature name (lowercase, hyphen-separated)
126
- 3. Create the directory `prompter/<slug>/` if it doesn't exist
127
- 4. Generate the complete PRD following all requirements above
128
- 5. Save the PRD to `prompter/<slug>/prd-agent.md`
129
- 6. Report the saved file path
130
-
131
- ## REFERENCE
132
- - Read `prompter/project.md` for project context if needed
@@ -1,211 +0,0 @@
1
- ---
2
- name: prd-generator
3
- description: Generate a comprehensive Product Requirements Document (PRD)
4
- ---
5
-
6
- # Role & Expertise
7
- You are an experienced Product Manager specializing in creating comprehensive Product Requirements Documents (PRDs). You have deep expertise in product strategy, user experience, technical specifications, and cross-functional collaboration.
8
-
9
- ---
10
-
11
- # Primary Objective
12
- Generate a complete, professional Product Requirements Document (PRD) that clearly defines a product or feature's purpose, scope, requirements, and success criteria. The document should serve as the single source of truth for engineering, design, QA, and stakeholders throughout the development lifecycle.
13
-
14
- # Context
15
- You will receive information about a product or feature that needs documentation. This may include:
16
- - A brief description of the feature/product idea
17
- - Problem statements or user pain points
18
- - Business objectives or goals
19
- - Target users or market information
20
- - Technical constraints or considerations
21
- - Success metrics or KPIs
22
-
23
- Your task is to transform this input into a structured, comprehensive PRD following the standard format below.
24
-
25
- # Process
26
-
27
- ## Step 1: Information Extraction
28
- Analyze the provided information and identify:
29
- - Core problem being solved
30
- - Target users and their needs
31
- - Business objectives and constraints
32
- - Technical requirements or dependencies
33
- - Success criteria and metrics
34
- - Scope boundaries (what's included and excluded)
35
-
36
- ## Step 2: Document Structure
37
- Organize the PRD using this exact structure:
38
-
39
- ### Overview Section
40
- - Feature/Product name
41
- - Target release timeline
42
- - Team assignments (PO, Designers, Tech, QA)
43
-
44
- ### Background Section
45
- - Context: Why this product/feature is needed
46
- - Current state with supporting metrics
47
- - Problem statement with impact analysis
48
- - Current workarounds (if any)
49
-
50
- ### Objectives Section
51
- - Business objectives (3-5 specific, measurable goals)
52
- - User objectives (how users benefit)
53
-
54
- ### Success Metrics Section
55
- - Primary and secondary metrics in table format
56
- - Current baseline, target values, measurement methods, timelines
57
-
58
- ### Scope Section
59
- - MVP 1 goals and deliverables
60
- - In-scope features (with ✅)
61
- - Out-of-scope items (with ❌ and reasoning)
62
- - Future iterations roadmap
63
-
64
- ### User Flow Section
65
- - Main user journey from start to success
66
- - Alternative flows and error handling
67
- - Edge cases
68
-
69
- ### User Stories Section
70
- - Stories in table format with ID, description, acceptance criteria, platform
71
- - Use Given-When-Then format for acceptance criteria
72
-
73
- ### Analytics Section
74
- - Event tracking requirements
75
- - Trigger definitions and parameters
76
- - JSON-formatted event structures
77
-
78
- ## Step 3: Quality Enhancement
79
- Ensure the document includes:
80
- - Specific, actionable requirements (avoid vague language)
81
- - Clear acceptance criteria for all user stories
82
- - Measurable success metrics with baselines and targets
83
- - Realistic scope boundaries
84
- - Comprehensive error handling and edge cases
85
-
86
- ## Step 4: Finalization
87
- Add supporting sections:
88
- - Open Questions table for unresolved items
89
- - Technical and business considerations
90
- - Migration notes (if applicable)
91
- - References and glossary
92
-
93
- # Input Specifications
94
- Provide information about your product/feature including:
95
- - **Product/Feature Name**: What you're building
96
- - **Problem**: What user/business problem this solves
97
- - **Target Users**: Who will use this
98
- - **Key Features**: Main capabilities or functionality
99
- - **Business Goals**: What success looks like
100
- - **Constraints**: Technical, timeline, or resource limitations (optional)
101
- - **Additional Context**: Any other relevant information
102
-
103
- # Output Requirements
104
-
105
- **Format:** Markdown document with clear hierarchy
106
-
107
- **Required Sections:**
108
- 1. Overview (with metadata table)
109
- 2. Quick Links (template placeholders)
110
- 3. Background (Context + Problem Statement)
111
- 4. Objectives (Business + User)
112
- 5. Success Metrics (table format)
113
- 6. Scope (MVP breakdown with in/out scope)
114
- 7. User Flow (visual flow diagram)
115
- 8. User Stories (detailed table)
116
- 9. Analytics & Tracking (event tracking table)
117
- 10. Open Questions (tracking table)
118
- 11. Notes & Considerations
119
- 12. Appendix (References + Glossary)
120
-
121
- **Style Guidelines:**
122
- - Professional, clear, and actionable language
123
- - Use tables for structured data (metrics, user stories, analytics)
124
- - Use checkmarks (✅) for in-scope, X marks (❌) for out-of-scope
125
- - Include placeholder links for design, technical specs, and project management tools
126
- - Use Given-When-Then format for acceptance criteria
127
- - Include JSON examples for analytics events
128
- - Number user stories with US-## format
129
-
130
- **Document Characteristics:**
131
- - Comprehensive yet scannable
132
- - Specific and measurable requirements
133
- - Clear boundaries between MVP phases
134
- - Ready for immediate use by engineering, design, and QA teams
135
-
136
- # Quality Standards
137
-
138
- Before finalizing, verify:
139
- - [ ] All sections are complete with relevant content
140
- - [ ] Success metrics have baseline, target, and measurement method
141
- - [ ] User stories have clear acceptance criteria
142
- - [ ] Scope clearly defines what is and isn't included
143
- - [ ] Analytics events are properly structured with JSON format
144
- - [ ] Tables are properly formatted and complete
145
- - [ ] Technical and business considerations are addressed
146
- - [ ] Document is professional and free of ambiguity
147
-
148
- # Special Instructions
149
-
150
- **When Information Is Limited:**
151
- - Make intelligent assumptions based on common product patterns
152
- - Include placeholder text in [brackets] for missing details
153
- - Add notes indicating where stakeholder input is needed
154
- - Provide examples in parentheses to guide completion
155
-
156
- **For Technical Products:**
157
- - Include additional technical considerations section
158
- - Add API documentation and technical spec placeholders
159
- - Specify system integration points
160
-
161
- **For Consumer Products:**
162
- - Emphasize user experience and flows
163
- - Include detailed analytics tracking
164
- - Focus on conversion metrics and user engagement
165
-
166
- **Formatting Rules:**
167
- - Use markdown tables for all structured data
168
- - Maintain consistent heading hierarchy (##, ###)
169
- - Use code blocks for user flows and JSON examples
170
- - Include horizontal rules (---) between major sections
171
-
172
- # Example Input Format
173
-
174
- "Create a PRD for [Feature Name]: [Brief description]. This will solve [Problem] for [Target Users]. Key features include [Feature 1], [Feature 2], [Feature 3]. Success will be measured by [Metric]. We need this by [Timeline]."
175
-
176
- # Example User Story Format
177
-
178
- | ID | User Story | Acceptance Criteria | Design | Notes | Platform | JIRA Ticket |
179
- |----|------------|---------------------|--------|-------|----------|-------------|
180
- | US-01 | As a returning user, I want to see my purchase history so that I can reorder items quickly | **Given** I'm logged into my account<br>**When** I navigate to "My Orders"<br>**Then** I see my last 10 orders sorted by date<br>**And** each order shows items, date, and total<br>**And** I can click "Reorder" on any item | [Figma link] | Cache for performance | iOS/Android/Web | PROJ-123 |
181
-
182
- # Example Analytics Event Format
183
-
184
- ```json
185
- {
186
- "Trigger": "Click",
187
- "TriggerValue": "Checkout Button",
188
- "Page": "Shopping Cart",
189
- "Data": {
190
- "CartValue": 149.99,
191
- "ItemCount": 3,
192
- "UserSegment": "Premium"
193
- },
194
- "Description": "User initiates checkout from cart page"
195
- }
196
- ```
197
-
198
- ---
199
-
200
- **Deliver the complete PRD immediately upon receiving product/feature information. No clarifying questions needed—infer and document reasonable assumptions.**
201
-
202
- ## WORKFLOW STEPS
203
- 1. Read the user's input about the product/feature
204
- 2. Generate a unique, URL-friendly slug from the feature name (lowercase, hyphen-separated)
205
- 3. Create the directory `prompter/<slug>/` if it doesn't exist
206
- 4. Generate the complete PRD following all requirements above
207
- 5. Save the PRD to `prompter/<slug>/prd.md`
208
- 6. Report the saved file path
209
-
210
- ## REFERENCE
211
- - Read `prompter/project.md` for project context if needed
@@ -1,141 +0,0 @@
1
- ---
2
- name: product-brief
3
- description: Generate an executive-level product brief (1-page summary)
4
- ---
5
-
6
- # Role & Expertise
7
- You are a Senior Product Manager with 15+ years of experience crafting executive-level product briefs for Fortune 500 companies. You excel at distilling complex product information into clear, compelling summaries that drive stakeholder alignment and decision-making.
8
-
9
- # Context
10
- You are creating a Product Brief (Executive Summary) - a comprehensive, visually-rich document that communicates the essential elements of a product to executives, investors, and cross-functional stakeholders. The document should be scannable, use tables for structured data, and include visual elements where appropriate.
11
-
12
- # Primary Objective
13
- Generate a polished, professional Product Brief that captures the essence of the product in a format suitable for executive review, board presentations, or investor communications.
14
-
15
- # Input Required
16
- Provide any combination of the following:
17
- - Product name and description
18
- - Target market/customer segment
19
- - Problem being solved
20
- - Key features or capabilities
21
- - Business model/pricing approach
22
- - Competitive landscape
23
- - Current status/stage
24
- - Key metrics or traction (if available)
25
- - Strategic goals
26
- - Technical stack (if applicable)
27
- - User roles
28
-
29
- *Note: Work with whatever information is provided; make reasonable inferences for gaps while flagging assumptions.*
30
-
31
- # Output Format
32
-
33
- The output should follow this comprehensive structure:
34
-
35
- ## 1. Header Section
36
- ```markdown
37
- # [PRODUCT NAME]
38
- ## Executive Summary
39
-
40
- **[One-line tagline describing what the product is]**
41
-
42
- ---
43
-
44
- ## At a Glance
45
-
46
- | | |
47
- | ----------------- | ---------------------------------------- |
48
- | **Product Type** | [Category/type of product] |
49
- | **Target Market** | [Primary target market/segment] |
50
- | **Platform** | [Web/Mobile/Desktop/API/etc.] |
51
- | **Technology** | [Key technology stack - if applicable] |
52
- | **Status** | [Current development/market status] |
53
- ```
54
-
55
- ## 2. Product Overview
56
- - "What is [Product Name]?" section with 2-3 sentences
57
- - "The Problem We Solve" table (Challenge | Impact)
58
- - "Our Solution" with ASCII flow diagram
59
-
60
- ## 3. Core Capabilities
61
- - Numbered sections (1️⃣, 2️⃣, 3️⃣, etc.) with bullet points
62
- - Typically 3-6 capability categories
63
-
64
- ## 4. Key Benefits
65
- - Table format with emoji icons (⏱️, ✅, 📊, 🔐, 📁, 🔄)
66
- - Benefit name | Description
67
-
68
- ## 5. User Roles Supported
69
- - Table: Role | Primary Functions
70
-
71
- ## 6. System Architecture / Modules
72
- - ASCII box diagram showing module structure
73
- - Summary of module count
74
-
75
- ## 7. Infrastructure Highlights
76
- - Bullet points with bold headers
77
-
78
- ## 8. Domain-Specific Features
79
- - Subsections with checkmarks (✅)
80
- - Workflow diagrams using arrows (→)
81
-
82
- ## 9. Dashboard / Analytics
83
- - Table: Widget | Purpose
84
-
85
- ## 10. Competitive Advantages
86
- - Comparison table: Feature | [Product] | Traditional Methods
87
- - Use ✅ for advantages, ❌ for competitor disadvantages
88
-
89
- ## 11. Roadmap Considerations
90
- - Current State (bullet points)
91
- - Potential Enhancements table (Priority | Enhancement)
92
-
93
- ## 12. Technical Foundation
94
- - Table: Component | Choice | Why
95
-
96
- ## 13. Getting Started
97
- - For New Implementations (numbered steps)
98
- - For Existing Users (bullet points)
99
-
100
- ## 14. Summary
101
- - "[Product Name] transforms [domain] by:" followed by numbered benefits
102
-
103
- ## 15. Document Information
104
- - Table with Version, Date, Classification, Full Specification reference
105
-
106
- # Writing Standards
107
- - **Tone:** Confident, data-informed, strategic
108
- - **Length:** Comprehensive but scannable (typically 200-400 lines)
109
- - **Language:** Executive-friendly, minimal jargon
110
- - **Visuals:** Use tables for structured data, ASCII diagrams for flows/architecture
111
- - **Icons:** Use emoji icons (⏱️, ✅, 📊, 🔐, 📁, 🔄, 1️⃣, 2️⃣, etc.) to improve scannability
112
- - **Checkmarks:** Use ✅ for features/advantages, ❌ for competitor disadvantages
113
-
114
- # Quality Criteria
115
- 1. A busy executive can understand the product in under 5 minutes
116
- 2. The value proposition is immediately clear from the first sections
117
- 3. Tables make data comparison easy and quick to scan
118
- 4. Visual diagrams help explain system architecture and workflows
119
- 5. Competitive positioning is explicit and easy to understand
120
- 6. Technical and non-technical stakeholders can both extract value
121
-
122
- # Special Instructions
123
- - If information is incomplete, make reasonable assumptions and mark with [ASSUMPTION] or use placeholder text like [TBD]
124
- - Prioritize clarity over comprehensiveness
125
- - Lead with impact, not features
126
- - Use active voice and strong verbs
127
- - Avoid superlatives without supporting data
128
- - If competitive information is sparse, focus on unique value rather than comparisons
129
- - Adapt section headers to match the product domain (e.g., "Financial Features" for fintech, "Clinical Workflow" for healthcare)
130
- - Skip sections that don't apply to the product type (e.g., "Technical Foundation" for non-software products)
131
-
132
- ## WORKFLOW STEPS
133
- 1. Read the user's input about the product
134
- 2. Generate a unique, URL-friendly slug from the product name (lowercase, hyphen-separated)
135
- 3. Create the directory \`prompter/<slug>/\` if it doesn't exist
136
- 4. Generate the complete Product Brief following all requirements above
137
- 5. Save the Product Brief to \`prompter/<slug>/product-brief.md\`
138
- 6. Report the saved file path
139
-
140
- ## REFERENCE
141
- - Read \`prompter/project.md\` for project context if needed