@jetrabbits/agentic 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (93) hide show
  1. package/AGENTS.md +8 -0
  2. package/CHANGELOG.md +3 -0
  3. package/Makefile +21 -5
  4. package/README.md +17 -4
  5. package/agentic +78 -7
  6. package/areas/devops/ci-cd/workflows/onboard-repo.md +29 -0
  7. package/areas/devops/ci-cd/workflows/pipeline-debug.md +26 -0
  8. package/areas/devops/ci-cd/workflows/release-pipeline.md +53 -0
  9. package/areas/devops/database-ops/workflows/backup-verify.md +27 -0
  10. package/areas/devops/database-ops/workflows/db-incident.md +30 -0
  11. package/areas/devops/devsecops/workflows/policy-onboard.md +34 -0
  12. package/areas/devops/devsecops/workflows/security-scan-pipeline.md +33 -0
  13. package/areas/devops/infrastructure/workflows/destroy-environment.md +31 -0
  14. package/areas/devops/infrastructure/workflows/drift-remediation.md +29 -0
  15. package/areas/devops/infrastructure/workflows/module-development.md +32 -0
  16. package/areas/devops/infrastructure/workflows/provision-environment.md +29 -0
  17. package/areas/devops/kubernetes/workflows/cluster-bootstrap.md +36 -0
  18. package/areas/devops/kubernetes/workflows/debug-workload.md +29 -0
  19. package/areas/devops/kubernetes/workflows/onboard-service.md +35 -0
  20. package/areas/devops/kubernetes/workflows/upgrade-cluster.md +30 -0
  21. package/areas/devops/networking/workflows/onboard-ingress.md +27 -0
  22. package/areas/devops/networking/workflows/service-mesh-onboard.md +27 -0
  23. package/areas/devops/observability/workflows/alert-investigation.md +29 -0
  24. package/areas/devops/observability/workflows/observability-stack-setup.md +33 -0
  25. package/areas/devops/observability/workflows/onboard-service-monitoring.md +31 -0
  26. package/areas/devops/sre/workflows/incident-response.md +48 -0
  27. package/areas/devops/sre/workflows/postmortem.md +32 -0
  28. package/areas/devops/sre/workflows/slo-review.md +35 -1
  29. package/areas/software/backend/workflows/add-migration.md +33 -0
  30. package/areas/software/backend/workflows/create-endpoint.md +40 -0
  31. package/areas/software/backend/workflows/debug-issue.md +31 -0
  32. package/areas/software/backend/workflows/develop-epic.md +37 -0
  33. package/areas/software/backend/workflows/develop-feature.md +44 -0
  34. package/areas/software/backend/workflows/refactor-module.md +35 -0
  35. package/areas/software/backend/workflows/test-feature.md +30 -0
  36. package/areas/software/data-engineering/workflows/backfill-data.md +25 -0
  37. package/areas/software/data-engineering/workflows/data-quality-incident.md +31 -0
  38. package/areas/software/data-engineering/workflows/lineage-trace.md +25 -0
  39. package/areas/software/data-engineering/workflows/new-model.md +30 -0
  40. package/areas/software/data-engineering/workflows/schema-migration.md +29 -0
  41. package/areas/software/frontend/workflows/a11y-fix.md +30 -0
  42. package/areas/software/frontend/workflows/bundle-analyze.md +28 -0
  43. package/areas/software/frontend/workflows/release-prep.md +33 -0
  44. package/areas/software/frontend/workflows/scaffold-component.md +32 -0
  45. package/areas/software/frontend/workflows/visual-regression.md +32 -0
  46. package/areas/software/full-stack/workflows/backend-project-full-cycle.md +47 -2
  47. package/areas/software/full-stack/workflows/debug-issue.md +29 -0
  48. package/areas/software/full-stack/workflows/develop-feature.md +38 -0
  49. package/areas/software/full-stack/workflows/feature-implementation-flow.md +38 -0
  50. package/areas/software/full-stack/workflows/testing-ci-pipeline.md +30 -0
  51. package/areas/software/general/workflows/code-review-workflow.md +31 -0
  52. package/areas/software/general/workflows/development-cycle-workflow.md +38 -0
  53. package/areas/software/general/workflows/project-setup-workflow.md +38 -0
  54. package/areas/software/mlops/workflows/champion-challenger.md +29 -0
  55. package/areas/software/mlops/workflows/deploy-endpoint.md +30 -0
  56. package/areas/software/mlops/workflows/evaluate-model.md +28 -0
  57. package/areas/software/mlops/workflows/model-incident.md +29 -0
  58. package/areas/software/mlops/workflows/train-experiment.md +25 -0
  59. package/areas/software/mobile/workflows/crash-triage.md +28 -0
  60. package/areas/software/mobile/workflows/device-testing.md +27 -0
  61. package/areas/software/mobile/workflows/ota-update.md +25 -0
  62. package/areas/software/mobile/workflows/release-build.md +30 -0
  63. package/areas/software/mobile/workflows/store-submission.md +29 -0
  64. package/areas/software/platform/workflows/cost-audit.md +28 -0
  65. package/areas/software/platform/workflows/deploy-production.md +30 -0
  66. package/areas/software/platform/workflows/drift-check.md +29 -0
  67. package/areas/software/platform/workflows/incident-response.md +33 -0
  68. package/areas/software/platform/workflows/provision-env.md +36 -0
  69. package/areas/software/qa/workflows/flakiness-investigation.md +30 -0
  70. package/areas/software/qa/workflows/performance-audit.md +29 -0
  71. package/areas/software/qa/workflows/regression-suite.md +28 -0
  72. package/areas/software/qa/workflows/smoke-test.md +31 -0
  73. package/areas/software/qa/workflows/test-coverage-report.md +28 -0
  74. package/areas/software/security/workflows/compliance-report.md +27 -0
  75. package/areas/software/security/workflows/pen-test-sim.md +28 -0
  76. package/areas/software/security/workflows/secret-rotation.md +33 -2
  77. package/areas/software/security/workflows/security-scan.md +29 -0
  78. package/areas/software/security/workflows/threat-model-review.md +30 -0
  79. package/docs/agentic-usage.md +1 -1
  80. package/docs/catalog.schema.json +5 -1
  81. package/docs/opencode_setup.md +10 -0
  82. package/docs/site/README.md +15 -1
  83. package/docs/site/app.js +68 -0
  84. package/docs/site/catalog.json +74 -1
  85. package/docs/site/index.html +5 -1
  86. package/docs/site/styles.css +52 -4
  87. package/extensions/opencode/opencode.json +0 -1
  88. package/extensions/opencode/profiles/githubcopilot/opencode.json +1 -2
  89. package/extensions/opencode/profiles/openai/opencode.json +20 -20
  90. package/package.json +1 -1
  91. package/scripts/build_docs_catalog.py +13 -1
  92. package/scripts/sync_workflow_diagrams.py +199 -0
  93. package/extensions/opencode/plugins/sound-notification.ts +0 -13
@@ -85,6 +85,50 @@ quality-gates:
85
85
  - **Output:** `docs/<feature>/delivery_summary.md` — accepted / deferred with rationale
86
86
  - **Done when:** feature accepted or explicitly deferred
87
87
 
88
+ ## Agent Interaction Diagram
89
+
90
+ <!-- agent-diagram:start -->
91
+ ```mermaid
92
+ flowchart TD
93
+ start(["Start /develop-feature"])
94
+ role_1["product-owner"]
95
+ role_2["pm"]
96
+ role_3["team-lead"]
97
+ role_4["designer"]
98
+ role_5["developer"]
99
+ role_6["qa"]
100
+ step_1["1. Requirements & Value Framing"]
101
+ step_2["2. Solution Design & Risk Plan"]
102
+ step_3["3. Implementation"]
103
+ step_4["4. Risk-Based Verification"]
104
+ step_5["5. Code Review & Architecture Sign-off"]
105
+ step_6["6. Fix / Retest Loop"]
106
+ step_7["7. Acceptance & Final Report"]
107
+ exit(["@product-owner acceptance + no unresolved blockers = feature complete and r..."])
108
+ start --> step_1
109
+ step_1 --> step_2
110
+ step_2 --> step_3
111
+ step_3 --> step_4
112
+ step_4 --> step_5
113
+ step_5 --> step_6
114
+ step_6 --> step_7
115
+ step_7 --> exit
116
+ role_1 -. owns .-> step_1
117
+ role_2 -. owns .-> step_1
118
+ role_3 -. owns .-> step_2
119
+ role_4 -. owns .-> step_2
120
+ role_5 -. owns .-> step_3
121
+ role_6 -. owns .-> step_4
122
+ role_3 -. owns .-> step_5
123
+ role_5 -. owns .-> step_6
124
+ role_6 -. owns .-> step_6
125
+ role_2 -. owns .-> step_6
126
+ role_1 -. owns .-> step_7
127
+ role_2 -. owns .-> step_7
128
+ step_7 -. iterate if blocked .-> step_1
129
+ ```
130
+ <!-- agent-diagram:end -->
131
+
88
132
  ## Iteration Loop
89
133
  Steps 3–6 repeat per increment for large features. `@pm` tracks scope changes and timeline impact.
90
134
 
@@ -69,5 +69,40 @@ quality-gates:
69
69
  - **Output:** merge approval + note in `refactor_plan.md`: "Goal achieved: <description>"
70
70
  - **Done when:** PR merged
71
71
 
72
+ ## Agent Interaction Diagram
73
+
74
+ <!-- agent-diagram:start -->
75
+ ```mermaid
76
+ flowchart TD
77
+ start(["Start /refactor-module"])
78
+ role_1["team-lead"]
79
+ role_2["qa"]
80
+ role_3["developer"]
81
+ step_1["1. Refactor Plan & Boundaries"]
82
+ step_2["2. Baseline Test Coverage"]
83
+ step_3["3. Incremental Refactor Implementation"]
84
+ step_4["4. Regression Validation"]
85
+ step_5["5. Review / Fix Loop"]
86
+ step_6["6. Closure with Parity Report"]
87
+ exit(["Merged refactor + behavior parity confirmed + improvement goal achieved = r..."])
88
+ start --> step_1
89
+ step_1 --> step_2
90
+ step_2 --> step_3
91
+ step_3 --> step_4
92
+ step_4 --> step_5
93
+ step_5 --> step_6
94
+ step_6 --> exit
95
+ role_1 -. owns .-> step_1
96
+ role_2 -. owns .-> step_2
97
+ role_3 -. owns .-> step_2
98
+ role_3 -. owns .-> step_3
99
+ role_2 -. owns .-> step_4
100
+ role_1 -. owns .-> step_5
101
+ role_3 -. owns .-> step_5
102
+ role_2 -. owns .-> step_5
103
+ role_1 -. owns .-> step_6
104
+ ```
105
+ <!-- agent-diagram:end -->
106
+
72
107
  ## Exit
73
108
  Merged refactor + behavior parity confirmed + improvement goal achieved = refactor complete.
@@ -63,5 +63,35 @@ quality-gates:
63
63
  - **Output:** `quality_report.md`; stable CI run evidence
64
64
  - **Done when:** zero flaky tests; coverage meets threshold; report complete
65
65
 
66
+ ## Agent Interaction Diagram
67
+
68
+ <!-- agent-diagram:start -->
69
+ ```mermaid
70
+ flowchart TD
71
+ start(["Start /test-feature"])
72
+ role_1["qa"]
73
+ role_2["developer"]
74
+ role_3["team-lead"]
75
+ step_1["1. Coverage Gap Analysis"]
76
+ step_2["2. Testability Adjustments"]
77
+ step_3["3. Automated Test Implementation"]
78
+ step_4["4. Review of Scenarios & Assertions"]
79
+ step_5["5. Stability Run & Reporting"]
80
+ exit(["Stable test suite + coverage threshold met + @team-lead approval = tests re..."])
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_1 -. owns .-> step_3
90
+ role_2 -. owns .-> step_3
91
+ role_3 -. owns .-> step_4
92
+ role_1 -. owns .-> step_5
93
+ ```
94
+ <!-- agent-diagram:end -->
95
+
66
96
  ## Exit
67
97
  Stable test suite + coverage threshold met + `@team-lead` approval = tests ready to merge.
@@ -55,5 +55,30 @@ quality-gates:
55
55
  - **Output:** `validation_report.md` — row counts, metric comparison, dbt test results
56
56
  - **Done when:** all tests pass; metrics match expected; consumers notified
57
57
 
58
+ ## Agent Interaction Diagram
59
+
60
+ <!-- agent-diagram:start -->
61
+ ```mermaid
62
+ flowchart TD
63
+ start(["Start /backfill-data"])
64
+ role_1["developer"]
65
+ role_2["qa"]
66
+ step_1["1. Impact Assessment"]
67
+ step_2["2. Dry Run"]
68
+ step_3["3. Execute Backfill"]
69
+ step_4["4. Post-Backfill Validation"]
70
+ exit(["Validated backfill + notified consumers + @team-lead sign-off = backfill co..."])
71
+ start --> step_1
72
+ step_1 --> step_2
73
+ step_2 --> step_3
74
+ step_3 --> step_4
75
+ step_4 --> exit
76
+ role_1 -. owns .-> step_1
77
+ role_2 -. owns .-> step_2
78
+ role_1 -. owns .-> step_3
79
+ role_2 -. owns .-> step_4
80
+ ```
81
+ <!-- agent-diagram:end -->
82
+
58
83
  ## Exit
59
84
  Validated backfill + notified consumers + `@team-lead` sign-off = backfill complete.
@@ -60,5 +60,36 @@ quality-gates:
60
60
  - **Output:** postmortem; monitoring updated; dbt tests 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 /data-quality-incident"])
69
+ role_1["qa"]
70
+ role_2["developer"]
71
+ role_3["team-lead"]
72
+ step_1["1. Scope & Triage"]
73
+ step_2["2. Quarantine"]
74
+ step_3["3. Root Cause Isolation"]
75
+ step_4["4. Remediation"]
76
+ step_5["5. Post-Incident"]
77
+ exit(["Clean model + postmortem published + prevention measures added = incident c..."])
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_1 -. owns .-> step_3
87
+ role_2 -. owns .-> step_3
88
+ role_2 -. owns .-> step_4
89
+ role_3 -. owns .-> step_5
90
+ role_1 -. owns .-> step_5
91
+ ```
92
+ <!-- agent-diagram:end -->
93
+
63
94
  ## Exit
64
95
  Clean model + postmortem published + prevention measures added = incident closed.
@@ -52,5 +52,30 @@ quality-gates:
52
52
  - **Output:** `lineage_report.md` with diagram, summary, and checklist
53
53
  - **Done when:** report reviewed and ready to share with affected owners
54
54
 
55
+ ## Agent Interaction Diagram
56
+
57
+ <!-- agent-diagram:start -->
58
+ ```mermaid
59
+ flowchart TD
60
+ start(["Start /lineage-trace"])
61
+ role_1["developer"]
62
+ role_2["team-lead"]
63
+ step_1["1. Parse Target"]
64
+ step_2["2. Trace Lineage"]
65
+ step_3["3. Impact Assessment"]
66
+ step_4["4. Generate Report"]
67
+ exit(["Published lineage report + migration checklist = ready to plan the change s..."])
68
+ start --> step_1
69
+ step_1 --> step_2
70
+ step_2 --> step_3
71
+ step_3 --> step_4
72
+ step_4 --> exit
73
+ role_1 -. owns .-> step_1
74
+ role_1 -. owns .-> step_2
75
+ role_2 -. owns .-> step_3
76
+ role_1 -. owns .-> step_4
77
+ ```
78
+ <!-- agent-diagram:end -->
79
+
55
80
  ## Exit
56
81
  Published lineage report + migration checklist = ready to plan the change safely.
@@ -67,5 +67,35 @@ quality-gates:
67
67
  - **Actions:** review SQL logic, naming conventions, documentation completeness; approve or return with blocking feedback
68
68
  - **Done when:** `@team-lead` approves; PR merged
69
69
 
70
+ ## Agent Interaction Diagram
71
+
72
+ <!-- agent-diagram:start -->
73
+ ```mermaid
74
+ flowchart TD
75
+ start(["Start /new-model"])
76
+ role_1["pm"]
77
+ role_2["team-lead"]
78
+ role_3["developer"]
79
+ role_4["qa"]
80
+ step_1["1. Requirements Gathering"]
81
+ step_2["2. Model Design"]
82
+ step_3["3. SQL & YAML Implementation"]
83
+ step_4["4. Validation"]
84
+ step_5["5. Review & Merge"]
85
+ exit(["Passing dbt tests + complete YAML docs + @team-lead approval = model produc..."])
86
+ start --> step_1
87
+ step_1 --> step_2
88
+ step_2 --> step_3
89
+ step_3 --> step_4
90
+ step_4 --> step_5
91
+ step_5 --> exit
92
+ role_1 -. owns .-> step_1
93
+ role_2 -. owns .-> step_2
94
+ role_3 -. owns .-> step_3
95
+ role_4 -. owns .-> step_4
96
+ role_2 -. owns .-> step_5
97
+ ```
98
+ <!-- agent-diagram:end -->
99
+
70
100
  ## Exit
71
101
  Passing dbt tests + complete YAML docs + `@team-lead` approval = model production-ready.
@@ -63,5 +63,34 @@ quality-gates:
63
63
  - **Output:** `validation_report.md`; catalog updated; owners notified
64
64
  - **Done when:** all tests green; documentation current
65
65
 
66
+ ## Agent Interaction Diagram
67
+
68
+ <!-- agent-diagram:start -->
69
+ ```mermaid
70
+ flowchart TD
71
+ start(["Start /schema-migration"])
72
+ role_1["team-lead"]
73
+ role_2["developer"]
74
+ role_3["qa"]
75
+ step_1["1. Change Classification"]
76
+ step_2["2. Impact Assessment"]
77
+ step_3["3. Migration Strategy"]
78
+ step_4["4. Execute Migration"]
79
+ step_5["5. Verify & Document"]
80
+ exit(["Post-migration tests green + catalog updated + owners notified = migration..."])
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_1 -. owns .-> step_3
90
+ role_2 -. owns .-> step_4
91
+ role_3 -. owns .-> step_5
92
+ ```
93
+ <!-- agent-diagram:end -->
94
+
66
95
  ## Exit
67
96
  Post-migration tests green + catalog updated + owners notified = migration complete.
@@ -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.