agemon 0.1.0 → 6.3.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.
- package/README.md +983 -30
- package/assets/skills/architecture/agemon-architecture/LICENSE +21 -0
- package/assets/skills/architecture/agemon-architecture/NOTICE.md +9 -0
- package/assets/skills/architecture/agemon-architecture/SKILL.md +275 -0
- package/assets/skills/code-quality/agemon-clean-code/LICENSE +21 -0
- package/assets/skills/code-quality/agemon-clean-code/NOTICE.md +9 -0
- package/assets/skills/code-quality/agemon-clean-code/SKILL.md +78 -0
- package/assets/skills/code-quality/agemon-house-rules/SKILL.md +103 -0
- package/assets/skills/commit/agemon-commit/SKILL.md +87 -0
- package/assets/skills/design/agemon-design/LICENSE +21 -0
- package/assets/skills/design/agemon-design/NOTICE.md +43 -0
- package/assets/skills/design/agemon-design/SKILL.md +128 -0
- package/assets/skills/design/agemon-design/references/accessibility.md +182 -0
- package/assets/skills/design/agemon-design/references/actions.md +215 -0
- package/assets/skills/design/agemon-design/references/ai-chat.md +158 -0
- package/assets/skills/design/agemon-design/references/brief.md +190 -0
- package/assets/skills/design/agemon-design/references/color.md +216 -0
- package/assets/skills/design/agemon-design/references/components.md +91 -0
- package/assets/skills/design/agemon-design/references/copy.md +300 -0
- package/assets/skills/design/agemon-design/references/core-rules.md +166 -0
- package/assets/skills/design/agemon-design/references/craft-intent.md +162 -0
- package/assets/skills/design/agemon-design/references/dashboard.md +131 -0
- package/assets/skills/design/agemon-design/references/dataviz.md +197 -0
- package/assets/skills/design/agemon-design/references/finish-bar.md +243 -0
- package/assets/skills/design/agemon-design/references/forms.md +192 -0
- package/assets/skills/design/agemon-design/references/heuristics.md +319 -0
- package/assets/skills/design/agemon-design/references/inspiration.md +287 -0
- package/assets/skills/design/agemon-design/references/layout.md +236 -0
- package/assets/skills/design/agemon-design/references/loops.md +155 -0
- package/assets/skills/design/agemon-design/references/metadata.md +98 -0
- package/assets/skills/design/agemon-design/references/modern-css.md +448 -0
- package/assets/skills/design/agemon-design/references/motion.md +434 -0
- package/assets/skills/design/agemon-design/references/personas.md +206 -0
- package/assets/skills/design/agemon-design/references/preset-dashboard.md +109 -0
- package/assets/skills/design/agemon-design/references/preset-editorial.md +94 -0
- package/assets/skills/design/agemon-design/references/preset-minimal.md +93 -0
- package/assets/skills/design/agemon-design/references/principles-catalog.md +299 -0
- package/assets/skills/design/agemon-design/references/recipe-auth.md +88 -0
- package/assets/skills/design/agemon-design/references/recipe-dashboard.md +130 -0
- package/assets/skills/design/agemon-design/references/recipe-landing.md +120 -0
- package/assets/skills/design/agemon-design/references/responsive.md +168 -0
- package/assets/skills/design/agemon-design/references/review.md +340 -0
- package/assets/skills/design/agemon-design/references/routing.md +143 -0
- package/assets/skills/design/agemon-design/references/sound.md +150 -0
- package/assets/skills/design/agemon-design/references/spec.md +123 -0
- package/assets/skills/design/agemon-design/references/stack.md +522 -0
- package/assets/skills/design/agemon-design/references/stage-assets.md +106 -0
- package/assets/skills/design/agemon-design/references/stage-build.md +46 -0
- package/assets/skills/design/agemon-design/references/stage-critique.md +34 -0
- package/assets/skills/design/agemon-design/references/stage-directions.md +44 -0
- package/assets/skills/design/agemon-design/references/stage-intake.md +34 -0
- package/assets/skills/design/agemon-design/references/stage-verify.md +44 -0
- package/assets/skills/design/agemon-design/references/state-design.md +188 -0
- package/assets/skills/design/agemon-design/references/tells-2026-11.md +32 -0
- package/assets/skills/design/agemon-design/references/themes.md +233 -0
- package/assets/skills/design/agemon-design/references/third-party-licenses.md +323 -0
- package/assets/skills/design/agemon-design/references/tokens.md +350 -0
- package/assets/skills/design/agemon-design/references/typography.md +248 -0
- package/assets/skills/design/agemon-design/scripts/audit-page.js +532 -0
- package/assets/skills/design/agemon-design/scripts/check-source.mjs +358 -0
- package/assets/skills/design/agemon-design/scripts/deal.mjs +231 -0
- package/assets/skills/design/agemon-design/scripts/inventory.mjs +676 -0
- package/assets/skills/essentials/web-design-guidelines/LICENSE +21 -0
- package/assets/skills/essentials/web-design-guidelines/NOTICE.md +14 -0
- package/assets/skills/essentials/web-design-guidelines/SKILL.md +18 -0
- package/assets/skills/essentials/web-design-guidelines/references/guidelines.md +184 -0
- package/assets/skills/essentials/writing-guidelines/LICENSE +21 -0
- package/assets/skills/essentials/writing-guidelines/NOTICE.md +14 -0
- package/assets/skills/essentials/writing-guidelines/SKILL.md +18 -0
- package/assets/skills/essentials/writing-guidelines/references/guidelines.md +250 -0
- package/assets/skills/founder/agemon-founder-board/LICENSE +21 -0
- package/assets/skills/founder/agemon-founder-board/NOTICE.md +11 -0
- package/assets/skills/founder/agemon-founder-board/SKILL.md +111 -0
- package/assets/skills/founder/agemon-founder-board/lenses.md +84 -0
- package/assets/skills/founder/agemon-founder-brand/LICENSE +21 -0
- package/assets/skills/founder/agemon-founder-brand/NOTICE.md +12 -0
- package/assets/skills/founder/agemon-founder-brand/SKILL.md +77 -0
- package/assets/skills/founder/agemon-founder-cfo/LICENSE +21 -0
- package/assets/skills/founder/agemon-founder-cfo/NOTICE.md +12 -0
- package/assets/skills/founder/agemon-founder-cfo/SKILL.md +109 -0
- package/assets/skills/founder/agemon-founder-cfo/example.json +27 -0
- package/assets/skills/founder/agemon-founder-cfo/unit_economics.py +270 -0
- package/assets/skills/founder/agemon-founder-competitors/LICENSE +21 -0
- package/assets/skills/founder/agemon-founder-competitors/NOTICE.md +12 -0
- package/assets/skills/founder/agemon-founder-competitors/SKILL.md +84 -0
- package/assets/skills/founder/agemon-founder-consumer/LICENSE +21 -0
- package/assets/skills/founder/agemon-founder-consumer/NOTICE.md +11 -0
- package/assets/skills/founder/agemon-founder-consumer/SKILL.md +126 -0
- package/assets/skills/founder/agemon-founder-consumer/customer.example.json +34 -0
- package/assets/skills/founder/agemon-founder-consumer/panel.py +424 -0
- package/assets/skills/founder/agemon-founder-consumer/pitch.example.md +3 -0
- package/assets/skills/founder/agemon-founder-launch/LICENSE +21 -0
- package/assets/skills/founder/agemon-founder-launch/NOTICE.md +11 -0
- package/assets/skills/founder/agemon-founder-launch/SKILL.md +65 -0
- package/assets/skills/founder/agemon-founder-marketing/LICENSE +21 -0
- package/assets/skills/founder/agemon-founder-marketing/NOTICE.md +11 -0
- package/assets/skills/founder/agemon-founder-marketing/SKILL.md +80 -0
- package/assets/skills/founder/agemon-founder-offer/LICENSE +21 -0
- package/assets/skills/founder/agemon-founder-offer/NOTICE.md +11 -0
- package/assets/skills/founder/agemon-founder-offer/SKILL.md +75 -0
- package/assets/skills/founder/agemon-founder-ops/LICENSE +21 -0
- package/assets/skills/founder/agemon-founder-ops/NOTICE.md +12 -0
- package/assets/skills/founder/agemon-founder-ops/SKILL.md +77 -0
- package/assets/skills/founder/agemon-founder-plan/LICENSE +21 -0
- package/assets/skills/founder/agemon-founder-plan/NOTICE.md +11 -0
- package/assets/skills/founder/agemon-founder-plan/SKILL.md +88 -0
- package/assets/skills/founder/agemon-founder-plan/compile.py +178 -0
- package/assets/skills/founder/agemon-founder-pricing/LICENSE +21 -0
- package/assets/skills/founder/agemon-founder-pricing/NOTICE.md +12 -0
- package/assets/skills/founder/agemon-founder-pricing/SKILL.md +92 -0
- package/assets/skills/founder/agemon-founder-pricing/van_westendorp.py +172 -0
- package/assets/skills/geo-seo/geo/LICENSE +21 -0
- package/assets/skills/geo-seo/geo/NOTICE.md +18 -0
- package/assets/skills/geo-seo/geo/SKILL.md +145 -0
- package/assets/skills/geo-seo/geo-audit/LICENSE +21 -0
- package/assets/skills/geo-seo/geo-audit/NOTICE.md +17 -0
- package/assets/skills/geo-seo/geo-audit/SKILL.md +371 -0
- package/assets/skills/geo-seo/geo-audit/references/ai-visibility.md +233 -0
- package/assets/skills/geo-seo/geo-audit/references/content.md +329 -0
- package/assets/skills/geo-seo/geo-audit/references/platform-analysis.md +294 -0
- package/assets/skills/geo-seo/geo-audit/references/schema.md +383 -0
- package/assets/skills/geo-seo/geo-audit/references/technical.md +368 -0
- package/assets/skills/geo-seo/geo-brand-mentions/LICENSE +21 -0
- package/assets/skills/geo-seo/geo-brand-mentions/NOTICE.md +15 -0
- package/assets/skills/geo-seo/geo-brand-mentions/SKILL.md +459 -0
- package/assets/skills/geo-seo/geo-citability/LICENSE +21 -0
- package/assets/skills/geo-seo/geo-citability/NOTICE.md +14 -0
- package/assets/skills/geo-seo/geo-citability/SKILL.md +320 -0
- package/assets/skills/geo-seo/geo-content/LICENSE +21 -0
- package/assets/skills/geo-seo/geo-content/NOTICE.md +14 -0
- package/assets/skills/geo-seo/geo-content/SKILL.md +352 -0
- package/assets/skills/geo-seo/geo-crawlers/LICENSE +21 -0
- package/assets/skills/geo-seo/geo-crawlers/NOTICE.md +15 -0
- package/assets/skills/geo-seo/geo-crawlers/SKILL.md +388 -0
- package/assets/skills/geo-seo/geo-llmstxt/LICENSE +21 -0
- package/assets/skills/geo-seo/geo-llmstxt/NOTICE.md +14 -0
- package/assets/skills/geo-seo/geo-llmstxt/SKILL.md +433 -0
- package/assets/skills/geo-seo/geo-platform-optimizer/LICENSE +21 -0
- package/assets/skills/geo-seo/geo-platform-optimizer/NOTICE.md +14 -0
- package/assets/skills/geo-seo/geo-platform-optimizer/SKILL.md +282 -0
- package/assets/skills/geo-seo/geo-report/LICENSE +21 -0
- package/assets/skills/geo-seo/geo-report/NOTICE.md +14 -0
- package/assets/skills/geo-seo/geo-report/SKILL.md +406 -0
- package/assets/skills/geo-seo/geo-report-pdf/LICENSE +21 -0
- package/assets/skills/geo-seo/geo-report-pdf/NOTICE.md +20 -0
- package/assets/skills/geo-seo/geo-report-pdf/SKILL.md +153 -0
- package/assets/skills/geo-seo/geo-report-pdf/templates/geo-report-template.html +548 -0
- package/assets/skills/geo-seo/geo-schema/LICENSE +21 -0
- package/assets/skills/geo-seo/geo-schema/NOTICE.md +16 -0
- package/assets/skills/geo-seo/geo-schema/SKILL.md +396 -0
- package/assets/skills/geo-seo/geo-technical/LICENSE +21 -0
- package/assets/skills/geo-seo/geo-technical/NOTICE.md +15 -0
- package/assets/skills/geo-seo/geo-technical/SKILL.md +566 -0
- package/assets/skills/output-style/agemon-adhd/LICENSE +21 -0
- package/assets/skills/output-style/agemon-adhd/NOTICE.md +13 -0
- package/assets/skills/output-style/agemon-adhd/SKILL.md +138 -0
- package/assets/skills/performance/agemon-performance/NOTICE.md +1 -0
- package/assets/skills/performance/agemon-performance/SKILL.md +76 -0
- package/assets/skills/security/agemon-security/LICENSE +21 -0
- package/assets/skills/security/agemon-security/NOTICE.md +8 -0
- package/assets/skills/security/agemon-security/SKILL.md +356 -0
- package/assets/skills/security/agemon-security-audit/AI-AND-LLM.md +83 -0
- package/assets/skills/security/agemon-security-audit/ATTACK-CLASSES.md +130 -0
- package/assets/skills/security/agemon-security-audit/CLIENT-SIDE.md +83 -0
- package/assets/skills/security/agemon-security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
- package/assets/skills/security/agemon-security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
- package/assets/skills/security/agemon-security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
- package/assets/skills/security/agemon-security-audit/HUNTING.md +251 -0
- package/assets/skills/security/agemon-security-audit/LICENSE +21 -0
- package/assets/skills/security/agemon-security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
- package/assets/skills/security/agemon-security-audit/NOTICE.md +12 -0
- package/assets/skills/security/agemon-security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
- package/assets/skills/security/agemon-security-audit/RECONNAISSANCE.md +156 -0
- package/assets/skills/security/agemon-security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
- package/assets/skills/security/agemon-security-audit/SKILL.md +192 -0
- package/assets/skills/security/agemon-security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
- package/assets/skills/security/agemon-security-audit/VALIDATION-AND-REPORTING.md +186 -0
- package/assets/skills/security/agemon-security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
- package/assets/skills/security/agemon-security-audit/report-schema.json +461 -0
- package/assets/skills/security/agemon-security-audit/validate-coverage-ledger.cjs +872 -0
- package/assets/skills/security/agemon-security-audit/validate-findings.cjs +773 -0
- package/assets/skills/self-review/agemon-review-intake/LICENSE +21 -0
- package/assets/skills/self-review/agemon-review-intake/NOTICE.md +9 -0
- package/assets/skills/self-review/agemon-review-intake/SKILL.md +205 -0
- package/assets/skills/self-review/agemon-review-request/LICENSE +21 -0
- package/assets/skills/self-review/agemon-review-request/NOTICE.md +9 -0
- package/assets/skills/self-review/agemon-review-request/SKILL.md +104 -0
- package/assets/skills/self-review/agemon-review-request/code-reviewer.md +188 -0
- package/assets/skills/self-review/agemon-root-cause/LICENSE +21 -0
- package/assets/skills/self-review/agemon-root-cause/NOTICE.md +10 -0
- package/assets/skills/self-review/agemon-root-cause/SKILL.md +283 -0
- package/assets/skills/self-review/agemon-root-cause/condition-based-waiting-example.ts +158 -0
- package/assets/skills/self-review/agemon-root-cause/condition-based-waiting.md +115 -0
- package/assets/skills/self-review/agemon-root-cause/defense-in-depth.md +122 -0
- package/assets/skills/self-review/agemon-root-cause/find-polluter.sh +72 -0
- package/assets/skills/self-review/agemon-root-cause/root-cause-tracing.md +169 -0
- package/assets/skills/self-review/agemon-root-cause/test-academic.md +14 -0
- package/assets/skills/self-review/agemon-root-cause/test-pressure-1.md +58 -0
- package/assets/skills/self-review/agemon-root-cause/test-pressure-2.md +68 -0
- package/assets/skills/self-review/agemon-root-cause/test-pressure-3.md +69 -0
- package/assets/skills/self-review/agemon-verify-before-done/LICENSE +21 -0
- package/assets/skills/self-review/agemon-verify-before-done/NOTICE.md +9 -0
- package/assets/skills/self-review/agemon-verify-before-done/SKILL.md +120 -0
- package/assets/skills/team-lead/agemon-plan-rfc/SKILL.md +317 -0
- package/assets/skills/team-lead/prd-generator/SKILL.md +437 -0
- package/assets/skills/team-lead/skill-headofit-audit/SKILL.md +72 -0
- package/assets/skills/team-lead/skill-incident-rca/SKILL.md +66 -0
- package/assets/skills/team-lead/skill-meeting-lifecycle/SKILL.md +63 -0
- package/assets/skills/team-lead/skill-obsidian-vault-sync/SKILL.md +69 -0
- package/assets/skills/team-lead/skill-prd-decomposer/SKILL.md +71 -0
- package/assets/skills/team-lead/skill-sec-check/SKILL.md +70 -0
- package/assets/skills/team-lead/skill-task-extractor/SKILL.md +79 -0
- package/assets/skills/team-lead/skill-tech-spike/SKILL.md +57 -0
- package/assets/skills/team-lead/skill-techlead-reviewer/SKILL.md +81 -0
- package/assets/skills/workflow/agemon-brainstorming/LICENSE +21 -0
- package/assets/skills/workflow/agemon-brainstorming/NOTICE.md +14 -0
- package/assets/skills/workflow/agemon-brainstorming/SKILL.md +287 -0
- package/assets/skills/workflow/agemon-brainstorming/builder-check-prompt.md +23 -0
- package/assets/skills/workflow/agemon-dispatching-parallel-agents/LICENSE +21 -0
- package/assets/skills/workflow/agemon-dispatching-parallel-agents/NOTICE.md +13 -0
- package/assets/skills/workflow/agemon-dispatching-parallel-agents/SKILL.md +167 -0
- package/assets/skills/workflow/agemon-executing-plans/LICENSE +21 -0
- package/assets/skills/workflow/agemon-executing-plans/NOTICE.md +15 -0
- package/assets/skills/workflow/agemon-executing-plans/SKILL.md +322 -0
- package/assets/skills/workflow/agemon-executing-plans/scripts/task-done +55 -0
- package/assets/skills/workflow/agemon-executing-plans/scripts/task-start +32 -0
- package/assets/skills/workflow/agemon-finishing-a-development-branch/LICENSE +21 -0
- package/assets/skills/workflow/agemon-finishing-a-development-branch/NOTICE.md +13 -0
- package/assets/skills/workflow/agemon-finishing-a-development-branch/SKILL.md +225 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/LICENSE +21 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/NOTICE.md +15 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/SKILL.md +339 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/code-reviewer.md +198 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/implementer-prompt.md +154 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/re-review-prompt.md +116 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/references/batching.md +11 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/references/cannot-verify.md +10 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/references/final-review.md +49 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/references/fix-loop.md +77 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/references/handling-reports.md +15 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/references/preflight.md +26 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/references/resuming.md +12 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/references/role-scout.md +18 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/references/role-worker.md +19 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/scripts/review-package +64 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/scripts/sdd-repo +54 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/scripts/sdd-workspace +110 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/scripts/task-brief +108 -0
- package/assets/skills/workflow/agemon-subagent-driven-development/task-reviewer-prompt.md +209 -0
- package/assets/skills/workflow/agemon-test-driven-development/LICENSE +21 -0
- package/assets/skills/workflow/agemon-test-driven-development/NOTICE.md +14 -0
- package/assets/skills/workflow/agemon-test-driven-development/SKILL.md +330 -0
- package/assets/skills/workflow/agemon-test-driven-development/writing-good-tests.md +198 -0
- package/assets/skills/workflow/agemon-using-git-worktrees/LICENSE +21 -0
- package/assets/skills/workflow/agemon-using-git-worktrees/NOTICE.md +13 -0
- package/assets/skills/workflow/agemon-using-git-worktrees/SKILL.md +167 -0
- package/assets/skills/workflow/agemon-writing-plans/LICENSE +21 -0
- package/assets/skills/workflow/agemon-writing-plans/NOTICE.md +13 -0
- package/assets/skills/workflow/agemon-writing-plans/SKILL.md +204 -0
- package/assets/tools/code-review-graph-constraints.txt +1418 -0
- package/assets/tools/package-lock.json +111 -0
- package/assets/tools/package.json +6 -0
- package/dist/chunk-ZZBF3GOV.js +3451 -0
- package/dist/chunk-ZZBF3GOV.js.map +1 -0
- package/dist/fake-subprocess-IV4ML77S.js +636 -0
- package/dist/fake-subprocess-IV4ML77S.js.map +1 -0
- package/dist/index.js +23836 -1945
- package/dist/index.js.map +1 -1
- package/package.json +37 -17
|
@@ -0,0 +1,437 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: prd-generator
|
|
3
|
+
description: Generate comprehensive Product Requirements Documents (PRDs) for product managers. Use this skill when users ask to "create a PRD", "write product requirements", "document a feature", or need help structuring product specifications.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# PRD Generator
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
Generate comprehensive, well-structured Product Requirements Documents (PRDs) that follow industry best practices. This skill helps product managers create clear, actionable requirements documents that align stakeholders and guide development teams.
|
|
11
|
+
|
|
12
|
+
## Core Workflow
|
|
13
|
+
|
|
14
|
+
When a user requests to create a PRD (e.g., "create a PRD for a user authentication feature"), follow this workflow:
|
|
15
|
+
|
|
16
|
+
### Step 1: Gather Context
|
|
17
|
+
|
|
18
|
+
Before generating the PRD, collect essential information through a discovery conversation:
|
|
19
|
+
|
|
20
|
+
**Required Information:**
|
|
21
|
+
- **Feature/Product Name**: What are we building?
|
|
22
|
+
- **Problem Statement**: What problem does this solve?
|
|
23
|
+
- **Target Users**: Who is this for?
|
|
24
|
+
- **Business Goals**: What are we trying to achieve?
|
|
25
|
+
- **Success Metrics**: How will we measure success?
|
|
26
|
+
- **Timeline/Constraints**: Any deadlines or limitations?
|
|
27
|
+
|
|
28
|
+
**Discovery Questions to Ask:**
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
1. What problem are you trying to solve?
|
|
32
|
+
2. Who is the primary user/audience for this feature?
|
|
33
|
+
3. What are the key business objectives?
|
|
34
|
+
4. Are there any technical constraints we should be aware of?
|
|
35
|
+
5. What does success look like? How will you measure it?
|
|
36
|
+
6. What's the timeline for this feature?
|
|
37
|
+
7. What's explicitly out of scope?
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
**Note:** If the user provides a detailed brief or requirements upfront, you can skip some questions. Always ask for clarification on missing critical information.
|
|
41
|
+
|
|
42
|
+
### Step 2: Generate PRD Structure
|
|
43
|
+
|
|
44
|
+
Structure the document with the following sections:
|
|
45
|
+
|
|
46
|
+
1. **Executive Summary** - High-level overview (2-3 paragraphs)
|
|
47
|
+
2. **Problem Statement** - Clear articulation of the problem
|
|
48
|
+
3. **Goals & Objectives** - What we're trying to achieve
|
|
49
|
+
4. **User Personas** - Who we're building for
|
|
50
|
+
5. **User Stories & Requirements** - Detailed functional requirements
|
|
51
|
+
6. **Success Metrics** - KPIs and measurement criteria
|
|
52
|
+
7. **Scope** - What's in and out of scope
|
|
53
|
+
8. **Technical Considerations** - Architecture, dependencies, constraints
|
|
54
|
+
9. **Design & UX Requirements** - UI/UX considerations
|
|
55
|
+
10. **Timeline & Milestones** - Key dates and phases
|
|
56
|
+
11. **Risks & Mitigation** - Potential issues and solutions
|
|
57
|
+
12. **Dependencies & Assumptions** - What we're relying on
|
|
58
|
+
13. **Open Questions** - Unresolved items
|
|
59
|
+
|
|
60
|
+
### Step 3: Create User Stories
|
|
61
|
+
|
|
62
|
+
For each major requirement, generate user stories using the standard format:
|
|
63
|
+
|
|
64
|
+
```
|
|
65
|
+
As a [user type],
|
|
66
|
+
I want to [action],
|
|
67
|
+
So that [benefit/value].
|
|
68
|
+
|
|
69
|
+
Acceptance Criteria:
|
|
70
|
+
- [Specific, testable criterion 1]
|
|
71
|
+
- [Specific, testable criterion 2]
|
|
72
|
+
- [Specific, testable criterion 3]
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Keep each story independent, testable, and free of implementation details (see User Story Best Practices below).
|
|
76
|
+
|
|
77
|
+
### Step 4: Define Success Metrics
|
|
78
|
+
|
|
79
|
+
Use appropriate metrics frameworks based on the product type:
|
|
80
|
+
|
|
81
|
+
- **AARRR (Pirate Metrics)**: Acquisition, Activation, Retention, Revenue, Referral
|
|
82
|
+
- **HEART Framework**: Happiness, Engagement, Adoption, Retention, Task Success
|
|
83
|
+
- **North Star Metric**: Single key metric that represents core value
|
|
84
|
+
- **OKRs**: Objectives and Key Results
|
|
85
|
+
|
|
86
|
+
Pick the framework that matches the product type and stakeholder expectations, and define concrete targets for each metric — not just the metric name.
|
|
87
|
+
|
|
88
|
+
### Step 5: Validate & Review
|
|
89
|
+
|
|
90
|
+
Before finalizing, walk through the Self-Review Checklist below to confirm the PRD is complete: all required sections present, user stories follow the standard format, success metrics are defined with targets, scope is clearly bounded, and no placeholder text remains.
|
|
91
|
+
|
|
92
|
+
## Usage Patterns
|
|
93
|
+
|
|
94
|
+
### Pattern 1: New Feature PRD
|
|
95
|
+
|
|
96
|
+
**User Request:** "Create a PRD for adding dark mode to our mobile app"
|
|
97
|
+
|
|
98
|
+
**Execution:**
|
|
99
|
+
|
|
100
|
+
1. Ask discovery questions about dark mode requirements
|
|
101
|
+
2. Generate PRD using template
|
|
102
|
+
3. Create user stories for:
|
|
103
|
+
- Theme switching
|
|
104
|
+
- Preference persistence
|
|
105
|
+
- System-level sync
|
|
106
|
+
- Design token updates
|
|
107
|
+
4. Define success metrics (adoption rate, user satisfaction)
|
|
108
|
+
5. Identify technical dependencies (design system, platform APIs)
|
|
109
|
+
|
|
110
|
+
### Pattern 2: Product Enhancement PRD
|
|
111
|
+
|
|
112
|
+
**User Request:** "Write requirements for improving our search functionality"
|
|
113
|
+
|
|
114
|
+
**Execution:**
|
|
115
|
+
|
|
116
|
+
1. Gather context on current search limitations
|
|
117
|
+
2. Identify user pain points and desired improvements
|
|
118
|
+
3. Generate PRD with focus on:
|
|
119
|
+
- Current state analysis
|
|
120
|
+
- Proposed enhancements
|
|
121
|
+
- Impact assessment
|
|
122
|
+
4. Create prioritized user stories
|
|
123
|
+
5. Define before/after metrics
|
|
124
|
+
|
|
125
|
+
### Pattern 3: New Product PRD
|
|
126
|
+
|
|
127
|
+
**User Request:** "I need a PRD for a new analytics dashboard product"
|
|
128
|
+
|
|
129
|
+
**Execution:**
|
|
130
|
+
|
|
131
|
+
1. Comprehensive discovery (market analysis, user research)
|
|
132
|
+
2. Generate full PRD with:
|
|
133
|
+
- Market opportunity
|
|
134
|
+
- Competitive analysis
|
|
135
|
+
- Product vision
|
|
136
|
+
- MVP scope
|
|
137
|
+
- Go-to-market considerations
|
|
138
|
+
3. Detailed user stories for core features
|
|
139
|
+
4. Phased rollout plan
|
|
140
|
+
5. Success metrics aligned with business goals
|
|
141
|
+
|
|
142
|
+
### Pattern 4: Quick PRD / One-Pager
|
|
143
|
+
|
|
144
|
+
**User Request:** "Create a lightweight PRD for a small bug fix feature"
|
|
145
|
+
|
|
146
|
+
**Execution:**
|
|
147
|
+
|
|
148
|
+
1. Generate simplified PRD focusing on:
|
|
149
|
+
- Problem statement
|
|
150
|
+
- Solution approach
|
|
151
|
+
- Acceptance criteria
|
|
152
|
+
- Success metrics
|
|
153
|
+
2. Skip sections not relevant for small scope
|
|
154
|
+
3. Keep document concise (1-2 pages)
|
|
155
|
+
|
|
156
|
+
## PRD Best Practices
|
|
157
|
+
|
|
158
|
+
### Writing Quality Requirements
|
|
159
|
+
|
|
160
|
+
**Good Requirements Are:**
|
|
161
|
+
- **Specific**: Clear and unambiguous
|
|
162
|
+
- **Measurable**: Can be verified/tested
|
|
163
|
+
- **Achievable**: Technically feasible
|
|
164
|
+
- **Relevant**: Tied to user/business value
|
|
165
|
+
- **Time-bound**: Has clear timeline
|
|
166
|
+
|
|
167
|
+
**Avoid:**
|
|
168
|
+
- Vague language ("fast", "easy", "intuitive")
|
|
169
|
+
- Implementation details (let engineers decide how)
|
|
170
|
+
- Feature creep (stick to core requirements)
|
|
171
|
+
- Assumptions without validation
|
|
172
|
+
|
|
173
|
+
### User Story Best Practices
|
|
174
|
+
|
|
175
|
+
**DO:**
|
|
176
|
+
- Focus on user value, not features
|
|
177
|
+
- Write from user perspective
|
|
178
|
+
- Include clear acceptance criteria
|
|
179
|
+
- Keep stories independent and small
|
|
180
|
+
- Use consistent format
|
|
181
|
+
|
|
182
|
+
**DON'T:**
|
|
183
|
+
- Write technical implementation details
|
|
184
|
+
- Create dependencies between stories
|
|
185
|
+
- Make stories too large (epics)
|
|
186
|
+
- Use internal jargon
|
|
187
|
+
- Skip acceptance criteria
|
|
188
|
+
|
|
189
|
+
### Scope Management
|
|
190
|
+
|
|
191
|
+
**In-Scope Section:**
|
|
192
|
+
- List specific features/capabilities included
|
|
193
|
+
- Be explicit and detailed
|
|
194
|
+
- Link to user stories
|
|
195
|
+
|
|
196
|
+
**Out-of-Scope Section:**
|
|
197
|
+
- Explicitly state what's NOT included
|
|
198
|
+
- Prevents scope creep
|
|
199
|
+
- Manages stakeholder expectations
|
|
200
|
+
- Can include "future considerations"
|
|
201
|
+
|
|
202
|
+
### Success Metrics Guidelines
|
|
203
|
+
|
|
204
|
+
**Choose Metrics That:**
|
|
205
|
+
- Align with business objectives
|
|
206
|
+
- Are measurable and trackable
|
|
207
|
+
- Have clear targets/thresholds
|
|
208
|
+
- Include both leading and lagging indicators
|
|
209
|
+
- Consider user and business value
|
|
210
|
+
|
|
211
|
+
**Typical Metric Categories:**
|
|
212
|
+
- **Adoption**: How many users use the feature?
|
|
213
|
+
- **Engagement**: How often do they use it?
|
|
214
|
+
- **Satisfaction**: Do users like it?
|
|
215
|
+
- **Performance**: Does it work well?
|
|
216
|
+
- **Business Impact**: Does it drive business goals?
|
|
217
|
+
|
|
218
|
+
## Advanced Features
|
|
219
|
+
|
|
220
|
+
### PRD Templates for Different Contexts
|
|
221
|
+
|
|
222
|
+
The skill supports different PRD formats:
|
|
223
|
+
|
|
224
|
+
**Standard PRD** - Full comprehensive document
|
|
225
|
+
**Lean PRD** - Streamlined for agile teams
|
|
226
|
+
**One-Pager** - Executive summary format
|
|
227
|
+
**Technical PRD** - Engineering-focused requirements
|
|
228
|
+
**Design PRD** - UX/UI-focused requirements
|
|
229
|
+
|
|
230
|
+
Specify the format when requesting: "Create a lean PRD for..." or "Generate a technical PRD for..."
|
|
231
|
+
|
|
232
|
+
### Integration with Design
|
|
233
|
+
|
|
234
|
+
**Design Requirements Section Should Include:**
|
|
235
|
+
- Visual design requirements
|
|
236
|
+
- Interaction patterns
|
|
237
|
+
- Accessibility requirements (WCAG compliance)
|
|
238
|
+
- Responsive design considerations
|
|
239
|
+
- Design system components to use
|
|
240
|
+
- User flow diagrams
|
|
241
|
+
- Wireframe/mockup references
|
|
242
|
+
|
|
243
|
+
### Technical Considerations Section
|
|
244
|
+
|
|
245
|
+
**Should Address:**
|
|
246
|
+
- **Architecture**: High-level technical approach
|
|
247
|
+
- **Dependencies**: External services, libraries, APIs
|
|
248
|
+
- **Security**: Authentication, authorization, data protection
|
|
249
|
+
- **Performance**: Load times, scalability requirements
|
|
250
|
+
- **Compatibility**: Browser, device, platform support
|
|
251
|
+
- **Data**: Storage, migration, privacy considerations
|
|
252
|
+
- **Integration**: How it fits with existing systems
|
|
253
|
+
|
|
254
|
+
### Stakeholder Alignment
|
|
255
|
+
|
|
256
|
+
**PRD Should Help:**
|
|
257
|
+
- Align cross-functional teams
|
|
258
|
+
- Set clear expectations
|
|
259
|
+
- Enable parallel work streams
|
|
260
|
+
- Facilitate decision-making
|
|
261
|
+
- Provide single source of truth
|
|
262
|
+
|
|
263
|
+
**Distribution Checklist:**
|
|
264
|
+
- [ ] Engineering reviewed technical feasibility
|
|
265
|
+
- [ ] Design reviewed UX requirements
|
|
266
|
+
- [ ] Product leadership approved scope
|
|
267
|
+
- [ ] Stakeholders understand timeline
|
|
268
|
+
- [ ] Success metrics agreed upon
|
|
269
|
+
|
|
270
|
+
## Common PRD Scenarios
|
|
271
|
+
|
|
272
|
+
### Scenario 1: Feature Request from Customer
|
|
273
|
+
|
|
274
|
+
When creating a PRD based on customer feedback:
|
|
275
|
+
|
|
276
|
+
1. Document the customer request verbatim
|
|
277
|
+
2. Analyze the underlying problem
|
|
278
|
+
3. Generalize the solution for all users
|
|
279
|
+
4. Validate with product strategy
|
|
280
|
+
5. Scope appropriately (might be smaller or larger than request)
|
|
281
|
+
|
|
282
|
+
### Scenario 2: Strategic Initiative
|
|
283
|
+
|
|
284
|
+
When creating a PRD for a strategic company initiative:
|
|
285
|
+
|
|
286
|
+
1. Link to company OKRs/goals
|
|
287
|
+
2. Include market analysis
|
|
288
|
+
3. Consider competitive landscape
|
|
289
|
+
4. Think multi-phase rollout
|
|
290
|
+
5. Include success criteria aligned with strategy
|
|
291
|
+
|
|
292
|
+
### Scenario 3: Technical Debt / Infrastructure
|
|
293
|
+
|
|
294
|
+
When creating a PRD for technical improvements:
|
|
295
|
+
|
|
296
|
+
1. Explain user impact (even if indirect)
|
|
297
|
+
2. Document current limitations
|
|
298
|
+
3. Articulate benefits (speed, reliability, maintainability)
|
|
299
|
+
4. Include engineering input heavily
|
|
300
|
+
5. Define measurable improvements
|
|
301
|
+
|
|
302
|
+
### Scenario 4: Compliance / Regulatory
|
|
303
|
+
|
|
304
|
+
When creating a PRD for compliance requirements:
|
|
305
|
+
|
|
306
|
+
1. Reference specific regulations (GDPR, HIPAA, etc.)
|
|
307
|
+
2. Include legal/compliance review
|
|
308
|
+
3. Deadline is usually non-negotiable
|
|
309
|
+
4. Focus on minimum viable compliance
|
|
310
|
+
5. Document audit trail requirements
|
|
311
|
+
|
|
312
|
+
## Validation & Quality Checks
|
|
313
|
+
|
|
314
|
+
### Self-Review Checklist
|
|
315
|
+
|
|
316
|
+
Before finalizing the PRD, verify:
|
|
317
|
+
|
|
318
|
+
- [ ] **Problem is clear**: Anyone can understand what we're solving
|
|
319
|
+
- [ ] **Users are identified**: We know who this is for
|
|
320
|
+
- [ ] **Success is measurable**: We can determine if it worked
|
|
321
|
+
- [ ] **Scope is bounded**: Clear what's in and out
|
|
322
|
+
- [ ] **Requirements are testable**: QA can verify completion
|
|
323
|
+
- [ ] **Timeline is realistic**: Estimates validated with engineering
|
|
324
|
+
- [ ] **Risks are identified**: We've thought through what could go wrong
|
|
325
|
+
- [ ] **Stakeholders aligned**: Key people have reviewed and approved
|
|
326
|
+
|
|
327
|
+
## Tips for Product Managers
|
|
328
|
+
|
|
329
|
+
### Before Writing the PRD
|
|
330
|
+
|
|
331
|
+
1. **Do your research**: User interviews, data analysis, competitive analysis
|
|
332
|
+
2. **Validate the problem**: Ensure it's worth solving
|
|
333
|
+
3. **Check strategic alignment**: Does this fit our roadmap?
|
|
334
|
+
4. **Estimate effort**: Rough t-shirt size with engineering
|
|
335
|
+
5. **Consider alternatives**: Is this the best solution?
|
|
336
|
+
|
|
337
|
+
### During PRD Creation
|
|
338
|
+
|
|
339
|
+
1. **Be clear, not clever**: Simple language wins
|
|
340
|
+
2. **Show, don't tell**: Use examples, mockups, diagrams
|
|
341
|
+
3. **Think edge cases**: What could go wrong?
|
|
342
|
+
4. **Prioritize ruthlessly**: What's MVP vs. nice-to-have?
|
|
343
|
+
5. **Collaborate early**: Don't work in isolation
|
|
344
|
+
|
|
345
|
+
### After PRD Completion
|
|
346
|
+
|
|
347
|
+
1. **Review with stakeholders**: Get feedback early
|
|
348
|
+
2. **Iterate based on input**: PRDs are living documents
|
|
349
|
+
3. **Present, don't just share**: Walk through the PRD
|
|
350
|
+
4. **Get formal sign-off**: Ensure commitment
|
|
351
|
+
5. **Keep it updated**: Adjust as understanding evolves
|
|
352
|
+
|
|
353
|
+
## Examples
|
|
354
|
+
|
|
355
|
+
### Example 1: Mobile Feature PRD
|
|
356
|
+
|
|
357
|
+
```bash
|
|
358
|
+
# User: "Create a PRD for adding biometric authentication to our iOS app"
|
|
359
|
+
|
|
360
|
+
# Assistant will:
|
|
361
|
+
# 1. Ask discovery questions about security requirements, user personas, existing auth
|
|
362
|
+
# 2. Generate PRD covering:
|
|
363
|
+
# - Problem: Password friction, security concerns
|
|
364
|
+
# - Solution: Face ID / Touch ID integration
|
|
365
|
+
# - User stories: Enable biometric, fallback to password, settings management
|
|
366
|
+
# - Metrics: Adoption rate, login success rate, support tickets
|
|
367
|
+
# - Technical: iOS Keychain, LocalAuthentication framework
|
|
368
|
+
# - Risks: Device compatibility, user privacy concerns
|
|
369
|
+
# 3. Output formatted markdown PRD
|
|
370
|
+
```
|
|
371
|
+
|
|
372
|
+
### Example 2: Web Platform Enhancement
|
|
373
|
+
|
|
374
|
+
```bash
|
|
375
|
+
# User: "Write requirements for improving our checkout flow conversion"
|
|
376
|
+
|
|
377
|
+
# Assistant will:
|
|
378
|
+
# 1. Gather data on current conversion rates and drop-off points
|
|
379
|
+
# 2. Generate PRD including:
|
|
380
|
+
# - Current state analysis with metrics
|
|
381
|
+
# - Proposed improvements (guest checkout, saved payment, progress indicator)
|
|
382
|
+
# - A/B test plan
|
|
383
|
+
# - Success metrics: Conversion rate increase, time to checkout
|
|
384
|
+
# - User stories for each improvement
|
|
385
|
+
# 3. Include phased rollout approach
|
|
386
|
+
```
|
|
387
|
+
|
|
388
|
+
### Example 3: B2B Product PRD
|
|
389
|
+
|
|
390
|
+
```bash
|
|
391
|
+
# User: "I need a PRD for an admin dashboard for enterprise customers"
|
|
392
|
+
|
|
393
|
+
# Assistant will:
|
|
394
|
+
# 1. Identify B2B-specific requirements (multi-tenancy, permissions, reporting)
|
|
395
|
+
# 2. Generate comprehensive PRD with:
|
|
396
|
+
# - Enterprise user personas (admin, manager, analyst)
|
|
397
|
+
# - Role-based access control requirements
|
|
398
|
+
# - Reporting and analytics needs
|
|
399
|
+
# - Integration requirements (SSO, SCIM)
|
|
400
|
+
# - Success metrics: Customer adoption, admin efficiency
|
|
401
|
+
# 3. Include enterprise-specific considerations (compliance, SLAs)
|
|
402
|
+
```
|
|
403
|
+
|
|
404
|
+
## Troubleshooting
|
|
405
|
+
|
|
406
|
+
**Issue: PRD is too long/detailed**
|
|
407
|
+
|
|
408
|
+
Solution: Create a "Lean PRD" focusing on problem, solution, acceptance criteria, and metrics. Reserve full PRD for major initiatives.
|
|
409
|
+
|
|
410
|
+
**Issue: Requirements are too vague**
|
|
411
|
+
|
|
412
|
+
Solution: Add specific examples, use concrete numbers, include visual references. Replace "fast" with "loads in under 2 seconds."
|
|
413
|
+
|
|
414
|
+
**Issue: Stakeholders not aligned**
|
|
415
|
+
|
|
416
|
+
Solution: Share PRD early as draft, incorporate feedback, present in person, get explicit sign-off before development starts.
|
|
417
|
+
|
|
418
|
+
**Issue: Scope keeps expanding**
|
|
419
|
+
|
|
420
|
+
Solution: Use "Out of Scope" section aggressively, create separate PRDs for future phases, tie scope to timeline constraints.
|
|
421
|
+
|
|
422
|
+
**Issue: Engineers say it's not feasible**
|
|
423
|
+
|
|
424
|
+
Solution: Involve engineering earlier in process, be flexible on solution approach, focus on problem not implementation.
|
|
425
|
+
|
|
426
|
+
## Best Practices Summary
|
|
427
|
+
|
|
428
|
+
1. **Start with the problem, not the solution**
|
|
429
|
+
2. **Write for your audience** (execs need summary, engineers need details)
|
|
430
|
+
3. **Be specific and measurable** (avoid vague language)
|
|
431
|
+
4. **Include visuals** (mockups, diagrams, flows)
|
|
432
|
+
5. **Define success upfront** (metrics, not features)
|
|
433
|
+
6. **Scope aggressively** (MVP mentality)
|
|
434
|
+
7. **Collaborate, don't dictate** (get input from all functions)
|
|
435
|
+
8. **Keep it updated** (PRD is a living document)
|
|
436
|
+
9. **Focus on "why" and "what", not "how"** (let engineers solve "how")
|
|
437
|
+
10. **Make it skimmable** (headers, bullets, summaries)
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: skill-headofit-audit
|
|
3
|
+
description: Evaluates SaaS tools, cloud infrastructure costs, self-hosted alternatives, vendor lock-in risks, and compliance readiness for Head of IT and IT Leadership decisions.
|
|
4
|
+
triggers: ["@vendor-audit", "head of it evaluation", "saas audit", "build vs buy", "infrastructure cost audit", "vendor evaluation"]
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Instruction Rules
|
|
8
|
+
1. **Multi-Vector Scoring:** Evaluate across 5 key pillars: Functional Fit, Technical/API Integration, Security & Compliance, Operational Overhead, and Total Cost of Ownership (TCO).
|
|
9
|
+
2. **Require Build vs. Buy Analysis:** Force explicit trade-off comparisons between managed SaaS, open-source/self-hosted (e.g., Coolify/Docker), and custom builds.
|
|
10
|
+
3. **Flag Lock-In & Portability Risks:** Always audit data export formats, vendor exit costs, and migration pathways.
|
|
11
|
+
4. **Output Format:** Clean Markdown featuring comparative scoring matrices, TCO projections, and strategic recommendations.
|
|
12
|
+
|
|
13
|
+
# Assessment Workflow
|
|
14
|
+
- **Phase 1: Need & Scope Definition:** Clarify business problem, usage scale, must-have constraints, and budget ceilings.
|
|
15
|
+
- **Phase 2: Build vs. Buy vs. Self-Host Analysis:** Evaluate managed options vs. self-hosted/open-source deployments.
|
|
16
|
+
- **Phase 3: Multi-Pillar Scoring & Security Pre-flight:** Audit SOC 2, GDPR, data residency, SLA guarantees, and API capabilities.
|
|
17
|
+
- **Phase 4: Financial TCO & Vendor Decision:** Calculate initial onboarding, subscription, maintenance, and exit costs over a 12–36 month horizon.
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
# Output Schema
|
|
22
|
+
|
|
23
|
+
# IT Infrastructure & Vendor Audit: [Vendor / Solution Name]
|
|
24
|
+
|
|
25
|
+
## 1. Executive Brief & Context
|
|
26
|
+
- **Evaluation Goal:** [e.g., Replacing managed DB platform with self-hosted PostgreSQL via Coolify]
|
|
27
|
+
- **Current Annual Spend / Cost:** [e.g., $18,000 / year]
|
|
28
|
+
- **Target Scale:** [e.g., 50 team members, 20 microservices, 99.9% uptime requirement]
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## 2. Build vs. Buy vs. Self-Host Matrix
|
|
33
|
+
|
|
34
|
+
| Parameter | Managed SaaS | Self-Hosted / Homelab | Custom In-House |
|
|
35
|
+
| :--- | :--- | :--- | :--- |
|
|
36
|
+
| **Direct License Cost** | High ($1,500/mo) | Low (Infra bare-metal cost) | None |
|
|
37
|
+
| **Ops / Maintenance Effort** | Low (Vendor managed) | Medium-High (Internal Team) | High |
|
|
38
|
+
| **Data Control & Residency** | Moderate (Vendor Cloud) | Complete (Self-managed) | Complete |
|
|
39
|
+
| **Vendor Lock-in Risk** | High | Low | None |
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## 3. Weighted Evaluation Scorecard
|
|
44
|
+
|
|
45
|
+
| Category | Weight | Score (1-5) | Key Observations |
|
|
46
|
+
| :--- | :--- | :--- | :--- |
|
|
47
|
+
| **Functional & Workflow Fit** | 30% | 4.5 / 5.0 | Meets 95% of operational requirements out of the box. |
|
|
48
|
+
| **Technical & API Capabilities** | 20% | 4.0 / 5.0 | REST & Webhook support present; missing GraphQL API. |
|
|
49
|
+
| **Security & Compliance** | 20% | 5.0 / 5.0 | GDPR compliant, SOC 2 Type II certified, isolated tenant DBs. |
|
|
50
|
+
| **Ops & Maintenance Overhead** | 15% | 3.5 / 5.0 | Requires internal team onboarding and backup orchestration. |
|
|
51
|
+
| **Financial & TCO Impact** | 15% | 4.0 / 5.0 | Payback period achieved within 6 months. |
|
|
52
|
+
| **Weighted Total** | **100%** | **4.28 / 5.0**| **RECOMMENDED** |
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## 4. 3-Year Total Cost of Ownership (TCO) Projection
|
|
57
|
+
|
|
58
|
+
```
|
|
59
|
+
[Year 1 Setup & Licensing] ──> $12,000
|
|
60
|
+
[Year 2 Maintenance & Run] ──> $8,500
|
|
61
|
+
[Year 3 Maintenance & Run] ──> $8,500
|
|
62
|
+
Total Estimated 3-Year TCO: $29,000 (35% savings vs incumbent)
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
## 5. Security, Risk & Exit Strategy
|
|
68
|
+
- **Security Check:** SOC 2 Type II verified, TLS 1.3 enforced, RBAC + SAML/SSO supported.
|
|
69
|
+
- **Vendor Lock-in Risk:** LOW. Native JSON/SQL export supported via API and CLI.
|
|
70
|
+
- **Recommended Next Steps:**
|
|
71
|
+
1. Initiate 14-day technical pilot on staging infrastructure.
|
|
72
|
+
2. Draft migration & rollback plan before contract finalization.
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: skill-incident-rca
|
|
3
|
+
description: Blameless Root Cause Analysis (RCA) and Post-Mortem framework for production outages, regressions, and critical incidents. Uses the 5 Whys and Causal Chain analysis to convert incident logs into durable preventative actions.
|
|
4
|
+
triggers: ["@incident-rca", "post-mortem", "root cause analysis", "incident report", "outage rca", "rca"]
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Instruction Rules
|
|
8
|
+
1. **Enforce Blameless Culture:** Focus strictly on systemic vulnerabilities, process gaps, and missing safeguards. Never attribute failures to individual human error.
|
|
9
|
+
2. **5 Whys Deep-Dive:** Chain every surface symptom down through at least 5 levels of "Why?" until reaching an actionable architectural or process gap. If evidence runs out before reaching level 5, mark the chain `UNKNOWN — insufficient evidence` at that point rather than inventing an unsupported cause.
|
|
10
|
+
3. **Quantify Impact:** Explicitly quantify outage duration, user blast radius, data loss, and SLA breach metrics. Mark any metric not available in the evidence as `UNKNOWN` rather than estimating.
|
|
11
|
+
4. **Action Item Discipline:** Output clear action items with specific owners, category tags, and due dates. Avoid vague terms like "improve testing".
|
|
12
|
+
|
|
13
|
+
# Execution Workflow
|
|
14
|
+
- **Step 1: Timeline Reconstruction:** Map events chronologically (Start $\rightarrow$ Detection $\rightarrow$ Triage $\rightarrow$ Mitigation $\rightarrow$ Resolution).
|
|
15
|
+
- **Step 2: Root Cause & 5 Whys Analysis:** Dig past immediate triggers (e.g., "database lock") to underlying root causes (e.g., "missing connection pool timeouts").
|
|
16
|
+
- **Step 3: Contributing Factors:** Identify monitoring gaps, missing runbooks, or testing blind spots that aggravated the issue.
|
|
17
|
+
- **Step 4: Preventative Action Matrix:** Create owned, closed-form engineering tasks.
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
# Output Schema
|
|
22
|
+
|
|
23
|
+
# Post-Mortem: [Incident Title / Outage Name]
|
|
24
|
+
|
|
25
|
+
## 1. Executive Summary
|
|
26
|
+
- **Incident Date:** {{YYYY-MM-DD}}
|
|
27
|
+
- **Severity Level:** [ SEV-1 | SEV-2 | SEV-3 ]
|
|
28
|
+
- **Time to Detect (TTD):** [e.g., 8 minutes]
|
|
29
|
+
- **Time to Resolve (TTR):** [e.g., 42 minutes]
|
|
30
|
+
- **Blast Radius:** [e.g., 15% of active API traffic received HTTP 500 errors]
|
|
31
|
+
- **Summary:** [3-sentence executive overview of what failed, impact, and mitigation]
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 2. Chronological Timeline
|
|
36
|
+
| Timestamp (UTC) | Event Phase | Description & Findings | Source / Evidence |
|
|
37
|
+
| :--- | :--- | :--- | :--- |
|
|
38
|
+
| **14:02** | Incident Start | Spike in background worker memory usage. | Grafana Alert |
|
|
39
|
+
| **14:08** | Detection | Automated alert paged On-Call Lead. | PagerDuty |
|
|
40
|
+
| **14:15** | Containment | Scaled worker pool & cleared queue. | Manual Action |
|
|
41
|
+
| **14:44** | Resolution | Deployed patch `v1.2.1` with memory caps. | CI/CD Deploy |
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## 3. Root Cause Analysis (The 5 Whys)
|
|
46
|
+
1. **Why did the API crash?** $\rightarrow$ Worker node ran out of memory (OOM).
|
|
47
|
+
2. **Why did it run out of memory?** $\rightarrow$ A background job loaded a 4GB dataset into RAM at once.
|
|
48
|
+
3. **Why did it load the full dataset?** $\rightarrow$ Pagination parameter was omitted in the query payload.
|
|
49
|
+
4. **Why was pagination missing?** $\rightarrow$ The endpoint lacked input schema validation for array bounds.
|
|
50
|
+
5. **Why was validation missing?** $\rightarrow$ Systemic gap: API review checklists do not require execution limits on bulk export endpoints.
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## 4. Contributing Factors
|
|
55
|
+
- **Monitoring Gap:** No alert was configured for database connection pool saturation prior to node OOM.
|
|
56
|
+
- **Process Gap:** Staging environment data volume was too small to surface memory scaling limits during integration testing.
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## 5. Preventative Action Items
|
|
61
|
+
|
|
62
|
+
| Action Item | Category | Assignee | Due Date | Target Ticket |
|
|
63
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
64
|
+
| Add memory boundary limit to API validator | Prevention | `@developer` | 2026-10-05 | `ENG-402` |
|
|
65
|
+
| Configure connection pool saturation alert at 80% | Detection | `@devops` | 2026-10-02 | `OPS-118` |
|
|
66
|
+
| Seed staging DB with realistic volume mock data | Process | `@qa-lead` | 2026-10-12 | `QA-88` |
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: skill-meeting-lifecycle
|
|
3
|
+
description: Processes raw transcripts or meeting notes into structured intelligence, distinguishing executive summaries, key decisions, speaker attributions, and follow-up items.
|
|
4
|
+
triggers: ["@meeting-notes", "process transcript", "meeting summary", "meeting notes", "call breakdown"]
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Instruction Rules
|
|
8
|
+
1. **Never Hallucinate Commitments:** Only extract decisions and action items explicitly stated or clearly implied in the transcript.
|
|
9
|
+
2. **Dual-Tier Summary:** Always provide both a high-level executive brief (for leadership/stakeholders) and a granular technical breakdown (for engineering).
|
|
10
|
+
3. **Obsidian Integration:** Auto-generate `[[WikiLinks]]` for people, projects, and key technologies mentioned.
|
|
11
|
+
4. **Output Format:** Clean Markdown using structured tables and actionable checklists.
|
|
12
|
+
|
|
13
|
+
# Processing Framework
|
|
14
|
+
- **Step 1: Context & Metadata Extraction:** Identify meeting date, purpose, attendees, and project context.
|
|
15
|
+
- **Step 2: Executive & Granular Synthesis:** Summarize core outcomes and group discussion points by technical topic.
|
|
16
|
+
- **Step 3: Decision Log:** Extract concrete architectural, product, or operational decisions made during the call.
|
|
17
|
+
- **Step 4: Action Items Extraction:** Prepare raw task payloads for downstream PM tools or Obsidian daily notes.
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
# Output Schema
|
|
22
|
+
|
|
23
|
+
# Meeting Notes: [Meeting Title / Topic]
|
|
24
|
+
|
|
25
|
+
## 1. Meeting Overview
|
|
26
|
+
- **Date & Time:** {{YYYY-MM-DD}}
|
|
27
|
+
- **Attendees:** [[Person A]], [[Person B]], [[Person C]]
|
|
28
|
+
- **Project Context:** [[Project Name]]
|
|
29
|
+
- **Executive Brief:** [2-3 concise sentences summarizing the core outcome of the call]
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## 2. Key Decisions Made
|
|
34
|
+
| # | Decision | Rationale | Owner / Lead |
|
|
35
|
+
| :--- | :--- | :--- | :--- |
|
|
36
|
+
| **1** | Migrating auth layer to Supabase | Reduces custom maintenance overhead | [[Person A]] |
|
|
37
|
+
| **2** | Postpone feature X to Sprint 15 | Prioritizing API performance fixes | [[Person B]] |
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## 3. Topic Breakdown & Discussion Notes
|
|
42
|
+
|
|
43
|
+
### Topic A: [e.g., Infrastructure & Database Scaling]
|
|
44
|
+
- Discussion focused on recent API latency spikes under load.
|
|
45
|
+
- [[Person A]] shared telemetry showing connection pool exhaustion.
|
|
46
|
+
- Consensus reached to add Redis caching before doubling database instance size.
|
|
47
|
+
|
|
48
|
+
### Topic B: [e.g., Q3 Product Roadmap Adjustments]
|
|
49
|
+
- Reviewed client feedback on onboarding workflow.
|
|
50
|
+
- Agreed to simplify signup steps down to 2 screens.
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## 4. Raw Action Items
|
|
55
|
+
- [ ] **Task 1:** [[Person A]] to draft Redis caching proposal by Friday.
|
|
56
|
+
- [ ] **Task 2:** [[Person B]] to update Figma designs for simplified onboarding.
|
|
57
|
+
- [ ] **Task 3:** [[Person C]] to check staging environment log retention settings.
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## 5. Unresolved Questions & Next Steps
|
|
62
|
+
- [ ] **Open Item:** How will the new caching layer handle multi-region invalidation?
|
|
63
|
+
- **Next Sync:** Scheduled for {{YYYY-MM-DD}}
|