@jetrabbits/agentic 0.3.3 → 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 (94) hide show
  1. package/AGENTS.md +8 -0
  2. package/CHANGELOG.md +18 -0
  3. package/Makefile +26 -5
  4. package/README.md +25 -6
  5. package/agentic +801 -66
  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 +19 -2
  80. package/docs/catalog.schema.json +5 -1
  81. package/docs/mcp/README.md +28 -0
  82. package/docs/opencode_setup.md +21 -1
  83. package/docs/site/README.md +15 -1
  84. package/docs/site/app.js +68 -0
  85. package/docs/site/catalog.json +74 -1
  86. package/docs/site/index.html +5 -1
  87. package/docs/site/styles.css +52 -4
  88. package/extensions/opencode/opencode.json +0 -1
  89. package/extensions/opencode/profiles/githubcopilot/opencode.json +87 -0
  90. package/extensions/opencode/profiles/openai/opencode.json +100 -0
  91. package/package.json +1 -1
  92. package/scripts/build_docs_catalog.py +13 -1
  93. package/scripts/sync_workflow_diagrams.py +199 -0
  94. package/extensions/opencode/plugins/sound-notification.ts +0 -13
@@ -59,5 +59,35 @@ quality-gates:
59
59
  - **Output:** `@team-lead` approval
60
60
  - **Done when:** approved; CI a11y checks added or confirmed
61
61
 
62
+ ## Agent Interaction Diagram
63
+
64
+ <!-- agent-diagram:start -->
65
+ ```mermaid
66
+ flowchart TD
67
+ start(["Start /a11y-fix"])
68
+ role_1["qa"]
69
+ role_2["designer"]
70
+ role_3["developer"]
71
+ role_4["team-lead"]
72
+ step_1["1. Audit & Severity Classification"]
73
+ step_2["2. UX Decision for Ambiguous Fixes"]
74
+ step_3["3. Implement Fixes"]
75
+ step_4["4. Re-test & Regression Checks"]
76
+ step_5["5. Final Review & Acceptance"]
77
+ exit(["Zero WCAG A issues + screen reader path validated + @team-lead approval = a..."])
78
+ start --> step_1
79
+ step_1 --> step_2
80
+ step_2 --> step_3
81
+ step_3 --> step_4
82
+ step_4 --> step_5
83
+ step_5 --> exit
84
+ role_1 -. owns .-> step_1
85
+ role_2 -. owns .-> step_2
86
+ role_3 -. owns .-> step_3
87
+ role_1 -. owns .-> step_4
88
+ role_4 -. owns .-> step_5
89
+ ```
90
+ <!-- agent-diagram:end -->
91
+
62
92
  ## Exit
63
93
  Zero WCAG A issues + screen reader path validated + `@team-lead` approval = a11y fix complete.
@@ -52,5 +52,33 @@ quality-gates:
52
52
  - **Output:** `bundle_diff_report.md`; backlog items created
53
53
  - **Done when:** report shared; items logged in project tracker
54
54
 
55
+ ## Agent Interaction Diagram
56
+
57
+ <!-- agent-diagram:start -->
58
+ ```mermaid
59
+ flowchart TD
60
+ start(["Start /bundle-analyze"])
61
+ role_1["developer"]
62
+ role_2["qa"]
63
+ role_3["team-lead"]
64
+ role_4["pm"]
65
+ step_1["1. Generate & Compare Bundle Metrics"]
66
+ step_2["2. Validate Measurement Reliability"]
67
+ step_3["3. Prioritize Optimization Candidates"]
68
+ step_4["4. Publish Report & Next Actions"]
69
+ exit(["Report published + backlog items created = bundle analysis complete."])
70
+ start --> step_1
71
+ step_1 --> step_2
72
+ step_2 --> step_3
73
+ step_3 --> step_4
74
+ step_4 --> exit
75
+ role_1 -. owns .-> step_1
76
+ role_2 -. owns .-> step_2
77
+ role_3 -. owns .-> step_3
78
+ role_1 -. owns .-> step_3
79
+ role_4 -. owns .-> step_4
80
+ ```
81
+ <!-- agent-diagram:end -->
82
+
55
83
  ## Exit
56
84
  Report published + backlog items created = bundle analysis complete.
@@ -62,5 +62,38 @@ quality-gates:
62
62
  - **Output:** approved release notes; team informed
63
63
  - **Done when:** notes approved; deployment team has green light
64
64
 
65
+ ## Agent Interaction Diagram
66
+
67
+ <!-- agent-diagram:start -->
68
+ ```mermaid
69
+ flowchart TD
70
+ start(["Start /release-prep"])
71
+ role_1["product-owner"]
72
+ role_2["pm"]
73
+ role_3["developer"]
74
+ role_4["qa"]
75
+ role_5["team-lead"]
76
+ step_1["1. Confirm Release Scope & Success Criteria"]
77
+ step_2["2. Execute Build/Lint/Test/Perf Checks"]
78
+ step_3["3. Regression + Smoke Verification"]
79
+ step_4["4. Review Go/No-Go Risks"]
80
+ step_5["5. Publish Release Notes & Decision"]
81
+ exit(["Go decision + approved release notes + all checks passed = release ready to..."])
82
+ start --> step_1
83
+ step_1 --> step_2
84
+ step_2 --> step_3
85
+ step_3 --> step_4
86
+ step_4 --> step_5
87
+ step_5 --> exit
88
+ role_1 -. owns .-> step_1
89
+ role_2 -. owns .-> step_1
90
+ role_3 -. owns .-> step_2
91
+ role_4 -. owns .-> step_3
92
+ role_5 -. owns .-> step_4
93
+ role_2 -. owns .-> step_5
94
+ role_1 -. owns .-> step_5
95
+ ```
96
+ <!-- agent-diagram:end -->
97
+
65
98
  ## Exit
66
99
  Go decision + approved release notes + all checks passed = release ready to deploy.
@@ -63,5 +63,37 @@ quality-gates:
63
63
  - **Output:** review feedback
64
64
  - **Done when:** all blocking feedback resolved; `@team-lead` approves
65
65
 
66
+ ## Agent Interaction Diagram
67
+
68
+ <!-- agent-diagram:start -->
69
+ ```mermaid
70
+ flowchart TD
71
+ start(["Start /scaffold-component"])
72
+ role_1["product-owner"]
73
+ role_2["designer"]
74
+ role_3["developer"]
75
+ role_4["qa"]
76
+ role_5["team-lead"]
77
+ step_1["1. Component Intent & Acceptance Criteria"]
78
+ step_2["2. Design System Alignment"]
79
+ step_3["3. Component Implementation"]
80
+ step_4["4. Functional & Accessibility Verification"]
81
+ step_5["5. Code Review & Merge Readiness"]
82
+ exit(["Accepted component + passing tests + a11y clear = ready to merge and publis..."])
83
+ start --> step_1
84
+ step_1 --> step_2
85
+ step_2 --> step_3
86
+ step_3 --> step_4
87
+ step_4 --> step_5
88
+ step_5 --> exit
89
+ role_1 -. owns .-> step_1
90
+ role_2 -. owns .-> step_1
91
+ role_2 -. owns .-> step_2
92
+ role_3 -. owns .-> step_3
93
+ role_4 -. owns .-> step_4
94
+ role_5 -. owns .-> step_5
95
+ ```
96
+ <!-- agent-diagram:end -->
97
+
66
98
  ## Exit
67
99
  Accepted component + passing tests + a11y clear = ready to merge and publish to design system.
@@ -61,5 +61,37 @@ quality-gates:
61
61
  - **Output:** merge approval
62
62
  - **Done when:** all diffs resolved; no unreviewed changes
63
63
 
64
+ ## Agent Interaction Diagram
65
+
66
+ <!-- agent-diagram:start -->
67
+ ```mermaid
68
+ flowchart TD
69
+ start(["Start /visual-regression"])
70
+ role_1["developer"]
71
+ role_2["qa"]
72
+ role_3["designer"]
73
+ role_4["team-lead"]
74
+ step_1["1. Determine Visual Test Scope"]
75
+ step_2["2. Run Capture & Comparison Suite"]
76
+ step_3["3. Classify Diffs"]
77
+ step_4["4. Fix or Approve Baseline Updates"]
78
+ step_5["5. Final Gate Decision"]
79
+ exit(["Zero unexpected diffs + all baseline updates designer-approved + @team-lead..."])
80
+ start --> step_1
81
+ step_1 --> step_2
82
+ step_2 --> step_3
83
+ step_3 --> step_4
84
+ step_4 --> step_5
85
+ step_5 --> exit
86
+ role_1 -. owns .-> step_1
87
+ role_2 -. owns .-> step_2
88
+ role_3 -. owns .-> step_3
89
+ role_2 -. owns .-> step_3
90
+ role_1 -. owns .-> step_4
91
+ role_3 -. owns .-> step_4
92
+ role_4 -. owns .-> step_5
93
+ ```
94
+ <!-- agent-diagram:end -->
95
+
64
96
  ## Exit
65
97
  Zero unexpected diffs + all baseline updates designer-approved + `@team-lead` sign-off = visual review complete.
@@ -18,13 +18,12 @@ roles:
18
18
  execution:
19
19
  initiator: team-lead
20
20
  related-rules:
21
- - project-setup-guide.md
21
+ - project-guide.md
22
22
  - backend-architecture-rule.md
23
23
  - code-quality-guide.md
24
24
  - env-settings-guide.md
25
25
  - testing-ci-guide.md
26
26
  - e2e-test-guide.md
27
- - ci-cd-deployment-guide.md
28
27
  uses-skills:
29
28
  - prompt-project-planner
30
29
  - app-builder
@@ -125,6 +124,52 @@ quality-gates:
125
124
  - **Output:** `artifacts/delivery_report_<task_id>.md` — plan vs. delivered, test evidence, known gaps
126
125
  - **Done when:** `@team-lead` signs off; report complete
127
126
 
127
+ ## Agent Interaction Diagram
128
+
129
+ <!-- agent-diagram:start -->
130
+ ```mermaid
131
+ flowchart TD
132
+ start(["Start /backend-project-full-cycle"])
133
+ role_1["team-lead"]
134
+ role_2["pm"]
135
+ role_3["developer"]
136
+ role_4["qa"]
137
+ step_1["1.1 — Define Tech Stack"]
138
+ step_2["1.2 — Requirements Clarification"]
139
+ step_3["1.3 — Architecture Plan"]
140
+ step_4["1.4 — Plan Approval"]
141
+ step_5["2.1 — Backend Logic"]
142
+ step_6["2.2 — Unit Tests & Quality"]
143
+ step_7["2.3 — Code Review"]
144
+ step_8["3.1 — E2E Validation"]
145
+ step_9["3.2 — Results Review & Report"]
146
+ exit(["Green E2E tests + @team-lead sign-off + delivery report = production-ready..."])
147
+ start --> step_1
148
+ step_1 --> step_2
149
+ step_2 --> step_3
150
+ step_3 --> step_4
151
+ step_4 --> step_5
152
+ step_5 --> step_6
153
+ step_6 --> step_7
154
+ step_7 --> step_8
155
+ step_8 --> step_9
156
+ step_9 --> exit
157
+ role_1 -. owns .-> step_1
158
+ role_2 -. owns .-> step_2
159
+ role_1 -. owns .-> step_2
160
+ role_1 -. owns .-> step_3
161
+ role_2 -. owns .-> step_4
162
+ role_3 -. owns .-> step_5
163
+ role_3 -. owns .-> step_6
164
+ role_4 -. owns .-> step_6
165
+ role_1 -. owns .-> step_7
166
+ role_4 -. owns .-> step_8
167
+ role_1 -. owns .-> step_9
168
+ role_2 -. owns .-> step_9
169
+ step_9 -. iterate if blocked .-> step_1
170
+ ```
171
+ <!-- agent-diagram:end -->
172
+
128
173
  ## Iteration Loop
129
174
  Phase 2 Steps 2.1–2.3 repeat until `@team-lead` approves. Phase 3 failure loops back to Phase 2 for fixes.
130
175
 
@@ -63,6 +63,35 @@ quality-gates:
63
63
  - **Output:** approved PR; root cause documented
64
64
  - **Done when:** PR merged; postmortem note added for P1/P2 issues
65
65
 
66
+ ## Agent Interaction Diagram
67
+
68
+ <!-- agent-diagram:start -->
69
+ ```mermaid
70
+ flowchart TD
71
+ start(["Start /debug-issue"])
72
+ role_1["backend-dev"]
73
+ role_2["team-lead"]
74
+ step_1["1. Triage"]
75
+ step_2["2. Reproduce"]
76
+ step_3["3. Root Cause Analysis"]
77
+ step_4["4. Fix"]
78
+ step_5["5. Review & Document"]
79
+ exit(["Merged fix + regression test + root cause documented in ticket."])
80
+ start --> step_1
81
+ step_1 --> step_2
82
+ step_2 --> step_3
83
+ step_3 --> step_4
84
+ step_4 --> step_5
85
+ step_5 --> exit
86
+ role_1 -. owns .-> step_1
87
+ role_1 -. owns .-> step_2
88
+ role_1 -. owns .-> step_3
89
+ role_1 -. owns .-> step_4
90
+ role_2 -. owns .-> step_5
91
+ step_5 -. iterate if blocked .-> step_1
92
+ ```
93
+ <!-- agent-diagram:end -->
94
+
66
95
  ## Iteration Loop
67
96
  If fix reveals deeper root cause → return to Step 3 with updated understanding.
68
97
 
@@ -78,6 +78,44 @@ quality-gates:
78
78
  - **Output:** passing CI + PR ready for review
79
79
  - **Done when:** `make test` green; `make lint` clean; PR submitted
80
80
 
81
+ ## Agent Interaction Diagram
82
+
83
+ <!-- agent-diagram:start -->
84
+ ```mermaid
85
+ flowchart TD
86
+ start(["Start /develop-feature"])
87
+ role_1["team-lead"]
88
+ role_2["backend-dev"]
89
+ role_3["frontend-dev"]
90
+ role_4["qa-engineer"]
91
+ step_1["1. Design"]
92
+ step_2["2. DB Model & Migration"]
93
+ step_3["3. Repository Layer"]
94
+ step_4["4. Service Layer"]
95
+ step_5["5. API Endpoint"]
96
+ step_6["6. Frontend / UI"]
97
+ step_7["7. QA & PR"]
98
+ exit(["Merged PR with passing CI. Feature accessible in target environment."])
99
+ start --> step_1
100
+ step_1 --> step_2
101
+ step_2 --> step_3
102
+ step_3 --> step_4
103
+ step_4 --> step_5
104
+ step_5 --> step_6
105
+ step_6 --> step_7
106
+ step_7 --> exit
107
+ role_1 -. owns .-> step_1
108
+ role_2 -. owns .-> step_2
109
+ role_2 -. owns .-> step_3
110
+ role_2 -. owns .-> step_4
111
+ role_2 -. owns .-> step_5
112
+ role_3 -. owns .-> step_6
113
+ role_4 -. owns .-> step_7
114
+ role_1 -. owns .-> step_7
115
+ step_7 -. iterate if blocked .-> step_1
116
+ ```
117
+ <!-- agent-diagram:end -->
118
+
81
119
  ## Iteration Loop
82
120
  If review finds issues → return to relevant step (Step 2 for schema issues, Step 4 for logic issues, Step 5 for API issues).
83
121
 
@@ -74,5 +74,43 @@ quality-gates:
74
74
  - **Actions:** fix; re-run checks; re-request review
75
75
  - **Done when:** zero blocking issues; all checks green
76
76
 
77
+ ## Agent Interaction Diagram
78
+
79
+ <!-- agent-diagram:start -->
80
+ ```mermaid
81
+ flowchart TD
82
+ start(["Start /feature-implementation-flow"])
83
+ role_1["pm"]
84
+ role_2["team-lead"]
85
+ role_3["designer"]
86
+ role_4["developer"]
87
+ role_5["qa"]
88
+ step_1["1. Requirement Analysis & Models"]
89
+ step_2["2. Design & Planning"]
90
+ step_3["3. Implementation — Inner to Outer"]
91
+ step_4["4. Verification"]
92
+ step_5["5. Review"]
93
+ step_6["6. Fix / Retest Loop"]
94
+ exit(["@team-lead approval + passing checks = feature ready to merge."])
95
+ start --> step_1
96
+ step_1 --> step_2
97
+ step_2 --> step_3
98
+ step_3 --> step_4
99
+ step_4 --> step_5
100
+ step_5 --> step_6
101
+ step_6 --> exit
102
+ role_1 -. owns .-> step_1
103
+ role_2 -. owns .-> step_1
104
+ role_2 -. owns .-> step_2
105
+ role_3 -. owns .-> step_2
106
+ role_4 -. owns .-> step_3
107
+ role_4 -. owns .-> step_4
108
+ role_5 -. owns .-> step_4
109
+ role_2 -. owns .-> step_5
110
+ role_4 -. owns .-> step_6
111
+ role_5 -. owns .-> step_6
112
+ ```
113
+ <!-- agent-diagram:end -->
114
+
77
115
  ## Exit
78
116
  `@team-lead` approval + passing checks = feature ready to merge.
@@ -61,5 +61,35 @@ quality-gates:
61
61
  ## Failure Policy
62
62
  If any step fails: pipeline halts. Fix the violation before proceeding. Do not skip or suppress failures.
63
63
 
64
+ ## Agent Interaction Diagram
65
+
66
+ <!-- agent-diagram:start -->
67
+ ```mermaid
68
+ flowchart TD
69
+ start(["Start /testing-ci-pipeline"])
70
+ role_1["developer"]
71
+ role_2["qa"]
72
+ role_3["team-lead"]
73
+ step_1["1. Code Quality Check"]
74
+ step_2["2. Unit Tests"]
75
+ step_3["3. Build / Prepare"]
76
+ step_4["4. E2E / Integration Tests"]
77
+ step_5["5. Results Review & Report"]
78
+ exit(["All steps green + test_report.md produced = pipeline passed."])
79
+ start --> step_1
80
+ step_1 --> step_2
81
+ step_2 --> step_3
82
+ step_3 --> step_4
83
+ step_4 --> step_5
84
+ step_5 --> exit
85
+ role_1 -. owns .-> step_1
86
+ role_1 -. owns .-> step_2
87
+ role_1 -. owns .-> step_3
88
+ role_2 -. owns .-> step_4
89
+ role_3 -. owns .-> step_5
90
+ role_2 -. owns .-> step_5
91
+ ```
92
+ <!-- agent-diagram:end -->
93
+
64
94
  ## Exit
65
95
  All steps green + `test_report.md` produced = pipeline passed.
@@ -77,6 +77,37 @@ quality-gates:
77
77
  - **Output:** merged PR; branch deleted
78
78
  - **Done when:** change merged and feature branch removed
79
79
 
80
+ ## Agent Interaction Diagram
81
+
82
+ <!-- agent-diagram:start -->
83
+ ```mermaid
84
+ flowchart TD
85
+ start(["Start /code-review-workflow"])
86
+ role_1["developer"]
87
+ role_2["team-lead"]
88
+ role_3["qa"]
89
+ step_1["1. Automated Pre-check"]
90
+ step_2["2. Context Understanding"]
91
+ step_3["3. Code Review"]
92
+ step_4["4. Feedback Resolution"]
93
+ step_5["5. Approval & Merge"]
94
+ exit(["Approved and merged PR = review complete."])
95
+ start --> step_1
96
+ step_1 --> step_2
97
+ step_2 --> step_3
98
+ step_3 --> step_4
99
+ step_4 --> step_5
100
+ step_5 --> exit
101
+ role_1 -. owns .-> step_1
102
+ role_2 -. owns .-> step_2
103
+ role_2 -. owns .-> step_3
104
+ role_3 -. owns .-> step_3
105
+ role_1 -. owns .-> step_4
106
+ role_2 -. owns .-> step_5
107
+ step_5 -. iterate if blocked .-> step_1
108
+ ```
109
+ <!-- agent-diagram:end -->
110
+
80
111
  ## Iteration Loop
81
112
  If fixes introduce new issues → reviewer re-raises blocking comments; loop repeats until clean.
82
113
 
@@ -78,6 +78,44 @@ quality-gates:
78
78
  - **Output:** merged PR; feature branch deleted
79
79
  - **Done when:** PR is merged and change is verified in staging/preview
80
80
 
81
+ ## Agent Interaction Diagram
82
+
83
+ <!-- agent-diagram:start -->
84
+ ```mermaid
85
+ flowchart TD
86
+ start(["Start /development-cycle-workflow"])
87
+ role_1["product-owner"]
88
+ role_2["pm"]
89
+ role_3["team-lead"]
90
+ role_4["developer"]
91
+ role_5["qa"]
92
+ step_1["1. Requirements Framing"]
93
+ step_2["2. Technical Design"]
94
+ step_3["3. Implementation"]
95
+ step_4["4. Verification"]
96
+ step_5["5. Pull Request"]
97
+ step_6["6. Review & Merge"]
98
+ exit(["Merged PR + acceptance criteria validated in staging = task complete."])
99
+ start --> step_1
100
+ step_1 --> step_2
101
+ step_2 --> step_3
102
+ step_3 --> step_4
103
+ step_4 --> step_5
104
+ step_5 --> step_6
105
+ step_6 --> exit
106
+ role_1 -. owns .-> step_1
107
+ role_2 -. owns .-> step_1
108
+ role_3 -. owns .-> step_2
109
+ role_4 -. owns .-> step_3
110
+ role_4 -. owns .-> step_4
111
+ role_5 -. owns .-> step_4
112
+ role_4 -. owns .-> step_5
113
+ role_3 -. owns .-> step_6
114
+ role_2 -. owns .-> step_6
115
+ step_6 -. iterate if blocked .-> step_1
116
+ ```
117
+ <!-- agent-diagram:end -->
118
+
81
119
  ## Iteration Loop
82
120
  If verification (Step 4) or review (Step 6) reveals gaps → return to Step 3. `@pm` tracks blockers and timeline.
83
121
 
@@ -90,5 +90,43 @@ quality-gates:
90
90
  - **Output:** green CI on first commit; validated by QA
91
91
  - **Done when:** CI green, QA confirms setup is reproducible
92
92
 
93
+ ## Agent Interaction Diagram
94
+
95
+ <!-- agent-diagram:start -->
96
+ ```mermaid
97
+ flowchart TD
98
+ start(["Start /project-setup-workflow"])
99
+ role_1["product-owner"]
100
+ role_2["pm"]
101
+ role_3["team-lead"]
102
+ role_4["developer"]
103
+ role_5["qa"]
104
+ step_1["1. Scope & Decisions"]
105
+ step_2["2. Repository Setup"]
106
+ step_3["3. Development Environment"]
107
+ step_4["4. Code Quality Tooling"]
108
+ step_5["5. CI Pipeline"]
109
+ step_6["6. First Commit & Validation"]
110
+ exit(["Green CI + QA sign-off = project is ready for first feature development."])
111
+ start --> step_1
112
+ step_1 --> step_2
113
+ step_2 --> step_3
114
+ step_3 --> step_4
115
+ step_4 --> step_5
116
+ step_5 --> step_6
117
+ step_6 --> exit
118
+ role_1 -. owns .-> step_1
119
+ role_2 -. owns .-> step_1
120
+ role_3 -. owns .-> step_2
121
+ role_4 -. owns .-> step_2
122
+ role_4 -. owns .-> step_3
123
+ role_4 -. owns .-> step_4
124
+ role_4 -. owns .-> step_5
125
+ role_3 -. owns .-> step_5
126
+ role_4 -. owns .-> step_6
127
+ role_5 -. owns .-> step_6
128
+ ```
129
+ <!-- agent-diagram:end -->
130
+
93
131
  ## Exit
94
132
  Green CI + QA sign-off = project is ready for first feature development.
@@ -61,5 +61,34 @@ quality-gates:
61
61
  - **Output:** experiment report in registry; traffic routed to winner
62
62
  - **Done when:** winner in production; loser archived; report complete
63
63
 
64
+ ## Agent Interaction Diagram
65
+
66
+ <!-- agent-diagram:start -->
67
+ ```mermaid
68
+ flowchart TD
69
+ start(["Start /champion-challenger"])
70
+ role_1["developer"]
71
+ role_2["qa"]
72
+ role_3["team-lead"]
73
+ step_1["1. Experiment Design"]
74
+ step_2["2. Configure Traffic Split"]
75
+ step_3["3. Run & Monitor"]
76
+ step_4["4. Analyze Results"]
77
+ step_5["5. Promotion Decision"]
78
+ exit(["Decision recorded in registry + winner at 100% traffic + report published =..."])
79
+ start --> step_1
80
+ step_1 --> step_2
81
+ step_2 --> step_3
82
+ step_3 --> step_4
83
+ step_4 --> step_5
84
+ step_5 --> exit
85
+ role_1 -. owns .-> step_1
86
+ role_1 -. owns .-> step_2
87
+ role_2 -. owns .-> step_3
88
+ role_2 -. owns .-> step_4
89
+ role_3 -. owns .-> step_5
90
+ ```
91
+ <!-- agent-diagram:end -->
92
+
64
93
  ## Exit
65
94
  Decision recorded in registry + winner at 100% traffic + report published = experiment closed.
@@ -63,6 +63,36 @@ quality-gates:
63
63
  - **Output:** `deployment_report.md` — timeline, traffic split results, new baselines
64
64
  - **Done when:** stable 24 hours; report complete
65
65
 
66
+ ## Agent Interaction Diagram
67
+
68
+ <!-- agent-diagram:start -->
69
+ ```mermaid
70
+ flowchart TD
71
+ start(["Start /deploy-endpoint"])
72
+ role_1["team-lead"]
73
+ role_2["developer"]
74
+ role_3["qa"]
75
+ step_1["1. Pre-flight"]
76
+ step_2["2. Shadow Deployment"]
77
+ step_3["3. Canary Rollout"]
78
+ step_4["4. Promote Champion"]
79
+ step_5["5. Post-Deploy Monitoring"]
80
+ exit(["100% traffic on new champion + stable monitoring + deployment report = endp..."])
81
+ start --> step_1
82
+ step_1 --> step_2
83
+ step_2 --> step_3
84
+ step_3 --> step_4
85
+ step_4 --> step_5
86
+ step_5 --> exit
87
+ role_1 -. owns .-> step_1
88
+ role_2 -. owns .-> step_2
89
+ role_2 -. owns .-> step_3
90
+ role_2 -. owns .-> step_4
91
+ role_3 -. owns .-> step_5
92
+ step_5 -. iterate if blocked .-> step_1
93
+ ```
94
+ <!-- agent-diagram:end -->
95
+
66
96
  ## Iteration Loop
67
97
  Auto-rollback on SLO breach returns to Step 2 (shadow) or Step 1 (full re-review).
68
98
 
@@ -59,5 +59,33 @@ quality-gates:
59
59
  - **Output:** `evaluation_scorecard.json` with recommendation; visualizations (confusion matrix, ROC, feature importance)
60
60
  - **Done when:** recommendation recorded in model registry
61
61
 
62
+ ## Agent Interaction Diagram
63
+
64
+ <!-- agent-diagram:start -->
65
+ ```mermaid
66
+ flowchart TD
67
+ start(["Start /evaluate-model"])
68
+ role_1["qa"]
69
+ role_2["team-lead"]
70
+ step_1["1. Load Model & Test Data"]
71
+ step_2["2. Compute Core Metrics"]
72
+ step_3["3. Business Impact Translation"]
73
+ step_4["4. Fairness Analysis"]
74
+ step_5["5. Champion Comparison"]
75
+ exit(["Signed scorecard + promotion recommendation = evaluation complete; feed int..."])
76
+ start --> step_1
77
+ step_1 --> step_2
78
+ step_2 --> step_3
79
+ step_3 --> step_4
80
+ step_4 --> step_5
81
+ step_5 --> exit
82
+ role_1 -. owns .-> step_1
83
+ role_1 -. owns .-> step_2
84
+ role_1 -. owns .-> step_3
85
+ role_1 -. owns .-> step_4
86
+ role_2 -. owns .-> step_5
87
+ ```
88
+ <!-- agent-diagram:end -->
89
+
62
90
  ## Exit
63
91
  Signed scorecard + promotion recommendation = evaluation complete; feed into `/deploy-endpoint` or `/champion-challenger`.
@@ -60,5 +60,34 @@ quality-gates:
60
60
  - **Output:** postmortem at `.mlops/incidents/<date>-<model>-incident.md`; monitoring updated; model card updated
61
61
  - **Done when:** postmortem reviewed; prevention measures in place
62
62
 
63
+ ## Agent Interaction Diagram
64
+
65
+ <!-- agent-diagram:start -->
66
+ ```mermaid
67
+ flowchart TD
68
+ start(["Start /model-incident"])
69
+ role_1["team-lead"]
70
+ role_2["qa"]
71
+ role_3["developer"]
72
+ step_1["1. Immediate Response"]
73
+ step_2["2. Diagnose"]
74
+ step_3["3. Scope Affected Predictions"]
75
+ step_4["4. Root Cause & Remediation"]
76
+ step_5["5. Post-Incident"]
77
+ exit(["System restored + postmortem published + monitoring improved = incident clo..."])
78
+ start --> step_1
79
+ step_1 --> step_2
80
+ step_2 --> step_3
81
+ step_3 --> step_4
82
+ step_4 --> step_5
83
+ step_5 --> exit
84
+ role_1 -. owns .-> step_1
85
+ role_2 -. owns .-> step_2
86
+ role_3 -. owns .-> step_3
87
+ role_3 -. owns .-> step_4
88
+ role_1 -. owns .-> step_5
89
+ ```
90
+ <!-- agent-diagram:end -->
91
+
63
92
  ## Exit
64
93
  System restored + postmortem published + monitoring improved = incident closed.