agent-toolkit-cli 1.0.3__py3-none-any.whl

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 (310) hide show
  1. agent_toolkit/__init__.py +4 -0
  2. agent_toolkit/__main__.py +3 -0
  3. agent_toolkit/_paths.py +64 -0
  4. agent_toolkit/cli/__init__.py +0 -0
  5. agent_toolkit/cli/doctor.py +453 -0
  6. agent_toolkit/cli/install.py +445 -0
  7. agent_toolkit/cli/main.py +66 -0
  8. agent_toolkit/cli/mcp.py +418 -0
  9. agent_toolkit/cli/plugin.py +213 -0
  10. agent_toolkit/cli/skills.py +421 -0
  11. agent_toolkit/loop/__init__.py +0 -0
  12. agent_toolkit/loop/gh_gate.py +626 -0
  13. agent_toolkit/loop/runner.py +1548 -0
  14. agent_toolkit/runner/__init__.py +0 -0
  15. agent_toolkit/runner/dispatcher.py +164 -0
  16. agent_toolkit/runner/policy.py +345 -0
  17. agent_toolkit/runner/providers/__init__.py +21 -0
  18. agent_toolkit/runner/providers/anthropic_provider.py +109 -0
  19. agent_toolkit/runner/providers/base.py +53 -0
  20. agent_toolkit/runner/providers/ollama_provider.py +108 -0
  21. agent_toolkit/runner/providers/openai_provider.py +105 -0
  22. agent_toolkit/runner/providers/opencode_provider.py +127 -0
  23. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/architect/AGENT.md +30 -0
  24. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/assistant/AGENT.md +59 -0
  25. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/build-error-resolver/AGENT.md +30 -0
  26. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/client-workflow-bootstrap/AGENT.md +60 -0
  27. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/code-reviewer/AGENT.md +49 -0
  28. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/database-reviewer/AGENT.md +44 -0
  29. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/docs-lookup/AGENT.md +28 -0
  30. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/e2e-runner/AGENT.md +38 -0
  31. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/performance-optimizer/AGENT.md +52 -0
  32. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/planner/AGENT.md +41 -0
  33. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/refactor-cleaner/AGENT.md +43 -0
  34. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/reference-lookup/AGENT.md +33 -0
  35. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/security-reviewer/AGENT.md +47 -0
  36. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/tdd-guide/AGENT.md +58 -0
  37. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/tech-assistant/AGENT.md +11 -0
  38. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/typescript-reviewer/AGENT.md +61 -0
  39. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/catalogs/agent-catalog.yaml +202 -0
  40. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/catalogs/loop-catalog.yaml +165 -0
  41. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/catalogs/skill-catalog.yaml +699 -0
  42. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/catalogs/skills-layout.json +337 -0
  43. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/changelog-drafter/loop.yaml +40 -0
  44. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/ci-sweeper/loop.yaml +53 -0
  45. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/daily-triage/loop.yaml +47 -0
  46. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/dep-sweeper/loop.yaml +46 -0
  47. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/issue-triage/loop.yaml +40 -0
  48. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/oss-daily-briefing/loop.yaml +65 -0
  49. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/oss-pr-monitor/loop.yaml +85 -0
  50. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/oss-triage/loop.yaml +67 -0
  51. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/post-merge-cleanup/loop.yaml +44 -0
  52. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/pr-babysitter/loop.yaml +46 -0
  53. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/clickup/README.md +45 -0
  54. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/clickup/config.template.json +7 -0
  55. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/clickup/wrapper.sh +23 -0
  56. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/figma/README.md +56 -0
  57. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/figma/config.template.json +9 -0
  58. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/github/README.md +11 -0
  59. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/github/config.template.json +7 -0
  60. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/github/wrapper.sh +23 -0
  61. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/linear/README.md +49 -0
  62. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/linear/config.template.json +10 -0
  63. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/notion/README.md +7 -0
  64. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/notion/config.template.json +7 -0
  65. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/notion/wrapper.sh +23 -0
  66. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/slack/README.md +8 -0
  67. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/slack/config.template.json +8 -0
  68. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/slack/wrapper.sh +23 -0
  69. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/CLAUDE.md +66 -0
  70. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/assistant.md +59 -0
  71. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/build-error-resolver.md +30 -0
  72. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/client-workflow-bootstrap.md +60 -0
  73. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/contribution-planner.md +39 -0
  74. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/database-reviewer.md +44 -0
  75. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/docs-lookup.md +28 -0
  76. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/e2e-runner.md +38 -0
  77. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/performance-optimizer.md +52 -0
  78. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/planner.md +41 -0
  79. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/refactor-cleaner.md +43 -0
  80. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/reference-lookup.md +33 -0
  81. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/security-reviewer.md +47 -0
  82. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/tdd-guide.md +58 -0
  83. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/typescript-reviewer.md +61 -0
  84. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/settings.json +87 -0
  85. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/copilot/copilot-instructions.md +15 -0
  86. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/README.md +33 -0
  87. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/architect.mdc +23 -0
  88. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/assistant.mdc +25 -0
  89. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/build-error-resolver.mdc +20 -0
  90. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/code-reviewer.mdc +21 -0
  91. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/database-reviewer.mdc +29 -0
  92. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/docs-lookup.mdc +15 -0
  93. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/e2e-runner.mdc +30 -0
  94. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/performance-optimizer.mdc +27 -0
  95. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/planner.mdc +28 -0
  96. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/refactor-cleaner.mdc +26 -0
  97. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/reference-lookup.mdc +20 -0
  98. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/security-reviewer.mdc +20 -0
  99. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/tdd-guide.mdc +26 -0
  100. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/typescript-reviewer.mdc +28 -0
  101. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/architect.md +30 -0
  102. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/assistant.md +52 -0
  103. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/build-error-resolver.md +31 -0
  104. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/client-workflow-bootstrap.md +66 -0
  105. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/code-reviewer.md +47 -0
  106. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/contribution-planner.md +44 -0
  107. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/database-reviewer.md +43 -0
  108. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/docs-lookup.md +28 -0
  109. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/e2e-runner.md +33 -0
  110. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/performance-optimizer.md +34 -0
  111. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/planner.md +27 -0
  112. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/refactor-cleaner.md +27 -0
  113. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/reference-lookup.md +27 -0
  114. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/security-reviewer.md +27 -0
  115. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/tdd-guide.md +27 -0
  116. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/typescript-reviewer.md +30 -0
  117. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/opencode.json +37 -0
  118. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/pi/skills/architect/skill.md +5 -0
  119. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/pi/skills/assistant/skill.md +3 -0
  120. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/pi/skills/code-reviewer/skill.md +5 -0
  121. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/pi/skills/planner/skill.md +3 -0
  122. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/pi/skills/security-reviewer/skill.md +3 -0
  123. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/memories/global_rules.md +74 -0
  124. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/architect.mdc +23 -0
  125. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/build-error-resolver.mdc +20 -0
  126. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/code-reviewer.mdc +21 -0
  127. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/database-reviewer.mdc +29 -0
  128. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/docs-lookup.mdc +15 -0
  129. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/e2e-runner.mdc +30 -0
  130. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/performance-optimizer.mdc +27 -0
  131. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/planner.mdc +28 -0
  132. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/refactor-cleaner.mdc +26 -0
  133. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/security-reviewer.mdc +20 -0
  134. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/tdd-guide.mdc +26 -0
  135. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/typescript-reviewer.mdc +28 -0
  136. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/assistant/SKILL.md +213 -0
  137. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/assistant/references/AGENTS_TEMPLATE.md +0 -0
  138. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/assistant/references/ORCHESTRATION.md +0 -0
  139. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/assistant/references/REPO_INSPECTION.md +0 -0
  140. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/dev-companion/SKILL.md +65 -0
  141. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/dev-companion/references/LOOP_GUARDRAILS.md +0 -0
  142. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/onboarding/SKILL.md +119 -0
  143. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/output-handshake/SKILL.md +24 -0
  144. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/pr-fallback/SKILL.md +33 -0
  145. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/pr-fallback/references/pr-body-default.md +0 -0
  146. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/workspace-knowledge-sync/SKILL.md +141 -0
  147. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/data/dbt-validation/SKILL.md +41 -0
  148. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/data/snowflake-validation/SKILL.md +38 -0
  149. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/adr/SKILL.md +46 -0
  150. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/adr/references/default-template.md +0 -0
  151. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/adr/references/example-001-graphql-adoption.md +66 -0
  152. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/agreement/SKILL.md +23 -0
  153. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/agreement/references/default-template.md +0 -0
  154. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/agreement/references/example-api-versioning.md +29 -0
  155. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/bug/SKILL.md +25 -0
  156. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/bug/references/default-template.md +0 -0
  157. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/bug/references/example-search-filter-bug.md +58 -0
  158. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/decision-log/SKILL.md +27 -0
  159. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/decision-log/references/default-template.md +0 -0
  160. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/decision-log/references/example-repository-pattern.md +27 -0
  161. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/development-workflow/SKILL.md +33 -0
  162. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/development-workflow/references/default-template.md +0 -0
  163. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/development-workflow/references/default-workflow-checklist.md +44 -0
  164. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/epic/SKILL.md +21 -0
  165. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/epic/references/default-template.md +0 -0
  166. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/epic/references/example-unified-dashboard.md +40 -0
  167. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/incident/SKILL.md +23 -0
  168. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/incident/references/default-template.md +0 -0
  169. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/incident/references/example-payment-outage.md +62 -0
  170. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/management-unit-assessment/SKILL.md +105 -0
  171. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/management-unit-assessment/references/default-template.md +0 -0
  172. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/management-unit-assessment/references/example-team-assessment.md +126 -0
  173. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/meeting-minutes/SKILL.md +24 -0
  174. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/meeting-minutes/references/default-template.md +0 -0
  175. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/meeting-minutes/references/example-weekly-sync.md +72 -0
  176. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/planning/SKILL.md +30 -0
  177. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/planning/references/default-template.md +0 -0
  178. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/planning/references/example-sprint-planning.md +62 -0
  179. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/prd/SKILL.md +44 -0
  180. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/prd/references/default-template.md +0 -0
  181. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/prd/references/example-unified-api.md +71 -0
  182. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment/SKILL.md +90 -0
  183. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment/references/default-template.md +0 -0
  184. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment/references/example-platform-assessment.md +122 -0
  185. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment-evidence/SKILL.md +88 -0
  186. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment-evidence/references/default-template.md +0 -0
  187. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment-evidence/references/example-evidence-map.md +46 -0
  188. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/spike/SKILL.md +23 -0
  189. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/spike/references/default-template.md +0 -0
  190. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/spike/references/example-graphql-federation.md +79 -0
  191. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/task/SKILL.md +20 -0
  192. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/task/references/default-template.md +0 -0
  193. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/task/references/example-nav-system.md +33 -0
  194. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/technical-unit-assessment/SKILL.md +58 -0
  195. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/technical-unit-assessment/references/default-template.md +0 -0
  196. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/technical-unit-assessment/references/example-frontend-assessment.md +112 -0
  197. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/technical-unit-assessment/references/indicator-groups.md +65 -0
  198. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/trd/SKILL.md +47 -0
  199. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/trd/references/default-template.md +0 -0
  200. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/trd/references/example-api-migration.md +122 -0
  201. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/user-story/SKILL.md +20 -0
  202. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/user-story/references/default-template.md +0 -0
  203. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/user-story/references/example-advanced-filtering.md +37 -0
  204. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/work-item/SKILL.md +30 -0
  205. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/work-item/references/default-template.md +0 -0
  206. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/work-item/references/example-routing-dashboard.md +23 -0
  207. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/workflow-client-bootstrap/SKILL.md +148 -0
  208. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/workflow-client-bootstrap/questions.yaml +165 -0
  209. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/workflow-generic-project/SKILL.md +78 -0
  210. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma/LICENSE.txt +2 -0
  211. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma/NOTICE.txt +25 -0
  212. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma/SKILL.md +95 -0
  213. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma/references/figma-mcp-config.md +82 -0
  214. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma/references/figma-tools-and-prompts.md +34 -0
  215. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-code-connect-components/LICENSE.txt +2 -0
  216. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-code-connect-components/NOTICE.txt +18 -0
  217. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-code-connect-components/SKILL.md +350 -0
  218. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-code-connect-components/references/mapping-checklist.md +7 -0
  219. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-code-connect-components/scripts/normalize_node_id.py +25 -0
  220. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-design-system-rules/LICENSE.txt +2 -0
  221. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-design-system-rules/NOTICE.txt +19 -0
  222. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-design-system-rules/SKILL.md +550 -0
  223. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-design-system-rules/references/rule-template.md +15 -0
  224. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-design-system-rules/scripts/check_agents_md.sh +9 -0
  225. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-new-file/LICENSE.txt +2 -0
  226. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-new-file/NOTICE.txt +17 -0
  227. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-new-file/SKILL.md +69 -0
  228. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-implement-design/LICENSE.txt +2 -0
  229. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-implement-design/NOTICE.txt +19 -0
  230. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-implement-design/SKILL.md +264 -0
  231. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/SKILL.md +60 -0
  232. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/charts.csv +26 -0
  233. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/colors.csv +97 -0
  234. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/icons.csv +101 -0
  235. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/landing.csv +31 -0
  236. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/products.csv +97 -0
  237. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/react-performance.csv +45 -0
  238. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/astro.csv +54 -0
  239. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  240. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
  241. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
  242. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
  243. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
  244. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
  245. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  246. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/react.csv +54 -0
  247. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
  248. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
  249. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  250. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/vue.csv +50 -0
  251. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/styles.csv +68 -0
  252. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/typography.csv +58 -0
  253. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
  254. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
  255. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/web-interface.csv +31 -0
  256. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/references/pre-delivery-checklist.md +39 -0
  257. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/references/search-reference.md +44 -0
  258. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/references/ui-rules.md +35 -0
  259. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/scripts/core.py +253 -0
  260. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/scripts/design_system.py +1067 -0
  261. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/scripts/search.py +114 -0
  262. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-address-comments/LICENSE.txt +202 -0
  263. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-address-comments/NOTICE.txt +20 -0
  264. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-address-comments/SKILL.md +69 -0
  265. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-address-comments/scripts/fetch_comments.py +237 -0
  266. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-contribution-planner/SKILL.md +157 -0
  267. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-contribution-planner/scripts/inspect_contributions.py +800 -0
  268. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-fix-ci/LICENSE.txt +201 -0
  269. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-fix-ci/NOTICE.txt +20 -0
  270. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-fix-ci/SKILL.md +71 -0
  271. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-fix-ci/scripts/inspect_pr_checks.py +509 -0
  272. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/github-cli-workflow/SKILL.md +49 -0
  273. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gitlab-cli-workflow/SKILL.md +44 -0
  274. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/workflow-client-bootstrap/SKILL.md +14 -0
  275. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/workflow-generic-project/SKILL.md +14 -0
  276. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/clickup-cli/SKILL.md +75 -0
  277. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/clickup-cli/references/docs-management.md +57 -0
  278. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/clickup-cli/references/task-management.md +131 -0
  279. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/clickup-cli/references/time-tracking.md +38 -0
  280. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/linear/LICENSE.txt +202 -0
  281. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/linear/NOTICE.txt +23 -0
  282. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/linear/SKILL.md +131 -0
  283. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/slack-assistant/SKILL.md +134 -0
  284. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/slack-cli/SKILL.md +105 -0
  285. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/slack-cli/references/INSTALLATION.md +42 -0
  286. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/loops/loop-runner/SKILL.md +90 -0
  287. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/ops/docs-generator/SKILL.md +81 -0
  288. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/ops/llm-cost-advisor/SKILL.md +83 -0
  289. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/ops/triage/SKILL.md +117 -0
  290. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/LICENSE.txt +201 -0
  291. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/NOTICE.txt +27 -0
  292. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/SKILL.md +142 -0
  293. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/assets/experiment-template.ipynb +110 -0
  294. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/assets/tutorial-template.ipynb +107 -0
  295. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/references/experiment-patterns.md +10 -0
  296. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/references/notebook-structure.md +17 -0
  297. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/references/quality-checklist.md +11 -0
  298. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/references/tutorial-patterns.md +9 -0
  299. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/scripts/new_notebook.py +130 -0
  300. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/LICENSE.txt +201 -0
  301. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/NOTICE.txt +29 -0
  302. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/SKILL.md +151 -0
  303. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/references/cli.md +116 -0
  304. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/references/workflows.md +98 -0
  305. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/scripts/executable_playwright_cli.sh +25 -0
  306. agent_toolkit_cli-1.0.3.dist-info/METADATA +411 -0
  307. agent_toolkit_cli-1.0.3.dist-info/RECORD +310 -0
  308. agent_toolkit_cli-1.0.3.dist-info/WHEEL +4 -0
  309. agent_toolkit_cli-1.0.3.dist-info/entry_points.txt +2 -0
  310. agent_toolkit_cli-1.0.3.dist-info/licenses/LICENSE +21 -0
@@ -0,0 +1,119 @@
1
+ ---
2
+ name: onboarding
3
+ description: >-
4
+ Getting started guide for new users. Walks through setup validation,
5
+ the skill/agent hierarchy, and the three most useful commands per role (developer,
6
+ PM, tech lead). Use when someone is new to the workstation or asks "where do I start?"
7
+ metadata:
8
+ author: ulises-jeremias
9
+ version: "1.0"
10
+ tags: [onboarding, setup, getting-started]
11
+ ---
12
+
13
+ # Onboarding
14
+
15
+ Welcome to . This skill guides new users through initial setup and daily usage.
16
+
17
+ ## When to use
18
+
19
+ - User asks "where do I start?" or "how does this work?"
20
+ - First-time setup after `chezmoi apply`
21
+ - Troubleshooting a broken installation
22
+ - Onboarding a teammate
23
+
24
+ ## Step 1 — Validate setup
25
+
26
+ ```bash
27
+ doctor
28
+ ```
29
+
30
+ Expected: `result: COMPLIANT`. If any check fails, `doctor` shows the fix command.
31
+
32
+ For persistent issues:
33
+
34
+ ```bash
35
+ update-check # check for available updates
36
+ skills list # verify skills are installed
37
+ skills sync # re-sync symlinks to AI tools
38
+ ```
39
+
40
+ ## Step 2 — Understand the hierarchy
41
+
42
+ ```text
43
+ User message
44
+ ↓
45
+ Orchestrator (assistant)
46
+ ↓ routes to
47
+ Workflow skill (WHAT — decides scope and gates)
48
+ e.g. workflow-generic-project
49
+ ↓ delegates to
50
+ Tool skill (HOW — executes CLI commands)
51
+ e.g. clickup-cli, github-cli-workflow
52
+ ```
53
+
54
+ **Skills** are invoked via the skill tool (e.g. `/planning`).
55
+ **Agents** are invoked via `@mention` (e.g. `@planner`). Never use the skill tool for agents.
56
+
57
+ ## Step 3 — First commands by role
58
+
59
+ ### Developer
60
+
61
+ ```bash
62
+ # Start any task
63
+ /workflow-generic-project
64
+
65
+ # After code changes — review before PR
66
+ @code-reviewer
67
+
68
+ # CI failing
69
+ /gh-fix-ci
70
+ ```
71
+
72
+ ### Product Manager / Tech Lead
73
+
74
+ ```bash
75
+ # Plan a feature
76
+ @planner
77
+
78
+ # Create a ClickUp task
79
+ /clickup-cli # then: clickup task create --current --name "..."
80
+
81
+ # Project health check
82
+ /project-assessment
83
+ ```
84
+
85
+ ### Anyone
86
+
87
+ ```bash
88
+ # Check workstation health
89
+ doctor
90
+
91
+ # Find which skill to use
92
+ # → ask the orchestrator: "what skill should I use for X?"
93
+
94
+ # Load client/project context
95
+ ./bin/workspace-context load packs/<client>.yaml # if in ai-workspace
96
+ ```
97
+
98
+ ## Key concepts in 60 seconds
99
+
100
+ | Concept | What it means |
101
+ |---------|--------------|
102
+ | **Pack** | Context bundle for a client/project (repos, constraints, commands) |
103
+ | **Skill** | Reusable AI prompt for a specific task (WHAT or HOW) |
104
+ | **Agent** | Specialized AI persona with restricted tool access (invoked via @mention) |
105
+ | **Loop** | Recurring autonomous process with state, tiers, and cost budgets |
106
+ | **L1 / L2 / L3** | Loop autonomy tiers: L1=observe-only, L2=PR-gated, L3=unattended |
107
+ | **knowledge/** | Persistent memory across sessions |
108
+
109
+ ## Anti-patterns
110
+
111
+ - Do not skip `doctor` — it catches 90% of setup issues
112
+ - Do not invoke agents via the skill tool — use `@mention`
113
+ - Do not run L3 loops without 3+ clean L1 runs first
114
+
115
+ ## Next steps
116
+
117
+ - Load a project pack: `./bin/workspace-context load packs/<project>.yaml`
118
+ - Run your first task: `/workflow-generic-project`
119
+ - Set up daily loop: `./bin/loop init daily-triage`
@@ -0,0 +1,24 @@
1
+ ---
2
+ name: output-handshake
3
+ description: >-
4
+ WHAT — Default gate for any deliverable: confirm where the final artifact will be stored and that a human will review, before writing PRDs, TRDs, ADRs, or PR bodies. Repository paths, wikis, and ticket tools differ by engagement; never assume a single location.
5
+ ---
6
+
7
+ # Output handshake (WHAT)
8
+
9
+ **Use first** when producing a **final** version of any deliverable that will leave the chat session: PRD, TRD, ADR, work item, planning notes, workflow/validation summary, project assessment, assessment scorecard, evidence map, meeting minutes, decision log, agreement, incident report, spike, or PR/MR body.
10
+
11
+ ## Default behavior (always)
12
+
13
+ 1. **Destination** — Ask explicitly: *where should the final content live?* (Examples: a path in `docs/`, a file in a repo, a page in a documentation tool, a task/Doc description, paste-only, or a combination.) Do **not** default to a location without the user (or the engagement pack) saying so.
14
+ 2. **Review** — State that a **human** must review before the artifact is considered approved; the assistant does not substitute for that review.
15
+ 3. Then proceed with the relevant skill (**`prd`**, **`trd`**, **`adr`**, **`work-item`**, **`planning`**, **`development-workflow`**, **`project-assessment`**, **`project-assessment-evidence`**, **`technical-unit-assessment`**, **`management-unit-assessment`**, **`meeting-minutes`**, **`decision-log`**, **`agreement`**, **`incident`**, **`spike`**, **`pr-fallback`** + forge workflow, etc.).
16
+
17
+ ## Boundaries
18
+
19
+ - This skill does not contain org templates; those stay in the specific artifact skills and their `references/default-template.md` files.
20
+
21
+ ## See also
22
+
23
+ - `workflow-generic-project` — delivery gates
24
+ - `assistant` — discover existing `docs/`, PR templates, `AGENTS.md`
@@ -0,0 +1,33 @@
1
+ ---
2
+ name: pr-fallback
3
+ description: >-
4
+ WHAT — When the repo has no GitHub PR template, structure the pull-request body using the default in references/pr-body-default.md. Pair with output-handshake and github-cli-workflow. Does not open the PR; HOW stays in the forge skill.
5
+ ---
6
+
7
+ # PR body — default when no repo template (WHAT)
8
+
9
+ ## When to use
10
+
11
+ - Remote is **GitHub** and **`assistant`** (or a file search) shows **no** `PULL_REQUEST_TEMPLATE` / `pull_request_template` under `.github/`.
12
+ - You need a **reasonable default** for `gh pr create --body-file` until the repo adds its own template.
13
+
14
+ ## Instructions
15
+
16
+ 1. Run **`output-handshake`**: user confirms where the final description will live (e.g. `body.md` for `gh`, paste-only) and that a **human** will review.
17
+ 2. If the repository adds a template later, **prefer the repo** over this file.
18
+ 3. Copy sections from **`references/pr-body-default.md`**, fill placeholders (issue id, test notes), and pass the path to **`github-cli-workflow`**.
19
+
20
+ ## GitLab
21
+
22
+ If there is no `.gitlab/merge_request_templates/`, you may use the same Markdown structure in the **merge request description** for consistency, subject to the user’s **destination** choice (MR description field, file, etc.) and **`output-handshake`**.
23
+
24
+ ## What not to do
25
+
26
+ - Do not **assume** a PR is always in a specific ticket system; the **file** the user points to is wherever they said in the handshake.
27
+
28
+ ## References
29
+
30
+ - `references/pr-body-default.md` — local copy of the default body
31
+ - `development-workflow` — default PR validation and DoD expectations
32
+ - `github-cli-workflow` — draft PR creation
33
+ - `gitlab-cli-workflow` — GitLab MRs
@@ -0,0 +1,141 @@
1
+ ---
2
+ name: workspace-knowledge-sync
3
+ description: >-
4
+ Syncs knowledge to the ai-workspace knowledge base. Use when the assistant
5
+ discovers new patterns, learns user preferences, or identifies information worth
6
+ preserving for future sessions. Integrates with tech-assistant for automatic
7
+ trigger points.
8
+ ---
9
+
10
+ # Workspace Knowledge Sync
11
+
12
+ Automatically syncs valuable discoveries, patterns, and decisions to the ai-workspace knowledge base.
13
+
14
+ ---
15
+
16
+ ## Purpose
17
+
18
+ The orchestrator session accumulates knowledge through work. This skill ensures that valuable discoveries don't get lost and are available for future sessions.
19
+
20
+ ---
21
+
22
+ ## Trigger Points (Automatic)
23
+
24
+ The tech-assistant will invoke this skill automatically when:
25
+
26
+ | Situation | What to Sync | Target File |
27
+ |-----------|--------------|-------------|
28
+ | Discovery of new skill/tool | Skill name, purpose, usage pattern | `knowledge/skills/discovered.md` |
29
+ | New process pattern | Process steps, roles, tools | `knowledge/processes/general.md` |
30
+ | Key decision made | Decision, rationale, outcome | `knowledge/learnings/general.md` |
31
+ | Pending follow-up | Task description, context | `knowledge/todos/pending.md` |
32
+ | User teaches something | Information, preference | Relevant knowledge file |
33
+
34
+ ---
35
+
36
+ ## How It Works
37
+
38
+ The skill uses the stable `assistant-memory` API with `--from-skill` for origin tracking:
39
+
40
+ ```bash
41
+ # Search before adding
42
+ assistant-memory search "<query>"
43
+
44
+ # Add a learning (with origin tracking)
45
+ assistant-memory add --type learning --from-skill knowledge-sync "Pattern: <description>"
46
+
47
+ # Add a skill (with tags)
48
+ assistant-memory add --type skill --from-skill knowledge-sync --tags jira,workflow "New skill: <name>"
49
+
50
+ # Add a pending todo
51
+ assistant-memory add --type todo --from-skill knowledge-sync "<description>"
52
+ ```
53
+
54
+ ---
55
+
56
+ ## Knowledge Structure
57
+
58
+ ```
59
+ knowledge/
60
+ ├── skills/
61
+ │ └── discovered.md # New skills found during work
62
+ ├── processes/
63
+ │ ├── jira.md
64
+ │ ├── confluence.md
65
+ │ └── general.md # Generic process patterns
66
+ ├── learnings/
67
+ │ └── general.md # Key decisions and insights
68
+ └── todos/
69
+ └── pending.md # Follow-up items
70
+ ```
71
+
72
+ ---
73
+
74
+ ## Manual Usage
75
+
76
+ You can also trigger this skill manually:
77
+
78
+ ```
79
+ User: "Save that pattern for later"
80
+
81
+ Assistant: → Use knowledge-sync to preserve the pattern
82
+ ```
83
+
84
+ ---
85
+
86
+ ## Integration with tech-assistant
87
+
88
+ The tech-assistant skill checks for these automatic sync opportunities:
89
+
90
+ 1. **After task creation/update** → Sync initiative info
91
+ 2. **After discovering space/list IDs** → Sync to knowledge base (per `knowledge-sync`).
92
+ 3. **After learning user preferences** → Sync to learnings
93
+ 4. **When user mentions follow-up** → Add to pending
94
+
95
+ ---
96
+
97
+ ## Best Practices
98
+
99
+ 1. **Be selective** - Only sync valuable, reusable information
100
+ 2. **Be specific** - Include context and usage examples
101
+ 3. **Be concise** - One idea per entry, link to details
102
+ 4. **Be current** - Update outdated information when found
103
+
104
+ ---
105
+
106
+ ## Examples
107
+
108
+ ### Auto-sync discovery
109
+
110
+ ```
111
+ Assistant discovers Initiative list IDs for all Technology spaces
112
+ → Syncs to knowledge/processes/clickup/spaces/
113
+ ```
114
+
115
+ ### Auto-sync key decision
116
+
117
+ ```
118
+ Assistant and user decide on naming convention
119
+ → Syncs to knowledge/learnings/general.md
120
+ ```
121
+
122
+ ### Manual sync request
123
+
124
+ ```
125
+ User: "Remember that we always use feature branches"
126
+ → Assistant syncs to knowledge/processes/general.md
127
+ ```
128
+
129
+ ---
130
+
131
+ ## Configuration
132
+
133
+ The skill uses these environment variables:
134
+
135
+ | Variable | Default | Purpose |
136
+ |----------|---------|---------|
137
+ | `KNOWLEDGE_BASE_PATH` | `~/ai-workspace/knowledge` | Knowledge base root |
138
+
139
+ ---
140
+
141
+ Base directory: `~/.local/share//skills/knowledge-sync`
@@ -0,0 +1,41 @@
1
+ ---
2
+ name: dbt-validation
3
+ description: >-
4
+ HOW — Run dbt checks as documented in the target repo (parse, compile, test, selective run).
5
+ Does not configure Snowflake accounts or change cloud security.
6
+ ---
7
+
8
+ # dbt validation (HOW)
9
+
10
+ Use when the repository is a **dbt** project or the task requires **dbt** verification. Client workflows may delegate here.
11
+
12
+ ## Boundaries
13
+
14
+ - Follow **repo** `AGENTS.md`, `Makefile`, `README`, and CI—not generic guesses.
15
+ - **Do not** change Snowflake security settings, network rules, or warehouse admin from this skill.
16
+ - If `dbt` or credentials are missing, **say so** and do not claim validation passed.
17
+
18
+ ## Discovery
19
+
20
+ Look for `dbt_project.yml`, `packages.yml`, `models/`, `Makefile`, `pyproject.toml`, or CI jobs that invoke dbt.
21
+
22
+ ## Typical commands (examples only—prefer repo docs)
23
+
24
+ | Intent | Often used (verify in repo) |
25
+ | --- | --- |
26
+ | Syntax / graph | `dbt parse`, `dbt compile` |
27
+ | Dependencies | `dbt deps` when packages change |
28
+ | Tests | `dbt test` or subset flags the repo documents |
29
+ | Build | `dbt run` / `dbt build` when the user approves mutating runs |
30
+
31
+ **Makefile** wrappers (e.g. `make parse`) take precedence when documented.
32
+
33
+ ## Evidence
34
+
35
+ - Summarize **which** commands ran and **high-level** outcome (pass/fail/skipped) for tickets and PRs.
36
+ - On failure, capture **actionable** error lines; do not dump full logs unless the user asks.
37
+
38
+ ## Safety
39
+
40
+ - Prefer **read-only** checks (`parse`, `compile`, `test`) when the task is review-only.
41
+ - Production runs require explicit user approval per repo policy.
@@ -0,0 +1,38 @@
1
+ ---
2
+ name: snowflake-validation
3
+ description: >-
4
+ HOW — Read-only Snowflake validation patterns: use repo-documented CLI (snowflake/sql) or SQL checks.
5
+ Never claim success without working credentials and evidence.
6
+ ---
7
+
8
+ # Snowflake validation (HOW)
9
+
10
+ Use when the task or repo requires **Snowflake** verification. Client workflows may delegate here alongside **dbt-validation**.
11
+
12
+ ## Boundaries
13
+
14
+ - **Read-only** validation unless the user and repo explicitly authorize DDL/DML.
15
+ - **Never** claim “Snowflake validation passed” or “query succeeded” without **credentials** and **observed outputs** (or explicit statement that checks were skipped).
16
+ - **Do not** rotate keys, change roles, or alter security objects from this skill unless the repo’s `AGENTS.md` clearly authorizes it and the user approves.
17
+
18
+ ## Discovery
19
+
20
+ Read repo docs for: connection method (env vars, `profiles.yml`, SSO), Snowflake **SQL** or **Snowflake CLI** (`snow`) usage, and warehouse/database/schema defaults.
21
+
22
+ ## Patterns
23
+
24
+ | Situation | Action |
25
+ | --- | --- |
26
+ | Credentials available | Run minimal **SELECT** statements or documented smoke queries; record that they were executed |
27
+ | Snowflake CLI documented | Use repo’s exact commands; check `snow --help` for current subcommands |
28
+ | No credentials | State **skipped** in Jira/PR; list what would be validated when access exists |
29
+ | dbt + Snowflake | Coordinate with **dbt-validation**; Snowflake may be exercised indirectly via dbt |
30
+
31
+ ## Evidence
32
+
33
+ - For each run: **what** ran (object or test name), **environment** (non-secret), **result** (row count, success/failure).
34
+ - Redact account identifiers if the user requests privacy in chat.
35
+
36
+ ## Safety
37
+
38
+ - No secrets in tickets, PRs, or command lines in logs pasted to chat—use env vars and documented patterns only.
@@ -0,0 +1,46 @@
1
+ ---
2
+ name: adr
3
+ description: >-
4
+ WHAT — Create and maintain Architecture Decision Records (ADRs) per the process. Covers when to write an ADR, required sections, review, and linking to epics/PRs. English for cross-team artifacts unless the user asks otherwise.
5
+ ---
6
+
7
+ # ADR — Architecture Decisions (WHAT)
8
+
9
+ **Template:** `references/default-template.md` — local reference for ADR structure and workflow.
10
+
11
+ ## Default guardrails (before any final content)
12
+
13
+ 1. Apply **`output-handshake`**: confirm **where** the final ADR will be recorded and that a **human** will review.
14
+ 2. Then follow the steps below.
15
+
16
+ ## When to use
17
+
18
+ Use **`decision-log`** for lightweight product/project/operational decisions and **`agreement`** for explicit commitments or terms among parties. Use this ADR skill only for durable architecture or technical decisions.
19
+
20
+ - A change has **long-term** architectural, security, data-model, or cost impact.
21
+ - You need **options with pros/cons** and a **record** for future readers (and for supersession later).
22
+ - The project needs decisions linked to PRDs, TRDs, tasks, PRs, diagrams, or other supporting artifacts.
23
+
24
+ ## Instructions
25
+
26
+ 1. **Confirm the decision qualifies** (new service, tech selection, schema change, deployment change, etc.) per the "When to Create an ADR" criteria.
27
+ 2. **Draft** using the six-part structure: Title & status, Context, Options, Decision, Consequences, References (link **PRD/TRD**, tasks, PRs, diagrams as applicable).
28
+ 3. **Review** with the tech lead / peers as in the workflow; keep ADRs **short and actionable** (clarity over completeness).
29
+ 4. **Link** the ADR to the relevant **epic or story** and to **PRs** in the forge (use **`github-cli-workflow` / `gitlab-cli-workflow`** for PR text when applicable).
30
+ 5. If an ADR is **superseded**, **preserve history**: update status and point to the replacement document.
31
+
32
+ ## What not to do
33
+
34
+ - Do not use an ADR for one-line fixes with no long-term effect (use a normal task or PR description).
35
+ - Do not paste the full org policy into this skill; keep a single **canonical** copy in the wiki.
36
+
37
+ ## References
38
+
39
+ - `output-handshake` — destination and review
40
+ - `references/default-template.md` — ADR structure and workflow
41
+ - `references/example-001-graphql-adoption.md` — example ADR for a GraphQL migration decision
42
+ - `trd` — where technical design references decisions
43
+ - `decision-log` — lightweight decisions
44
+ - `agreement` — explicit commitments or terms
45
+ - `workflow-generic-project` — traceability and plan approval
46
+ - `clickup-cli`, `jira-*` — ticket and comment operations (per engagement)
@@ -0,0 +1,66 @@
1
+ # ADR-001: Adopt GraphQL for the Product API
2
+
3
+ **Status:** Accepted
4
+
5
+ ## Context
6
+
7
+ The current REST API has accumulated significant complexity as the product domain grew. Multiple frontend clients (web, mobile) are experiencing over-fetching, under-fetching, and fragile coupling to backend structure. The team spends significant time on API versioning and backward compatibility work.
8
+
9
+ Key constraints:
10
+ - Existing REST endpoints cannot be deprecated immediately
11
+ - Mobile team needs faster iteration cycles
12
+ - Analytics requirements demand a more expressive data querying interface
13
+
14
+ ## Options Considered
15
+
16
+ ### Option A: GraphQL Federation
17
+ **Pros:**
18
+ - Single coherent graph for all clients
19
+ - Type safety and auto-generated docs
20
+ - Separate subgraph ownership reduces coupling
21
+
22
+ **Cons:**
23
+ - Higher initial infrastructure complexity
24
+ - Requires Apollo Federation or equivalent gateway
25
+ - Caching strategies differ from REST patterns
26
+
27
+ ### Option B: REST with JSON:API
28
+ **Pros:**
29
+ - Team familiarity with REST patterns
30
+ - Simpler infrastructure (no gateway needed)
31
+ - Easier to cache at CDN level
32
+
33
+ **Cons:**
34
+ - Still requires versioning as domain grows
35
+ - Multiple endpoints needed for complex queries
36
+ - No built-in type safety or schema
37
+
38
+ ### Option C:渐进式迁移 — Evolve REST to GraphQL incrementally
39
+ **Pros:**
40
+ - Low risk approach
41
+ - Existing clients unaffected during transition
42
+ - Can validate GraphQL value before full commitment
43
+
44
+ **Cons:**
45
+ - Longer timeline to realize benefits
46
+ - Requires maintaining both API styles temporarily
47
+ - Higher total implementation effort
48
+
49
+ ## Decision
50
+
51
+ Adopt GraphQL with a phased approach: establish a new `/graphql` endpoint alongside existing REST, migrate the product domain first, then expand to other domains as teams gain familiarity.
52
+
53
+ Rationale: Provides immediate relief for frontend teams while preserving existing investments. The federation model future-proofs architecture for microservices decomposition.
54
+
55
+ ## Consequences
56
+
57
+ - New `api-gateway` service will be introduced in Q3
58
+ - Mobile team leads the product domain migration (most urgent need)
59
+ - REST API maintained for backward compatibility until deprecation notice (6-month notice period)
60
+ - Existing client SDKs updated to support both endpoints during transition
61
+
62
+ ## References
63
+
64
+ - [PRD-042: Unified API Strategy](./prd-042-unified-api-strategy.md)
65
+ - [Spike-012: GraphQL vs REST evaluation](./spike-012-graphql-evaluation.md)
66
+ - Engineering sync 2024-11-15
@@ -0,0 +1,23 @@
1
+ ---
2
+ name: agreement
3
+ description: >-
4
+ WHAT - Capture explicit agreements, terms, parties involved, dates, validity, and linked work items using the Agreement Document structure.
5
+ ---
6
+
7
+ # Agreement Document (WHAT)
8
+
9
+ Use for formal agreements or commitments made during meetings or project discussions.
10
+
11
+ ## Default guardrails
12
+
13
+ 1. Apply **`output-handshake`** before final output.
14
+ 2. Identify parties involved and affected.
15
+ 3. Include validity/review dates when the agreement has a time boundary.
16
+ 4. Link related work items and meeting minutes where possible.
17
+
18
+ ## References
19
+
20
+ - `references/default-template.md`
21
+ - `references/example-api-versioning.md` — example agreement covering semantic versioning and deprecation policy
22
+ - `meeting-minutes`
23
+ - `decision-log`
@@ -0,0 +1,29 @@
1
+ # Agreement: API Versioning Policy
2
+
3
+ ## Agreement Summary
4
+
5
+ All public APIs will follow semantic versioning with a minimum 6-month deprecation notice before breaking changes. Version support windows are tied to major versions.
6
+
7
+ ## Parties Involved
8
+
9
+ - Platform Team (API owners)
10
+ - All consuming service teams
11
+ - Product Management (for public API consumers)
12
+
13
+ ## Terms and Conditions
14
+
15
+ 1. **Version numbering:** Follows `MAJOR.MINOR.PATCH` semantic versioning
16
+ 2. **Breaking changes:** Require a new major version with 6-month overlap period
17
+ 3. **Deprecation notice:** Written notice in API response headers and changelog minimum 6 months before EOL
18
+ 4. **Sunset timeline:** Major versions receive security patches for 18 months from release, then EOL
19
+ 5. **Version discovery:** `/versions` endpoint lists supported versions with EOL dates
20
+
21
+ ## Date and Validity
22
+
23
+ - Start Date: 2024-01-01
24
+ - Review / Due Date: 2025-07-01 (first review)
25
+
26
+ ## References / Linked Work Items
27
+
28
+ - [ADR-003: API Versioning Standard](./adr-003-api-versioning.md)
29
+ - [TRD-007: Platform API Migration](./trd-007-platform-api-migration.md)
@@ -0,0 +1,25 @@
1
+ ---
2
+ name: bug
3
+ description: >-
4
+ WHAT - Draft and review bugs using the Bug Template; classifies whether an issue should be escalated to incident based on production/user impact.
5
+ ---
6
+
7
+ # Bug (WHAT)
8
+
9
+ Use for defects that can be handled through the normal development workflow.
10
+
11
+ ## Bug vs incident rule
12
+
13
+ Route to **`incident`** instead if the problem impacts production or live users now, degrades service, blocks critical business operations, creates client-reported urgency, or needs immediate response outside planning cycles.
14
+
15
+ ## Default guardrails
16
+
17
+ 1. Apply **`output-handshake`** before final output.
18
+ 2. Capture reproduction steps and environment details.
19
+ 3. Use **`clickup-cli`** for ClickUp writes only after approval.
20
+
21
+ ## References
22
+
23
+ - `references/default-template.md` — bug template
24
+ - `references/example-search-filter-bug.md` — example bug with environment details, diagnostics, and severity assessment
25
+ - `incident` — when to escalate to incident
@@ -0,0 +1,58 @@
1
+ # BUG-042: Search results not displaying after deployment
2
+
3
+ ## Steps to Reproduce
4
+
5
+ 1. Navigate to `/products` with query parameter `?category=electronics&sort=price_asc`
6
+ 2. Click on the "Filter" button to open the filter panel
7
+ 3. Select "Screen Size: 40-50 inch" and click Apply
8
+ 4. Observe the results area
9
+
10
+ ## Expected Result
11
+
12
+ Product grid updates to show only electronics with screen sizes between 40 and 50 inches, sorted by price ascending. Total count shows "47 products found".
13
+
14
+ ## Actual Result
15
+
16
+ Results area shows a spinner indefinitely. Network tab shows 200 response but no DOM updates. After 30 seconds the spinner is replaced with an empty state: "No products match your filters."
17
+
18
+ ## Environment Details
19
+
20
+ | Field | Value |
21
+ | --- | --- |
22
+ | Environment | Production |
23
+ | Browser | Chrome 120.0.6099.130 |
24
+ | Device / OS | macOS 14.2 (M2 Pro) |
25
+ | App Version | 2.14.1 |
26
+ | User Role | Authenticated consumer |
27
+ | Network Conditions | WiFi, 50 Mbps down |
28
+
29
+ ## Diagnostics and Observations
30
+
31
+ - Screenshots, videos, or logs: [Recording attached to ticket]
32
+ - Console errors or stack traces: `TypeError: Cannot read properties of undefined (reading 'length')` at `FilterPanel.jsx:142`
33
+ - External system behavior: Analytics events fire successfully — the failure is in frontend rendering only
34
+ - Previous working version: 2.13.4 (verified via rollback test)
35
+
36
+ ## Acceptance Criteria
37
+
38
+ - [ ] Expected behavior is working and manually verified in Production.
39
+ - [ ] Original reproduction steps no longer reproduce the bug.
40
+ - [ ] Fix was tested in the relevant environment (Production-like staging).
41
+ - [ ] Resolution evidence was added (recording, logs confirming the TypeError is gone).
42
+ - [ ] Documentation or user guidance was updated if needed (release notes mention the fix).
43
+
44
+ ## Severity and Priority
45
+
46
+ - Severity: High
47
+ - Priority: P1
48
+
49
+ ## Additional Information
50
+
51
+ - Estimated Effort: 2 days
52
+ - Assigned To: Sarah Chen
53
+ - Due Date: 2024-01-20
54
+
55
+ ## Review
56
+
57
+ - [ ] Destination confirmed.
58
+ - [ ] Human review required.