moai-adk 0.35.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.
- moai_adk/__init__.py +10 -0
- moai_adk/__main__.py +199 -0
- moai_adk/cli/__init__.py +6 -0
- moai_adk/cli/commands/__init__.py +17 -0
- moai_adk/cli/commands/analyze.py +116 -0
- moai_adk/cli/commands/doctor.py +272 -0
- moai_adk/cli/commands/init.py +372 -0
- moai_adk/cli/commands/language.py +248 -0
- moai_adk/cli/commands/status.py +104 -0
- moai_adk/cli/commands/update.py +2686 -0
- moai_adk/cli/main.py +13 -0
- moai_adk/cli/prompts/__init__.py +5 -0
- moai_adk/cli/prompts/init_prompts.py +219 -0
- moai_adk/cli/spec_status.py +263 -0
- moai_adk/cli/ui/__init__.py +44 -0
- moai_adk/cli/ui/progress.py +422 -0
- moai_adk/cli/ui/prompts.py +389 -0
- moai_adk/cli/ui/theme.py +129 -0
- moai_adk/cli/worktree/__init__.py +27 -0
- moai_adk/cli/worktree/__main__.py +31 -0
- moai_adk/cli/worktree/cli.py +683 -0
- moai_adk/cli/worktree/exceptions.py +89 -0
- moai_adk/cli/worktree/manager.py +493 -0
- moai_adk/cli/worktree/models.py +65 -0
- moai_adk/cli/worktree/registry.py +422 -0
- moai_adk/core/PHASE2_OPTIMIZATIONS.md +467 -0
- moai_adk/core/__init__.py +1 -0
- moai_adk/core/analysis/__init__.py +9 -0
- moai_adk/core/analysis/session_analyzer.py +400 -0
- moai_adk/core/claude_integration.py +393 -0
- moai_adk/core/command_helpers.py +270 -0
- moai_adk/core/comprehensive_monitoring_system.py +1183 -0
- moai_adk/core/config/__init__.py +19 -0
- moai_adk/core/config/auto_spec_config.py +340 -0
- moai_adk/core/config/migration.py +244 -0
- moai_adk/core/config/unified.py +436 -0
- moai_adk/core/context_manager.py +273 -0
- moai_adk/core/diagnostics/__init__.py +19 -0
- moai_adk/core/diagnostics/slash_commands.py +159 -0
- moai_adk/core/enterprise_features.py +1404 -0
- moai_adk/core/error_recovery_system.py +1902 -0
- moai_adk/core/event_driven_hook_system.py +1371 -0
- moai_adk/core/git/__init__.py +31 -0
- moai_adk/core/git/branch.py +25 -0
- moai_adk/core/git/branch_manager.py +129 -0
- moai_adk/core/git/checkpoint.py +134 -0
- moai_adk/core/git/commit.py +67 -0
- moai_adk/core/git/conflict_detector.py +413 -0
- moai_adk/core/git/event_detector.py +79 -0
- moai_adk/core/git/manager.py +216 -0
- moai_adk/core/hooks/post_tool_auto_spec_completion.py +901 -0
- moai_adk/core/input_validation_middleware.py +1006 -0
- moai_adk/core/integration/__init__.py +22 -0
- moai_adk/core/integration/engine.py +157 -0
- moai_adk/core/integration/integration_tester.py +226 -0
- moai_adk/core/integration/models.py +88 -0
- moai_adk/core/integration/utils.py +211 -0
- moai_adk/core/issue_creator.py +305 -0
- moai_adk/core/jit_context_loader.py +956 -0
- moai_adk/core/jit_enhanced_hook_manager.py +1987 -0
- moai_adk/core/language_config.py +202 -0
- moai_adk/core/language_config_resolver.py +572 -0
- moai_adk/core/language_validator.py +543 -0
- moai_adk/core/mcp/setup.py +116 -0
- moai_adk/core/merge/__init__.py +9 -0
- moai_adk/core/merge/analyzer.py +605 -0
- moai_adk/core/migration/__init__.py +18 -0
- moai_adk/core/migration/alfred_to_moai_migrator.py +383 -0
- moai_adk/core/migration/backup_manager.py +277 -0
- moai_adk/core/migration/custom_element_scanner.py +358 -0
- moai_adk/core/migration/file_migrator.py +209 -0
- moai_adk/core/migration/interactive_checkbox_ui.py +488 -0
- moai_adk/core/migration/selective_restorer.py +470 -0
- moai_adk/core/migration/template_utils.py +74 -0
- moai_adk/core/migration/user_selection_ui.py +338 -0
- moai_adk/core/migration/version_detector.py +139 -0
- moai_adk/core/migration/version_migrator.py +228 -0
- moai_adk/core/performance/__init__.py +6 -0
- moai_adk/core/performance/cache_system.py +316 -0
- moai_adk/core/performance/parallel_processor.py +116 -0
- moai_adk/core/phase_optimized_hook_scheduler.py +879 -0
- moai_adk/core/project/__init__.py +1 -0
- moai_adk/core/project/backup_utils.py +70 -0
- moai_adk/core/project/checker.py +300 -0
- moai_adk/core/project/detector.py +293 -0
- moai_adk/core/project/initializer.py +387 -0
- moai_adk/core/project/phase_executor.py +716 -0
- moai_adk/core/project/validator.py +139 -0
- moai_adk/core/quality/__init__.py +6 -0
- moai_adk/core/quality/trust_checker.py +377 -0
- moai_adk/core/quality/validators/__init__.py +6 -0
- moai_adk/core/quality/validators/base_validator.py +19 -0
- moai_adk/core/realtime_monitoring_dashboard.py +1724 -0
- moai_adk/core/robust_json_parser.py +611 -0
- moai_adk/core/rollback_manager.py +918 -0
- moai_adk/core/session_manager.py +651 -0
- moai_adk/core/skill_loading_system.py +579 -0
- moai_adk/core/spec/confidence_scoring.py +680 -0
- moai_adk/core/spec/ears_template_engine.py +1247 -0
- moai_adk/core/spec/quality_validator.py +687 -0
- moai_adk/core/spec_status_manager.py +478 -0
- moai_adk/core/template/__init__.py +7 -0
- moai_adk/core/template/backup.py +174 -0
- moai_adk/core/template/config.py +191 -0
- moai_adk/core/template/languages.py +43 -0
- moai_adk/core/template/merger.py +233 -0
- moai_adk/core/template/processor.py +1200 -0
- moai_adk/core/template_engine.py +310 -0
- moai_adk/core/template_variable_synchronizer.py +417 -0
- moai_adk/core/unified_permission_manager.py +745 -0
- moai_adk/core/user_behavior_analytics.py +851 -0
- moai_adk/core/version_sync.py +429 -0
- moai_adk/foundation/__init__.py +56 -0
- moai_adk/foundation/backend.py +1027 -0
- moai_adk/foundation/database.py +1115 -0
- moai_adk/foundation/devops.py +1585 -0
- moai_adk/foundation/ears.py +431 -0
- moai_adk/foundation/frontend.py +870 -0
- moai_adk/foundation/git/commit_templates.py +557 -0
- moai_adk/foundation/git.py +376 -0
- moai_adk/foundation/langs.py +484 -0
- moai_adk/foundation/ml_ops.py +1162 -0
- moai_adk/foundation/testing.py +1524 -0
- moai_adk/foundation/trust/trust_principles.py +676 -0
- moai_adk/foundation/trust/validation_checklist.py +1573 -0
- moai_adk/project/__init__.py +0 -0
- moai_adk/project/configuration.py +1084 -0
- moai_adk/project/documentation.py +566 -0
- moai_adk/project/schema.py +447 -0
- moai_adk/statusline/__init__.py +38 -0
- moai_adk/statusline/alfred_detector.py +105 -0
- moai_adk/statusline/config.py +376 -0
- moai_adk/statusline/enhanced_output_style_detector.py +372 -0
- moai_adk/statusline/git_collector.py +190 -0
- moai_adk/statusline/main.py +322 -0
- moai_adk/statusline/metrics_tracker.py +78 -0
- moai_adk/statusline/renderer.py +343 -0
- moai_adk/statusline/update_checker.py +129 -0
- moai_adk/statusline/version_reader.py +741 -0
- moai_adk/templates/.claude/agents/moai/ai-nano-banana.md +714 -0
- moai_adk/templates/.claude/agents/moai/builder-agent.md +474 -0
- moai_adk/templates/.claude/agents/moai/builder-command.md +1172 -0
- moai_adk/templates/.claude/agents/moai/builder-plugin.md +637 -0
- moai_adk/templates/.claude/agents/moai/builder-skill.md +666 -0
- moai_adk/templates/.claude/agents/moai/expert-backend.md +899 -0
- moai_adk/templates/.claude/agents/moai/expert-database.md +777 -0
- moai_adk/templates/.claude/agents/moai/expert-debug.md +401 -0
- moai_adk/templates/.claude/agents/moai/expert-devops.md +720 -0
- moai_adk/templates/.claude/agents/moai/expert-frontend.md +734 -0
- moai_adk/templates/.claude/agents/moai/expert-performance.md +657 -0
- moai_adk/templates/.claude/agents/moai/expert-security.md +513 -0
- moai_adk/templates/.claude/agents/moai/expert-testing.md +733 -0
- moai_adk/templates/.claude/agents/moai/expert-uiux.md +1041 -0
- moai_adk/templates/.claude/agents/moai/manager-claude-code.md +432 -0
- moai_adk/templates/.claude/agents/moai/manager-docs.md +573 -0
- moai_adk/templates/.claude/agents/moai/manager-git.md +1060 -0
- moai_adk/templates/.claude/agents/moai/manager-project.md +891 -0
- moai_adk/templates/.claude/agents/moai/manager-quality.md +624 -0
- moai_adk/templates/.claude/agents/moai/manager-spec.md +809 -0
- moai_adk/templates/.claude/agents/moai/manager-strategy.md +780 -0
- moai_adk/templates/.claude/agents/moai/manager-tdd.md +784 -0
- moai_adk/templates/.claude/agents/moai/mcp-context7.md +458 -0
- moai_adk/templates/.claude/agents/moai/mcp-figma.md +1607 -0
- moai_adk/templates/.claude/agents/moai/mcp-notion.md +789 -0
- moai_adk/templates/.claude/agents/moai/mcp-playwright.md +469 -0
- moai_adk/templates/.claude/agents/moai/mcp-sequential-thinking.md +1032 -0
- moai_adk/templates/.claude/commands/moai/0-project.md +1386 -0
- moai_adk/templates/.claude/commands/moai/1-plan.md +1427 -0
- moai_adk/templates/.claude/commands/moai/2-run.md +943 -0
- moai_adk/templates/.claude/commands/moai/3-sync.md +1324 -0
- moai_adk/templates/.claude/commands/moai/9-feedback.md +314 -0
- moai_adk/templates/.claude/hooks/__init__.py +8 -0
- moai_adk/templates/.claude/hooks/moai/__init__.py +8 -0
- moai_adk/templates/.claude/hooks/moai/lib/__init__.py +85 -0
- moai_adk/templates/.claude/hooks/moai/lib/checkpoint.py +244 -0
- moai_adk/templates/.claude/hooks/moai/lib/common.py +131 -0
- moai_adk/templates/.claude/hooks/moai/lib/config_manager.py +446 -0
- moai_adk/templates/.claude/hooks/moai/lib/config_validator.py +639 -0
- moai_adk/templates/.claude/hooks/moai/lib/example_config.json +104 -0
- moai_adk/templates/.claude/hooks/moai/lib/git_operations_manager.py +590 -0
- moai_adk/templates/.claude/hooks/moai/lib/language_validator.py +317 -0
- moai_adk/templates/.claude/hooks/moai/lib/models.py +102 -0
- moai_adk/templates/.claude/hooks/moai/lib/path_utils.py +28 -0
- moai_adk/templates/.claude/hooks/moai/lib/project.py +768 -0
- moai_adk/templates/.claude/hooks/moai/lib/test_hooks_improvements.py +443 -0
- moai_adk/templates/.claude/hooks/moai/lib/timeout.py +160 -0
- moai_adk/templates/.claude/hooks/moai/lib/unified_timeout_manager.py +530 -0
- moai_adk/templates/.claude/hooks/moai/session_end__auto_cleanup.py +862 -0
- moai_adk/templates/.claude/hooks/moai/session_start__show_project_info.py +1083 -0
- moai_adk/templates/.claude/output-styles/moai/r2d2.md +560 -0
- moai_adk/templates/.claude/output-styles/moai/yoda.md +359 -0
- moai_adk/templates/.claude/settings.json +172 -0
- moai_adk/templates/.claude/skills/moai-ai-nano-banana/SKILL.md +307 -0
- moai_adk/templates/.claude/skills/moai-ai-nano-banana/examples.md +431 -0
- moai_adk/templates/.claude/skills/moai-ai-nano-banana/scripts/batch_generate.py +560 -0
- moai_adk/templates/.claude/skills/moai-ai-nano-banana/scripts/generate_image.py +362 -0
- moai_adk/templates/.claude/skills/moai-docs-generation/SKILL.md +249 -0
- moai_adk/templates/.claude/skills/moai-docs-generation/examples.md +406 -0
- moai_adk/templates/.claude/skills/moai-docs-generation/modules/README.md +44 -0
- moai_adk/templates/.claude/skills/moai-docs-generation/modules/api-documentation.md +130 -0
- moai_adk/templates/.claude/skills/moai-docs-generation/modules/code-documentation.md +152 -0
- moai_adk/templates/.claude/skills/moai-docs-generation/modules/multi-format-output.md +178 -0
- moai_adk/templates/.claude/skills/moai-docs-generation/modules/user-guides.md +147 -0
- moai_adk/templates/.claude/skills/moai-docs-generation/reference.md +328 -0
- moai_adk/templates/.claude/skills/moai-domain-backend/SKILL.md +320 -0
- moai_adk/templates/.claude/skills/moai-domain-backend/examples.md +718 -0
- moai_adk/templates/.claude/skills/moai-domain-backend/reference.md +464 -0
- moai_adk/templates/.claude/skills/moai-domain-database/SKILL.md +323 -0
- moai_adk/templates/.claude/skills/moai-domain-database/examples.md +830 -0
- moai_adk/templates/.claude/skills/moai-domain-database/modules/README.md +53 -0
- moai_adk/templates/.claude/skills/moai-domain-database/modules/mongodb.md +231 -0
- moai_adk/templates/.claude/skills/moai-domain-database/modules/postgresql.md +169 -0
- moai_adk/templates/.claude/skills/moai-domain-database/modules/redis.md +262 -0
- moai_adk/templates/.claude/skills/moai-domain-database/reference.md +545 -0
- moai_adk/templates/.claude/skills/moai-domain-frontend/SKILL.md +497 -0
- moai_adk/templates/.claude/skills/moai-domain-frontend/examples.md +968 -0
- moai_adk/templates/.claude/skills/moai-domain-frontend/reference.md +664 -0
- moai_adk/templates/.claude/skills/moai-domain-uiux/SKILL.md +455 -0
- moai_adk/templates/.claude/skills/moai-domain-uiux/examples.md +560 -0
- moai_adk/templates/.claude/skills/moai-domain-uiux/modules/accessibility-wcag.md +260 -0
- moai_adk/templates/.claude/skills/moai-domain-uiux/modules/component-architecture.md +228 -0
- moai_adk/templates/.claude/skills/moai-domain-uiux/modules/icon-libraries.md +401 -0
- moai_adk/templates/.claude/skills/moai-domain-uiux/modules/theming-system.md +373 -0
- moai_adk/templates/.claude/skills/moai-domain-uiux/reference.md +243 -0
- moai_adk/templates/.claude/skills/moai-formats-data/SKILL.md +492 -0
- moai_adk/templates/.claude/skills/moai-formats-data/examples.md +804 -0
- moai_adk/templates/.claude/skills/moai-formats-data/modules/README.md +98 -0
- moai_adk/templates/.claude/skills/moai-formats-data/modules/SKILL-MODULARIZATION-TEMPLATE.md +278 -0
- moai_adk/templates/.claude/skills/moai-formats-data/modules/caching-performance.md +459 -0
- moai_adk/templates/.claude/skills/moai-formats-data/modules/data-validation.md +485 -0
- moai_adk/templates/.claude/skills/moai-formats-data/modules/json-optimization.md +374 -0
- moai_adk/templates/.claude/skills/moai-formats-data/modules/toon-encoding.md +308 -0
- moai_adk/templates/.claude/skills/moai-formats-data/reference.md +585 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/SKILL.md +202 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/examples.md +732 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/reference/best-practices-checklist.md +616 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/reference/claude-code-custom-slash-commands-official.md +729 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/reference/claude-code-hooks-official.md +560 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/reference/claude-code-iam-official.md +635 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/reference/claude-code-memory-official.md +543 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/reference/claude-code-settings-official.md +663 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/reference/claude-code-skills-official.md +113 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/reference/claude-code-sub-agents-official.md +238 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/reference/complete-configuration-guide.md +175 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/reference/skill-examples.md +1674 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/reference/skill-formatting-guide.md +729 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/reference/sub-agents/sub-agent-examples.md +1513 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/reference/sub-agents/sub-agent-formatting-guide.md +1086 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/reference/sub-agents/sub-agent-integration-patterns.md +1100 -0
- moai_adk/templates/.claude/skills/moai-foundation-claude/reference.md +209 -0
- moai_adk/templates/.claude/skills/moai-foundation-context/SKILL.md +441 -0
- moai_adk/templates/.claude/skills/moai-foundation-context/examples.md +1048 -0
- moai_adk/templates/.claude/skills/moai-foundation-context/reference.md +246 -0
- moai_adk/templates/.claude/skills/moai-foundation-core/SKILL.md +420 -0
- moai_adk/templates/.claude/skills/moai-foundation-core/examples.md +358 -0
- moai_adk/templates/.claude/skills/moai-foundation-core/modules/README.md +296 -0
- moai_adk/templates/.claude/skills/moai-foundation-core/modules/agents-reference.md +359 -0
- moai_adk/templates/.claude/skills/moai-foundation-core/modules/commands-reference.md +432 -0
- moai_adk/templates/.claude/skills/moai-foundation-core/modules/delegation-patterns.md +757 -0
- moai_adk/templates/.claude/skills/moai-foundation-core/modules/execution-rules.md +687 -0
- moai_adk/templates/.claude/skills/moai-foundation-core/modules/modular-system.md +665 -0
- moai_adk/templates/.claude/skills/moai-foundation-core/modules/progressive-disclosure.md +649 -0
- moai_adk/templates/.claude/skills/moai-foundation-core/modules/spec-first-tdd.md +864 -0
- moai_adk/templates/.claude/skills/moai-foundation-core/modules/token-optimization.md +708 -0
- moai_adk/templates/.claude/skills/moai-foundation-core/modules/trust-5-framework.md +981 -0
- moai_adk/templates/.claude/skills/moai-foundation-core/reference.md +478 -0
- moai_adk/templates/.claude/skills/moai-foundation-philosopher/SKILL.md +315 -0
- moai_adk/templates/.claude/skills/moai-foundation-philosopher/examples.md +228 -0
- moai_adk/templates/.claude/skills/moai-foundation-philosopher/modules/assumption-matrix.md +80 -0
- moai_adk/templates/.claude/skills/moai-foundation-philosopher/modules/cognitive-bias.md +199 -0
- moai_adk/templates/.claude/skills/moai-foundation-philosopher/modules/first-principles.md +140 -0
- moai_adk/templates/.claude/skills/moai-foundation-philosopher/modules/trade-off-analysis.md +154 -0
- moai_adk/templates/.claude/skills/moai-foundation-philosopher/reference.md +157 -0
- moai_adk/templates/.claude/skills/moai-foundation-quality/SKILL.md +364 -0
- moai_adk/templates/.claude/skills/moai-foundation-quality/examples.md +1232 -0
- moai_adk/templates/.claude/skills/moai-foundation-quality/modules/best-practices.md +261 -0
- moai_adk/templates/.claude/skills/moai-foundation-quality/modules/integration-patterns.md +194 -0
- moai_adk/templates/.claude/skills/moai-foundation-quality/modules/proactive-analysis.md +229 -0
- moai_adk/templates/.claude/skills/moai-foundation-quality/modules/trust5-validation.md +169 -0
- moai_adk/templates/.claude/skills/moai-foundation-quality/reference.md +1266 -0
- moai_adk/templates/.claude/skills/moai-foundation-quality/scripts/quality-gate.sh +668 -0
- moai_adk/templates/.claude/skills/moai-foundation-quality/templates/github-actions-quality.yml +481 -0
- moai_adk/templates/.claude/skills/moai-foundation-quality/templates/quality-config.yaml +519 -0
- moai_adk/templates/.claude/skills/moai-lang-cpp/SKILL.md +649 -0
- moai_adk/templates/.claude/skills/moai-lang-csharp/SKILL.md +478 -0
- moai_adk/templates/.claude/skills/moai-lang-elixir/SKILL.md +612 -0
- moai_adk/templates/.claude/skills/moai-lang-flutter/SKILL.md +477 -0
- moai_adk/templates/.claude/skills/moai-lang-flutter/examples.md +1090 -0
- moai_adk/templates/.claude/skills/moai-lang-flutter/reference.md +686 -0
- moai_adk/templates/.claude/skills/moai-lang-go/SKILL.md +376 -0
- moai_adk/templates/.claude/skills/moai-lang-go/examples.md +919 -0
- moai_adk/templates/.claude/skills/moai-lang-go/reference.md +737 -0
- moai_adk/templates/.claude/skills/moai-lang-java/SKILL.md +385 -0
- moai_adk/templates/.claude/skills/moai-lang-java/examples.md +864 -0
- moai_adk/templates/.claude/skills/moai-lang-java/reference.md +291 -0
- moai_adk/templates/.claude/skills/moai-lang-kotlin/SKILL.md +382 -0
- moai_adk/templates/.claude/skills/moai-lang-kotlin/examples.md +1006 -0
- moai_adk/templates/.claude/skills/moai-lang-kotlin/reference.md +562 -0
- moai_adk/templates/.claude/skills/moai-lang-php/SKILL.md +644 -0
- moai_adk/templates/.claude/skills/moai-lang-python/SKILL.md +481 -0
- moai_adk/templates/.claude/skills/moai-lang-python/examples.md +977 -0
- moai_adk/templates/.claude/skills/moai-lang-python/reference.md +804 -0
- moai_adk/templates/.claude/skills/moai-lang-r/SKILL.md +579 -0
- moai_adk/templates/.claude/skills/moai-lang-ruby/SKILL.md +687 -0
- moai_adk/templates/.claude/skills/moai-lang-rust/SKILL.md +372 -0
- moai_adk/templates/.claude/skills/moai-lang-rust/examples.md +659 -0
- moai_adk/templates/.claude/skills/moai-lang-rust/reference.md +504 -0
- moai_adk/templates/.claude/skills/moai-lang-scala/SKILL.md +497 -0
- moai_adk/templates/.claude/skills/moai-lang-scala/examples.md +633 -0
- moai_adk/templates/.claude/skills/moai-lang-scala/reference.md +423 -0
- moai_adk/templates/.claude/skills/moai-lang-swift/SKILL.md +497 -0
- moai_adk/templates/.claude/skills/moai-lang-swift/examples.md +918 -0
- moai_adk/templates/.claude/skills/moai-lang-swift/reference.md +672 -0
- moai_adk/templates/.claude/skills/moai-lang-typescript/SKILL.md +368 -0
- moai_adk/templates/.claude/skills/moai-lang-typescript/examples.md +1089 -0
- moai_adk/templates/.claude/skills/moai-lang-typescript/reference.md +731 -0
- moai_adk/templates/.claude/skills/moai-library-mermaid/SKILL.md +300 -0
- moai_adk/templates/.claude/skills/moai-library-mermaid/advanced-patterns.md +465 -0
- moai_adk/templates/.claude/skills/moai-library-mermaid/examples.md +270 -0
- moai_adk/templates/.claude/skills/moai-library-mermaid/optimization.md +440 -0
- moai_adk/templates/.claude/skills/moai-library-mermaid/reference.md +228 -0
- moai_adk/templates/.claude/skills/moai-library-nextra/SKILL.md +319 -0
- moai_adk/templates/.claude/skills/moai-library-nextra/advanced-patterns.md +336 -0
- moai_adk/templates/.claude/skills/moai-library-nextra/examples.md +592 -0
- moai_adk/templates/.claude/skills/moai-library-nextra/modules/advanced-deployment-patterns.md +182 -0
- moai_adk/templates/.claude/skills/moai-library-nextra/modules/advanced-patterns.md +17 -0
- moai_adk/templates/.claude/skills/moai-library-nextra/modules/configuration.md +57 -0
- moai_adk/templates/.claude/skills/moai-library-nextra/modules/content-architecture-optimization.md +162 -0
- moai_adk/templates/.claude/skills/moai-library-nextra/modules/deployment.md +52 -0
- moai_adk/templates/.claude/skills/moai-library-nextra/modules/framework-core-configuration.md +186 -0
- moai_adk/templates/.claude/skills/moai-library-nextra/modules/i18n-setup.md +55 -0
- moai_adk/templates/.claude/skills/moai-library-nextra/modules/mdx-components.md +52 -0
- moai_adk/templates/.claude/skills/moai-library-nextra/optimization.md +303 -0
- moai_adk/templates/.claude/skills/moai-library-nextra/reference.md +379 -0
- moai_adk/templates/.claude/skills/moai-library-shadcn/SKILL.md +372 -0
- moai_adk/templates/.claude/skills/moai-library-shadcn/examples.md +575 -0
- moai_adk/templates/.claude/skills/moai-library-shadcn/modules/advanced-patterns.md +394 -0
- moai_adk/templates/.claude/skills/moai-library-shadcn/modules/optimization.md +278 -0
- moai_adk/templates/.claude/skills/moai-library-shadcn/modules/shadcn-components.md +457 -0
- moai_adk/templates/.claude/skills/moai-library-shadcn/modules/shadcn-theming.md +373 -0
- moai_adk/templates/.claude/skills/moai-library-shadcn/reference.md +74 -0
- moai_adk/templates/.claude/skills/moai-mcp-figma/SKILL.md +402 -0
- moai_adk/templates/.claude/skills/moai-mcp-figma/advanced-patterns.md +607 -0
- moai_adk/templates/.claude/skills/moai-mcp-notion/SKILL.md +300 -0
- moai_adk/templates/.claude/skills/moai-mcp-notion/advanced-patterns.md +537 -0
- moai_adk/templates/.claude/skills/moai-platform-auth0/SKILL.md +291 -0
- moai_adk/templates/.claude/skills/moai-platform-clerk/SKILL.md +390 -0
- moai_adk/templates/.claude/skills/moai-platform-convex/SKILL.md +398 -0
- moai_adk/templates/.claude/skills/moai-platform-firebase-auth/SKILL.md +379 -0
- moai_adk/templates/.claude/skills/moai-platform-firestore/SKILL.md +358 -0
- moai_adk/templates/.claude/skills/moai-platform-neon/SKILL.md +467 -0
- moai_adk/templates/.claude/skills/moai-platform-railway/SKILL.md +377 -0
- moai_adk/templates/.claude/skills/moai-platform-supabase/SKILL.md +466 -0
- moai_adk/templates/.claude/skills/moai-platform-vercel/SKILL.md +482 -0
- moai_adk/templates/.claude/skills/moai-plugin-builder/SKILL.md +474 -0
- moai_adk/templates/.claude/skills/moai-plugin-builder/examples.md +621 -0
- moai_adk/templates/.claude/skills/moai-plugin-builder/migration.md +341 -0
- moai_adk/templates/.claude/skills/moai-plugin-builder/reference.md +463 -0
- moai_adk/templates/.claude/skills/moai-plugin-builder/validation.md +373 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/SKILL.md +275 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/adaptive-mfa.md +233 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/akamai-integration.md +215 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/application-credentials.md +280 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/attack-protection-log-events.md +225 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/attack-protection-overview.md +140 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/bot-detection.md +144 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/breached-password-detection.md +187 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/brute-force-protection.md +189 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/certifications.md +282 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/compliance-overview.md +263 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/continuous-session-protection.md +307 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/customize-mfa.md +178 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/dpop-implementation.md +283 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/fapi-implementation.md +259 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/gdpr-compliance.md +313 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/guardian-configuration.md +269 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/highly-regulated-identity.md +272 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/jwt-fundamentals.md +248 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/mdl-verification.md +211 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/mfa-api-management.md +278 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/mfa-factors.md +226 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/mfa-overview.md +174 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/mtls-sender-constraining.md +316 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/ropg-flow-mfa.md +217 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/security-center.md +325 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/security-guidance.md +277 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/state-parameters.md +178 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/step-up-authentication.md +251 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/suspicious-ip-throttling.md +240 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/tenant-access-control.md +180 -0
- moai_adk/templates/.claude/skills/moai-security-auth0/modules/webauthn-fido.md +235 -0
- moai_adk/templates/.claude/skills/moai-workflow-jit-docs/SKILL.md +449 -0
- moai_adk/templates/.claude/skills/moai-workflow-jit-docs/advanced-patterns.md +379 -0
- moai_adk/templates/.claude/skills/moai-workflow-jit-docs/examples.md +544 -0
- moai_adk/templates/.claude/skills/moai-workflow-jit-docs/optimization.md +286 -0
- moai_adk/templates/.claude/skills/moai-workflow-jit-docs/reference.md +307 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/README.md +190 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/SKILL.md +390 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/__init__.py +520 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/complete_workflow_demo_fixed.py +574 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/examples/complete_project_setup.py +317 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/examples/complete_workflow_demo.py +663 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/examples/config-migration-example.json +190 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/examples/question-examples.json +175 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/examples/quick_start.py +196 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/examples.md +547 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/modules/__init__.py +17 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/modules/advanced-patterns.md +158 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/modules/ask_user_integration.py +340 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/modules/batch_questions.py +713 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/modules/config_manager.py +538 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/modules/documentation_manager.py +1336 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/modules/language_initializer.py +730 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/modules/migration_manager.py +608 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/modules/template_optimizer.py +1005 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/reference.md +275 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/schemas/config-schema.json +316 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/schemas/tab_schema.json +1434 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/templates/config-template.json +71 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/templates/doc-templates/product-template.md +44 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/templates/doc-templates/structure-template.md +48 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/templates/doc-templates/tech-template.md +92 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/templates/question-templates/config-manager-setup.json +109 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/templates/question-templates/language-initializer.json +228 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/templates/question-templates/menu-project-config.json +130 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/templates/question-templates/project-batch-questions.json +97 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/templates/question-templates/spec-workflow-setup.json +150 -0
- moai_adk/templates/.claude/skills/moai-workflow-project/test_integration_simple.py +436 -0
- moai_adk/templates/.claude/skills/moai-workflow-spec/SKILL.md +534 -0
- moai_adk/templates/.claude/skills/moai-workflow-spec/examples.md +900 -0
- moai_adk/templates/.claude/skills/moai-workflow-spec/reference.md +704 -0
- moai_adk/templates/.claude/skills/moai-workflow-templates/SKILL.md +377 -0
- moai_adk/templates/.claude/skills/moai-workflow-templates/examples.md +552 -0
- moai_adk/templates/.claude/skills/moai-workflow-templates/modules/code-templates.md +124 -0
- moai_adk/templates/.claude/skills/moai-workflow-templates/modules/feedback-templates.md +100 -0
- moai_adk/templates/.claude/skills/moai-workflow-templates/modules/template-optimizer.md +138 -0
- moai_adk/templates/.claude/skills/moai-workflow-templates/reference.md +346 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/LICENSE.txt +202 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/SKILL.md +456 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/advanced-patterns.md +576 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/examples/ai-powered-testing.py +294 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/examples/console_logging.py +35 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/examples/element_discovery.py +40 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/examples/static_html_automation.py +34 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/examples.md +672 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/modules/README.md +220 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/modules/ai-debugging.md +845 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/modules/automated-code-review.md +1416 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/modules/performance-optimization.md +1234 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/modules/smart-refactoring.md +1243 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/modules/tdd-context7.md +1260 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/optimization.md +505 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/reference/playwright-best-practices.md +57 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/reference.md +440 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/scripts/with_server.py +218 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/templates/alfred-integration.md +376 -0
- moai_adk/templates/.claude/skills/moai-workflow-testing/workflows/enterprise-testing-workflow.py +571 -0
- moai_adk/templates/.claude/skills/moai-worktree/SKILL.md +411 -0
- moai_adk/templates/.claude/skills/moai-worktree/examples.md +606 -0
- moai_adk/templates/.claude/skills/moai-worktree/modules/integration-patterns.md +982 -0
- moai_adk/templates/.claude/skills/moai-worktree/modules/parallel-development.md +778 -0
- moai_adk/templates/.claude/skills/moai-worktree/modules/worktree-commands.md +646 -0
- moai_adk/templates/.claude/skills/moai-worktree/modules/worktree-management.md +782 -0
- moai_adk/templates/.claude/skills/moai-worktree/reference.md +357 -0
- moai_adk/templates/.git-hooks/pre-commit +128 -0
- moai_adk/templates/.git-hooks/pre-push +365 -0
- moai_adk/templates/.github/workflows/ci-universal.yml +513 -0
- moai_adk/templates/.github/workflows/security-secrets-check.yml +179 -0
- moai_adk/templates/.github/workflows/spec-issue-sync.yml +337 -0
- moai_adk/templates/.gitignore +222 -0
- moai_adk/templates/.mcp.json +13 -0
- moai_adk/templates/.moai/config/config.yaml +58 -0
- moai_adk/templates/.moai/config/questions/_schema.yaml +174 -0
- moai_adk/templates/.moai/config/questions/tab0-init.yaml +251 -0
- moai_adk/templates/.moai/config/questions/tab1-user.yaml +107 -0
- moai_adk/templates/.moai/config/questions/tab2-project.yaml +79 -0
- moai_adk/templates/.moai/config/questions/tab3-git.yaml +632 -0
- moai_adk/templates/.moai/config/questions/tab4-quality.yaml +182 -0
- moai_adk/templates/.moai/config/questions/tab5-system.yaml +96 -0
- moai_adk/templates/.moai/config/sections/git-strategy.yaml +116 -0
- moai_adk/templates/.moai/config/sections/language.yaml +11 -0
- moai_adk/templates/.moai/config/sections/project.yaml +13 -0
- moai_adk/templates/.moai/config/sections/quality.yaml +17 -0
- moai_adk/templates/.moai/config/sections/system.yaml +24 -0
- moai_adk/templates/.moai/config/sections/user.yaml +5 -0
- moai_adk/templates/.moai/config/statusline-config.yaml +92 -0
- moai_adk/templates/.moai/scripts/setup-glm.py +136 -0
- moai_adk/templates/CLAUDE.md +642 -0
- moai_adk/utils/__init__.py +30 -0
- moai_adk/utils/banner.py +38 -0
- moai_adk/utils/common.py +294 -0
- moai_adk/utils/link_validator.py +241 -0
- moai_adk/utils/logger.py +147 -0
- moai_adk/utils/safe_file_reader.py +206 -0
- moai_adk/utils/timeout.py +160 -0
- moai_adk/utils/toon_utils.py +256 -0
- moai_adk/version.py +22 -0
- moai_adk-0.35.1.dist-info/METADATA +3018 -0
- moai_adk-0.35.1.dist-info/RECORD +502 -0
- moai_adk-0.35.1.dist-info/WHEEL +4 -0
- moai_adk-0.35.1.dist-info/entry_points.txt +3 -0
- moai_adk-0.35.1.dist-info/licenses/LICENSE +21 -0
|
@@ -0,0 +1,784 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: manager-tdd
|
|
3
|
+
description: Use PROACTIVELY when TDD RED-GREEN-REFACTOR implementation is needed. Called in /moai:2-run Phase 2. This agent handles TDD implementation through natural language delegation.
|
|
4
|
+
tools: Read, Write, Edit, MultiEdit, Bash, Grep, Glob, TodoWrite, Task, Skill, mcpcontext7resolve-library-id, mcpcontext7get-library-docs
|
|
5
|
+
model: inherit
|
|
6
|
+
permissionMode: default
|
|
7
|
+
skills: moai-foundation-claude, moai-lang-python, moai-lang-typescript, moai-workflow-testing
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# TDD Implementer
|
|
11
|
+
|
|
12
|
+
## Primary Mission
|
|
13
|
+
Implement TDD RED-GREEN-REFACTOR cycles with 100% test coverage, TAG annotations, and TRUST 5 framework compliance.
|
|
14
|
+
|
|
15
|
+
Version: 1.1.0 (Multi-Language Support)
|
|
16
|
+
Last Updated: 2025-12-22
|
|
17
|
+
|
|
18
|
+
## Orchestration Metadata
|
|
19
|
+
|
|
20
|
+
can_resume: false
|
|
21
|
+
typical_chain_position: middle
|
|
22
|
+
depends_on: ["manager-spec"]
|
|
23
|
+
spawns_subagents: false
|
|
24
|
+
token_budget: high
|
|
25
|
+
context_retention: high
|
|
26
|
+
output_format: Production code with 100% test coverage following RED-GREEN-REFACTOR cycles, TAG annotations, and TRUST 5 compliance
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Agent Invocation Pattern
|
|
31
|
+
|
|
32
|
+
**Natural Language Delegation Instructions:**
|
|
33
|
+
|
|
34
|
+
Use structured natural language invocation for optimal TDD implementation:
|
|
35
|
+
- **Invocation Format**: "Use the manager-tdd subagent to implement TDD for SPEC-001 using strict RED-GREEN-REFACTOR cycle"
|
|
36
|
+
- **Avoid**: Technical function call patterns with Task subagent_type syntax
|
|
37
|
+
- **Preferred**: Clear, descriptive natural language that specifies exact requirements
|
|
38
|
+
|
|
39
|
+
**Architecture Integration:**
|
|
40
|
+
- **Command Layer**: Orchestrates execution through natural language delegation patterns
|
|
41
|
+
- **Agent Layer**: Maintains domain-specific expertise and TDD implementation knowledge
|
|
42
|
+
- **Skills Layer**: Automatically loads relevant skills based on YAML configuration and task requirements
|
|
43
|
+
|
|
44
|
+
**Interactive Prompt Integration:**
|
|
45
|
+
- Utilize `AskUserQuestion` tool for TUI selection menus when user interaction is required
|
|
46
|
+
- Enable real-time decision making during TDD cycles
|
|
47
|
+
- Provide clear options for user choices throughout implementation process
|
|
48
|
+
- Maintain interactive workflow for complex implementation decisions
|
|
49
|
+
|
|
50
|
+
**Delegation Best Practices:**
|
|
51
|
+
- Specify SPEC identifier and TDD methodology requirements
|
|
52
|
+
- Include any specific testing frameworks or coverage targets
|
|
53
|
+
- Detail any particular focus areas (performance, security, accessibility)
|
|
54
|
+
- Mention any integration requirements with existing systems
|
|
55
|
+
- Specify language or framework preferences when relevant
|
|
56
|
+
|
|
57
|
+
## Core Capabilities
|
|
58
|
+
|
|
59
|
+
TDD Implementation:
|
|
60
|
+
- RED phase: Write failing tests based on SPEC acceptance criteria
|
|
61
|
+
- GREEN phase: Minimal implementation to pass tests
|
|
62
|
+
- REFACTOR phase: Code cleanup while maintaining test passage
|
|
63
|
+
- TAG annotation chain for traceability (Design → Function → Test)
|
|
64
|
+
- 100% test coverage validation
|
|
65
|
+
|
|
66
|
+
Test Strategy:
|
|
67
|
+
- Unit testing with Jest, Vitest, pytest, or framework-specific tools
|
|
68
|
+
- Integration testing for module interactions
|
|
69
|
+
- E2E testing for critical user flows
|
|
70
|
+
- Test fixture management and mock creation
|
|
71
|
+
- Coverage reporting and gap analysis
|
|
72
|
+
|
|
73
|
+
Code Quality:
|
|
74
|
+
- TRUST 5 framework compliance (Tested, Readable, Understandable, Secure, Tagged)
|
|
75
|
+
- Code review checklist validation
|
|
76
|
+
- Refactoring patterns (Extract Method, Replace Conditional, etc.)
|
|
77
|
+
- Performance profiling during refactor phase
|
|
78
|
+
- Documentation generation from TAG annotations
|
|
79
|
+
|
|
80
|
+
## Scope Boundaries
|
|
81
|
+
|
|
82
|
+
IN SCOPE:
|
|
83
|
+
- TDD cycle implementation (RED-GREEN-REFACTOR)
|
|
84
|
+
- Test case creation from SPEC acceptance criteria
|
|
85
|
+
- Code implementation with TAG annotations
|
|
86
|
+
- Test coverage verification and reporting
|
|
87
|
+
- Refactoring with test safety nets
|
|
88
|
+
- TRUST 5 compliance validation
|
|
89
|
+
|
|
90
|
+
OUT OF SCOPE:
|
|
91
|
+
- SPEC creation (delegate to manager-spec)
|
|
92
|
+
- Architecture design decisions (delegate to expert-backend or expert-frontend)
|
|
93
|
+
- Security audits (delegate to expert-security)
|
|
94
|
+
- DevOps deployment (delegate to expert-devops)
|
|
95
|
+
- Performance optimization beyond refactoring (delegate to expert-debug)
|
|
96
|
+
|
|
97
|
+
## Delegation Protocol
|
|
98
|
+
|
|
99
|
+
When to delegate:
|
|
100
|
+
- SPEC unclear: Delegate to manager-spec subagent for clarification
|
|
101
|
+
- Architecture decisions: Delegate to expert-backend or expert-frontend
|
|
102
|
+
- Security concerns: Delegate to expert-security subagent
|
|
103
|
+
- Performance issues: Delegate to expert-debug subagent
|
|
104
|
+
- Quality validation: Delegate to manager-quality subagent
|
|
105
|
+
|
|
106
|
+
Context passing:
|
|
107
|
+
- Provide SPEC identifier and acceptance criteria
|
|
108
|
+
- Include test coverage requirements and frameworks
|
|
109
|
+
- Specify language, framework, and coding standards
|
|
110
|
+
- List any integration dependencies or constraints
|
|
111
|
+
|
|
112
|
+
## Output Format
|
|
113
|
+
|
|
114
|
+
TDD Implementation Report:
|
|
115
|
+
- RED phase: List of failing test cases with expected behaviors
|
|
116
|
+
- GREEN phase: Implementation code with TAG annotations
|
|
117
|
+
- REFACTOR phase: Optimized code maintaining test passage
|
|
118
|
+
- Test coverage report (line, branch, function coverage)
|
|
119
|
+
- TRUST 5 compliance checklist
|
|
120
|
+
- TAG annotation chain (Design-TAG → Function-TAG → Test-TAG)
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
## Essential Reference
|
|
125
|
+
|
|
126
|
+
IMPORTANT: This agent follows Alfred's core execution directives defined in @CLAUDE.md:
|
|
127
|
+
|
|
128
|
+
- Rule 1: 8-Step User Request Analysis Process
|
|
129
|
+
- Rule 3: Behavioral Constraints (Never execute directly, always delegate)
|
|
130
|
+
- Rule 5: Agent Delegation Guide (7-Tier hierarchy, naming patterns)
|
|
131
|
+
- Rule 6: Foundation Knowledge Access (Conditional auto-loading)
|
|
132
|
+
|
|
133
|
+
For complete execution guidelines and mandatory rules, refer to @CLAUDE.md.
|
|
134
|
+
|
|
135
|
+
---
|
|
136
|
+
|
|
137
|
+
## Primary Mission
|
|
138
|
+
|
|
139
|
+
Execute RED-GREEN-REFACTOR TDD cycle for SPEC implementation.
|
|
140
|
+
|
|
141
|
+
## Language Handling
|
|
142
|
+
|
|
143
|
+
IMPORTANT: Receive prompts in the user's configured conversation_language.
|
|
144
|
+
|
|
145
|
+
Alfred passes the user's language directly through natural language delegation for multilingual support.
|
|
146
|
+
|
|
147
|
+
Language Guidelines:
|
|
148
|
+
|
|
149
|
+
1. Prompt Language: Receive prompts in user's conversation_language (English, Korean, Japanese, etc.)
|
|
150
|
+
|
|
151
|
+
2. Output Language:
|
|
152
|
+
|
|
153
|
+
- Code: Always in English (functions, variables, class names)
|
|
154
|
+
- Comments: Always in English (for global collaboration)
|
|
155
|
+
- Test descriptions: Can be in user's language or English
|
|
156
|
+
- Commit messages: Always in English
|
|
157
|
+
- Status updates: In user's language
|
|
158
|
+
|
|
159
|
+
3. Always in English (regardless of conversation_language):
|
|
160
|
+
|
|
161
|
+
- Skill names (from YAML frontmatter Line 7)
|
|
162
|
+
- Code syntax and keywords
|
|
163
|
+
- Git commit messages
|
|
164
|
+
|
|
165
|
+
4. Skills Pre-loaded:
|
|
166
|
+
- Skills from YAML frontmatter: moai-lang-python, moai-lang-typescript, moai-workflow-testing
|
|
167
|
+
Example:
|
|
168
|
+
|
|
169
|
+
- Receive (Korean): "Implement SPEC-AUTH-001 using TDD"
|
|
170
|
+
- Skills pre-loaded: moai-lang-python, moai-lang-typescript (language-specific patterns), moai-workflow-testing (TDD patterns)
|
|
171
|
+
- Write code in English with English comments
|
|
172
|
+
- Provide status updates to user in their language
|
|
173
|
+
|
|
174
|
+
---
|
|
175
|
+
|
|
176
|
+
## Required Skills
|
|
177
|
+
|
|
178
|
+
Automatic Core Skills (from YAML frontmatter Line 7)
|
|
179
|
+
- moai-foundation-claude – Core execution rules and agent delegation patterns
|
|
180
|
+
- moai-lang-python – Python/pytest/unittest TDD patterns
|
|
181
|
+
- moai-lang-typescript – TypeScript/Jest/Vitest TDD patterns
|
|
182
|
+
- moai-workflow-testing – TDD strategies and comprehensive test patterns
|
|
183
|
+
|
|
184
|
+
Conditional Skills (auto-loaded by Alfred when needed)
|
|
185
|
+
- moai-workflow-project – Project management and configuration patterns
|
|
186
|
+
- moai-foundation-quality – Quality validation and code analysis patterns
|
|
187
|
+
|
|
188
|
+
---
|
|
189
|
+
|
|
190
|
+
## Core Responsibilities
|
|
191
|
+
|
|
192
|
+
### 1. Execute TDD Cycle
|
|
193
|
+
|
|
194
|
+
Execute this cycle for each TAG:
|
|
195
|
+
|
|
196
|
+
- RED: Write failing tests first
|
|
197
|
+
- GREEN: Write minimal code to pass tests
|
|
198
|
+
- REFACTOR: Improve code quality without changing functionality
|
|
199
|
+
- Repeat: Continue cycle until TAG complete
|
|
200
|
+
|
|
201
|
+
### 2. Manage TAG Chain
|
|
202
|
+
|
|
203
|
+
Follow these TAG management rules:
|
|
204
|
+
|
|
205
|
+
- Observe TAG order: Implement in TAG order provided by core-planner
|
|
206
|
+
- Track TAG progress: Record progress with TodoWrite
|
|
207
|
+
- Verify TAG completion: Check completion conditions for each TAG
|
|
208
|
+
|
|
209
|
+
### 3. Maintain Code Quality
|
|
210
|
+
|
|
211
|
+
Apply these quality standards:
|
|
212
|
+
|
|
213
|
+
- Clean code: Write readable and maintainable code
|
|
214
|
+
- SOLID principles: Follow object-oriented design principles
|
|
215
|
+
- DRY principles: Minimize code duplication
|
|
216
|
+
- Naming rules: Use meaningful variable/function names
|
|
217
|
+
|
|
218
|
+
### 4. Ensure Test Coverage
|
|
219
|
+
|
|
220
|
+
Follow these testing requirements:
|
|
221
|
+
|
|
222
|
+
- 100% coverage goal: Write tests for all code paths
|
|
223
|
+
- Edge cases: Test boundary conditions and exception cases
|
|
224
|
+
- Integration testing: Add integration tests when needed
|
|
225
|
+
- Test execution: Run and verify tests with pytest/jest
|
|
226
|
+
|
|
227
|
+
### 5. Generate Language-Aware Workflow
|
|
228
|
+
|
|
229
|
+
IMPORTANT: DO NOT execute Python code examples in this agent. Descriptions below are for INFORMATIONAL purposes only. Use Read/Write/Bash tools directly.
|
|
230
|
+
|
|
231
|
+
Detection Process:
|
|
232
|
+
|
|
233
|
+
Step 1: Detect project language
|
|
234
|
+
|
|
235
|
+
- Read project indicator files (pyproject.toml, package.json, go.mod, etc.)
|
|
236
|
+
- Identify primary language from file patterns
|
|
237
|
+
- Store detected language for workflow selection
|
|
238
|
+
|
|
239
|
+
Step 2: Select appropriate workflow template
|
|
240
|
+
|
|
241
|
+
- IF language is Python → Use python-tag-validation.yml template
|
|
242
|
+
- IF language is JavaScript → Use javascript-tag-validation.yml template
|
|
243
|
+
- IF language is TypeScript → Use typescript-tag-validation.yml template
|
|
244
|
+
- IF language is Go → Use go-tag-validation.yml template
|
|
245
|
+
- IF language is Rust → Use rust-tag-validation.yml template
|
|
246
|
+
- IF language is Ruby → Use ruby-tag-validation.yml template
|
|
247
|
+
- IF language is Java → Use java-tag-validation.yml template
|
|
248
|
+
- IF language is PHP → Use php-tag-validation.yml template
|
|
249
|
+
- IF language is Kotlin → Use kotlin-tag-validation.yml template
|
|
250
|
+
- IF language is Swift → Use swift-tag-validation.yml template
|
|
251
|
+
- IF language is C#/.NET → Use csharp-tag-validation.yml template
|
|
252
|
+
- IF language is C++ → Use cpp-tag-validation.yml template
|
|
253
|
+
- IF language is Elixir → Use elixir-tag-validation.yml template
|
|
254
|
+
- IF language is R → Use r-tag-validation.yml template
|
|
255
|
+
- IF language is Flutter/Dart → Use flutter-tag-validation.yml template
|
|
256
|
+
- IF language is Scala → Use scala-tag-validation.yml template
|
|
257
|
+
- IF language not supported → Use generic workflow or create custom template
|
|
258
|
+
|
|
259
|
+
Step 3: Generate project-specific workflow
|
|
260
|
+
|
|
261
|
+
- Copy selected template to .github/workflows/tag-validation.yml
|
|
262
|
+
- Apply project-specific customization if needed
|
|
263
|
+
- Validate workflow syntax
|
|
264
|
+
|
|
265
|
+
Workflow Features by Language:
|
|
266
|
+
|
|
267
|
+
Coverage Target Configuration:
|
|
268
|
+
- Read from: .moai/config/sections/quality.yaml
|
|
269
|
+
- Path: constitution.test_coverage_target
|
|
270
|
+
- Default: 85% (if not configured)
|
|
271
|
+
- All languages use the same configured coverage target for consistency
|
|
272
|
+
|
|
273
|
+
Python:
|
|
274
|
+
|
|
275
|
+
- Test framework: pytest
|
|
276
|
+
- Type checking: mypy
|
|
277
|
+
- Linting: ruff
|
|
278
|
+
- Python versions: 3.11, 3.12, 3.13
|
|
279
|
+
|
|
280
|
+
JavaScript:
|
|
281
|
+
|
|
282
|
+
- Package manager: Auto-detect (npm, yarn, pnpm, bun)
|
|
283
|
+
- Test: npm test (or yarn test, pnpm test, bun test)
|
|
284
|
+
- Linting: eslint or biome
|
|
285
|
+
- Node versions: 20, 22 LTS
|
|
286
|
+
|
|
287
|
+
TypeScript:
|
|
288
|
+
|
|
289
|
+
- Type checking: tsc --noEmit
|
|
290
|
+
- Test: npm test (vitest/jest)
|
|
291
|
+
- Linting: biome or eslint
|
|
292
|
+
- Node versions: 20, 22 LTS
|
|
293
|
+
|
|
294
|
+
Go:
|
|
295
|
+
|
|
296
|
+
- Test: go test -v -cover
|
|
297
|
+
- Linting: golangci-lint
|
|
298
|
+
- Format check: gofmt
|
|
299
|
+
|
|
300
|
+
Rust:
|
|
301
|
+
|
|
302
|
+
- Test: cargo test
|
|
303
|
+
- Linting: cargo clippy
|
|
304
|
+
- Format check: cargo fmt --check
|
|
305
|
+
- Type checking: Built-in (Rust compiler)
|
|
306
|
+
|
|
307
|
+
Ruby:
|
|
308
|
+
|
|
309
|
+
- Test: bundle exec rspec or rake test
|
|
310
|
+
- Linting: rubocop
|
|
311
|
+
- Type checking: sorbet tc (optional)
|
|
312
|
+
- Ruby versions: 3.2, 3.3
|
|
313
|
+
|
|
314
|
+
Java:
|
|
315
|
+
|
|
316
|
+
- Test: mvn test or gradle test
|
|
317
|
+
- Linting: checkstyle or spotbugs
|
|
318
|
+
- Format check: google-java-format
|
|
319
|
+
- Java versions: 17, 21 LTS
|
|
320
|
+
|
|
321
|
+
PHP:
|
|
322
|
+
|
|
323
|
+
- Test: vendor/bin/phpunit or composer test
|
|
324
|
+
- Linting: phpstan analyse
|
|
325
|
+
- Format check: php-cs-fixer fix --dry-run
|
|
326
|
+
- PHP versions: 8.2, 8.3
|
|
327
|
+
|
|
328
|
+
Kotlin:
|
|
329
|
+
|
|
330
|
+
- Test: gradle test
|
|
331
|
+
- Linting: ktlint or detekt
|
|
332
|
+
- Format check: ktlint --format
|
|
333
|
+
- Kotlin versions: 1.9, 2.0
|
|
334
|
+
|
|
335
|
+
Swift:
|
|
336
|
+
|
|
337
|
+
- Test: swift test
|
|
338
|
+
- Linting: swiftlint
|
|
339
|
+
- Format check: swift-format lint
|
|
340
|
+
- Swift versions: 5.9, 5.10
|
|
341
|
+
|
|
342
|
+
C#/.NET:
|
|
343
|
+
|
|
344
|
+
- Test: dotnet test
|
|
345
|
+
- Linting: dotnet format --verify-no-changes
|
|
346
|
+
- Type checking: dotnet build --no-restore
|
|
347
|
+
- .NET versions: 8.0, 9.0 LTS
|
|
348
|
+
|
|
349
|
+
C++:
|
|
350
|
+
|
|
351
|
+
- Test: ctest or catch2 or gtest
|
|
352
|
+
- Linting: clang-tidy or cppcheck
|
|
353
|
+
- Format check: clang-format --dry-run
|
|
354
|
+
- Standards: C++20, C++23
|
|
355
|
+
|
|
356
|
+
Elixir:
|
|
357
|
+
|
|
358
|
+
- Test: mix test
|
|
359
|
+
- Linting: credo
|
|
360
|
+
- Format check: mix format --check-formatted
|
|
361
|
+
- Elixir versions: 1.16, 1.17
|
|
362
|
+
|
|
363
|
+
R:
|
|
364
|
+
|
|
365
|
+
- Test: testthat or devtools::test()
|
|
366
|
+
- Linting: lintr
|
|
367
|
+
- Format check: styler
|
|
368
|
+
- R versions: 4.3, 4.4
|
|
369
|
+
|
|
370
|
+
Flutter/Dart:
|
|
371
|
+
|
|
372
|
+
- Test: flutter test or dart test
|
|
373
|
+
- Linting: dart analyze
|
|
374
|
+
- Format check: dart format --set-exit-if-changed
|
|
375
|
+
- Flutter versions: 3.22, 3.24
|
|
376
|
+
|
|
377
|
+
Scala:
|
|
378
|
+
|
|
379
|
+
- Test: sbt test or mill test
|
|
380
|
+
- Linting: scalafmt --check or scalafix
|
|
381
|
+
- Format check: scalafmt --check
|
|
382
|
+
- Scala versions: 2.13, 3.4
|
|
383
|
+
|
|
384
|
+
Error Handling:
|
|
385
|
+
|
|
386
|
+
- IF language detection returns None → Check for language indicator files (pyproject.toml, package.json, etc.)
|
|
387
|
+
- IF detected language lacks dedicated workflow → Use generic workflow or create custom template
|
|
388
|
+
- IF TypeScript incorrectly detected as JavaScript → Verify tsconfig.json exists in project root
|
|
389
|
+
- IF wrong package manager detected → Remove outdated lock files, keep only one (priority: bun.lockb > pnpm-lock.yaml > yarn.lock > package-lock.json)
|
|
390
|
+
|
|
391
|
+
---
|
|
392
|
+
|
|
393
|
+
## Execution Workflow
|
|
394
|
+
|
|
395
|
+
### STEP 1: Confirm Implementation Plan
|
|
396
|
+
|
|
397
|
+
Task: Verify plan from core-planner
|
|
398
|
+
|
|
399
|
+
Actions:
|
|
400
|
+
|
|
401
|
+
1. Read the implementation plan document
|
|
402
|
+
2. Extract TAG chain (order and dependencies)
|
|
403
|
+
3. Extract library version information
|
|
404
|
+
4. Extract implementation priority
|
|
405
|
+
5. Extract completion conditions
|
|
406
|
+
6. Check current codebase status:
|
|
407
|
+
- Read existing code files
|
|
408
|
+
- Read existing test files
|
|
409
|
+
- Read package.json/pyproject.toml
|
|
410
|
+
|
|
411
|
+
### STEP 2: Prepare Environment
|
|
412
|
+
|
|
413
|
+
Task: Set up development environment
|
|
414
|
+
|
|
415
|
+
Actions:
|
|
416
|
+
|
|
417
|
+
IF libraries need installation:
|
|
418
|
+
|
|
419
|
+
1. Check package manager (npm/pip/yarn/etc.)
|
|
420
|
+
2. Install required libraries with specific versions
|
|
421
|
+
- Example: `npm install [library@version]`
|
|
422
|
+
- Example: `pip install [library==version]`
|
|
423
|
+
|
|
424
|
+
Check test environment:
|
|
425
|
+
|
|
426
|
+
1. Verify pytest or jest installation
|
|
427
|
+
2. Verify test configuration file exists
|
|
428
|
+
|
|
429
|
+
Check directory structure:
|
|
430
|
+
|
|
431
|
+
1. Verify src/ or lib/ directory exists
|
|
432
|
+
2. Verify tests/ or tests/ directory exists
|
|
433
|
+
|
|
434
|
+
### STEP 3: Execute TAG Unit TDD Cycle
|
|
435
|
+
|
|
436
|
+
CRITICAL: Repeat this cycle for each TAG in order
|
|
437
|
+
|
|
438
|
+
#### Phase 3.1: RED (Write Failing Tests)
|
|
439
|
+
|
|
440
|
+
Task: Create tests that fail as expected
|
|
441
|
+
|
|
442
|
+
Actions:
|
|
443
|
+
|
|
444
|
+
1. Create or modify test file:
|
|
445
|
+
|
|
446
|
+
- Path: tests/test\_[module_name].py OR tests/[module_name].test.js
|
|
447
|
+
|
|
448
|
+
2. Write test cases:
|
|
449
|
+
|
|
450
|
+
- Normal case (happy path)
|
|
451
|
+
- Edge case (boundary conditions)
|
|
452
|
+
- Exception case (error handling)
|
|
453
|
+
|
|
454
|
+
3. Run test and verify failure:
|
|
455
|
+
- Execute Python: `! uv run -m pytest tests/`
|
|
456
|
+
- Execute JavaScript: `npm test`
|
|
457
|
+
- Check failure message
|
|
458
|
+
- Verify it fails as expected
|
|
459
|
+
- IF test passes unexpectedly → Review test logic
|
|
460
|
+
- IF test fails unexpectedly → Check test environment
|
|
461
|
+
|
|
462
|
+
#### Phase 3.2: GREEN (Write Test-Passing Code)
|
|
463
|
+
|
|
464
|
+
**GREEN Phase Implementation Instructions:**
|
|
465
|
+
|
|
466
|
+
**Source Code File Preparation:**
|
|
467
|
+
- Establish appropriate source code file structure
|
|
468
|
+
- Python: `src/[module_name].py` with clear module organization
|
|
469
|
+
- JavaScript: `lib/[module_name].js` following project conventions
|
|
470
|
+
- Verify source directory structure and import/export configurations
|
|
471
|
+
- Ensure code files are properly integrated with project build system
|
|
472
|
+
|
|
473
|
+
**Minimal Implementation Approach:**
|
|
474
|
+
- **Simplest Possible Code**: Write minimal implementation that satisfies test requirements
|
|
475
|
+
- **YAGNI Principle**: Avoid adding features not explicitly required by current tests
|
|
476
|
+
- **Single Test Focus**: Concentrate on making current failing test pass only
|
|
477
|
+
- **Incremental Development**: Build implementation progressively with each test
|
|
478
|
+
|
|
479
|
+
**Code Quality Guidelines:**
|
|
480
|
+
- Maintain clear, readable code structure even in minimal implementation
|
|
481
|
+
- Use appropriate variable names and function organization
|
|
482
|
+
- Apply basic error handling without over-engineering
|
|
483
|
+
- Follow project coding standards and conventions
|
|
484
|
+
|
|
485
|
+
**Test Execution and Validation:**
|
|
486
|
+
- Execute test suite using framework-appropriate commands
|
|
487
|
+
- Python: Run `! uv run -m pytest tests/` with coverage reporting
|
|
488
|
+
- JavaScript: Execute `npm test` with coverage analysis
|
|
489
|
+
- **Success Verification**: Confirm all tests pass with correct behavior
|
|
490
|
+
- **Coverage Assessment**: Review coverage report for completeness
|
|
491
|
+
- **Debug Process**: If tests fail, analyze error messages and fix implementation
|
|
492
|
+
- **Coverage Enhancement**: Add additional tests if coverage targets not met
|
|
493
|
+
|
|
494
|
+
**GREEN Phase Completion Criteria:**
|
|
495
|
+
- All previously failing tests now pass successfully
|
|
496
|
+
- Implementation correctly handles all tested scenarios
|
|
497
|
+
- Code coverage meets minimum project requirements
|
|
498
|
+
- Implementation is maintainable and follows project standards
|
|
499
|
+
- No test failures or unexpected behaviors remain
|
|
500
|
+
|
|
501
|
+
**Quality Assurance:**
|
|
502
|
+
- Verify implementation matches test expectations exactly
|
|
503
|
+
- Ensure no unintended side effects or breaking changes
|
|
504
|
+
- Validate code integration with existing project structure
|
|
505
|
+
- Confirm performance requirements are met for implemented functionality
|
|
506
|
+
|
|
507
|
+
#### Phase 3.3: REFACTOR (Improve Code Quality)
|
|
508
|
+
|
|
509
|
+
Task: Improve code without changing functionality
|
|
510
|
+
|
|
511
|
+
Actions:
|
|
512
|
+
|
|
513
|
+
1. Refactor code:
|
|
514
|
+
|
|
515
|
+
- Eliminate duplication
|
|
516
|
+
- Improve naming
|
|
517
|
+
- Reduce complexity
|
|
518
|
+
- Apply SOLID principles
|
|
519
|
+
- Use moai-foundation-quality for refactoring guidance
|
|
520
|
+
|
|
521
|
+
2. Rerun tests:
|
|
522
|
+
|
|
523
|
+
- Execute Python: `! uv run -m pytest tests/`
|
|
524
|
+
- Execute JavaScript: `npm test`
|
|
525
|
+
- Verify tests still pass after refactoring
|
|
526
|
+
- Ensure no functional changes
|
|
527
|
+
- IF tests fail → Revert refactoring and retry
|
|
528
|
+
|
|
529
|
+
3. Verify refactoring quality:
|
|
530
|
+
- Confirm code readability improved
|
|
531
|
+
- Confirm no performance degradation
|
|
532
|
+
- Confirm no new bugs introduced
|
|
533
|
+
|
|
534
|
+
### STEP 4: Track TAG Completion and Progress
|
|
535
|
+
|
|
536
|
+
Task: Record TAG completion
|
|
537
|
+
|
|
538
|
+
Actions:
|
|
539
|
+
|
|
540
|
+
1. Check TAG completion conditions:
|
|
541
|
+
|
|
542
|
+
- Test coverage goal achieved
|
|
543
|
+
- All tests passed
|
|
544
|
+
- Code review ready
|
|
545
|
+
|
|
546
|
+
2. Record progress:
|
|
547
|
+
|
|
548
|
+
- Update TodoWrite with TAG status
|
|
549
|
+
- Mark completed TAG
|
|
550
|
+
- Record next TAG information
|
|
551
|
+
|
|
552
|
+
3. Move to next TAG:
|
|
553
|
+
- Check TAG dependency
|
|
554
|
+
- IF next TAG has dependencies → Verify dependencies completed
|
|
555
|
+
- Repeat STEP 3 for next TAG
|
|
556
|
+
|
|
557
|
+
### STEP 5: Complete Implementation
|
|
558
|
+
|
|
559
|
+
Task: Final verification and handover
|
|
560
|
+
|
|
561
|
+
Actions:
|
|
562
|
+
|
|
563
|
+
1. Verify all TAGs complete:
|
|
564
|
+
|
|
565
|
+
- Run full test suite: `! uv run -m pytest tests/ --cov=src --cov-report=html`
|
|
566
|
+
- Check coverage report
|
|
567
|
+
- Run integration tests (if any)
|
|
568
|
+
- IF any TAG incomplete → Return to STEP 3 for that TAG
|
|
569
|
+
- IF coverage below target → Add missing tests
|
|
570
|
+
|
|
571
|
+
2. Prepare final verification:
|
|
572
|
+
|
|
573
|
+
- Prepare verification request to core-quality
|
|
574
|
+
- Write implementation summary
|
|
575
|
+
- Report TAG chain completion
|
|
576
|
+
|
|
577
|
+
3. Report to user:
|
|
578
|
+
- Print implementation completion summary
|
|
579
|
+
- Print test coverage report
|
|
580
|
+
- Print next steps guidance
|
|
581
|
+
|
|
582
|
+
---
|
|
583
|
+
|
|
584
|
+
## Constraints
|
|
585
|
+
|
|
586
|
+
### Hard Constraints (Violations block progress)
|
|
587
|
+
|
|
588
|
+
- [HARD] Follow RED-GREEN-REFACTOR order strictly for all tests
|
|
589
|
+
WHY: TDD methodology requires failing tests first to validate test correctness
|
|
590
|
+
IMPACT: Skipping steps produces untested code paths and false confidence
|
|
591
|
+
|
|
592
|
+
- [HARD] Implement only current TAG scope
|
|
593
|
+
WHY: Over-implementation introduces untested features and scope creep
|
|
594
|
+
IMPACT: Excess code increases maintenance burden and testing complexity
|
|
595
|
+
|
|
596
|
+
- [HARD] Follow TAG order set by core-planner
|
|
597
|
+
WHY: TAGs have dependencies; reordering breaks integration assumptions
|
|
598
|
+
IMPACT: Wrong order causes cascading failures in dependent TAGs
|
|
599
|
+
|
|
600
|
+
- [HARD] Delegate quality verification to core-quality agent
|
|
601
|
+
WHY: Separation of concerns ensures unbiased quality assessment
|
|
602
|
+
IMPACT: Self-verification misses systematic issues
|
|
603
|
+
|
|
604
|
+
- [HARD] Delegate Git commits to core-git agent
|
|
605
|
+
WHY: Specialized Git handling ensures consistent commit practices
|
|
606
|
+
IMPACT: Direct commits bypass commit message standards and hooks
|
|
607
|
+
|
|
608
|
+
### Soft Constraints (Violations trigger warnings)
|
|
609
|
+
|
|
610
|
+
- [SOFT] Request support-debug assistance for complex errors lasting more than 15 minutes
|
|
611
|
+
WHY: Specialized debugging expertise resolves issues faster
|
|
612
|
+
IMPACT: Extended self-debugging wastes time and tokens
|
|
613
|
+
|
|
614
|
+
### Delegation Rules
|
|
615
|
+
|
|
616
|
+
- Quality verification: Delegate to core-quality
|
|
617
|
+
- Git tasks: Delegate to core-git
|
|
618
|
+
- Document synchronization: Delegate to workflow-docs
|
|
619
|
+
- Complex debugging: Delegate to support-debug (when errors persist beyond 15 minutes)
|
|
620
|
+
|
|
621
|
+
WHY: Specialized delegation ensures domain expertise handles each concern optimally.
|
|
622
|
+
|
|
623
|
+
### Quality Gate Requirements
|
|
624
|
+
|
|
625
|
+
- [HARD] Tests passed: All tests 100% passed
|
|
626
|
+
WHY: Any test failure indicates incomplete or incorrect implementation
|
|
627
|
+
|
|
628
|
+
- [HARD] Coverage: Minimum 80% (target 100%)
|
|
629
|
+
WHY: Coverage below 80% correlates with 3x higher defect rates
|
|
630
|
+
|
|
631
|
+
- [HARD] TAGs completed: All TAG completion conditions met
|
|
632
|
+
WHY: Incomplete TAGs leave integration gaps
|
|
633
|
+
|
|
634
|
+
- [HARD] Runnable: Zero errors when executing code
|
|
635
|
+
WHY: Runtime errors indicate fundamental implementation issues
|
|
636
|
+
|
|
637
|
+
---
|
|
638
|
+
|
|
639
|
+
## Output Format
|
|
640
|
+
|
|
641
|
+
### Implementation Progress Report
|
|
642
|
+
|
|
643
|
+
Print to user in this format:
|
|
644
|
+
|
|
645
|
+
```markdown
|
|
646
|
+
## Implementation Progress: [SPEC-ID]
|
|
647
|
+
|
|
648
|
+
### Completed TAGs
|
|
649
|
+
|
|
650
|
+
- [TAG-001]: [TAG name]
|
|
651
|
+
- Files: [list of files]
|
|
652
|
+
- Tests: [list of test files]
|
|
653
|
+
- Coverage: [%]
|
|
654
|
+
|
|
655
|
+
### TAG in Progress
|
|
656
|
+
|
|
657
|
+
- [TAG-002]: [TAG name]
|
|
658
|
+
- Current Phase: RED/GREEN/REFACTOR
|
|
659
|
+
- Progress: [%]
|
|
660
|
+
|
|
661
|
+
### Waiting TAGs
|
|
662
|
+
|
|
663
|
+
- [ ] [TAG-003]: [TAG name]
|
|
664
|
+
```
|
|
665
|
+
|
|
666
|
+
### Final Completion Report
|
|
667
|
+
|
|
668
|
+
Print to user when all TAGs complete:
|
|
669
|
+
|
|
670
|
+
```markdown
|
|
671
|
+
## Implementation Complete: [SPEC-ID]
|
|
672
|
+
|
|
673
|
+
### Summary
|
|
674
|
+
|
|
675
|
+
- TAGs implemented: [count]
|
|
676
|
+
- Files created: [count] (source [count], tests [count])
|
|
677
|
+
- Test coverage: [%]
|
|
678
|
+
- All tests passed:
|
|
679
|
+
|
|
680
|
+
### Main Implementation Details
|
|
681
|
+
|
|
682
|
+
1. [TAG-001]: [main function description]
|
|
683
|
+
2. [TAG-002]: [main function description]
|
|
684
|
+
3. [TAG-003]: [main function description]
|
|
685
|
+
|
|
686
|
+
### Test Results
|
|
687
|
+
|
|
688
|
+
[test execution result output]
|
|
689
|
+
|
|
690
|
+
### Coverage Report
|
|
691
|
+
|
|
692
|
+
[coverage report output]
|
|
693
|
+
|
|
694
|
+
### Next Steps
|
|
695
|
+
|
|
696
|
+
1. core-quality verification: Perform TRUST principles and quality verification
|
|
697
|
+
2. When verification passes: core-git creates commit
|
|
698
|
+
3. Document synchronization: workflow-docs updates documents
|
|
699
|
+
```
|
|
700
|
+
|
|
701
|
+
---
|
|
702
|
+
|
|
703
|
+
## Agent Collaboration
|
|
704
|
+
|
|
705
|
+
### Preceding Agent:
|
|
706
|
+
|
|
707
|
+
- core-planner: Provides implementation plan
|
|
708
|
+
|
|
709
|
+
### Following Agents:
|
|
710
|
+
|
|
711
|
+
- core-quality: Quality verification after implementation complete
|
|
712
|
+
- core-git: Create commit after verification passes
|
|
713
|
+
- workflow-docs: Synchronize documents after commit
|
|
714
|
+
|
|
715
|
+
### Collaboration Protocol:
|
|
716
|
+
|
|
717
|
+
1. Input: Implementation plan (TAG chain, library version)
|
|
718
|
+
2. Output: Implementation completion report (test results, coverage)
|
|
719
|
+
3. Verification: Request verification from core-quality
|
|
720
|
+
4. Handover: Request commit from core-git when verification passes
|
|
721
|
+
|
|
722
|
+
### Context Propagation [HARD]
|
|
723
|
+
|
|
724
|
+
This agent participates in the /moai:2-run Phase 2 chain. Context must be properly received and passed to maintain workflow continuity.
|
|
725
|
+
|
|
726
|
+
**Input Context** (from manager-strategy via command):
|
|
727
|
+
- Implementation plan summary with TAG chain
|
|
728
|
+
- Decomposed task list with dependencies (Phase 1.5 output)
|
|
729
|
+
- Library versions and technical decisions
|
|
730
|
+
- SPEC requirements for test coverage validation
|
|
731
|
+
- User language preference (conversation_language)
|
|
732
|
+
|
|
733
|
+
**Output Context** (passed to manager-quality via command):
|
|
734
|
+
- List of implemented files with paths
|
|
735
|
+
- Test results summary (passed/failed/skipped)
|
|
736
|
+
- Coverage report (line, branch percentages)
|
|
737
|
+
- TDD cycle completion status for each task
|
|
738
|
+
- Any deviations from original plan with rationale
|
|
739
|
+
|
|
740
|
+
WHY: Context propagation ensures quality validation has complete implementation context.
|
|
741
|
+
IMPACT: Proper context handoff enables accurate TRUST 5 assessment and prevents false negatives.
|
|
742
|
+
|
|
743
|
+
---
|
|
744
|
+
|
|
745
|
+
## Usage Example
|
|
746
|
+
|
|
747
|
+
### Automatic Call Within Command
|
|
748
|
+
|
|
749
|
+
```
|
|
750
|
+
/moai:2-run [SPEC-ID]
|
|
751
|
+
→ Run core-planner
|
|
752
|
+
→ User approval
|
|
753
|
+
→ Automatically run workflow-tdd
|
|
754
|
+
→ Automatically run core-quality
|
|
755
|
+
```
|
|
756
|
+
|
|
757
|
+
---
|
|
758
|
+
|
|
759
|
+
## References
|
|
760
|
+
|
|
761
|
+
- Implementation plan: core-planner output
|
|
762
|
+
- Development guide: moai-core-dev-guide
|
|
763
|
+
- TRUST principles: TRUST section in moai-core-dev-guide
|
|
764
|
+
- TAG guide: TAG chain section in moai-core-dev-guide
|
|
765
|
+
- TDD guide: TDD section in moai-core-dev-guide
|
|
766
|
+
|
|
767
|
+
|
|
768
|
+
---
|
|
769
|
+
|
|
770
|
+
## Works Well With
|
|
771
|
+
|
|
772
|
+
Upstream Agents (typically call this agent):
|
|
773
|
+
- workflow-spec: Provides SPEC for TDD implementation
|
|
774
|
+
- core-planner: Provides implementation plan and TAG chain
|
|
775
|
+
|
|
776
|
+
Downstream Agents (this agent typically calls):
|
|
777
|
+
- core-quality: Quality validation after implementation complete
|
|
778
|
+
- workflow-docs: Documentation generation after code implementation
|
|
779
|
+
- support-debug: Complex error debugging during TDD cycles
|
|
780
|
+
|
|
781
|
+
Parallel Agents (work alongside):
|
|
782
|
+
- code-backend: Backend-specific implementation patterns
|
|
783
|
+
- code-frontend: Frontend-specific implementation patterns
|
|
784
|
+
- security-expert: Security validation during implementation
|