@jetrabbits/agentic 0.4.0 → 0.5.0

package/areas/software/full-stack/workflows/testing-ci-pipeline.md

@@ -61,5 +61,35 @@ quality-gates:
 ## Failure Policy
 If any step fails: pipeline halts. Fix the violation before proceeding. Do not skip or suppress failures.
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /testing-ci-pipeline"])
+  role_1["developer"]
+  role_2["qa"]
+  role_3["team-lead"]
+  step_1["1. Code Quality Check"]
+  step_2["2. Unit Tests"]
+  step_3["3. Build / Prepare"]
+  step_4["4. E2E / Integration Tests"]
+  step_5["5. Results Review & Report"]
+  exit(["All steps green + test_report.md produced = pipeline passed."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_1 -. owns .-> step_3
+  role_2 -. owns .-> step_4
+  role_3 -. owns .-> step_5
+  role_2 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 All steps green + `test_report.md` produced = pipeline passed.

package/areas/software/general/workflows/code-review-workflow.md

@@ -77,6 +77,37 @@ quality-gates:
 - **Output:** merged PR; branch deleted
 - **Done when:** change merged and feature branch removed
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /code-review-workflow"])
+  role_1["developer"]
+  role_2["team-lead"]
+  role_3["qa"]
+  step_1["1. Automated Pre-check"]
+  step_2["2. Context Understanding"]
+  step_3["3. Code Review"]
+  step_4["4. Feedback Resolution"]
+  step_5["5. Approval & Merge"]
+  exit(["Approved and merged PR = review complete."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_2 -. owns .-> step_2
+  role_2 -. owns .-> step_3
+  role_3 -. owns .-> step_3
+  role_1 -. owns .-> step_4
+  role_2 -. owns .-> step_5
+  step_5 -. iterate if blocked .-> step_1
+```
+<!-- agent-diagram:end -->
+
 ## Iteration Loop
 If fixes introduce new issues → reviewer re-raises blocking comments; loop repeats until clean.
 

package/areas/software/general/workflows/development-cycle-workflow.md

@@ -78,6 +78,44 @@ quality-gates:
 - **Output:** merged PR; feature branch deleted
 - **Done when:** PR is merged and change is verified in staging/preview
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /development-cycle-workflow"])
+  role_1["product-owner"]
+  role_2["pm"]
+  role_3["team-lead"]
+  role_4["developer"]
+  role_5["qa"]
+  step_1["1. Requirements Framing"]
+  step_2["2. Technical Design"]
+  step_3["3. Implementation"]
+  step_4["4. Verification"]
+  step_5["5. Pull Request"]
+  step_6["6. Review & Merge"]
+  exit(["Merged PR + acceptance criteria validated in staging = task complete."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> step_6
+  step_6 --> exit
+  role_1 -. owns .-> step_1
+  role_2 -. owns .-> step_1
+  role_3 -. owns .-> step_2
+  role_4 -. owns .-> step_3
+  role_4 -. owns .-> step_4
+  role_5 -. owns .-> step_4
+  role_4 -. owns .-> step_5
+  role_3 -. owns .-> step_6
+  role_2 -. owns .-> step_6
+  step_6 -. iterate if blocked .-> step_1
+```
+<!-- agent-diagram:end -->
+
 ## Iteration Loop
 If verification (Step 4) or review (Step 6) reveals gaps → return to Step 3. `@pm` tracks blockers and timeline.
 

package/areas/software/general/workflows/project-setup-workflow.md

@@ -90,5 +90,43 @@ quality-gates:
 - **Output:** green CI on first commit; validated by QA
 - **Done when:** CI green, QA confirms setup is reproducible
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /project-setup-workflow"])
+  role_1["product-owner"]
+  role_2["pm"]
+  role_3["team-lead"]
+  role_4["developer"]
+  role_5["qa"]
+  step_1["1. Scope & Decisions"]
+  step_2["2. Repository Setup"]
+  step_3["3. Development Environment"]
+  step_4["4. Code Quality Tooling"]
+  step_5["5. CI Pipeline"]
+  step_6["6. First Commit & Validation"]
+  exit(["Green CI + QA sign-off = project is ready for first feature development."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> step_6
+  step_6 --> exit
+  role_1 -. owns .-> step_1
+  role_2 -. owns .-> step_1
+  role_3 -. owns .-> step_2
+  role_4 -. owns .-> step_2
+  role_4 -. owns .-> step_3
+  role_4 -. owns .-> step_4
+  role_4 -. owns .-> step_5
+  role_3 -. owns .-> step_5
+  role_4 -. owns .-> step_6
+  role_5 -. owns .-> step_6
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Green CI + QA sign-off = project is ready for first feature development.

package/areas/software/mlops/workflows/champion-challenger.md

@@ -61,5 +61,34 @@ quality-gates:
 - **Output:** experiment report in registry; traffic routed to winner
 - **Done when:** winner in production; loser archived; report complete
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /champion-challenger"])
+  role_1["developer"]
+  role_2["qa"]
+  role_3["team-lead"]
+  step_1["1. Experiment Design"]
+  step_2["2. Configure Traffic Split"]
+  step_3["3. Run & Monitor"]
+  step_4["4. Analyze Results"]
+  step_5["5. Promotion Decision"]
+  exit(["Decision recorded in registry + winner at 100% traffic + report published =..."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_2 -. owns .-> step_3
+  role_2 -. owns .-> step_4
+  role_3 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Decision recorded in registry + winner at 100% traffic + report published = experiment closed.

package/areas/software/mlops/workflows/deploy-endpoint.md

@@ -63,6 +63,36 @@ quality-gates:
 - **Output:** `deployment_report.md` — timeline, traffic split results, new baselines
 - **Done when:** stable 24 hours; report complete
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /deploy-endpoint"])
+  role_1["team-lead"]
+  role_2["developer"]
+  role_3["qa"]
+  step_1["1. Pre-flight"]
+  step_2["2. Shadow Deployment"]
+  step_3["3. Canary Rollout"]
+  step_4["4. Promote Champion"]
+  step_5["5. Post-Deploy Monitoring"]
+  exit(["100% traffic on new champion + stable monitoring + deployment report = endp..."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_2 -. owns .-> step_2
+  role_2 -. owns .-> step_3
+  role_2 -. owns .-> step_4
+  role_3 -. owns .-> step_5
+  step_5 -. iterate if blocked .-> step_1
+```
+<!-- agent-diagram:end -->
+
 ## Iteration Loop
 Auto-rollback on SLO breach returns to Step 2 (shadow) or Step 1 (full re-review).
 

package/areas/software/mlops/workflows/evaluate-model.md

@@ -59,5 +59,33 @@ quality-gates:
 - **Output:** `evaluation_scorecard.json` with recommendation; visualizations (confusion matrix, ROC, feature importance)
 - **Done when:** recommendation recorded in model registry
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /evaluate-model"])
+  role_1["qa"]
+  role_2["team-lead"]
+  step_1["1. Load Model & Test Data"]
+  step_2["2. Compute Core Metrics"]
+  step_3["3. Business Impact Translation"]
+  step_4["4. Fairness Analysis"]
+  step_5["5. Champion Comparison"]
+  exit(["Signed scorecard + promotion recommendation = evaluation complete; feed int..."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_1 -. owns .-> step_3
+  role_1 -. owns .-> step_4
+  role_2 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Signed scorecard + promotion recommendation = evaluation complete; feed into `/deploy-endpoint` or `/champion-challenger`.

package/areas/software/mlops/workflows/model-incident.md

@@ -60,5 +60,34 @@ quality-gates:
 - **Output:** postmortem at `.mlops/incidents/<date>-<model>-incident.md`; monitoring updated; model card updated
 - **Done when:** postmortem reviewed; prevention measures in place
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /model-incident"])
+  role_1["team-lead"]
+  role_2["qa"]
+  role_3["developer"]
+  step_1["1. Immediate Response"]
+  step_2["2. Diagnose"]
+  step_3["3. Scope Affected Predictions"]
+  step_4["4. Root Cause & Remediation"]
+  step_5["5. Post-Incident"]
+  exit(["System restored + postmortem published + monitoring improved = incident clo..."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_2 -. owns .-> step_2
+  role_3 -. owns .-> step_3
+  role_3 -. owns .-> step_4
+  role_1 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 System restored + postmortem published + monitoring improved = incident closed.

package/areas/software/mlops/workflows/train-experiment.md

@@ -52,5 +52,30 @@ quality-gates:
 - **Output:** evaluation scorecard; comparison vs. top 3 previous runs
 - **Done when:** evaluation complete; recommendation produced (promote / continue tuning / investigate)
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /train-experiment"])
+  role_1["developer"]
+  role_2["qa"]
+  step_1["1. Prerequisites Validation"]
+  step_2["2. Environment Snapshot"]
+  step_3["3. Training Run"]
+  step_4["4. Validation"]
+  exit(["Logged artifact + evaluation scorecard + champion comparison = experiment c..."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_1 -. owns .-> step_3
+  role_2 -. owns .-> step_4
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Logged artifact + evaluation scorecard + champion comparison = experiment complete.

package/areas/software/mobile/workflows/crash-triage.md

@@ -59,5 +59,33 @@ quality-gates:
 - **Output:** verification report with device results
 - **Done when:** crash resolved on all tested devices; crash-free rate confirmed
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /crash-triage"])
+  role_1["developer"]
+  role_2["qa"]
+  step_1["1. Gather & Symbolicate"]
+  step_2["2. Reproduce"]
+  step_3["3. Root Cause"]
+  step_4["4. Fix & Regression Test"]
+  step_5["5. Verification"]
+  exit(["Device-verified fix + passing regression test + crash-free rate restored =..."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_2 -. owns .-> step_2
+  role_1 -. owns .-> step_3
+  role_1 -. owns .-> step_4
+  role_2 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Device-verified fix + passing regression test + crash-free rate restored = triage complete.

package/areas/software/mobile/workflows/device-testing.md

@@ -50,5 +50,32 @@ quality-gates:
 - **Output:** pass/fail matrix by device × test; failure screenshots with device context
 - **Done when:** all failures classified; release recommendation made
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /device-testing"])
+  role_1["qa"]
+  role_2["developer"]
+  role_3["team-lead"]
+  step_1["1. Select Device Matrix"]
+  step_2["2. Upload Build"]
+  step_3["3. Execute Test Suite"]
+  step_4["4. Analyze Results"]
+  exit(["Device matrix report + explicit go/no-go = device testing complete."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> exit
+  role_1 -. owns .-> step_1
+  role_2 -. owns .-> step_2
+  role_1 -. owns .-> step_3
+  role_1 -. owns .-> step_4
+  role_3 -. owns .-> step_4
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Device matrix report + explicit go/no-go = device testing complete.

package/areas/software/mobile/workflows/ota-update.md

@@ -50,5 +50,30 @@ quality-gates:
 - **Output:** adoption report with timeline and error rate
 - **Done when:** full adoption reached; no error rate regression
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /ota-update"])
+  role_1["developer"]
+  role_2["qa"]
+  step_1["1. Validate OTA Eligibility"]
+  step_2["2. Build Bundle"]
+  step_3["3. Staged Rollout"]
+  step_4["4. Monitor Adoption"]
+  exit(["100% adoption + stable error rate = OTA update complete."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_1 -. owns .-> step_3
+  role_2 -. owns .-> step_4
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 100% adoption + stable error rate = OTA update complete.

package/areas/software/mobile/workflows/release-build.md

@@ -63,5 +63,35 @@ quality-gates:
 - **Output:** artifact uploaded; hash recorded; team notified
 - **Done when:** upload confirmed; team has TestFlight/App Distribution link
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /release-build"])
+  role_1["developer"]
+  role_2["qa"]
+  role_3["team-lead"]
+  step_1["1. Version Validation"]
+  step_2["2. Environment Check"]
+  step_3["3. Build"]
+  step_4["4. Validate Build"]
+  step_5["5. Upload & Report"]
+  exit(["Signed artifact uploaded + smoke tests passed + @team-lead approval = relea..."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_1 -. owns .-> step_3
+  role_2 -. owns .-> step_4
+  role_1 -. owns .-> step_5
+  role_3 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Signed artifact uploaded + smoke tests passed + `@team-lead` approval = release build complete.

package/areas/software/mobile/workflows/store-submission.md

@@ -59,5 +59,34 @@ quality-gates:
 - **Output:** post-release monitoring report (48h window)
 - **Done when:** 48 hours stable; no new critical issues
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /store-submission"])
+  role_1["qa"]
+  role_2["developer"]
+  role_3["team-lead"]
+  step_1["1. Validate Build"]
+  step_2["2. Prepare Metadata"]
+  step_3["3. Compliance Check"]
+  step_4["4. Submit"]
+  step_5["5. Monitor Post-Release"]
+  exit(["Submission live + stable 48h monitoring = release complete."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_2 -. owns .-> step_2
+  role_3 -. owns .-> step_3
+  role_2 -. owns .-> step_4
+  role_1 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Submission live + stable 48h monitoring = release complete.

package/areas/software/platform/workflows/cost-audit.md

@@ -57,5 +57,33 @@ quality-gates:
 - **Output:** `cost_report.md`
 - **Done when:** report shared; owners assigned for top recommendations
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /cost-audit"])
+  role_1["qa"]
+  role_2["team-lead"]
+  step_1["1. Fetch Billing Data"]
+  step_2["2. Analyze Spend Patterns"]
+  step_3["3. Detect Waste"]
+  step_4["4. Generate Recommendations"]
+  step_5["5. Report"]
+  exit(["Published report + owners assigned for top recommendations = audit complete."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_1 -. owns .-> step_3
+  role_2 -. owns .-> step_4
+  role_2 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Published report + owners assigned for top recommendations = audit complete.

package/areas/software/platform/workflows/deploy-production.md

@@ -63,5 +63,35 @@ quality-gates:
 - **Output:** `deployment_report.md`
 - **Done when:** team and stakeholders informed
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /deploy-production"])
+  role_1["team-lead"]
+  role_2["developer"]
+  role_3["qa"]
+  role_4["pm"]
+  step_1["1. Pre-flight"]
+  step_2["2. Canary (10% traffic)"]
+  step_3["3. Progressive Rollout"]
+  step_4["4. Post-Deploy Validation"]
+  step_5["5. Complete"]
+  exit(["Green smoke tests + stable metrics + deployment report = release complete."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_2 -. owns .-> step_2
+  role_2 -. owns .-> step_3
+  role_3 -. owns .-> step_4
+  role_4 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Green smoke tests + stable metrics + deployment report = release complete.

package/areas/software/platform/workflows/drift-check.md

@@ -57,5 +57,34 @@ quality-gates:
 - **Output:** Category A drift resolved; issues created for B/C/D
 - **Done when:** Category A applied; B/C/D tracked in issues
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /drift-check"])
+  role_1["qa"]
+  role_2["team-lead"]
+  role_3["developer"]
+  step_1["1. Fetch Live State"]
+  step_2["2. Compute Diff"]
+  step_3["3. Classify Drift"]
+  step_4["4. Report"]
+  step_5["5. Remediate"]
+  exit(["Drift report published + Category A resolved (if --fix) + B/C/D tracked = d..."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_2 -. owns .-> step_3
+  role_2 -. owns .-> step_4
+  role_3 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Drift report published + Category A resolved (if --fix) + B/C/D tracked = drift check complete.

package/areas/software/platform/workflows/incident-response.md

@@ -65,5 +65,38 @@ quality-gates:
 - **Output:** stakeholders informed; status page updated
 - **Done when:** all affected parties notified
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /incident-response"])
+  role_1["team-lead"]
+  role_2["developer"]
+  role_3["pm"]
+  step_1["1. Triage"]
+  step_2["2. Establish Incident Channel"]
+  step_3["3. Generate Hypothesis List"]
+  step_4["4. Execute Mitigation"]
+  step_5["5. Draft Postmortem"]
+  step_6["6. Communicate Resolution"]
+  exit(["Services healthy + postmortem scheduled + stakeholders notified = incident..."])
+  start --> step_1
+  step_1 --> step_2
+  step_2 --> step_3
+  step_3 --> step_4
+  step_4 --> step_5
+  step_5 --> step_6
+  step_6 --> exit
+  role_1 -. owns .-> step_1
+  role_1 -. owns .-> step_2
+  role_1 -. owns .-> step_3
+  role_2 -. owns .-> step_3
+  role_2 -. owns .-> step_4
+  role_1 -. owns .-> step_5
+  role_3 -. owns .-> step_6
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Services healthy + postmortem scheduled + stakeholders notified = incident resolved.