@jetrabbits/agentic 0.4.0 → 0.5.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 (93) hide show
  1. package/AGENTS.md +8 -0
  2. package/CHANGELOG.md +3 -0
  3. package/Makefile +21 -5
  4. package/README.md +17 -4
  5. package/agentic +78 -7
  6. package/areas/devops/ci-cd/workflows/onboard-repo.md +29 -0
  7. package/areas/devops/ci-cd/workflows/pipeline-debug.md +26 -0
  8. package/areas/devops/ci-cd/workflows/release-pipeline.md +53 -0
  9. package/areas/devops/database-ops/workflows/backup-verify.md +27 -0
  10. package/areas/devops/database-ops/workflows/db-incident.md +30 -0
  11. package/areas/devops/devsecops/workflows/policy-onboard.md +34 -0
  12. package/areas/devops/devsecops/workflows/security-scan-pipeline.md +33 -0
  13. package/areas/devops/infrastructure/workflows/destroy-environment.md +31 -0
  14. package/areas/devops/infrastructure/workflows/drift-remediation.md +29 -0
  15. package/areas/devops/infrastructure/workflows/module-development.md +32 -0
  16. package/areas/devops/infrastructure/workflows/provision-environment.md +29 -0
  17. package/areas/devops/kubernetes/workflows/cluster-bootstrap.md +36 -0
  18. package/areas/devops/kubernetes/workflows/debug-workload.md +29 -0
  19. package/areas/devops/kubernetes/workflows/onboard-service.md +35 -0
  20. package/areas/devops/kubernetes/workflows/upgrade-cluster.md +30 -0
  21. package/areas/devops/networking/workflows/onboard-ingress.md +27 -0
  22. package/areas/devops/networking/workflows/service-mesh-onboard.md +27 -0
  23. package/areas/devops/observability/workflows/alert-investigation.md +29 -0
  24. package/areas/devops/observability/workflows/observability-stack-setup.md +33 -0
  25. package/areas/devops/observability/workflows/onboard-service-monitoring.md +31 -0
  26. package/areas/devops/sre/workflows/incident-response.md +48 -0
  27. package/areas/devops/sre/workflows/postmortem.md +32 -0
  28. package/areas/devops/sre/workflows/slo-review.md +35 -1
  29. package/areas/software/backend/workflows/add-migration.md +33 -0
  30. package/areas/software/backend/workflows/create-endpoint.md +40 -0
  31. package/areas/software/backend/workflows/debug-issue.md +31 -0
  32. package/areas/software/backend/workflows/develop-epic.md +37 -0
  33. package/areas/software/backend/workflows/develop-feature.md +44 -0
  34. package/areas/software/backend/workflows/refactor-module.md +35 -0
  35. package/areas/software/backend/workflows/test-feature.md +30 -0
  36. package/areas/software/data-engineering/workflows/backfill-data.md +25 -0
  37. package/areas/software/data-engineering/workflows/data-quality-incident.md +31 -0
  38. package/areas/software/data-engineering/workflows/lineage-trace.md +25 -0
  39. package/areas/software/data-engineering/workflows/new-model.md +30 -0
  40. package/areas/software/data-engineering/workflows/schema-migration.md +29 -0
  41. package/areas/software/frontend/workflows/a11y-fix.md +30 -0
  42. package/areas/software/frontend/workflows/bundle-analyze.md +28 -0
  43. package/areas/software/frontend/workflows/release-prep.md +33 -0
  44. package/areas/software/frontend/workflows/scaffold-component.md +32 -0
  45. package/areas/software/frontend/workflows/visual-regression.md +32 -0
  46. package/areas/software/full-stack/workflows/backend-project-full-cycle.md +47 -2
  47. package/areas/software/full-stack/workflows/debug-issue.md +29 -0
  48. package/areas/software/full-stack/workflows/develop-feature.md +38 -0
  49. package/areas/software/full-stack/workflows/feature-implementation-flow.md +38 -0
  50. package/areas/software/full-stack/workflows/testing-ci-pipeline.md +30 -0
  51. package/areas/software/general/workflows/code-review-workflow.md +31 -0
  52. package/areas/software/general/workflows/development-cycle-workflow.md +38 -0
  53. package/areas/software/general/workflows/project-setup-workflow.md +38 -0
  54. package/areas/software/mlops/workflows/champion-challenger.md +29 -0
  55. package/areas/software/mlops/workflows/deploy-endpoint.md +30 -0
  56. package/areas/software/mlops/workflows/evaluate-model.md +28 -0
  57. package/areas/software/mlops/workflows/model-incident.md +29 -0
  58. package/areas/software/mlops/workflows/train-experiment.md +25 -0
  59. package/areas/software/mobile/workflows/crash-triage.md +28 -0
  60. package/areas/software/mobile/workflows/device-testing.md +27 -0
  61. package/areas/software/mobile/workflows/ota-update.md +25 -0
  62. package/areas/software/mobile/workflows/release-build.md +30 -0
  63. package/areas/software/mobile/workflows/store-submission.md +29 -0
  64. package/areas/software/platform/workflows/cost-audit.md +28 -0
  65. package/areas/software/platform/workflows/deploy-production.md +30 -0
  66. package/areas/software/platform/workflows/drift-check.md +29 -0
  67. package/areas/software/platform/workflows/incident-response.md +33 -0
  68. package/areas/software/platform/workflows/provision-env.md +36 -0
  69. package/areas/software/qa/workflows/flakiness-investigation.md +30 -0
  70. package/areas/software/qa/workflows/performance-audit.md +29 -0
  71. package/areas/software/qa/workflows/regression-suite.md +28 -0
  72. package/areas/software/qa/workflows/smoke-test.md +31 -0
  73. package/areas/software/qa/workflows/test-coverage-report.md +28 -0
  74. package/areas/software/security/workflows/compliance-report.md +27 -0
  75. package/areas/software/security/workflows/pen-test-sim.md +28 -0
  76. package/areas/software/security/workflows/secret-rotation.md +33 -2
  77. package/areas/software/security/workflows/security-scan.md +29 -0
  78. package/areas/software/security/workflows/threat-model-review.md +30 -0
  79. package/docs/agentic-usage.md +1 -1
  80. package/docs/catalog.schema.json +5 -1
  81. package/docs/opencode_setup.md +10 -0
  82. package/docs/site/README.md +15 -1
  83. package/docs/site/app.js +68 -0
  84. package/docs/site/catalog.json +74 -1
  85. package/docs/site/index.html +5 -1
  86. package/docs/site/styles.css +52 -4
  87. package/extensions/opencode/opencode.json +0 -1
  88. package/extensions/opencode/profiles/githubcopilot/opencode.json +1 -2
  89. package/extensions/opencode/profiles/openai/opencode.json +20 -20
  90. package/package.json +1 -1
  91. package/scripts/build_docs_catalog.py +13 -1
  92. package/scripts/sync_workflow_diagrams.py +199 -0
  93. package/extensions/opencode/plugins/sound-notification.ts +0 -13
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.1.0",
2
+ "version": "1.2.0",
3
3
  "generated_from": "areas/**/{workflows,prompts}",
4
4
  "areas": [
5
5
  {
@@ -57,6 +57,7 @@
57
57
  "pipeline runs green on first PR",
58
58
  "all mandatory stages present"
59
59
  ],
60
+ "workflow_diagram": "flowchart TD\n start([\"Start /onboard-repo\"])\n role_1[\"devops-engineer\"]\n role_2[\"developer\"]\n step_1[\"1. Assess & Plan\"]\n step_2[\"2. Secrets & Environments Setup\"]\n step_3[\"3. Write Pipeline Config\"]\n step_4[\"4. First Run & Debug\"]\n step_5[\"5. Document\"]\n exit([\"Green pipeline + staging deploy + documentation = repo onboarded.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_2 -. owns .-> step_4\n role_1 -. owns .-> step_5",
60
61
  "examples": {
61
62
  "both": [
62
63
  {
@@ -119,6 +120,7 @@
119
120
  }
120
121
  ],
121
122
  "quality_gates": [],
123
+ "workflow_diagram": "flowchart TD\n start([\"Start /pipeline-debug\"])\n role_1[\"devops-engineer\"]\n role_2[\"developer\"]\n step_1[\"1. Classify Failure\"]\n step_2[\"2. Diagnose by Category\"]\n step_3[\"3. Fix & Verify\"]\n step_4[\"4. Merge & Monitor\"]\n exit([\"Pipeline green + root cause documented in ticket = debug complete.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4",
122
124
  "examples": {
123
125
  "both": [
124
126
  {
@@ -199,6 +201,7 @@
199
201
  "staging deploy healthy >= 15 min before production gate",
200
202
  "manual approval from team-lead for production"
201
203
  ],
204
+ "workflow_diagram": "flowchart TD\n start([\"Start /release-pipeline\"])\n role_1[\"team-lead\"]\n role_2[\"pm\"]\n role_3[\"developer\"]\n role_4[\"devops-engineer\"]\n role_5[\"qa\"]\n step_1[\"1. Release Readiness and Freeze Check\"]\n step_2[\"2. Database Compatibility Gate\"]\n step_3[\"3. Tag Release\"]\n step_4[\"4. CI Release Pipeline (automated) — CI system\"]\n step_5[\"5. Deploy Staging\"]\n step_6[\"6. Production Gate\"]\n step_7[\"7. Canary Deployment\"]\n step_8[\"8. Feature Flag Progression\"]\n step_9[\"9. Post-Deploy Validation\"]\n exit([\"Release is complete when 100% traffic is healthy, post-deploy checks pass,...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> step_7\n step_7 --> step_8\n step_8 --> step_9\n step_9 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_1\n role_3 -. owns .-> step_2\n role_4 -. owns .-> step_2\n role_3 -. owns .-> step_3\n role_3 -. owns .-> step_4\n role_4 -. owns .-> step_4\n role_1 -. owns .-> step_4\n role_2 -. owns .-> step_4\n role_5 -. owns .-> step_4\n role_4 -. owns .-> step_5\n role_1 -. owns .-> step_6\n role_5 -. owns .-> step_6\n role_4 -. owns .-> step_7\n role_3 -. owns .-> step_8\n role_5 -. owns .-> step_8\n role_5 -. owns .-> step_9\n role_2 -. owns .-> step_9\n step_9 -. iterate if blocked .-> step_1",
202
205
  "examples": {
203
206
  "both": [
204
207
  {
@@ -264,6 +267,7 @@
264
267
  "row counts match production within 1%",
265
268
  "backup age < 26 hours"
266
269
  ],
270
+ "workflow_diagram": "flowchart TD\n start([\"Start /backup-verify\"])\n role_1[\"devops-engineer\"]\n step_1[\"1. Pre-Check: Backup Catalog\"]\n step_2[\"2. Provision Test Environment\"]\n step_3[\"3. Restore Latest Backup\"]\n step_4[\"4. Row Count Validation\"]\n step_5[\"5. Report + Cleanup\"]\n exit([\"Restore successful + row counts validated + test env destroyed + report pos...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5",
267
271
  "examples": {
268
272
  "both": [
269
273
  {
@@ -325,6 +329,7 @@
325
329
  "quality_gates": [
326
330
  "backup verified before any destructive action"
327
331
  ],
332
+ "workflow_diagram": "flowchart TD\n start([\"Start /db-incident\"])\n role_1[\"devops-engineer\"]\n role_2[\"developer\"]\n step_1[\"1. Triage\"]\n step_2[\"2. Immediate Mitigation by Type\"]\n step_3[\"3. Root Cause\"]\n step_4[\"4. Fix & Verify\"]\n step_5[\"5. Document\"]\n exit([\"Metrics normal + root cause documented = db incident resolved.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5",
328
333
  "examples": {
329
334
  "both": [
330
335
  {
@@ -398,6 +403,7 @@
398
403
  "each policy tested with passing AND failing manifest before deploy",
399
404
  "dryrun in staging before enforce in production"
400
405
  ],
406
+ "workflow_diagram": "flowchart TD\n start([\"Start /policy-onboard\"])\n role_1[\"devops-engineer\"]\n role_2[\"developer\"]\n role_3[\"team-lead\"]\n step_1[\"1. Design Policy\"]\n step_2[\"2. Unit Test\"]\n step_3[\"3. Dryrun in Staging\"]\n step_4[\"4. Fix Existing Violations\"]\n step_5[\"5. Switch to Enforce\"]\n step_6[\"6. Monitor Policy Health\"]\n exit([\"Policy tested + existing violations resolved + enforce mode active + monito...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5\n role_3 -. owns .-> step_5\n role_1 -. owns .-> step_6",
401
407
  "examples": {
402
408
  "both": [
403
409
  {
@@ -471,6 +477,7 @@
471
477
  "zero Critical/High unresolved before release",
472
478
  "SBOM generated and attached to image"
473
479
  ],
480
+ "workflow_diagram": "flowchart TD\n start([\"Start /security-scan-pipeline\"])\n role_1[\"devops-engineer\"]\n step_1[\"1. Secrets Scan\"]\n step_2[\"2. SAST (Static Analysis)\"]\n step_3[\"3. Dependency CVE Scan\"]\n step_4[\"4. Container Image Scan\"]\n step_5[\"5. IaC Security Scan\"]\n step_6[\"6. Generate SBOM\"]\n step_7[\"7. Collate Report\"]\n exit([\"Zero unresolved Critical/High + SBOM attached + scan report filed = securit...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> step_7\n step_7 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5\n role_1 -. owns .-> step_6\n role_1 -. owns .-> step_7",
474
481
  "examples": {
475
482
  "both": [
476
483
  {
@@ -543,6 +550,7 @@
543
550
  "explicit team-lead approval required before any destroy",
544
551
  "backup of state file taken before destroy"
545
552
  ],
553
+ "workflow_diagram": "flowchart TD\n start([\"Start /destroy-environment\"])\n role_1[\"devops-engineer\"]\n role_2[\"team-lead\"]\n step_1[\"1. Confirm Scope\"]\n step_2[\"2. Approval\"]\n step_3[\"3. Pre-Destroy Backup\"]\n step_4[\"4. Ordered Teardown\"]\n step_5[\"5. Verify & Cleanup\"]\n step_6[\"6. Document\"]\n exit([\"Terraform state empty + cloud console clean + documentation filed = environ...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5\n role_1 -. owns .-> step_6",
546
554
  "examples": {
547
555
  "both": [
548
556
  {
@@ -603,6 +611,7 @@
603
611
  "quality_gates": [
604
612
  "drift classified before any apply"
605
613
  ],
614
+ "workflow_diagram": "flowchart TD\n start([\"Start /drift-remediation\"])\n role_1[\"devops-engineer\"]\n role_2[\"team-lead\"]\n step_1[\"1. Detect Drift\"]\n step_2[\"2. Classify Findings\"]\n step_3[\"3. Remediate (if REMEDIATE class)\"]\n step_4[\"4. Investigate (if INVESTIGATE class)\"]\n step_5[\"5. Report\"]\n exit([\"All drift classified + REMEDIATE resolved + INVESTIGATE escalated = drift c...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_2 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5",
606
615
  "examples": {
607
616
  "both": [
608
617
  {
@@ -666,6 +675,7 @@
666
675
  "terraform validate passes",
667
676
  "no provider config inside module"
668
677
  ],
678
+ "workflow_diagram": "flowchart TD\n start([\"Start /module-development\"])\n role_1[\"devops-engineer\"]\n role_2[\"team-lead\"]\n step_1[\"1. Design Interface\"]\n step_2[\"2. Implement Module\"]\n step_3[\"3. Write Examples\"]\n step_4[\"4. Test\"]\n step_5[\"5. Code Review\"]\n step_6[\"6. Release\"]\n exit([\"Module published + examples tested + documentation complete = module released.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_2 -. owns .-> step_5\n role_1 -. owns .-> step_6",
669
679
  "examples": {
670
680
  "both": [
671
681
  {
@@ -730,6 +740,7 @@
730
740
  "terraform plan reviewed and approved before apply",
731
741
  "no secrets in plan output"
732
742
  ],
743
+ "workflow_diagram": "flowchart TD\n start([\"Start /provision-environment\"])\n role_1[\"devops-engineer\"]\n role_2[\"team-lead\"]\n step_1[\"1. Plan & Review\"]\n step_2[\"2. Apply Infrastructure\"]\n step_3[\"3. Configure Nodes (Ansible)\"]\n step_4[\"4. Smoke Tests\"]\n step_5[\"5. Document & Store Outputs\"]\n exit([\"Terraform apply clean + Ansible 0 failures + smoke tests pass = environment...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5",
733
744
  "examples": {
734
745
  "both": [
735
746
  {
@@ -805,6 +816,7 @@
805
816
  "control plane HA (3 nodes) before adding workers",
806
817
  "etcd encrypted at rest"
807
818
  ],
819
+ "workflow_diagram": "flowchart TD\n start([\"Start /cluster-bootstrap\"])\n role_1[\"devops-engineer\"]\n step_1[\"1. Node Pre-Flight\"]\n step_2[\"2. Bootstrap First Control Plane\"]\n step_3[\"3. Install CNI (Cilium)\"]\n step_4[\"4. Join Remaining Control Plane Nodes\"]\n step_5[\"5. Join Worker Nodes\"]\n step_6[\"6. etcd Encryption at Rest\"]\n step_7[\"7. Core Platform Components\"]\n step_8[\"8. Apply Security Baselines\"]\n exit([\"All nodes Ready + core components Running + etcd encrypted + monitoring liv...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> step_7\n step_7 --> step_8\n step_8 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5\n role_1 -. owns .-> step_6\n role_1 -. owns .-> step_7\n role_1 -. owns .-> step_8",
808
820
  "examples": {
809
821
  "both": [
810
822
  {
@@ -867,6 +879,7 @@
867
879
  "symptom reproduced before fix applied",
868
880
  "fix verified in target environment"
869
881
  ],
882
+ "workflow_diagram": "flowchart TD\n start([\"Start /debug-workload\"])\n role_1[\"devops-engineer\"]\n role_2[\"developer\"]\n step_1[\"1. Classify Symptom\"]\n step_2[\"2. Deep Diagnosis\"]\n step_3[\"3. Apply Fix\"]\n step_4[\"4. Verify & Monitor\"]\n step_5[\"5. Document\"]\n exit([\"Pod Running + metrics stable + root cause documented = workload debug compl...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_2 -. owns .-> step_3\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5",
870
883
  "examples": {
871
884
  "both": [
872
885
  {
@@ -949,6 +962,7 @@
949
962
  "all manifests pass `kubectl apply --dry-run=server`",
950
963
  "helm lint passes with no warnings"
951
964
  ],
965
+ "workflow_diagram": "flowchart TD\n start([\"Start /onboard-service\"])\n role_1[\"devops-engineer\"]\n role_2[\"developer\"]\n step_1[\"1. Namespace Setup\"]\n step_2[\"2. RBAC Setup\"]\n step_3[\"3. Network Policies\"]\n step_4[\"4. Helm Chart\"]\n step_5[\"5. ArgoCD Application\"]\n step_6[\"6. Validate & Smoke Test\"]\n step_7[\"7. Monitoring\"]\n exit([\"Pod Running + health check passing + ArgoCD Healthy + metrics visible = ser...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> step_7\n step_7 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5\n role_2 -. owns .-> step_6\n role_1 -. owns .-> step_7",
952
966
  "examples": {
953
967
  "both": [
954
968
  {
@@ -1013,6 +1027,7 @@
1013
1027
  "no active P0/P1 incidents",
1014
1028
  "deprecated API audit shows zero blocking deprecations"
1015
1029
  ],
1030
+ "workflow_diagram": "flowchart TD\n start([\"Start /upgrade-cluster\"])\n role_1[\"devops-engineer\"]\n role_2[\"team-lead\"]\n step_1[\"1. etcd Backup\"]\n step_2[\"2. Upgrade Control Plane (kubeadm)\"]\n step_3[\"3. Validate Control Plane\"]\n step_4[\"4. Upgrade Worker Nodes (rolling)\"]\n step_5[\"5. Post-Upgrade Validation\"]\n exit([\"All nodes on target version + Tier 1 services healthy + upgrade report comm...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5\n role_2 -. owns .-> step_5\n step_5 -. iterate if blocked .-> step_1",
1016
1031
  "examples": {
1017
1032
  "both": [
1018
1033
  {
@@ -1080,6 +1095,7 @@
1080
1095
  "TLS certificate issued (not just pending)",
1081
1096
  "HTTPS accessible; HTTP redirects"
1082
1097
  ],
1098
+ "workflow_diagram": "flowchart TD\n start([\"Start /onboard-ingress\"])\n role_1[\"devops-engineer\"]\n step_1[\"1. Write Ingress Manifest\"]\n step_2[\"2. Apply & Wait for Certificate\"]\n step_3[\"3. Verify HTTPS\"]\n step_4[\"4. Verify Rate Limiting\"]\n step_5[\"5. DNS (if needed)\"]\n exit([\"HTTPS accessible + cert issued + security headers present + rate limit veri...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5",
1083
1099
  "examples": {
1084
1100
  "both": [
1085
1101
  {
@@ -1148,6 +1164,7 @@
1148
1164
  "mTLS verified between service and at least one upstream/downstream",
1149
1165
  "no plaintext traffic visible in mesh telemetry"
1150
1166
  ],
1167
+ "workflow_diagram": "flowchart TD\n start([\"Start /service-mesh-onboard\"])\n role_1[\"devops-engineer\"]\n step_1[\"1. Pre-Check Mesh Health\"]\n step_2[\"2. Enable Injection\"]\n step_3[\"3. Verify mTLS\"]\n step_4[\"4. Apply Traffic Policies\"]\n step_5[\"5. Validate in Mesh Dashboard\"]\n exit([\"Sidecar injected + mTLS verified + policies applied + dashboard shows servi...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5",
1151
1168
  "examples": {
1152
1169
  "both": [
1153
1170
  {
@@ -1225,6 +1242,7 @@
1225
1242
  "quality_gates": [
1226
1243
  "root cause identified before alert is silenced"
1227
1244
  ],
1245
+ "workflow_diagram": "flowchart TD\n start([\"Start /alert-investigation\"])\n role_1[\"devops-engineer\"]\n role_2[\"developer\"]\n step_1[\"1. Acknowledge & Classify\"]\n step_2[\"2. Correlate Signals\"]\n step_3[\"3. Identify Root Cause\"]\n step_4[\"4. Mitigate\"]\n step_5[\"5. Post-Investigation Notes\"]\n exit([\"Alert resolved or escalated + root cause noted + runbook quality assessed =...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5",
1228
1246
  "examples": {
1229
1247
  "both": [
1230
1248
  {
@@ -1310,6 +1328,7 @@
1310
1328
  "all components healthy (Prometheus targets UP)",
1311
1329
  "sample alert fires and reaches Alertmanager"
1312
1330
  ],
1331
+ "workflow_diagram": "flowchart TD\n start([\"Start /observability-stack-setup\"])\n role_1[\"devops-engineer\"]\n step_1[\"1. Namespace & Prerequisites\"]\n step_2[\"2. kube-prometheus-stack (Prometheus + Grafana + Alertmanager)\"]\n step_3[\"3. Loki + Promtail (Logs)\"]\n step_4[\"4. Tempo (Traces)\"]\n step_5[\"5. OpenTelemetry Collector (DaemonSet)\"]\n step_6[\"6. Validate Stack\"]\n step_7[\"7. Import Dashboards\"]\n exit([\"All 4 components healthy + test alert fired + dashboards showing data = sta...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> step_7\n step_7 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5\n role_1 -. owns .-> step_6\n role_1 -. owns .-> step_7",
1313
1332
  "examples": {
1314
1333
  "both": [
1315
1334
  {
@@ -1383,6 +1402,7 @@
1383
1402
  "all four golden signals visible in Prometheus",
1384
1403
  "at least one critical alert deployed with runbook"
1385
1404
  ],
1405
+ "workflow_diagram": "flowchart TD\n start([\"Start /onboard-service-monitoring\"])\n role_1[\"developer\"]\n role_2[\"devops-engineer\"]\n step_1[\"1. Metrics Instrumentation\"]\n step_2[\"2. ServiceMonitor\"]\n step_3[\"3. Tracing Instrumentation\"]\n step_4[\"4. Log Labels\"]\n step_5[\"5. Alert Rules\"]\n step_6[\"6. Grafana Dashboard\"]\n exit([\"Golden signals in Prometheus + logs in Loki + traces in Tempo + alerts depl...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_2 -. owns .-> step_5\n role_2 -. owns .-> step_6",
1386
1406
  "examples": {
1387
1407
  "both": [
1388
1408
  {
@@ -1451,6 +1471,7 @@
1451
1471
  "status page updated within 10 min of P0 declaration",
1452
1472
  "mitigation applied before root cause fully known (if available)"
1453
1473
  ],
1474
+ "workflow_diagram": "flowchart TD\n start([\"Start /incident-response\"])\n role_1[\"devops-engineer\"]\n role_2[\"developer\"]\n role_3[\"pm\"]\n role_4[\"devops-engineer (IC)\"]\n role_5[\"developer (technical lead)\"]\n role_6[\"pm (comms)\"]\n step_1[\"T+0–5: Acknowledge & Scope\"]\n step_2[\"T+5–15: Mitigate\"]\n step_3[\"T+10: Communicate\"]\n step_4[\"T+15–30: Stabilize\"]\n step_5[\"T+30: Resolve or Escalate\"]\n step_6[\"T+60: Preliminary Postmortem\"]\n step_7[\"T+24h: Full Postmortem\"]\n exit([\"Service healthy + stakeholders informed + postmortem published = incident c...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> step_7\n step_7 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_1 -. owns .-> step_2\n role_3 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_2 -. owns .-> step_5\n role_4 -. owns .-> step_5\n role_5 -. owns .-> step_5\n role_6 -. owns .-> step_5\n role_2 -. owns .-> step_6\n role_4 -. owns .-> step_6\n role_5 -. owns .-> step_6\n role_6 -. owns .-> step_6\n role_2 -. owns .-> step_7\n role_4 -. owns .-> step_7\n role_5 -. owns .-> step_7\n role_6 -. owns .-> step_7",
1454
1475
  "examples": {
1455
1476
  "both": [
1456
1477
  {
@@ -1520,6 +1541,7 @@
1520
1541
  "postmortem published within 48h of incident resolution",
1521
1542
  "every action item has an owner and a due date"
1522
1543
  ],
1544
+ "workflow_diagram": "flowchart TD\n start([\"Start /postmortem\"])\n role_1[\"devops-engineer\"]\n role_2[\"team-lead\"]\n step_1[\"1. Collect Data (within 2h of resolution)\"]\n step_2[\"2. Draft Postmortem\"]\n step_3[\"3. 5-Whys Facilitation Meeting (within 48h)\"]\n step_4[\"4. Finalize Document\"]\n step_5[\"5. Publish & Track\"]\n step_6[\"6. Follow-Up (2 weeks later)\"]\n exit([\"Postmortem published + all action items in tracker + team notified = postmo...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_1 -. owns .-> step_5\n role_2 -. owns .-> step_5\n role_2 -. owns .-> step_6",
1523
1545
  "examples": {
1524
1546
  "both": [
1525
1547
  {
@@ -1588,6 +1610,7 @@
1588
1610
  "SLO targets grounded in actual reliability data (not aspirational)",
1589
1611
  "every changed SLO has product-owner sign-off"
1590
1612
  ],
1613
+ "workflow_diagram": "flowchart TD\n start([\"Start /slo-review\"])\n role_1[\"devops-engineer\"]\n role_2[\"team-lead\"]\n role_3[\"product-owner\"]\n step_1[\"1. Pull Reliability Data\"]\n step_2[\"2. Classify Services\"]\n step_3[\"3. SLO Adjustment Workshop\"]\n step_4[\"4. Update SLO Definitions\"]\n step_5[\"5. Error Budget Policy Review\"]\n step_6[\"6. Publish SLO Review Report\"]\n exit([\"Report published + SLO changes applied + action items in tracker = review c...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_3\n role_3 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_2 -. owns .-> step_5\n role_3 -. owns .-> step_5\n role_1 -. owns .-> step_6",
1591
1614
  "examples": {
1592
1615
  "both": [
1593
1616
  {
@@ -1662,6 +1685,7 @@
1662
1685
  "forward migration validated on test DB",
1663
1686
  "rollback or mitigation strategy documented"
1664
1687
  ],
1688
+ "workflow_diagram": "flowchart TD\n start([\"Start /add-migration\"])\n role_1[\"team-lead\"]\n role_2[\"developer\"]\n role_3[\"qa\"]\n role_4[\"pm\"]\n step_1[\"1. Risk & Compatibility Analysis\"]\n step_2[\"2. Migration Implementation\"]\n step_3[\"3. Test DB Validation & Data Checks\"]\n step_4[\"4. Review & Remediation Loop\"]\n step_5[\"5. Readiness Report\"]\n exit([\"Validated migration + readiness report + @team-lead approval = ready to dep...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_3 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_2 -. owns .-> step_4\n role_4 -. owns .-> step_5\n role_1 -. owns .-> step_5\n step_5 -. iterate if blocked .-> step_1",
1665
1689
  "examples": {
1666
1690
  "both": [
1667
1691
  {
@@ -1740,6 +1764,7 @@
1740
1764
  "API contract approved before implementation",
1741
1765
  "security checks passed (auth, input validation, rate limiting)"
1742
1766
  ],
1767
+ "workflow_diagram": "flowchart TD\n start([\"Start /create-endpoint\"])\n role_1[\"product-owner\"]\n role_2[\"pm\"]\n role_3[\"team-lead\"]\n role_4[\"developer\"]\n role_5[\"qa\"]\n step_1[\"1. Scope & Contract\"]\n step_2[\"2. Architecture Review\"]\n step_3[\"3. Implementation\"]\n step_4[\"4. Test Design & Execution\"]\n step_5[\"5. Code Review & Sign-off\"]\n step_6[\"6. Fix / Retest Loop\"]\n step_7[\"7. Acceptance\"]\n exit([\"Accepted endpoint + passing tests + @team-lead sign-off = ready to merge.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> step_7\n step_7 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_1\n role_3 -. owns .-> step_2\n role_4 -. owns .-> step_3\n role_5 -. owns .-> step_4\n role_3 -. owns .-> step_5\n role_4 -. owns .-> step_6\n role_5 -. owns .-> step_6\n role_1 -. owns .-> step_7\n role_2 -. owns .-> step_7",
1743
1768
  "examples": {
1744
1769
  "both": [
1745
1770
  {
@@ -1810,6 +1835,7 @@
1810
1835
  "issue reproducible before fix is written",
1811
1836
  "fix verified by automated checks and regression test"
1812
1837
  ],
1838
+ "workflow_diagram": "flowchart TD\n start([\"Start /debug-issue\"])\n role_1[\"pm\"]\n role_2[\"team-lead\"]\n role_3[\"developer\"]\n role_4[\"qa\"]\n step_1[\"1. Triage & Impact Classification\"]\n step_2[\"2. Reproduce & Isolate\"]\n step_3[\"3. Fix Implementation\"]\n step_4[\"4. Verification & Regression Checks\"]\n step_5[\"5. Technical Review & Closure\"]\n exit([\"Merged fix + verified resolution + root cause documented = incident closed.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_1\n role_3 -. owns .-> step_2\n role_3 -. owns .-> step_3\n role_4 -. owns .-> step_4\n role_2 -. owns .-> step_5",
1813
1839
  "examples": {
1814
1840
  "both": [
1815
1841
  {
@@ -1892,6 +1918,7 @@
1892
1918
  "each increment is independently testable and deployable",
1893
1919
  "integration and regression checks pass after each increment"
1894
1920
  ],
1921
+ "workflow_diagram": "flowchart TD\n start([\"Start /develop-epic\"])\n role_1[\"product-owner\"]\n role_2[\"pm\"]\n role_3[\"team-lead\"]\n role_4[\"developer\"]\n role_5[\"qa\"]\n step_1[\"1. Epic Decomposition & Milestone Planning\"]\n step_2[\"2. Architecture Runway Definition\"]\n step_3[\"3. Increment Implementation\"]\n step_4[\"4. Increment Verification\"]\n step_5[\"5. Milestone Review & Replanning\"]\n step_6[\"6. Final Acceptance\"]\n exit([\"All increments accepted by @product-owner + clean regression suite = epic d...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_1\n role_3 -. owns .-> step_2\n role_4 -. owns .-> step_3\n role_5 -. owns .-> step_4\n role_2 -. owns .-> step_5\n role_3 -. owns .-> step_5\n role_1 -. owns .-> step_6\n step_6 -. iterate if blocked .-> step_1",
1895
1922
  "examples": {
1896
1923
  "both": [
1897
1924
  {
@@ -1964,6 +1991,7 @@
1964
1991
  "scope and acceptance criteria approved before implementation",
1965
1992
  "all automated checks pass (lint / test / build)"
1966
1993
  ],
1994
+ "workflow_diagram": "flowchart TD\n start([\"Start /develop-feature\"])\n role_1[\"product-owner\"]\n role_2[\"pm\"]\n role_3[\"team-lead\"]\n role_4[\"designer\"]\n role_5[\"developer\"]\n role_6[\"qa\"]\n step_1[\"1. Requirements & Value Framing\"]\n step_2[\"2. Solution Design & Risk Plan\"]\n step_3[\"3. Implementation\"]\n step_4[\"4. Risk-Based Verification\"]\n step_5[\"5. Code Review & Architecture Sign-off\"]\n step_6[\"6. Fix / Retest Loop\"]\n step_7[\"7. Acceptance & Final Report\"]\n exit([\"@product-owner acceptance + no unresolved blockers = feature complete and r...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> step_7\n step_7 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_1\n role_3 -. owns .-> step_2\n role_4 -. owns .-> step_2\n role_5 -. owns .-> step_3\n role_6 -. owns .-> step_4\n role_3 -. owns .-> step_5\n role_5 -. owns .-> step_6\n role_6 -. owns .-> step_6\n role_2 -. owns .-> step_6\n role_1 -. owns .-> step_7\n role_2 -. owns .-> step_7\n step_7 -. iterate if blocked .-> step_1",
1967
1995
  "examples": {
1968
1996
  "both": [
1969
1997
  {
@@ -2032,6 +2060,7 @@
2032
2060
  "behavior baseline captured before refactor begins",
2033
2061
  "no regressions on critical flows"
2034
2062
  ],
2063
+ "workflow_diagram": "flowchart TD\n start([\"Start /refactor-module\"])\n role_1[\"team-lead\"]\n role_2[\"qa\"]\n role_3[\"developer\"]\n step_1[\"1. Refactor Plan & Boundaries\"]\n step_2[\"2. Baseline Test Coverage\"]\n step_3[\"3. Incremental Refactor Implementation\"]\n step_4[\"4. Regression Validation\"]\n step_5[\"5. Review / Fix Loop\"]\n step_6[\"6. Closure with Parity Report\"]\n exit([\"Merged refactor + behavior parity confirmed + improvement goal achieved = r...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_3 -. owns .-> step_2\n role_3 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_1 -. owns .-> step_5\n role_3 -. owns .-> step_5\n role_2 -. owns .-> step_5\n role_1 -. owns .-> step_6",
2035
2064
  "examples": {
2036
2065
  "both": [
2037
2066
  {
@@ -2100,6 +2129,7 @@
2100
2129
  "critical paths and failure paths covered",
2101
2130
  "all tests stable across 3+ consecutive CI runs"
2102
2131
  ],
2132
+ "workflow_diagram": "flowchart TD\n start([\"Start /test-feature\"])\n role_1[\"qa\"]\n role_2[\"developer\"]\n role_3[\"team-lead\"]\n step_1[\"1. Coverage Gap Analysis\"]\n step_2[\"2. Testability Adjustments\"]\n step_3[\"3. Automated Test Implementation\"]\n step_4[\"4. Review of Scenarios & Assertions\"]\n step_5[\"5. Stability Run & Reporting\"]\n exit([\"Stable test suite + coverage threshold met + @team-lead approval = tests re...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_3\n role_3 -. owns .-> step_4\n role_1 -. owns .-> step_5",
2103
2133
  "examples": {
2104
2134
  "both": [
2105
2135
  {
@@ -2173,6 +2203,7 @@
2173
2203
  "single-partition validated before full run",
2174
2204
  "no duplicates on unique key post-backfill"
2175
2205
  ],
2206
+ "workflow_diagram": "flowchart TD\n start([\"Start /backfill-data\"])\n role_1[\"developer\"]\n role_2[\"qa\"]\n step_1[\"1. Impact Assessment\"]\n step_2[\"2. Dry Run\"]\n step_3[\"3. Execute Backfill\"]\n step_4[\"4. Post-Backfill Validation\"]\n exit([\"Validated backfill + notified consumers + @team-lead sign-off = backfill co...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_4",
2176
2207
  "examples": {
2177
2208
  "both": [
2178
2209
  {
@@ -2242,6 +2273,7 @@
2242
2273
  "affected partitions quarantined before fix",
2243
2274
  "root cause identified and documented"
2244
2275
  ],
2276
+ "workflow_diagram": "flowchart TD\n start([\"Start /data-quality-incident\"])\n role_1[\"qa\"]\n role_2[\"developer\"]\n role_3[\"team-lead\"]\n step_1[\"1. Scope & Triage\"]\n step_2[\"2. Quarantine\"]\n step_3[\"3. Root Cause Isolation\"]\n step_4[\"4. Remediation\"]\n step_5[\"5. Post-Incident\"]\n exit([\"Clean model + postmortem published + prevention measures added = incident c...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_3 -. owns .-> step_5\n role_1 -. owns .-> step_5",
2245
2277
  "examples": {
2246
2278
  "both": [
2247
2279
  {
@@ -2309,6 +2341,7 @@
2309
2341
  "all downstream models and dashboards identified",
2310
2342
  "SLA-critical models in blast radius explicitly flagged"
2311
2343
  ],
2344
+ "workflow_diagram": "flowchart TD\n start([\"Start /lineage-trace\"])\n role_1[\"developer\"]\n role_2[\"team-lead\"]\n step_1[\"1. Parse Target\"]\n step_2[\"2. Trace Lineage\"]\n step_3[\"3. Impact Assessment\"]\n step_4[\"4. Generate Report\"]\n exit([\"Published lineage report + migration checklist = ready to plan the change s...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_2 -. owns .-> step_3\n role_1 -. owns .-> step_4",
2312
2345
  "examples": {
2313
2346
  "both": [
2314
2347
  {
@@ -2386,6 +2419,7 @@
2386
2419
  "dbt compile passes with no errors",
2387
2420
  "standard tests pass (unique/not_null on PK, relationships on FKs)"
2388
2421
  ],
2422
+ "workflow_diagram": "flowchart TD\n start([\"Start /new-model\"])\n role_1[\"pm\"]\n role_2[\"team-lead\"]\n role_3[\"developer\"]\n role_4[\"qa\"]\n step_1[\"1. Requirements Gathering\"]\n step_2[\"2. Model Design\"]\n step_3[\"3. SQL & YAML Implementation\"]\n step_4[\"4. Validation\"]\n step_5[\"5. Review & Merge\"]\n exit([\"Passing dbt tests + complete YAML docs + @team-lead approval = model produc...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_3 -. owns .-> step_3\n role_4 -. owns .-> step_4\n role_2 -. owns .-> step_5",
2389
2423
  "examples": {
2390
2424
  "both": [
2391
2425
  {
@@ -2455,6 +2489,7 @@
2455
2489
  "non-breaking changes confirmed or expand/contract plan approved",
2456
2490
  "all dbt tests pass post-migration"
2457
2491
  ],
2492
+ "workflow_diagram": "flowchart TD\n start([\"Start /schema-migration\"])\n role_1[\"team-lead\"]\n role_2[\"developer\"]\n role_3[\"qa\"]\n step_1[\"1. Change Classification\"]\n step_2[\"2. Impact Assessment\"]\n step_3[\"3. Migration Strategy\"]\n step_4[\"4. Execute Migration\"]\n step_5[\"5. Verify & Document\"]\n exit([\"Post-migration tests green + catalog updated + owners notified = migration...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_3 -. owns .-> step_5",
2458
2493
  "examples": {
2459
2494
  "both": [
2460
2495
  {
@@ -2528,6 +2563,7 @@
2528
2563
  "no blocking WCAG A issues remaining",
2529
2564
  "keyboard and screen-reader critical paths validated"
2530
2565
  ],
2566
+ "workflow_diagram": "flowchart TD\n start([\"Start /a11y-fix\"])\n role_1[\"qa\"]\n role_2[\"designer\"]\n role_3[\"developer\"]\n role_4[\"team-lead\"]\n step_1[\"1. Audit & Severity Classification\"]\n step_2[\"2. UX Decision for Ambiguous Fixes\"]\n step_3[\"3. Implement Fixes\"]\n step_4[\"4. Re-test & Regression Checks\"]\n step_5[\"5. Final Review & Acceptance\"]\n exit([\"Zero WCAG A issues + screen reader path validated + @team-lead approval = a...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_3 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_4 -. owns .-> step_5",
2531
2567
  "examples": {
2532
2568
  "both": [
2533
2569
  {
@@ -2585,6 +2621,7 @@
2585
2621
  "quality_gates": [
2586
2622
  "budget regressions triaged with root cause"
2587
2623
  ],
2624
+ "workflow_diagram": "flowchart TD\n start([\"Start /bundle-analyze\"])\n role_1[\"developer\"]\n role_2[\"qa\"]\n role_3[\"team-lead\"]\n role_4[\"pm\"]\n step_1[\"1. Generate & Compare Bundle Metrics\"]\n step_2[\"2. Validate Measurement Reliability\"]\n step_3[\"3. Prioritize Optimization Candidates\"]\n step_4[\"4. Publish Report & Next Actions\"]\n exit([\"Report published + backlog items created = bundle analysis complete.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_3 -. owns .-> step_3\n role_1 -. owns .-> step_3\n role_4 -. owns .-> step_4",
2588
2625
  "examples": {
2589
2626
  "both": [
2590
2627
  {
@@ -2650,6 +2687,7 @@
2650
2687
  "all automated checks pass (lint / test / build / a11y / bundle)",
2651
2688
  "regression smoke test passes"
2652
2689
  ],
2690
+ "workflow_diagram": "flowchart TD\n start([\"Start /release-prep\"])\n role_1[\"product-owner\"]\n role_2[\"pm\"]\n role_3[\"developer\"]\n role_4[\"qa\"]\n role_5[\"team-lead\"]\n step_1[\"1. Confirm Release Scope & Success Criteria\"]\n step_2[\"2. Execute Build/Lint/Test/Perf Checks\"]\n step_3[\"3. Regression + Smoke Verification\"]\n step_4[\"4. Review Go/No-Go Risks\"]\n step_5[\"5. Publish Release Notes & Decision\"]\n exit([\"Go decision + approved release notes + all checks passed = release ready to...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_1\n role_3 -. owns .-> step_2\n role_4 -. owns .-> step_3\n role_5 -. owns .-> step_4\n role_2 -. owns .-> step_5\n role_1 -. owns .-> step_5",
2653
2691
  "examples": {
2654
2692
  "both": [
2655
2693
  {
@@ -2720,6 +2758,7 @@
2720
2758
  "component API documented (props, events, slots)",
2721
2759
  "all component states implemented (loading, empty, error, success)"
2722
2760
  ],
2761
+ "workflow_diagram": "flowchart TD\n start([\"Start /scaffold-component\"])\n role_1[\"product-owner\"]\n role_2[\"designer\"]\n role_3[\"developer\"]\n role_4[\"qa\"]\n role_5[\"team-lead\"]\n step_1[\"1. Component Intent & Acceptance Criteria\"]\n step_2[\"2. Design System Alignment\"]\n step_3[\"3. Component Implementation\"]\n step_4[\"4. Functional & Accessibility Verification\"]\n step_5[\"5. Code Review & Merge Readiness\"]\n exit([\"Accepted component + passing tests + a11y clear = ready to merge and publis...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_3 -. owns .-> step_3\n role_4 -. owns .-> step_4\n role_5 -. owns .-> step_5",
2723
2762
  "examples": {
2724
2763
  "both": [
2725
2764
  {
@@ -2784,6 +2823,7 @@
2784
2823
  "critical diffs reviewed by designer before baseline update",
2785
2824
  "accepted diffs documented with rationale"
2786
2825
  ],
2826
+ "workflow_diagram": "flowchart TD\n start([\"Start /visual-regression\"])\n role_1[\"developer\"]\n role_2[\"qa\"]\n role_3[\"designer\"]\n role_4[\"team-lead\"]\n step_1[\"1. Determine Visual Test Scope\"]\n step_2[\"2. Run Capture & Comparison Suite\"]\n step_3[\"3. Classify Diffs\"]\n step_4[\"4. Fix or Approve Baseline Updates\"]\n step_5[\"5. Final Gate Decision\"]\n exit([\"Zero unexpected diffs + all baseline updates designer-approved + @team-lead...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_3 -. owns .-> step_3\n role_2 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_3 -. owns .-> step_4\n role_4 -. owns .-> step_5",
2787
2827
  "examples": {
2788
2828
  "both": [
2789
2829
  {
@@ -2863,6 +2903,7 @@
2863
2903
  "plan explicitly approved by user before any code is written",
2864
2904
  "unit tests pass with coverage ≥ 70%"
2865
2905
  ],
2906
+ "workflow_diagram": "flowchart TD\n start([\"Start /backend-project-full-cycle\"])\n role_1[\"team-lead\"]\n role_2[\"pm\"]\n role_3[\"developer\"]\n role_4[\"qa\"]\n step_1[\"1.1 — Define Tech Stack\"]\n step_2[\"1.2 — Requirements Clarification\"]\n step_3[\"1.3 — Architecture Plan\"]\n step_4[\"1.4 — Plan Approval\"]\n step_5[\"2.1 — Backend Logic\"]\n step_6[\"2.2 — Unit Tests & Quality\"]\n step_7[\"2.3 — Code Review\"]\n step_8[\"3.1 — E2E Validation\"]\n step_9[\"3.2 — Results Review & Report\"]\n exit([\"Green E2E tests + @team-lead sign-off + delivery report = production-ready...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> step_7\n step_7 --> step_8\n step_8 --> step_9\n step_9 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_3 -. owns .-> step_5\n role_3 -. owns .-> step_6\n role_4 -. owns .-> step_6\n role_1 -. owns .-> step_7\n role_4 -. owns .-> step_8\n role_1 -. owns .-> step_9\n role_2 -. owns .-> step_9\n step_9 -. iterate if blocked .-> step_1",
2866
2907
  "examples": {
2867
2908
  "both": [
2868
2909
  {
@@ -2935,6 +2976,7 @@
2935
2976
  "regression test fails before fix, passes after",
2936
2977
  "no mypy/ruff errors introduced"
2937
2978
  ],
2979
+ "workflow_diagram": "flowchart TD\n start([\"Start /debug-issue\"])\n role_1[\"backend-dev\"]\n role_2[\"team-lead\"]\n step_1[\"1. Triage\"]\n step_2[\"2. Reproduce\"]\n step_3[\"3. Root Cause Analysis\"]\n step_4[\"4. Fix\"]\n step_5[\"5. Review & Document\"]\n exit([\"Merged fix + regression test + root cause documented in ticket.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_2 -. owns .-> step_5\n step_5 -. iterate if blocked .-> step_1",
2938
2980
  "examples": {
2939
2981
  "both": [
2940
2982
  {
@@ -3010,6 +3052,7 @@
3010
3052
  "no mypy/ruff errors",
3011
3053
  "architecture layer boundaries respected (no cross-layer imports)"
3012
3054
  ],
3055
+ "workflow_diagram": "flowchart TD\n start([\"Start /develop-feature\"])\n role_1[\"team-lead\"]\n role_2[\"backend-dev\"]\n role_3[\"frontend-dev\"]\n role_4[\"qa-engineer\"]\n step_1[\"1. Design\"]\n step_2[\"2. DB Model & Migration\"]\n step_3[\"3. Repository Layer\"]\n step_4[\"4. Service Layer\"]\n step_5[\"5. API Endpoint\"]\n step_6[\"6. Frontend / UI\"]\n step_7[\"7. QA & PR\"]\n exit([\"Merged PR with passing CI. Feature accessible in target environment.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> step_7\n step_7 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_2 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_2 -. owns .-> step_5\n role_3 -. owns .-> step_6\n role_4 -. owns .-> step_7\n role_1 -. owns .-> step_7\n step_7 -. iterate if blocked .-> step_1",
3013
3056
  "examples": {
3014
3057
  "both": [
3015
3058
  {
@@ -3076,6 +3119,7 @@
3076
3119
  "layered architecture rules respected (no business logic in API layer)",
3077
3120
  "unit and integration tests pass"
3078
3121
  ],
3122
+ "workflow_diagram": "flowchart TD\n start([\"Start /feature-implementation-flow\"])\n role_1[\"pm\"]\n role_2[\"team-lead\"]\n role_3[\"designer\"]\n role_4[\"developer\"]\n role_5[\"qa\"]\n step_1[\"1. Requirement Analysis & Models\"]\n step_2[\"2. Design & Planning\"]\n step_3[\"3. Implementation — Inner to Outer\"]\n step_4[\"4. Verification\"]\n step_5[\"5. Review\"]\n step_6[\"6. Fix / Retest Loop\"]\n exit([\"@team-lead approval + passing checks = feature ready to merge.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_3 -. owns .-> step_2\n role_4 -. owns .-> step_3\n role_4 -. owns .-> step_4\n role_5 -. owns .-> step_4\n role_2 -. owns .-> step_5\n role_4 -. owns .-> step_6\n role_5 -. owns .-> step_6",
3079
3123
  "examples": {
3080
3124
  "both": [
3081
3125
  {
@@ -3139,6 +3183,7 @@
3139
3183
  "lint and format clean",
3140
3184
  "all tests in selected scope pass"
3141
3185
  ],
3186
+ "workflow_diagram": "flowchart TD\n start([\"Start /testing-ci-pipeline\"])\n role_1[\"developer\"]\n role_2[\"qa\"]\n role_3[\"team-lead\"]\n step_1[\"1. Code Quality Check\"]\n step_2[\"2. Unit Tests\"]\n step_3[\"3. Build / Prepare\"]\n step_4[\"4. E2E / Integration Tests\"]\n step_5[\"5. Results Review & Report\"]\n exit([\"All steps green + test_report.md produced = pipeline passed.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_3 -. owns .-> step_5\n role_2 -. owns .-> step_5",
3142
3187
  "examples": {
3143
3188
  "both": [
3144
3189
  {
@@ -3208,6 +3253,7 @@
3208
3253
  "CI pipeline passes before manual review begins",
3209
3254
  "all blocking comments resolved before approval"
3210
3255
  ],
3256
+ "workflow_diagram": "flowchart TD\n start([\"Start /code-review-workflow\"])\n role_1[\"developer\"]\n role_2[\"team-lead\"]\n role_3[\"qa\"]\n step_1[\"1. Automated Pre-check\"]\n step_2[\"2. Context Understanding\"]\n step_3[\"3. Code Review\"]\n step_4[\"4. Feedback Resolution\"]\n step_5[\"5. Approval & Merge\"]\n exit([\"Approved and merged PR = review complete.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_2 -. owns .-> step_3\n role_3 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_2 -. owns .-> step_5\n step_5 -. iterate if blocked .-> step_1",
3211
3257
  "examples": {
3212
3258
  "both": [
3213
3259
  {
@@ -3276,6 +3322,7 @@
3276
3322
  "acceptance criteria confirmed before implementation starts",
3277
3323
  "all checks pass (lint / test / build)"
3278
3324
  ],
3325
+ "workflow_diagram": "flowchart TD\n start([\"Start /development-cycle-workflow\"])\n role_1[\"product-owner\"]\n role_2[\"pm\"]\n role_3[\"team-lead\"]\n role_4[\"developer\"]\n role_5[\"qa\"]\n step_1[\"1. Requirements Framing\"]\n step_2[\"2. Technical Design\"]\n step_3[\"3. Implementation\"]\n step_4[\"4. Verification\"]\n step_5[\"5. Pull Request\"]\n step_6[\"6. Review & Merge\"]\n exit([\"Merged PR + acceptance criteria validated in staging = task complete.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_1\n role_3 -. owns .-> step_2\n role_4 -. owns .-> step_3\n role_4 -. owns .-> step_4\n role_5 -. owns .-> step_4\n role_4 -. owns .-> step_5\n role_3 -. owns .-> step_6\n role_2 -. owns .-> step_6\n step_6 -. iterate if blocked .-> step_1",
3279
3326
  "examples": {
3280
3327
  "both": [
3281
3328
  {
@@ -3345,6 +3392,7 @@
3345
3392
  "CI pipeline passes on first commit",
3346
3393
  "make install && make dev works on a clean machine"
3347
3394
  ],
3395
+ "workflow_diagram": "flowchart TD\n start([\"Start /project-setup-workflow\"])\n role_1[\"product-owner\"]\n role_2[\"pm\"]\n role_3[\"team-lead\"]\n role_4[\"developer\"]\n role_5[\"qa\"]\n step_1[\"1. Scope & Decisions\"]\n step_2[\"2. Repository Setup\"]\n step_3[\"3. Development Environment\"]\n step_4[\"4. Code Quality Tooling\"]\n step_5[\"5. CI Pipeline\"]\n step_6[\"6. First Commit & Validation\"]\n exit([\"Green CI + QA sign-off = project is ready for first feature development.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_1\n role_3 -. owns .-> step_2\n role_4 -. owns .-> step_2\n role_4 -. owns .-> step_3\n role_4 -. owns .-> step_4\n role_4 -. owns .-> step_5\n role_3 -. owns .-> step_5\n role_4 -. owns .-> step_6\n role_5 -. owns .-> step_6",
3348
3396
  "examples": {
3349
3397
  "both": [
3350
3398
  {
@@ -3420,6 +3468,7 @@
3420
3468
  "sample size calculated before experiment starts",
3421
3469
  "guardrail metrics monitored daily with auto-rollback"
3422
3470
  ],
3471
+ "workflow_diagram": "flowchart TD\n start([\"Start /champion-challenger\"])\n role_1[\"developer\"]\n role_2[\"qa\"]\n role_3[\"team-lead\"]\n step_1[\"1. Experiment Design\"]\n step_2[\"2. Configure Traffic Split\"]\n step_3[\"3. Run & Monitor\"]\n step_4[\"4. Analyze Results\"]\n step_5[\"5. Promotion Decision\"]\n exit([\"Decision recorded in registry + winner at 100% traffic + report published =...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_2 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_3 -. owns .-> step_5",
3423
3472
  "examples": {
3424
3473
  "both": [
3425
3474
  {
@@ -3483,6 +3532,7 @@
3483
3532
  "PROMOTE recommendation confirmed in model registry",
3484
3533
  "canary passes latency and error rate SLOs"
3485
3534
  ],
3535
+ "workflow_diagram": "flowchart TD\n start([\"Start /deploy-endpoint\"])\n role_1[\"team-lead\"]\n role_2[\"developer\"]\n role_3[\"qa\"]\n step_1[\"1. Pre-flight\"]\n step_2[\"2. Shadow Deployment\"]\n step_3[\"3. Canary Rollout\"]\n step_4[\"4. Promote Champion\"]\n step_5[\"5. Post-Deploy Monitoring\"]\n exit([\"100% traffic on new champion + stable monitoring + deployment report = endp...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_2 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_3 -. owns .-> step_5\n step_5 -. iterate if blocked .-> step_1",
3486
3536
  "examples": {
3487
3537
  "both": [
3488
3538
  {
@@ -3545,6 +3595,7 @@
3545
3595
  "test set was not used during any training iteration",
3546
3596
  "fairness disparity checked for people-affecting models"
3547
3597
  ],
3598
+ "workflow_diagram": "flowchart TD\n start([\"Start /evaluate-model\"])\n role_1[\"qa\"]\n role_2[\"team-lead\"]\n step_1[\"1. Load Model & Test Data\"]\n step_2[\"2. Compute Core Metrics\"]\n step_3[\"3. Business Impact Translation\"]\n step_4[\"4. Fairness Analysis\"]\n step_5[\"5. Champion Comparison\"]\n exit([\"Signed scorecard + promotion recommendation = evaluation complete; feed int...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_2 -. owns .-> step_5",
3548
3599
  "examples": {
3549
3600
  "both": [
3550
3601
  {
@@ -3608,6 +3659,7 @@
3608
3659
  "rollback executed within 5 minutes for critical incidents",
3609
3660
  "affected prediction window scoped and logged"
3610
3661
  ],
3662
+ "workflow_diagram": "flowchart TD\n start([\"Start /model-incident\"])\n role_1[\"team-lead\"]\n role_2[\"qa\"]\n role_3[\"developer\"]\n step_1[\"1. Immediate Response\"]\n step_2[\"2. Diagnose\"]\n step_3[\"3. Scope Affected Predictions\"]\n step_4[\"4. Root Cause & Remediation\"]\n step_5[\"5. Post-Incident\"]\n exit([\"System restored + postmortem published + monitoring improved = incident clo...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_3 -. owns .-> step_3\n role_3 -. owns .-> step_4\n role_1 -. owns .-> step_5",
3611
3663
  "examples": {
3612
3664
  "both": [
3613
3665
  {
@@ -3669,6 +3721,7 @@
3669
3721
  "environment fully snapshotted before training starts",
3670
3722
  "training loss decreased monotonically"
3671
3723
  ],
3724
+ "workflow_diagram": "flowchart TD\n start([\"Start /train-experiment\"])\n role_1[\"developer\"]\n role_2[\"qa\"]\n step_1[\"1. Prerequisites Validation\"]\n step_2[\"2. Environment Snapshot\"]\n step_3[\"3. Training Run\"]\n step_4[\"4. Validation\"]\n exit([\"Logged artifact + evaluation scorecard + champion comparison = experiment c...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_4",
3672
3725
  "examples": {
3673
3726
  "both": [
3674
3727
  {
@@ -3736,6 +3789,7 @@
3736
3789
  "crash reproduced before fix is written",
3737
3790
  "fix verified on physical device"
3738
3791
  ],
3792
+ "workflow_diagram": "flowchart TD\n start([\"Start /crash-triage\"])\n role_1[\"developer\"]\n role_2[\"qa\"]\n step_1[\"1. Gather & Symbolicate\"]\n step_2[\"2. Reproduce\"]\n step_3[\"3. Root Cause\"]\n step_4[\"4. Fix & Regression Test\"]\n step_5[\"5. Verification\"]\n exit([\"Device-verified fix + passing regression test + crash-free rate restored =...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_2 -. owns .-> step_5",
3739
3793
  "examples": {
3740
3794
  "both": [
3741
3795
  {
@@ -3791,6 +3845,7 @@
3791
3845
  "quality_gates": [
3792
3846
  "device matrix covers latest 2 OS versions per platform"
3793
3847
  ],
3848
+ "workflow_diagram": "flowchart TD\n start([\"Start /device-testing\"])\n role_1[\"qa\"]\n role_2[\"developer\"]\n role_3[\"team-lead\"]\n step_1[\"1. Select Device Matrix\"]\n step_2[\"2. Upload Build\"]\n step_3[\"3. Execute Test Suite\"]\n step_4[\"4. Analyze Results\"]\n exit([\"Device matrix report + explicit go/no-go = device testing complete.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_3 -. owns .-> step_4",
3794
3849
  "examples": {
3795
3850
  "both": [
3796
3851
  {
@@ -3846,6 +3901,7 @@
3846
3901
  "quality_gates": [
3847
3902
  "OTA eligibility confirmed (JS-only, no native modules changed)"
3848
3903
  ],
3904
+ "workflow_diagram": "flowchart TD\n start([\"Start /ota-update\"])\n role_1[\"developer\"]\n role_2[\"qa\"]\n step_1[\"1. Validate OTA Eligibility\"]\n step_2[\"2. Build Bundle\"]\n step_3[\"3. Staged Rollout\"]\n step_4[\"4. Monitor Adoption\"]\n exit([\"100% adoption + stable error rate = OTA update complete.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_4",
3849
3905
  "examples": {
3850
3906
  "both": [
3851
3907
  {
@@ -3910,6 +3966,7 @@
3910
3966
  "no debug flags or dev endpoints in release build",
3911
3967
  "Detox smoke tests pass on physical device"
3912
3968
  ],
3969
+ "workflow_diagram": "flowchart TD\n start([\"Start /release-build\"])\n role_1[\"developer\"]\n role_2[\"qa\"]\n role_3[\"team-lead\"]\n step_1[\"1. Version Validation\"]\n step_2[\"2. Environment Check\"]\n step_3[\"3. Build\"]\n step_4[\"4. Validate Build\"]\n step_5[\"5. Upload & Report\"]\n exit([\"Signed artifact uploaded + smoke tests passed + @team-lead approval = relea...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_1 -. owns .-> step_5\n role_3 -. owns .-> step_5",
3913
3970
  "examples": {
3914
3971
  "both": [
3915
3972
  {
@@ -3972,6 +4029,7 @@
3972
4029
  "crash-free rate ≥ 99.5% in pre-release track",
3973
4030
  "privacy labels match actual data collection"
3974
4031
  ],
4032
+ "workflow_diagram": "flowchart TD\n start([\"Start /store-submission\"])\n role_1[\"qa\"]\n role_2[\"developer\"]\n role_3[\"team-lead\"]\n step_1[\"1. Validate Build\"]\n step_2[\"2. Prepare Metadata\"]\n step_3[\"3. Compliance Check\"]\n step_4[\"4. Submit\"]\n step_5[\"5. Monitor Post-Release\"]\n exit([\"Submission live + stable 48h monitoring = release complete.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_3 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_1 -. owns .-> step_5",
3975
4033
  "examples": {
3976
4034
  "both": [
3977
4035
  {
@@ -4037,6 +4095,7 @@
4037
4095
  "quality_gates": [
4038
4096
  "all waste categories checked (EBS, EC2, ELB, S3, RDS)"
4039
4097
  ],
4098
+ "workflow_diagram": "flowchart TD\n start([\"Start /cost-audit\"])\n role_1[\"qa\"]\n role_2[\"team-lead\"]\n step_1[\"1. Fetch Billing Data\"]\n step_2[\"2. Analyze Spend Patterns\"]\n step_3[\"3. Detect Waste\"]\n step_4[\"4. Generate Recommendations\"]\n step_5[\"5. Report\"]\n exit([\"Published report + owners assigned for top recommendations = audit complete.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_2 -. owns .-> step_5",
4040
4099
  "examples": {
4041
4100
  "both": [
4042
4101
  {
@@ -4106,6 +4165,7 @@
4106
4165
  "no active P0/P1 incidents before deploy starts",
4107
4166
  "canary passes error rate and latency SLOs"
4108
4167
  ],
4168
+ "workflow_diagram": "flowchart TD\n start([\"Start /deploy-production\"])\n role_1[\"team-lead\"]\n role_2[\"developer\"]\n role_3[\"qa\"]\n role_4[\"pm\"]\n step_1[\"1. Pre-flight\"]\n step_2[\"2. Canary (10% traffic)\"]\n step_3[\"3. Progressive Rollout\"]\n step_4[\"4. Post-Deploy Validation\"]\n step_5[\"5. Complete\"]\n exit([\"Green smoke tests + stable metrics + deployment report = release complete.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_2 -. owns .-> step_3\n role_3 -. owns .-> step_4\n role_4 -. owns .-> step_5",
4109
4169
  "examples": {
4110
4170
  "both": [
4111
4171
  {
@@ -4168,6 +4228,7 @@
4168
4228
  "quality_gates": [
4169
4229
  "Category D drift (unexpected destroy) pages on-call immediately"
4170
4230
  ],
4231
+ "workflow_diagram": "flowchart TD\n start([\"Start /drift-check\"])\n role_1[\"qa\"]\n role_2[\"team-lead\"]\n role_3[\"developer\"]\n step_1[\"1. Fetch Live State\"]\n step_2[\"2. Compute Diff\"]\n step_3[\"3. Classify Drift\"]\n step_4[\"4. Report\"]\n step_5[\"5. Remediate\"]\n exit([\"Drift report published + Category A resolved (if --fix) + B/C/D tracked = d...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_2 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_3 -. owns .-> step_5",
4171
4232
  "examples": {
4172
4233
  "both": [
4173
4234
  {
@@ -4236,6 +4297,7 @@
4236
4297
  "incident channel created within 5 minutes of P0/P1 alert",
4237
4298
  "mitigation attempted per runbook before ad-hoc debugging"
4238
4299
  ],
4300
+ "workflow_diagram": "flowchart TD\n start([\"Start /incident-response\"])\n role_1[\"team-lead\"]\n role_2[\"developer\"]\n role_3[\"pm\"]\n step_1[\"1. Triage\"]\n step_2[\"2. Establish Incident Channel\"]\n step_3[\"3. Generate Hypothesis List\"]\n step_4[\"4. Execute Mitigation\"]\n step_5[\"5. Draft Postmortem\"]\n step_6[\"6. Communicate Resolution\"]\n exit([\"Services healthy + postmortem scheduled + stakeholders notified = incident...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_1 -. owns .-> step_5\n role_3 -. owns .-> step_6",
4239
4301
  "examples": {
4240
4302
  "both": [
4241
4303
  {
@@ -4310,6 +4372,7 @@
4310
4372
  "no unexpected destroy operations in plan for non-preview envs",
4311
4373
  "cost delta within budget before apply"
4312
4374
  ],
4375
+ "workflow_diagram": "flowchart TD\n start([\"Start /provision-env\"])\n role_1[\"team-lead\"]\n role_2[\"developer\"]\n role_3[\"qa\"]\n role_4[\"pm\"]\n step_1[\"1. Validate Prerequisites\"]\n step_2[\"2. Plan Infrastructure\"]\n step_3[\"3. Estimate Cost\"]\n step_4[\"4. Apply Infrastructure\"]\n step_5[\"5. Configure DNS & Ingress\"]\n step_6[\"6. Seed & Smoke Test\"]\n step_7[\"7. Report\"]\n exit([\"Smoke tests green + URL published = environment ready for use.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> step_7\n step_7 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_2 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_2 -. owns .-> step_5\n role_3 -. owns .-> step_6\n role_4 -. owns .-> step_7",
4313
4376
  "examples": {
4314
4377
  "both": [
4315
4378
  {
@@ -4383,6 +4446,7 @@
4383
4446
  "root cause identified (not just test quarantined)",
4384
4447
  "stabilization confirmed by 5+ consecutive green CI runs"
4385
4448
  ],
4449
+ "workflow_diagram": "flowchart TD\n start([\"Start /flakiness-investigation\"])\n role_1[\"qa\"]\n role_2[\"developer\"]\n role_3[\"team-lead\"]\n step_1[\"1. Collect Failure Signals & Patterns\"]\n step_2[\"2. Reproduce & Classify Root Cause\"]\n step_3[\"3. Stabilization Fix\"]\n step_4[\"4. Stress Re-run & Quarantine Decision\"]\n step_5[\"5. Policy Review & Closure\"]\n exit([\"Stable test in CI + root cause documented + log updated = investigation clo...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_2 -. owns .-> step_2\n role_2 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_3 -. owns .-> step_5",
4386
4450
  "examples": {
4387
4451
  "both": [
4388
4452
  {
@@ -4447,6 +4511,7 @@
4447
4511
  "SLO regressions explicitly identified vs. baseline",
4448
4512
  "bottleneck root cause identified (not just symptom)"
4449
4513
  ],
4514
+ "workflow_diagram": "flowchart TD\n start([\"Start /performance-audit\"])\n role_1[\"qa\"]\n role_2[\"developer\"]\n role_3[\"team-lead\"]\n role_4[\"pm\"]\n step_1[\"1. Scenario Definition & Baseline Alignment\"]\n step_2[\"2. Load/Stress Execution & Monitoring Capture\"]\n step_3[\"3. Bottleneck Analysis & Fix Proposal\"]\n step_4[\"4. Prioritization & Delivery Planning\"]\n exit([\"Published report + prioritized remediation plan + backlog items created = a...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_2 -. owns .-> step_3\n role_1 -. owns .-> step_3\n role_3 -. owns .-> step_4\n role_4 -. owns .-> step_4",
4450
4515
  "examples": {
4451
4516
  "both": [
4452
4517
  {
@@ -4515,6 +4580,7 @@
4515
4580
  "no unresolved critical failures in selected scope",
4516
4581
  "flaky test handling policy applied (quarantine, not suppress)"
4517
4582
  ],
4583
+ "workflow_diagram": "flowchart TD\n start([\"Start /regression-suite\"])\n role_1[\"qa\"]\n role_2[\"developer\"]\n role_3[\"team-lead\"]\n step_1[\"1. Scope Selection & Environment Readiness\"]\n step_2[\"2. Suite Execution & Evidence Capture\"]\n step_3[\"3. Failure Triage & Fixes\"]\n step_4[\"4. Risk Review & Release Recommendation\"]\n exit([\"Go recommendation + regression report = release confidence confirmed.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_2 -. owns .-> step_3\n role_1 -. owns .-> step_3\n role_3 -. owns .-> step_4\n role_1 -. owns .-> step_4",
4518
4584
  "examples": {
4519
4585
  "both": [
4520
4586
  {
@@ -4578,6 +4644,7 @@
4578
4644
  "quality_gates": [
4579
4645
  "critical path checks complete within 15 minutes of deployment"
4580
4646
  ],
4647
+ "workflow_diagram": "flowchart TD\n start([\"Start /smoke-test\"])\n role_1[\"qa\"]\n role_2[\"developer\"]\n role_3[\"team-lead\"]\n role_4[\"pm\"]\n step_1[\"1. Prepare Environment & Test Data\"]\n step_2[\"2. Run Critical Smoke Scenarios\"]\n step_3[\"3. Defect Triage & Fix\"]\n step_4[\"4. Operational Risk Assessment\"]\n step_5[\"5. Communicate Go/No-Go\"]\n exit([\"Go status + summary published = deployment validated. No-go + rollback trig...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_2 -. owns .-> step_3\n role_3 -. owns .-> step_4\n role_4 -. owns .-> step_5\n role_1 -. owns .-> step_5",
4581
4648
  "examples": {
4582
4649
  "both": [
4583
4650
  {
@@ -4640,6 +4707,7 @@
4640
4707
  "critical business paths meet coverage threshold",
4641
4708
  "top uncovered risks have assigned owners"
4642
4709
  ],
4710
+ "workflow_diagram": "flowchart TD\n start([\"Start /test-coverage-report\"])\n role_1[\"qa\"]\n role_2[\"team-lead\"]\n role_3[\"developer\"]\n step_1[\"1. Collect & Compare Metrics\"]\n step_2[\"2. Identify High-Risk Gaps\"]\n step_3[\"3. Implement Targeted Tests & Fixes\"]\n step_4[\"4. Publish Trend & Action Plan\"]\n exit([\"Critical paths at threshold + trend published + gaps assigned = coverage cy...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_2 -. owns .-> step_2\n role_3 -. owns .-> step_3\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4",
4643
4711
  "examples": {
4644
4712
  "both": [
4645
4713
  {
@@ -4707,6 +4775,7 @@
4707
4775
  "all controls evaluated (Compliant / Partial / Non-Compliant / N/A)",
4708
4776
  "remediation plan exists for all Non-Compliant controls"
4709
4777
  ],
4778
+ "workflow_diagram": "flowchart TD\n start([\"Start /compliance-report\"])\n role_1[\"team-lead\"]\n role_2[\"developer\"]\n role_3[\"qa\"]\n step_1[\"1. Map Controls\"]\n step_2[\"2. Collect Evidence\"]\n step_3[\"3. Evaluate Compliance\"]\n step_4[\"4. Generate Report\"]\n exit([\"Complete control matrix + gap analysis + human review flag = report ready f...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_3 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_1 -. owns .-> step_4",
4710
4779
  "examples": {
4711
4780
  "both": [
4712
4781
  {
@@ -4775,6 +4844,7 @@
4775
4844
  "target confirmed as staging (never production)",
4776
4845
  "all OWASP Top-10 categories evaluated"
4777
4846
  ],
4847
+ "workflow_diagram": "flowchart TD\n start([\"Start /pen-test-sim\"])\n role_1[\"team-lead\"]\n role_2[\"qa\"]\n step_1[\"1. Scope Confirmation\"]\n step_2[\"2. Passive Recon\"]\n step_3[\"3. Active Scanning\"]\n step_4[\"4. Manual Checks\"]\n step_5[\"5. Report\"]\n exit([\"Published report + Critical/High findings assigned = pen-test complete.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_2 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_1 -. owns .-> step_5",
4778
4848
  "examples": {
4779
4849
  "both": [
4780
4850
  {
@@ -4837,6 +4907,7 @@
4837
4907
  "old credential revoked only after zero auth errors confirmed",
4838
4908
  "audit log entry created with rotation metadata"
4839
4909
  ],
4910
+ "workflow_diagram": "flowchart TD\n start([\"Start /secret-rotation\"])\n role_1[\"developer\"]\n role_2[\"team-lead\"]\n step_1[\"1. Prepare New Secret\"]\n step_2[\"2. Dual-Read Window\"]\n step_3[\"3. Deploy New Secret\"]\n step_4[\"4. Validate\"]\n step_5[\"5. Revoke Old Secret\"]\n step_6[\"6. Document\"]\n exit([\"Old secret revoked + audit record updated = rotation complete.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> step_6\n step_6 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_2 -. owns .-> step_4\n role_1 -. owns .-> step_5\n role_1 -. owns .-> step_6",
4840
4911
  "examples": {
4841
4912
  "both": [
4842
4913
  {
@@ -4906,6 +4977,7 @@
4906
4977
  "no critical findings unaddressed before merge",
4907
4978
  "high findings have 72-hour SLA assigned"
4908
4979
  ],
4980
+ "workflow_diagram": "flowchart TD\n start([\"Start /security-scan\"])\n role_1[\"developer\"]\n role_2[\"qa\"]\n role_3[\"team-lead\"]\n step_1[\"1. SAST Scan\"]\n step_2[\"2. Dependency Audit\"]\n step_3[\"3. Secret Scanning\"]\n step_4[\"4. Infrastructure Scan\"]\n step_5[\"5. Synthesize & Report\"]\n exit([\"No unaddressed Critical findings + report saved = scan complete.\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_1 -. owns .-> step_2\n role_2 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_3 -. owns .-> step_5",
4909
4981
  "examples": {
4910
4982
  "both": [
4911
4983
  {
@@ -4967,6 +5039,7 @@
4967
5039
  "all trust boundary crossings evaluated for all 6 STRIDE categories",
4968
5040
  "required mitigations mapped to controls before implementation"
4969
5041
  ],
5042
+ "workflow_diagram": "flowchart TD\n start([\"Start /threat-model-review\"])\n role_1[\"team-lead\"]\n role_2[\"developer\"]\n role_3[\"qa\"]\n step_1[\"1. Parse Feature\"]\n step_2[\"2. Data Flow Diagram\"]\n step_3[\"3. STRIDE Analysis\"]\n step_4[\"4. Prioritize\"]\n step_5[\"5. Generate Mitigations\"]\n exit([\"Published threat model + Required mitigations assigned = secure implementat...\"])\n start --> step_1\n step_1 --> step_2\n step_2 --> step_3\n step_3 --> step_4\n step_4 --> step_5\n step_5 --> exit\n role_1 -. owns .-> step_1\n role_2 -. owns .-> step_2\n role_1 -. owns .-> step_3\n role_3 -. owns .-> step_3\n role_1 -. owns .-> step_4\n role_2 -. owns .-> step_5",
4970
5043
  "examples": {
4971
5044
  "both": [
4972
5045
  {