gabbe-kit 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 (502) hide show
  1. package/LICENSE +25 -0
  2. package/LICENSE-CODE +202 -0
  3. package/README.md +817 -0
  4. package/agents/AGENTS.md +542 -0
  5. package/agents/CONSTITUTION.md +188 -0
  6. package/agents/guides/00-index.md +142 -0
  7. package/agents/guides/ai/a2ui-protocols.md +71 -0
  8. package/agents/guides/ai/actor-agent-frameworks.md +82 -0
  9. package/agents/guides/ai/agent-communication.md +146 -0
  10. package/agents/guides/ai/agent-identity-trust.md +69 -0
  11. package/agents/guides/ai/agent-only-cognition.md +73 -0
  12. package/agents/guides/ai/agent-only-swarms.md +70 -0
  13. package/agents/guides/ai/agent-operating-ergonomics.md +52 -0
  14. package/agents/guides/ai/agent-ui.md +106 -0
  15. package/agents/guides/ai/ai-agentic.md +309 -0
  16. package/agents/guides/ai/beyond-llms.md +60 -0
  17. package/agents/guides/ai/dynamic-capability-loading.md +121 -0
  18. package/agents/guides/ai/gabbe-innovations.md +111 -0
  19. package/agents/guides/ai/model-customization-decisions.md +78 -0
  20. package/agents/guides/ai/multi-agent-systems.md +85 -0
  21. package/agents/guides/ai/self-evolving-skills.md +137 -0
  22. package/agents/guides/ai/self-healing-summary.md +21 -0
  23. package/agents/guides/ai/visual-mcp-integration.md +106 -0
  24. package/agents/guides/architecture/api-standards.md +61 -0
  25. package/agents/guides/architecture/blockchain-dlt.md +36 -0
  26. package/agents/guides/architecture/critical-systems-arch.md +66 -0
  27. package/agents/guides/architecture/event-driven-architecture.md +39 -0
  28. package/agents/guides/architecture/microservices.md +292 -0
  29. package/agents/guides/architecture/monolith.md +303 -0
  30. package/agents/guides/architecture/orchestration.md +75 -0
  31. package/agents/guides/architecture/system-qualities.md +51 -0
  32. package/agents/guides/architecture/system-scalability.md +47 -0
  33. package/agents/guides/architecture/systems-architecture.md +506 -0
  34. package/agents/guides/data/semantic-web.md +23 -0
  35. package/agents/guides/data/sql-nosql.md +305 -0
  36. package/agents/guides/industry/engineering-standards.md +36 -0
  37. package/agents/guides/industry/global-standards.md +24 -0
  38. package/agents/guides/industry/healthcare-fhir.md +33 -0
  39. package/agents/guides/industry/industrial-iot.md +33 -0
  40. package/agents/guides/industry/telecom-networks.md +34 -0
  41. package/agents/guides/languages/c-sharp.md +66 -0
  42. package/agents/guides/languages/go-lang.md +251 -0
  43. package/agents/guides/languages/java.md +73 -0
  44. package/agents/guides/languages/js-ts-nodejs.md +361 -0
  45. package/agents/guides/languages/nodejs-advanced.md +56 -0
  46. package/agents/guides/languages/php-laravel.md +376 -0
  47. package/agents/guides/languages/python-fastapi-ai.md +257 -0
  48. package/agents/guides/languages/rust.md +73 -0
  49. package/agents/guides/ops/compliance-audit.md +177 -0
  50. package/agents/guides/ops/cost-optimization.md +57 -0
  51. package/agents/guides/ops/dev-environments.md +67 -0
  52. package/agents/guides/ops/dev-workflow.md +44 -0
  53. package/agents/guides/ops/gabbe-cli-workflows.md +252 -0
  54. package/agents/guides/ops/production-health.md +62 -0
  55. package/agents/guides/ops/troubleshooting-guide.md +69 -0
  56. package/agents/guides/patterns/agentic-design-patterns.md +308 -0
  57. package/agents/guides/patterns/agentic-patterns.md +43 -0
  58. package/agents/guides/patterns/ai-native-scenarios.md +71 -0
  59. package/agents/guides/patterns/autonomous-swarm-patterns.md +42 -0
  60. package/agents/guides/patterns/design-patterns.md +68 -0
  61. package/agents/guides/patterns/enterprise-migration-scenario.md +58 -0
  62. package/agents/guides/patterns/enterprise-patterns.md +56 -0
  63. package/agents/guides/patterns/software-design-patterns.md +106 -0
  64. package/agents/guides/patterns/time-complexity-analysis.md +116 -0
  65. package/agents/guides/planning/product-requirements.md +407 -0
  66. package/agents/guides/planning/strategic-analysis.md +98 -0
  67. package/agents/guides/planning/visual-product-specs.md +162 -0
  68. package/agents/guides/principles/clean-code-standards.md +51 -0
  69. package/agents/guides/principles/computing-foundations.md +87 -0
  70. package/agents/guides/principles/diagramming-standards.md +568 -0
  71. package/agents/guides/principles/evaluation-strategy.md +103 -0
  72. package/agents/guides/principles/future-tech.md +35 -0
  73. package/agents/guides/principles/human-agent-collaboration.md +54 -0
  74. package/agents/guides/principles/legacy-tech.md +61 -0
  75. package/agents/guides/principles/mathematical-foundations.md +103 -0
  76. package/agents/guides/principles/modeling-methods.md +97 -0
  77. package/agents/guides/principles/no-code-integration.md +84 -0
  78. package/agents/guides/principles/testing-strategy.md +97 -0
  79. package/agents/guides/principles/visual-design-system.md +44 -0
  80. package/agents/guides/processes/RARV_CYCLE.md +262 -0
  81. package/agents/guides/processes/extension-protocol.md +183 -0
  82. package/agents/guides/processes/full-system-lifecycle.md +47 -0
  83. package/agents/guides/processes/knowledge-integration.md +82 -0
  84. package/agents/guides/processes/loki-sdlc-phases.md +446 -0
  85. package/agents/guides/product/green-software.md +38 -0
  86. package/agents/guides/product/sustainability-checks.md +29 -0
  87. package/agents/guides/security/ai-risk-standards-map.md +98 -0
  88. package/agents/guides/security/api-security.md +51 -0
  89. package/agents/guides/security/cryptography-standards.md +38 -0
  90. package/agents/guides/security/privacy-data-protection.md +41 -0
  91. package/agents/guides/security/secure-architecture.md +43 -0
  92. package/agents/guides/security/threat-modeling.md +46 -0
  93. package/agents/memory/AUDIT_LOG.md +48 -0
  94. package/agents/memory/CONTINUITY.md +49 -0
  95. package/agents/memory/PROJECT_STATE.md +134 -0
  96. package/agents/memory/RESUME_POINTER.md +15 -0
  97. package/agents/memory/episodic/DECISION_LOG_TEMPLATE.md +104 -0
  98. package/agents/memory/semantic/PROJECT_KNOWLEDGE_TEMPLATE.md +194 -0
  99. package/agents/memory/semantic/VECTOR_DB_CONFIG_TEMPLATE.json +46 -0
  100. package/agents/personas/00-index.md +148 -0
  101. package/agents/personas/biz-compliance.md +112 -0
  102. package/agents/personas/biz-legal.md +131 -0
  103. package/agents/personas/eng-api.md +110 -0
  104. package/agents/personas/eng-backend.md +113 -0
  105. package/agents/personas/eng-data.md +50 -0
  106. package/agents/personas/eng-database.md +95 -0
  107. package/agents/personas/eng-frontend.md +75 -0
  108. package/agents/personas/eng-infra.md +105 -0
  109. package/agents/personas/eng-messaging.md +50 -0
  110. package/agents/personas/eng-ml.md +50 -0
  111. package/agents/personas/eng-mobile.md +75 -0
  112. package/agents/personas/eng-perf.md +90 -0
  113. package/agents/personas/eng-qa.md +125 -0
  114. package/agents/personas/eng-tooling.md +49 -0
  115. package/agents/personas/ops-compliance.md +109 -0
  116. package/agents/personas/ops-cost.md +92 -0
  117. package/agents/personas/ops-devops.md +85 -0
  118. package/agents/personas/ops-incident.md +123 -0
  119. package/agents/personas/ops-monitor.md +89 -0
  120. package/agents/personas/ops-release.md +91 -0
  121. package/agents/personas/ops-security.md +104 -0
  122. package/agents/personas/ops-sre.md +85 -0
  123. package/agents/personas/orch-coordinator.md +140 -0
  124. package/agents/personas/orch-judge.md +135 -0
  125. package/agents/personas/orch-planner.md +114 -0
  126. package/agents/personas/orch-researcher.md +165 -0
  127. package/agents/personas/prod-architect.md +110 -0
  128. package/agents/personas/prod-design.md +112 -0
  129. package/agents/personas/prod-ethicist.md +50 -0
  130. package/agents/personas/prod-integration.md +120 -0
  131. package/agents/personas/prod-pm.md +115 -0
  132. package/agents/personas/prod-product-ops.md +128 -0
  133. package/agents/personas/prod-research.md +49 -0
  134. package/agents/personas/prod-safety-engineer.md +28 -0
  135. package/agents/personas/prod-tech-lead.md +119 -0
  136. package/agents/personas/ui-design.md +81 -0
  137. package/agents/scripts/check_skills_docs.py +120 -0
  138. package/agents/scripts/compile_skills.py +284 -0
  139. package/agents/scripts/comprehensive_checker.py +187 -0
  140. package/agents/scripts/dump-context.sh +37 -0
  141. package/agents/scripts/eval_skills.py +268 -0
  142. package/agents/scripts/preflight_summary.sh +80 -0
  143. package/agents/scripts/report_duplicates.py +125 -0
  144. package/agents/scripts/setup-context.ps1 +250 -0
  145. package/agents/scripts/setup-context.sh +398 -0
  146. package/agents/scripts/state_export.sh +84 -0
  147. package/agents/scripts/state_import.sh +99 -0
  148. package/agents/scripts/validate_integrity.py +98 -0
  149. package/agents/scripts/validate_links.py +96 -0
  150. package/agents/scripts/validate_methodology_graph.py +194 -0
  151. package/agents/scripts/validate_skills.py +81 -0
  152. package/agents/scripts/verify_e2e_init_flows.py +246 -0
  153. package/agents/scripts/verify_setup_simulation.py +104 -0
  154. package/agents/scripts/verify_triggers_and_mcps.py +159 -0
  155. package/agents/scripts/verify_use_cases.py +498 -0
  156. package/agents/skills/00-index.md +322 -0
  157. package/agents/skills/ai/a2ui-protocols.skill.md +31 -0
  158. package/agents/skills/ai/actor-agent-frameworks.skill.md +31 -0
  159. package/agents/skills/ai/agent-communication.skill.md +36 -0
  160. package/agents/skills/ai/agent-ui.skill.md +31 -0
  161. package/agents/skills/ai/autonomous-swarm-patterns.skill.md +31 -0
  162. package/agents/skills/ai/beyond-llms.skill.md +31 -0
  163. package/agents/skills/ai/context-engineering.skill.md +79 -0
  164. package/agents/skills/ai/llm-as-judge.skill.md +97 -0
  165. package/agents/skills/ai/multi-agent-systems.skill.md +31 -0
  166. package/agents/skills/ai/rag-evaluation.skill.md +93 -0
  167. package/agents/skills/ai/reasoning-patterns.skill.md +125 -0
  168. package/agents/skills/architecture/adaptive-architecture.skill.md +51 -0
  169. package/agents/skills/architecture/api-design.skill.md +92 -0
  170. package/agents/skills/architecture/api-standards.skill.md +31 -0
  171. package/agents/skills/architecture/arch-debt.skill.md +180 -0
  172. package/agents/skills/architecture/arch-design.skill.md +304 -0
  173. package/agents/skills/architecture/arch-patterns.skill.md +52 -0
  174. package/agents/skills/architecture/arch-review.skill.md +326 -0
  175. package/agents/skills/architecture/architecture-governance.skill.md +62 -0
  176. package/agents/skills/architecture/attribute-driven-design.skill.md +108 -0
  177. package/agents/skills/architecture/blockchain-dlt.skill.md +28 -0
  178. package/agents/skills/architecture/compatibility-design.skill.md +51 -0
  179. package/agents/skills/architecture/critical-systems-arch.skill.md +31 -0
  180. package/agents/skills/architecture/design-patterns.skill.md +59 -0
  181. package/agents/skills/architecture/diagramming.skill.md +380 -0
  182. package/agents/skills/architecture/domain-model.skill.md +294 -0
  183. package/agents/skills/architecture/enterprise-migration-scenario.skill.md +31 -0
  184. package/agents/skills/architecture/enterprise-patterns.skill.md +31 -0
  185. package/agents/skills/architecture/error-handling-strategy.skill.md +58 -0
  186. package/agents/skills/architecture/event-driven-architecture.skill.md +31 -0
  187. package/agents/skills/architecture/event-governance.skill.md +55 -0
  188. package/agents/skills/architecture/fitness-functions.skill.md +111 -0
  189. package/agents/skills/architecture/graphql-schema.skill.md +64 -0
  190. package/agents/skills/architecture/legacy-modernization.skill.md +51 -0
  191. package/agents/skills/architecture/microservices.skill.md +31 -0
  192. package/agents/skills/architecture/middleware-design.skill.md +59 -0
  193. package/agents/skills/architecture/monolith.skill.md +31 -0
  194. package/agents/skills/architecture/realtime-comm.skill.md +52 -0
  195. package/agents/skills/architecture/state-management.skill.md +72 -0
  196. package/agents/skills/architecture/system-qualities.skill.md +31 -0
  197. package/agents/skills/architecture/system-scalability.skill.md +31 -0
  198. package/agents/skills/architecture/systems-architecture.skill.md +31 -0
  199. package/agents/skills/architecture/visual-whiteboarding.skill.md +33 -0
  200. package/agents/skills/brain/README.md +70 -0
  201. package/agents/skills/brain/active-inference.skill.md +74 -0
  202. package/agents/skills/brain/brain-mode.skill.md +125 -0
  203. package/agents/skills/brain/cognitive-architectures.skill.md +53 -0
  204. package/agents/skills/brain/cognitive-testing.skill.md +62 -0
  205. package/agents/skills/brain/consciousness-loop.skill.md +68 -0
  206. package/agents/skills/brain/cost-benefit-router.skill.md +89 -0
  207. package/agents/skills/brain/episodic-consolidation.skill.md +43 -0
  208. package/agents/skills/brain/epistemology-knowledge.skill.md +54 -0
  209. package/agents/skills/brain/global-workspace.skill.md +77 -0
  210. package/agents/skills/brain/learning-adaptation.skill.md +68 -0
  211. package/agents/skills/brain/loki-mode.skill.md +267 -0
  212. package/agents/skills/brain/neuroscience-foundations.skill.md +52 -0
  213. package/agents/skills/brain/scripts/active_inference_loop.py +92 -0
  214. package/agents/skills/brain/scripts/cognition_test.py +80 -0
  215. package/agents/skills/brain/scripts/global_workspace.py +104 -0
  216. package/agents/skills/brain/self-improvement.skill.md +80 -0
  217. package/agents/skills/brain/sensory-motor.skill.md +61 -0
  218. package/agents/skills/brain/sequential-thinking.skill.md +48 -0
  219. package/agents/skills/brain/working-memory.skill.md +47 -0
  220. package/agents/skills/coding/agent-trajectory-eval.skill.md +92 -0
  221. package/agents/skills/coding/artisan-commands.skill.md +52 -0
  222. package/agents/skills/coding/browser-tdd.skill.md +131 -0
  223. package/agents/skills/coding/chaos-fault-injection.skill.md +116 -0
  224. package/agents/skills/coding/ci-autofix.skill.md +53 -0
  225. package/agents/skills/coding/clean-coder.skill.md +58 -0
  226. package/agents/skills/coding/code-review.skill.md +100 -0
  227. package/agents/skills/coding/debug.skill.md +100 -0
  228. package/agents/skills/coding/documentation.skill.md +149 -0
  229. package/agents/skills/coding/eval-driven-development.skill.md +107 -0
  230. package/agents/skills/coding/evals/code-review.eval.yaml +29 -0
  231. package/agents/skills/coding/excalidraw.skill.md +90 -0
  232. package/agents/skills/coding/file-processing.skill.md +55 -0
  233. package/agents/skills/coding/git-workflow.skill.md +153 -0
  234. package/agents/skills/coding/metamorphic-testing.skill.md +113 -0
  235. package/agents/skills/coding/mobile-dev.skill.md +41 -0
  236. package/agents/skills/coding/nodejs-expert.skill.md +23 -0
  237. package/agents/skills/coding/output-validation.skill.md +57 -0
  238. package/agents/skills/coding/pbt-strategy.skill.md +117 -0
  239. package/agents/skills/coding/performant-ai.skill.md +62 -0
  240. package/agents/skills/coding/performant-go.skill.md +61 -0
  241. package/agents/skills/coding/performant-laravel.skill.md +70 -0
  242. package/agents/skills/coding/performant-nodejs.skill.md +67 -0
  243. package/agents/skills/coding/performant-php.skill.md +53 -0
  244. package/agents/skills/coding/performant-python.skill.md +62 -0
  245. package/agents/skills/coding/refactor.skill.md +124 -0
  246. package/agents/skills/coding/secure-coding.skill.md +57 -0
  247. package/agents/skills/coding/sketch-to-diagram.skill.md +106 -0
  248. package/agents/skills/coding/spec-driven-development.skill.md +110 -0
  249. package/agents/skills/coding/tdd-cycle.skill.md +92 -0
  250. package/agents/skills/coding/testing-strategy.skill.md +74 -0
  251. package/agents/skills/coding/time-complexity.skill.md +112 -0
  252. package/agents/skills/coding/tldraw-canvas.skill.md +109 -0
  253. package/agents/skills/coding/tool-construction.skill.md +47 -0
  254. package/agents/skills/coding/ui-gen.skill.md +64 -0
  255. package/agents/skills/coding/vibe-coding.skill.md +63 -0
  256. package/agents/skills/coding/visual-design.skill.md +65 -0
  257. package/agents/skills/coordination/agent-interop.skill.md +72 -0
  258. package/agents/skills/coordination/agent-protocol.skill.md +62 -0
  259. package/agents/skills/coordination/agent-workflow-patterns.skill.md +123 -0
  260. package/agents/skills/coordination/agentic-linter.skill.md +134 -0
  261. package/agents/skills/coordination/agentic-patterns.skill.md +79 -0
  262. package/agents/skills/coordination/meta-optimize.skill.md +62 -0
  263. package/agents/skills/coordination/meta-prompting.skill.md +46 -0
  264. package/agents/skills/coordination/multi-agent-orch.skill.md +78 -0
  265. package/agents/skills/coordination/persona-selector.skill.md +78 -0
  266. package/agents/skills/coordination/self-optimize.skill.md +81 -0
  267. package/agents/skills/coordination/swarm-consensus.skill.md +52 -0
  268. package/agents/skills/core/agent-analytics.skill.md +74 -0
  269. package/agents/skills/core/audit-trail.skill.md +122 -0
  270. package/agents/skills/core/clarify.skill.md +89 -0
  271. package/agents/skills/core/emerging-tech.skill.md +52 -0
  272. package/agents/skills/core/empirical-methods.skill.md +101 -0
  273. package/agents/skills/core/evals/clarify.eval.yaml +29 -0
  274. package/agents/skills/core/evals/integrity-check.eval.yaml +23 -0
  275. package/agents/skills/core/evals/research.eval.yaml +23 -0
  276. package/agents/skills/core/final-review.skill.md +66 -0
  277. package/agents/skills/core/integrity-check.skill.md +149 -0
  278. package/agents/skills/core/knowledge-connect.skill.md +77 -0
  279. package/agents/skills/core/knowledge-gap.skill.md +123 -0
  280. package/agents/skills/core/preflight.skill.md +106 -0
  281. package/agents/skills/core/research.skill.md +107 -0
  282. package/agents/skills/core/retrospective.skill.md +59 -0
  283. package/agents/skills/core/sdlc-checkpoint.skill.md +151 -0
  284. package/agents/skills/core/self-heal.skill.md +163 -0
  285. package/agents/skills/core/session-resume.skill.md +125 -0
  286. package/agents/skills/core/skills-registry.skill.md +65 -0
  287. package/agents/skills/core/state-portability.skill.md +89 -0
  288. package/agents/skills/core/state-preserve.skill.md +76 -0
  289. package/agents/skills/core/system-lifecycle.skill.md +51 -0
  290. package/agents/skills/core/update-scan.skill.md +92 -0
  291. package/agents/skills/data/data-engineering.skill.md +56 -0
  292. package/agents/skills/data/data-governance.skill.md +49 -0
  293. package/agents/skills/data/db-migration.skill.md +136 -0
  294. package/agents/skills/data/semantic-web.skill.md +28 -0
  295. package/agents/skills/data/sql-optimization.skill.md +78 -0
  296. package/agents/skills/industry/engineering-standards.skill.md +31 -0
  297. package/agents/skills/industry/global-standards.skill.md +30 -0
  298. package/agents/skills/industry/healthcare-fhir.skill.md +28 -0
  299. package/agents/skills/industry/industrial-iot.skill.md +30 -0
  300. package/agents/skills/industry/telecom-networks.skill.md +30 -0
  301. package/agents/skills/ops/caching-strategy.skill.md +77 -0
  302. package/agents/skills/ops/capacity-planning.skill.md +67 -0
  303. package/agents/skills/ops/cloud-deploy.skill.md +55 -0
  304. package/agents/skills/ops/configuration-management.skill.md +107 -0
  305. package/agents/skills/ops/cost-optimization.skill.md +39 -0
  306. package/agents/skills/ops/decommission-sunset.skill.md +64 -0
  307. package/agents/skills/ops/dependency-lifecycle.skill.md +63 -0
  308. package/agents/skills/ops/deployment.skill.md +217 -0
  309. package/agents/skills/ops/dev-environments.skill.md +31 -0
  310. package/agents/skills/ops/dev-workflow.skill.md +28 -0
  311. package/agents/skills/ops/docker-dev.skill.md +52 -0
  312. package/agents/skills/ops/enterprise-integration.skill.md +53 -0
  313. package/agents/skills/ops/feature-flag-management.skill.md +59 -0
  314. package/agents/skills/ops/incident-response.skill.md +40 -0
  315. package/agents/skills/ops/infra-devops.skill.md +53 -0
  316. package/agents/skills/ops/k8s-dev.skill.md +51 -0
  317. package/agents/skills/ops/memory-optimization.skill.md +45 -0
  318. package/agents/skills/ops/observability-stack-setup.skill.md +62 -0
  319. package/agents/skills/ops/performance-audit.skill.md +178 -0
  320. package/agents/skills/ops/performance-optimization.skill.md +51 -0
  321. package/agents/skills/ops/production-health.skill.md +85 -0
  322. package/agents/skills/ops/production-verifier.skill.md +50 -0
  323. package/agents/skills/ops/queue-management.skill.md +52 -0
  324. package/agents/skills/ops/release-management.skill.md +39 -0
  325. package/agents/skills/ops/release-validation.skill.md +51 -0
  326. package/agents/skills/ops/reliability-sre.skill.md +51 -0
  327. package/agents/skills/ops/runbook-authoring.skill.md +64 -0
  328. package/agents/skills/ops/system-benchmark.skill.md +69 -0
  329. package/agents/skills/ops/tech-debt.skill.md +143 -0
  330. package/agents/skills/ops/troubleshooting-guide.skill.md +31 -0
  331. package/agents/skills/product/accessibility.skill.md +143 -0
  332. package/agents/skills/product/adr-writer.skill.md +110 -0
  333. package/agents/skills/product/business-case.skill.md +70 -0
  334. package/agents/skills/product/change-management.skill.md +90 -0
  335. package/agents/skills/product/decompose.skill.md +75 -0
  336. package/agents/skills/product/design-thinking.skill.md +62 -0
  337. package/agents/skills/product/estimation-sizing.skill.md +87 -0
  338. package/agents/skills/product/evals/spec-writer.eval.yaml +22 -0
  339. package/agents/skills/product/financial-governance.skill.md +88 -0
  340. package/agents/skills/product/green-software.skill.md +46 -0
  341. package/agents/skills/product/ideation-facilitation.skill.md +87 -0
  342. package/agents/skills/product/market-analysis.skill.md +56 -0
  343. package/agents/skills/product/opportunity-assessment.skill.md +89 -0
  344. package/agents/skills/product/product-analytics.skill.md +92 -0
  345. package/agents/skills/product/professional-practice.skill.md +105 -0
  346. package/agents/skills/product/req-elicitation.skill.md +292 -0
  347. package/agents/skills/product/req-review.skill.md +280 -0
  348. package/agents/skills/product/spec-analyze.skill.md +98 -0
  349. package/agents/skills/product/spec-writer.skill.md +114 -0
  350. package/agents/skills/product/stakeholder-management.skill.md +54 -0
  351. package/agents/skills/product/sustainability-checks.skill.md +29 -0
  352. package/agents/skills/product/systems-thinking.skill.md +56 -0
  353. package/agents/skills/product/user-research-synthesis.skill.md +85 -0
  354. package/agents/skills/product/user-story-mapping.skill.md +54 -0
  355. package/agents/skills/product/visual-specs.skill.md +112 -0
  356. package/agents/skills/security/access-control.skill.md +45 -0
  357. package/agents/skills/security/agent-sandboxing.skill.md +69 -0
  358. package/agents/skills/security/ai-ethics-compliance.skill.md +46 -0
  359. package/agents/skills/security/ai-red-teaming.skill.md +74 -0
  360. package/agents/skills/security/ai-safety-guardrails.skill.md +60 -0
  361. package/agents/skills/security/api-security.skill.md +31 -0
  362. package/agents/skills/security/backup-recovery.skill.md +49 -0
  363. package/agents/skills/security/compliance-review.skill.md +152 -0
  364. package/agents/skills/security/cryptography-standards.skill.md +31 -0
  365. package/agents/skills/security/dependency-security.skill.md +47 -0
  366. package/agents/skills/security/hazard-analysis.skill.md +53 -0
  367. package/agents/skills/security/legal-review.skill.md +41 -0
  368. package/agents/skills/security/log-analysis.skill.md +68 -0
  369. package/agents/skills/security/network-security.skill.md +64 -0
  370. package/agents/skills/security/privacy-audit.skill.md +137 -0
  371. package/agents/skills/security/privacy-data-protection.skill.md +31 -0
  372. package/agents/skills/security/prompt-injection-defense.skill.md +67 -0
  373. package/agents/skills/security/reliability-engineering.skill.md +47 -0
  374. package/agents/skills/security/safety-scan.skill.md +49 -0
  375. package/agents/skills/security/secrets-management.skill.md +65 -0
  376. package/agents/skills/security/secure-architecture.skill.md +31 -0
  377. package/agents/skills/security/security-audit.skill.md +164 -0
  378. package/agents/skills/security/threat-model.skill.md +120 -0
  379. package/agents/skills/security/traceability-audit.skill.md +48 -0
  380. package/agents/templates/00-index.md +162 -0
  381. package/agents/templates/architecture/ADAPTIVE_SYSTEM_TEMPLATE.md +35 -0
  382. package/agents/templates/architecture/ADD_WORKBOOK_TEMPLATE.md +81 -0
  383. package/agents/templates/architecture/ADR_TEMPLATE.md +136 -0
  384. package/agents/templates/architecture/ARCHITECTURE_DECISION_MATRIX.md +169 -0
  385. package/agents/templates/architecture/ARCHITECTURE_REVIEW_TEMPLATE.md +241 -0
  386. package/agents/templates/architecture/ARCHITECTURE_VIEWS_TEMPLATE.md +353 -0
  387. package/agents/templates/architecture/ARCH_DECISION_FRAMEWORK.md +32 -0
  388. package/agents/templates/architecture/C4_ARCHITECTURE_TEMPLATE.md +185 -0
  389. package/agents/templates/architecture/CAPABILITY_MAP_TEMPLATE.md +153 -0
  390. package/agents/templates/architecture/CONTEXT_MAP_TEMPLATE.md +196 -0
  391. package/agents/templates/architecture/DESIGN_PATTERN_USAGE.md +24 -0
  392. package/agents/templates/architecture/DOMAIN_MODEL_TEMPLATE.md +254 -0
  393. package/agents/templates/architecture/FITNESS_FUNCTION_TEMPLATE.md +59 -0
  394. package/agents/templates/architecture/INTEGRATION_SPEC_TEMPLATE.md +38 -0
  395. package/agents/templates/architecture/LEGACY_AUDIT_TEMPLATE.md +34 -0
  396. package/agents/templates/architecture/QUALITY_ATTRIBUTES_TEMPLATE.md +210 -0
  397. package/agents/templates/architecture/SCALABILITY_ANALYSIS_TEMPLATE.md +46 -0
  398. package/agents/templates/architecture/SMART_CONTRACT_TEMPLATE.md +44 -0
  399. package/agents/templates/architecture/SYSTEM_CONTEXT_TEMPLATE.md +197 -0
  400. package/agents/templates/brain/ACTIVE_INFERENCE_LOOP_TEMPLATE.md +42 -0
  401. package/agents/templates/brain/EPISODIC_MEMORY_LOG_TEMPLATE.md +28 -0
  402. package/agents/templates/brain/GLOBAL_WORKSPACE_CONFIG_TEMPLATE.md +44 -0
  403. package/agents/templates/brain/KNOWLEDGE_MAP_TEMPLATE.md +53 -0
  404. package/agents/templates/brain/OODA_LOOP_TRACE_TEMPLATE.md +44 -0
  405. package/agents/templates/brain/PREDICTION_ERROR_LOG_TEMPLATE.md +33 -0
  406. package/agents/templates/brain/PROJECT_CONTEXT_TEMPLATE.md +36 -0
  407. package/agents/templates/brain/SELF_IMPROVEMENT_LOG_TEMPLATE.md +39 -0
  408. package/agents/templates/brain/WORKING_MEMORY_TEMPLATE.md +34 -0
  409. package/agents/templates/coding/CLEAN_CODE_CHECKLIST.md +30 -0
  410. package/agents/templates/coding/DESIGN_TOKENS_TEMPLATE.json +54 -0
  411. package/agents/templates/coding/DEVCONTAINER_TEMPLATE.json +42 -0
  412. package/agents/templates/coding/DEV_SPACE_TEMPLATE.yaml +48 -0
  413. package/agents/templates/coding/E2E_TEST_SUITE_TEMPLATE.md +36 -0
  414. package/agents/templates/coding/EVAL_PLAN_TEMPLATE.md +85 -0
  415. package/agents/templates/coding/EVAL_RUBRIC_TEMPLATE.md +57 -0
  416. package/agents/templates/coding/GOLDEN_DATASET_TEMPLATE.md +73 -0
  417. package/agents/templates/coding/PROPERTY_TEST_CHECKLIST.md +77 -0
  418. package/agents/templates/coding/SKETCH_TO_DIAGRAM_TEMPLATE.md +56 -0
  419. package/agents/templates/coding/TEST_CASE_TEMPLATE.md +28 -0
  420. package/agents/templates/coding/TEST_PLAN_TEMPLATE.md +36 -0
  421. package/agents/templates/coding/TIME_COMPLEXITY_REPORT_TEMPLATE.md +61 -0
  422. package/agents/templates/coordination/AGENTS_TEMPLATE.md +540 -0
  423. package/agents/templates/coordination/AGENT_HANDSHAKE_TEMPLATE.json +37 -0
  424. package/agents/templates/coordination/AGENT_PROFILE_TEMPLATE.md +28 -0
  425. package/agents/templates/coordination/SWARM_ARCHITECTURE_TEMPLATE.md +53 -0
  426. package/agents/templates/coordination/SWARM_CONFIG_TEMPLATE.json +45 -0
  427. package/agents/templates/core/AUDIT_LOG_TEMPLATE.md +75 -0
  428. package/agents/templates/core/BUG_REPORT_TEMPLATE.md +136 -0
  429. package/agents/templates/core/DEPENDENCY_GRAPH_TEMPLATE.md +63 -0
  430. package/agents/templates/core/ESTIMATION_TEMPLATE.md +70 -0
  431. package/agents/templates/core/MCP_CONFIG_TEMPLATE.json +807 -0
  432. package/agents/templates/core/PLAN_TEMPLATE.md +162 -0
  433. package/agents/templates/core/PROJECT_RETROSPECTIVE_TEMPLATE.md +67 -0
  434. package/agents/templates/core/SDLC_TRACKER.md +217 -0
  435. package/agents/templates/core/SESSION_SNAPSHOT_TEMPLATE.md +168 -0
  436. package/agents/templates/core/SYSTEM_ANALYSIS_TEMPLATE.md +52 -0
  437. package/agents/templates/core/TASKS_TEMPLATE.md +104 -0
  438. package/agents/templates/core/TRACEABILITY_MATRIX_TEMPLATE.md +18 -0
  439. package/agents/templates/core/WHITEBOARD_DESIGN_TEMPLATE.md +46 -0
  440. package/agents/templates/data/DATABASE_SCHEMA_TEMPLATE.md +38 -0
  441. package/agents/templates/data/DATA_PIPELINE_TEMPLATE.md +44 -0
  442. package/agents/templates/data/ONTOLOGY_TEMPLATE.md +52 -0
  443. package/agents/templates/industry/ENGINEERING_STANDARDS_REVIEW_TEMPLATE.md +43 -0
  444. package/agents/templates/industry/FHIR_INTEGRATION_TEMPLATE.md +53 -0
  445. package/agents/templates/industry/GLOBAL_STANDARDS_AUDIT_TEMPLATE.md +45 -0
  446. package/agents/templates/industry/IOT_TELEMETRY_TEMPLATE.md +59 -0
  447. package/agents/templates/industry/TELECOM_API_TEMPLATE.md +50 -0
  448. package/agents/templates/ops/BENCHMARK_REPORT_TEMPLATE.md +48 -0
  449. package/agents/templates/ops/CAPACITY_PLAN_TEMPLATE.md +41 -0
  450. package/agents/templates/ops/COST_OPTIMIZATION_REPORT_TEMPLATE.md +40 -0
  451. package/agents/templates/ops/DECOMMISSION_PLAN_TEMPLATE.md +102 -0
  452. package/agents/templates/ops/DEPLOY_CONFIG_TEMPLATE.md +88 -0
  453. package/agents/templates/ops/INCIDENT_POSTMORTEM_TEMPLATE.md +39 -0
  454. package/agents/templates/ops/INFRA_PLAN_TEMPLATE.md +37 -0
  455. package/agents/templates/ops/RELEASE_READINESS_REPORT.md +35 -0
  456. package/agents/templates/ops/RUNBOOK_TEMPLATE.md +103 -0
  457. package/agents/templates/ops/TECH_DEBT_TEMPLATE.md +102 -0
  458. package/agents/templates/product/BUSINESS_CASE_TEMPLATE.md +42 -0
  459. package/agents/templates/product/CHANGE_MANAGEMENT_PLAN_TEMPLATE.md +68 -0
  460. package/agents/templates/product/EMPATHY_MAP_TEMPLATE.md +47 -0
  461. package/agents/templates/product/EXPERIMENT_PLAN_TEMPLATE.md +84 -0
  462. package/agents/templates/product/GREEN_SOFTWARE_REPORT_TEMPLATE.md +42 -0
  463. package/agents/templates/product/IDEATION_LOG_TEMPLATE.md +42 -0
  464. package/agents/templates/product/NFR_TEMPLATE.md +31 -0
  465. package/agents/templates/product/PRD_TEMPLATE.md +222 -0
  466. package/agents/templates/product/PROBLEM_STATEMENT_TEMPLATE.md +32 -0
  467. package/agents/templates/product/REQUIREMENTS_REVIEW_TEMPLATE.md +173 -0
  468. package/agents/templates/product/SPEC_TEMPLATE.md +259 -0
  469. package/agents/templates/product/STAKEHOLDER_REGISTER_TEMPLATE.md +127 -0
  470. package/agents/templates/product/USER_STORY_MAP_TEMPLATE.md +35 -0
  471. package/agents/templates/product/VISUAL_SPEC_PACKAGE_TEMPLATE.md +207 -0
  472. package/agents/templates/security/DATASHEET_TEMPLATE.md +95 -0
  473. package/agents/templates/security/ETHICAL_IMPACT_ASSESSMENT.md +32 -0
  474. package/agents/templates/security/HAZARD_LOG.md +17 -0
  475. package/agents/templates/security/MODEL_CARD_TEMPLATE.md +120 -0
  476. package/agents/templates/security/SAFETY_CASE.md +39 -0
  477. package/agents/templates/security/SAFETY_POLICY.md +25 -0
  478. package/agents/templates/security/SECURITY_CHECKLIST.md +157 -0
  479. package/agents/templates/security/SYSTEM_CARD_TEMPLATE.md +139 -0
  480. package/agents/templates/security/THREAT_MODEL_TEMPLATE.md +171 -0
  481. package/bin/install.js +572 -0
  482. package/docs/CLI_REFERENCE.md +527 -0
  483. package/docs/INSTALL.md +68 -0
  484. package/docs/MCP_CONFIGURATIONS.md +1765 -0
  485. package/docs/PLATFORM_CONTROLS.md +324 -0
  486. package/docs/POST_INSTALL.md +75 -0
  487. package/docs/QUICK_COMMANDS.md +131 -0
  488. package/docs/QUICK_GUIDE.md +914 -0
  489. package/docs/README_FULL.md +1451 -0
  490. package/docs/SCHEMA.md +164 -0
  491. package/docs/V1_RELEASE_CHECKLIST.md +144 -0
  492. package/docs/VERIFICATION_GUIDE.md +283 -0
  493. package/docs/adr/0001-record-architecture-decisions.md +26 -0
  494. package/docs/adr/0002-brain-active-inference-runtime.md +27 -0
  495. package/docs/adr/0003-additive-only-emitter-schema-evolution.md +33 -0
  496. package/docs/assets/GABBE.png +0 -0
  497. package/docs/gabbe.config.example.json +9 -0
  498. package/docs/reports/duplication-report.md +30 -0
  499. package/install.ps1 +90 -0
  500. package/install.sh +89 -0
  501. package/package.json +49 -0
  502. package/scripts/init.py +1036 -0
@@ -0,0 +1,45 @@
1
+ {
2
+ "_comment": "Swarm Configuration - Defines the network topology of the multi-agent system.",
3
+ "swarm_id": "project-alpha-swarm",
4
+ "topology_type": "star | mesh | hierarchical",
5
+
6
+ "orchestrator": {
7
+ "agent_id": "loki-planner-01",
8
+ "endpoint": "http://localhost:8000"
9
+ },
10
+
11
+ "agents": [
12
+ {
13
+ "role": "frontend-coder",
14
+ "agent_id": "fe-01",
15
+ "transport": "sse",
16
+ "endpoint": "http://localhost:8001/events",
17
+ "capabilities": ["react", "css", "jest"]
18
+ },
19
+ {
20
+ "role": "backend-coder",
21
+ "agent_id": "be-01",
22
+ "transport": "http",
23
+ "endpoint": "http://localhost:8002/api",
24
+ "capabilities": ["node", "sql", "api"]
25
+ },
26
+ {
27
+ "role": "security-audit",
28
+ "agent_id": "sec-01",
29
+ "transport": "stdio",
30
+ "command": "python3 agents/security_agent.py",
31
+ "capabilities": ["sast", "audit"]
32
+ }
33
+ ],
34
+
35
+ "channels": {
36
+ "broadcast": "redis://localhost:6379/broadcast",
37
+ "tasks": "amqp://guest:guest@localhost:5672/tasks"
38
+ },
39
+
40
+ "policies": {
41
+ "max_hops": 5,
42
+ "timeout_ms": 30000,
43
+ "retry_count": 3
44
+ }
45
+ }
@@ -0,0 +1,75 @@
1
+ # AUDIT_LOG.md — Project Audit Trail
2
+ <!-- APPEND ONLY — never delete or modify existing entries -->
3
+ <!-- Updated by: audit-trail.skill | Read by: session-resume.skill, integrity-check.skill -->
4
+ <!-- Project: [Project Name] | Started: [date] | Format version: 1.0 -->
5
+
6
+ ---
7
+
8
+ ## Log Format
9
+
10
+ ```
11
+ | Timestamp (ISO 8601) | Session ID | Agent/Human | Action Type | Description | Outcome | References |
12
+ ```
13
+
14
+ **Session ID format:** `S[SDLC-phase]-[sequential-number]` (e.g., `S01-001`, `S05-023`)
15
+
16
+ **Action Types:**
17
+ | Type | When to use |
18
+ |---|---|
19
+ | `DECISION` | A choice was made between options |
20
+ | `PHASE_TRANSITION` | SDLC phase changed (sdlc-checkpoint.skill) |
21
+ | `TASK_DONE` | A task completed successfully |
22
+ | `TASK_BLOCKED` | A task is stuck, human decision needed |
23
+ | `QUALITY_GATE` | Quality gate pass/fail result |
24
+ | `SECURITY_FINDING` | Security issue found (include severity) |
25
+ | `ADR_CREATED` | Architecture decision documented |
26
+ | `HUMAN_ESCALATION` | Agent escalated to human (5 attempts exhausted) |
27
+ | `SELF_HEAL_ATTEMPT` | Agent tried to self-fix (include attempt N/5) |
28
+ | `RESEARCH_FINDING` | Authoritative source verified |
29
+ | `HUMAN_APPROVED` | Human provided approval/decision |
30
+ | `ERROR` | Unexpected error encountered |
31
+ | `ROLLBACK` | A change was reverted |
32
+
33
+ **Outcome values:** `SUCCESS` | `FAIL` | `PASS` | `OPEN` | `RESOLVED` | `APPROVED` | `REJECTED` | `ESCALATED`
34
+
35
+ ---
36
+
37
+ ## Instructions for Agents
38
+
39
+ 1. **Append a new row** for every significant action (do NOT edit existing rows)
40
+ 2. **Do NOT overwrite** this file — always append
41
+ 3. **Reference artifacts** by path or URL in the References column
42
+ 4. **Be specific** in Description — "fixed auth bug" is bad; "removed missing null check on user.email in UserService.update() line 42" is good
43
+ 5. For HUMAN_ESCALATION: add a note row below the entry with the escalation report summary
44
+
45
+ ---
46
+
47
+ ## Log Entries
48
+
49
+ | Timestamp | Session | Agent/Human | Action Type | Description | Outcome | References |
50
+ |---|---|---|---|---|---|---|
51
+ | [INIT] | S00-001 | setup-context.sh | PHASE_TRANSITION | agents/ kit initialized for project | SUCCESS | agents/README_FULL.md |
52
+
53
+ <!--
54
+ EXAMPLE ENTRIES (remove this comment block when using):
55
+
56
+ | 2025-03-15T09:00:00Z | S01-001 | prod-pm | DECISION | Chose EARS format for requirements over user story format | SUCCESS | docs/PRD.md |
57
+ | 2025-03-15T09:30:00Z | S01-001 | prod-pm | PHASE_TRANSITION | PRD.md completed — awaiting human approval for S01 | OPEN | docs/PRD.md |
58
+ | 2025-03-15T10:00:00Z | S01-001 | human:alice | HUMAN_APPROVED | PRD.md approved — 12 EARS requirements signed off | APPROVED | docs/PRD.md |
59
+ | 2025-03-15T10:01:00Z | S01-001 | sdlc-checkpoint | PHASE_TRANSITION | S01 Requirements checkpoint created | SUCCESS | agents/memory/episodic/SESSION_SNAPSHOT/S01_requirements.md |
60
+ | 2025-03-15T11:00:00Z | S02-001 | prod-architect | ADR_CREATED | Chose Prisma over TypeORM — performance + type safety | ACCEPTED | docs/architecture/decisions/ADR-001-prisma.md |
61
+ | 2025-03-15T11:30:00Z | S02-001 | prod-architect | DECISION | Chose Clean Architecture — domain/application/adapters/infra/main | ACCEPTED | docs/PLAN.md |
62
+ | 2025-03-15T14:00:00Z | S05-001 | eng-backend | TASK_DONE | T-001: Created User domain entity with email value object | SUCCESS | src/domain/user.ts |
63
+ | 2025-03-15T14:30:00Z | S05-001 | eng-backend | SELF_HEAL_ATTEMPT | T-002: TypeScript error on UserDto.email — attempt 1/5 — null check missing | FAIL | src/application/create-user.use-case.ts:42 |
64
+ | 2025-03-15T14:35:00Z | S05-001 | eng-backend | TASK_DONE | T-002: Fixed type error — added null guard before email access | SUCCESS | src/application/create-user.use-case.ts |
65
+ | 2025-03-15T16:00:00Z | S05-001 | eng-backend | TASK_BLOCKED | T-020: Cannot implement payment integration — unclear if Stripe or Paddle | OPEN | project/TASKS.md |
66
+ | 2025-03-15T16:01:00Z | S05-001 | eng-backend | HUMAN_ESCALATION | T-020 blocked: Payment provider not decided. Options: Stripe (fees: 2.9%) vs Paddle (fees: 5%). Recommend Stripe (direct settlement). | ESCALATED | project/TASKS.md |
67
+ | 2025-03-15T16:45:00Z | S05-001 | human:bob | DECISION | Use Stripe for payment processing — direct settlement preferred | APPROVED | — |
68
+ | 2025-03-15T17:00:00Z | S06-001 | orch-judge | QUALITY_GATE | Gate 3 Tests: 247 pass, 0 fail, 0 skip, 84% coverage | PASS | — |
69
+ | 2025-03-15T17:05:00Z | S07-001 | ops-security | SECURITY_FINDING | HIGH: No rate limit on /auth/login endpoint — brute force possible | OPEN | src/adapters/http/auth.controller.ts:23 |
70
+ | 2025-03-15T17:30:00Z | S07-001 | eng-backend | TASK_DONE | Added rate limiting to /auth/login: 5 req/min per IP | SUCCESS | src/adapters/http/auth.controller.ts |
71
+ | 2025-03-15T17:31:00Z | S07-001 | ops-security | SECURITY_FINDING | HIGH: No rate limit on /auth/login — RESOLVED | RESOLVED | src/adapters/http/auth.controller.ts |
72
+ | 2025-03-15T18:00:00Z | S08-001 | human:alice | HUMAN_APPROVED | Code review approved — all feedback addressed | APPROVED | PR #42 |
73
+ | 2025-03-15T18:01:00Z | S10-001 | sdlc-checkpoint | PHASE_TRANSITION | S10 Production deployed. Project complete | SUCCESS | agents/memory/episodic/SESSION_SNAPSHOT/S10_production.md |
74
+
75
+ END EXAMPLES -->
@@ -0,0 +1,136 @@
1
+ # Bug Report: [Brief Title]
2
+ <!-- Fill before using debug.skill — helps agent understand and reproduce the bug -->
3
+ <!-- Created: [date] | Reported by: [name] -->
4
+
5
+ ---
6
+
7
+ ## Summary
8
+
9
+ **One-line description:** [What is broken in plain language]
10
+
11
+ **Severity:** Critical | High | Medium | Low
12
+
13
+ **Impact:** [Who is affected, how often, what the business impact is]
14
+
15
+ **Environment:**
16
+ ```
17
+ OS: [Linux / macOS / Windows + version]
18
+ Browser: [Chrome 120 / Firefox 121 / N/A]
19
+ Node/PHP/etc: [runtime version]
20
+ App version: [git commit hash or release tag]
21
+ Database: [PostgreSQL 16 / MySQL 8 / etc]
22
+ ```
23
+
24
+ ---
25
+
26
+ ## Steps to Reproduce
27
+
28
+ <!-- Be specific — a bug that can't be reproduced can't be fixed -->
29
+
30
+ 1. [Starting state: "Given a user is logged in as role X"]
31
+ 2. [Action: "When they navigate to /settings/profile"]
32
+ 3. [Action: "And they click 'Save Changes' without modifying any field"]
33
+ 4. [Observed: "Then they see a 500 Internal Server Error"]
34
+
35
+ **Minimum reproduction:** [The fewest steps to see the bug]
36
+
37
+ **Is it reproducible?** [Always / Intermittently (estimate %) / Rare / Only once]
38
+
39
+ **Reproduction rate (if intermittent):** [Approximately X out of Y tries]
40
+
41
+ ---
42
+
43
+ ## Expected Behavior
44
+
45
+ [What should have happened? Be specific.]
46
+
47
+ Example: "Clicking 'Save Changes' with unchanged data should return 200 OK and display 'No changes saved' message."
48
+
49
+ ---
50
+
51
+ ## Actual Behavior
52
+
53
+ [What actually happens? Include exact error messages, HTTP status codes, UI state.]
54
+
55
+ Example: "API returns HTTP 500 with body: `{ "error": "Cannot read properties of undefined (reading 'email')" }`"
56
+
57
+ ---
58
+
59
+ ## Error Messages & Stack Trace
60
+
61
+ ```
62
+ [Paste full error message and stack trace here]
63
+
64
+ Example:
65
+ TypeError: Cannot read properties of undefined (reading 'email')
66
+ at UserController.update (/app/src/adapters/http/user.controller.ts:45:22)
67
+ at Layer.handle [as handle_request] (/app/node_modules/express/lib/router/layer.js:95:5)
68
+ ```
69
+
70
+ ---
71
+
72
+ ## Logs
73
+
74
+ ```
75
+ [Relevant log lines from application or server logs]
76
+ [Include timestamps if available]
77
+ ```
78
+
79
+ ---
80
+
81
+ ## Screenshots / Videos
82
+
83
+ [If UI bug: link to screenshot or screen recording]
84
+ [If API bug: include request/response from browser DevTools or Postman]
85
+
86
+ **API Request:**
87
+ ```
88
+ POST /api/v1/users/123 HTTP/1.1
89
+ Authorization: Bearer [token]
90
+ Content-Type: application/json
91
+
92
+ {}
93
+ ```
94
+
95
+ **API Response:**
96
+ ```
97
+ HTTP/1.1 500 Internal Server Error
98
+ Content-Type: application/json
99
+
100
+ { "error": "Internal server error" }
101
+ ```
102
+
103
+ ---
104
+
105
+ ## Hypothesis (Initial Guess)
106
+
107
+ [Your initial hypothesis about what's causing the bug — even if uncertain]
108
+
109
+ Example: "Suspect the save handler doesn't check for empty body before accessing `body.email`"
110
+
111
+ ---
112
+
113
+ ## Context
114
+
115
+ **Related code:** [file path and line number if known]
116
+ **Related PR/commit:** [link if you know when this was introduced]
117
+ **Regression?** [Did this work before? When did it stop working?]
118
+ **Workaround?** [Is there a temporary workaround users can use?]
119
+
120
+ ---
121
+
122
+ ## Definition of Fixed
123
+
124
+ <!-- What exact behavior will confirm this bug is resolved? -->
125
+
126
+ - [ ] [Specific test that must pass]
127
+ - [ ] [Specific behavior that must work]
128
+ - [ ] [No regressions in related functionality]
129
+
130
+ ---
131
+
132
+ ## Assignment
133
+
134
+ **Assigned to:** [agent / human developer]
135
+ **Priority:** [P1 (immediate) / P2 (this sprint) / P3 (backlog)]
136
+ **Labels:** [ui, api, database, performance, security]
@@ -0,0 +1,63 @@
1
+ # Dependency & Parallelism Worksheet: [Project / Milestone Name]
2
+
3
+ **Date:** [YYYY-MM-DD]
4
+ **Author:** [name]
5
+ **Status:** Draft | Reviewed
6
+
7
+ <!-- Goal: find what can run in parallel, what's on the critical path, and where
8
+ resources collide. This drives scheduling and staffing decisions. -->
9
+
10
+ ---
11
+
12
+ ## 1. Task Dependency Table
13
+
14
+ | Task | Depends on | Blocks | Can parallelize with | Resource conflicts |
15
+ |---|---|---|---|---|
16
+ | [T1: name] | [—] | [T3, T4] | [T2] | [None] |
17
+ | [T2: name] | [—] | [T4] | [T1] | [Shares DB migration window with T5] |
18
+ | [T3: name] | [T1] | [ ] | [ ] | [ ] |
19
+ | [T4: name] | [T1, T2] | [ ] | [ ] | [ ] |
20
+
21
+ ---
22
+
23
+ ## 2. Critical Path
24
+
25
+ <!-- The longest chain of dependent tasks. Its length is the floor on project
26
+ duration — shortening anything OFF this path does not help. -->
27
+
28
+ **Path:** [T1 → T4 → ... → done]
29
+ **Estimated length:** [sum of durations along the path]
30
+ **Slack elsewhere:** [Tasks with float and how much, e.g. "T2 has 2d slack."]
31
+ **Biggest risk on the path:** [Which task, and why.]
32
+
33
+ ---
34
+
35
+ ## 3. Dependency DAG
36
+
37
+ <!-- Replace with a real graph. Mermaid or plain arrows both fine. -->
38
+
39
+ ```mermaid
40
+ graph LR
41
+ T1[T1: name] --> T3[T3: name]
42
+ T1 --> T4[T4: name]
43
+ T2[T2: name] --> T4
44
+ T4 --> DONE[Done]
45
+ ```
46
+
47
+ Plain-text fallback:
48
+ ```
49
+ T1 ─┬─> T3
50
+ └─> T4 ──> DONE
51
+ T2 ─────> T4
52
+ ```
53
+
54
+ ---
55
+
56
+ ## 4. Parallelization Plan
57
+
58
+ | Wave | Tasks runnable together | Owner(s) | Gate to next wave |
59
+ |---|---|---|---|
60
+ | 1 | [T1, T2] | [ ] | [Both complete] |
61
+ | 2 | [T3, T4] | [ ] | [ ] |
62
+
63
+ **Resource bottlenecks:** [Shared people, environments, or services that cap actual parallelism below the theoretical max.]
@@ -0,0 +1,70 @@
1
+ # Estimation Worksheet: [Project / Feature Name]
2
+
3
+ **Date:** [YYYY-MM-DD]
4
+ **Estimator(s):** [names or roles]
5
+ **Status:** Draft | Reviewed | Final
6
+
7
+ ---
8
+
9
+ ## 1. Scope
10
+
11
+ **In scope:** [What work is being estimated? e.g., "Backend API + DB migration for the new billing module".]
12
+ **Out of scope:** [What is explicitly NOT included? e.g., "Frontend UI, third-party tax integration".]
13
+ **Assumptions baked into this estimate:** [List the load-bearing assumptions; if one breaks, the estimate breaks.]
14
+
15
+ ---
16
+
17
+ ## 2. Method
18
+
19
+ Pick one (or combine) and justify:
20
+
21
+ | Method | When to use | Selected? |
22
+ |---|---|---|
23
+ | Reference-class forecasting | Similar past projects exist to anchor against | [Yes/No] |
24
+ | Story points (relative) | Team has a stable velocity baseline | [Yes/No] |
25
+ | T-shirt sizing (XS–XL) | Early/coarse; no detailed breakdown yet | [Yes/No] |
26
+
27
+ **Justification:** [Why this method fits the current uncertainty and available data.]
28
+
29
+ ---
30
+
31
+ ## 3. Per-Item Estimates
32
+
33
+ P50 = "as likely to finish before as after." P90 = "90% chance we finish by this." The P90/P50 gap is the risk premium.
34
+
35
+ | Item | Size | P50 | P90 | Confidence | Assumptions |
36
+ |---|---|---|---|---|---|
37
+ | [Task / story] | [XS–XL or pts] | [e.g. 2d] | [e.g. 5d] | [Low/Med/High] | [Key assumption] |
38
+ | [Task / story] | [ ] | [ ] | [ ] | [ ] | [ ] |
39
+ | [Task / story] | [ ] | [ ] | [ ] | [ ] | [ ] |
40
+
41
+ ---
42
+
43
+ ## 4. Cone of Uncertainty
44
+
45
+ <!-- Early estimates can be off by 4x in either direction; the range narrows only as work is done.
46
+ Record WHERE on the cone this estimate sits so readers calibrate trust. -->
47
+
48
+ **Phase:** [Concept / Requirements-set / Design-complete / In-progress]
49
+ **Expected error band at this phase:** [e.g. "0.5x to 2x" early; "0.8x to 1.25x" mid-flight]
50
+ **What would tighten the cone:** [Spikes, prototypes, or decisions that would reduce uncertainty.]
51
+
52
+ ---
53
+
54
+ ## 5. Total Range
55
+
56
+ | Roll-up | Optimistic (sum P50) | Realistic (P90-weighted) | Pessimistic (sum P90) |
57
+ |---|---|---|---|
58
+ | Effort | [ ] | [ ] | [ ] |
59
+ | Calendar (with WIP/parallelism) | [ ] | [ ] | [ ] |
60
+
61
+ **Stated range:** [e.g. "3–6 weeks, most likely 4."]
62
+
63
+ ---
64
+
65
+ ## 6. Honesty Note
66
+
67
+ > An estimate is a probability range, not a commitment or a deadline.
68
+ > Reporting a single number hides the risk. Always present the range and the
69
+ > confidence behind it. If a date is needed, derive it from the P90 plus an
70
+ > explicit buffer — and say so out loud.