@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.
- package/AGENTS.md +8 -0
- package/CHANGELOG.md +18 -0
- package/Makefile +26 -5
- package/README.md +25 -6
- package/agentic +801 -66
- package/areas/devops/ci-cd/workflows/onboard-repo.md +29 -0
- package/areas/devops/ci-cd/workflows/pipeline-debug.md +26 -0
- package/areas/devops/ci-cd/workflows/release-pipeline.md +53 -0
- package/areas/devops/database-ops/workflows/backup-verify.md +27 -0
- package/areas/devops/database-ops/workflows/db-incident.md +30 -0
- package/areas/devops/devsecops/workflows/policy-onboard.md +34 -0
- package/areas/devops/devsecops/workflows/security-scan-pipeline.md +33 -0
- package/areas/devops/infrastructure/workflows/destroy-environment.md +31 -0
- package/areas/devops/infrastructure/workflows/drift-remediation.md +29 -0
- package/areas/devops/infrastructure/workflows/module-development.md +32 -0
- package/areas/devops/infrastructure/workflows/provision-environment.md +29 -0
- package/areas/devops/kubernetes/workflows/cluster-bootstrap.md +36 -0
- package/areas/devops/kubernetes/workflows/debug-workload.md +29 -0
- package/areas/devops/kubernetes/workflows/onboard-service.md +35 -0
- package/areas/devops/kubernetes/workflows/upgrade-cluster.md +30 -0
- package/areas/devops/networking/workflows/onboard-ingress.md +27 -0
- package/areas/devops/networking/workflows/service-mesh-onboard.md +27 -0
- package/areas/devops/observability/workflows/alert-investigation.md +29 -0
- package/areas/devops/observability/workflows/observability-stack-setup.md +33 -0
- package/areas/devops/observability/workflows/onboard-service-monitoring.md +31 -0
- package/areas/devops/sre/workflows/incident-response.md +48 -0
- package/areas/devops/sre/workflows/postmortem.md +32 -0
- package/areas/devops/sre/workflows/slo-review.md +35 -1
- package/areas/software/backend/workflows/add-migration.md +33 -0
- package/areas/software/backend/workflows/create-endpoint.md +40 -0
- package/areas/software/backend/workflows/debug-issue.md +31 -0
- package/areas/software/backend/workflows/develop-epic.md +37 -0
- package/areas/software/backend/workflows/develop-feature.md +44 -0
- package/areas/software/backend/workflows/refactor-module.md +35 -0
- package/areas/software/backend/workflows/test-feature.md +30 -0
- package/areas/software/data-engineering/workflows/backfill-data.md +25 -0
- package/areas/software/data-engineering/workflows/data-quality-incident.md +31 -0
- package/areas/software/data-engineering/workflows/lineage-trace.md +25 -0
- package/areas/software/data-engineering/workflows/new-model.md +30 -0
- package/areas/software/data-engineering/workflows/schema-migration.md +29 -0
- package/areas/software/frontend/workflows/a11y-fix.md +30 -0
- package/areas/software/frontend/workflows/bundle-analyze.md +28 -0
- package/areas/software/frontend/workflows/release-prep.md +33 -0
- package/areas/software/frontend/workflows/scaffold-component.md +32 -0
- package/areas/software/frontend/workflows/visual-regression.md +32 -0
- package/areas/software/full-stack/workflows/backend-project-full-cycle.md +47 -2
- package/areas/software/full-stack/workflows/debug-issue.md +29 -0
- package/areas/software/full-stack/workflows/develop-feature.md +38 -0
- package/areas/software/full-stack/workflows/feature-implementation-flow.md +38 -0
- package/areas/software/full-stack/workflows/testing-ci-pipeline.md +30 -0
- package/areas/software/general/workflows/code-review-workflow.md +31 -0
- package/areas/software/general/workflows/development-cycle-workflow.md +38 -0
- package/areas/software/general/workflows/project-setup-workflow.md +38 -0
- package/areas/software/mlops/workflows/champion-challenger.md +29 -0
- package/areas/software/mlops/workflows/deploy-endpoint.md +30 -0
- package/areas/software/mlops/workflows/evaluate-model.md +28 -0
- package/areas/software/mlops/workflows/model-incident.md +29 -0
- package/areas/software/mlops/workflows/train-experiment.md +25 -0
- package/areas/software/mobile/workflows/crash-triage.md +28 -0
- package/areas/software/mobile/workflows/device-testing.md +27 -0
- package/areas/software/mobile/workflows/ota-update.md +25 -0
- package/areas/software/mobile/workflows/release-build.md +30 -0
- package/areas/software/mobile/workflows/store-submission.md +29 -0
- package/areas/software/platform/workflows/cost-audit.md +28 -0
- package/areas/software/platform/workflows/deploy-production.md +30 -0
- package/areas/software/platform/workflows/drift-check.md +29 -0
- package/areas/software/platform/workflows/incident-response.md +33 -0
- package/areas/software/platform/workflows/provision-env.md +36 -0
- package/areas/software/qa/workflows/flakiness-investigation.md +30 -0
- package/areas/software/qa/workflows/performance-audit.md +29 -0
- package/areas/software/qa/workflows/regression-suite.md +28 -0
- package/areas/software/qa/workflows/smoke-test.md +31 -0
- package/areas/software/qa/workflows/test-coverage-report.md +28 -0
- package/areas/software/security/workflows/compliance-report.md +27 -0
- package/areas/software/security/workflows/pen-test-sim.md +28 -0
- package/areas/software/security/workflows/secret-rotation.md +33 -2
- package/areas/software/security/workflows/security-scan.md +29 -0
- package/areas/software/security/workflows/threat-model-review.md +30 -0
- package/docs/agentic-usage.md +19 -2
- package/docs/catalog.schema.json +5 -1
- package/docs/mcp/README.md +28 -0
- package/docs/opencode_setup.md +21 -1
- package/docs/site/README.md +15 -1
- package/docs/site/app.js +68 -0
- package/docs/site/catalog.json +74 -1
- package/docs/site/index.html +5 -1
- package/docs/site/styles.css +52 -4
- package/extensions/opencode/opencode.json +0 -1
- package/extensions/opencode/profiles/githubcopilot/opencode.json +87 -0
- package/extensions/opencode/profiles/openai/opencode.json +100 -0
- package/package.json +1 -1
- package/scripts/build_docs_catalog.py +13 -1
- package/scripts/sync_workflow_diagrams.py +199 -0
- 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-
|
|
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.
|