amazingteam 3.0.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.
Files changed (164) hide show
  1. package/.ai-team/agents/architect.md +144 -0
  2. package/.ai-team/agents/ci-analyst.md +188 -0
  3. package/.ai-team/agents/developer.md +176 -0
  4. package/.ai-team/agents/planner.md +355 -0
  5. package/.ai-team/agents/qa.md +189 -0
  6. package/.ai-team/agents/reviewer.md +211 -0
  7. package/.ai-team/agents/triage.md +146 -0
  8. package/.ai-team/commands/ci-analyze.md +116 -0
  9. package/.ai-team/commands/design.md +100 -0
  10. package/.ai-team/commands/implement.md +108 -0
  11. package/.ai-team/commands/release-check.md +142 -0
  12. package/.ai-team/commands/review.md +142 -0
  13. package/.ai-team/commands/test.md +115 -0
  14. package/.ai-team/commands/triage.md +138 -0
  15. package/.ai-team/memory/architect/architecture_notes.md +67 -0
  16. package/.ai-team/memory/architect/design_rationale.md +113 -0
  17. package/.ai-team/memory/architect/module_map.md +84 -0
  18. package/.ai-team/memory/ci-analyst/failure_patterns.md +102 -0
  19. package/.ai-team/memory/ci-analyst/runbook_references.md +87 -0
  20. package/.ai-team/memory/developer/bug_investigation.md +102 -0
  21. package/.ai-team/memory/developer/build_issues.md +115 -0
  22. package/.ai-team/memory/developer/implementation_notes.md +83 -0
  23. package/.ai-team/memory/failures/failure_library.md +103 -0
  24. package/.ai-team/memory/planner/decomposition_notes.md +82 -0
  25. package/.ai-team/memory/planner/flow_rules.md +86 -0
  26. package/.ai-team/memory/planner/github_issue_patterns.md +229 -0
  27. package/.ai-team/memory/qa/regression_cases.md +101 -0
  28. package/.ai-team/memory/qa/test_strategy.md +138 -0
  29. package/.ai-team/memory/qa/validation_notes.md +110 -0
  30. package/.ai-team/memory/reviewer/quality_rules.md +105 -0
  31. package/.ai-team/memory/reviewer/recurring_risks.md +109 -0
  32. package/.ai-team/memory/reviewer/review_notes.md +124 -0
  33. package/.ai-team/memory/triage/classification_heuristics.md +82 -0
  34. package/.ai-team/memory/triage/debug_notes.md +87 -0
  35. package/.ai-team/opencode.template.jsonc +216 -0
  36. package/.ai-team/skills/bugfix-playbook/skill.md +174 -0
  37. package/.ai-team/skills/ci-failure-analysis/skill.md +176 -0
  38. package/.ai-team/skills/issue-triage/skill.md +163 -0
  39. package/.ai-team/skills/regression-checklist/skill.md +176 -0
  40. package/.ai-team/skills/release-readiness-check/skill.md +216 -0
  41. package/.ai-team/skills/repo-architecture-reader/skill.md +139 -0
  42. package/.ai-team/skills/safe-refactor-checklist/skill.md +215 -0
  43. package/.ai-team/skills/task-breakdown-and-dispatch/skill.md +151 -0
  44. package/.ai-team/skills/test-first-feature-dev/skill.md +205 -0
  45. package/.ai-team/workflows/ci.yml +81 -0
  46. package/.ai-team/workflows/nightly-ai-maintenance.yml +129 -0
  47. package/.ai-team/workflows/opencode.yml +33 -0
  48. package/.ai-team/workflows/pr-check.yml +41 -0
  49. package/.foundation/foundation.lock +38 -0
  50. package/.foundation/local-overrides.md +97 -0
  51. package/.foundation/upgrade-history.md +38 -0
  52. package/.opencode/agents/architect.md +38 -0
  53. package/.opencode/agents/ci-analyst.md +38 -0
  54. package/.opencode/agents/developer.md +43 -0
  55. package/.opencode/agents/planner.md +47 -0
  56. package/.opencode/agents/qa.md +34 -0
  57. package/.opencode/agents/reviewer.md +38 -0
  58. package/.opencode/agents/triage.md +37 -0
  59. package/.opencode/commands/auto.md +264 -0
  60. package/.opencode/commands/breakdown-issue.md +94 -0
  61. package/.opencode/commands/ci-analyze.md +15 -0
  62. package/.opencode/commands/close-parent-task.md +122 -0
  63. package/.opencode/commands/design.md +15 -0
  64. package/.opencode/commands/dispatch-next.md +102 -0
  65. package/.opencode/commands/implement.md +16 -0
  66. package/.opencode/commands/release-check.md +16 -0
  67. package/.opencode/commands/resume.md +88 -0
  68. package/.opencode/commands/review.md +15 -0
  69. package/.opencode/commands/show-blockers.md +97 -0
  70. package/.opencode/commands/summarize-parent.md +121 -0
  71. package/.opencode/commands/test.md +15 -0
  72. package/.opencode/commands/triage.md +109 -0
  73. package/.opencode/skills/bugfix-playbook/SKILL.md +81 -0
  74. package/.opencode/skills/ci-failure-analysis/SKILL.md +94 -0
  75. package/.opencode/skills/issue-triage/SKILL.md +80 -0
  76. package/.opencode/skills/regression-checklist/SKILL.md +81 -0
  77. package/.opencode/skills/release-readiness-check/SKILL.md +81 -0
  78. package/.opencode/skills/repo-architecture-reader/SKILL.md +65 -0
  79. package/.opencode/skills/safe-refactor-checklist/SKILL.md +76 -0
  80. package/.opencode/skills/task-breakdown-and-dispatch/SKILL.md +255 -0
  81. package/.opencode/skills/test-first-feature-dev/SKILL.md +78 -0
  82. package/AGENTS.md +879 -0
  83. package/CHANGELOG.md +261 -0
  84. package/LICENSE +21 -0
  85. package/README.md +1215 -0
  86. package/VERSION +1 -0
  87. package/action/__tests__/downloader.test.js +251 -0
  88. package/action/__tests__/merger.test.js +156 -0
  89. package/action/__tests__/path-resolver.test.js +199 -0
  90. package/action/__tests__/validator.test.js +310 -0
  91. package/action/action.yml +61 -0
  92. package/action/index.js +223 -0
  93. package/action/lib/downloader.js +344 -0
  94. package/action/lib/merger.js +170 -0
  95. package/action/lib/path-resolver.js +176 -0
  96. package/action/lib/setup.js +286 -0
  97. package/action/lib/validator.js +324 -0
  98. package/cli/__tests__/cli.test.js +270 -0
  99. package/cli/amazingteam.cjs +225 -0
  100. package/cli/commands/check-update.cjs +159 -0
  101. package/cli/commands/init.cjs +412 -0
  102. package/cli/commands/local.cjs +264 -0
  103. package/cli/commands/migrate.cjs +316 -0
  104. package/cli/commands/status.cjs +241 -0
  105. package/cli/commands/upgrade.cjs +213 -0
  106. package/cli/commands/validate.cjs +259 -0
  107. package/cli/commands/version.cjs +59 -0
  108. package/cli/sync.cjs +237 -0
  109. package/dist/index.js +35 -0
  110. package/docs/architecture/overview.md +138 -0
  111. package/docs/blocker_resolution_design.md +372 -0
  112. package/docs/bootstrap-model.md +356 -0
  113. package/docs/config-reference.md +458 -0
  114. package/docs/how-to-use.md +178 -0
  115. package/docs/migration-to-v3.md +355 -0
  116. package/docs/overlay-guide.md +156 -0
  117. package/docs/patterns/README.md +67 -0
  118. package/docs/quick-start-v3.md +330 -0
  119. package/docs/releases/README.md +64 -0
  120. package/docs/runbooks/ci/README.md +62 -0
  121. package/docs/runbooks/ci/build-debug.md +120 -0
  122. package/docs/runbooks/ci/flaky-tests.md +127 -0
  123. package/docs/runbooks/getting-started.md +81 -0
  124. package/docs/upgrade-policy.md +188 -0
  125. package/docs/versioning.md +199 -0
  126. package/overlays/README.md +30 -0
  127. package/overlays/ai-agent-product/.ai-team/skills/llm-integration/skill.md +99 -0
  128. package/overlays/ai-agent-product/docs/ai-agent-architecture.md +68 -0
  129. package/overlays/ai-agent-product/overlay.yaml +26 -0
  130. package/overlays/cpp-qt-desktop/.ai-team/skills/qt-signals-slots/skill.md +60 -0
  131. package/overlays/cpp-qt-desktop/docs/qt-conventions.md +64 -0
  132. package/overlays/cpp-qt-desktop/overlay.yaml +22 -0
  133. package/overlays/python-backend/.ai-team/skills/python-testing/skill.md +90 -0
  134. package/overlays/python-backend/docs/python-style.md +78 -0
  135. package/overlays/python-backend/overlay.yaml +22 -0
  136. package/overlays/web-fullstack/.ai-team/skills/frontend-testing/skill.md +70 -0
  137. package/overlays/web-fullstack/docs/frontend-conventions.md +68 -0
  138. package/overlays/web-fullstack/overlay.yaml +26 -0
  139. package/package.json +84 -0
  140. package/presets/default.yaml +161 -0
  141. package/presets/go.yaml +43 -0
  142. package/presets/python.yaml +43 -0
  143. package/presets/typescript.yaml +40 -0
  144. package/schemas/config.schema.json +239 -0
  145. package/scripts/diff_foundation_vs_project.sh +134 -0
  146. package/scripts/generate_docs.sh +200 -0
  147. package/scripts/init_project.sh +455 -0
  148. package/scripts/plan_upgrade.sh +268 -0
  149. package/scripts/upgrade_foundation.sh +365 -0
  150. package/scripts/validate-foundation.cjs +278 -0
  151. package/scripts/validate_foundation.sh +192 -0
  152. package/scripts/validate_project_setup.sh +171 -0
  153. package/tasks/README.md +94 -0
  154. package/tasks/_template/analysis.md +76 -0
  155. package/tasks/_template/design.md +121 -0
  156. package/tasks/_template/implementation.md +121 -0
  157. package/tasks/_template/release.md +119 -0
  158. package/tasks/_template/review.md +131 -0
  159. package/tasks/_template/subtasks/task.yaml +24 -0
  160. package/tasks/_template/task.yaml +75 -0
  161. package/tasks/_template/validation.md +128 -0
  162. package/templates/amazingteam.yml +81 -0
  163. package/templates/gitignore +14 -0
  164. package/templates/opencode.jsonc +216 -0
@@ -0,0 +1,88 @@
1
+ ---
2
+ description: Resume a blocked workflow after blocker resolution
3
+ agent: planner
4
+ ---
5
+ Resume a previously blocked workflow after the blocker has been resolved.
6
+
7
+ ## Usage
8
+
9
+ Comment on the blocked issue:
10
+
11
+ ```
12
+ /oc /resume
13
+ ```
14
+
15
+ Or with additional context:
16
+
17
+ ```
18
+ /oc /resume
19
+ The permission issue has been fixed. Please continue from where you left off.
20
+ ```
21
+
22
+ ## When to Use
23
+
24
+ Use `/resume` when:
25
+ - A blocker sub-issue has been resolved
26
+ - Human has provided required input/approval
27
+ - External dependency is now available
28
+ - Permission/access has been granted
29
+
30
+ ## Process
31
+
32
+ 1. **Verify Blocker Resolution**
33
+ - Check blocker sub-issue status
34
+ - Verify fix was applied
35
+ - Confirm dependencies are available
36
+
37
+ 2. **Restore Workflow State**
38
+ - Load saved workflow state
39
+ - Identify last successful step
40
+ - Prepare to continue
41
+
42
+ 3. **Resume Execution**
43
+ - Continue from where workflow paused
44
+ - Execute remaining steps
45
+ - Create PR when complete
46
+
47
+ ## Output
48
+
49
+ ```markdown
50
+ ## Workflow Resumed
51
+
52
+ - **Original Issue**: #{issue_id}
53
+ - **Blocker**: #{blocker_id} - ✅ Resolved
54
+ - **Resuming From**: {phase}
55
+ - **Status**: In progress...
56
+
57
+ Continuing with {next_step}...
58
+ ```
59
+
60
+ ## If Blocker Not Resolved
61
+
62
+ ```markdown
63
+ ## Cannot Resume
64
+
65
+ - **Blocker**: #{blocker_id} - ❌ Not resolved
66
+ - **Status**: {blocker_status}
67
+
68
+ ### Required Actions
69
+ {list of required actions to resolve blocker}
70
+
71
+ Please resolve the blocker first, then run `/resume` again.
72
+ ```
73
+
74
+ ## Example
75
+
76
+ ```
77
+ User: /oc /resume
78
+ Branch protection has been disabled temporarily.
79
+
80
+ Planner:
81
+ ## Workflow Resumed
82
+
83
+ - **Original Issue**: #120
84
+ - **Blocker**: #206 (Permission denied) - ✅ Resolved
85
+ - **Resuming From**: Implementation phase
86
+
87
+ Continuing with implementation...
88
+ ```
@@ -0,0 +1,15 @@
1
+ ---
2
+ description: Review code for quality and correctness
3
+ agent: reviewer
4
+ ---
5
+ Review the code changes for quality, correctness, and maintainability.
6
+
7
+ ## Steps
8
+
9
+ 1. Review the pull request changes
10
+ 2. Check coding standards compliance
11
+ 3. Identify potential issues
12
+ 4. Provide constructive feedback
13
+ 5. Document review results in `tasks/{task_id}/review.md`
14
+
15
+ Use the `safe-refactor-checklist` skill for thorough review.
@@ -0,0 +1,97 @@
1
+ ---
2
+ description: List all blocked subtasks and required actions to unblock them
3
+ agent: planner
4
+ ---
5
+ Show all blocked subtasks and what is needed to unblock them.
6
+
7
+ ## Steps
8
+
9
+ ### 1. Scan Task Directory
10
+
11
+ List all tasks and subtasks:
12
+ ```
13
+ tasks/
14
+ ├── issue-{N}/
15
+ ├── issue-{N}-subtask-01/
16
+ ├── issue-{N}-subtask-02/
17
+ ...
18
+ ```
19
+
20
+ ### 2. Check for Blocked Status
21
+
22
+ For each task/subtask, check `task.yaml`:
23
+ - status: blocked
24
+ - blocked_by field
25
+ - depends_on field
26
+
27
+ ### 3. Analyze Blocker Types
28
+
29
+ Common blocker types:
30
+ - `missing_design_decision` - Design not complete
31
+ - `failing_dependency` - Dependency task not done
32
+ - `ci_failure` - CI failing on related PR
33
+ - `unclear_requirements` - Issue needs clarification
34
+ - `missing_approval` - Waiting for human approval
35
+ - `external_dependency` - Waiting for external artifact
36
+
37
+ ### 4. Check GitHub Status
38
+
39
+ ```bash
40
+ gh issue view {issue-number}
41
+ gh pr list --state open --search "fixes #{issue-number}"
42
+ ```
43
+
44
+ ### 5. Determine Unblock Actions
45
+
46
+ For each blocked item, identify:
47
+ - What is blocking
48
+ - What must happen to unblock
49
+ - Who should act
50
+ - Recommended next command
51
+
52
+ ## Output Format
53
+
54
+ ```
55
+ Blocked Subtasks Report
56
+ ========================
57
+
58
+ Parent Task: issue-{N}
59
+
60
+ ┌─────────────────────────────────────────────────────────────┐
61
+ │ Blocked: issue-{N}-subtask-02 │
62
+ ├─────────────────────────────────────────────────────────────┤
63
+ │ Title: [Subtask] Implement feature │
64
+ │ GitHub: #202 │
65
+ │ Owner: developer │
66
+ │ │
67
+ │ Blocker Type: failing_dependency │
68
+ │ Blocker Source: issue-{N}-subtask-01 (design pending) │
69
+ │ │
70
+ │ Required Action: Complete design phase │
71
+ │ Recommended Next: Dispatch to architect │
72
+ │ Command: /design --subtask issue-{N}-subtask-01 │
73
+ └─────────────────────────────────────────────────────────────┘
74
+
75
+ ┌─────────────────────────────────────────────────────────────┐
76
+ │ Blocked: issue-{M}-subtask-03 │
77
+ ├─────────────────────────────────────────────────────────────┤
78
+ │ Title: [Subtask] Add tests │
79
+ │ GitHub: #305 │
80
+ │ Owner: qa │
81
+ │ │
82
+ │ Blocker Type: ci_failure │
83
+ │ Blocker Source: PR #304 failing │
84
+ │ │
85
+ │ Required Action: Fix CI failure │
86
+ │ Recommended Next: Dispatch to ci-analyst │
87
+ │ Command: /ci-analyze --pr 304 │
88
+ └─────────────────────────────────────────────────────────────┘
89
+
90
+ Summary:
91
+ - 2 blocked subtasks
92
+ - 1 requires architecture work
93
+ - 1 requires CI fix
94
+
95
+ Next Recommended Action:
96
+ Dispatch to ci-analyst for immediate CI fix (blocking implementation)
97
+ ```
@@ -0,0 +1,121 @@
1
+ ---
2
+ description: Summarize current progress of all child issues under a parent issue
3
+ agent: planner
4
+ ---
5
+ Summarize the progress of all child issues under a parent issue.
6
+
7
+ ## Steps
8
+
9
+ ### 1. Identify Parent Issue
10
+
11
+ Parse the issue reference or read from `tasks/issue-{N}/task.yaml`
12
+
13
+ ### 2. List All Child Issues
14
+
15
+ From parent task.yaml:
16
+ ```yaml
17
+ subtasks:
18
+ - id: issue-{N}-subtask-01
19
+ github_issue: 201
20
+ - id: issue-{N}-subtask-02
21
+ github_issue: 202
22
+ ...
23
+ ```
24
+
25
+ ### 3. Check GitHub Status
26
+
27
+ For each child issue:
28
+ ```bash
29
+ gh issue view {issue-number} --json number,title,state,labels
30
+ ```
31
+
32
+ ### 4. Check Linked PRs
33
+
34
+ ```bash
35
+ gh pr list --state all --search "fixes #{issue-number}"
36
+ ```
37
+
38
+ ### 5. Calculate Progress
39
+
40
+ - Count: total, done, in_progress, pending, blocked
41
+ - Calculate completion percentage
42
+ - Identify critical path items
43
+
44
+ ### 6. Identify Risks
45
+
46
+ - Long-running blocked items
47
+ - Dependencies not progressing
48
+ - Missing assignments
49
+
50
+ ## Output Format
51
+
52
+ ```
53
+ Parent Issue Summary
54
+ ====================
55
+
56
+ Parent: issue-{N} - {title}
57
+ GitHub: #{issue-number}
58
+ Status: in_implementation
59
+ Priority: high
60
+
61
+ Progress Overview
62
+ -----------------
63
+ Total Subtasks: 5
64
+ ✓ Done: 2 (40%)
65
+ ● In Progress: 1 (20%)
66
+ ○ Pending: 1 (20%)
67
+ ✗ Blocked: 1 (20%)
68
+
69
+ Completion: 40%
70
+
71
+ Subtask Details
72
+ ---------------
73
+
74
+ ✓ #201 [Subtask] Design API
75
+ Role: architect | Status: done
76
+ PR: #250 (merged)
77
+ Completed: 2024-01-15
78
+
79
+ ✓ #202 [Subtask] Implement core
80
+ Role: developer | Status: done
81
+ PR: #251 (merged)
82
+ Completed: 2024-01-18
83
+
84
+ ● #203 [Subtask] Add tests
85
+ Role: qa | Status: in_validation
86
+ PR: #252 (open)
87
+ Started: 2024-01-19
88
+
89
+ ○ #204 [Subtask] Update docs
90
+ Role: developer | Status: pending
91
+ Depends on: #203
92
+ ETA: after #203
93
+
94
+ ✗ #205 [Subtask] Integration test
95
+ Role: qa | Status: blocked
96
+ Blocker: CI failure in #203
97
+ Blocked since: 2024-01-20
98
+
99
+ Dependency Graph
100
+ ----------------
101
+ #201 (done) → #202 (done) → #203 (in_progress) → #204 (pending)
102
+
103
+ #205 (blocked)
104
+
105
+ Critical Path
106
+ -------------
107
+ Current: #203 (validation)
108
+ Next: #204 (docs), #205 (integration)
109
+
110
+ Risks
111
+ -----
112
+ - #205 blocked for 2 days (CI failure)
113
+ - #204 waiting on #203
114
+
115
+ Recommendations
116
+ ---------------
117
+ 1. Resolve CI failure in #203 to unblock #205
118
+ 2. Consider parallelizing #204 after #203 validation passes
119
+
120
+ Next Action: /dispatch-next
121
+ ```
@@ -0,0 +1,15 @@
1
+ ---
2
+ description: Validate implementation through testing
3
+ agent: qa
4
+ ---
5
+ Validate the implementation and ensure quality.
6
+
7
+ ## Steps
8
+
9
+ 1. Review acceptance criteria
10
+ 2. Verify all tests pass
11
+ 3. Test edge cases
12
+ 4. Check for regressions
13
+ 5. Document validation results in `tasks/{task_id}/validation.md`
14
+
15
+ Use the `regression-checklist` skill for thorough validation.
@@ -0,0 +1,109 @@
1
+ ---
2
+ description: Classify issue, determine decomposition need, and perform initial analysis
3
+ agent: triage
4
+ ---
5
+ Classify this issue, determine whether decomposition is needed, and perform initial analysis.
6
+
7
+ ## Steps
8
+
9
+ ### 1. Read Issue Description
10
+
11
+ Understand:
12
+ - What is being reported or requested?
13
+ - What is the expected behavior?
14
+ - What is the actual behavior (for bugs)?
15
+ - What is the business goal (for features)?
16
+
17
+ ### 2. Classify by Type
18
+
19
+ | Type | Indicators |
20
+ |------|------------|
21
+ | bug | Error, crash, incorrect behavior |
22
+ | feature | New functionality, enhancement |
23
+ | tech-task | Refactoring, dependency update, infrastructure |
24
+ | docs | Documentation changes |
25
+
26
+ ### 3. Assess Priority and Severity
27
+
28
+ **Severity (bugs):**
29
+ - critical: System down, data loss, security issue
30
+ - high: Major feature broken, no workaround
31
+ - medium: Feature partially broken, workaround exists
32
+ - low: Minor issue, cosmetic
33
+
34
+ **Priority:**
35
+ - critical: Immediate action required
36
+ - high: This sprint
37
+ - medium: Next sprint
38
+ - low: Backlog
39
+
40
+ ### 4. Determine Decomposition Need
41
+
42
+ **Decomposition Required if:**
43
+ - Touches multiple modules
44
+ - Requires design before implementation
45
+ - Impacts public interfaces
46
+ - Changes data model, API contract, or protocol
47
+ - Likely needs multiple PRs
48
+ - Contains several distinct implementation steps
49
+ - Requires staged validation
50
+
51
+ **No Decomposition if:**
52
+ - Single module change
53
+ - No architecture decision needed
54
+ - One implementation step sufficient
55
+ - One PR likely enough
56
+ - Simple validation
57
+
58
+ ### 5. Perform Initial Investigation
59
+
60
+ - Check if similar issues exist
61
+ - Identify affected files/modules
62
+ - Note relevant code paths
63
+ - Check for related PRs
64
+
65
+ ### 6. Suggest Next Steps
66
+
67
+ Based on classification and decomposition decision:
68
+
69
+ | Scenario | Next Step |
70
+ |----------|-----------|
71
+ | Bug, no decomposition | /implement |
72
+ | Bug, needs decomposition | /breakdown-issue |
73
+ | Feature, no decomposition | /design |
74
+ | Feature, needs decomposition | /breakdown-issue |
75
+ | Unclear issue | Ask for clarification |
76
+
77
+ ## Output Format
78
+
79
+ ```
80
+ Triage Report
81
+ =============
82
+
83
+ Issue: #{number} - {title}
84
+
85
+ Classification:
86
+ - Type: bug | feature | tech-task | docs
87
+ - Severity: critical | high | medium | low
88
+ - Priority: critical | high | medium | low
89
+
90
+ Scope Analysis:
91
+ - Affected modules: [list]
92
+ - Affected components: [list]
93
+ - Related issues: [list]
94
+
95
+ Decomposition Decision: required | not_required
96
+
97
+ Reason:
98
+ - [reasons for decomposition decision]
99
+
100
+ Estimated Complexity: simple | moderate | complex
101
+
102
+ Recommended Next Steps:
103
+ 1. [first action]
104
+ 2. [second action]
105
+
106
+ Command: /breakdown-issue | /design | /implement
107
+ ```
108
+
109
+ Use the `issue-triage` skill for systematic classification.
@@ -0,0 +1,81 @@
1
+ ---
2
+ name: bugfix-playbook
3
+ description: Systematic approach to identifying, analyzing, and fixing bugs
4
+ license: MIT
5
+ ---
6
+ # Bug Fix Playbook
7
+
8
+ ## When to Use
9
+
10
+ - Fixing reported bugs
11
+ - Debugging production issues
12
+ - Investigating test failures
13
+ - Resolving regression issues
14
+
15
+ ## Steps
16
+
17
+ ### 1. Reproduce the Bug
18
+ 1. Document exact reproduction steps
19
+ 2. Verify the bug exists in current version
20
+ 3. Create minimal reproduction case
21
+ 4. Capture relevant logs/errors
22
+
23
+ ### 2. Gather Information
24
+ 1. Review bug report details
25
+ 2. Check for related issues
26
+ 3. Review recent changes
27
+ 4. Collect stack traces
28
+
29
+ ### 3. Locate the Source
30
+ 1. Use stack traces to identify locations
31
+ 2. Search for error messages in codebase
32
+ 3. Trace execution flow
33
+ 4. Identify the specific file and function
34
+
35
+ ### 4. Analyze the Root Cause
36
+ 1. Understand the expected behavior
37
+ 2. Compare with actual behavior
38
+ 3. Identify why the discrepancy occurs
39
+ 4. Document the root cause clearly
40
+
41
+ ### 5. Design the Fix
42
+ 1. Determine the minimal change needed
43
+ 2. Consider potential side effects
44
+ 3. Plan any necessary refactoring
45
+
46
+ ### 6. Implement the Fix
47
+ 1. Write the fix (minimal, targeted)
48
+ 2. Add/update tests
49
+ 3. Verify fix resolves the issue
50
+ 4. Run all tests to catch regressions
51
+
52
+ ## Root Cause Analysis Template
53
+
54
+ ```markdown
55
+ ## Bug Analysis: [Bug Title]
56
+
57
+ ### Issue
58
+ [Description of the bug]
59
+
60
+ ### Root Cause
61
+ [Explanation of why the bug occurs]
62
+
63
+ ### Affected Code
64
+ - `file_path:line_number` - [Description]
65
+
66
+ ### Fix Approach
67
+ [Description of how to fix]
68
+
69
+ ### Tests to Add
70
+ 1. [Test case 1]
71
+ 2. [Test case 2]
72
+ ```
73
+
74
+ ## Checklist
75
+
76
+ - [ ] Bug reproduced
77
+ - [ ] Root cause identified
78
+ - [ ] Fix implemented (minimal change)
79
+ - [ ] Tests added for the bug
80
+ - [ ] All tests pass
81
+ - [ ] No regressions detected
@@ -0,0 +1,94 @@
1
+ ---
2
+ name: ci-failure-analysis
3
+ description: Investigate CI failures systematically and find root causes
4
+ license: MIT
5
+ ---
6
+ # CI Failure Analysis
7
+
8
+ ## When to Use
9
+
10
+ - CI pipeline failed
11
+ - Tests failing in CI but not locally
12
+ - Build errors
13
+ - Deployment failures
14
+
15
+ ## Analysis Steps
16
+
17
+ ### 1. Identify Failure Type
18
+ - **Build failure**: Compilation/transpilation error
19
+ - **Test failure**: Tests not passing
20
+ - **Lint failure**: Code style issues
21
+ - **Deploy failure**: Deployment step failed
22
+
23
+ ### 2. Gather Information
24
+ 1. Read the CI logs
25
+ 2. Identify the failing step
26
+ 3. Note the error message
27
+ 4. Check for recent changes
28
+
29
+ ### 3. Analyze Root Cause
30
+
31
+ #### Build Failures
32
+ - Missing dependencies
33
+ - Type errors
34
+ - Syntax errors
35
+ - Configuration issues
36
+
37
+ #### Test Failures
38
+ - Flaky tests
39
+ - Environment differences
40
+ - Missing test data
41
+ - Timing issues
42
+
43
+ #### Lint Failures
44
+ - New lint rules
45
+ - Code style violations
46
+ - Unused imports
47
+
48
+ ### 4. Propose Fix
49
+ 1. Identify the minimal fix
50
+ 2. Consider side effects
51
+ 3. Document the solution
52
+
53
+ ## Common CI Issues
54
+
55
+ ### Environment Differences
56
+ ```bash
57
+ # Check Node version
58
+ node --version
59
+
60
+ # Check package versions
61
+ npm list [package]
62
+ ```
63
+
64
+ ### Flaky Tests
65
+ - Look for timing issues
66
+ - Check for race conditions
67
+ - Verify test isolation
68
+
69
+ ### Memory Issues
70
+ - Increase Node memory: `NODE_OPTIONS=--max-old-space-size=4096`
71
+ - Check for memory leaks
72
+
73
+ ## Report Template
74
+
75
+ ```markdown
76
+ ## CI Failure Analysis
77
+
78
+ ### Failure Type
79
+ [Build|Test|Lint|Deploy]
80
+
81
+ ### Error Message
82
+ ```
83
+ [Paste error]
84
+ ```
85
+
86
+ ### Root Cause
87
+ [Explanation]
88
+
89
+ ### Fix
90
+ [Proposed solution]
91
+
92
+ ### Prevention
93
+ [How to prevent in future]
94
+ ```
@@ -0,0 +1,80 @@
1
+ ---
2
+ name: issue-triage
3
+ description: Classify issues by type, priority, and assign appropriate handling
4
+ license: MIT
5
+ ---
6
+ # Issue Triage
7
+
8
+ ## When to Use
9
+
10
+ - New issue created
11
+ - Bug reports received
12
+ - Feature requests submitted
13
+ - Technical debt identified
14
+
15
+ ## Classification Categories
16
+
17
+ ### Type
18
+ - **bug**: Something is broken
19
+ - **feature**: New functionality requested
20
+ - **enhancement**: Improvement to existing feature
21
+ - **tech**: Technical task (refactor, upgrade, etc.)
22
+ - **docs**: Documentation changes
23
+
24
+ ### Priority
25
+ - **critical**: Blocks production or major functionality
26
+ - **high**: Significant impact, should be addressed soon
27
+ - **medium**: Normal priority, standard timeline
28
+ - **low**: Nice to have, can wait
29
+
30
+ ### Severity (for bugs)
31
+ - **blocker**: System unusable
32
+ - **major**: Significant functionality broken
33
+ - **minor**: Small issue, workaround available
34
+ - **cosmetic**: UI/UX issue, no functional impact
35
+
36
+ ## Triage Steps
37
+
38
+ ### 1. Read the Issue
39
+ 1. Understand the reported problem/request
40
+ 2. Identify the reporter's intent
41
+ 3. Note any reproduction steps
42
+
43
+ ### 2. Classify
44
+ 1. Determine the type
45
+ 2. Assess priority
46
+ 3. Estimate severity (if bug)
47
+ 4. Identify affected components
48
+
49
+ ### 3. Validate
50
+ 1. Reproduce the issue (if bug)
51
+ 2. Verify it's not a duplicate
52
+ 3. Check for related issues
53
+
54
+ ### 4. Assign
55
+ 1. Identify the right agent
56
+ 2. Add appropriate labels
57
+ 3. Set milestone if applicable
58
+
59
+ ## Issue Template
60
+
61
+ ```markdown
62
+ ## Classification
63
+ - **Type**: [bug|feature|enhancement|tech|docs]
64
+ - **Priority**: [critical|high|medium|low]
65
+ - **Severity**: [blocker|major|minor|cosmetic]
66
+
67
+ ## Summary
68
+ [Brief description]
69
+
70
+ ## Affected Components
71
+ - [Component 1]
72
+ - [Component 2]
73
+
74
+ ## Next Steps
75
+ 1. [Action 1]
76
+ 2. [Action 2]
77
+
78
+ ## Assigned To
79
+ [Agent name]
80
+ ```