@jetrabbits/agentic 0.3.3 → 0.5.0

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.

package/areas/software/platform/workflows/provision-env.md

@@ -73,5 +73,41 @@ quality-gates:
 - **Output:** environment URL published in PR
 - **Done when:** team has access and teardown instructions
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /provision-env"])
+  role_1["team-lead"]
+  role_2["developer"]
+  role_3["qa"]
+  role_4["pm"]
+  step_1["1. Validate Prerequisites"]
+  step_2["2. Plan Infrastructure"]
+  step_3["3. Estimate Cost"]
+  step_4["4. Apply Infrastructure"]
+  step_5["5. Configure DNS & Ingress"]
+  step_6["6. Seed & Smoke Test"]
+  step_7["7. Report"]
+  exit(["Smoke tests green + URL published = environment ready for use."])
+  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 --> step_7
+  step_7 --> exit
+  role_1 -. owns .-> step_1
+  role_2 -. owns .-> step_2
+  role_2 -. owns .-> step_3
+  role_2 -. owns .-> step_4
+  role_2 -. owns .-> step_5
+  role_3 -. owns .-> step_6
+  role_4 -. owns .-> step_7
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Smoke tests green + URL published = environment ready for use.

package/areas/software/qa/workflows/flakiness-investigation.md

@@ -59,5 +59,35 @@ quality-gates:
 - **Output:** closure note in flakiness log; systemic action item if needed
 - **Done when:** flakiness log updated; test unquarantined or deleted
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /flakiness-investigation"])
+  role_1["qa"]
+  role_2["developer"]
+  role_3["team-lead"]
+  step_1["1. Collect Failure Signals & Patterns"]
+  step_2["2. Reproduce & Classify Root Cause"]
+  step_3["3. Stabilization Fix"]
+  step_4["4. Stress Re-run & Quarantine Decision"]
+  step_5["5. Policy Review & Closure"]
+  exit(["Stable test in CI + root cause documented + log updated = investigation 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_1 -. owns .-> step_2
+  role_2 -. owns .-> step_2
+  role_2 -. owns .-> step_3
+  role_1 -. owns .-> step_4
+  role_3 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Stable test in CI + root cause documented + log updated = investigation closed.

package/areas/software/qa/workflows/performance-audit.md

@@ -55,5 +55,34 @@ quality-gates:
 - **Output:** `performance_report.md`; remediation backlog items created
 - **Done when:** report complete; backlog items assigned
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /performance-audit"])
+  role_1["qa"]
+  role_2["developer"]
+  role_3["team-lead"]
+  role_4["pm"]
+  step_1["1. Scenario Definition & Baseline Alignment"]
+  step_2["2. Load/Stress Execution & Monitoring Capture"]
+  step_3["3. Bottleneck Analysis & Fix Proposal"]
+  step_4["4. Prioritization & Delivery Planning"]
+  exit(["Published report + prioritized remediation plan + backlog items created = a..."])
+  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_2 -. owns .-> step_3
+  role_1 -. owns .-> step_3
+  role_3 -. owns .-> step_4
+  role_4 -. owns .-> step_4
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Published report + prioritized remediation plan + backlog items created = audit complete.

package/areas/software/qa/workflows/regression-suite.md

@@ -55,5 +55,33 @@ quality-gates:
 - **Output:** `regression_report.md`; go/no-go decision
 - **Done when:** recommendation is explicit; stakeholders informed
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /regression-suite"])
+  role_1["qa"]
+  role_2["developer"]
+  role_3["team-lead"]
+  step_1["1. Scope Selection & Environment Readiness"]
+  step_2["2. Suite Execution & Evidence Capture"]
+  step_3["3. Failure Triage & Fixes"]
+  step_4["4. Risk Review & Release Recommendation"]
+  exit(["Go recommendation + regression report = release confidence confirmed."])
+  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_2 -. owns .-> step_3
+  role_1 -. owns .-> step_3
+  role_3 -. owns .-> step_4
+  role_1 -. owns .-> step_4
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Go recommendation + regression report = release confidence confirmed.

package/areas/software/qa/workflows/smoke-test.md

@@ -60,5 +60,36 @@ quality-gates:
 - **Output:** `smoke_result_summary.md`; stakeholders informed
 - **Done when:** all parties notified; action taken if needed
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /smoke-test"])
+  role_1["qa"]
+  role_2["developer"]
+  role_3["team-lead"]
+  role_4["pm"]
+  step_1["1. Prepare Environment & Test Data"]
+  step_2["2. Run Critical Smoke Scenarios"]
+  step_3["3. Defect Triage & Fix"]
+  step_4["4. Operational Risk Assessment"]
+  step_5["5. Communicate Go/No-Go"]
+  exit(["Go status + summary published = deployment validated. No-go + rollback trig..."])
+  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_3 -. owns .-> step_4
+  role_4 -. owns .-> step_5
+  role_1 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Go status + summary published = deployment validated. No-go + rollback triggered = incident response starts.

package/areas/software/qa/workflows/test-coverage-report.md

@@ -53,5 +53,33 @@ quality-gates:
 - **Output:** `coverage_report.md`; next sprint coverage actions noted
 - **Done when:** report shared with team; action items logged
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /test-coverage-report"])
+  role_1["qa"]
+  role_2["team-lead"]
+  role_3["developer"]
+  step_1["1. Collect & Compare Metrics"]
+  step_2["2. Identify High-Risk Gaps"]
+  step_3["3. Implement Targeted Tests & Fixes"]
+  step_4["4. Publish Trend & Action Plan"]
+  exit(["Critical paths at threshold + trend published + gaps assigned = coverage cy..."])
+  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_2 -. owns .-> step_2
+  role_3 -. owns .-> step_3
+  role_1 -. owns .-> step_3
+  role_1 -. owns .-> step_4
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Critical paths at threshold + trend published + gaps assigned = coverage cycle complete.

package/areas/software/security/workflows/compliance-report.md

@@ -53,5 +53,32 @@ quality-gates:
 - **Output:** compliance report document
 - **Done when:** report complete; human review flag set
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /compliance-report"])
+  role_1["team-lead"]
+  role_2["developer"]
+  role_3["qa"]
+  step_1["1. Map Controls"]
+  step_2["2. Collect Evidence"]
+  step_3["3. Evaluate Compliance"]
+  step_4["4. Generate Report"]
+  exit(["Complete control matrix + gap analysis + human review flag = report ready f..."])
+  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_3 -. owns .-> step_2
+  role_1 -. owns .-> step_3
+  role_1 -. owns .-> step_4
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Complete control matrix + gap analysis + human review flag = report ready for review.

package/areas/software/security/workflows/pen-test-sim.md

@@ -59,5 +59,33 @@ quality-gates:
 - **Output:** `pentest_report_<date>.md`; remediation assignments
 - **Done when:** report reviewed; remediation owners assigned
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /pen-test-sim"])
+  role_1["team-lead"]
+  role_2["qa"]
+  step_1["1. Scope Confirmation"]
+  step_2["2. Passive Recon"]
+  step_3["3. Active Scanning"]
+  step_4["4. Manual Checks"]
+  step_5["5. Report"]
+  exit(["Published report + Critical/High findings assigned = pen-test 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_2 -. owns .-> step_4
+  role_1 -. owns .-> step_5
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Published report + Critical/High findings assigned = pen-test complete.

package/areas/software/security/workflows/secret-rotation.md

@@ -16,9 +16,9 @@ execution:
   initiator: developer
 related-rules:
   - secrets-policy.md
-  - security-posture.md
+  - secure-coding.md
 uses-skills:
-  - secrets-management
+  - crypto-standards
 quality-gates:
   - old credential revoked only after zero auth errors confirmed
   - audit log entry created with rotation metadata
@@ -63,5 +63,36 @@ quality-gates:
 - **Output:** audit record updated
 - **Done when:** inventory current; next rotation scheduled
 
+## Agent Interaction Diagram
+
+<!-- agent-diagram:start -->
+```mermaid
+flowchart TD
+  start(["Start /secret-rotation"])
+  role_1["developer"]
+  role_2["team-lead"]
+  step_1["1. Prepare New Secret"]
+  step_2["2. Dual-Read Window"]
+  step_3["3. Deploy New Secret"]
+  step_4["4. Validate"]
+  step_5["5. Revoke Old Secret"]
+  step_6["6. Document"]
+  exit(["Old secret revoked + audit record updated = rotation 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_1 -. owns .-> step_2
+  role_1 -. owns .-> step_3
+  role_2 -. owns .-> step_4
+  role_1 -. owns .-> step_5
+  role_1 -. owns .-> step_6
+```
+<!-- agent-diagram:end -->
+
 ## Exit
 Old secret revoked + audit record updated = rotation complete.