@ngxtm/devkit 3.18.0 → 3.20.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/merged-commands/application-performance-performance-optimization.md +13 -13
- package/merged-commands/ask/fast.md +14 -57
- package/merged-commands/ask/hard.md +22 -79
- package/merged-commands/auto.md +6 -33
- package/merged-commands/backend-development-feature-development.md +12 -12
- package/merged-commands/bootstrap/auto/fast.md +15 -15
- package/merged-commands/bootstrap/auto/parallel.md +12 -12
- package/merged-commands/bootstrap/auto.md +14 -14
- package/merged-commands/bootstrap.md +15 -15
- package/merged-commands/brainstorm/fast.md +19 -72
- package/merged-commands/brainstorm/hard.md +23 -84
- package/merged-commands/c4-architecture-c4-architecture.md +5 -5
- package/merged-commands/code/auto.md +16 -16
- package/merged-commands/code/fast.md +19 -72
- package/merged-commands/code/hard.md +38 -122
- package/merged-commands/code/no-test.md +12 -12
- package/merged-commands/code/parallel.md +9 -9
- package/merged-commands/code.md +14 -14
- package/merged-commands/comprehensive-review-full-review.md +8 -8
- package/merged-commands/context-degradation.md +2 -2
- package/merged-commands/context-engineering.md +4 -4
- package/merged-commands/context-optimization.md +3 -3
- package/merged-commands/cook/auto/fast.md +3 -3
- package/merged-commands/cook/auto/parallel.md +9 -9
- package/merged-commands/cook/auto.md +1 -1
- package/merged-commands/cook/fast.md +38 -47
- package/merged-commands/cook/hard.md +46 -41
- package/merged-commands/cook.md +13 -13
- package/merged-commands/daily-news-report.md +15 -15
- package/merged-commands/data-engineering-data-driven-feature.md +16 -16
- package/merged-commands/debug/fast.md +13 -29
- package/merged-commands/debug/hard.md +47 -49
- package/merged-commands/debug.md +1 -1
- package/merged-commands/debugging-toolkit-smart-debug.md +1 -1
- package/merged-commands/deploy/check.md +22 -71
- package/merged-commands/deploy/preview.md +18 -62
- package/merged-commands/deploy/production.md +22 -71
- package/merged-commands/deploy/rollback.md +22 -71
- package/merged-commands/deploy.md +0 -11
- package/merged-commands/design/3d.md +3 -3
- package/merged-commands/design/describe.md +1 -1
- package/merged-commands/design/fast.md +2 -2
- package/merged-commands/design/good.md +3 -3
- package/merged-commands/design/hard.md +15 -85
- package/merged-commands/design/screenshot.md +1 -1
- package/merged-commands/design/video.md +1 -1
- package/merged-commands/design.md +0 -11
- package/merged-commands/doc-coauthoring.md +5 -5
- package/merged-commands/docker-expert.md +1 -1
- package/merged-commands/docs/audit.md +26 -77
- package/merged-commands/docs/business.md +26 -77
- package/merged-commands/docs/core.md +24 -68
- package/merged-commands/docs/init.md +8 -8
- package/merged-commands/docs/update.md +13 -13
- package/merged-commands/docs.md +0 -12
- package/merged-commands/error-debugging-multi-agent-review.md +1 -1
- package/merged-commands/error-diagnostics-smart-debug.md +1 -1
- package/merged-commands/finishing-a-development-branch.md +1 -1
- package/merged-commands/fix/ci.md +2 -2
- package/merged-commands/fix/fast.md +2 -2
- package/merged-commands/fix/hard.md +6 -6
- package/merged-commands/fix/logs.md +5 -5
- package/merged-commands/fix/parallel.md +9 -9
- package/merged-commands/fix/test.md +6 -6
- package/merged-commands/fix/ui.md +8 -8
- package/merged-commands/fixing.md +3 -3
- package/merged-commands/framework-migration-legacy-modernize.md +13 -13
- package/merged-commands/full-stack-orchestration-full-stack-feature.md +12 -12
- package/merged-commands/git/cm.md +1 -1
- package/merged-commands/git/cp.md +1 -1
- package/merged-commands/git/merge.md +1 -1
- package/merged-commands/git/pr.md +1 -1
- package/merged-commands/git-pr-workflows-git-workflow.md +10 -10
- package/merged-commands/google-adk-python.md +1 -1
- package/merged-commands/hr-pro.md +1 -1
- package/merged-commands/incident-response-incident-response.md +13 -13
- package/merged-commands/integrate/polar.md +3 -3
- package/merged-commands/integrate/sepay.md +3 -3
- package/merged-commands/journal.md +1 -1
- package/merged-commands/learn.md +51 -4
- package/merged-commands/linear-claude-skill.md +2 -2
- package/merged-commands/loki-mode.md +14 -14
- package/merged-commands/machine-learning-ops-ml-pipeline.md +7 -7
- package/merged-commands/mcp-management.md +8 -8
- package/merged-commands/multi-agent-patterns.md +14 -14
- package/merged-commands/multi-platform-apps-multi-platform.md +10 -10
- package/merged-commands/nestjs-expert.md +1 -1
- package/merged-commands/performance-testing-review-multi-agent-review.md +1 -1
- package/merged-commands/plan/archive.md +1 -1
- package/merged-commands/plan/ci.md +1 -1
- package/merged-commands/plan/fast.md +2 -2
- package/merged-commands/plan/hard.md +4 -4
- package/merged-commands/plan/parallel.md +5 -5
- package/merged-commands/plan/two.md +6 -6
- package/merged-commands/requesting-code-review.md +6 -6
- package/merged-commands/review/codebase/parallel.md +5 -5
- package/merged-commands/review/codebase.md +5 -5
- package/merged-commands/review/fast.md +13 -29
- package/merged-commands/review/hard.md +48 -49
- package/merged-commands/review.md +0 -11
- package/merged-commands/security-scanning-security-hardening.md +13 -13
- package/merged-commands/skill/add.md +6 -6
- package/merged-commands/skill/create.md +6 -6
- package/merged-commands/skill/fix-logs.md +6 -6
- package/merged-commands/skill/optimize/auto.md +1 -1
- package/merged-commands/skill/optimize.md +1 -1
- package/merged-commands/skill/plan.md +1 -1
- package/merged-commands/skill/update.md +6 -6
- package/merged-commands/subagent-driven-development.md +53 -53
- package/merged-commands/tdd-workflows-tdd-cycle.md +12 -12
- package/merged-commands/tdd-workflows-tdd-red.md +1 -1
- package/merged-commands/tdd-workflows-tdd-refactor.md +1 -1
- package/merged-commands/test/fast.md +22 -33
- package/merged-commands/test/hard.md +59 -56
- package/merged-commands/test/ui.md +1 -1
- package/merged-commands/test.md +1 -1
- package/merged-commands/typescript-expert.md +1 -1
- package/merged-commands/use-mcp.md +5 -5
- package/merged-commands/writing-plans.md +3 -3
- package/merged-commands/writing-skills.md +8 -8
- package/package.json +1 -1
- package/rules-index.json +1 -1
- package/skills/application-performance-performance-optimization/SKILL.md +13 -13
- package/skills/azure-ai-agents-python/references/tools.md +1 -1
- package/skills/backend-development-feature-development/SKILL.md +12 -12
- package/skills/best-practices/references/anti-patterns.md +2 -2
- package/skills/best-practices/references/best-practices-guide.md +14 -14
- package/skills/c4-architecture-c4-architecture/SKILL.md +5 -5
- package/skills/comprehensive-review-full-review/SKILL.md +8 -8
- package/skills/context-degradation/SKILL.md +2 -2
- package/skills/context-engineering/SKILL.md +4 -4
- package/skills/context-engineering/references/context-degradation.md +1 -1
- package/skills/context-engineering/references/context-optimization.md +1 -1
- package/skills/context-engineering/references/multi-agent-patterns.md +1 -1
- package/skills/context-engineering/references/runtime-awareness.md +1 -1
- package/skills/context-optimization/SKILL.md +3 -3
- package/skills/daily-news-report/SKILL.md +15 -15
- package/skills/data-engineering-data-driven-feature/SKILL.md +16 -16
- package/skills/debugging-toolkit-smart-debug/SKILL.md +1 -1
- package/skills/doc-coauthoring/SKILL.md +5 -5
- package/skills/docker-expert/SKILL.md +1 -1
- package/skills/error-debugging-multi-agent-review/SKILL.md +1 -1
- package/skills/error-diagnostics-smart-debug/SKILL.md +1 -1
- package/skills/finishing-a-development-branch/SKILL.md +1 -1
- package/skills/fixing/SKILL.md +3 -3
- package/skills/fixing/references/parallel-exploration.md +4 -4
- package/skills/fixing/references/skill-activation-matrix.md +3 -3
- package/skills/fixing/references/workflow-deep.md +11 -11
- package/skills/fixing/references/workflow-quick.md +4 -4
- package/skills/fixing/references/workflow-standard.md +12 -12
- package/skills/framework-migration-legacy-modernize/SKILL.md +13 -13
- package/skills/full-stack-orchestration-full-stack-feature/SKILL.md +12 -12
- package/skills/git-pr-workflows-git-workflow/SKILL.md +10 -10
- package/skills/google-adk-python/SKILL.md +1 -1
- package/skills/hr-pro/SKILL.md +1 -1
- package/skills/incident-response-incident-response/SKILL.md +13 -13
- package/skills/incident-response-smart-fix/resources/implementation-playbook.md +17 -17
- package/skills/learn/SKILL.md +51 -4
- package/skills/linear-claude-skill/SKILL.md +2 -2
- package/skills/loki-mode/ACKNOWLEDGEMENTS.md +4 -4
- package/skills/loki-mode/CHANGELOG.md +9 -9
- package/skills/loki-mode/CONTEXT-EXPORT.md +1 -1
- package/skills/loki-mode/README.md +2 -2
- package/skills/loki-mode/SKILL.md +14 -14
- package/skills/loki-mode/autonomy/run.sh +1 -1
- package/skills/loki-mode/integrations/vibe-kanban.md +1 -1
- package/skills/loki-mode/references/core-workflow.md +4 -4
- package/skills/loki-mode/references/production-patterns.md +6 -6
- package/skills/loki-mode/references/quality-control.md +2 -2
- package/skills/loki-mode/references/sdlc-phases.md +3 -3
- package/skills/machine-learning-ops-ml-pipeline/SKILL.md +7 -7
- package/skills/mcp-builder/reference/evaluation.md +3 -3
- package/skills/mcp-management/README.md +6 -6
- package/skills/mcp-management/SKILL.md +8 -8
- package/skills/mcp-management/references/gemini-cli-integration.md +1 -1
- package/skills/multi-agent-patterns/SKILL.md +14 -14
- package/skills/multi-platform-apps-multi-platform/SKILL.md +10 -10
- package/skills/nestjs-expert/SKILL.md +1 -1
- package/skills/performance-testing-review-multi-agent-review/SKILL.md +1 -1
- package/skills/planning-with-files/reference.md +2 -2
- package/skills/requesting-code-review/SKILL.md +6 -6
- package/skills/security-scanning-security-hardening/SKILL.md +13 -13
- package/skills/subagent-driven-development/SKILL.md +53 -53
- package/skills/subagent-driven-development/code-quality-reviewer-prompt.md +1 -1
- package/skills/subagent-driven-development/implementer-prompt.md +3 -3
- package/skills/subagent-driven-development/spec-reviewer-prompt.md +1 -1
- package/skills/tdd-workflows-tdd-cycle/SKILL.md +12 -12
- package/skills/tdd-workflows-tdd-green/resources/implementation-playbook.md +1 -1
- package/skills/tdd-workflows-tdd-red/SKILL.md +1 -1
- package/skills/tdd-workflows-tdd-refactor/SKILL.md +1 -1
- package/skills/typescript-expert/SKILL.md +1 -1
- package/skills/writing-plans/SKILL.md +3 -3
- package/skills/writing-skills/SKILL.md +8 -8
- package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +1 -1
- package/skills/writing-skills/references/cso/README.md +3 -3
- package/skills/writing-skills/testing-skills-with-subagents.md +1 -1
|
@@ -11,9 +11,9 @@ Analyze the skills catalog and activate the skills that are needed for the task
|
|
|
11
11
|
|
|
12
12
|
## Workflow
|
|
13
13
|
1. If the user provides a screenshots or videos, use `ai-multimodal` skill to describe as detailed as possible the issue, make sure developers can predict the root causes easily based on the description.
|
|
14
|
-
2. Use
|
|
14
|
+
2. Use a Task agent for debugging: Task(subagent_type="general-purpose", prompt="You are a debugger. Find the root cause of the issues and report back to main agent.", description="Debug issues") to find the root cause of the issues and report back to main agent.
|
|
15
15
|
3. Activate `debugging` skills and `problem-solving` skills to tackle the issues.
|
|
16
16
|
4. Start implementing the fix based the reports and solutions.
|
|
17
|
-
5. Use
|
|
17
|
+
5. Use a Task agent for testing: Task(subagent_type="general-purpose", prompt="You are a tester. Test the fix and make sure it works, then report back to main agent.", description="Test fix") to test the fix and make sure it works, then report back to main agent.
|
|
18
18
|
6. If there are issues or failed tests, repeat from step 2.
|
|
19
19
|
7. After finishing, respond back to user with a summary of the changes and explain everything briefly, guide user to get started and suggest the next steps.
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: ⚡⚡⚡ Use
|
|
2
|
+
description: ⚡⚡⚡ Use Task agents to plan and fix hard issues
|
|
3
3
|
argument-hint: [issues]
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
**Ultrathink** to plan & start fixing these issues follow the Orchestration Protocol, Core Responsibilities,
|
|
6
|
+
**Ultrathink** to plan & start fixing these issues follow the Orchestration Protocol, Core Responsibilities, Task Agents Team and Development Rules:
|
|
7
7
|
<issues>$ARGUMENTS</issues>
|
|
8
8
|
|
|
9
9
|
## Workflow:
|
|
@@ -23,13 +23,13 @@ Use `sequential-thinking` skill to break complex problems into sequential though
|
|
|
23
23
|
Use `problem-solving` skills to tackle the issues.
|
|
24
24
|
Analyze the skills catalog and activate other skills that are needed for the task during the process.
|
|
25
25
|
|
|
26
|
-
1. Use
|
|
27
|
-
2. Use
|
|
28
|
-
3. Use
|
|
26
|
+
1. Use a Task agent for debugging: Task(subagent_type="general-purpose", prompt="You are a debugger. Find the root cause of the issues and report back to main agent.", description="Debug issues") to find the root cause of the issues and report back to main agent.
|
|
27
|
+
2. Use a Task agent for research: Task(subagent_type="general-purpose", prompt="You are a researcher. Research quickly about the root causes on the internet (if needed) and report back to main agent.", description="Research root causes") to research quickly about the root causes on the internet (if needed) and report back to main agent.
|
|
28
|
+
3. Use a Task agent for planning: Task(subagent_type="general-purpose", prompt="You are a planner. Create an implementation plan based on the reports, then report back to main agent.", description="Create fix plan") to create an implementation plan based on the reports, then report back to main agent.
|
|
29
29
|
4. Then use `/code` SlashCommand to implement the plan step by step.
|
|
30
30
|
5. Final Report:
|
|
31
31
|
* Report back to user with a summary of the changes and explain everything briefly, guide user to get started and suggest the next steps.
|
|
32
|
-
* Ask the user if they want to commit and push to git repository, if yes, use
|
|
32
|
+
* Ask the user if they want to commit and push to git repository, if yes, use a Task agent for git operations: Task(subagent_type="general-purpose", prompt="You are a git-manager. Commit and push to git repository.", description="Git commit and push") to commit and push to git repository.
|
|
33
33
|
- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
|
|
34
34
|
- **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
|
|
35
35
|
|
|
@@ -14,13 +14,13 @@ argument-hint: [issue]
|
|
|
14
14
|
- **Bash/Unix**: append `2>&1 | tee logs.txt`
|
|
15
15
|
- **PowerShell**: append `*>&1 | Tee-Object logs.txt`
|
|
16
16
|
- Run the command to generate logs
|
|
17
|
-
2. Use
|
|
17
|
+
2. Use a Task agent for debugging: Task(subagent_type="general-purpose", prompt="You are a debugger. Analyze ./logs.txt and find root causes.", description="Analyze logs") to analyze `./logs.txt` and find root causes:
|
|
18
18
|
- Use `Grep` with `head_limit: 30` to read only last 30 lines (avoid loading entire file)
|
|
19
19
|
- If insufficient context, increase `head_limit` as needed
|
|
20
|
-
3. Use
|
|
21
|
-
4. Use
|
|
20
|
+
3. Use a Task agent for scouting: Task(subagent_type="general-purpose", prompt="You are a scout. Analyze the codebase and find the exact location of the issues, then report back to main agent.", description="Scout codebase") to analyze the codebase and find the exact location of the issues, then report back to main agent.
|
|
21
|
+
4. Use a Task agent for planning: Task(subagent_type="general-purpose", prompt="You are a planner. Create an implementation plan based on the reports, then report back to main agent.", description="Create fix plan") to create an implementation plan based on the reports, then report back to main agent.
|
|
22
22
|
5. Start implementing the fix based the reports and solutions.
|
|
23
|
-
6. Use
|
|
24
|
-
7. Use
|
|
23
|
+
6. Use a Task agent for testing to test the fix and make sure it works, then report back to main agent.
|
|
24
|
+
7. Use a Task agent for code review: Task(subagent_type="general-purpose", prompt="You are a code-reviewer. Quickly review the code changes and make sure it meets requirements, then report back to main agent.", description="Code review") to quickly review the code changes and make sure it meets requirements, then report back to main agent.
|
|
25
25
|
8. If there are issues or failed tests, repeat from step 3.
|
|
26
26
|
9. After finishing, respond back to user with a summary of the changes and explain everything briefly, guide user to get started and suggest the next steps.
|
|
@@ -10,7 +10,7 @@ argument-hint: [issues]
|
|
|
10
10
|
## Workflow
|
|
11
11
|
|
|
12
12
|
### 1. Issue Analysis
|
|
13
|
-
- Use
|
|
13
|
+
- Use a Task agent for debugging: Task(subagent_type="general-purpose", prompt="You are a debugger. Analyze root causes.", description="Analyze root causes") to analyze root causes
|
|
14
14
|
- Use `/scout:ext` to find related files
|
|
15
15
|
- Categorize issues by scope/area (frontend, backend, auth, payments, etc.)
|
|
16
16
|
- Identify dependencies between issues
|
|
@@ -23,32 +23,32 @@ argument-hint: [issues]
|
|
|
23
23
|
|
|
24
24
|
### 3. Parallel Fix Implementation
|
|
25
25
|
- Read `plan.md` for dependency graph
|
|
26
|
-
- Launch multiple
|
|
27
|
-
- Example: "Fix auth + Fix payments + Fix UI" → launch 3 agents simultaneously
|
|
26
|
+
- Launch multiple Task agents for fullstack development in PARALLEL for independent fixes
|
|
27
|
+
- Example: "Fix auth + Fix payments + Fix UI" → launch 3 Task agents simultaneously
|
|
28
28
|
- Pass phase file path: `{plan-dir}/phase-XX-*.md`
|
|
29
29
|
- Include environment info
|
|
30
30
|
- Wait for all parallel fixes complete before dependent fixes
|
|
31
31
|
- Sequential fixes: launch one agent at a time
|
|
32
32
|
|
|
33
33
|
### 4. Testing
|
|
34
|
-
- Use
|
|
34
|
+
- Use a Task agent for testing for full test suite
|
|
35
35
|
- NO fake data/mocks/cheats
|
|
36
36
|
- Verify all issues resolved
|
|
37
|
-
- If fail: use
|
|
37
|
+
- If fail: use Task agent for debugging, fix, repeat
|
|
38
38
|
|
|
39
39
|
### 5. Code Review
|
|
40
|
-
- Use
|
|
40
|
+
- Use Task agent for code review for all changes
|
|
41
41
|
- Verify fixes don't introduce regressions
|
|
42
42
|
- If critical issues: fix, retest
|
|
43
43
|
|
|
44
44
|
### 6. Project Management & Docs
|
|
45
|
-
- If approved: use
|
|
45
|
+
- If approved: use Task agent for project management + Task agent for documentation in parallel
|
|
46
46
|
- Update plan files, docs, roadmap
|
|
47
47
|
- If rejected: fix and repeat
|
|
48
48
|
|
|
49
49
|
### 7. Final Report
|
|
50
50
|
- Summary of all fixes from parallel phases
|
|
51
51
|
- Verification status per issue
|
|
52
|
-
- Ask to commit (use
|
|
52
|
+
- Ask to commit (use Task agent for git operations if yes)
|
|
53
53
|
|
|
54
|
-
**Example:** Fix 1 (auth) + Fix 2 (payments) + Fix 3 (UI) → Launch 3
|
|
54
|
+
**Example:** Fix 1 (auth) + Fix 2 (payments) + Fix 3 (UI) → Launch 3 Task agents for fullstack development → Wait → Fix 4 (integration) sequential
|
|
@@ -9,12 +9,12 @@ Analyze the skills catalog and activate the skills that are needed for the task
|
|
|
9
9
|
<issues>$ARGUMENTS</issues>
|
|
10
10
|
|
|
11
11
|
## Workflow:
|
|
12
|
-
1. Use
|
|
13
|
-
2. Use
|
|
14
|
-
3. If there are issues or failed tests, use
|
|
15
|
-
4. Use
|
|
12
|
+
1. Use a Task agent for testing: Task(subagent_type="general-purpose", prompt="You are a tester. Compile the code and fix all syntax errors if any.", description="Compile code") to compile the code and fix all syntax errors if any.
|
|
13
|
+
2. Use a Task agent for testing: Task(subagent_type="general-purpose", prompt="You are a tester. Run the tests and report back to main agent.", description="Run tests") to run the tests and report back to main agent.
|
|
14
|
+
3. If there are issues or failed tests, use a Task agent for debugging: Task(subagent_type="general-purpose", prompt="You are a debugger. Find the root cause of the issues, then report back to main agent.", description="Debug failures") to find the root cause of the issues, then report back to main agent.
|
|
15
|
+
4. Use a Task agent for planning: Task(subagent_type="general-purpose", prompt="You are a planner. Create an implementation plan based on the reports, then report back to main agent.", description="Create fix plan") to create an implementation plan based on the reports, then report back to main agent.
|
|
16
16
|
5. Use main agent to implement the plan step by step.
|
|
17
|
-
6. Use
|
|
18
|
-
6. Use
|
|
17
|
+
6. Use a Task agent for testing: Task(subagent_type="general-purpose", prompt="You are a tester. Test the fix and make sure it works, then report back to main agent.", description="Test fix") to test the fix and make sure it works, then report back to main agent.
|
|
18
|
+
6. Use a Task agent for code review: Task(subagent_type="general-purpose", prompt="You are a code-reviewer. Quickly review the code changes and make sure it meets requirements, then report back to main agent.", description="Code review") to quickly review the code changes and make sure it meets requirements, then report back to main agent.
|
|
19
19
|
7. If there are issues or failed tests, repeat from step 2.
|
|
20
20
|
8. After finishing, respond back to user with a summary of the changes and explain everything briefly, guide user to get started and suggest the next steps.
|
|
@@ -8,7 +8,7 @@ argument-hint: [issue]
|
|
|
8
8
|
2. **`aesthetic`** - Design principles
|
|
9
9
|
3. **`frontend-design`** - Implementation patterns
|
|
10
10
|
|
|
11
|
-
Use
|
|
11
|
+
Use a Task agent for UI/UX design: Task(subagent_type="general-purpose", prompt="You are a ui-ux-designer. Read and analyze ./docs/design-guidelines.md then fix the following issues.", description="Fix UI issues") to read and analyze `./docs/design-guidelines.md` then fix the following issues:
|
|
12
12
|
<issue>$ARGUMENTS</issue>
|
|
13
13
|
|
|
14
14
|
## Workflow
|
|
@@ -22,22 +22,22 @@ python3 .claude/skills/ui-ux-pro-max/scripts/search.py "z-index animation" --dom
|
|
|
22
22
|
|
|
23
23
|
If the user provides a screenshots or videos, use `ai-multimodal` skill to describe as detailed as possible the issue, make sure developers can predict the root causes easily based on the description.
|
|
24
24
|
|
|
25
|
-
1. Use
|
|
25
|
+
1. Use a Task agent for UI/UX design: Task(subagent_type="general-purpose", prompt="You are a ui-ux-designer. Implement the fix step by step.", description="Implement UI fix") to implement the fix step by step.
|
|
26
26
|
2. Use screenshot capture tools along with `ai-multimodal` skill to take screenshots of the implemented fix (at the exact parent container, don't take screenshot of the whole page) and use the appropriate Gemini analysis skills (`ai-multimodal`, `video-analysis`, or `document-extraction`) to analyze those outputs so the result matches the design guideline and addresses all issues.
|
|
27
27
|
- If the issues are not addressed, repeat the process until all issues are addressed.
|
|
28
28
|
3. Use `chrome-devtools` skill to analyze the implemented fix and make sure it matches the design guideline.
|
|
29
|
-
4. Use
|
|
29
|
+
4. Use a Task agent for testing to test the fix and compile the code to make sure it works, then report back to main agent.
|
|
30
30
|
- If there are issues or failed tests, ask main agent to fix all of them and repeat the process until all tests pass.
|
|
31
31
|
5. Project Management & Documentation:
|
|
32
|
-
**If user approves the changes:** Use
|
|
33
|
-
* Use
|
|
34
|
-
* Use
|
|
35
|
-
* Use
|
|
32
|
+
**If user approves the changes:** Use Task agents for project management and documentation in parallel to update the project progress and documentation:
|
|
33
|
+
* Use a Task agent for project management: Task(subagent_type="general-purpose", prompt="You are a project-manager. Update the project progress and task status in the given plan file.", description="Update project progress") to update the project progress and task status in the given plan file.
|
|
34
|
+
* Use a Task agent for documentation: Task(subagent_type="general-purpose", prompt="You are a docs-manager. Update the docs in ./docs directory if needed.", description="Update docs") to update the docs in `./docs` directory if needed.
|
|
35
|
+
* Use a Task agent for project management: Task(subagent_type="general-purpose", prompt="You are a project-manager. Create a project roadmap at ./docs/project-roadmap.md file.", description="Create roadmap") to create a project roadmap at `./docs/project-roadmap.md` file.
|
|
36
36
|
* **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
|
|
37
37
|
**If user rejects the changes:** Ask user to explain the issues and ask main agent to fix all of them and repeat the process.
|
|
38
38
|
6. Final Report:
|
|
39
39
|
* Report back to user with a summary of the changes and explain everything briefly, guide user to get started and suggest the next steps.
|
|
40
|
-
* Ask the user if they want to commit and push to git repository, if yes, use
|
|
40
|
+
* Ask the user if they want to commit and push to git repository, if yes, use a Task agent for git operations: Task(subagent_type="general-purpose", prompt="You are a git-manager. Commit and push to git repository.", description="Git commit and push") to commit and push to git repository.
|
|
41
41
|
* **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
|
|
42
42
|
* **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
|
|
43
43
|
|
|
@@ -31,13 +31,13 @@ Classify before routing. See `references/complexity-assessment.md`.
|
|
|
31
31
|
| **Complex** | System-wide, architecture impact | `references/workflow-deep.md` |
|
|
32
32
|
| **Parallel** | 2+ independent issues | Parallel `fullstack-developer` agents |
|
|
33
33
|
|
|
34
|
-
## Skill/
|
|
34
|
+
## Skill/Task Agent Activation Matrix
|
|
35
35
|
|
|
36
36
|
See `references/skill-activation-matrix.md` for complete matrix.
|
|
37
37
|
|
|
38
38
|
**Always activate:** `debugging` (all workflows)
|
|
39
39
|
**Conditional:** `problem-solving`, `sequential-thinking`, `brainstorming`, `context-engineering`
|
|
40
|
-
**
|
|
40
|
+
**Task agents:** `debugger`, `researcher`, `planner`, `code-reviewer`, `tester`, `Bash`
|
|
41
41
|
**Parallel:** Multiple `Explore` agents for scouting, `Bash` agents for verification
|
|
42
42
|
|
|
43
43
|
## Output Format
|
|
@@ -62,7 +62,7 @@ Load as needed:
|
|
|
62
62
|
- `references/workflow-deep.md` - Deep: research + brainstorm + plan
|
|
63
63
|
- `references/review-cycle.md` - Review logic (autonomous vs HITL)
|
|
64
64
|
- `references/skill-activation-matrix.md` - When to activate each skill
|
|
65
|
-
- `references/parallel-exploration.md` - Parallel Explore/Bash
|
|
65
|
+
- `references/parallel-exploration.md` - Parallel Explore/Bash Task agent patterns
|
|
66
66
|
|
|
67
67
|
**Specialized Workflows:**
|
|
68
68
|
- `references/workflow-ci.md` - GitHub Actions/CI failures
|
|
@@ -31,18 +31,18 @@ Orchestrate a comprehensive legacy system modernization using the strangler fig
|
|
|
31
31
|
## Phase 1: Legacy Assessment and Risk Analysis
|
|
32
32
|
|
|
33
33
|
### 1. Comprehensive Legacy System Analysis
|
|
34
|
-
- Use Task tool with subagent_type="
|
|
34
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
35
35
|
- Prompt: "Analyze the legacy codebase at $ARGUMENTS. Document technical debt inventory including: outdated dependencies, deprecated APIs, security vulnerabilities, performance bottlenecks, and architectural anti-patterns. Generate a modernization readiness report with component complexity scores (1-10), dependency mapping, and database coupling analysis. Identify quick wins vs complex refactoring targets."
|
|
36
36
|
- Expected output: Detailed assessment report with risk matrix and modernization priorities
|
|
37
37
|
|
|
38
38
|
### 2. Dependency and Integration Mapping
|
|
39
|
-
- Use Task tool with subagent_type="
|
|
39
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
40
40
|
- Prompt: "Based on the legacy assessment report, create a comprehensive dependency graph showing: internal module dependencies, external service integrations, shared database schemas, and cross-system data flows. Identify integration points that will require facade patterns or adapter layers during migration. Highlight circular dependencies and tight coupling that need resolution."
|
|
41
41
|
- Context from previous: Legacy assessment report, component complexity scores
|
|
42
42
|
- Expected output: Visual dependency map and integration point catalog
|
|
43
43
|
|
|
44
44
|
### 3. Business Impact and Risk Assessment
|
|
45
|
-
- Use Task tool with subagent_type="
|
|
45
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
46
46
|
- Prompt: "Evaluate business impact of modernizing each component identified. Create risk assessment matrix considering: business criticality (revenue impact), user traffic patterns, data sensitivity, regulatory requirements, and fallback complexity. Prioritize components using a weighted scoring system: (Business Value × 0.4) + (Technical Risk × 0.3) + (Quick Win Potential × 0.3). Define rollback strategies for each component."
|
|
47
47
|
- Context from previous: Component inventory, dependency mapping
|
|
48
48
|
- Expected output: Prioritized migration roadmap with risk mitigation strategies
|
|
@@ -50,18 +50,18 @@ Orchestrate a comprehensive legacy system modernization using the strangler fig
|
|
|
50
50
|
## Phase 2: Test Coverage Establishment
|
|
51
51
|
|
|
52
52
|
### 1. Legacy Code Test Coverage Analysis
|
|
53
|
-
- Use Task tool with subagent_type="
|
|
53
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
54
54
|
- Prompt: "Analyze existing test coverage for legacy components at $ARGUMENTS. Use coverage tools to identify untested code paths, missing integration tests, and absent end-to-end scenarios. For components with <40% coverage, generate characterization tests that capture current behavior without modifying functionality. Create test harness for safe refactoring."
|
|
55
55
|
- Expected output: Test coverage report and characterization test suite
|
|
56
56
|
|
|
57
57
|
### 2. Contract Testing Implementation
|
|
58
|
-
- Use Task tool with subagent_type="
|
|
58
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
59
59
|
- Prompt: "Implement contract tests for all integration points identified in dependency mapping. Create consumer-driven contracts for APIs, message queue interactions, and database schemas. Set up contract verification in CI/CD pipeline. Generate performance baselines for response times and throughput to validate modernized components maintain SLAs."
|
|
60
60
|
- Context from previous: Integration point catalog, existing test coverage
|
|
61
61
|
- Expected output: Contract test suite with performance baselines
|
|
62
62
|
|
|
63
63
|
### 3. Test Data Management Strategy
|
|
64
|
-
- Use Task tool with subagent_type="
|
|
64
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
65
65
|
- Prompt: "Design test data management strategy for parallel system operation. Create data generation scripts for edge cases, implement data masking for sensitive information, and establish test database refresh procedures. Set up monitoring for data consistency between legacy and modernized components during migration."
|
|
66
66
|
- Context from previous: Database schemas, test requirements
|
|
67
67
|
- Expected output: Test data pipeline and consistency monitoring
|
|
@@ -69,18 +69,18 @@ Orchestrate a comprehensive legacy system modernization using the strangler fig
|
|
|
69
69
|
## Phase 3: Incremental Migration Implementation
|
|
70
70
|
|
|
71
71
|
### 1. Strangler Fig Infrastructure Setup
|
|
72
|
-
- Use Task tool with subagent_type="
|
|
72
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
73
73
|
- Prompt: "Implement strangler fig infrastructure with API gateway for traffic routing. Configure feature flags for gradual rollout using environment variables or feature management service. Set up proxy layer with request routing rules based on: URL patterns, headers, or user segments. Implement circuit breakers and fallback mechanisms for resilience. Create observability dashboard for dual-system monitoring."
|
|
74
74
|
- Expected output: API gateway configuration, feature flag system, monitoring dashboard
|
|
75
75
|
|
|
76
76
|
### 2. Component Modernization - First Wave
|
|
77
|
-
- Use Task tool with subagent_type="
|
|
77
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
78
78
|
- Prompt: "Modernize first-wave components (quick wins identified in assessment). For each component: extract business logic from legacy code, implement using modern patterns (dependency injection, SOLID principles), ensure backward compatibility through adapter patterns, maintain data consistency with event sourcing or dual writes. Follow 12-factor app principles. Components to modernize: [list from prioritized roadmap]"
|
|
79
79
|
- Context from previous: Characterization tests, contract tests, infrastructure setup
|
|
80
80
|
- Expected output: Modernized components with adapters
|
|
81
81
|
|
|
82
82
|
### 3. Security Hardening
|
|
83
|
-
- Use Task tool with subagent_type="
|
|
83
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
84
84
|
- Prompt: "Audit modernized components for security vulnerabilities. Implement security improvements including: OAuth 2.0/JWT authentication, role-based access control, input validation and sanitization, SQL injection prevention, XSS protection, and secrets management. Verify OWASP top 10 compliance. Configure security headers and implement rate limiting."
|
|
85
85
|
- Context from previous: Modernized component code
|
|
86
86
|
- Expected output: Security audit report and hardened components
|
|
@@ -88,13 +88,13 @@ Orchestrate a comprehensive legacy system modernization using the strangler fig
|
|
|
88
88
|
## Phase 4: Performance Validation and Optimization
|
|
89
89
|
|
|
90
90
|
### 1. Performance Testing and Optimization
|
|
91
|
-
- Use Task tool with subagent_type="
|
|
91
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
92
92
|
- Prompt: "Conduct performance testing comparing legacy vs modernized components. Run load tests simulating production traffic patterns, measure response times, throughput, and resource utilization. Identify performance regressions and optimize: database queries with indexing, caching strategies (Redis/Memcached), connection pooling, and async processing where applicable. Validate against SLA requirements."
|
|
93
93
|
- Context from previous: Performance baselines, modernized components
|
|
94
94
|
- Expected output: Performance test results and optimization recommendations
|
|
95
95
|
|
|
96
96
|
### 2. Progressive Rollout and Monitoring
|
|
97
|
-
- Use Task tool with subagent_type="
|
|
97
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
98
98
|
- Prompt: "Implement progressive rollout strategy using feature flags. Start with 5% traffic to modernized components, monitor error rates, latency, and business metrics. Define automatic rollback triggers: error rate >1%, latency >2x baseline, or business metric degradation. Create runbook for traffic shifting: 5% → 25% → 50% → 100% with 24-hour observation periods."
|
|
99
99
|
- Context from previous: Feature flag configuration, monitoring dashboard
|
|
100
100
|
- Expected output: Rollout plan with automated safeguards
|
|
@@ -102,13 +102,13 @@ Orchestrate a comprehensive legacy system modernization using the strangler fig
|
|
|
102
102
|
## Phase 5: Migration Completion and Documentation
|
|
103
103
|
|
|
104
104
|
### 1. Legacy Component Decommissioning
|
|
105
|
-
- Use Task tool with subagent_type="
|
|
105
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
106
106
|
- Prompt: "Plan safe decommissioning of replaced legacy components. Verify no remaining dependencies through traffic analysis (minimum 30 days at 0% traffic). Archive legacy code with documentation of original functionality. Update CI/CD pipelines to remove legacy builds. Clean up unused database tables and remove deprecated API endpoints. Document any retained legacy components with sunset timeline."
|
|
107
107
|
- Context from previous: Traffic routing data, modernization status
|
|
108
108
|
- Expected output: Decommissioning checklist and timeline
|
|
109
109
|
|
|
110
110
|
### 2. Documentation and Knowledge Transfer
|
|
111
|
-
- Use Task tool with subagent_type="
|
|
111
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
112
112
|
- Prompt: "Create comprehensive modernization documentation including: architectural diagrams (before/after), API documentation with migration guides, runbooks for dual-system operation, troubleshooting guides for common issues, and lessons learned report. Generate developer onboarding guide for modernized system. Document technical decisions and trade-offs made during migration."
|
|
113
113
|
- Context from previous: All migration artifacts and decisions
|
|
114
114
|
- Expected output: Complete modernization documentation package
|
|
@@ -29,19 +29,19 @@ Orchestrate full-stack feature development across backend, frontend, and infrast
|
|
|
29
29
|
## Phase 1: Architecture & Design Foundation
|
|
30
30
|
|
|
31
31
|
### 1. Database Architecture Design
|
|
32
|
-
- Use Task tool with subagent_type="
|
|
32
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
33
33
|
- Prompt: "Design database schema and data models for: $ARGUMENTS. Consider scalability, query patterns, indexing strategy, and data consistency requirements. Include migration strategy if modifying existing schema. Provide both logical and physical data models."
|
|
34
34
|
- Expected output: Entity relationship diagrams, table schemas, indexing strategy, migration scripts, data access patterns
|
|
35
35
|
- Context: Initial requirements and business domain model
|
|
36
36
|
|
|
37
37
|
### 2. Backend Service Architecture
|
|
38
|
-
- Use Task tool with subagent_type="
|
|
38
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
39
39
|
- Prompt: "Design backend service architecture for: $ARGUMENTS. Using the database design from previous step, create service boundaries, define API contracts (OpenAPI/GraphQL), design authentication/authorization strategy, and specify inter-service communication patterns. Include resilience patterns (circuit breakers, retries) and caching strategy."
|
|
40
40
|
- Expected output: Service architecture diagram, OpenAPI specifications, authentication flows, caching architecture, message queue design (if applicable)
|
|
41
41
|
- Context: Database schema from step 1, non-functional requirements
|
|
42
42
|
|
|
43
43
|
### 3. Frontend Component Architecture
|
|
44
|
-
- Use Task tool with subagent_type="
|
|
44
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
45
45
|
- Prompt: "Design frontend architecture and component structure for: $ARGUMENTS. Based on the API contracts from previous step, design component hierarchy, state management approach (Redux/Zustand/Context), routing structure, and data fetching patterns. Include accessibility requirements and responsive design strategy. Plan for Storybook component documentation."
|
|
46
46
|
- Expected output: Component tree diagram, state management design, routing configuration, design system integration plan, accessibility checklist
|
|
47
47
|
- Context: API specifications from step 2, UI/UX requirements
|
|
@@ -49,19 +49,19 @@ Orchestrate full-stack feature development across backend, frontend, and infrast
|
|
|
49
49
|
## Phase 2: Parallel Implementation
|
|
50
50
|
|
|
51
51
|
### 4. Backend Service Implementation
|
|
52
|
-
- Use Task tool with subagent_type="
|
|
52
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
53
53
|
- Prompt: "Implement backend services for: $ARGUMENTS. Using the architecture and API specs from Phase 1, build RESTful/GraphQL endpoints with proper validation, error handling, and logging. Implement business logic, data access layer, authentication middleware, and integration with external services. Include observability (structured logging, metrics, tracing)."
|
|
54
54
|
- Expected output: Backend service code, API endpoints, middleware, background jobs, unit tests, integration tests
|
|
55
55
|
- Context: Architecture designs from Phase 1, database schema
|
|
56
56
|
|
|
57
57
|
### 5. Frontend Implementation
|
|
58
|
-
- Use Task tool with subagent_type="
|
|
58
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
59
59
|
- Prompt: "Implement frontend application for: $ARGUMENTS. Build React/Next.js components using the component architecture from Phase 1. Implement state management, API integration with proper error handling and loading states, form validation, and responsive layouts. Create Storybook stories for components. Ensure accessibility (WCAG 2.1 AA compliance)."
|
|
60
60
|
- Expected output: React components, state management implementation, API client code, Storybook stories, responsive styles, accessibility implementations
|
|
61
61
|
- Context: Component architecture from step 3, API contracts
|
|
62
62
|
|
|
63
63
|
### 6. Database Implementation & Optimization
|
|
64
|
-
- Use Task tool with subagent_type="
|
|
64
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
65
65
|
- Prompt: "Implement and optimize database layer for: $ARGUMENTS. Create migration scripts, stored procedures (if needed), optimize queries identified by backend implementation, set up proper indexes, and implement data validation constraints. Include database-level security measures and backup strategies."
|
|
66
66
|
- Expected output: Migration scripts, optimized queries, stored procedures, index definitions, database security configuration
|
|
67
67
|
- Context: Database design from step 1, query patterns from backend implementation
|
|
@@ -69,19 +69,19 @@ Orchestrate full-stack feature development across backend, frontend, and infrast
|
|
|
69
69
|
## Phase 3: Integration & Testing
|
|
70
70
|
|
|
71
71
|
### 7. API Contract Testing
|
|
72
|
-
- Use Task tool with subagent_type="
|
|
72
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
73
73
|
- Prompt: "Create contract tests for: $ARGUMENTS. Implement Pact/Dredd tests to validate API contracts between backend and frontend. Create integration tests for all API endpoints, test authentication flows, validate error responses, and ensure proper CORS configuration. Include load testing scenarios."
|
|
74
74
|
- Expected output: Contract test suites, integration tests, load test scenarios, API documentation validation
|
|
75
75
|
- Context: API implementations from Phase 2
|
|
76
76
|
|
|
77
77
|
### 8. End-to-End Testing
|
|
78
|
-
- Use Task tool with subagent_type="
|
|
78
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
79
79
|
- Prompt: "Implement E2E tests for: $ARGUMENTS. Create Playwright/Cypress tests covering critical user journeys, cross-browser compatibility, mobile responsiveness, and error scenarios. Test feature flags integration, analytics tracking, and performance metrics. Include visual regression tests."
|
|
80
80
|
- Expected output: E2E test suites, visual regression baselines, performance benchmarks, test reports
|
|
81
81
|
- Context: Frontend and backend implementations from Phase 2
|
|
82
82
|
|
|
83
83
|
### 9. Security Audit & Hardening
|
|
84
|
-
- Use Task tool with subagent_type="
|
|
84
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
85
85
|
- Prompt: "Perform security audit for: $ARGUMENTS. Review API security (authentication, authorization, rate limiting), check for OWASP Top 10 vulnerabilities, audit frontend for XSS/CSRF risks, validate input sanitization, and review secrets management. Provide penetration testing results and remediation steps."
|
|
86
86
|
- Expected output: Security audit report, vulnerability assessment, remediation recommendations, security headers configuration
|
|
87
87
|
- Context: All implementations from Phase 2
|
|
@@ -89,19 +89,19 @@ Orchestrate full-stack feature development across backend, frontend, and infrast
|
|
|
89
89
|
## Phase 4: Deployment & Operations
|
|
90
90
|
|
|
91
91
|
### 10. Infrastructure & CI/CD Setup
|
|
92
|
-
- Use Task tool with subagent_type="
|
|
92
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
93
93
|
- Prompt: "Setup deployment infrastructure for: $ARGUMENTS. Create Docker containers, Kubernetes manifests (or cloud-specific configs), implement CI/CD pipelines with automated testing gates, setup feature flags (LaunchDarkly/Unleash), and configure monitoring/alerting. Include blue-green deployment strategy and rollback procedures."
|
|
94
94
|
- Expected output: Dockerfiles, K8s manifests, CI/CD pipeline configs, feature flag setup, IaC templates (Terraform/CloudFormation)
|
|
95
95
|
- Context: All implementations and tests from previous phases
|
|
96
96
|
|
|
97
97
|
### 11. Observability & Monitoring
|
|
98
|
-
- Use Task tool with subagent_type="
|
|
98
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
99
99
|
- Prompt: "Implement observability stack for: $ARGUMENTS. Setup distributed tracing (OpenTelemetry), configure application metrics (Prometheus/DataDog), implement centralized logging (ELK/Splunk), create dashboards for key metrics, and define SLIs/SLOs. Include alerting rules and on-call procedures."
|
|
100
100
|
- Expected output: Observability configuration, dashboard definitions, alert rules, runbooks, SLI/SLO definitions
|
|
101
101
|
- Context: Infrastructure setup from step 10
|
|
102
102
|
|
|
103
103
|
### 12. Performance Optimization
|
|
104
|
-
- Use Task tool with subagent_type="
|
|
104
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
105
105
|
- Prompt: "Optimize performance across stack for: $ARGUMENTS. Analyze and optimize database queries, implement caching strategies (Redis/CDN), optimize frontend bundle size and loading performance, setup lazy loading and code splitting, and tune backend service performance. Include before/after metrics."
|
|
106
106
|
- Expected output: Performance improvements, caching configuration, CDN setup, optimized bundles, performance metrics report
|
|
107
107
|
- Context: Monitoring data from step 11, load test results
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Stage all files and create a commit.
|
|
3
3
|
---
|
|
4
|
-
Use
|
|
4
|
+
Use Task agent for git management: Task(subagent_type="general-purpose", prompt="You are a git-manager. Analyze changes, categorize commits, stage and commit...", description="Git commit") to:
|
|
5
5
|
- Analyze changes with `git status` and `git diff --stat`
|
|
6
6
|
- Categorize changes into multiple commits
|
|
7
7
|
- Stage files and create commits based on the changes made
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Stage, commit and push all code in the current branch
|
|
3
3
|
---
|
|
4
|
-
Use
|
|
4
|
+
Use Task agent for git management: Task(subagent_type="general-purpose", prompt="You are a git-manager. Analyze changes, categorize commits, stage, commit, and push...", description="Git commit and push") to:
|
|
5
5
|
- Analyze changes with `git status` and `git diff --stat`
|
|
6
6
|
- Categorize changes into multiple commits
|
|
7
7
|
- Stage files and create commits based on the changes made
|
|
@@ -10,7 +10,7 @@ FROM_BRANCH: $2 (defaults to current branch)
|
|
|
10
10
|
|
|
11
11
|
## Workflow
|
|
12
12
|
|
|
13
|
-
Use
|
|
13
|
+
Use Task agent for git management to execute the merge workflow: Task(subagent_type="general-purpose", prompt="You are a git-manager. Execute merge workflow...", description="Git merge")
|
|
14
14
|
|
|
15
15
|
### Step 1: Sync with remote (CRITICAL)
|
|
16
16
|
```bash
|
|
@@ -10,7 +10,7 @@ FROM_BRANCH: $2 (defaults to current branch)
|
|
|
10
10
|
|
|
11
11
|
## Workflow
|
|
12
12
|
|
|
13
|
-
Use
|
|
13
|
+
Use Task agent for git management to execute the PR workflow: Task(subagent_type="general-purpose", prompt="You are a git-manager. Execute PR workflow...", description="Create pull request")
|
|
14
14
|
|
|
15
15
|
### Step 1: Ensure remote is synced
|
|
16
16
|
```bash
|
|
@@ -44,12 +44,12 @@ Orchestrate a comprehensive git workflow from code review through PR creation, l
|
|
|
44
44
|
## Phase 1: Pre-Commit Review and Analysis
|
|
45
45
|
|
|
46
46
|
### 1. Code Quality Assessment
|
|
47
|
-
- Use Task tool with subagent_type="
|
|
47
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
48
48
|
- Prompt: "Review all uncommitted changes for code quality issues. Check for: 1) Code style violations, 2) Security vulnerabilities, 3) Performance concerns, 4) Missing error handling, 5) Incomplete implementations. Generate a detailed report with severity levels (critical/high/medium/low) and provide specific line-by-line feedback. Output format: JSON with {issues: [], summary: {critical: 0, high: 0, medium: 0, low: 0}, recommendations: []}"
|
|
49
49
|
- Expected output: Structured code review report for next phase
|
|
50
50
|
|
|
51
51
|
### 2. Dependency and Breaking Change Analysis
|
|
52
|
-
- Use Task tool with subagent_type="
|
|
52
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
53
53
|
- Prompt: "Analyze the changes for: 1) New dependencies or version changes, 2) Breaking API changes, 3) Database schema modifications, 4) Configuration changes, 5) Backward compatibility issues. Context from previous review: [insert issues summary]. Identify any changes that require migration scripts or documentation updates."
|
|
54
54
|
- Context from previous: Code quality issues that might indicate breaking changes
|
|
55
55
|
- Expected output: Breaking change assessment and migration requirements
|
|
@@ -57,13 +57,13 @@ Orchestrate a comprehensive git workflow from code review through PR creation, l
|
|
|
57
57
|
## Phase 2: Testing and Validation
|
|
58
58
|
|
|
59
59
|
### 1. Test Execution and Coverage
|
|
60
|
-
- Use Task tool with subagent_type="
|
|
60
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
61
61
|
- Prompt: "Execute all test suites for the modified code. Run: 1) Unit tests, 2) Integration tests, 3) End-to-end tests if applicable. Generate coverage report and identify any untested code paths. Based on review issues: [insert critical/high issues], ensure tests cover the problem areas. Provide test results in format: {passed: [], failed: [], skipped: [], coverage: {statements: %, branches: %, functions: %, lines: %}, untested_critical_paths: []}"
|
|
62
62
|
- Context from previous: Critical code review issues that need test coverage
|
|
63
63
|
- Expected output: Complete test results and coverage metrics
|
|
64
64
|
|
|
65
65
|
### 2. Test Recommendations and Gap Analysis
|
|
66
|
-
- Use Task tool with subagent_type="
|
|
66
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
67
67
|
- Prompt: "Based on test results [insert summary] and code changes, identify: 1) Missing test scenarios, 2) Edge cases not covered, 3) Integration points needing verification, 4) Performance benchmarks needed. Generate test implementation recommendations prioritized by risk. Consider the breaking changes identified: [insert breaking changes]."
|
|
68
68
|
- Context from previous: Test results, breaking changes, untested paths
|
|
69
69
|
- Expected output: Prioritized list of additional tests needed
|
|
@@ -71,13 +71,13 @@ Orchestrate a comprehensive git workflow from code review through PR creation, l
|
|
|
71
71
|
## Phase 3: Commit Message Generation
|
|
72
72
|
|
|
73
73
|
### 1. Change Analysis and Categorization
|
|
74
|
-
- Use Task tool with subagent_type="
|
|
74
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
75
75
|
- Prompt: "Analyze all changes and categorize them according to Conventional Commits specification. Identify the primary change type (feat/fix/docs/style/refactor/perf/test/build/ci/chore/revert) and scope. For changes: [insert file list and summary], determine if this should be a single commit or multiple atomic commits. Consider test results: [insert test summary]."
|
|
76
76
|
- Context from previous: Test results, code review summary
|
|
77
77
|
- Expected output: Commit structure recommendation
|
|
78
78
|
|
|
79
79
|
### 2. Conventional Commit Message Creation
|
|
80
|
-
- Use Task tool with subagent_type="
|
|
80
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
81
81
|
- Prompt: "Create Conventional Commits format message(s) based on categorization: [insert categorization]. Format: <type>(<scope>): <subject> with blank line then <body> explaining what and why (not how), then <footer> with BREAKING CHANGE: if applicable. Include: 1) Clear subject line (50 chars max), 2) Detailed body explaining rationale, 3) References to issues/tickets, 4) Co-authors if applicable. Consider the impact: [insert breaking changes if any]."
|
|
82
82
|
- Context from previous: Change categorization, breaking changes
|
|
83
83
|
- Expected output: Properly formatted commit message(s)
|
|
@@ -85,12 +85,12 @@ Orchestrate a comprehensive git workflow from code review through PR creation, l
|
|
|
85
85
|
## Phase 4: Branch Strategy and Push Preparation
|
|
86
86
|
|
|
87
87
|
### 1. Branch Management
|
|
88
|
-
- Use Task tool with subagent_type="
|
|
88
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
89
89
|
- Prompt: "Based on workflow type [--trunk-based or --feature-branch], prepare branch strategy. For feature branch: ensure branch name follows pattern (feature|bugfix|hotfix)/<ticket>-<description>. For trunk-based: prepare for direct main push with feature flag strategy if needed. Current branch: [insert branch], target: [insert target branch]. Verify no conflicts with target branch."
|
|
90
90
|
- Expected output: Branch preparation commands and conflict status
|
|
91
91
|
|
|
92
92
|
### 2. Pre-Push Validation
|
|
93
|
-
- Use Task tool with subagent_type="
|
|
93
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
94
94
|
- Prompt: "Perform final pre-push checks: 1) Verify all CI checks will pass, 2) Confirm no sensitive data in commits, 3) Validate commit signatures if required, 4) Check branch protection rules, 5) Ensure all review comments addressed. Test summary: [insert test results]. Review status: [insert review summary]."
|
|
95
95
|
- Context from previous: All previous validation results
|
|
96
96
|
- Expected output: Push readiness confirmation or blocking issues
|
|
@@ -98,13 +98,13 @@ Orchestrate a comprehensive git workflow from code review through PR creation, l
|
|
|
98
98
|
## Phase 5: Pull Request Creation
|
|
99
99
|
|
|
100
100
|
### 1. PR Description Generation
|
|
101
|
-
- Use Task tool with subagent_type="
|
|
101
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
102
102
|
- Prompt: "Create comprehensive PR description including: 1) Summary of changes (what and why), 2) Type of change checklist, 3) Testing performed summary from [insert test results], 4) Screenshots/recordings if UI changes, 5) Deployment notes from [insert deployment considerations], 6) Related issues/tickets, 7) Breaking changes section if applicable: [insert breaking changes], 8) Reviewer checklist. Format as GitHub-flavored Markdown."
|
|
103
103
|
- Context from previous: All validation results, test outcomes, breaking changes
|
|
104
104
|
- Expected output: Complete PR description in Markdown
|
|
105
105
|
|
|
106
106
|
### 2. PR Metadata and Automation Setup
|
|
107
|
-
- Use Task tool with subagent_type="
|
|
107
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
108
108
|
- Prompt: "Configure PR metadata: 1) Assign appropriate reviewers based on CODEOWNERS, 2) Add labels (type, priority, component), 3) Link related issues, 4) Set milestone if applicable, 5) Configure merge strategy (squash/merge/rebase), 6) Set up auto-merge if all checks pass. Consider draft status: [--draft-pr flag]. Include test status: [insert test summary]."
|
|
109
109
|
- Context from previous: PR description, test results, review status
|
|
110
110
|
- Expected output: PR configuration commands and automation rules
|
|
@@ -25,7 +25,7 @@ Use this skill when users need to:
|
|
|
25
25
|
|
|
26
26
|
**LlmAgent**: LLM-powered agents capable of dynamic routing and adaptive behavior
|
|
27
27
|
- Define with name, model, instruction, description, and tools
|
|
28
|
-
- Supports
|
|
28
|
+
- Supports Task agents for delegation and coordination
|
|
29
29
|
- Intelligent decision-making based on context
|
|
30
30
|
|
|
31
31
|
**Workflow Agents**: Structured, predictable orchestration patterns
|
|
@@ -27,7 +27,7 @@ source: community
|
|
|
27
27
|
- Provide actionable steps and verification.
|
|
28
28
|
- If detailed examples are required, open `resources/implementation-playbook.md`.
|
|
29
29
|
|
|
30
|
-
You are **HR-Pro**, a professional, employee-centered and compliance-aware Human Resources
|
|
30
|
+
You are **HR-Pro**, a professional, employee-centered and compliance-aware Human Resources Task agent for Claude Code.
|
|
31
31
|
|
|
32
32
|
## IMPORTANT LEGAL DISCLAIMER
|
|
33
33
|
- **NOT LEGAL ADVICE.** HR-Pro provides general HR information and templates only and does not create an attorney–client relationship.
|