moai-adk 0.3.13__py3-none-any.whl → 0.4.1__py3-none-any.whl

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.

Potentially problematic release.


This version of moai-adk might be problematic. Click here for more details.

Files changed (141) hide show
  1. moai_adk/__init__.py +1 -1
  2. moai_adk/__main__.py +1 -1
  3. moai_adk/cli/commands/__init__.py +1 -1
  4. moai_adk/cli/commands/doctor.py +2 -2
  5. moai_adk/cli/commands/init.py +10 -5
  6. moai_adk/cli/commands/status.py +1 -1
  7. moai_adk/cli/commands/update.py +210 -8
  8. moai_adk/cli/prompts/init_prompts.py +15 -19
  9. moai_adk/core/__init__.py +1 -1
  10. moai_adk/core/diagnostics/slash_commands.py +1 -1
  11. moai_adk/core/git/branch.py +1 -1
  12. moai_adk/core/git/manager.py +1 -1
  13. moai_adk/core/project/backup_utils.py +1 -0
  14. moai_adk/core/project/phase_executor.py +3 -1
  15. moai_adk/core/project/validator.py +3 -2
  16. moai_adk/core/quality/__init__.py +1 -1
  17. moai_adk/core/quality/trust_checker.py +1 -1
  18. moai_adk/core/quality/validators/__init__.py +1 -1
  19. moai_adk/core/quality/validators/base_validator.py +1 -1
  20. moai_adk/core/template/__init__.py +1 -1
  21. moai_adk/core/template/backup.py +12 -3
  22. moai_adk/core/template/config.py +24 -0
  23. moai_adk/core/template/languages.py +1 -1
  24. moai_adk/core/template/merger.py +74 -4
  25. moai_adk/core/template/processor.py +62 -14
  26. moai_adk/templates/.claude/agents/alfred/cc-manager.md +765 -191
  27. moai_adk/templates/.claude/agents/alfred/debug-helper.md +116 -103
  28. moai_adk/templates/.claude/agents/alfred/doc-syncer.md +130 -116
  29. moai_adk/templates/.claude/agents/alfred/git-manager.md +186 -174
  30. moai_adk/templates/.claude/agents/alfred/implementation-planner.md +227 -213
  31. moai_adk/templates/.claude/agents/alfred/project-manager.md +205 -125
  32. moai_adk/templates/.claude/agents/alfred/quality-gate.md +224 -209
  33. moai_adk/templates/.claude/agents/alfred/spec-builder.md +174 -160
  34. moai_adk/templates/.claude/agents/alfred/tag-agent.md +151 -139
  35. moai_adk/templates/.claude/agents/alfred/tdd-implementer.md +209 -196
  36. moai_adk/templates/.claude/agents/alfred/trust-checker.md +247 -233
  37. moai_adk/templates/.claude/commands/alfred/0-project.md +856 -355
  38. moai_adk/templates/.claude/commands/alfred/1-plan.md +572 -0
  39. moai_adk/templates/.claude/commands/alfred/2-run.md +470 -0
  40. moai_adk/templates/.claude/commands/alfred/3-sync.md +366 -356
  41. moai_adk/templates/.claude/hooks/alfred/README.md +52 -52
  42. moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py +44 -48
  43. moai_adk/templates/.claude/hooks/alfred/core/__init__.py +17 -17
  44. moai_adk/templates/.claude/hooks/alfred/core/checkpoint.py +59 -59
  45. moai_adk/templates/.claude/hooks/alfred/core/context.py +19 -19
  46. moai_adk/templates/.claude/hooks/alfred/core/project.py +52 -52
  47. moai_adk/templates/.claude/hooks/alfred/handlers/__init__.py +1 -1
  48. moai_adk/templates/.claude/hooks/alfred/handlers/notification.py +4 -4
  49. moai_adk/templates/.claude/hooks/alfred/handlers/session.py +30 -51
  50. moai_adk/templates/.claude/hooks/alfred/handlers/tool.py +16 -17
  51. moai_adk/templates/.claude/hooks/alfred/handlers/user.py +11 -11
  52. moai_adk/templates/.claude/output-styles/alfred/agentic-coding.md +308 -307
  53. moai_adk/templates/.claude/output-styles/alfred/moai-adk-learning.md +297 -296
  54. moai_adk/templates/.claude/output-styles/alfred/study-with-alfred.md +191 -190
  55. moai_adk/templates/.claude/skills/moai-alfred-code-reviewer/SKILL.md +112 -0
  56. moai_adk/templates/.claude/skills/moai-alfred-debugger-pro/SKILL.md +103 -0
  57. moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/SKILL.md +103 -0
  58. moai_adk/templates/.claude/skills/moai-alfred-git-workflow/SKILL.md +95 -0
  59. moai_adk/templates/.claude/skills/moai-alfred-language-detection/SKILL.md +99 -0
  60. moai_adk/templates/.claude/skills/moai-alfred-performance-optimizer/SKILL.md +105 -0
  61. moai_adk/templates/.claude/skills/moai-alfred-refactoring-coach/SKILL.md +97 -0
  62. moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/SKILL.md +97 -0
  63. moai_adk/templates/.claude/skills/moai-alfred-tag-scanning/SKILL.md +90 -0
  64. moai_adk/templates/.claude/skills/moai-alfred-trust-validation/SKILL.md +99 -0
  65. moai_adk/templates/.claude/skills/moai-alfred-tui-survey/SKILL.md +87 -0
  66. moai_adk/templates/.claude/skills/moai-alfred-tui-survey/examples.md +62 -0
  67. moai_adk/templates/.claude/skills/moai-claude-code/SKILL.md +94 -0
  68. moai_adk/templates/.claude/skills/moai-claude-code/examples.md +513 -0
  69. moai_adk/templates/.claude/skills/moai-claude-code/reference.md +433 -0
  70. moai_adk/templates/.claude/skills/moai-claude-code/templates/agent-full.md +332 -0
  71. moai_adk/templates/.claude/skills/moai-claude-code/templates/command-full.md +384 -0
  72. moai_adk/templates/.claude/skills/moai-claude-code/templates/plugin-full.json +363 -0
  73. moai_adk/templates/.claude/skills/moai-claude-code/templates/settings-full.json +595 -0
  74. moai_adk/templates/.claude/skills/moai-claude-code/templates/skill-full.md +496 -0
  75. moai_adk/templates/.claude/skills/moai-domain-backend/SKILL.md +99 -0
  76. moai_adk/templates/.claude/skills/moai-domain-cli-tool/SKILL.md +95 -0
  77. moai_adk/templates/.claude/skills/moai-domain-data-science/SKILL.md +98 -0
  78. moai_adk/templates/.claude/skills/moai-domain-database/SKILL.md +100 -0
  79. moai_adk/templates/.claude/skills/moai-domain-devops/SKILL.md +100 -0
  80. moai_adk/templates/.claude/skills/moai-domain-frontend/SKILL.md +99 -0
  81. moai_adk/templates/.claude/skills/moai-domain-ml/SKILL.md +99 -0
  82. moai_adk/templates/.claude/skills/moai-domain-mobile-app/SKILL.md +93 -0
  83. moai_adk/templates/.claude/skills/moai-domain-security/SKILL.md +105 -0
  84. moai_adk/templates/.claude/skills/moai-domain-web-api/SKILL.md +97 -0
  85. moai_adk/templates/.claude/skills/moai-essentials-debug/SKILL.md +102 -0
  86. moai_adk/templates/.claude/skills/moai-essentials-perf/SKILL.md +104 -0
  87. moai_adk/templates/.claude/skills/moai-essentials-refactor/SKILL.md +96 -0
  88. moai_adk/templates/.claude/skills/moai-essentials-review/SKILL.md +112 -0
  89. moai_adk/templates/.claude/skills/moai-foundation-ears/SKILL.md +98 -0
  90. moai_adk/templates/.claude/skills/moai-foundation-git/SKILL.md +90 -0
  91. moai_adk/templates/.claude/skills/moai-foundation-langs/SKILL.md +94 -0
  92. moai_adk/templates/.claude/skills/moai-foundation-specs/SKILL.md +93 -0
  93. moai_adk/templates/.claude/skills/moai-foundation-tags/SKILL.md +86 -0
  94. moai_adk/templates/.claude/skills/moai-foundation-trust/SKILL.md +86 -0
  95. moai_adk/templates/.claude/skills/moai-lang-c/SKILL.md +100 -0
  96. moai_adk/templates/.claude/skills/moai-lang-clojure/SKILL.md +100 -0
  97. moai_adk/templates/.claude/skills/moai-lang-cpp/SKILL.md +102 -0
  98. moai_adk/templates/.claude/skills/moai-lang-csharp/SKILL.md +100 -0
  99. moai_adk/templates/.claude/skills/moai-lang-dart/SKILL.md +98 -0
  100. moai_adk/templates/.claude/skills/moai-lang-elixir/SKILL.md +99 -0
  101. moai_adk/templates/.claude/skills/moai-lang-go/SKILL.md +100 -0
  102. moai_adk/templates/.claude/skills/moai-lang-haskell/SKILL.md +100 -0
  103. moai_adk/templates/.claude/skills/moai-lang-java/SKILL.md +98 -0
  104. moai_adk/templates/.claude/skills/moai-lang-javascript/SKILL.md +96 -0
  105. moai_adk/templates/.claude/skills/moai-lang-julia/SKILL.md +98 -0
  106. moai_adk/templates/.claude/skills/moai-lang-kotlin/SKILL.md +99 -0
  107. moai_adk/templates/.claude/skills/moai-lang-lua/SKILL.md +98 -0
  108. moai_adk/templates/.claude/skills/moai-lang-php/SKILL.md +98 -0
  109. moai_adk/templates/.claude/skills/moai-lang-python/SKILL.md +96 -0
  110. moai_adk/templates/.claude/skills/moai-lang-r/SKILL.md +99 -0
  111. moai_adk/templates/.claude/skills/moai-lang-ruby/SKILL.md +99 -0
  112. moai_adk/templates/.claude/skills/moai-lang-rust/SKILL.md +100 -0
  113. moai_adk/templates/.claude/skills/moai-lang-scala/SKILL.md +100 -0
  114. moai_adk/templates/.claude/skills/moai-lang-shell/SKILL.md +100 -0
  115. moai_adk/templates/.claude/skills/moai-lang-sql/SKILL.md +100 -0
  116. moai_adk/templates/.claude/skills/moai-lang-swift/SKILL.md +99 -0
  117. moai_adk/templates/.claude/skills/moai-lang-typescript/SKILL.md +96 -0
  118. moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md +44 -43
  119. moai_adk/templates/.github/workflows/moai-gitflow.yml +36 -35
  120. moai_adk/templates/.moai/config.json +9 -6
  121. moai_adk/templates/.moai/memory/development-guide.md +220 -221
  122. moai_adk/templates/.moai/memory/gitflow-protection-policy.md +85 -85
  123. moai_adk/templates/.moai/memory/spec-metadata.md +149 -150
  124. moai_adk/templates/.moai/project/product.md +90 -90
  125. moai_adk/templates/.moai/project/structure.md +85 -85
  126. moai_adk/templates/.moai/project/tech.md +117 -117
  127. moai_adk/templates/CLAUDE.md +354 -573
  128. moai_adk/templates/__init__.py +1 -1
  129. moai_adk/utils/__init__.py +1 -1
  130. moai_adk/utils/banner.py +7 -7
  131. moai_adk/utils/logger.py +1 -1
  132. moai_adk-0.4.1.dist-info/METADATA +303 -0
  133. moai_adk-0.4.1.dist-info/RECORD +152 -0
  134. moai_adk/templates/.claude/commands/alfred/1-spec.md +0 -532
  135. moai_adk/templates/.claude/commands/alfred/2-build.md +0 -432
  136. moai_adk/templates/.moai/hooks/pre-push.sample +0 -88
  137. moai_adk-0.3.13.dist-info/METADATA +0 -1586
  138. moai_adk-0.3.13.dist-info/RECORD +0 -90
  139. {moai_adk-0.3.13.dist-info → moai_adk-0.4.1.dist-info}/WHEEL +0 -0
  140. {moai_adk-0.3.13.dist-info → moai_adk-0.4.1.dist-info}/entry_points.txt +0 -0
  141. {moai_adk-0.3.13.dist-info → moai_adk-0.4.1.dist-info}/licenses/LICENSE +0 -0
@@ -0,0 +1,98 @@
1
+ ---
2
+
3
+ name: moai-domain-data-science
4
+ description: Data analysis, visualization, statistical modeling, and reproducible research workflows. Use when working on data science workflows scenarios.
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ ---
9
+
10
+ # Data Science Expert
11
+
12
+ ## Skill Metadata
13
+ | Field | Value |
14
+ | ----- | ----- |
15
+ | Allowed tools | Read (read_file), Bash (terminal) |
16
+ | Auto-load | On demand for analytics and DS work |
17
+ | Trigger cues | Notebook workflows, data pipelines, feature engineering, experimentation plans. |
18
+ | Tier | 4 |
19
+
20
+ ## What it does
21
+
22
+ Provides expertise in data analysis workflows, statistical modeling, data visualization, and reproducible research practices using Python (pandas, scikit-learn) or R (tidyverse).
23
+
24
+ ## When to use
25
+
26
+ - Engages when analytics, experimentation, or data science implementation is requested.
27
+ - “Data analysis”, “Visualization”, “Statistical modeling”, “Reproducible research”
28
+ - Automatically invoked when working with data science projects
29
+ - Data science SPEC implementation (`/alfred:2-run`)
30
+
31
+ ## How it works
32
+
33
+ **Data Analysis (Python)**:
34
+ - **pandas**: Data manipulation (DataFrames, groupby, merge)
35
+ - **numpy**: Numerical computing
36
+ - **scipy**: Scientific computing, statistics
37
+ - **statsmodels**: Statistical modeling
38
+
39
+ **Data Analysis (R)**:
40
+ - **tidyverse**: dplyr, ggplot2, tidyr
41
+ - **data.table**: High-performance data manipulation
42
+ - **caret**: Machine learning framework
43
+
44
+ **Visualization**:
45
+ - **matplotlib/seaborn**: Python plotting
46
+ - **plotly**: Interactive visualizations
47
+ - **ggplot2**: R grammar of graphics
48
+ - **D3.js**: Web-based visualizations
49
+
50
+ **Statistical Modeling**:
51
+ - **Hypothesis testing**: t-tests, ANOVA, chi-square
52
+ - **Regression**: Linear, logistic, polynomial
53
+ - **Time series**: ARIMA, seasonal decomposition
54
+ - **Bayesian inference**: PyMC3, Stan
55
+
56
+ **Reproducible Research**:
57
+ - **Jupyter notebooks**: Interactive analysis
58
+ - **R Markdown**: Literate programming
59
+ - **Version control**: Git for notebooks (nbstripout)
60
+ - **Environment management**: conda, renv
61
+
62
+ ## Examples
63
+ ```markdown
64
+ - Orchestrate data prep → training → evaluation steps.
65
+ - Export metrics (precision/recall) to the Quality Report.
66
+ ```
67
+
68
+ ## Inputs
69
+ - Domain-specific design documents and user requirements.
70
+ - Project technology stack and operational constraints.
71
+
72
+ ## Outputs
73
+ - Domain-specific architecture or implementation guidelines.
74
+ - Recommended list of associated sub-agents/skills.
75
+
76
+ ## Failure Modes
77
+ - When the domain document does not exist or is ambiguous.
78
+ - When the project strategy is unconfirmed and cannot be specified.
79
+
80
+ ## Dependencies
81
+ - `.moai/project/` document and latest technical briefing are required.
82
+
83
+ ## References
84
+ - Google. "Rules of Machine Learning." https://developers.google.com/machine-learning/guides/rules-of-ml (accessed 2025-03-29).
85
+ - Netflix. "Metaflow: Human-Centric Framework for Data Science." https://metaflow.org/ (accessed 2025-03-29).
86
+
87
+ ## Changelog
88
+ - 2025-03-29: Codified input/output and failure responses for domain skills.
89
+
90
+ ## Works well with
91
+
92
+ - alfred-trust-validation (analysis testing)
93
+ - python-expert/r-expert (implementation)
94
+ - ml-expert (advanced modeling)
95
+
96
+ ## Best Practices
97
+ - Record supporting documentation (version/link) for each domain decision.
98
+ - Review performance, security, and operational requirements simultaneously at an early stage.
@@ -0,0 +1,100 @@
1
+ ---
2
+
3
+ name: moai-domain-database
4
+ description: Database design, schema optimization, indexing strategies, and migration management. Use when working on database integration tasks scenarios.
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ ---
9
+
10
+ # Database Expert
11
+
12
+ ## Skill Metadata
13
+ | Field | Value |
14
+ | ----- | ----- |
15
+ | Allowed tools | Read (read_file), Bash (terminal) |
16
+ | Auto-load | On demand for data layer design |
17
+ | Trigger cues | Schema modeling, migration planning, query optimization, indexing strategy. |
18
+ | Tier | 4 |
19
+
20
+ ## What it does
21
+
22
+ Provides expertise in database design, schema normalization, indexing strategies, query optimization, and safe migration management for SQL and NoSQL databases.
23
+
24
+ ## When to use
25
+
26
+ - Engages when the conversation focuses on database design or tuning.
27
+ - “Database design”, “Schema optimization”, “Index strategy”, “Migration”
28
+ - Automatically invoked when working with database projects
29
+ - Database SPEC implementation (`/alfred:2-run`)
30
+
31
+ ## How it works
32
+
33
+ **Schema Design**:
34
+ - **Normalization**: 1NF, 2NF, 3NF, BCNF
35
+ - **Denormalization**: Performance trade-offs
36
+ - **Constraints**: Primary keys, foreign keys, unique, check
37
+ - **Data types**: Choosing appropriate types
38
+
39
+ **Indexing Strategies**:
40
+ - **B-tree indices**: General-purpose indexing
41
+ - **Hash indices**: Exact match queries
42
+ - **Full-text indices**: Text search
43
+ - **Composite indices**: Multi-column indexing
44
+ - **Index maintenance**: REINDEX, VACUUM
45
+
46
+ **Query Optimization**:
47
+ - **EXPLAIN/EXPLAIN ANALYZE**: Query plan analysis
48
+ - **JOIN optimization**: INNER, LEFT, RIGHT, FULL
49
+ - **Subquery vs JOIN**: Performance comparison
50
+ - **N+1 query problem**: Eager loading
51
+ - **Query caching**: Redis, Memcached
52
+
53
+ **Migration Management**:
54
+ - **Version control**: Flyway, Liquibase, Alembic
55
+ - **Rollback strategies**: Backward compatibility
56
+ - **Zero-downtime migrations**: Expand-contract pattern
57
+ - **Data migrations**: Safe data transformations
58
+
59
+ **Database Types**:
60
+ - **SQL**: PostgreSQL, MySQL, SQLite
61
+ - **NoSQL**: MongoDB, Redis, Cassandra
62
+ - **NewSQL**: CockroachDB, Vitess
63
+
64
+ ## Examples
65
+ ```bash
66
+ $ alembic upgrade head
67
+ $ psql -f audits/verify_constraints.sql
68
+ ```
69
+
70
+ ## Inputs
71
+ - Domain-specific design documents and user requirements.
72
+ - Project technology stack and operational constraints.
73
+
74
+ ## Outputs
75
+ - Domain-specific architecture or implementation guidelines.
76
+ - Recommended list of associated sub-agents/skills.
77
+
78
+ ## Failure Modes
79
+ - When the domain document does not exist or is ambiguous.
80
+ - When the project strategy is unconfirmed and cannot be specified.
81
+
82
+ ## Dependencies
83
+ - `.moai/project/` document and latest technical briefing are required.
84
+
85
+ ## References
86
+ - Fowler, Martin. "Evolutionary Database Design." https://martinfowler.com/articles/evodb.html (accessed 2025-03-29).
87
+ - AWS. "Database Tuning Best Practices." https://aws.amazon.com/blogs/database/ (accessed 2025-03-29).
88
+
89
+ ## Changelog
90
+ - 2025-03-29: Codified input/output and failure responses for domain skills.
91
+
92
+ ## Works well with
93
+
94
+ - alfred-trust-validation (migration testing)
95
+ - sql-expert (SQL implementation)
96
+ - backend-expert (ORM integration)
97
+
98
+ ## Best Practices
99
+ - Record supporting documentation (version/link) for each domain decision.
100
+ - Review performance, security, and operational requirements simultaneously at an early stage.
@@ -0,0 +1,100 @@
1
+ ---
2
+
3
+ name: moai-domain-devops
4
+ description: CI/CD pipelines, Docker containerization, Kubernetes orchestration, and infrastructure as code. Use when working on DevOps automation scenarios.
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ ---
9
+
10
+ # DevOps Expert
11
+
12
+ ## Skill Metadata
13
+ | Field | Value |
14
+ | ----- | ----- |
15
+ | Allowed tools | Read (read_file), Bash (terminal) |
16
+ | Auto-load | On demand for platform and CI/CD topics |
17
+ | Trigger cues | Infrastructure as code, pipeline design, release automation, observability setup. |
18
+ | Tier | 4 |
19
+
20
+ ## What it does
21
+
22
+ Provides expertise in continuous integration/deployment (CI/CD), Docker containerization, Kubernetes orchestration, and infrastructure as code (IaC) for automated deployment workflows.
23
+
24
+ ## When to use
25
+
26
+ - Engages when DevOps, CI/CD, or infrastructure automation is required.
27
+ - “CI/CD pipeline”, “Docker containerization”, “Kubernetes deployment”, “infrastructure code”
28
+ - Automatically invoked when working with DevOps projects
29
+ - DevOps SPEC implementation (`/alfred:2-run`)
30
+
31
+ ## How it works
32
+
33
+ **CI/CD Pipelines**:
34
+ - **GitHub Actions**: Workflow automation (.github/workflows)
35
+ - **GitLab CI**: .gitlab-ci.yml configuration
36
+ - **Jenkins**: Pipeline as code (Jenkinsfile)
37
+ - **CircleCI**: .circleci/config.yml
38
+ - **Pipeline stages**: Build → Test → Deploy
39
+
40
+ **Docker Containerization**:
41
+ - **Dockerfile**: Multi-stage builds for optimization
42
+ - **docker-compose**: Local development environments
43
+ - **Image optimization**: Layer caching, alpine base images
44
+ - **Container registries**: Docker Hub, GitHub Container Registry
45
+
46
+ **Kubernetes Orchestration**:
47
+ - **Deployments**: Rolling updates, rollbacks
48
+ - **Services**: LoadBalancer, ClusterIP, NodePort
49
+ - **ConfigMaps/Secrets**: Configuration management
50
+ - **Helm charts**: Package management
51
+ - **Ingress**: Traffic routing
52
+
53
+ **Infrastructure as Code (IaC)**:
54
+ - **Terraform**: Cloud-agnostic provisioning
55
+ - **Ansible**: Configuration management
56
+ - **CloudFormation**: AWS-specific IaC
57
+ - **Pulumi**: Programmatic infrastructure
58
+
59
+ **Monitoring & Logging**:
60
+ - **Prometheus**: Metrics collection
61
+ - **Grafana**: Visualization
62
+ - **ELK Stack**: Logging (Elasticsearch, Logstash, Kibana)
63
+
64
+ ## Examples
65
+ ```bash
66
+ $ terraform fmt && terraform validate
67
+ $ ansible-playbook deploy.yml --check
68
+ ```
69
+
70
+ ## Inputs
71
+ - Domain-specific design documents and user requirements.
72
+ - Project technology stack and operational constraints.
73
+
74
+ ## Outputs
75
+ - Domain-specific architecture or implementation guidelines.
76
+ - Recommended list of associated sub-agents/skills.
77
+
78
+ ## Failure Modes
79
+ - When the domain document does not exist or is ambiguous.
80
+ - When the project strategy is unconfirmed and cannot be specified.
81
+
82
+ ## Dependencies
83
+ - `.moai/project/` document and latest technical briefing are required.
84
+
85
+ ## References
86
+ - Google SRE. "Site Reliability Engineering." https://sre.google/books/ (accessed 2025-03-29).
87
+ - HashiCorp. "Terraform Best Practices." https://developer.hashicorp.com/terraform/intro (accessed 2025-03-29).
88
+
89
+ ## Changelog
90
+ - 2025-03-29: Codified input/output and failure responses for domain skills.
91
+
92
+ ## Works well with
93
+
94
+ - alfred-trust-validation (deployment validation)
95
+ - shell-expert (shell scripting for automation)
96
+ - security-expert (secure deployments)
97
+
98
+ ## Best Practices
99
+ - Record supporting documentation (version/link) for each domain decision.
100
+ - Review performance, security, and operational requirements simultaneously at an early stage.
@@ -0,0 +1,99 @@
1
+ ---
2
+
3
+ name: moai-domain-frontend
4
+ description: React/Vue/Angular development with state management, performance optimization, and accessibility. Use when working on frontend interfaces scenarios.
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ ---
9
+
10
+ # Frontend Expert
11
+
12
+ ## Skill Metadata
13
+ | Field | Value |
14
+ | ----- | ----- |
15
+ | Allowed tools | Read (read_file), Bash (terminal) |
16
+ | Auto-load | On demand for frontend delivery |
17
+ | Trigger cues | Component architecture, design systems, accessibility, performance budgets. |
18
+ | Tier | 4 |
19
+
20
+ ## What it does
21
+
22
+ Provides expertise in modern frontend development using React, Vue, or Angular, including state management patterns, performance optimization techniques, and accessibility (a11y) best practices.
23
+
24
+ ## When to use
25
+
26
+ - Engages when building or reviewing UI/front-end experiences.
27
+ - “Front-end development”, “React components”, “state management”, “performance optimization”
28
+ - Automatically invoked when working with frontend projects
29
+ - Frontend SPEC implementation (`/alfred:2-run`)
30
+
31
+ ## How it works
32
+
33
+ **React Development**:
34
+ - **Functional components**: Hooks (useState, useEffect, useMemo)
35
+ - **State management**: Redux, Zustand, Jotai
36
+ - **Performance**: React.memo, useCallback, code splitting
37
+ - **Testing**: React Testing Library
38
+
39
+ **Vue Development**:
40
+ - **Composition API**: setup(), reactive(), computed()
41
+ - **State management**: Pinia, Vuex
42
+ - **Performance**: Virtual scrolling, lazy loading
43
+ - **Testing**: Vue Test Utils
44
+
45
+ **Angular Development**:
46
+ - **Components**: TypeScript classes with decorators
47
+ - **State management**: NgRx, Akita
48
+ - **Performance**: OnPush change detection, lazy loading
49
+ - **Testing**: Jasmine, Karma
50
+
51
+ **Performance Optimization**:
52
+ - **Code splitting**: Dynamic imports, route-based splitting
53
+ - **Lazy loading**: Images, components
54
+ - **Bundle optimization**: Tree shaking, minification
55
+ - **Web Vitals**: LCP, FID, CLS optimization
56
+
57
+ **Accessibility (a11y)**:
58
+ - **Semantic HTML**: Proper use of HTML5 elements
59
+ - **ARIA attributes**: Roles, labels, descriptions
60
+ - **Keyboard navigation**: Focus management
61
+ - **Screen reader support**: Alt text, aria-live
62
+
63
+ ## Examples
64
+ ```bash
65
+ $ npm run lint && npm run test
66
+ $ npm run build -- --profiling
67
+ ```
68
+
69
+ ## Inputs
70
+ - Domain-specific design documents and user requirements.
71
+ - Project technology stack and operational constraints.
72
+
73
+ ## Outputs
74
+ - Domain-specific architecture or implementation guidelines.
75
+ - Recommended list of associated sub-agents/skills.
76
+
77
+ ## Failure Modes
78
+ - When the domain document does not exist or is ambiguous.
79
+ - When the project strategy is unconfirmed and cannot be specified.
80
+
81
+ ## Dependencies
82
+ - `.moai/project/` document and latest technical briefing are required.
83
+
84
+ ## References
85
+ - Google. "Web.dev Performance Guidelines." https://web.dev/fast/ (accessed 2025-03-29).
86
+ - W3C. "Web Content Accessibility Guidelines (WCAG) 2.2." https://www.w3.org/TR/WCAG22/ (accessed 2025-03-29).
87
+
88
+ ## Changelog
89
+ - 2025-03-29: Codified input/output and failure responses for domain skills.
90
+
91
+ ## Works well with
92
+
93
+ - alfred-trust-validation (frontend testing)
94
+ - typescript-expert (type-safe React/Vue)
95
+ - alfred-performance-optimizer (performance profiling)
96
+
97
+ ## Best Practices
98
+ - Record supporting documentation (version/link) for each domain decision.
99
+ - Review performance, security, and operational requirements simultaneously at an early stage.
@@ -0,0 +1,99 @@
1
+ ---
2
+
3
+ name: moai-domain-ml
4
+ description: Machine learning model training, evaluation, deployment, and MLOps workflows. Use when working on machine learning pipelines scenarios.
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ ---
9
+
10
+ # ML Expert
11
+
12
+ ## Skill Metadata
13
+ | Field | Value |
14
+ | ----- | ----- |
15
+ | Allowed tools | Read (read_file), Bash (terminal) |
16
+ | Auto-load | On demand for ML lifecycle |
17
+ | Trigger cues | Model training, evaluation, deployment, MLOps guardrails. |
18
+ | Tier | 4 |
19
+
20
+ ## What it does
21
+
22
+ Provides expertise in machine learning model development, training, evaluation, hyperparameter tuning, deployment, and MLOps workflows for production ML systems.
23
+
24
+ ## When to use
25
+
26
+ - Engages when machine learning workflows or model operations are discussed.
27
+ - “Machine learning model development”, “model training”, “model deployment”, “MLOps”
28
+ - Automatically invoked when working with ML projects
29
+ - ML SPEC implementation (`/alfred:2-run`)
30
+
31
+ ## How it works
32
+
33
+ **Model Training**:
34
+ - **scikit-learn**: Classical ML (RandomForest, SVM, KNN)
35
+ - **TensorFlow/Keras**: Deep learning (CNN, RNN, Transformers)
36
+ - **PyTorch**: Research-oriented deep learning
37
+ - **XGBoost/LightGBM**: Gradient boosting
38
+
39
+ **Model Evaluation**:
40
+ - **Classification**: Accuracy, precision, recall, F1, ROC-AUC
41
+ - **Regression**: RMSE, MAE, R²
42
+ - **Cross-validation**: k-fold, stratified k-fold
43
+ - **Confusion matrix**: Error analysis
44
+
45
+ **Hyperparameter Tuning**:
46
+ - **Grid search**: Exhaustive search
47
+ - **Random search**: Stochastic search
48
+ - **Bayesian optimization**: Optuna, Hyperopt
49
+ - **AutoML**: Auto-sklearn, TPOT
50
+
51
+ **Model Deployment**:
52
+ - **Serialization**: pickle, joblib, ONNX
53
+ - **Serving**: FastAPI, TensorFlow Serving, TorchServe
54
+ - **Containerization**: Docker for reproducibility
55
+ - **Versioning**: MLflow, DVC
56
+
57
+ **MLOps Workflows**:
58
+ - **Experiment tracking**: MLflow, Weights & Biases
59
+ - **Feature store**: Feast, Tecton
60
+ - **Model registry**: Centralized model management
61
+ - **Monitoring**: Data drift detection, model performance
62
+
63
+ ## Examples
64
+ ```markdown
65
+ - Trigger model training pipeline (e.g., `dvc repro`).
66
+ - Register artifact path in Completion Report.
67
+ ```
68
+
69
+ ## Inputs
70
+ - Domain-specific design documents and user requirements.
71
+ - Project technology stack and operational constraints.
72
+
73
+ ## Outputs
74
+ - Domain-specific architecture or implementation guidelines.
75
+ - Recommended list of associated sub-agents/skills.
76
+
77
+ ## Failure Modes
78
+ - When the domain document does not exist or is ambiguous.
79
+ - When the project strategy is unconfirmed and cannot be specified.
80
+
81
+ ## Dependencies
82
+ - `.moai/project/` document and latest technical briefing are required.
83
+
84
+ ## References
85
+ - Google Cloud. "MLOps Continuous Delivery." https://cloud.google.com/architecture/mlops-continuous-delivery-and-automation-pipelines (accessed 2025-03-29).
86
+ - NVIDIA. "MLOps Best Practices." https://developer.nvidia.com/blog/category/ai/ (accessed 2025-03-29).
87
+
88
+ ## Changelog
89
+ - 2025-03-29: Codified input/output and failure responses for domain skills.
90
+
91
+ ## Works well with
92
+
93
+ - alfred-trust-validation (model testing)
94
+ - python-expert (ML implementation)
95
+ - data-science-expert (data preparation)
96
+
97
+ ## Best Practices
98
+ - Record supporting documentation (version/link) for each domain decision.
99
+ - Review performance, security, and operational requirements simultaneously at an early stage.
@@ -0,0 +1,93 @@
1
+ ---
2
+
3
+ name: moai-domain-mobile-app
4
+ description: Mobile app development with Flutter and React Native, state management, and native integration. Use when working on mobile application flows scenarios.
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ ---
9
+
10
+ # Mobile App Expert
11
+
12
+ ## Skill Metadata
13
+ | Field | Value |
14
+ | ----- | ----- |
15
+ | Allowed tools | Read (read_file), Bash (terminal) |
16
+ | Auto-load | On demand for mobile flows |
17
+ | Trigger cues | iOS/Android releases, cross-platform tooling, app store compliance, mobile UX. |
18
+ | Tier | 4 |
19
+
20
+ ## What it does
21
+
22
+ Provides expertise in cross-platform mobile app development using Flutter (Dart) and React Native (TypeScript), including state management patterns and native module integration.
23
+
24
+ ## When to use
25
+
26
+ - Engages when mobile application development or release pipelines are in scope.
27
+ - “Mobile app development”, “Flutter widgets”, “React Native components”, “state management”
28
+ - Automatically invoked when working with mobile app projects
29
+ - Mobile app SPEC implementation (`/alfred:2-run`)
30
+
31
+ ## How it works
32
+
33
+ **Flutter Development**:
34
+ - **Widget tree**: StatelessWidget, StatefulWidget
35
+ - **State management**: Provider, Riverpod, BLoC
36
+ - **Navigation**: Navigator 2.0, go_router
37
+ - **Platform-specific code**: MethodChannel
38
+
39
+ **React Native Development**:
40
+ - **Components**: Functional components with hooks
41
+ - **State management**: Redux, MobX, Zustand
42
+ - **Navigation**: React Navigation
43
+ - **Native modules**: Turbo modules, JSI
44
+
45
+ **Cross-Platform Patterns**:
46
+ - **Responsive design**: Adaptive layouts for phone/tablet
47
+ - **Performance optimization**: Lazy loading, memoization
48
+ - **Offline support**: Local storage, sync strategies
49
+ - **Testing**: Widget tests (Flutter), component tests (RN)
50
+
51
+ **Native Integration**:
52
+ - **Plugins**: Platform channels, native modules
53
+ - **Permissions**: Camera, location, notifications
54
+ - **Deep linking**: Universal links, app links
55
+ - **Push notifications**: FCM, APNs
56
+
57
+ ## Examples
58
+ ```markdown
59
+ - Generate platform-specific builds (`flutter build`, `xcodebuild`).
60
+ - Capture store submission checklist as Todo items.
61
+ ```
62
+
63
+ ## Inputs
64
+ - Domain-specific design documents and user requirements.
65
+ - Project technology stack and operational constraints.
66
+
67
+ ## Outputs
68
+ - Domain-specific architecture or implementation guidelines.
69
+ - Recommended list of associated sub-agents/skills.
70
+
71
+ ## Failure Modes
72
+ - When the domain document does not exist or is ambiguous.
73
+ - When the project strategy is unconfirmed and cannot be specified.
74
+
75
+ ## Dependencies
76
+ - `.moai/project/` document and latest technical briefing are required.
77
+
78
+ ## References
79
+ - Apple. "Human Interface Guidelines." https://developer.apple.com/design/human-interface-guidelines/ (accessed 2025-03-29).
80
+ - Google. "Material Design." https://m3.material.io/ (accessed 2025-03-29).
81
+
82
+ ## Changelog
83
+ - 2025-03-29: Codified input/output and failure responses for domain skills.
84
+
85
+ ## Works well with
86
+
87
+ - alfred-trust-validation (mobile testing)
88
+ - dart-expert (Flutter development)
89
+ - typescript-expert (React Native development)
90
+
91
+ ## Best Practices
92
+ - Record supporting documentation (version/link) for each domain decision.
93
+ - Review performance, security, and operational requirements simultaneously at an early stage.
@@ -0,0 +1,105 @@
1
+ ---
2
+
3
+ name: moai-domain-security
4
+ description: OWASP Top 10, static analysis (SAST), dependency security, and secrets management. Use when working on security and compliance reviews scenarios.
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ ---
9
+
10
+ # Security Expert
11
+
12
+ ## Skill Metadata
13
+ | Field | Value |
14
+ | ----- | ----- |
15
+ | Allowed tools | Read (read_file), Bash (terminal) |
16
+ | Auto-load | On demand when security keywords appear |
17
+ | Trigger cues | Threat modeling, OWASP findings, secrets management, compliance reviews. |
18
+ | Tier | 4 |
19
+
20
+ ## What it does
21
+
22
+ Provides expertise in application security, including OWASP Top 10 vulnerabilities, static application security testing (SAST), dependency vulnerability scanning, and secrets management.
23
+
24
+ ## When to use
25
+
26
+ - Engages when the team asks about security posture or mitigation steps.
27
+ - “Security vulnerability analysis”, “OWASP verification”, “Secret management”, “Dependency security”
28
+ - Automatically invoked when security concerns arise
29
+ - Security SPEC implementation (`/alfred:2-run`)
30
+
31
+ ## How it works
32
+
33
+ **OWASP Top 10 (2021)**:
34
+ 1. **Broken Access Control**: Authorization checks
35
+ 2. **Cryptographic Failures**: Encryption at rest/transit
36
+ 3. **Injection**: SQL injection, XSS prevention
37
+ 4. **Insecure Design**: Threat modeling
38
+ 5. **Security Misconfiguration**: Secure defaults
39
+ 6. **Vulnerable Components**: Dependency scanning
40
+ 7. **Identification/Authentication Failures**: MFA, password policies
41
+ 8. **Software/Data Integrity Failures**: Code signing
42
+ 9. **Security Logging/Monitoring Failures**: Audit logs
43
+ 10. **Server-Side Request Forgery (SSRF)**: Input validation
44
+
45
+ **Static Analysis (SAST)**:
46
+ - **Semgrep**: Multi-language static analysis
47
+ - **SonarQube**: Code quality + security
48
+ - **Bandit**: Python security linter
49
+ - **ESLint security plugins**: JavaScript security
50
+
51
+ **Dependency Security**:
52
+ - **Snyk**: Vulnerability scanning
53
+ - **Dependabot**: Automated dependency updates
54
+ - **npm audit**: Node.js vulnerabilities
55
+ - **safety**: Python dependency checker
56
+
57
+ **Secrets Management**:
58
+ - **Never commit secrets**: .gitignore for .env files
59
+ - **Vault**: Secrets storage (HashiCorp Vault)
60
+ - **Environment variables**: Runtime configuration
61
+ - **Secret scanning**: git-secrets, trufflehog
62
+
63
+ **Secure Coding Practices**:
64
+ - Input validation and sanitization
65
+ - Parameterized queries (SQL injection prevention)
66
+ - CSP (Content Security Policy) headers
67
+ - HTTPS enforcement
68
+
69
+ ## Examples
70
+ ```markdown
71
+ - Run SAST/DAST tools and attach findings summary.
72
+ - Update risk matrix with severity/owner/ETA.
73
+ ```
74
+
75
+ ## Inputs
76
+ - Domain-related design documents and user requirements.
77
+ - Project technology stack and operational constraints.
78
+
79
+ ## Outputs
80
+ - Domain-specific architecture or implementation guidelines.
81
+ - Recommended list of associated sub-agents/skills.
82
+
83
+ ## Failure Modes
84
+ - When the domain document does not exist or is ambiguous.
85
+ - When the project strategy is unconfirmed and cannot be specified.
86
+
87
+ ## Dependencies
88
+ - `.moai/project/` document and latest technical briefing are required.
89
+
90
+ ## References
91
+ - OWASP. "Top 10 Web Application Security Risks." https://owasp.org/www-project-top-ten/ (accessed 2025-03-29).
92
+ - NIST. "Secure Software Development Framework." https://csrc.nist.gov/publications/detail/sp/800-218/final (accessed 2025-03-29).
93
+
94
+ ## Changelog
95
+ - 2025-03-29: Codified input/output and failure responses for domain skills.
96
+
97
+ ## Works well with
98
+
99
+ - alfred-trust-validation (security validation)
100
+ - web-api-expert (API security)
101
+ - devops-expert (secure deployments)
102
+
103
+ ## Best Practices
104
+ - Record supporting documentation (version/link) for each domain decision.
105
+ - Review performance, security, and operational requirements simultaneously at an early stage.