@jetrabbits/agentic 0.0.1
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 +143 -0
- package/README.md +154 -0
- package/agentic +1615 -0
- package/areas/devops/ci-cd/AGENTS.md +48 -0
- package/areas/devops/ci-cd/PROMPTS.md +7 -0
- package/areas/devops/ci-cd/prompts/onboard-repo.md +97 -0
- package/areas/devops/ci-cd/prompts/pipeline-debug.md +103 -0
- package/areas/devops/ci-cd/prompts/release-pipeline.md +115 -0
- package/areas/devops/ci-cd/rules/pipeline-standards.md +33 -0
- package/areas/devops/ci-cd/rules/quality-gates.md +24 -0
- package/areas/devops/ci-cd/rules/supply-chain-security.md +34 -0
- package/areas/devops/ci-cd/skills/artifact-management/SKILL.md +157 -0
- package/areas/devops/ci-cd/skills/build-optimization/SKILL.md +168 -0
- package/areas/devops/ci-cd/skills/github-actions-patterns/SKILL.md +190 -0
- package/areas/devops/ci-cd/skills/gitlab-ci-patterns/SKILL.md +169 -0
- package/areas/devops/ci-cd/skills/pipeline-security/SKILL.md +161 -0
- package/areas/devops/ci-cd/workflows/onboard-repo.md +73 -0
- package/areas/devops/ci-cd/workflows/pipeline-debug.md +66 -0
- package/areas/devops/ci-cd/workflows/release-pipeline.md +115 -0
- package/areas/devops/database-ops/AGENTS.md +47 -0
- package/areas/devops/database-ops/prompts/backup-verify.md +83 -0
- package/areas/devops/database-ops/prompts/db-incident.md +127 -0
- package/areas/devops/database-ops/rules/access-control.md +20 -0
- package/areas/devops/database-ops/rules/backup-policy.md +33 -0
- package/areas/devops/database-ops/rules/migration-runbook.md +32 -0
- package/areas/devops/database-ops/skills/backup-restore/SKILL.md +226 -0
- package/areas/devops/database-ops/skills/db-performance/SKILL.md +205 -0
- package/areas/devops/database-ops/skills/migration-safety/SKILL.md +155 -0
- package/areas/devops/database-ops/skills/postgres-operations/SKILL.md +156 -0
- package/areas/devops/database-ops/skills/redis-operations/SKILL.md +174 -0
- package/areas/devops/database-ops/workflows/backup-verify.md +107 -0
- package/areas/devops/database-ops/workflows/db-incident.md +86 -0
- package/areas/devops/devsecops/AGENTS.md +47 -0
- package/areas/devops/devsecops/prompts/policy-onboard.md +79 -0
- package/areas/devops/devsecops/prompts/security-scan-pipeline.md +131 -0
- package/areas/devops/devsecops/rules/container-security.md +22 -0
- package/areas/devops/devsecops/rules/policy-as-code.md +37 -0
- package/areas/devops/devsecops/rules/shift-left-policy.md +26 -0
- package/areas/devops/devsecops/skills/container-hardening/SKILL.md +146 -0
- package/areas/devops/devsecops/skills/opa-policies/SKILL.md +188 -0
- package/areas/devops/devsecops/skills/sbom-supply-chain/SKILL.md +165 -0
- package/areas/devops/devsecops/skills/secret-detection/SKILL.md +190 -0
- package/areas/devops/devsecops/skills/sigstore-signing/SKILL.md +184 -0
- package/areas/devops/devsecops/workflows/policy-onboard.md +104 -0
- package/areas/devops/devsecops/workflows/security-scan-pipeline.md +155 -0
- package/areas/devops/infrastructure/AGENTS.md +50 -0
- package/areas/devops/infrastructure/prompts/destroy-environment.md +81 -0
- package/areas/devops/infrastructure/prompts/drift-remediation.md +71 -0
- package/areas/devops/infrastructure/prompts/module-development.md +69 -0
- package/areas/devops/infrastructure/prompts/provision-environment.md +121 -0
- package/areas/devops/infrastructure/rules/iac-standards.md +80 -0
- package/areas/devops/infrastructure/rules/immutability.md +28 -0
- package/areas/devops/infrastructure/rules/secret-hygiene.md +53 -0
- package/areas/devops/infrastructure/rules/state-management.md +47 -0
- package/areas/devops/infrastructure/skills/ansible-playbooks/SKILL.md +174 -0
- package/areas/devops/infrastructure/skills/cost-optimization/SKILL.md +177 -0
- package/areas/devops/infrastructure/skills/drift-detection/SKILL.md +178 -0
- package/areas/devops/infrastructure/skills/state-management/SKILL.md +159 -0
- package/areas/devops/infrastructure/skills/terraform-modules/SKILL.md +169 -0
- package/areas/devops/infrastructure/workflows/destroy-environment.md +96 -0
- package/areas/devops/infrastructure/workflows/drift-remediation.md +66 -0
- package/areas/devops/infrastructure/workflows/module-development.md +101 -0
- package/areas/devops/infrastructure/workflows/provision-environment.md +96 -0
- package/areas/devops/kubernetes/AGENTS.md +57 -0
- package/areas/devops/kubernetes/PROMPTS.md +9 -0
- package/areas/devops/kubernetes/prompts/cluster-bootstrap.md +67 -0
- package/areas/devops/kubernetes/prompts/debug-workload.md +91 -0
- package/areas/devops/kubernetes/prompts/onboard-service.md +101 -0
- package/areas/devops/kubernetes/prompts/upgrade-cluster.md +63 -0
- package/areas/devops/kubernetes/rules/cluster-standards.md +51 -0
- package/areas/devops/kubernetes/rules/resource-governance.md +80 -0
- package/areas/devops/kubernetes/rules/upgrade-policy.md +52 -0
- package/areas/devops/kubernetes/rules/workload-security.md +64 -0
- package/areas/devops/kubernetes/skills/cluster-operations/SKILL.md +136 -0
- package/areas/devops/kubernetes/skills/helm-charts/SKILL.md +152 -0
- package/areas/devops/kubernetes/skills/network-policies/SKILL.md +169 -0
- package/areas/devops/kubernetes/skills/pod-troubleshooting/SKILL.md +129 -0
- package/areas/devops/kubernetes/skills/rbac-design/SKILL.md +148 -0
- package/areas/devops/kubernetes/skills/resource-tuning/SKILL.md +156 -0
- package/areas/devops/kubernetes/workflows/cluster-bootstrap.md +194 -0
- package/areas/devops/kubernetes/workflows/debug-workload.md +108 -0
- package/areas/devops/kubernetes/workflows/onboard-service.md +124 -0
- package/areas/devops/kubernetes/workflows/upgrade-cluster.md +165 -0
- package/areas/devops/networking/AGENTS.md +47 -0
- package/areas/devops/networking/prompts/onboard-ingress.md +119 -0
- package/areas/devops/networking/prompts/service-mesh-onboard.md +77 -0
- package/areas/devops/networking/rules/ingress-standards.md +17 -0
- package/areas/devops/networking/rules/network-segmentation.md +24 -0
- package/areas/devops/networking/rules/tls-policy.md +32 -0
- package/areas/devops/networking/skills/dns-management/SKILL.md +169 -0
- package/areas/devops/networking/skills/ingress-patterns/SKILL.md +165 -0
- package/areas/devops/networking/skills/service-mesh/SKILL.md +206 -0
- package/areas/devops/networking/skills/tls-termination/SKILL.md +198 -0
- package/areas/devops/networking/skills/vpc-design/SKILL.md +132 -0
- package/areas/devops/networking/workflows/onboard-ingress.md +64 -0
- package/areas/devops/networking/workflows/service-mesh-onboard.md +122 -0
- package/areas/devops/observability/AGENTS.md +48 -0
- package/areas/devops/observability/prompts/alert-investigation.md +117 -0
- package/areas/devops/observability/prompts/observability-stack-setup.md +99 -0
- package/areas/devops/observability/prompts/onboard-service-monitoring.md +79 -0
- package/areas/devops/observability/rules/alerting-standards.md +36 -0
- package/areas/devops/observability/rules/data-retention.md +19 -0
- package/areas/devops/observability/rules/golden-signals.md +28 -0
- package/areas/devops/observability/skills/distributed-tracing/SKILL.md +149 -0
- package/areas/devops/observability/skills/grafana-dashboards/SKILL.md +201 -0
- package/areas/devops/observability/skills/log-aggregation/SKILL.md +159 -0
- package/areas/devops/observability/skills/prometheus-alertmanager/SKILL.md +188 -0
- package/areas/devops/observability/skills/slo-implementation/SKILL.md +189 -0
- package/areas/devops/observability/workflows/alert-investigation.md +98 -0
- package/areas/devops/observability/workflows/observability-stack-setup.md +156 -0
- package/areas/devops/observability/workflows/onboard-service-monitoring.md +83 -0
- package/areas/devops/sre/AGENTS.md +48 -0
- package/areas/devops/sre/prompts/incident-response.md +129 -0
- package/areas/devops/sre/prompts/postmortem.md +101 -0
- package/areas/devops/sre/prompts/slo-review.md +125 -0
- package/areas/devops/sre/rules/error-budget-policy.md +25 -0
- package/areas/devops/sre/rules/on-call-standards.md +25 -0
- package/areas/devops/sre/rules/slo-policy.md +31 -0
- package/areas/devops/sre/skills/capacity-planning/SKILL.md +162 -0
- package/areas/devops/sre/skills/chaos-engineering/SKILL.md +186 -0
- package/areas/devops/sre/skills/incident-command/SKILL.md +119 -0
- package/areas/devops/sre/skills/postmortem-analysis/SKILL.md +104 -0
- package/areas/devops/sre/skills/slo-sli-design/SKILL.md +145 -0
- package/areas/devops/sre/workflows/incident-response.md +66 -0
- package/areas/devops/sre/workflows/postmortem.md +90 -0
- package/areas/devops/sre/workflows/slo-review.md +95 -0
- package/areas/software/backend/AGENTS.md +59 -0
- package/areas/software/backend/PROMPTS.md +50 -0
- package/areas/software/backend/README.md +48 -0
- package/areas/software/backend/prompts/add-migration.md +93 -0
- package/areas/software/backend/prompts/create-endpoint.md +97 -0
- package/areas/software/backend/prompts/debug-issue.md +87 -0
- package/areas/software/backend/prompts/develop-epic.md +83 -0
- package/areas/software/backend/prompts/develop-feature.md +91 -0
- package/areas/software/backend/prompts/refactor-module.md +79 -0
- package/areas/software/backend/prompts/test-feature.md +89 -0
- package/areas/software/backend/rules/architecture.md +20 -0
- package/areas/software/backend/rules/data_access.md +20 -0
- package/areas/software/backend/rules/security.md +20 -0
- package/areas/software/backend/rules/testing.md +19 -0
- package/areas/software/backend/skills/api-design/SKILL.md +170 -0
- package/areas/software/backend/skills/async-processing/SKILL.md +152 -0
- package/areas/software/backend/skills/database-modeling/SKILL.md +173 -0
- package/areas/software/backend/skills/observability/SKILL.md +162 -0
- package/areas/software/backend/skills/troubleshooting/SKILL.md +139 -0
- package/areas/software/backend/workflows/add-migration.md +79 -0
- package/areas/software/backend/workflows/create-endpoint.md +89 -0
- package/areas/software/backend/workflows/debug-issue.md +77 -0
- package/areas/software/backend/workflows/develop-epic.md +78 -0
- package/areas/software/backend/workflows/develop-feature.md +98 -0
- package/areas/software/backend/workflows/refactor-module.md +73 -0
- package/areas/software/backend/workflows/test-feature.md +67 -0
- package/areas/software/data-engineering/AGENTS.md +59 -0
- package/areas/software/data-engineering/PROMPTS.md +32 -0
- package/areas/software/data-engineering/prompts/backfill-data.md +107 -0
- package/areas/software/data-engineering/prompts/data-quality-incident.md +109 -0
- package/areas/software/data-engineering/prompts/lineage-trace.md +121 -0
- package/areas/software/data-engineering/prompts/new-model.md +117 -0
- package/areas/software/data-engineering/prompts/schema-migration.md +111 -0
- package/areas/software/data-engineering/rules/data-governance.md +11 -0
- package/areas/software/data-engineering/rules/pii-handling.md +19 -0
- package/areas/software/data-engineering/rules/pipeline-integrity.md +11 -0
- package/areas/software/data-engineering/rules/schema-management.md +21 -0
- package/areas/software/data-engineering/skills/data-modeling/SKILL.md +49 -0
- package/areas/software/data-engineering/skills/dbt-patterns/SKILL.md +43 -0
- package/areas/software/data-engineering/skills/lineage-governance/SKILL.md +38 -0
- package/areas/software/data-engineering/skills/orchestration/SKILL.md +35 -0
- package/areas/software/data-engineering/skills/quality-checks/SKILL.md +50 -0
- package/areas/software/data-engineering/skills/sql-optimization/SKILL.md +47 -0
- package/areas/software/data-engineering/skills/streaming-patterns/SKILL.md +48 -0
- package/areas/software/data-engineering/workflows/backfill-data.md +59 -0
- package/areas/software/data-engineering/workflows/data-quality-incident.md +64 -0
- package/areas/software/data-engineering/workflows/lineage-trace.md +56 -0
- package/areas/software/data-engineering/workflows/new-model.md +71 -0
- package/areas/software/data-engineering/workflows/schema-migration.md +67 -0
- package/areas/software/frontend/AGENTS.md +60 -0
- package/areas/software/frontend/PROMPTS.md +32 -0
- package/areas/software/frontend/prompts/a11y-fix.md +75 -0
- package/areas/software/frontend/prompts/bundle-analyze.md +75 -0
- package/areas/software/frontend/prompts/release-prep.md +83 -0
- package/areas/software/frontend/prompts/scaffold-component.md +69 -0
- package/areas/software/frontend/prompts/visual-regression.md +73 -0
- package/areas/software/frontend/rules/accessibility.md +16 -0
- package/areas/software/frontend/rules/architecture.md +29 -0
- package/areas/software/frontend/rules/performance.md +23 -0
- package/areas/software/frontend/rules/quality.md +12 -0
- package/areas/software/frontend/skills/a11y-audit/SKILL.md +61 -0
- package/areas/software/frontend/skills/api-integration/SKILL.md +58 -0
- package/areas/software/frontend/skills/component-design/SKILL.md +171 -0
- package/areas/software/frontend/skills/css-architecture/SKILL.md +146 -0
- package/areas/software/frontend/skills/error-handling/SKILL.md +55 -0
- package/areas/software/frontend/skills/performance-tuning/SKILL.md +58 -0
- package/areas/software/frontend/skills/state-management/SKILL.md +54 -0
- package/areas/software/frontend/skills/testing-patterns/SKILL.md +69 -0
- package/areas/software/frontend/workflows/a11y-fix.md +63 -0
- package/areas/software/frontend/workflows/bundle-analyze.md +56 -0
- package/areas/software/frontend/workflows/release-prep.md +66 -0
- package/areas/software/frontend/workflows/scaffold-component.md +67 -0
- package/areas/software/frontend/workflows/visual-regression.md +65 -0
- package/areas/software/full-stack/AGENTS.md +72 -0
- package/areas/software/full-stack/PROMPTS.md +66 -0
- package/areas/software/full-stack/prompts/backend-project-full-cycle.md +141 -0
- package/areas/software/full-stack/prompts/debug-issue.md +115 -0
- package/areas/software/full-stack/prompts/develop-feature.md +119 -0
- package/areas/software/full-stack/prompts/feature-implementation-flow.md +137 -0
- package/areas/software/full-stack/prompts/testing-ci-pipeline.md +119 -0
- package/areas/software/full-stack/rules/api-design-guide.md +24 -0
- package/areas/software/full-stack/rules/async-concurrency-guide.md +21 -0
- package/areas/software/full-stack/rules/backend-architecture-rule.md +41 -0
- package/areas/software/full-stack/rules/background-jobs-guide.md +20 -0
- package/areas/software/full-stack/rules/code-quality-guide.md +22 -0
- package/areas/software/full-stack/rules/database-access-guide.md +24 -0
- package/areas/software/full-stack/rules/database-migrations-guide.md +24 -0
- package/areas/software/full-stack/rules/domain-models-guide.md +28 -0
- package/areas/software/full-stack/rules/e2e-test-guide.md +18 -0
- package/areas/software/full-stack/rules/env-settings-guide.md +34 -0
- package/areas/software/full-stack/rules/error-handling-guide.md +20 -0
- package/areas/software/full-stack/rules/logging-observability-guide.md +22 -0
- package/areas/software/full-stack/rules/project-guide.md +34 -0
- package/areas/software/full-stack/rules/python-venv-guide.md +23 -0
- package/areas/software/full-stack/rules/security-guide.md +22 -0
- package/areas/software/full-stack/rules/svt-test-guide.md +17 -0
- package/areas/software/full-stack/rules/testing-ci-guide.md +25 -0
- package/areas/software/full-stack/skills/api-design-principles/SKILL.md +125 -0
- package/areas/software/full-stack/skills/api-design-principles/assets/api-design-checklist.md +155 -0
- package/areas/software/full-stack/skills/api-design-principles/assets/rest-api-template.py +182 -0
- package/areas/software/full-stack/skills/api-design-principles/references/graphql-schema-design.md +583 -0
- package/areas/software/full-stack/skills/api-design-principles/references/rest-best-practices.md +408 -0
- package/areas/software/full-stack/skills/api-design-principles/resources/implementation-playbook.md +513 -0
- package/areas/software/full-stack/skills/api-patterns/SKILL.md +81 -0
- package/areas/software/full-stack/skills/api-patterns/api-style.md +42 -0
- package/areas/software/full-stack/skills/api-patterns/auth.md +24 -0
- package/areas/software/full-stack/skills/api-patterns/documentation.md +26 -0
- package/areas/software/full-stack/skills/api-patterns/graphql.md +41 -0
- package/areas/software/full-stack/skills/api-patterns/rate-limiting.md +31 -0
- package/areas/software/full-stack/skills/api-patterns/response.md +37 -0
- package/areas/software/full-stack/skills/api-patterns/rest.md +40 -0
- package/areas/software/full-stack/skills/api-patterns/scripts/api_validator.py +211 -0
- package/areas/software/full-stack/skills/api-patterns/security-testing.md +122 -0
- package/areas/software/full-stack/skills/api-patterns/trpc.md +41 -0
- package/areas/software/full-stack/skills/api-patterns/versioning.md +22 -0
- package/areas/software/full-stack/skills/app-builder/SKILL.md +135 -0
- package/areas/software/full-stack/skills/app-builder/agent-coordination.md +71 -0
- package/areas/software/full-stack/skills/app-builder/feature-building.md +53 -0
- package/areas/software/full-stack/skills/app-builder/project-detection.md +34 -0
- package/areas/software/full-stack/skills/app-builder/scaffolding.md +118 -0
- package/areas/software/full-stack/skills/app-builder/tech-stack.md +40 -0
- package/areas/software/full-stack/skills/app-builder/templates/SKILL.md +39 -0
- package/areas/software/full-stack/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
- package/areas/software/full-stack/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
- package/areas/software/full-stack/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
- package/areas/software/full-stack/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
- package/areas/software/full-stack/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
- package/areas/software/full-stack/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
- package/areas/software/full-stack/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
- package/areas/software/full-stack/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +82 -0
- package/areas/software/full-stack/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +100 -0
- package/areas/software/full-stack/skills/app-builder/templates/nextjs-static/TEMPLATE.md +106 -0
- package/areas/software/full-stack/skills/app-builder/templates/nuxt-app/TEMPLATE.md +101 -0
- package/areas/software/full-stack/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
- package/areas/software/full-stack/skills/app-builder/templates/react-native-app/TEMPLATE.md +93 -0
- package/areas/software/full-stack/skills/backend-developer/SKILL.md +58 -0
- package/areas/software/full-stack/skills/bash-pro/SKILL.md +310 -0
- package/areas/software/full-stack/skills/blackbox-test/SKILL.md +84 -0
- package/areas/software/full-stack/skills/prompt-project-planner/SKILL.md +130 -0
- package/areas/software/full-stack/skills/prompt-project-planner/output.schema.md +68 -0
- package/areas/software/full-stack/skills/prompt-project-planner/questions.md +80 -0
- package/areas/software/full-stack/skills/python-pro/SKILL.md +158 -0
- package/areas/software/full-stack/skills/skill-creator/LICENSE.txt +202 -0
- package/areas/software/full-stack/skills/skill-creator/SKILL.md +356 -0
- package/areas/software/full-stack/skills/skill-creator/references/output-patterns.md +82 -0
- package/areas/software/full-stack/skills/skill-creator/references/workflows.md +28 -0
- package/areas/software/full-stack/skills/skill-creator/scripts/init_skill.py +303 -0
- package/areas/software/full-stack/skills/skill-creator/scripts/package_skill.py +110 -0
- package/areas/software/full-stack/skills/skill-creator/scripts/quick_validate.py +95 -0
- package/areas/software/full-stack/workflows/backend-project-full-cycle.md +132 -0
- package/areas/software/full-stack/workflows/debug-issue.md +70 -0
- package/areas/software/full-stack/workflows/develop-feature.md +85 -0
- package/areas/software/full-stack/workflows/feature-implementation-flow.md +78 -0
- package/areas/software/full-stack/workflows/testing-ci-pipeline.md +65 -0
- package/areas/software/general/AGENTS.md +68 -0
- package/areas/software/general/prompts/code-review-workflow.md +87 -0
- package/areas/software/general/prompts/development-cycle-workflow.md +83 -0
- package/areas/software/general/prompts/project-setup-workflow.md +93 -0
- package/areas/software/general/rules/code-style-guide.md +31 -0
- package/areas/software/general/rules/docker-compose-guide.md +27 -0
- package/areas/software/general/rules/git-workflow-guide.md +27 -0
- package/areas/software/general/rules/github-workflow-guide.md +27 -0
- package/areas/software/general/rules/gitlab-ci-guide.md +27 -0
- package/areas/software/general/rules/lint-format-guide.md +29 -0
- package/areas/software/general/rules/makefile-guide.md +34 -0
- package/areas/software/general/rules/readme-sync-guide.md +40 -0
- package/areas/software/general/rules/sdlc-methodology-guide.md +27 -0
- package/areas/software/general/rules/sdlc-role-responsibilities.md +108 -0
- package/areas/software/general/skills/general-dev-tools/SKILL.md +324 -0
- package/areas/software/general/workflows/code-review-workflow.md +84 -0
- package/areas/software/general/workflows/development-cycle-workflow.md +85 -0
- package/areas/software/general/workflows/project-setup-workflow.md +94 -0
- package/areas/software/mlops/AGENTS.md +57 -0
- package/areas/software/mlops/PROMPTS.md +32 -0
- package/areas/software/mlops/prompts/champion-challenger.md +87 -0
- package/areas/software/mlops/prompts/deploy-endpoint.md +91 -0
- package/areas/software/mlops/prompts/evaluate-model.md +87 -0
- package/areas/software/mlops/prompts/model-incident.md +87 -0
- package/areas/software/mlops/prompts/train-experiment.md +83 -0
- package/areas/software/mlops/rules/data-integrity.md +9 -0
- package/areas/software/mlops/rules/model-governance.md +9 -0
- package/areas/software/mlops/rules/production-safety.md +9 -0
- package/areas/software/mlops/rules/reproducibility.md +9 -0
- package/areas/software/mlops/skills/experiment-tracking/SKILL.md +29 -0
- package/areas/software/mlops/skills/feature-engineering/SKILL.md +44 -0
- package/areas/software/mlops/skills/inference-serving/SKILL.md +35 -0
- package/areas/software/mlops/skills/model-evaluation/SKILL.md +40 -0
- package/areas/software/mlops/skills/model-monitoring/SKILL.md +32 -0
- package/areas/software/mlops/workflows/champion-challenger.md +65 -0
- package/areas/software/mlops/workflows/deploy-endpoint.md +70 -0
- package/areas/software/mlops/workflows/evaluate-model.md +63 -0
- package/areas/software/mlops/workflows/model-incident.md +64 -0
- package/areas/software/mlops/workflows/train-experiment.md +56 -0
- package/areas/software/mobile/AGENTS.md +58 -0
- package/areas/software/mobile/PROMPTS.md +32 -0
- package/areas/software/mobile/prompts/crash-triage.md +63 -0
- package/areas/software/mobile/prompts/device-testing.md +83 -0
- package/areas/software/mobile/prompts/ota-update.md +75 -0
- package/areas/software/mobile/prompts/release-build.md +67 -0
- package/areas/software/mobile/prompts/store-submission.md +79 -0
- package/areas/software/mobile/rules/offline-first.md +10 -0
- package/areas/software/mobile/rules/performance-budget.md +20 -0
- package/areas/software/mobile/rules/platform-compliance.md +17 -0
- package/areas/software/mobile/rules/security-mobile.md +9 -0
- package/areas/software/mobile/skills/app-store-prep/SKILL.md +27 -0
- package/areas/software/mobile/skills/mobile-testing/SKILL.md +36 -0
- package/areas/software/mobile/skills/native-modules/SKILL.md +38 -0
- package/areas/software/mobile/skills/navigation-patterns/SKILL.md +49 -0
- package/areas/software/mobile/skills/push-notifications/SKILL.md +40 -0
- package/areas/software/mobile/skills/state-sync/SKILL.md +48 -0
- package/areas/software/mobile/workflows/crash-triage.md +63 -0
- package/areas/software/mobile/workflows/device-testing.md +54 -0
- package/areas/software/mobile/workflows/ota-update.md +54 -0
- package/areas/software/mobile/workflows/release-build.md +67 -0
- package/areas/software/mobile/workflows/store-submission.md +63 -0
- package/areas/software/platform/AGENTS.md +67 -0
- package/areas/software/platform/PROMPTS.md +32 -0
- package/areas/software/platform/prompts/cost-audit.md +117 -0
- package/areas/software/platform/prompts/deploy-production.md +109 -0
- package/areas/software/platform/prompts/drift-check.md +107 -0
- package/areas/software/platform/prompts/incident-response.md +121 -0
- package/areas/software/platform/prompts/provision-env.md +113 -0
- package/areas/software/platform/rules/cost-governance.md +11 -0
- package/areas/software/platform/rules/immutability.md +17 -0
- package/areas/software/platform/rules/reliability.md +19 -0
- package/areas/software/platform/rules/security-posture.md +12 -0
- package/areas/software/platform/skills/ci-cd-pipelines/SKILL.md +58 -0
- package/areas/software/platform/skills/incident-response/SKILL.md +41 -0
- package/areas/software/platform/skills/k8s-manifests/SKILL.md +56 -0
- package/areas/software/platform/skills/networking/SKILL.md +44 -0
- package/areas/software/platform/skills/observability-setup/SKILL.md +49 -0
- package/areas/software/platform/skills/secrets-management/SKILL.md +43 -0
- package/areas/software/platform/skills/terraform-patterns/SKILL.md +75 -0
- package/areas/software/platform/workflows/cost-audit.md +61 -0
- package/areas/software/platform/workflows/deploy-production.md +67 -0
- package/areas/software/platform/workflows/drift-check.md +61 -0
- package/areas/software/platform/workflows/incident-response.md +69 -0
- package/areas/software/platform/workflows/provision-env.md +77 -0
- package/areas/software/qa/AGENTS.md +58 -0
- package/areas/software/qa/PROMPTS.md +32 -0
- package/areas/software/qa/prompts/flakiness-investigation.md +61 -0
- package/areas/software/qa/prompts/performance-audit.md +65 -0
- package/areas/software/qa/prompts/regression-suite.md +61 -0
- package/areas/software/qa/prompts/smoke-test.md +65 -0
- package/areas/software/qa/prompts/test-coverage-report.md +61 -0
- package/areas/software/qa/rules/flakiness-policy.md +12 -0
- package/areas/software/qa/rules/quality-gates.md +28 -0
- package/areas/software/qa/rules/test-data.md +9 -0
- package/areas/software/qa/rules/test-strategy.md +11 -0
- package/areas/software/qa/skills/accessibility-testing/SKILL.md +139 -0
- package/areas/software/qa/skills/api-testing/SKILL.md +140 -0
- package/areas/software/qa/skills/e2e-patterns/SKILL.md +152 -0
- package/areas/software/qa/skills/performance-testing/SKILL.md +177 -0
- package/areas/software/qa/skills/test-data-management/SKILL.md +161 -0
- package/areas/software/qa/skills/test-pyramid/SKILL.md +127 -0
- package/areas/software/qa/workflows/flakiness-investigation.md +63 -0
- package/areas/software/qa/workflows/performance-audit.md +59 -0
- package/areas/software/qa/workflows/regression-suite.md +59 -0
- package/areas/software/qa/workflows/smoke-test.md +64 -0
- package/areas/software/qa/workflows/test-coverage-report.md +57 -0
- package/areas/software/security/AGENTS.md +58 -0
- package/areas/software/security/PROMPTS.md +32 -0
- package/areas/software/security/prompts/compliance-report.md +113 -0
- package/areas/software/security/prompts/pen-test-sim.md +113 -0
- package/areas/software/security/prompts/secret-rotation.md +115 -0
- package/areas/software/security/prompts/security-scan.md +91 -0
- package/areas/software/security/prompts/threat-model-review.md +105 -0
- package/areas/software/security/rules/compliance-baseline.md +23 -0
- package/areas/software/security/rules/dependency-policy.md +12 -0
- package/areas/software/security/rules/secrets-policy.md +22 -0
- package/areas/software/security/rules/secure-coding.md +22 -0
- package/areas/software/security/skills/auth-patterns/SKILL.md +42 -0
- package/areas/software/security/skills/crypto-standards/SKILL.md +42 -0
- package/areas/software/security/skills/dependency-audit/SKILL.md +29 -0
- package/areas/software/security/skills/sast-dast-interpretation/SKILL.md +33 -0
- package/areas/software/security/skills/security-headers/SKILL.md +29 -0
- package/areas/software/security/skills/threat-modeling/SKILL.md +36 -0
- package/areas/software/security/workflows/compliance-report.md +57 -0
- package/areas/software/security/workflows/pen-test-sim.md +63 -0
- package/areas/software/security/workflows/secret-rotation.md +67 -0
- package/areas/software/security/workflows/security-scan.md +64 -0
- package/areas/software/security/workflows/threat-model-review.md +62 -0
- package/areas/template/AGENTS-area.tmpl.md +61 -0
- package/areas/template/AGENTS.tmpl.md +67 -0
- package/areas/template/GUIDE.md +102 -0
- package/areas/template/PROMPTS.tmpl.md +29 -0
- package/areas/template/README.md +57 -0
- package/areas/template/README.tmpl.md +51 -0
- package/areas/template/prompt.tmpl.md +101 -0
- package/areas/template/rule.tmpl.md +71 -0
- package/areas/template/skill.tmpl.md +108 -0
- package/areas/template/workflow.tmpl.md +104 -0
- package/bin/agentic.js +24 -0
- package/extensions/antigravity/GEMINI.md +10 -0
- package/extensions/claude/CLAUDE.md +10 -0
- package/extensions/codex/AGENTS.override.md +93 -0
- package/extensions/gemini/GEMINI.md +10 -0
- package/extensions/opencode/agents/designer.md +65 -0
- package/extensions/opencode/agents/developer.md +63 -0
- package/extensions/opencode/agents/devops-engineer.md +69 -0
- package/extensions/opencode/agents/pm.md +61 -0
- package/extensions/opencode/agents/product-owner.md +76 -0
- package/extensions/opencode/agents/qa.md +66 -0
- package/extensions/opencode/agents/team-lead.md +67 -0
- package/extensions/opencode/commands/feature.md +75 -0
- package/extensions/opencode/opencode.json +93 -0
- package/extensions/opencode/plugins/model-checker.json +14 -0
- package/extensions/opencode/plugins/model-checker.ts +279 -0
- package/extensions/opencode/plugins/sound-notification.ts +13 -0
- package/extensions/opencode/plugins/telegram-notification.ts +86 -0
- package/extensions/opencode/skills/code_review_expert/SKILL.md +144 -0
- package/extensions/opencode/skills/design_expert/SKILL.md +42 -0
- package/extensions/opencode/skills/qa_expert/SKILL.md +116 -0
- package/package.json +19 -0
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: code-review-workflow
|
|
3
|
+
type: workflow
|
|
4
|
+
trigger: /code-review-workflow
|
|
5
|
+
description: Conduct a structured, constructive code review of a pull or merge request.
|
|
6
|
+
inputs:
|
|
7
|
+
- pull_request_or_merge_request
|
|
8
|
+
- codebase_context
|
|
9
|
+
outputs:
|
|
10
|
+
- review_comments
|
|
11
|
+
- approval_or_change_requests
|
|
12
|
+
roles:
|
|
13
|
+
- team-lead
|
|
14
|
+
- developer
|
|
15
|
+
- qa
|
|
16
|
+
execution:
|
|
17
|
+
initiator: developer
|
|
18
|
+
related-rules:
|
|
19
|
+
- code-style-guide.md
|
|
20
|
+
- git-workflow-guide.md
|
|
21
|
+
- sdlc-methodology-guide.md
|
|
22
|
+
uses-skills:
|
|
23
|
+
- general-dev-tools
|
|
24
|
+
quality-gates:
|
|
25
|
+
- CI pipeline passes before manual review begins
|
|
26
|
+
- all blocking comments resolved before approval
|
|
27
|
+
- no secrets or credentials in diff
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Steps
|
|
31
|
+
|
|
32
|
+
### 1. Automated Pre-check — `@developer` (author)
|
|
33
|
+
- **Input:** feature branch with changes
|
|
34
|
+
- **Actions:** confirm CI passes (lint / tests / build); no merge conflicts; branch up to date with target
|
|
35
|
+
- **Output:** CI-green PR
|
|
36
|
+
- **Done when:** automated checks pass — only then request review
|
|
37
|
+
|
|
38
|
+
### 2. Context Understanding — `@team-lead`
|
|
39
|
+
- **Input:** PR description and linked issue/task
|
|
40
|
+
- **Actions:** read PR description and linked ticket; check scope focus; if diff > 400 lines of logic — request splitting the PR
|
|
41
|
+
- **Output:** decision to proceed or split
|
|
42
|
+
- **Done when:** reviewer understands the intent and scope is acceptable
|
|
43
|
+
|
|
44
|
+
### 3. Code Review — `@team-lead` + `@qa`
|
|
45
|
+
- **Input:** PR diff + context
|
|
46
|
+
- **Actions — Correctness:**
|
|
47
|
+
- Does the code do what the ticket describes?
|
|
48
|
+
- Are edge cases and error paths handled?
|
|
49
|
+
- **Actions — Design & Architecture:**
|
|
50
|
+
- Does the change follow existing codebase patterns?
|
|
51
|
+
- No unnecessary complexity or over-engineering?
|
|
52
|
+
- Abstractions at the right level?
|
|
53
|
+
- **Actions — Code Quality:**
|
|
54
|
+
- Names are clear and intention-revealing?
|
|
55
|
+
- No duplicated logic that could be extracted?
|
|
56
|
+
- No magic numbers or strings?
|
|
57
|
+
- **Actions — Tests:**
|
|
58
|
+
- New behaviors covered by tests?
|
|
59
|
+
- Tests assert meaningful behavior, not implementation details?
|
|
60
|
+
- Edge cases tested?
|
|
61
|
+
- **Actions — Security:**
|
|
62
|
+
- No secrets or credentials committed
|
|
63
|
+
- User input validated/sanitized
|
|
64
|
+
- Permissions and access control respected
|
|
65
|
+
- **Output:** review comments with blocking / non-blocking labels; at least one positive comment
|
|
66
|
+
- **Done when:** all review dimensions checked
|
|
67
|
+
|
|
68
|
+
### 4. Feedback Resolution — `@developer`
|
|
69
|
+
- **Input:** review comments
|
|
70
|
+
- **Actions:** address all blocking comments; push fixes as new commits (no force-push during review); re-request review
|
|
71
|
+
- **Output:** updated PR
|
|
72
|
+
- **Done when:** no open blocking comments
|
|
73
|
+
|
|
74
|
+
### 5. Approval & Merge — `@team-lead`
|
|
75
|
+
- **Input:** resolved PR
|
|
76
|
+
- **Actions:** re-check fixes; approve; author squashes or rebases per project convention; merge; delete feature branch
|
|
77
|
+
- **Output:** merged PR; branch deleted
|
|
78
|
+
- **Done when:** change merged and feature branch removed
|
|
79
|
+
|
|
80
|
+
## Iteration Loop
|
|
81
|
+
If fixes introduce new issues → reviewer re-raises blocking comments; loop repeats until clean.
|
|
82
|
+
|
|
83
|
+
## Exit
|
|
84
|
+
Approved and merged PR = review complete.
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: development-cycle-workflow
|
|
3
|
+
type: workflow
|
|
4
|
+
trigger: /development-cycle-workflow
|
|
5
|
+
description: Implement any development task from ticket to merged code.
|
|
6
|
+
inputs:
|
|
7
|
+
- task_or_issue_description
|
|
8
|
+
- existing_codebase
|
|
9
|
+
outputs:
|
|
10
|
+
- implemented_changes
|
|
11
|
+
- passing_tests
|
|
12
|
+
- merged_pull_request
|
|
13
|
+
roles:
|
|
14
|
+
- product-owner
|
|
15
|
+
- pm
|
|
16
|
+
- team-lead
|
|
17
|
+
- developer
|
|
18
|
+
- qa
|
|
19
|
+
execution:
|
|
20
|
+
initiator: product-owner
|
|
21
|
+
related-rules:
|
|
22
|
+
- git-workflow-guide.md
|
|
23
|
+
- sdlc-methodology-guide.md
|
|
24
|
+
- code-style-guide.md
|
|
25
|
+
- lint-format-guide.md
|
|
26
|
+
uses-skills:
|
|
27
|
+
- general-dev-tools
|
|
28
|
+
quality-gates:
|
|
29
|
+
- acceptance criteria confirmed before implementation starts
|
|
30
|
+
- all checks pass (lint / test / build)
|
|
31
|
+
- PR reviewed and approved
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## Steps
|
|
35
|
+
|
|
36
|
+
### 1. Requirements Framing — `@product-owner` + `@pm`
|
|
37
|
+
- **Input:** task or issue description
|
|
38
|
+
- **Actions:** define acceptance criteria; clarify scope and non-goals; if larger than 1 day of work — break into sub-tasks
|
|
39
|
+
- **Output:** confirmed acceptance criteria added to the ticket
|
|
40
|
+
- **Done when:** criteria are testable and agreed upon
|
|
41
|
+
|
|
42
|
+
### 2. Technical Design — `@team-lead`
|
|
43
|
+
- **Input:** confirmed acceptance criteria
|
|
44
|
+
- **Actions:** identify impacted code areas; flag architectural risks; approve approach or request changes
|
|
45
|
+
- **Output:** brief design note (inline comment or `docs/<task>/notes.md` for significant changes)
|
|
46
|
+
- **Done when:** implementation approach is unambiguous
|
|
47
|
+
|
|
48
|
+
### 3. Implementation — `@developer`
|
|
49
|
+
- **Input:** confirmed acceptance criteria + design note
|
|
50
|
+
- **Actions:**
|
|
51
|
+
- pull latest `main`, create branch: `git checkout -b feature/<task-id>-short-desc`
|
|
52
|
+
- implement in small logical commits; follow code style rules
|
|
53
|
+
- run `make fmt` after each logical change
|
|
54
|
+
- do not mix unrelated changes in the same branch
|
|
55
|
+
- **Output:** code changes on feature branch
|
|
56
|
+
- **Done when:** implementation covers all acceptance criteria
|
|
57
|
+
|
|
58
|
+
### 4. Verification — `@developer` → `@qa`
|
|
59
|
+
- **Input:** code changes on branch
|
|
60
|
+
- **Actions:**
|
|
61
|
+
- `make test` — all tests pass
|
|
62
|
+
- `make lint` — zero errors
|
|
63
|
+
- `make fmt` — no diffs
|
|
64
|
+
- add or update tests for any new behavior
|
|
65
|
+
- `@qa` runs exploratory checks against acceptance criteria
|
|
66
|
+
- **Output:** green local checks; test evidence attached to PR
|
|
67
|
+
- **Done when:** no failing checks; acceptance criteria manually verified
|
|
68
|
+
|
|
69
|
+
### 5. Pull Request — `@developer`
|
|
70
|
+
- **Input:** green checks, test evidence
|
|
71
|
+
- **Actions:** open PR with title `[TASK-ID] Short description`; body includes what changed, why, how to test, screenshots if UI; assign reviewer; CI must pass before review
|
|
72
|
+
- **Output:** open PR with passing CI
|
|
73
|
+
- **Done when:** PR is open and CI is green
|
|
74
|
+
|
|
75
|
+
### 6. Review & Merge — `@team-lead` (coordinated by `@pm`)
|
|
76
|
+
- **Input:** open PR
|
|
77
|
+
- **Actions:** `@team-lead` reviews code quality, architecture, and tests; `@developer` addresses all blocking comments; squash or rebase per project convention; merge; delete feature branch
|
|
78
|
+
- **Output:** merged PR; feature branch deleted
|
|
79
|
+
- **Done when:** PR is merged and change is verified in staging/preview
|
|
80
|
+
|
|
81
|
+
## Iteration Loop
|
|
82
|
+
If verification (Step 4) or review (Step 6) reveals gaps → return to Step 3. `@pm` tracks blockers and timeline.
|
|
83
|
+
|
|
84
|
+
## Exit
|
|
85
|
+
Merged PR + acceptance criteria validated in staging = task complete.
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: project-setup-workflow
|
|
3
|
+
type: workflow
|
|
4
|
+
trigger: /project-setup-workflow
|
|
5
|
+
description: Bootstrap a new software project with tooling, CI, and documentation from day one.
|
|
6
|
+
inputs:
|
|
7
|
+
- project_name
|
|
8
|
+
- language_or_framework
|
|
9
|
+
- target_platform
|
|
10
|
+
outputs:
|
|
11
|
+
- initialized_repository
|
|
12
|
+
- ci_pipeline_configured
|
|
13
|
+
- readme_and_docs
|
|
14
|
+
roles:
|
|
15
|
+
- product-owner
|
|
16
|
+
- pm
|
|
17
|
+
- team-lead
|
|
18
|
+
- developer
|
|
19
|
+
- qa
|
|
20
|
+
execution:
|
|
21
|
+
initiator: product-owner
|
|
22
|
+
related-rules:
|
|
23
|
+
- git-workflow-guide.md
|
|
24
|
+
- makefile-guide.md
|
|
25
|
+
- docker-compose-guide.md
|
|
26
|
+
- lint-format-guide.md
|
|
27
|
+
uses-skills:
|
|
28
|
+
- general-dev-tools
|
|
29
|
+
quality-gates:
|
|
30
|
+
- CI pipeline passes on first commit
|
|
31
|
+
- make install && make dev works on a clean machine
|
|
32
|
+
- pre-commit hooks installed and passing
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## Steps
|
|
36
|
+
|
|
37
|
+
### 1. Scope & Decisions — `@product-owner` + `@pm`
|
|
38
|
+
- **Input:** project name, purpose, team constraints
|
|
39
|
+
- **Actions:** confirm language/framework/platform; define team conventions (branch model, merge strategy); confirm initial milestone
|
|
40
|
+
- **Output:** brief project charter note (README draft or ADR-0)
|
|
41
|
+
- **Done when:** tech stack and conventions agreed upon
|
|
42
|
+
|
|
43
|
+
### 2. Repository Setup — `@team-lead` + `@developer`
|
|
44
|
+
- **Input:** project charter note
|
|
45
|
+
- **Actions:**
|
|
46
|
+
- create repo on GitHub/GitLab with meaningful name and description
|
|
47
|
+
- set up branch protection on `main` (require CI + review)
|
|
48
|
+
- add `.gitignore` for the language/framework
|
|
49
|
+
- add `README.md` with: description, prerequisites, quick start (`make install && make dev`), CI badge
|
|
50
|
+
- **Output:** initialized repository with branch protection
|
|
51
|
+
- **Done when:** repo accessible, branch protection active
|
|
52
|
+
|
|
53
|
+
### 3. Development Environment — `@developer`
|
|
54
|
+
- **Input:** initialized repository
|
|
55
|
+
- **Actions:**
|
|
56
|
+
- create `Makefile` with targets: `install`, `dev`, `test`, `lint`, `fmt`, `clean`, `help`
|
|
57
|
+
- if multi-service: create `docker-compose.yml` with health checks and `.env.example`
|
|
58
|
+
- configure language toolchain (venv, node_modules, go modules, etc.)
|
|
59
|
+
- add `.editorconfig` for consistent whitespace
|
|
60
|
+
- **Output:** working local dev environment
|
|
61
|
+
- **Done when:** `make install && make dev` succeeds on a clean machine
|
|
62
|
+
|
|
63
|
+
### 4. Code Quality Tooling — `@developer`
|
|
64
|
+
- **Input:** working dev environment
|
|
65
|
+
- **Actions:**
|
|
66
|
+
- add linter config (`.eslintrc`, `pyproject.toml [tool.ruff]`, `.golangci.yml`, etc.)
|
|
67
|
+
- add formatter config (`prettier`, `black`, etc.)
|
|
68
|
+
- configure `pre-commit` with at minimum: trailing-whitespace, end-of-file-fixer, check-yaml
|
|
69
|
+
- run `pre-commit install` and `pre-commit run --all-files` — fix any issues
|
|
70
|
+
- **Output:** linter + formatter + pre-commit hooks configured and passing
|
|
71
|
+
- **Done when:** `make lint` and `make fmt` exit clean on the initial codebase
|
|
72
|
+
|
|
73
|
+
### 5. CI Pipeline — `@developer` + `@team-lead`
|
|
74
|
+
- **Input:** quality tooling configured
|
|
75
|
+
- **Actions:**
|
|
76
|
+
- create CI config (`.github/workflows/ci.yml` or `.gitlab-ci.yml`)
|
|
77
|
+
- pipeline runs: lint → test → build on every PR
|
|
78
|
+
- set branch protection to require passing CI before merge
|
|
79
|
+
- add CI status badge to README
|
|
80
|
+
- **Output:** CI pipeline running on the repo
|
|
81
|
+
- **Done when:** CI passes on `main`
|
|
82
|
+
|
|
83
|
+
### 6. First Commit & Validation — `@developer` + `@qa`
|
|
84
|
+
- **Input:** all tooling configured
|
|
85
|
+
- **Actions:**
|
|
86
|
+
- `git add -A && git commit -m "chore: initial project setup"`
|
|
87
|
+
- push and verify CI passes on default branch
|
|
88
|
+
- `@qa` validates: clean install on a second machine, CI badge green, `make test` passes
|
|
89
|
+
- create first `CHANGELOG.md` entry: `## [Unreleased]`
|
|
90
|
+
- **Output:** green CI on first commit; validated by QA
|
|
91
|
+
- **Done when:** CI green, QA confirms setup is reproducible
|
|
92
|
+
|
|
93
|
+
## Exit
|
|
94
|
+
Green CI + QA sign-off = project is ready for first feature development.
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# MLOps — guidance index
|
|
2
|
+
|
|
3
|
+
## What this area covers
|
|
4
|
+
|
|
5
|
+
Machine learning operations: experiment tracking, model training pipelines, feature engineering, model evaluation, champion/challenger workflows, inference serving, model monitoring, and production safety gates. MLOps treats models as software artifacts with the same reproducibility and observability requirements as any production service.
|
|
6
|
+
|
|
7
|
+
## Guidance chain
|
|
8
|
+
|
|
9
|
+
1. Project `.agent/` baseline (`AGENTS.md` + `.agent/*`)
|
|
10
|
+
2. `software/general/rules/*` — always active
|
|
11
|
+
3. `mlops/rules/*` — load all for this spec
|
|
12
|
+
4. `mlops/skills/*/SKILL.md` — load only the skill matching the current task
|
|
13
|
+
5. `mlops/workflows/*` — load the workflow matching the triggered command
|
|
14
|
+
|
|
15
|
+
## Inherited from general
|
|
16
|
+
|
|
17
|
+
- SDLC methodology and handoff contracts
|
|
18
|
+
- Git / CI / lint and code style baselines
|
|
19
|
+
|
|
20
|
+
## MLOps-specific constraints
|
|
21
|
+
|
|
22
|
+
- Every experiment is reproducible: fixed random seed, pinned dependency versions, logged hyperparameters.
|
|
23
|
+
- No model promotes to production without a documented evaluation report and a champion/challenger comparison.
|
|
24
|
+
- Production models emit prediction latency, throughput, and data drift metrics — no silent inference.
|
|
25
|
+
- Training data containing PII is governed under `data-engineering/rules/pii-handling.md` at all times.
|
|
26
|
+
|
|
27
|
+
## Spec map
|
|
28
|
+
|
|
29
|
+
```text
|
|
30
|
+
mlops/
|
|
31
|
+
├── rules/
|
|
32
|
+
│ ├── reproducibility.md ← seed pinning, dependency locking, artifact versioning
|
|
33
|
+
│ ├── data-integrity.md ← training data lineage, validation, split discipline
|
|
34
|
+
│ ├── model-governance.md ← approval gates, versioning, rollback policy
|
|
35
|
+
│ └── production-safety.md ← shadow mode, canary traffic, kill switch requirements
|
|
36
|
+
├── skills/
|
|
37
|
+
│ ├── experiment-tracking/SKILL.md ← MLflow, W&B, run comparison, artifact logging
|
|
38
|
+
│ ├── feature-engineering/SKILL.md ← feature stores, transformation pipelines, leakage prevention
|
|
39
|
+
│ ├── model-evaluation/SKILL.md ← metric selection, fairness checks, threshold calibration
|
|
40
|
+
│ ├── inference-serving/SKILL.md ← online/batch serving, latency budgets, model registries
|
|
41
|
+
│ └── model-monitoring/SKILL.md ← data drift, prediction drift, retraining triggers
|
|
42
|
+
├── workflows/
|
|
43
|
+
│ ├── train-experiment.md ← /train-experiment
|
|
44
|
+
│ ├── evaluate-model.md ← /evaluate-model
|
|
45
|
+
│ ├── champion-challenger.md ← /champion-challenger
|
|
46
|
+
│ ├── deploy-endpoint.md ← /deploy-endpoint
|
|
47
|
+
│ └── model-incident.md ← /model-incident
|
|
48
|
+
└── prompts/
|
|
49
|
+
└── *.md
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## Discovery patterns
|
|
53
|
+
|
|
54
|
+
- `rules/*.md`
|
|
55
|
+
- `skills/*/SKILL.md`
|
|
56
|
+
- `workflows/*.md`
|
|
57
|
+
- `prompts/*.md`
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# PROMPTS: mlops
|
|
2
|
+
|
|
3
|
+
Use these prompts with `AGENTS.md` from the same directory.
|
|
4
|
+
|
|
5
|
+
## 1) Initialize agent behavior
|
|
6
|
+
|
|
7
|
+
```text
|
|
8
|
+
Read `mlops/AGENTS.md` and adopt its rules, skills loading strategy, and workflows as hard constraints.
|
|
9
|
+
List the active rules and the selected workflow before implementation.
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## 2) Implement a feature
|
|
13
|
+
|
|
14
|
+
```text
|
|
15
|
+
Using `mlops/AGENTS.md`, implement: <feature description>.
|
|
16
|
+
Before coding: provide architecture notes, risk list, and test plan.
|
|
17
|
+
After coding: run checks and report exact commands and results.
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
## 3) Incident / debug mode
|
|
21
|
+
|
|
22
|
+
```text
|
|
23
|
+
Using `mlops/AGENTS.md`, run incident triage for: <incident summary>.
|
|
24
|
+
Return root cause hypotheses, validation steps, fix plan, and rollback plan.
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## 4) Release readiness
|
|
28
|
+
|
|
29
|
+
```text
|
|
30
|
+
Using `mlops/AGENTS.md`, prepare release checklist for: <release scope>.
|
|
31
|
+
Include quality gates, security gates, performance gates, and deployment validation.
|
|
32
|
+
```
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
---
|
|
2
|
+
workflow: champion-challenger
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Prompt: `/champion-challenger`
|
|
6
|
+
|
|
7
|
+
Use when: running a controlled champion-vs-challenger model experiment with statistical significance and rollback guardrails.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## Example 1 — Credit risk model challenger rollout
|
|
12
|
+
|
|
13
|
+
**EN:**
|
|
14
|
+
```
|
|
15
|
+
/champion-challenger
|
|
16
|
+
|
|
17
|
+
Champion model: credit-risk-xgb-v14 (Production in registry)
|
|
18
|
+
Challenger model: credit-risk-xgb-v15 (candidate from MLflow run 5d8a9f2)
|
|
19
|
+
Experiment duration: 14 days or until 2.5M scored applications
|
|
20
|
+
Primary metric: approved-loan default rate after policy thresholding
|
|
21
|
+
Guardrails:
|
|
22
|
+
- online latency p99 < 180ms
|
|
23
|
+
- application scoring error rate < 0.2%
|
|
24
|
+
- fairness disparity by age_group and region <= 0.08
|
|
25
|
+
Traffic split: 50% champion / 50% challenger by hashed applicant_id
|
|
26
|
+
Decision rules:
|
|
27
|
+
- promote only if default rate improves by at least 1.5% relative and p-value < 0.05
|
|
28
|
+
- auto-rollback if latency or fairness guardrail breaches for 30 min
|
|
29
|
+
Output: experiment design, sample-size calculation, daily monitoring plan, and final promotion decision template
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
**RU:**
|
|
33
|
+
```
|
|
34
|
+
/champion-challenger
|
|
35
|
+
|
|
36
|
+
Champion model: credit-risk-xgb-v14 (Production в registry)
|
|
37
|
+
Challenger model: credit-risk-xgb-v15 (кандидат из MLflow run 5d8a9f2)
|
|
38
|
+
Длительность эксперимента: 14 дней или до 2.5M скорингованных заявок
|
|
39
|
+
Основная метрика: default rate по одобренным займам после применения policy threshold
|
|
40
|
+
Guardrails:
|
|
41
|
+
- online latency p99 < 180ms
|
|
42
|
+
- error rate скоринга заявок < 0.2%
|
|
43
|
+
- fairness disparity по age_group и region <= 0.08
|
|
44
|
+
Разделение трафика: 50% champion / 50% challenger по hashed applicant_id
|
|
45
|
+
Правила решения:
|
|
46
|
+
- продвигать только если default rate улучшается минимум на 1.5% относительно и p-value < 0.05
|
|
47
|
+
- auto-rollback если latency или fairness guardrail нарушается 30 минут подряд
|
|
48
|
+
Результат: дизайн эксперимента, расчёт sample size, ежедневный план мониторинга и шаблон финального решения о promotion
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## Example 2 — Search ranking experiment with segment safety
|
|
54
|
+
|
|
55
|
+
**EN:**
|
|
56
|
+
```
|
|
57
|
+
/champion-challenger
|
|
58
|
+
|
|
59
|
+
Champion model: search-ranker-bert-v8
|
|
60
|
+
Challenger model: search-ranker-bert-v9-distilled
|
|
61
|
+
Experiment duration: 7 days during normal traffic period (exclude Black Friday campaign week)
|
|
62
|
+
Primary metric: click-through rate on top-5 search results
|
|
63
|
+
Secondary metrics:
|
|
64
|
+
- add-to-cart rate from search sessions
|
|
65
|
+
- zero-result session rate
|
|
66
|
+
- median inference cost per 1k requests
|
|
67
|
+
Segments that must not regress: mobile web, long-tail queries, German locale
|
|
68
|
+
Rollback policy: if challenger harms any protected segment by > 2% relative CTR for 24h, revert all traffic to champion
|
|
69
|
+
Output: experiment assignment strategy, segment analysis requirements, and final report structure for registry and product stakeholders
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
**RU:**
|
|
73
|
+
```
|
|
74
|
+
/champion-challenger
|
|
75
|
+
|
|
76
|
+
Champion model: search-ranker-bert-v8
|
|
77
|
+
Challenger model: search-ranker-bert-v9-distilled
|
|
78
|
+
Длительность эксперимента: 7 дней в период обычного трафика (исключая неделю кампании Black Friday)
|
|
79
|
+
Основная метрика: click-through rate по top-5 результатам поиска
|
|
80
|
+
Вторичные метрики:
|
|
81
|
+
- add-to-cart rate из search sessions
|
|
82
|
+
- zero-result session rate
|
|
83
|
+
- median inference cost на 1k запросов
|
|
84
|
+
Сегменты, которые не должны деградировать: mobile web, long-tail queries, немецкая локаль
|
|
85
|
+
Политика отката: если challenger ухудшает любой защищённый сегмент более чем на 2% относительного CTR в течение 24ч, вернуть весь трафик champion'у
|
|
86
|
+
Результат: стратегия назначения эксперимента, требования к segment analysis и структура финального отчёта для registry и продуктовых стейкхолдеров
|
|
87
|
+
```
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
---
|
|
2
|
+
workflow: deploy-endpoint
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Prompt: `/deploy-endpoint`
|
|
6
|
+
|
|
7
|
+
Use when: deploying a model endpoint through shadow, canary, and full rollout with explicit rollback thresholds.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## Example 1 — Deploy new fraud model with shadow and canary
|
|
12
|
+
|
|
13
|
+
**EN:**
|
|
14
|
+
```
|
|
15
|
+
/deploy-endpoint
|
|
16
|
+
|
|
17
|
+
Model name: fraud-detection-xgb
|
|
18
|
+
Run ID: mlflow://fraud-prod/4f2d71b9
|
|
19
|
+
Deployment strategy: shadow -> canary -> full rollout
|
|
20
|
+
Preconditions:
|
|
21
|
+
- /evaluate-model scorecard recommendation = PROMOTE
|
|
22
|
+
- model registry approval recorded by risk lead
|
|
23
|
+
- current production endpoint fraud-score-v12 healthy for last 7 days
|
|
24
|
+
Traffic plan:
|
|
25
|
+
- shadow for 48h with 100% mirrored requests, no user-visible responses from challenger
|
|
26
|
+
- canary 5% -> 20% -> 50% -> 100% if latency p99 < 120ms and error rate < 0.5%
|
|
27
|
+
Monitoring:
|
|
28
|
+
- compare prediction distribution vs champion
|
|
29
|
+
- alert on PSI > 0.2 for any top-10 feature
|
|
30
|
+
- auto-rollback on SLO breach or schema mismatch in payloads
|
|
31
|
+
Output: deployment plan, rollout checkpoints, rollback commands, and post-deploy monitoring checklist
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
**RU:**
|
|
35
|
+
```
|
|
36
|
+
/deploy-endpoint
|
|
37
|
+
|
|
38
|
+
Model name: fraud-detection-xgb
|
|
39
|
+
Run ID: mlflow://fraud-prod/4f2d71b9
|
|
40
|
+
Стратегия деплоя: shadow -> canary -> full rollout
|
|
41
|
+
Предусловия:
|
|
42
|
+
- рекомендация в scorecard от /evaluate-model = PROMOTE
|
|
43
|
+
- approval в model registry зафиксирован risk lead
|
|
44
|
+
- текущий production endpoint fraud-score-v12 здоров последние 7 дней
|
|
45
|
+
План трафика:
|
|
46
|
+
- shadow 48ч со 100% зеркалированием запросов, без user-visible ответов от challenger
|
|
47
|
+
- canary 5% -> 20% -> 50% -> 100% если latency p99 < 120ms и error rate < 0.5%
|
|
48
|
+
Мониторинг:
|
|
49
|
+
- сравнивать распределение предсказаний vs champion
|
|
50
|
+
- алерт при PSI > 0.2 для любого из top-10 признаков
|
|
51
|
+
- auto-rollback при нарушении SLO или schema mismatch в payload'ах
|
|
52
|
+
Результат: план деплоя, rollout checkpoints, rollback commands и чеклист post-deploy мониторинга
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## Example 2 — Emergency redeploy after endpoint infrastructure drift
|
|
58
|
+
|
|
59
|
+
**EN:**
|
|
60
|
+
```
|
|
61
|
+
/deploy-endpoint
|
|
62
|
+
|
|
63
|
+
Model name: recommendations-transformer
|
|
64
|
+
Run ID: mlflow://reco-prod/9a17cb21
|
|
65
|
+
Deployment strategy: canary only (skip shadow because the same artifact was already shadow-tested last week)
|
|
66
|
+
Context:
|
|
67
|
+
- current live endpoint lost autoscaling configuration during cluster migration
|
|
68
|
+
- no model change, but serving container and HPA manifests must be re-applied safely
|
|
69
|
+
Success criteria:
|
|
70
|
+
- 100% traffic restored on the same model artifact
|
|
71
|
+
- canary stages complete without error rate increase above 0.2%
|
|
72
|
+
- dashboards updated with new pod labels and endpoint version tags
|
|
73
|
+
Output: infrastructure validation checklist, canary plan, and evidence that registry state still points to the same Production artifact
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
**RU:**
|
|
77
|
+
```
|
|
78
|
+
/deploy-endpoint
|
|
79
|
+
|
|
80
|
+
Model name: recommendations-transformer
|
|
81
|
+
Run ID: mlflow://reco-prod/9a17cb21
|
|
82
|
+
Стратегия деплоя: только canary (без shadow, потому что тот же артефакт уже проходил shadow на прошлой неделе)
|
|
83
|
+
Контекст:
|
|
84
|
+
- текущий live endpoint потерял autoscaling configuration во время миграции кластера
|
|
85
|
+
- модель не меняется, но serving container и HPA manifests нужно безопасно применить заново
|
|
86
|
+
Критерии успеха:
|
|
87
|
+
- 100% трафика восстановлено на том же model artifact
|
|
88
|
+
- canary стадии завершаются без роста error rate выше 0.2%
|
|
89
|
+
- dashboards обновлены с новыми pod labels и endpoint version tags
|
|
90
|
+
Результат: чеклист валидации инфраструктуры, canary plan и доказательство, что registry state по-прежнему указывает на тот же Production artifact
|
|
91
|
+
```
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
---
|
|
2
|
+
workflow: evaluate-model
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Prompt: `/evaluate-model`
|
|
6
|
+
|
|
7
|
+
Use when: evaluating a trained model against a held-out test set, current champion, and business/fairness constraints before promotion.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## Example 1 — Binary classification promotion review
|
|
12
|
+
|
|
13
|
+
**EN:**
|
|
14
|
+
```
|
|
15
|
+
/evaluate-model
|
|
16
|
+
|
|
17
|
+
Run ID: mlflow://fraud-exp/8124ac91
|
|
18
|
+
Champion reference: fraud-detection-xgb-v12 (Production)
|
|
19
|
+
Model type: binary classification
|
|
20
|
+
Held-out test set: fraud_eval_2026_02_15.parquet (never used in training)
|
|
21
|
+
Required metrics:
|
|
22
|
+
- AUC-ROC, PR-AUC, precision, recall, F1 at operating threshold 0.72
|
|
23
|
+
- confusion matrix for amounts > $500 and <= $500
|
|
24
|
+
Business translation:
|
|
25
|
+
- estimate prevented fraud dollars/month at current traffic
|
|
26
|
+
- estimate false-positive manual review cost increase
|
|
27
|
+
Fairness check required: disparity across customer_region and account_age_bucket
|
|
28
|
+
Decision options: PROMOTE / DO_NOT_PROMOTE / NEEDS_REVIEW
|
|
29
|
+
Output: signed evaluation_scorecard.json + plots + champion comparison summary
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
**RU:**
|
|
33
|
+
```
|
|
34
|
+
/evaluate-model
|
|
35
|
+
|
|
36
|
+
Run ID: mlflow://fraud-exp/8124ac91
|
|
37
|
+
Champion reference: fraud-detection-xgb-v12 (Production)
|
|
38
|
+
Тип модели: binary classification
|
|
39
|
+
Held-out test set: fraud_eval_2026_02_15.parquet (никогда не использовался в обучении)
|
|
40
|
+
Обязательные метрики:
|
|
41
|
+
- AUC-ROC, PR-AUC, precision, recall, F1 на operating threshold 0.72
|
|
42
|
+
- confusion matrix для сумм > $500 и <= $500
|
|
43
|
+
Бизнес-интерпретация:
|
|
44
|
+
- оценить предотвращённые fraud losses в месяц при текущем трафике
|
|
45
|
+
- оценить рост стоимости ручной проверки из-за false positive
|
|
46
|
+
Требуется fairness check: disparity по customer_region и account_age_bucket
|
|
47
|
+
Варианты решения: PROMOTE / DO_NOT_PROMOTE / NEEDS_REVIEW
|
|
48
|
+
Результат: подписанный evaluation_scorecard.json + графики + summary сравнения с champion
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## Example 2 — Regression model with champion comparison and leakage guard
|
|
54
|
+
|
|
55
|
+
**EN:**
|
|
56
|
+
```
|
|
57
|
+
/evaluate-model
|
|
58
|
+
|
|
59
|
+
Run ID: mlflow://pricing-exp/cd09f552
|
|
60
|
+
Champion reference: price-forecast-lgbm-v7
|
|
61
|
+
Model type: regression
|
|
62
|
+
Held-out test set: demand_forecast_eval_week_10 (data version dv_2026_03_01)
|
|
63
|
+
Checks required:
|
|
64
|
+
- verify test set rows were excluded from every training iteration and hyperparameter search
|
|
65
|
+
- compute MAE, RMSE, R2, and MAPE vs champion on the same horizon
|
|
66
|
+
- business impact: estimate inventory carrying cost delta if challenger replaces champion
|
|
67
|
+
- slice analysis: top 20 SKUs, long-tail SKUs, promo periods, holiday periods
|
|
68
|
+
Promotion rule: only recommend PROMOTE if MAE improves and no slice regresses by more than 3%
|
|
69
|
+
Output: scorecard, leakage verification note, and decision rationale for pricing team review
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
**RU:**
|
|
73
|
+
```
|
|
74
|
+
/evaluate-model
|
|
75
|
+
|
|
76
|
+
Run ID: mlflow://pricing-exp/cd09f552
|
|
77
|
+
Champion reference: price-forecast-lgbm-v7
|
|
78
|
+
Тип модели: regression
|
|
79
|
+
Held-out test set: demand_forecast_eval_week_10 (версия данных dv_2026_03_01)
|
|
80
|
+
Требуемые проверки:
|
|
81
|
+
- подтвердить, что строки test set были исключены из всех итераций обучения и hyperparameter search
|
|
82
|
+
- вычислить MAE, RMSE, R2 и MAPE vs champion на том же горизонте
|
|
83
|
+
- бизнес-эффект: оценить дельту стоимости хранения запасов, если challenger заменит champion
|
|
84
|
+
- slice analysis: top 20 SKU, long-tail SKU, promo periods, holiday periods
|
|
85
|
+
Правило продвижения: рекомендовать PROMOTE только если MAE улучшается и ни один slice не деградирует более чем на 3%
|
|
86
|
+
Результат: scorecard, заметка о проверке leakage и обоснование решения для review командой pricing
|
|
87
|
+
```
|