@ngxtm/devkit 3.19.0 → 3.21.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/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/recover.md +22 -0
- 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/sync.md +29 -5
- 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/base/auto-skill.md +60 -0
- package/rules/base/command-routing.md +58 -0
- package/rules/base/context-checkpoint.md +38 -0
- package/rules-index.json +1 -1
- package/scripts/organize-rules.js +9 -0
- 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/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
- package/skills-graph.json +1 -1
- package/templates/base/rules/auto-skill.md +16 -96
- package/templates/base/rules/command-routing.md +0 -13
- package/templates/base/rules/context-checkpoint.md +38 -0
|
@@ -7,14 +7,14 @@ source: community
|
|
|
7
7
|
|
|
8
8
|
# Requesting Code Review
|
|
9
9
|
|
|
10
|
-
Dispatch superpowers:code-reviewer
|
|
10
|
+
Dispatch superpowers:code-reviewer Task agent to catch issues before they cascade.
|
|
11
11
|
|
|
12
12
|
**Core principle:** Review early, review often.
|
|
13
13
|
|
|
14
14
|
## When to Request Review
|
|
15
15
|
|
|
16
16
|
**Mandatory:**
|
|
17
|
-
- After each task in
|
|
17
|
+
- After each task in Task agent-driven development
|
|
18
18
|
- After completing major feature
|
|
19
19
|
- Before merge to main
|
|
20
20
|
|
|
@@ -31,7 +31,7 @@ BASE_SHA=$(git rev-parse HEAD~1) # or origin/main
|
|
|
31
31
|
HEAD_SHA=$(git rev-parse HEAD)
|
|
32
32
|
```
|
|
33
33
|
|
|
34
|
-
**2. Dispatch code-reviewer
|
|
34
|
+
**2. Dispatch code-reviewer Task agent:**
|
|
35
35
|
|
|
36
36
|
Use Task tool with superpowers:code-reviewer type, fill template at `code-reviewer.md`
|
|
37
37
|
|
|
@@ -58,14 +58,14 @@ You: Let me request code review before proceeding.
|
|
|
58
58
|
BASE_SHA=$(git log --oneline | grep "Task 1" | head -1 | awk '{print $1}')
|
|
59
59
|
HEAD_SHA=$(git rev-parse HEAD)
|
|
60
60
|
|
|
61
|
-
[Dispatch superpowers:code-reviewer
|
|
61
|
+
[Dispatch superpowers:code-reviewer Task agent]
|
|
62
62
|
WHAT_WAS_IMPLEMENTED: Verification and repair functions for conversation index
|
|
63
63
|
PLAN_OR_REQUIREMENTS: Task 2 from docs/plans/deployment-plan.md
|
|
64
64
|
BASE_SHA: a7981ec
|
|
65
65
|
HEAD_SHA: 3df7661
|
|
66
66
|
DESCRIPTION: Added verifyIndex() and repairIndex() with 4 issue types
|
|
67
67
|
|
|
68
|
-
[
|
|
68
|
+
[Task agent returns]:
|
|
69
69
|
Strengths: Clean architecture, real tests
|
|
70
70
|
Issues:
|
|
71
71
|
Important: Missing progress indicators
|
|
@@ -78,7 +78,7 @@ You: [Fix progress indicators]
|
|
|
78
78
|
|
|
79
79
|
## Integration with Workflows
|
|
80
80
|
|
|
81
|
-
**
|
|
81
|
+
**Task Agent-Driven Development:**
|
|
82
82
|
- Review after EACH task
|
|
83
83
|
- Catch issues before they compound
|
|
84
84
|
- Fix before moving to next task
|
|
@@ -36,19 +36,19 @@ Implement comprehensive security hardening with defense-in-depth strategy throug
|
|
|
36
36
|
## Phase 1: Comprehensive Security Assessment
|
|
37
37
|
|
|
38
38
|
### 1. Initial Vulnerability Scanning
|
|
39
|
-
- Use Task tool with subagent_type="
|
|
39
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
40
40
|
- Prompt: "Perform comprehensive security assessment on: $ARGUMENTS. Execute SAST analysis with Semgrep/SonarQube, DAST scanning with OWASP ZAP, dependency audit with Snyk/Trivy, secrets detection with GitLeaks/TruffleHog. Generate SBOM for supply chain analysis. Identify OWASP Top 10 vulnerabilities, CWE weaknesses, and CVE exposures."
|
|
41
41
|
- Output: Detailed vulnerability report with CVSS scores, exploitability analysis, attack surface mapping, secrets exposure report, SBOM inventory
|
|
42
42
|
- Context: Initial baseline for all remediation efforts
|
|
43
43
|
|
|
44
44
|
### 2. Threat Modeling and Risk Analysis
|
|
45
|
-
- Use Task tool with subagent_type="
|
|
45
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
46
46
|
- Prompt: "Conduct threat modeling using STRIDE methodology for: $ARGUMENTS. Analyze attack vectors, create attack trees, assess business impact of identified vulnerabilities. Map threats to MITRE ATT&CK framework. Prioritize risks based on likelihood and impact."
|
|
47
47
|
- Output: Threat model diagrams, risk matrix with prioritized vulnerabilities, attack scenario documentation, business impact analysis
|
|
48
48
|
- Context: Uses vulnerability scan results to inform threat priorities
|
|
49
49
|
|
|
50
50
|
### 3. Architecture Security Review
|
|
51
|
-
- Use Task tool with subagent_type="
|
|
51
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
52
52
|
- Prompt: "Review architecture for security weaknesses in: $ARGUMENTS. Evaluate service boundaries, data flow security, authentication/authorization architecture, encryption implementation, network segmentation. Design zero-trust architecture patterns. Reference threat model and vulnerability findings."
|
|
53
53
|
- Output: Security architecture assessment, zero-trust design recommendations, service mesh security requirements, data classification matrix
|
|
54
54
|
- Context: Incorporates threat model to address architectural vulnerabilities
|
|
@@ -56,25 +56,25 @@ Implement comprehensive security hardening with defense-in-depth strategy throug
|
|
|
56
56
|
## Phase 2: Vulnerability Remediation
|
|
57
57
|
|
|
58
58
|
### 4. Critical Vulnerability Fixes
|
|
59
|
-
- Use Task tool with subagent_type="
|
|
59
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
60
60
|
- Prompt: "Coordinate immediate remediation of critical vulnerabilities (CVSS 7+) in: $ARGUMENTS. Fix SQL injections with parameterized queries, XSS with output encoding, authentication bypasses with secure session management, insecure deserialization with input validation. Apply security patches for CVEs."
|
|
61
61
|
- Output: Patched code with vulnerability fixes, security patch documentation, regression test requirements
|
|
62
62
|
- Context: Addresses high-priority items from vulnerability assessment
|
|
63
63
|
|
|
64
64
|
### 5. Backend Security Hardening
|
|
65
|
-
- Use Task tool with subagent_type="
|
|
65
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
66
66
|
- Prompt: "Implement comprehensive backend security controls for: $ARGUMENTS. Add input validation with OWASP ESAPI, implement rate limiting and DDoS protection, secure API endpoints with OAuth2/JWT validation, add encryption for data at rest/transit using AES-256/TLS 1.3. Implement secure logging without PII exposure."
|
|
67
67
|
- Output: Hardened API endpoints, validation middleware, encryption implementation, secure configuration templates
|
|
68
68
|
- Context: Builds upon vulnerability fixes with preventive controls
|
|
69
69
|
|
|
70
70
|
### 6. Frontend Security Implementation
|
|
71
|
-
- Use Task tool with subagent_type="
|
|
71
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
72
72
|
- Prompt: "Implement frontend security measures for: $ARGUMENTS. Configure CSP headers with nonce-based policies, implement XSS prevention with DOMPurify, secure authentication flows with PKCE OAuth2, add SRI for external resources, implement secure cookie handling with SameSite/HttpOnly/Secure flags."
|
|
73
73
|
- Output: Secure frontend components, CSP policy configuration, authentication flow implementation, security headers configuration
|
|
74
74
|
- Context: Complements backend security with client-side protections
|
|
75
75
|
|
|
76
76
|
### 7. Mobile Security Hardening
|
|
77
|
-
- Use Task tool with subagent_type="
|
|
77
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
78
78
|
- Prompt: "Implement mobile app security for: $ARGUMENTS. Add certificate pinning, implement biometric authentication, secure local storage with encryption, obfuscate code with ProGuard/R8, implement anti-tampering and root/jailbreak detection, secure IPC communications."
|
|
79
79
|
- Output: Hardened mobile application, security configuration files, obfuscation rules, certificate pinning implementation
|
|
80
80
|
- Context: Extends security to mobile platforms if applicable
|
|
@@ -82,19 +82,19 @@ Implement comprehensive security hardening with defense-in-depth strategy throug
|
|
|
82
82
|
## Phase 3: Security Controls Implementation
|
|
83
83
|
|
|
84
84
|
### 8. Authentication and Authorization Enhancement
|
|
85
|
-
- Use Task tool with subagent_type="
|
|
85
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
86
86
|
- Prompt: "Implement modern authentication system for: $ARGUMENTS. Deploy OAuth2/OIDC with PKCE, implement MFA with TOTP/WebAuthn/FIDO2, add risk-based authentication, implement RBAC/ABAC with principle of least privilege, add session management with secure token rotation."
|
|
87
87
|
- Output: Authentication service configuration, MFA implementation, authorization policies, session management system
|
|
88
88
|
- Context: Strengthens access controls based on architecture review
|
|
89
89
|
|
|
90
90
|
### 9. Infrastructure Security Controls
|
|
91
|
-
- Use Task tool with subagent_type="
|
|
91
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
92
92
|
- Prompt: "Deploy infrastructure security controls for: $ARGUMENTS. Configure WAF rules for OWASP protection, implement network segmentation with micro-segmentation, deploy IDS/IPS systems, configure cloud security groups and NACLs, implement DDoS protection with rate limiting and geo-blocking."
|
|
93
93
|
- Output: WAF configuration, network security policies, IDS/IPS rules, cloud security configurations
|
|
94
94
|
- Context: Implements network-level defenses
|
|
95
95
|
|
|
96
96
|
### 10. Secrets Management Implementation
|
|
97
|
-
- Use Task tool with subagent_type="
|
|
97
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
98
98
|
- Prompt: "Implement enterprise secrets management for: $ARGUMENTS. Deploy HashiCorp Vault or AWS Secrets Manager, implement secret rotation policies, remove hardcoded secrets, configure least-privilege IAM roles, implement encryption key management with HSM support."
|
|
99
99
|
- Output: Secrets management configuration, rotation policies, IAM role definitions, key management procedures
|
|
100
100
|
- Context: Eliminates secrets exposure vulnerabilities
|
|
@@ -102,19 +102,19 @@ Implement comprehensive security hardening with defense-in-depth strategy throug
|
|
|
102
102
|
## Phase 4: Validation and Compliance
|
|
103
103
|
|
|
104
104
|
### 11. Penetration Testing and Validation
|
|
105
|
-
- Use Task tool with subagent_type="
|
|
105
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
106
106
|
- Prompt: "Execute comprehensive penetration testing for: $ARGUMENTS. Perform authenticated and unauthenticated testing, API security testing, business logic testing, privilege escalation attempts. Use Burp Suite, Metasploit, and custom exploits. Validate all security controls effectiveness."
|
|
107
107
|
- Output: Penetration test report, proof-of-concept exploits, remediation validation, security control effectiveness metrics
|
|
108
108
|
- Context: Validates all implemented security measures
|
|
109
109
|
|
|
110
110
|
### 12. Compliance and Standards Verification
|
|
111
|
-
- Use Task tool with subagent_type="
|
|
111
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
112
112
|
- Prompt: "Verify compliance with security frameworks for: $ARGUMENTS. Validate against OWASP ASVS Level 2, CIS Benchmarks, SOC2 Type II requirements, GDPR/CCPA privacy controls, HIPAA/PCI-DSS if applicable. Generate compliance attestation reports."
|
|
113
113
|
- Output: Compliance assessment report, gap analysis, remediation requirements, audit evidence collection
|
|
114
114
|
- Context: Ensures regulatory and industry standard compliance
|
|
115
115
|
|
|
116
116
|
### 13. Security Monitoring and SIEM Integration
|
|
117
|
-
- Use Task tool with subagent_type="
|
|
117
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
118
118
|
- Prompt: "Implement security monitoring and SIEM for: $ARGUMENTS. Deploy Splunk/ELK/Sentinel integration, configure security event correlation, implement behavioral analytics for anomaly detection, set up automated incident response playbooks, create security dashboards and alerting."
|
|
119
119
|
- Output: SIEM configuration, correlation rules, incident response playbooks, security dashboards, alert definitions
|
|
120
120
|
- Context: Establishes continuous security monitoring
|
|
@@ -5,11 +5,11 @@ risk: unknown
|
|
|
5
5
|
source: community
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
#
|
|
8
|
+
# Task Agent-Driven Development
|
|
9
9
|
|
|
10
|
-
Execute plan by dispatching fresh
|
|
10
|
+
Execute plan by dispatching fresh Task agent per task, with two-stage review after each: spec compliance review first, then code quality review.
|
|
11
11
|
|
|
12
|
-
**Core principle:** Fresh
|
|
12
|
+
**Core principle:** Fresh Task agent per task + two-stage review (spec then quality) = high quality, fast iteration
|
|
13
13
|
|
|
14
14
|
## When to Use
|
|
15
15
|
|
|
@@ -33,7 +33,7 @@ digraph when_to_use {
|
|
|
33
33
|
|
|
34
34
|
**vs. Executing Plans (parallel session):**
|
|
35
35
|
- Same session (no context switch)
|
|
36
|
-
- Fresh
|
|
36
|
+
- Fresh Task agent per task (no context pollution)
|
|
37
37
|
- Two-stage review after each task: spec compliance first, then code quality
|
|
38
38
|
- Faster iteration (no human-in-loop between tasks)
|
|
39
39
|
|
|
@@ -45,55 +45,55 @@ digraph process {
|
|
|
45
45
|
|
|
46
46
|
subgraph cluster_per_task {
|
|
47
47
|
label="Per Task";
|
|
48
|
-
"Dispatch implementer
|
|
49
|
-
"Implementer
|
|
48
|
+
"Dispatch implementer Task agent (./implementer-prompt.md)" [shape=box];
|
|
49
|
+
"Implementer Task agent asks questions?" [shape=diamond];
|
|
50
50
|
"Answer questions, provide context" [shape=box];
|
|
51
|
-
"Implementer
|
|
52
|
-
"Dispatch spec reviewer
|
|
53
|
-
"Spec reviewer
|
|
54
|
-
"Implementer
|
|
55
|
-
"Dispatch code quality reviewer
|
|
56
|
-
"Code quality reviewer
|
|
57
|
-
"Implementer
|
|
51
|
+
"Implementer Task agent implements, tests, commits, self-reviews" [shape=box];
|
|
52
|
+
"Dispatch spec reviewer Task agent (./spec-reviewer-prompt.md)" [shape=box];
|
|
53
|
+
"Spec reviewer Task agent confirms code matches spec?" [shape=diamond];
|
|
54
|
+
"Implementer Task agent fixes spec gaps" [shape=box];
|
|
55
|
+
"Dispatch code quality reviewer Task agent (./code-quality-reviewer-prompt.md)" [shape=box];
|
|
56
|
+
"Code quality reviewer Task agent approves?" [shape=diamond];
|
|
57
|
+
"Implementer Task agent fixes quality issues" [shape=box];
|
|
58
58
|
"Mark task complete in TodoWrite" [shape=box];
|
|
59
59
|
}
|
|
60
60
|
|
|
61
61
|
"Read plan, extract all tasks with full text, note context, create TodoWrite" [shape=box];
|
|
62
62
|
"More tasks remain?" [shape=diamond];
|
|
63
|
-
"Dispatch final code reviewer
|
|
63
|
+
"Dispatch final code reviewer Task agent for entire implementation" [shape=box];
|
|
64
64
|
"Use superpowers:finishing-a-development-branch" [shape=box style=filled fillcolor=lightgreen];
|
|
65
65
|
|
|
66
|
-
"Read plan, extract all tasks with full text, note context, create TodoWrite" -> "Dispatch implementer
|
|
67
|
-
"Dispatch implementer
|
|
68
|
-
"Implementer
|
|
69
|
-
"Answer questions, provide context" -> "Dispatch implementer
|
|
70
|
-
"Implementer
|
|
71
|
-
"Implementer
|
|
72
|
-
"Dispatch spec reviewer
|
|
73
|
-
"Spec reviewer
|
|
74
|
-
"Implementer
|
|
75
|
-
"Spec reviewer
|
|
76
|
-
"Dispatch code quality reviewer
|
|
77
|
-
"Code quality reviewer
|
|
78
|
-
"Implementer
|
|
79
|
-
"Code quality reviewer
|
|
66
|
+
"Read plan, extract all tasks with full text, note context, create TodoWrite" -> "Dispatch implementer Task agent (./implementer-prompt.md)";
|
|
67
|
+
"Dispatch implementer Task agent (./implementer-prompt.md)" -> "Implementer Task agent asks questions?";
|
|
68
|
+
"Implementer Task agent asks questions?" -> "Answer questions, provide context" [label="yes"];
|
|
69
|
+
"Answer questions, provide context" -> "Dispatch implementer Task agent (./implementer-prompt.md)";
|
|
70
|
+
"Implementer Task agent asks questions?" -> "Implementer Task agent implements, tests, commits, self-reviews" [label="no"];
|
|
71
|
+
"Implementer Task agent implements, tests, commits, self-reviews" -> "Dispatch spec reviewer Task agent (./spec-reviewer-prompt.md)";
|
|
72
|
+
"Dispatch spec reviewer Task agent (./spec-reviewer-prompt.md)" -> "Spec reviewer Task agent confirms code matches spec?";
|
|
73
|
+
"Spec reviewer Task agent confirms code matches spec?" -> "Implementer Task agent fixes spec gaps" [label="no"];
|
|
74
|
+
"Implementer Task agent fixes spec gaps" -> "Dispatch spec reviewer Task agent (./spec-reviewer-prompt.md)" [label="re-review"];
|
|
75
|
+
"Spec reviewer Task agent confirms code matches spec?" -> "Dispatch code quality reviewer Task agent (./code-quality-reviewer-prompt.md)" [label="yes"];
|
|
76
|
+
"Dispatch code quality reviewer Task agent (./code-quality-reviewer-prompt.md)" -> "Code quality reviewer Task agent approves?";
|
|
77
|
+
"Code quality reviewer Task agent approves?" -> "Implementer Task agent fixes quality issues" [label="no"];
|
|
78
|
+
"Implementer Task agent fixes quality issues" -> "Dispatch code quality reviewer Task agent (./code-quality-reviewer-prompt.md)" [label="re-review"];
|
|
79
|
+
"Code quality reviewer Task agent approves?" -> "Mark task complete in TodoWrite" [label="yes"];
|
|
80
80
|
"Mark task complete in TodoWrite" -> "More tasks remain?";
|
|
81
|
-
"More tasks remain?" -> "Dispatch implementer
|
|
82
|
-
"More tasks remain?" -> "Dispatch final code reviewer
|
|
83
|
-
"Dispatch final code reviewer
|
|
81
|
+
"More tasks remain?" -> "Dispatch implementer Task agent (./implementer-prompt.md)" [label="yes"];
|
|
82
|
+
"More tasks remain?" -> "Dispatch final code reviewer Task agent for entire implementation" [label="no"];
|
|
83
|
+
"Dispatch final code reviewer Task agent for entire implementation" -> "Use superpowers:finishing-a-development-branch";
|
|
84
84
|
}
|
|
85
85
|
```
|
|
86
86
|
|
|
87
87
|
## Prompt Templates
|
|
88
88
|
|
|
89
|
-
- `./implementer-prompt.md` - Dispatch implementer
|
|
90
|
-
- `./spec-reviewer-prompt.md` - Dispatch spec compliance reviewer
|
|
91
|
-
- `./code-quality-reviewer-prompt.md` - Dispatch code quality reviewer
|
|
89
|
+
- `./implementer-prompt.md` - Dispatch implementer Task agent
|
|
90
|
+
- `./spec-reviewer-prompt.md` - Dispatch spec compliance reviewer Task agent
|
|
91
|
+
- `./code-quality-reviewer-prompt.md` - Dispatch code quality reviewer Task agent
|
|
92
92
|
|
|
93
93
|
## Example Workflow
|
|
94
94
|
|
|
95
95
|
```
|
|
96
|
-
You: I'm using
|
|
96
|
+
You: I'm using Task Agent-Driven Development to execute this plan.
|
|
97
97
|
|
|
98
98
|
[Read plan file once: docs/plans/feature-plan.md]
|
|
99
99
|
[Extract all 5 tasks with full text and context]
|
|
@@ -102,7 +102,7 @@ You: I'm using Subagent-Driven Development to execute this plan.
|
|
|
102
102
|
Task 1: Hook installation script
|
|
103
103
|
|
|
104
104
|
[Get Task 1 text and context (already extracted)]
|
|
105
|
-
[Dispatch implementation
|
|
105
|
+
[Dispatch implementation Task agent with full task text + context]
|
|
106
106
|
|
|
107
107
|
Implementer: "Before I begin - should the hook be installed at user or system level?"
|
|
108
108
|
|
|
@@ -126,7 +126,7 @@ Code reviewer: Strengths: Good test coverage, clean. Issues: None. Approved.
|
|
|
126
126
|
Task 2: Recovery modes
|
|
127
127
|
|
|
128
128
|
[Get Task 2 text and context (already extracted)]
|
|
129
|
-
[Dispatch implementation
|
|
129
|
+
[Dispatch implementation Task agent with full task text + context]
|
|
130
130
|
|
|
131
131
|
Implementer: [No questions, proceeds]
|
|
132
132
|
Implementer:
|
|
@@ -169,10 +169,10 @@ Done!
|
|
|
169
169
|
## Advantages
|
|
170
170
|
|
|
171
171
|
**vs. Manual execution:**
|
|
172
|
-
-
|
|
172
|
+
- Task agents follow TDD naturally
|
|
173
173
|
- Fresh context per task (no confusion)
|
|
174
|
-
- Parallel-safe (
|
|
175
|
-
-
|
|
174
|
+
- Parallel-safe (Task agents don't interfere)
|
|
175
|
+
- Task agent can ask questions (before AND during work)
|
|
176
176
|
|
|
177
177
|
**vs. Executing Plans:**
|
|
178
178
|
- Same session (no handoff)
|
|
@@ -182,7 +182,7 @@ Done!
|
|
|
182
182
|
**Efficiency gains:**
|
|
183
183
|
- No file reading overhead (controller provides full text)
|
|
184
184
|
- Controller curates exactly what context is needed
|
|
185
|
-
-
|
|
185
|
+
- Task agent gets complete information upfront
|
|
186
186
|
- Questions surfaced before work begins (not after)
|
|
187
187
|
|
|
188
188
|
**Quality gates:**
|
|
@@ -193,7 +193,7 @@ Done!
|
|
|
193
193
|
- Code quality ensures implementation is well-built
|
|
194
194
|
|
|
195
195
|
**Cost:**
|
|
196
|
-
- More
|
|
196
|
+
- More Task agent invocations (implementer + 2 reviewers per task)
|
|
197
197
|
- Controller does more prep work (extracting all tasks upfront)
|
|
198
198
|
- Review loops add iterations
|
|
199
199
|
- But catches issues early (cheaper than debugging later)
|
|
@@ -203,40 +203,40 @@ Done!
|
|
|
203
203
|
**Never:**
|
|
204
204
|
- Skip reviews (spec compliance OR code quality)
|
|
205
205
|
- Proceed with unfixed issues
|
|
206
|
-
- Dispatch multiple implementation
|
|
207
|
-
- Make
|
|
208
|
-
- Skip scene-setting context (
|
|
209
|
-
- Ignore
|
|
206
|
+
- Dispatch multiple implementation Task agents in parallel (conflicts)
|
|
207
|
+
- Make Task agent read plan file (provide full text instead)
|
|
208
|
+
- Skip scene-setting context (Task agent needs to understand where task fits)
|
|
209
|
+
- Ignore Task agent questions (answer before letting them proceed)
|
|
210
210
|
- Accept "close enough" on spec compliance (spec reviewer found issues = not done)
|
|
211
211
|
- Skip review loops (reviewer found issues = implementer fixes = review again)
|
|
212
212
|
- Let implementer self-review replace actual review (both are needed)
|
|
213
213
|
- **Start code quality review before spec compliance is ✅** (wrong order)
|
|
214
214
|
- Move to next task while either review has open issues
|
|
215
215
|
|
|
216
|
-
**If
|
|
216
|
+
**If Task agent asks questions:**
|
|
217
217
|
- Answer clearly and completely
|
|
218
218
|
- Provide additional context if needed
|
|
219
219
|
- Don't rush them into implementation
|
|
220
220
|
|
|
221
221
|
**If reviewer finds issues:**
|
|
222
|
-
- Implementer (same
|
|
222
|
+
- Implementer (same Task agent) fixes them
|
|
223
223
|
- Reviewer reviews again
|
|
224
224
|
- Repeat until approved
|
|
225
225
|
- Don't skip the re-review
|
|
226
226
|
|
|
227
|
-
**If
|
|
228
|
-
- Dispatch fix
|
|
227
|
+
**If Task agent fails task:**
|
|
228
|
+
- Dispatch fix Task agent with specific instructions
|
|
229
229
|
- Don't try to fix manually (context pollution)
|
|
230
230
|
|
|
231
231
|
## Integration
|
|
232
232
|
|
|
233
233
|
**Required workflow skills:**
|
|
234
234
|
- **superpowers:writing-plans** - Creates the plan this skill executes
|
|
235
|
-
- **superpowers:requesting-code-review** - Code review template for reviewer
|
|
235
|
+
- **superpowers:requesting-code-review** - Code review template for reviewer Task agents
|
|
236
236
|
- **superpowers:finishing-a-development-branch** - Complete development after all tasks
|
|
237
237
|
|
|
238
|
-
**
|
|
239
|
-
- **superpowers:test-driven-development** -
|
|
238
|
+
**Task agents should use:**
|
|
239
|
+
- **superpowers:test-driven-development** - Task agents follow TDD for each task
|
|
240
240
|
|
|
241
241
|
**Alternative workflow:**
|
|
242
242
|
- **superpowers:executing-plans** - Use for parallel session instead of same-session execution
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Code Quality Reviewer Prompt Template
|
|
2
2
|
|
|
3
|
-
Use this template when dispatching a code quality reviewer
|
|
3
|
+
Use this template when dispatching a code quality reviewer Task agent.
|
|
4
4
|
|
|
5
5
|
**Purpose:** Verify implementation is well-built (clean, tested, maintainable)
|
|
6
6
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
# Implementer
|
|
1
|
+
# Implementer Task Agent Prompt Template
|
|
2
2
|
|
|
3
|
-
Use this template when dispatching an implementer
|
|
3
|
+
Use this template when dispatching an implementer Task agent.
|
|
4
4
|
|
|
5
5
|
```
|
|
6
6
|
Task tool (general-purpose):
|
|
@@ -10,7 +10,7 @@ Task tool (general-purpose):
|
|
|
10
10
|
|
|
11
11
|
## Task Description
|
|
12
12
|
|
|
13
|
-
[FULL TEXT of task from plan - paste it here, don't make
|
|
13
|
+
[FULL TEXT of task from plan - paste it here, don't make Task agent read file]
|
|
14
14
|
|
|
15
15
|
## Context
|
|
16
16
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Spec Compliance Reviewer Prompt Template
|
|
2
2
|
|
|
3
|
-
Use this template when dispatching a spec compliance reviewer
|
|
3
|
+
Use this template when dispatching a spec compliance reviewer Task agent.
|
|
4
4
|
|
|
5
5
|
**Purpose:** Verify implementer built what was requested (nothing more, nothing less)
|
|
6
6
|
|
|
@@ -42,13 +42,13 @@ Execute a comprehensive Test-Driven Development (TDD) workflow with strict red-g
|
|
|
42
42
|
## Phase 1: Test Specification and Design
|
|
43
43
|
|
|
44
44
|
### 1. Requirements Analysis
|
|
45
|
-
- Use Task tool with subagent_type="
|
|
45
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
46
46
|
- Prompt: "Analyze requirements for: $ARGUMENTS. Define acceptance criteria, identify edge cases, and create test scenarios. Output a comprehensive test specification."
|
|
47
47
|
- Output: Test specification, acceptance criteria, edge case matrix
|
|
48
48
|
- Validation: Ensure all requirements have corresponding test scenarios
|
|
49
49
|
|
|
50
50
|
### 2. Test Architecture Design
|
|
51
|
-
- Use Task tool with subagent_type="
|
|
51
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
52
52
|
- Prompt: "Design test architecture for: $ARGUMENTS based on test specification. Define test structure, fixtures, mocks, and test data strategy. Ensure testability and maintainability."
|
|
53
53
|
- Output: Test architecture, fixture design, mock strategy
|
|
54
54
|
- Validation: Architecture supports isolated, fast, reliable tests
|
|
@@ -56,13 +56,13 @@ Execute a comprehensive Test-Driven Development (TDD) workflow with strict red-g
|
|
|
56
56
|
## Phase 2: RED - Write Failing Tests
|
|
57
57
|
|
|
58
58
|
### 3. Write Unit Tests (Failing)
|
|
59
|
-
- Use Task tool with subagent_type="
|
|
59
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
60
60
|
- Prompt: "Write FAILING unit tests for: $ARGUMENTS. Tests must fail initially. Include edge cases, error scenarios, and happy paths. DO NOT implement production code."
|
|
61
61
|
- Output: Failing unit tests, test documentation
|
|
62
62
|
- **CRITICAL**: Verify all tests fail with expected error messages
|
|
63
63
|
|
|
64
64
|
### 4. Verify Test Failure
|
|
65
|
-
- Use Task tool with subagent_type="
|
|
65
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
66
66
|
- Prompt: "Verify that all tests for: $ARGUMENTS are failing correctly. Ensure failures are for the right reasons (missing implementation, not test errors). Confirm no false positives."
|
|
67
67
|
- Output: Test failure verification report
|
|
68
68
|
- **GATE**: Do not proceed until all tests fail appropriately
|
|
@@ -70,13 +70,13 @@ Execute a comprehensive Test-Driven Development (TDD) workflow with strict red-g
|
|
|
70
70
|
## Phase 3: GREEN - Make Tests Pass
|
|
71
71
|
|
|
72
72
|
### 5. Minimal Implementation
|
|
73
|
-
- Use Task tool with subagent_type="
|
|
73
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
74
74
|
- Prompt: "Implement MINIMAL code to make tests pass for: $ARGUMENTS. Focus only on making tests green. Do not add extra features or optimizations. Keep it simple."
|
|
75
75
|
- Output: Minimal working implementation
|
|
76
76
|
- Constraint: No code beyond what's needed to pass tests
|
|
77
77
|
|
|
78
78
|
### 6. Verify Test Success
|
|
79
|
-
- Use Task tool with subagent_type="
|
|
79
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
80
80
|
- Prompt: "Run all tests for: $ARGUMENTS and verify they pass. Check test coverage metrics. Ensure no tests were accidentally broken."
|
|
81
81
|
- Output: Test execution report, coverage metrics
|
|
82
82
|
- **GATE**: All tests must pass before proceeding
|
|
@@ -84,13 +84,13 @@ Execute a comprehensive Test-Driven Development (TDD) workflow with strict red-g
|
|
|
84
84
|
## Phase 4: REFACTOR - Improve Code Quality
|
|
85
85
|
|
|
86
86
|
### 7. Code Refactoring
|
|
87
|
-
- Use Task tool with subagent_type="
|
|
87
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
88
88
|
- Prompt: "Refactor implementation for: $ARGUMENTS while keeping tests green. Apply SOLID principles, remove duplication, improve naming, and optimize performance. Run tests after each refactoring."
|
|
89
89
|
- Output: Refactored code, refactoring report
|
|
90
90
|
- Constraint: Tests must remain green throughout
|
|
91
91
|
|
|
92
92
|
### 8. Test Refactoring
|
|
93
|
-
- Use Task tool with subagent_type="
|
|
93
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
94
94
|
- Prompt: "Refactor tests for: $ARGUMENTS. Remove test duplication, improve test names, extract common fixtures, and enhance test readability. Ensure tests still provide same coverage."
|
|
95
95
|
- Output: Refactored tests, improved test structure
|
|
96
96
|
- Validation: Coverage metrics unchanged or improved
|
|
@@ -98,13 +98,13 @@ Execute a comprehensive Test-Driven Development (TDD) workflow with strict red-g
|
|
|
98
98
|
## Phase 5: Integration and System Tests
|
|
99
99
|
|
|
100
100
|
### 9. Write Integration Tests (Failing First)
|
|
101
|
-
- Use Task tool with subagent_type="
|
|
101
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
102
102
|
- Prompt: "Write FAILING integration tests for: $ARGUMENTS. Test component interactions, API contracts, and data flow. Tests must fail initially."
|
|
103
103
|
- Output: Failing integration tests
|
|
104
104
|
- Validation: Tests fail due to missing integration logic
|
|
105
105
|
|
|
106
106
|
### 10. Implement Integration
|
|
107
|
-
- Use Task tool with subagent_type="
|
|
107
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
108
108
|
- Prompt: "Implement integration code for: $ARGUMENTS to make integration tests pass. Focus on component interaction and data flow."
|
|
109
109
|
- Output: Integration implementation
|
|
110
110
|
- Validation: All integration tests pass
|
|
@@ -112,13 +112,13 @@ Execute a comprehensive Test-Driven Development (TDD) workflow with strict red-g
|
|
|
112
112
|
## Phase 6: Continuous Improvement Cycle
|
|
113
113
|
|
|
114
114
|
### 11. Performance and Edge Case Tests
|
|
115
|
-
- Use Task tool with subagent_type="
|
|
115
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
116
116
|
- Prompt: "Add performance tests and additional edge case tests for: $ARGUMENTS. Include stress tests, boundary tests, and error recovery tests."
|
|
117
117
|
- Output: Extended test suite
|
|
118
118
|
- Metric: Increased test coverage and scenario coverage
|
|
119
119
|
|
|
120
120
|
### 12. Final Code Review
|
|
121
|
-
- Use Task tool with subagent_type="
|
|
121
|
+
- Use Task tool with subagent_type="general-purpose"
|
|
122
122
|
- Prompt: "Perform comprehensive review of: $ARGUMENTS. Verify TDD process was followed, check code quality, test quality, and coverage. Suggest improvements."
|
|
123
123
|
- Output: Review report, improvement suggestions
|
|
124
124
|
- Action: Implement critical suggestions while maintaining green tests
|
|
@@ -32,7 +32,7 @@ Implement minimal code to make failing tests pass in TDD green phase:
|
|
|
32
32
|
|
|
33
33
|
## Implementation Process
|
|
34
34
|
|
|
35
|
-
Use Task tool with subagent_type="
|
|
35
|
+
Use Task tool with subagent_type="general-purpose" to implement minimal passing code.
|
|
36
36
|
|
|
37
37
|
Prompt: "Implement MINIMAL code to make these failing tests pass: $ARGUMENTS. Follow TDD green phase principles:
|
|
38
38
|
|
|
@@ -35,7 +35,7 @@ Write comprehensive failing tests following TDD red phase principles.
|
|
|
35
35
|
|
|
36
36
|
## Role
|
|
37
37
|
|
|
38
|
-
Generate failing tests using Task tool with subagent_type="
|
|
38
|
+
Generate failing tests using Task tool with subagent_type="general-purpose".
|
|
39
39
|
|
|
40
40
|
## Prompt Template
|
|
41
41
|
|
|
@@ -28,7 +28,7 @@ Refactor code with confidence using comprehensive test safety net:
|
|
|
28
28
|
|
|
29
29
|
## Usage
|
|
30
30
|
|
|
31
|
-
Use Task tool with subagent_type="
|
|
31
|
+
Use Task tool with subagent_type="general-purpose" to perform safe refactoring.
|
|
32
32
|
|
|
33
33
|
Prompt: "Refactor this code while keeping all tests green: $ARGUMENTS. Apply TDD refactor phase:
|
|
34
34
|
|
|
@@ -27,7 +27,7 @@ You are an advanced TypeScript expert with deep, practical knowledge of type-lev
|
|
|
27
27
|
- Type performance profiling or compiler internals → typescript-type-expert
|
|
28
28
|
|
|
29
29
|
Example to output:
|
|
30
|
-
"This requires deep bundler expertise. Please invoke: 'Use the typescript-build-expert
|
|
30
|
+
"This requires deep bundler expertise. Please invoke: 'Use the typescript-build-expert Task agent.' Stopping here."
|
|
31
31
|
|
|
32
32
|
1. Analyze project setup comprehensively:
|
|
33
33
|
|
|
@@ -102,16 +102,16 @@ After saving the plan, offer execution choice:
|
|
|
102
102
|
|
|
103
103
|
**"Plan complete and saved to `docs/plans/<filename>.md`. Two execution options:**
|
|
104
104
|
|
|
105
|
-
**1.
|
|
105
|
+
**1. Task Agent-Driven (this session)** - I dispatch fresh Task agent per task, review between tasks, fast iteration
|
|
106
106
|
|
|
107
107
|
**2. Parallel Session (separate)** - Open new session with executing-plans, batch execution with checkpoints
|
|
108
108
|
|
|
109
109
|
**Which approach?"**
|
|
110
110
|
|
|
111
|
-
**If
|
|
111
|
+
**If Task Agent-Driven chosen:**
|
|
112
112
|
- **REQUIRED SUB-SKILL:** Use superpowers:subagent-driven-development
|
|
113
113
|
- Stay in this session
|
|
114
|
-
- Fresh
|
|
114
|
+
- Fresh Task agent per task + code review
|
|
115
115
|
|
|
116
116
|
**If Parallel Session chosen:**
|
|
117
117
|
- Guide them to open new session in worktree
|
|
@@ -11,7 +11,7 @@ description: Use when creating new skills, editing existing skills, or verifying
|
|
|
11
11
|
|
|
12
12
|
**Personal skills live in agent-specific directories (`~/.claude/skills` for Claude Code, `~/.codex/skills` for Codex)**
|
|
13
13
|
|
|
14
|
-
You write test cases (pressure scenarios with
|
|
14
|
+
You write test cases (pressure scenarios with Task agents), watch them fail (baseline behavior), write the skill (documentation), watch tests pass (agents comply), and refactor (close loopholes).
|
|
15
15
|
|
|
16
16
|
**Core principle:** If you didn't watch an agent fail without the skill, you don't know if the skill teaches the right thing.
|
|
17
17
|
|
|
@@ -31,7 +31,7 @@ A **skill** is a reference guide for proven techniques, patterns, or tools. Skil
|
|
|
31
31
|
|
|
32
32
|
| TDD Concept | Skill Creation |
|
|
33
33
|
|-------------|----------------|
|
|
34
|
-
| **Test case** | Pressure scenario with
|
|
34
|
+
| **Test case** | Pressure scenario with Task agent |
|
|
35
35
|
| **Production code** | Skill document (SKILL.md) |
|
|
36
36
|
| **Test fails (RED)** | Agent violates rule without skill (baseline) |
|
|
37
37
|
| **Test passes (GREEN)** | Agent complies with skill present |
|
|
@@ -159,7 +159,7 @@ When the description was changed to just "Use when executing implementation plan
|
|
|
159
159
|
|
|
160
160
|
```yaml
|
|
161
161
|
# ❌ BAD: Summarizes workflow - Claude may follow this instead of reading skill
|
|
162
|
-
description: Use when executing plans - dispatches
|
|
162
|
+
description: Use when executing plans - dispatches Task agent per task with code review between tasks
|
|
163
163
|
|
|
164
164
|
# ❌ BAD: Too much process detail
|
|
165
165
|
description: Use for TDD - write test first, watch it fail, write minimal code, refactor
|
|
@@ -233,11 +233,11 @@ search-conversations supports multiple modes and filters. Run --help for details
|
|
|
233
233
|
**Use cross-references:**
|
|
234
234
|
```markdown
|
|
235
235
|
# ❌ BAD: Repeat workflow details
|
|
236
|
-
When searching, dispatch
|
|
236
|
+
When searching, dispatch Task agent with template...
|
|
237
237
|
[20 lines of repeated instructions]
|
|
238
238
|
|
|
239
239
|
# ✅ GOOD: Reference other skill
|
|
240
|
-
Always use
|
|
240
|
+
Always use Task agents (50-100x context savings). REQUIRED: Use [other-skill-name] for workflow.
|
|
241
241
|
```
|
|
242
242
|
|
|
243
243
|
**Compress examples:**
|
|
@@ -245,12 +245,12 @@ Always use subagents (50-100x context savings). REQUIRED: Use [other-skill-name]
|
|
|
245
245
|
# ❌ BAD: Verbose example (42 words)
|
|
246
246
|
your human partner: "How did we handle authentication errors in React Router before?"
|
|
247
247
|
You: I'll search past conversations for React Router authentication patterns.
|
|
248
|
-
[Dispatch
|
|
248
|
+
[Dispatch Task agent with search query: "React Router authentication error handling 401"]
|
|
249
249
|
|
|
250
250
|
# ✅ GOOD: Minimal example (20 words)
|
|
251
251
|
Partner: "How did we handle auth errors in React Router?"
|
|
252
252
|
You: Searching...
|
|
253
|
-
[Dispatch
|
|
253
|
+
[Dispatch Task agent → synthesis]
|
|
254
254
|
```
|
|
255
255
|
|
|
256
256
|
**Eliminate redundancy:**
|
|
@@ -536,7 +536,7 @@ Follow the TDD cycle:
|
|
|
536
536
|
|
|
537
537
|
### RED: Write Failing Test (Baseline)
|
|
538
538
|
|
|
539
|
-
Run pressure scenario with
|
|
539
|
+
Run pressure scenario with Task agent WITHOUT the skill. Document exact behavior:
|
|
540
540
|
- What choices did they make?
|
|
541
541
|
- What rationalizations did they use (verbatim)?
|
|
542
542
|
- Which pressures triggered violations?
|