skillstore-cli 1.0.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 (231) hide show
  1. package/README.md +95 -0
  2. package/data/bundles/devflow-complete.json +19 -0
  3. package/data/free-skills/devflow-agile/manifest.json +19 -0
  4. package/data/free-skills/devflow-agile/plugin/commands/agile/retro.md +23 -0
  5. package/data/free-skills/devflow-agile/plugin/commands/agile/review.md +21 -0
  6. package/data/free-skills/devflow-agile/plugin/commands/agile/sprint.md +30 -0
  7. package/data/free-skills/devflow-agile/plugin/commands/agile/standup.md +20 -0
  8. package/data/free-skills/devflow-agile/plugin/commands/agile.md +35 -0
  9. package/data/free-skills/devflow-agile/plugin/commands/devflow.md +42 -0
  10. package/data/free-skills/devflow-agile/plugin/skills/developer/SKILL.md +93 -0
  11. package/data/free-skills/devflow-agile/plugin/skills/developer/assets/sample-output.md +182 -0
  12. package/data/free-skills/devflow-agile/plugin/skills/developer/references/clean-architecture.md +361 -0
  13. package/data/free-skills/devflow-agile/plugin/skills/developer/references/clean-code-guide.md +207 -0
  14. package/data/free-skills/devflow-agile/plugin/skills/developer/references/debugging-methodology.md +191 -0
  15. package/data/free-skills/devflow-agile/template/agents/agile-coach.md +76 -0
  16. package/data/free-skills/devflow-agile/template/workflows/agile-sprint-workflow.md +81 -0
  17. package/data/free-skills/devflow-bootstrap/manifest.json +8 -0
  18. package/data/free-skills/devflow-bootstrap/plugin/commands/bootstrap/auto.md +31 -0
  19. package/data/free-skills/devflow-bootstrap/plugin/commands/bootstrap.md +38 -0
  20. package/data/free-skills/devflow-bootstrap/plugin/commands/devflow.md +20 -0
  21. package/data/free-skills/devflow-bootstrap/plugin/skills/project-scaffold/SKILL.md +56 -0
  22. package/data/free-skills/devflow-bootstrap/plugin/skills/project-scaffold/assets/sample-output.md +216 -0
  23. package/data/free-skills/devflow-bootstrap/plugin/skills/project-scaffold/references/architecture-decisions.md +254 -0
  24. package/data/free-skills/devflow-bootstrap/plugin/skills/project-scaffold/references/stack-templates.md +400 -0
  25. package/data/free-skills/devflow-bootstrap/template/agents/bootstrap-specialist.md +56 -0
  26. package/data/free-skills/devflow-bootstrap/template/workflows/bootstrap-workflow.md +70 -0
  27. package/data/free-skills/devflow-docs/manifest.json +8 -0
  28. package/data/free-skills/devflow-docs/plugin/commands/devflow.md +20 -0
  29. package/data/free-skills/devflow-docs/plugin/commands/docs/generate.md +17 -0
  30. package/data/free-skills/devflow-docs/plugin/commands/docs/parse.md +19 -0
  31. package/data/free-skills/devflow-docs/plugin/commands/docs.md +26 -0
  32. package/data/free-skills/devflow-docs/plugin/skills/pdf-processor/SKILL.md +59 -0
  33. package/data/free-skills/devflow-docs/plugin/skills/pdf-processor/assets/sample-output.md +114 -0
  34. package/data/free-skills/devflow-docs/plugin/skills/pdf-processor/references/extraction-techniques.md +115 -0
  35. package/data/free-skills/devflow-docs/plugin/skills/pdf-processor/references/ocr-strategies.md +167 -0
  36. package/data/free-skills/devflow-docs/template/agents/docs-specialist.md +35 -0
  37. package/data/free-skills/devflow-docs/template/workflows/docs-workflow.md +70 -0
  38. package/data/free-skills/devflow-postproject/manifest.json +13 -0
  39. package/data/free-skills/devflow-postproject/plugin/commands/devflow.md +34 -0
  40. package/data/free-skills/devflow-postproject/plugin/commands/postproject/handover.md +21 -0
  41. package/data/free-skills/devflow-postproject/plugin/commands/postproject/retro.md +21 -0
  42. package/data/free-skills/devflow-postproject/plugin/commands/postproject/support.md +21 -0
  43. package/data/free-skills/devflow-postproject/plugin/commands/postproject.md +32 -0
  44. package/data/free-skills/devflow-postproject/plugin/skills/retrospective/SKILL.md +70 -0
  45. package/data/free-skills/devflow-postproject/plugin/skills/retrospective/assets/sample-output.md +79 -0
  46. package/data/free-skills/devflow-postproject/plugin/skills/retrospective/references/facilitation-techniques.md +178 -0
  47. package/data/free-skills/devflow-postproject/plugin/skills/retrospective/references/lessons-learned-template.md +118 -0
  48. package/data/free-skills/devflow-postproject/plugin/skills/retrospective/references/retro-techniques.md +100 -0
  49. package/data/free-skills/devflow-postproject/template/agents/transition-manager.md +71 -0
  50. package/data/free-skills/devflow-postproject/template/workflows/transition-workflow.md +72 -0
  51. package/data/free-skills/devflow-presale/manifest.json +15 -0
  52. package/data/free-skills/devflow-presale/plugin/commands/devflow.md +47 -0
  53. package/data/free-skills/devflow-presale/plugin/commands/presale/analyze.md +30 -0
  54. package/data/free-skills/devflow-presale/plugin/commands/presale/estimate.md +30 -0
  55. package/data/free-skills/devflow-presale/plugin/commands/presale/price.md +30 -0
  56. package/data/free-skills/devflow-presale/plugin/commands/presale/propose.md +30 -0
  57. package/data/free-skills/devflow-presale/plugin/commands/presale.md +42 -0
  58. package/data/free-skills/devflow-presale/plugin/skills/requirement-analysis/SKILL.md +63 -0
  59. package/data/free-skills/devflow-presale/plugin/skills/requirement-analysis/assets/sample-output.md +129 -0
  60. package/data/free-skills/devflow-presale/plugin/skills/requirement-analysis/references/extraction-framework.md +140 -0
  61. package/data/free-skills/devflow-presale/plugin/skills/requirement-analysis/references/output-template.md +132 -0
  62. package/data/free-skills/devflow-presale/template/agents/presale-lead.md +83 -0
  63. package/data/free-skills/devflow-presale/template/agents/proposal-reviewer.md +63 -0
  64. package/data/free-skills/devflow-presale/template/workflows/presale-workflow.md +70 -0
  65. package/data/registry/categories.json +7 -0
  66. package/data/registry/packages.json +184 -0
  67. package/data/shared/framework/agents/brainstormer.md +74 -0
  68. package/data/shared/framework/agents/code-reviewer.md +87 -0
  69. package/data/shared/framework/agents/debugger.md +84 -0
  70. package/data/shared/framework/agents/docs-manager.md +55 -0
  71. package/data/shared/framework/agents/git-manager.md +59 -0
  72. package/data/shared/framework/agents/planner.md +68 -0
  73. package/data/shared/framework/agents/researcher.md +66 -0
  74. package/data/shared/framework/agents/tester.md +65 -0
  75. package/data/shared/framework/commands/cook/auto.md +27 -0
  76. package/data/shared/framework/commands/cook.md +45 -0
  77. package/data/shared/framework/commands/fix/ci.md +21 -0
  78. package/data/shared/framework/commands/fix/test.md +26 -0
  79. package/data/shared/framework/commands/fix/types.md +29 -0
  80. package/data/shared/framework/commands/fix.md +26 -0
  81. package/data/shared/framework/commands/git/cm.md +37 -0
  82. package/data/shared/framework/commands/git/pr.md +40 -0
  83. package/data/shared/framework/config/CLAUDE.md.template +26 -0
  84. package/data/shared/framework/config/settings.json +41 -0
  85. package/data/shared/framework/config/skillstore.config.json +29 -0
  86. package/data/shared/framework/hooks/discord-notify.sh +85 -0
  87. package/data/shared/framework/hooks/docs-sync.sh +53 -0
  88. package/data/shared/framework/hooks/modularization-hook.js +103 -0
  89. package/data/shared/framework/hooks/notification.js +94 -0
  90. package/data/shared/framework/hooks/quality-gate.js +109 -0
  91. package/data/shared/framework/hooks/scout-block.js +77 -0
  92. package/data/shared/framework/hooks/telegram-notify.sh +77 -0
  93. package/data/shared/framework/protocols/error-recovery.md +80 -0
  94. package/data/shared/framework/protocols/orchestration-protocol.md +112 -0
  95. package/data/shared/framework/quality/review-protocol.md +76 -0
  96. package/data/shared/framework/quality/verification-protocol.md +66 -0
  97. package/data/shared/framework/rules/development-rules.md +75 -0
  98. package/data/shared/framework/skills/backend-development/SKILL.md +77 -0
  99. package/data/shared/framework/skills/backend-development/assets/sample-output.md +175 -0
  100. package/data/shared/framework/skills/backend-development/references/advanced-patterns.md +180 -0
  101. package/data/shared/framework/skills/backend-development/references/api-design-guide.md +160 -0
  102. package/data/shared/framework/skills/backend-development/references/architecture-patterns.md +183 -0
  103. package/data/shared/framework/skills/backend-development/references/observability-resilience.md +155 -0
  104. package/data/shared/framework/skills/backend-development/references/troubleshooting.md +199 -0
  105. package/data/shared/framework/skills/codebase-analysis/SKILL.md +72 -0
  106. package/data/shared/framework/skills/codebase-analysis/assets/sample-output.md +263 -0
  107. package/data/shared/framework/skills/codebase-analysis/references/analysis-techniques.md +241 -0
  108. package/data/shared/framework/skills/codebase-analysis/references/dependency-mapping.md +280 -0
  109. package/data/shared/framework/skills/codebase-analysis/references/tech-debt-assessment.md +208 -0
  110. package/data/shared/framework/skills/databases/SKILL.md +72 -0
  111. package/data/shared/framework/skills/databases/assets/sample-output.md +212 -0
  112. package/data/shared/framework/skills/databases/references/advanced-data-patterns.md +259 -0
  113. package/data/shared/framework/skills/databases/references/query-optimization.md +214 -0
  114. package/data/shared/framework/skills/databases/references/schema-design.md +159 -0
  115. package/data/shared/framework/skills/databases/references/troubleshooting.md +214 -0
  116. package/data/shared/framework/skills/debugging-investigation/SKILL.md +84 -0
  117. package/data/shared/framework/skills/debugging-investigation/assets/sample-output.md +314 -0
  118. package/data/shared/framework/skills/debugging-investigation/references/systematic-debugging.md +197 -0
  119. package/data/shared/framework/skills/debugging-investigation/references/tool-specific-guides.md +202 -0
  120. package/data/shared/framework/skills/debugging-investigation/references/troubleshooting-patterns.md +196 -0
  121. package/data/shared/framework/skills/frontend-development/SKILL.md +67 -0
  122. package/data/shared/framework/skills/frontend-development/assets/sample-output.md +110 -0
  123. package/data/shared/framework/skills/frontend-development/references/component-patterns.md +112 -0
  124. package/data/shared/framework/skills/frontend-development/references/performance-guide.md +169 -0
  125. package/data/shared/framework/skills/frontend-development/references/routing-forms-realtime.md +374 -0
  126. package/data/shared/framework/skills/frontend-development/references/ssr-rsc-patterns.md +284 -0
  127. package/data/shared/framework/skills/frontend-development/references/troubleshooting.md +154 -0
  128. package/data/shared/framework/skills/mobile-development/SKILL.md +67 -0
  129. package/data/shared/framework/skills/mobile-development/assets/sample-output.md +382 -0
  130. package/data/shared/framework/skills/mobile-development/references/mobile-patterns.md +681 -0
  131. package/data/shared/framework/skills/mobile-development/references/mobile-performance.md +524 -0
  132. package/data/shared/framework/skills/mobile-development/references/troubleshooting.md +158 -0
  133. package/data/shared/framework/skills/security-audit/SKILL.md +83 -0
  134. package/data/shared/framework/skills/security-audit/assets/sample-output.md +451 -0
  135. package/data/shared/framework/skills/security-audit/references/owasp-checklist.md +580 -0
  136. package/data/shared/framework/skills/security-audit/references/secure-coding-patterns.md +433 -0
  137. package/data/shared/framework/skills/security-audit/references/vulnerability-remediation.md +331 -0
  138. package/data/shared/framework/skills/ui-generation/SKILL.md +70 -0
  139. package/data/shared/framework/skills/ui-generation/assets/sample-output.md +139 -0
  140. package/data/shared/framework/skills/ui-generation/references/accessibility-responsive.md +127 -0
  141. package/data/shared/framework/skills/ui-generation/references/compound-components.md +252 -0
  142. package/data/shared/framework/skills/ui-generation/references/generation-patterns.md +110 -0
  143. package/data/shared/framework/skills/ui-generation/references/storybook-design-system.md +278 -0
  144. package/data/shared/framework/skills/ui-generation/references/troubleshooting.md +198 -0
  145. package/data/shared/framework/workflows/documentation-management.md +58 -0
  146. package/data/shared/framework/workflows/primary-workflow.md +88 -0
  147. package/dist/commands/activate.d.ts +3 -0
  148. package/dist/commands/activate.d.ts.map +1 -0
  149. package/dist/commands/activate.js +34 -0
  150. package/dist/commands/activate.js.map +1 -0
  151. package/dist/commands/bundle.d.ts +3 -0
  152. package/dist/commands/bundle.d.ts.map +1 -0
  153. package/dist/commands/bundle.js +64 -0
  154. package/dist/commands/bundle.js.map +1 -0
  155. package/dist/commands/install.d.ts +3 -0
  156. package/dist/commands/install.d.ts.map +1 -0
  157. package/dist/commands/install.js +99 -0
  158. package/dist/commands/install.js.map +1 -0
  159. package/dist/commands/list.d.ts +3 -0
  160. package/dist/commands/list.d.ts.map +1 -0
  161. package/dist/commands/list.js +37 -0
  162. package/dist/commands/list.js.map +1 -0
  163. package/dist/commands/search.d.ts +3 -0
  164. package/dist/commands/search.d.ts.map +1 -0
  165. package/dist/commands/search.js +30 -0
  166. package/dist/commands/search.js.map +1 -0
  167. package/dist/commands/status.d.ts +3 -0
  168. package/dist/commands/status.d.ts.map +1 -0
  169. package/dist/commands/status.js +35 -0
  170. package/dist/commands/status.js.map +1 -0
  171. package/dist/commands/update.d.ts +3 -0
  172. package/dist/commands/update.d.ts.map +1 -0
  173. package/dist/commands/update.js +68 -0
  174. package/dist/commands/update.js.map +1 -0
  175. package/dist/download/cache.d.ts +3 -0
  176. package/dist/download/cache.d.ts.map +1 -0
  177. package/dist/download/cache.js +18 -0
  178. package/dist/download/cache.js.map +1 -0
  179. package/dist/download/client.d.ts +2 -0
  180. package/dist/download/client.d.ts.map +1 -0
  181. package/dist/download/client.js +58 -0
  182. package/dist/download/client.js.map +1 -0
  183. package/dist/index.d.ts +3 -0
  184. package/dist/index.d.ts.map +1 -0
  185. package/dist/index.js +23 -0
  186. package/dist/index.js.map +1 -0
  187. package/dist/installer/file-copier.d.ts +6 -0
  188. package/dist/installer/file-copier.d.ts.map +1 -0
  189. package/dist/installer/file-copier.js +32 -0
  190. package/dist/installer/file-copier.js.map +1 -0
  191. package/dist/installer/plugin-installer.d.ts +12 -0
  192. package/dist/installer/plugin-installer.d.ts.map +1 -0
  193. package/dist/installer/plugin-installer.js +33 -0
  194. package/dist/installer/plugin-installer.js.map +1 -0
  195. package/dist/installer/template-installer.d.ts +12 -0
  196. package/dist/installer/template-installer.d.ts.map +1 -0
  197. package/dist/installer/template-installer.js +45 -0
  198. package/dist/installer/template-installer.js.map +1 -0
  199. package/dist/license/crypto.d.ts +16 -0
  200. package/dist/license/crypto.d.ts.map +1 -0
  201. package/dist/license/crypto.js +50 -0
  202. package/dist/license/crypto.js.map +1 -0
  203. package/dist/license/license-store.d.ts +19 -0
  204. package/dist/license/license-store.d.ts.map +1 -0
  205. package/dist/license/license-store.js +99 -0
  206. package/dist/license/license-store.js.map +1 -0
  207. package/dist/license/validator.d.ts +32 -0
  208. package/dist/license/validator.d.ts.map +1 -0
  209. package/dist/license/validator.js +81 -0
  210. package/dist/license/validator.js.map +1 -0
  211. package/dist/registry/loader.d.ts +30 -0
  212. package/dist/registry/loader.d.ts.map +1 -0
  213. package/dist/registry/loader.js +22 -0
  214. package/dist/registry/loader.js.map +1 -0
  215. package/dist/registry/search-engine.d.ts +9 -0
  216. package/dist/registry/search-engine.d.ts.map +1 -0
  217. package/dist/registry/search-engine.js +30 -0
  218. package/dist/registry/search-engine.js.map +1 -0
  219. package/dist/utils/config.d.ts +14 -0
  220. package/dist/utils/config.d.ts.map +1 -0
  221. package/dist/utils/config.js +28 -0
  222. package/dist/utils/config.js.map +1 -0
  223. package/dist/utils/logger.d.ts +9 -0
  224. package/dist/utils/logger.d.ts.map +1 -0
  225. package/dist/utils/logger.js +22 -0
  226. package/dist/utils/logger.js.map +1 -0
  227. package/dist/utils/paths.d.ts +20 -0
  228. package/dist/utils/paths.d.ts.map +1 -0
  229. package/dist/utils/paths.js +79 -0
  230. package/dist/utils/paths.js.map +1 -0
  231. package/package.json +54 -0
@@ -0,0 +1,70 @@
1
+ ---
2
+ name: retrospective
3
+ description: Conduct project retrospectives — gather lessons learned, identify process improvements, and collect team feedback.
4
+ ---
5
+
6
+ # Project Retrospective
7
+
8
+ ## Triggers
9
+
10
+ - Project completion and final delivery
11
+ - Phase or milestone completion
12
+ - Major incident resolution (post-mortem)
13
+ - Quarterly team review
14
+
15
+ ## Process
16
+
17
+ ### 1. Data Gathering
18
+
19
+ Collect objective data before the session:
20
+
21
+ - Project metrics (velocity, defect rate, release frequency, budget vs actual)
22
+ - Timeline of key events (milestones, scope changes, incidents, team changes)
23
+ - Client feedback received during the project
24
+ - Team survey results (anonymous, collected beforehand)
25
+ - Sprint retrospective action items and their completion rate
26
+
27
+ ### 2. Insight Generation
28
+
29
+ Facilitate a structured discussion (60-90 minutes):
30
+
31
+ - Use a retrospective technique suited to the project (see references)
32
+ - Focus on patterns, not individual events
33
+ - Separate observations from opinions
34
+ - Capture both process and technical insights
35
+ - Ensure every team member contributes (use round-robin or anonymous input)
36
+
37
+ ### 3. Action Planning
38
+
39
+ Convert insights into concrete actions:
40
+
41
+ - Each action item must be SMART (Specific, Measurable, Achievable, Relevant, Time-bound)
42
+ - Assign an owner to every action item
43
+ - Limit to 5-7 high-impact items (do not overcommit)
44
+ - Distinguish project-level vs organization-level improvements
45
+ - Set a follow-up date to review progress
46
+
47
+ ### 4. Documentation
48
+
49
+ Produce the lessons learned report:
50
+
51
+ - Project summary and context
52
+ - What went well (with evidence)
53
+ - What could be improved (with root cause)
54
+ - Key decisions and their outcomes
55
+ - Actionable recommendations
56
+ - Share with project team, management, and knowledge base
57
+
58
+ ## Key Principles
59
+
60
+ - **Blameless**: Focus on systems and processes, not individuals.
61
+ - **Evidence-based**: Back observations with data and specific examples.
62
+ - **Forward-looking**: The goal is to improve future projects, not to judge the past.
63
+ - **Inclusive**: Every role (dev, QA, PM, design, DevOps) brings a unique perspective.
64
+ - **Action-oriented**: A retrospective without action items is just a complaint session.
65
+
66
+ ## References
67
+
68
+ - `references/retro-techniques.md` — Facilitation formats and tools
69
+ - `references/lessons-learned-template.md` — Documentation template
70
+ - `assets/sample-output.md` — Example retrospective report
@@ -0,0 +1,79 @@
1
+ ---
2
+ name: sample-retrospective
3
+ description: Sample project retrospective for a Mobile Banking App project with lessons learned and action items.
4
+ ---
5
+
6
+ # Project Retrospective — Mobile Banking App
7
+
8
+ **Project**: SecureBank Mobile App v1.0
9
+ **Client**: SecureBank Financial Services
10
+ **Duration**: 2025-06-01 to 2025-12-20 (7 months)
11
+ **Team**: 12 members (4 backend, 3 mobile, 2 QA, 1 DevOps, 1 BA, 1 PM)
12
+ **Stack**: React Native, Node.js, PostgreSQL, AWS, Plaid API
13
+
14
+ ---
15
+
16
+ ## Project Summary
17
+
18
+ Delivered a mobile banking app with account management, fund transfers, bill payments, and spending analytics. Fixed-price contract. Launched on schedule with 2 weeks buffer used for performance optimization. Client rated delivery 4.2/5 overall.
19
+
20
+ ## What Went Well
21
+
22
+ | # | Area | What Happened | Evidence |
23
+ |---|---|---|---|
24
+ | 1 | Architecture | Modular API design allowed parallel development across features | 3 feature teams worked independently; zero merge conflicts on API contracts |
25
+ | 2 | Testing | Early investment in E2E test suite caught 23 critical bugs before UAT | UAT defect rate: 0.8 bugs/story point (team average: 2.1) |
26
+ | 3 | Client communication | Weekly demo + daily async updates via Slack kept client aligned | Zero scope disputes; all 4 change requests processed through CR workflow |
27
+ | 4 | Security | Engaged security review at Sprint 3, not Sprint 10 | Passed PCI-DSS pre-assessment on first attempt; zero findings in pentest |
28
+ | 5 | DevOps | CI/CD pipeline with automated security scanning from week 2 | Average deployment time: 12 minutes; 94 production deployments total |
29
+
30
+ ## What Could Be Improved
31
+
32
+ | # | Area | What Happened | Root Cause | Improvement |
33
+ |---|---|---|---|---|
34
+ | 1 | Estimation | Fund transfer module took 2.5x estimated effort | Underestimated Plaid API integration complexity and edge cases | Add spike/POC for third-party API integrations before estimating |
35
+ | 2 | Mobile testing | Delayed discovery of performance issues on older Android devices | Only tested on flagship devices until Sprint 8 | Define device matrix in Sprint 0; include budget Android devices from day 1 |
36
+ | 3 | BA capacity | BA was shared across 2 projects; requirement gaps in Sprints 4-6 | Resource allocation; BA had conflicting priorities | Dedicated BA for fixed-price projects above 5-person team |
37
+ | 4 | Timezone | 6-hour timezone gap caused 1-day delay on every blocker needing client input | Offshore-onshore model without overlap hours | Establish 2-hour daily overlap window; empower team to make low-risk decisions independently |
38
+
39
+ ## Key Decisions and Outcomes
40
+
41
+ | Decision | Rationale | Outcome | Same Again? |
42
+ |---|---|---|---|
43
+ | React Native over native iOS + Android | Faster delivery, shared codebase, client budget constraint | Delivered on time; performance acceptable after optimization | Yes, for this scope. Would reconsider for graphics-heavy apps |
44
+ | Plaid for banking integration | Client preference, market leader | Worked but integration was harder than expected. Documentation gaps | Yes, but add 40% buffer for integration effort |
45
+ | Feature flags for gradual rollout | Reduce risk of big-bang launch | Caught a payment rounding bug affecting 2% of users before full rollout | Absolutely yes |
46
+
47
+ ## Team Feedback Summary (Anonymized)
48
+
49
+ **Positive themes** (mentioned by 3+ people):
50
+ - "Best CI/CD setup I have worked with — fast feedback loop"
51
+ - "PM handled scope changes professionally — team was protected"
52
+ - "Good knowledge sharing — pair programming sessions were valuable"
53
+
54
+ **Improvement themes** (mentioned by 3+ people):
55
+ - "Too many meetings on Tuesdays — lost half the day"
56
+ - "Requirement documents arrived late for Sprints 4-6"
57
+ - "Need better device lab for mobile testing"
58
+
59
+ ## Action Items
60
+
61
+ | # | Action | Owner | Target | Priority |
62
+ |---|---|---|---|---|
63
+ | 1 | Create Plaid integration starter template for future banking projects | Tuan (Tech Lead) | 2026-01-15 | High |
64
+ | 2 | Define standard device testing matrix for mobile projects | QA Lead | 2026-01-10 | High |
65
+ | 3 | Update estimation playbook: add "third-party API complexity" factor | BA Team | 2026-01-31 | High |
66
+ | 4 | Propose dedicated BA policy for fixed-price projects >5 people | Delivery Manager | 2026-02-01 | Medium |
67
+ | 5 | Reduce recurring meetings — consolidate Tuesday syncs into 1 session | PM | Immediate | Medium |
68
+ | 6 | Add React Native performance testing to CI pipeline template | DevOps | 2026-02-15 | Medium |
69
+
70
+ ## Metrics Summary
71
+
72
+ | Metric | Planned | Actual |
73
+ |---|---|---|
74
+ | Duration | 28 weeks | 29 weeks (1 week buffer used) |
75
+ | Budget | $480,000 | $465,000 (3% under) |
76
+ | Story points delivered | 340 | 358 (includes 4 CRs) |
77
+ | Production defects (first 30 days) | — | 3 (1 P3, 2 P4) |
78
+ | Client satisfaction | — | 4.2 / 5.0 |
79
+ | Team satisfaction | — | 4.0 / 5.0 |
@@ -0,0 +1,178 @@
1
+ ---
2
+ name: facilitation-techniques
3
+ description: Advanced retrospective facilitation techniques — 4Ls, Sailboat, Timeline, Mad/Sad/Glad, distributed adaptations, and action item tracking.
4
+ ---
5
+
6
+ # Retrospective Facilitation Techniques (Advanced)
7
+
8
+ ## 4Ls Technique (Liked, Learned, Lacked, Longed For)
9
+
10
+ Best for: End-of-project retros, milestone reviews, teams wanting structured reflection.
11
+
12
+ ### Setup
13
+ 1. Create a board (physical or digital) with 4 columns
14
+ 2. Label each column: Liked, Learned, Lacked, Longed For
15
+ 3. Distribute sticky notes / cards (3-5 per person per column)
16
+ 4. Set a visible timer for each phase
17
+
18
+ ### Facilitation Script
19
+
20
+ | Phase | Duration | Facilitator Action |
21
+ |-------|----------|-------------------|
22
+ | Introduction | 3 min | Explain the 4 columns, give examples for each, set ground rules (no blame, be specific) |
23
+ | Silent writing | 10 min | Everyone writes independently. No talking. Play ambient music if in-person |
24
+ | Liked | 8 min | Each person shares their Liked items. Facilitator groups similar items. No debate yet |
25
+ | Learned | 8 min | Share Learned items. Highlight learnings that should be carried to next project |
26
+ | Lacked | 8 min | Share Lacked items. Facilitator notes patterns. Encourage "I needed X" not "You failed to give X" |
27
+ | Longed For | 8 min | Share Longed For items. Focus on forward-looking wishes, not complaints |
28
+ | Dot voting | 5 min | Each person gets 5 votes across all columns. Vote on items most important to act on |
29
+ | Action planning | 10 min | Top 3-5 voted items become action items. Assign owners and deadlines |
30
+
31
+ **Total time**: 60 minutes.
32
+
33
+ ### Tip
34
+ Combine "Lacked" and "Longed For" findings — Lacked identifies the gap, Longed For often suggests the solution.
35
+
36
+ ## Sailboat Technique
37
+
38
+ Best for: Visual teams, complex projects, identifying both enablers and blockers simultaneously.
39
+
40
+ ### Visual Diagram
41
+
42
+ ```
43
+ 🏝️ ISLAND (Goal/Destination)
44
+ /
45
+ /
46
+ ⛵ SAILBOAT ---/
47
+ / | \
48
+ / | \ 💨 WIND (Helps us move forward)
49
+ / | \ - Good practices
50
+ | - Helpful tools
51
+ | - Supportive people
52
+ ⚓ ANCHOR
53
+ (Holds us back) 🪨 ROCKS (Hidden risks)
54
+ - Blockers - Near-misses
55
+ - Inefficiencies - Potential dangers
56
+ - Process gaps - Technical debt
57
+ ```
58
+
59
+ ### Facilitation Steps
60
+
61
+ 1. **Draw the sailboat** on a whiteboard or shared canvas (5 min)
62
+ 2. **Explain the metaphor** — the boat is the team, we are sailing toward the island (our goal) (3 min)
63
+ 3. **Silent brainstorming** — each person writes items for all 4 elements (10 min)
64
+ 4. **Wind discussion** — what propelled us forward? Group and discuss (8 min)
65
+ 5. **Anchor discussion** — what held us back? Be specific about impact (8 min)
66
+ 6. **Rocks discussion** — what risks did we encounter or narrowly avoid? (8 min)
67
+ 7. **Island discussion** — did we reach our destination? What changed along the way? (5 min)
68
+ 8. **Prioritize and plan** — dot vote, create action items (10 min)
69
+
70
+ **Total time**: 55-60 minutes.
71
+
72
+ ## Timeline Technique
73
+
74
+ Best for: Long projects (3+ months), projects with many phases, understanding cause-and-effect.
75
+
76
+ ### Setup
77
+ 1. Draw a horizontal timeline on a large surface (whiteboard, Miro board)
78
+ 2. Mark project milestones: kickoff, sprints, releases, major events
79
+ 3. Prepare two colors of sticky notes: green (positive events), red (negative events)
80
+
81
+ ### Facilitation Steps
82
+
83
+ | Phase | Duration | Activity |
84
+ |-------|----------|----------|
85
+ | Setup | 5 min | Draw timeline with milestones. Explain the exercise |
86
+ | Individual mapping | 15 min | Each person places events on the timeline (silent) |
87
+ | Walk-through | 20 min | Walk chronologically. Read each note. Author elaborates briefly |
88
+ | Pattern identification | 10 min | Look for clusters. Ask: "What caused this group of issues in Sprint 3?" |
89
+ | Metric correlation | 5 min | Overlay velocity, bug count, or team mood data if available |
90
+ | Root cause analysis | 10 min | For the top 3 problem clusters, ask "5 Whys" |
91
+ | Action items | 10 min | Convert root causes into preventive actions for future projects |
92
+
93
+ **Total time**: 75 minutes.
94
+
95
+ ### Pattern Signals to Watch For
96
+ - **Cluster of red notes** around a specific date — indicates a systemic issue, not isolated incidents
97
+ - **Green-to-red transition** — something changed; identify what triggered the shift
98
+ - **Recurring themes** across multiple sprints — indicates unresolved root cause
99
+ - **Silent periods** — no notes may mean disengagement, not smooth sailing
100
+
101
+ ## Mad / Sad / Glad
102
+
103
+ Best for: Short retros (30 min), sprint retros, quick pulse checks.
104
+
105
+ | Column | Prompt | Example |
106
+ |--------|--------|---------|
107
+ | **Mad** | What frustrated you? What made you angry? | "Deploy process took 2 hours every time" |
108
+ | **Sad** | What disappointed you? What could have been better? | "We didn't get to implement the feature we planned" |
109
+ | **Glad** | What made you happy? What went well? | "Pair programming sessions were really productive" |
110
+
111
+ **Format**: 5 min write, 10 min share and group, 5 min vote, 10 min action planning.
112
+
113
+ **When to use over other techniques**: When time is limited, when the team needs emotional release, when you want a low-overhead format that still produces action items.
114
+
115
+ ## Facilitation Best Practices
116
+
117
+ ### Timeboxing
118
+ - **Set a visible timer** for every phase — teams respect time when they can see it counting down
119
+ - **Announce transitions** clearly: "Writing time is over. Let's share Liked items now"
120
+ - **Buffer 5 minutes** between discussion and action planning for mental transition
121
+ - **Hard stop** — end on time even if discussion is ongoing. Capture remaining items in a parking lot
122
+
123
+ ### Dot Voting for Prioritization
124
+ 1. Give each participant **3-5 votes** (fewer votes = more focused prioritization)
125
+ 2. Allow **multi-voting** on a single item (max 2 votes per item per person)
126
+ 3. **Vote silently** — no campaigning for items before voting
127
+ 4. Tally immediately and announce top 5
128
+ 5. Only create action items for the **top 3** — better to do 3 well than 7 poorly
129
+
130
+ ### Silent Brainstorming Before Discussion
131
+ - **Always start with silent writing** (5-10 min) before any verbal sharing
132
+ - Prevents groupthink — introverts and junior members contribute their genuine thoughts
133
+ - Prevents anchoring — the first speaker doesn't set the agenda for everyone
134
+ - Produces 2-3x more unique items than open discussion alone
135
+
136
+ ## Distributed Team Adaptations
137
+
138
+ ### Async Retro Boards
139
+ - **Miro / FigJam**: Create a template board, share link 2-3 days before the session. Team adds items async
140
+ - **Notion / Confluence**: Create a page with sections. Team adds bullet points over 2 days
141
+ - **RetroTool / EasyRetro**: Purpose-built async retro tools with anonymous mode and voting
142
+
143
+ ### Async-First Flow
144
+ 1. **Day 1-2**: Share the board. Team adds items asynchronously (no discussion yet)
145
+ 2. **Day 3**: Facilitator groups similar items, identifies themes
146
+ 3. **Day 3-4**: Team votes asynchronously (dot voting on the board)
147
+ 4. **Day 5**: 30-min synchronous call to discuss top-voted items and assign actions
148
+
149
+ ### Timezone-Fair Scheduling
150
+ - **Rotate meeting times** — do not always favor one timezone
151
+ - **Record sessions** (with consent) for team members who cannot attend
152
+ - **Async follow-up** — post action items in a shared channel within 24 hours
153
+ - **Equal voice** — if some people are async, ensure their written items get equal discussion time
154
+
155
+ ## Action Item Tracking
156
+
157
+ ### SMART Format for Retro Actions
158
+
159
+ | Attribute | Question to Ask | Bad Example | Good Example |
160
+ |-----------|----------------|-------------|--------------|
161
+ | **Specific** | What exactly will we do? | "Improve communication" | "Create a #blockers Slack channel and post daily" |
162
+ | **Measurable** | How will we know it's done? | "Write more tests" | "Increase API test coverage from 40% to 70%" |
163
+ | **Achievable** | Can we do this in one sprint? | "Rewrite the monolith" | "Extract payment service into a separate module" |
164
+ | **Relevant** | Does this address a top-voted retro item? | "Adopt a new framework" | "Add automated deploy to reduce 2-hour manual process" |
165
+ | **Time-bound** | When will it be done? | "Soon" | "Complete by end of Sprint 12 (March 28)" |
166
+
167
+ ### Owner Assignment
168
+ - Every action item **must have exactly one owner** (not "the team")
169
+ - Owner is accountable for completion, not necessarily the sole doer
170
+ - If no one volunteers, facilitator assigns based on expertise and capacity
171
+ - Owner confirms acceptance before the retro ends
172
+
173
+ ### Follow-Up in Next Retro
174
+ - **First 5 minutes** of every retro: review action items from the previous retro
175
+ - Status for each item: Done / In Progress / Blocked / Dropped
176
+ - **Track completion rate** — healthy teams complete 70%+ of retro action items
177
+ - If an item is carried forward 3 times, either escalate it or consciously drop it
178
+ - Maintain a running retro action log (spreadsheet or Jira board) visible to the whole team
@@ -0,0 +1,118 @@
1
+ ---
2
+ name: lessons-learned-template
3
+ description: Structured template for documenting lessons learned — project summary, outcomes, recommendations, and organizational action items.
4
+ ---
5
+
6
+ # Lessons Learned Template
7
+
8
+ ## Project Summary
9
+
10
+ | Field | Value |
11
+ |---|---|
12
+ | Project name | |
13
+ | Client | |
14
+ | Duration | Start date — End date |
15
+ | Team size | Peak / Average |
16
+ | Technology stack | |
17
+ | Delivery model | Fixed price / T&M / Dedicated team |
18
+ | Budget | Planned vs Actual |
19
+ | Scope changes | Number of CRs, impact on timeline |
20
+
21
+ ## What Went Well
22
+
23
+ For each item, include evidence or metrics:
24
+
25
+ | # | Area | What Happened | Evidence / Metric |
26
+ |---|---|---|---|
27
+ | 1 | | | |
28
+ | 2 | | | |
29
+ | 3 | | | |
30
+
31
+ Areas to consider: delivery speed, code quality, client communication, team collaboration, tooling, testing strategy, DevOps practices, requirement clarity.
32
+
33
+ ## What Could Be Improved
34
+
35
+ For each item, identify root cause:
36
+
37
+ | # | Area | What Happened | Root Cause | Suggested Improvement |
38
+ |---|---|---|---|---|
39
+ | 1 | | | | |
40
+ | 2 | | | | |
41
+ | 3 | | | | |
42
+
43
+ Common root causes in ITO/outsourcing: timezone gap, unclear requirements, scope creep without CR process, insufficient domain knowledge, dependency on client for decisions, under-estimated complexity.
44
+
45
+ ## Key Decisions and Outcomes
46
+
47
+ | Decision | When | Rationale | Outcome | Would We Decide the Same Again? |
48
+ |---|---|---|---|---|
49
+ | | | | | |
50
+
51
+ Examples: technology choice, architectural pattern, team structure, process adoption, build vs buy.
52
+
53
+ ## Process Recommendations
54
+
55
+ For future projects with similar characteristics:
56
+
57
+ **Estimation**:
58
+ - What estimation technique worked? What did not?
59
+ - How accurate were initial estimates vs actuals?
60
+ - Recommendations for buffer and contingency.
61
+
62
+ **Development process**:
63
+ - Sprint length that worked best
64
+ - Code review practices that added value
65
+ - Testing strategy effectiveness (unit, integration, E2E, manual)
66
+ - CI/CD pipeline lessons
67
+
68
+ **Communication**:
69
+ - Meeting cadence that worked (too many, too few, just right)
70
+ - Tools that helped vs added noise
71
+ - Client communication frequency and format
72
+ - Offshore-onshore collaboration patterns
73
+
74
+ **Quality**:
75
+ - Defect density trend
76
+ - Production incidents caused by code vs infrastructure vs config
77
+ - Test coverage targets and whether they were realistic
78
+
79
+ ## Technology Recommendations
80
+
81
+ | Technology / Tool | Verdict | Notes |
82
+ |---|---|---|
83
+ | | Keep / Replace / Evaluate | |
84
+
85
+ Capture: what worked, what caused pain, what you would choose differently.
86
+
87
+ ## Team Feedback Summary (Anonymized)
88
+
89
+ Aggregate themes from anonymous team survey:
90
+
91
+ **Positive themes**:
92
+ - (e.g., "Good team collaboration", "PM shielded team from scope changes effectively")
93
+
94
+ **Improvement themes**:
95
+ - (e.g., "Requirements were often unclear", "Too many meetings broke focus time")
96
+
97
+ **Individual growth**:
98
+ - Skills gained by the team (new technologies, domain knowledge, soft skills)
99
+ - Training needs identified for future projects
100
+
101
+ ## Action Items for Organization
102
+
103
+ Items that go beyond this project — improvements for the company:
104
+
105
+ | # | Action | Category | Owner | Target Date | Priority |
106
+ |---|---|---|---|---|---|
107
+ | 1 | | Process / Tooling / Training / Hiring | | | High / Medium / Low |
108
+ | 2 | | | | | |
109
+ | 3 | | | | | |
110
+
111
+ ## Distribution
112
+
113
+ | Audience | Content | Format |
114
+ |---|---|---|
115
+ | Project team | Full report | Shared document |
116
+ | Delivery management | Summary + recommendations | Presentation |
117
+ | Sales / Pre-sales | Reusable case study material | Extracted highlights |
118
+ | Organization knowledge base | Full report (anonymized if needed) | Wiki / Confluence |
@@ -0,0 +1,100 @@
1
+ ---
2
+ name: retro-techniques
3
+ description: Retrospective facilitation techniques — formats, prioritization, action planning, and remote facilitation tips.
4
+ ---
5
+
6
+ # Retrospective Facilitation Techniques
7
+
8
+ ## Start / Stop / Continue
9
+
10
+ Best for: Regular sprint retros, straightforward projects.
11
+
12
+ | Column | Prompt |
13
+ |---|---|
14
+ | **Start** | What should we begin doing that we are not doing today? |
15
+ | **Stop** | What should we stop doing because it hurts more than it helps? |
16
+ | **Continue** | What is working well and should keep going? |
17
+
18
+ Time: 10 min write, 15 min discuss, 10 min vote and plan.
19
+
20
+ ## 4Ls (Liked, Learned, Lacked, Longed For)
21
+
22
+ Best for: End-of-project retros, teams new to retrospectives.
23
+
24
+ | Column | Prompt |
25
+ |---|---|
26
+ | **Liked** | What did you enjoy or appreciate about this project? |
27
+ | **Learned** | What new knowledge or skills did you gain? |
28
+ | **Lacked** | What was missing that would have helped? |
29
+ | **Longed for** | What do you wish had been different? |
30
+
31
+ Time: 10 min write, 20 min discuss, 10 min actions.
32
+
33
+ ## Sailboat Method
34
+
35
+ Best for: Visual thinkers, longer projects, identifying risks.
36
+
37
+ Draw a sailboat with four elements:
38
+
39
+ - **Wind** (sails): What helped us move forward? (tools, practices, people)
40
+ - **Anchor**: What held us back? (blockers, inefficiencies, gaps)
41
+ - **Rocks** (underwater): What risks almost hit us or could hit future projects?
42
+ - **Island** (destination): What was our goal and did we reach it?
43
+
44
+ Time: 5 min explain, 10 min write, 25 min discuss, 10 min actions.
45
+
46
+ ## Timeline Retrospective
47
+
48
+ Best for: Long projects (6+ months), complex projects with many phases.
49
+
50
+ 1. Draw a horizontal timeline with project milestones
51
+ 2. Each team member adds sticky notes for key events (positive and negative)
52
+ 3. Walk through chronologically, discuss clusters and patterns
53
+ 4. Identify turning points and root causes
54
+
55
+ Time: 60-90 min (longer format needed).
56
+
57
+ ## Dot Voting for Prioritization
58
+
59
+ After collecting items in any format:
60
+
61
+ 1. Each participant gets 3-5 votes (dots)
62
+ 2. Vote on the items you think are most important to address
63
+ 3. Tally votes — top items become action candidates
64
+ 4. Discuss the top 5-7 voted items
65
+ 5. Convert to action items with owners
66
+
67
+ This prevents endless discussion on low-impact items.
68
+
69
+ ## Action Item SMART Format
70
+
71
+ Every action item should be:
72
+
73
+ | Attribute | Bad Example | Good Example |
74
+ |---|---|---|
75
+ | **Specific** | "Improve testing" | "Add integration tests for payment flow" |
76
+ | **Measurable** | "Write more tests" | "Increase payment module coverage from 45% to 80%" |
77
+ | **Achievable** | "Achieve 100% coverage" | "Add 15 integration tests in next sprint" |
78
+ | **Relevant** | "Rewrite the frontend" | "Add retry logic to prevent payment timeout recurrence" |
79
+ | **Time-bound** | "Eventually" | "Complete by end of Sprint 24 (March 14)" |
80
+
81
+ ## Anonymous Feedback Collection
82
+
83
+ When team dynamics might prevent open discussion:
84
+
85
+ - **Pre-retro survey**: Send a Google Form or Typeform 2 days before the session with open-ended questions
86
+ - **Anonymous board**: Use Miro, FigJam, or RetroTool with anonymous mode enabled
87
+ - **Written-first format**: Everyone writes silently before any discussion begins
88
+ - **Facilitator reads aloud**: Facilitator reads anonymous items so no one is identified by handwriting or typing style
89
+
90
+ When to use anonymous: new teams, conflict situations, cross-cultural teams where hierarchy may suppress honest feedback.
91
+
92
+ ## Remote Retrospective Tips
93
+
94
+ - **Use a shared board** (Miro, FigJam, Notion) — do not rely on verbal-only discussion
95
+ - **Timebox strictly** — remote meetings lose energy faster than in-person
96
+ - **Camera on** (if culturally appropriate) — non-verbal cues matter for sensitive topics
97
+ - **Silent writing first** — prevents groupthink and ensures introverts contribute
98
+ - **Breakout rooms** for large teams (>8 people) — discuss in groups of 3-4, then share back
99
+ - **Record the session** (with consent) for absent members
100
+ - **Follow up in writing** within 24 hours with action items and owners
@@ -0,0 +1,71 @@
1
+ ---
2
+ name: transition-manager
3
+ description: Use this agent to manage the complete post-project transition — coordinates handover, maintenance setup, retrospective, and client feedback activities. Best for end-of-project orchestration.
4
+ tools: Glob, Grep, LS, Read, Edit, Write, WebFetch
5
+ ---
6
+
7
+ You are a Senior Transition Manager with extensive experience in IT outsourcing project closures and transitions. You ensure smooth handovers, establish maintenance processes, capture lessons learned, and nurture client relationships.
8
+
9
+ ## Core Responsibilities
10
+
11
+ ### 1. Project Handover
12
+ - Activate `handover` skill
13
+ - Ensure all documentation is complete and accurate
14
+ - Plan and track knowledge transfer sessions
15
+ - Verify receiving team readiness
16
+
17
+ ### 2. Maintenance Setup
18
+ - Activate `maintenance-support` skill
19
+ - Define SLA agreements with client
20
+ - Setup incident management process
21
+ - Establish on-call and escalation procedures
22
+
23
+ ### 3. Retrospective Facilitation
24
+ - Activate `retrospective` skill
25
+ - Run project retrospective while context is fresh
26
+ - Capture lessons learned for organizational knowledge base
27
+ - Create improvement action items
28
+
29
+ ### 4. Client Relationship
30
+ - Activate `client-feedback` skill
31
+ - Collect client satisfaction data
32
+ - Address concerns before contract closure
33
+ - Identify and propose expansion opportunities
34
+
35
+ ## Operational Guidelines
36
+
37
+ - Start retrospective early — don't wait until last day
38
+ - Handover documentation should enable self-sufficiency
39
+ - SLAs must be realistic and measurable
40
+ - Client feedback should drive both immediate fixes and long-term improvements
41
+ - Maintain professional relationship even during project closure
42
+
43
+ ## Error Recovery
44
+
45
+ Reference: `rules/development-rules.md` and `protocols/error-recovery.md`
46
+
47
+ ### Retry Policy
48
+ - Max retries: from config.thresholds.maxRetries (default: 3)
49
+ - Between retries: analyze failure, adjust approach
50
+ - After max retries: STOP, report with context
51
+
52
+ ### Escalation
53
+ | Failure | Action |
54
+ |---------|--------|
55
+ | KT receiving team not understanding | Repeat session with different approach, max 2 repeats |
56
+ | Missing documentation for handover | Flag as gap, create minimal doc, schedule follow-up |
57
+ | SLA targets unrealistic | Present data to user, recommend adjusted targets |
58
+ | Client feedback negative | Escalate immediately, don't wait for full analysis |
59
+
60
+ ## Checkpoint Protocol
61
+
62
+ After completing each phase (Retrospective → Handover → Feedback → Maintenance):
63
+ 1. Save deliverable output
64
+ 2. Log: phase completed, key findings, pending items
65
+ 3. If interrupted: next session can resume from last completed phase
66
+
67
+ ## Model Usage
68
+ - Documentation tasks: primary model
69
+ - Survey/feedback analysis: primary model
70
+ - Template filling: lightweight model
71
+ - Fall back per config if primary unavailable