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.
- package/.ai-team/agents/architect.md +144 -0
- package/.ai-team/agents/ci-analyst.md +188 -0
- package/.ai-team/agents/developer.md +176 -0
- package/.ai-team/agents/planner.md +355 -0
- package/.ai-team/agents/qa.md +189 -0
- package/.ai-team/agents/reviewer.md +211 -0
- package/.ai-team/agents/triage.md +146 -0
- package/.ai-team/commands/ci-analyze.md +116 -0
- package/.ai-team/commands/design.md +100 -0
- package/.ai-team/commands/implement.md +108 -0
- package/.ai-team/commands/release-check.md +142 -0
- package/.ai-team/commands/review.md +142 -0
- package/.ai-team/commands/test.md +115 -0
- package/.ai-team/commands/triage.md +138 -0
- package/.ai-team/memory/architect/architecture_notes.md +67 -0
- package/.ai-team/memory/architect/design_rationale.md +113 -0
- package/.ai-team/memory/architect/module_map.md +84 -0
- package/.ai-team/memory/ci-analyst/failure_patterns.md +102 -0
- package/.ai-team/memory/ci-analyst/runbook_references.md +87 -0
- package/.ai-team/memory/developer/bug_investigation.md +102 -0
- package/.ai-team/memory/developer/build_issues.md +115 -0
- package/.ai-team/memory/developer/implementation_notes.md +83 -0
- package/.ai-team/memory/failures/failure_library.md +103 -0
- package/.ai-team/memory/planner/decomposition_notes.md +82 -0
- package/.ai-team/memory/planner/flow_rules.md +86 -0
- package/.ai-team/memory/planner/github_issue_patterns.md +229 -0
- package/.ai-team/memory/qa/regression_cases.md +101 -0
- package/.ai-team/memory/qa/test_strategy.md +138 -0
- package/.ai-team/memory/qa/validation_notes.md +110 -0
- package/.ai-team/memory/reviewer/quality_rules.md +105 -0
- package/.ai-team/memory/reviewer/recurring_risks.md +109 -0
- package/.ai-team/memory/reviewer/review_notes.md +124 -0
- package/.ai-team/memory/triage/classification_heuristics.md +82 -0
- package/.ai-team/memory/triage/debug_notes.md +87 -0
- package/.ai-team/opencode.template.jsonc +216 -0
- package/.ai-team/skills/bugfix-playbook/skill.md +174 -0
- package/.ai-team/skills/ci-failure-analysis/skill.md +176 -0
- package/.ai-team/skills/issue-triage/skill.md +163 -0
- package/.ai-team/skills/regression-checklist/skill.md +176 -0
- package/.ai-team/skills/release-readiness-check/skill.md +216 -0
- package/.ai-team/skills/repo-architecture-reader/skill.md +139 -0
- package/.ai-team/skills/safe-refactor-checklist/skill.md +215 -0
- package/.ai-team/skills/task-breakdown-and-dispatch/skill.md +151 -0
- package/.ai-team/skills/test-first-feature-dev/skill.md +205 -0
- package/.ai-team/workflows/ci.yml +81 -0
- package/.ai-team/workflows/nightly-ai-maintenance.yml +129 -0
- package/.ai-team/workflows/opencode.yml +33 -0
- package/.ai-team/workflows/pr-check.yml +41 -0
- package/.foundation/foundation.lock +38 -0
- package/.foundation/local-overrides.md +97 -0
- package/.foundation/upgrade-history.md +38 -0
- package/.opencode/agents/architect.md +38 -0
- package/.opencode/agents/ci-analyst.md +38 -0
- package/.opencode/agents/developer.md +43 -0
- package/.opencode/agents/planner.md +47 -0
- package/.opencode/agents/qa.md +34 -0
- package/.opencode/agents/reviewer.md +38 -0
- package/.opencode/agents/triage.md +37 -0
- package/.opencode/commands/auto.md +264 -0
- package/.opencode/commands/breakdown-issue.md +94 -0
- package/.opencode/commands/ci-analyze.md +15 -0
- package/.opencode/commands/close-parent-task.md +122 -0
- package/.opencode/commands/design.md +15 -0
- package/.opencode/commands/dispatch-next.md +102 -0
- package/.opencode/commands/implement.md +16 -0
- package/.opencode/commands/release-check.md +16 -0
- package/.opencode/commands/resume.md +88 -0
- package/.opencode/commands/review.md +15 -0
- package/.opencode/commands/show-blockers.md +97 -0
- package/.opencode/commands/summarize-parent.md +121 -0
- package/.opencode/commands/test.md +15 -0
- package/.opencode/commands/triage.md +109 -0
- package/.opencode/skills/bugfix-playbook/SKILL.md +81 -0
- package/.opencode/skills/ci-failure-analysis/SKILL.md +94 -0
- package/.opencode/skills/issue-triage/SKILL.md +80 -0
- package/.opencode/skills/regression-checklist/SKILL.md +81 -0
- package/.opencode/skills/release-readiness-check/SKILL.md +81 -0
- package/.opencode/skills/repo-architecture-reader/SKILL.md +65 -0
- package/.opencode/skills/safe-refactor-checklist/SKILL.md +76 -0
- package/.opencode/skills/task-breakdown-and-dispatch/SKILL.md +255 -0
- package/.opencode/skills/test-first-feature-dev/SKILL.md +78 -0
- package/AGENTS.md +879 -0
- package/CHANGELOG.md +261 -0
- package/LICENSE +21 -0
- package/README.md +1215 -0
- package/VERSION +1 -0
- package/action/__tests__/downloader.test.js +251 -0
- package/action/__tests__/merger.test.js +156 -0
- package/action/__tests__/path-resolver.test.js +199 -0
- package/action/__tests__/validator.test.js +310 -0
- package/action/action.yml +61 -0
- package/action/index.js +223 -0
- package/action/lib/downloader.js +344 -0
- package/action/lib/merger.js +170 -0
- package/action/lib/path-resolver.js +176 -0
- package/action/lib/setup.js +286 -0
- package/action/lib/validator.js +324 -0
- package/cli/__tests__/cli.test.js +270 -0
- package/cli/amazingteam.cjs +225 -0
- package/cli/commands/check-update.cjs +159 -0
- package/cli/commands/init.cjs +412 -0
- package/cli/commands/local.cjs +264 -0
- package/cli/commands/migrate.cjs +316 -0
- package/cli/commands/status.cjs +241 -0
- package/cli/commands/upgrade.cjs +213 -0
- package/cli/commands/validate.cjs +259 -0
- package/cli/commands/version.cjs +59 -0
- package/cli/sync.cjs +237 -0
- package/dist/index.js +35 -0
- package/docs/architecture/overview.md +138 -0
- package/docs/blocker_resolution_design.md +372 -0
- package/docs/bootstrap-model.md +356 -0
- package/docs/config-reference.md +458 -0
- package/docs/how-to-use.md +178 -0
- package/docs/migration-to-v3.md +355 -0
- package/docs/overlay-guide.md +156 -0
- package/docs/patterns/README.md +67 -0
- package/docs/quick-start-v3.md +330 -0
- package/docs/releases/README.md +64 -0
- package/docs/runbooks/ci/README.md +62 -0
- package/docs/runbooks/ci/build-debug.md +120 -0
- package/docs/runbooks/ci/flaky-tests.md +127 -0
- package/docs/runbooks/getting-started.md +81 -0
- package/docs/upgrade-policy.md +188 -0
- package/docs/versioning.md +199 -0
- package/overlays/README.md +30 -0
- package/overlays/ai-agent-product/.ai-team/skills/llm-integration/skill.md +99 -0
- package/overlays/ai-agent-product/docs/ai-agent-architecture.md +68 -0
- package/overlays/ai-agent-product/overlay.yaml +26 -0
- package/overlays/cpp-qt-desktop/.ai-team/skills/qt-signals-slots/skill.md +60 -0
- package/overlays/cpp-qt-desktop/docs/qt-conventions.md +64 -0
- package/overlays/cpp-qt-desktop/overlay.yaml +22 -0
- package/overlays/python-backend/.ai-team/skills/python-testing/skill.md +90 -0
- package/overlays/python-backend/docs/python-style.md +78 -0
- package/overlays/python-backend/overlay.yaml +22 -0
- package/overlays/web-fullstack/.ai-team/skills/frontend-testing/skill.md +70 -0
- package/overlays/web-fullstack/docs/frontend-conventions.md +68 -0
- package/overlays/web-fullstack/overlay.yaml +26 -0
- package/package.json +84 -0
- package/presets/default.yaml +161 -0
- package/presets/go.yaml +43 -0
- package/presets/python.yaml +43 -0
- package/presets/typescript.yaml +40 -0
- package/schemas/config.schema.json +239 -0
- package/scripts/diff_foundation_vs_project.sh +134 -0
- package/scripts/generate_docs.sh +200 -0
- package/scripts/init_project.sh +455 -0
- package/scripts/plan_upgrade.sh +268 -0
- package/scripts/upgrade_foundation.sh +365 -0
- package/scripts/validate-foundation.cjs +278 -0
- package/scripts/validate_foundation.sh +192 -0
- package/scripts/validate_project_setup.sh +171 -0
- package/tasks/README.md +94 -0
- package/tasks/_template/analysis.md +76 -0
- package/tasks/_template/design.md +121 -0
- package/tasks/_template/implementation.md +121 -0
- package/tasks/_template/release.md +119 -0
- package/tasks/_template/review.md +131 -0
- package/tasks/_template/subtasks/task.yaml +24 -0
- package/tasks/_template/task.yaml +75 -0
- package/tasks/_template/validation.md +128 -0
- package/templates/amazingteam.yml +81 -0
- package/templates/gitignore +14 -0
- 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
|
+
```
|