@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.
- package/AGENTS.md +8 -0
- package/CHANGELOG.md +3 -0
- package/Makefile +21 -5
- package/README.md +17 -4
- package/agentic +78 -7
- 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 +1 -1
- package/docs/catalog.schema.json +5 -1
- package/docs/opencode_setup.md +10 -0
- 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 +1 -2
- package/extensions/opencode/profiles/openai/opencode.json +20 -20
- 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
|
@@ -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-
|
|
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.
|