@teevee98/synapse-hub 4.1.4 → 4.2.1
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/.agents/rules/git-push-protocol.md +2 -2
- package/.agents/skills/01-web-automation/auth-session-and-cookie-manager/SKILL.md +52 -3
- package/.agents/skills/01-web-automation/bats-testing-patterns/SKILL.md +55 -5
- package/.agents/skills/01-web-automation/clean-pom-crafter/SKILL.md +62 -67
- package/.agents/skills/01-web-automation/e2e-testing-patterns/SKILL.md +54 -4
- package/.agents/skills/01-web-automation/katalon-cli-runner/SKILL.md +62 -12
- package/.agents/skills/01-web-automation/lam-script-generator/SKILL.md +55 -8
- package/.agents/skills/01-web-automation/mobile-appium-som/SKILL.md +60 -12
- package/.agents/skills/01-web-automation/mobile-appium-som/examples/BaseScreen.java +2 -2
- package/.agents/skills/01-web-automation/mobile-appium-som/examples/LoginScreen.java +2 -2
- package/.agents/skills/01-web-automation/mobile-appium-som/examples/TC_MobileLogin.java +2 -2
- package/.agents/skills/01-web-automation/playwright-live-interaction/SKILL.md +54 -91
- package/.agents/skills/01-web-automation/playwright-webapp-testing/SKILL.md +59 -11
- package/.agents/skills/01-web-automation/web-agent-gym-benchmarking/SKILL.md +50 -4
- package/.agents/skills/02-test-design/architecture-decision-records/SKILL.md +55 -9
- package/.agents/skills/02-test-design/gherkin-to-suite/SKILL.md +55 -9
- package/.agents/skills/02-test-design/rbt-manual-testing/SKILL.md +55 -8
- package/.agents/skills/02-test-design/review-spec/SKILL.md +50 -6
- package/.agents/skills/02-test-design/tot-exploratory-testing/SKILL.md +50 -4
- package/.agents/skills/03-api-and-contracts/api-network-mocking-interception/SKILL.md +56 -5
- package/.agents/skills/03-api-and-contracts/api-spec-to-e2e-matrix/SKILL.md +53 -7
- package/.agents/skills/03-api-and-contracts/consumer-driven-contract-testing/SKILL.md +86 -36
- package/.agents/skills/04-performance-and-load/backend-load-and-stress-patterns/SKILL.md +54 -6
- package/.agents/skills/04-performance-and-load/lean-impact-scoreboard/SKILL.md +50 -6
- package/.agents/skills/04-performance-and-load/web-vitals-and-performance-profiler/SKILL.md +50 -3
- package/.agents/skills/05-security-and-compliance/security-dast-sentinel/SKILL.md +63 -14
- package/.agents/skills/05-security-and-compliance/skillspector-security-guard/SKILL.md +51 -5
- package/.agents/skills/05-security-and-compliance/wcag-audit-patterns/SKILL.md +54 -4
- package/.agents/skills/06-healing-and-resilience/agentless-qa-repair/SKILL.md +51 -5
- package/.agents/skills/06-healing-and-resilience/antigravity-test-sentinel/SKILL.md +53 -6
- package/.agents/skills/06-healing-and-resilience/failure-autopsy-and-healing/SKILL.md +54 -8
- package/.agents/skills/06-healing-and-resilience/flaky-test-sentinel-and-quarantine/SKILL.md +60 -24
- package/.agents/skills/06-healing-and-resilience/self-healing-locator/SKILL.md +52 -6
- package/.agents/skills/06-healing-and-resilience/systematic-debugging/SKILL.md +56 -10
- package/.agents/skills/06-healing-and-resilience/test-driven-development/SKILL.md +58 -12
- package/.agents/skills/06-healing-and-resilience/verification-before-completion/SKILL.md +58 -12
- package/.agents/skills/06-healing-and-resilience/visual-regression-sentinel/SKILL.md +53 -5
- package/.agents/skills/07-data-and-state/db-state-verifier-and-seeder/SKILL.md +56 -5
- package/.agents/skills/07-data-and-state/file-and-report-validator/SKILL.md +53 -4
- package/.agents/skills/07-data-and-state/synthetic-test-data-generator/SKILL.md +58 -5
- package/.agents/skills/08-code-quality/code-refactoring-refactor-clean/SKILL.md +57 -11
- package/.agents/skills/08-code-quality/graphify-impact-analyzer/SKILL.md +83 -34
- package/.agents/skills/08-code-quality/graphify-impact-analyzer/examples/dependency_blast_radius.json +3 -4
- package/.agents/skills/08-code-quality/lean-code-ladder/SKILL.md +55 -10
- package/.agents/skills/08-code-quality/repo-quality-audit/SKILL.md +49 -6
- package/.agents/skills/08-code-quality/senior-code-review/SKILL.md +52 -7
- package/.agents/skills/08-code-quality/surgical-coding-principles/SKILL.md +55 -10
- package/.agents/skills/08-code-quality/technical-debt-harvester/SKILL.md +51 -5
- package/.agents/skills/09-ci-and-devops/github-actions-templates/SKILL.md +54 -17
- package/.agents/skills/09-ci-and-devops/github-actions-templates/examples/matrix_test_pipeline.yml +2 -1
- package/.agents/skills/10-agent-orchestration/actor-qa-swarm/SKILL.md +50 -4
- package/.agents/skills/10-agent-orchestration/agent-orchestration-multi-agent-optimize/SKILL.md +53 -7
- package/.agents/skills/10-agent-orchestration/event-stream-qa-orchestrator/SKILL.md +50 -4
- package/.agents/skills/10-agent-orchestration/persistent-planning-files/SKILL.md +58 -13
- package/.agents/skills/10-agent-orchestration/qa-memory-os/SKILL.md +51 -5
- package/.agents/skills/11-ai-and-prompting/meta-prompt-crafter/SKILL.md +57 -10
- package/.agents/skills/11-ai-and-prompting/mipro-prompt-compiler/SKILL.md +50 -4
- package/.agents/skills/11-ai-and-prompting/qa-aci-interface/SKILL.md +50 -4
- package/.agents/skills/11-ai-and-prompting/token-and-context-optimizer/SKILL.md +55 -9
- package/.cursor/rules/synapse-qa.mdc +20 -7
- package/.cursorrules +19 -5
- package/.windsurfrules +18 -3
- package/AGENTS.md +51 -59
- package/CLAUDE.md +38 -24
- package/LICENSE +5 -5
- package/NOTICE +1 -1
- package/README.en.md +4 -4
- package/README.md +4 -4
- package/agentskills.json +1 -1
- package/docs/ARCHITECTURE.en.md +2 -2
- package/docs/ARCHITECTURE.md +11 -2
- package/docs/CLIENT_SUPPORT_MATRIX.md +44 -0
- package/docs/CLI_REFERENCE.en.md +6 -4
- package/docs/CLI_REFERENCE.md +1 -1
- package/docs/CONTRIBUTING.en.md +1 -1
- package/docs/CONTRIBUTING.md +2 -2
- package/docs/SIDE_EFFECTING_TOOLS_INVENTORY.md +233 -0
- package/docs/TOOL_CATALOG.md +6 -2
- package/docs/research/agent_skill_training_analysis.md +1 -1
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/skills_manifest.json +320 -55
- package/synapse.config.json +1 -1
- package/templates/ai_bridges/CLAUDE.md +29 -26
- package/templates/ai_bridges/copilot-instructions.md +14 -5
- package/templates/ai_bridges/cursor_synapse_qa.mdc +16 -7
- package/templates/ai_bridges/windsurfrules +14 -3
- package/templates/ui/index.html +2 -2
- package/tools/TOOLS_RUNBOOK.md +1 -1
- package/tools/TOOL_CATALOG.json +63 -3
- package/tools/__init__.py +1 -1
- package/tools/api_fuzzer.py +447 -132
- package/tools/author_integrity.py +121 -11
- package/tools/benchmark_swarm_context.py +130 -22
- package/tools/break_ui_generator.py +233 -0
- package/tools/browser_helpers.js +2 -2
- package/tools/check_version_sync.py +18 -50
- package/tools/cli.py +110 -19
- package/tools/core/bm25_retriever.py +218 -0
- package/tools/core/i18n.py +5 -5
- package/tools/core/provider_usage_adapter.py +383 -0
- package/tools/core/token_estimator.py +81 -15
- package/tools/count_tokens.py +7 -2
- package/tools/coverage_reporter.py +245 -0
- package/tools/dashboard_generator.py +8 -8
- package/tools/db_sandbox.py +290 -9
- package/tools/distill_log.py +1 -1
- package/tools/distill_skill.py +206 -0
- package/tools/git_pre_commit_guard.py +202 -1
- package/tools/humanize_linter.py +3 -0
- package/tools/mcp_docx_server.py +1 -1
- package/tools/mcp_excel_server.py +1 -1
- package/tools/mcp_server.py +104 -16
- package/tools/micro_mutator.py +114 -15
- package/tools/pentest_scope_guard.py +674 -58
- package/tools/perf/benchmark_perf_runner.py +42 -0
- package/tools/project_state.py +29 -5
- package/tools/reversible_sandbox.py +58 -13
- package/tools/rules_router.py +473 -60
- package/tools/security_scanner.py +80 -0
- package/tools/senior_code_review.py +14 -0
- package/tools/skill_canonical_digest.py +302 -0
- package/tools/skill_profiles.py +77 -7
- package/tools/slide_deck_exporter.py +477 -0
- package/tools/sync_agent_rules.py +187 -61
- package/tools/sync_skills_manifest.py +166 -0
- package/tools/task_memory_manager.py +275 -0
- package/tools/ui_server.py +3 -1
- package/tools/update_sentinel.py +3 -3
- package/tools/validate_host_interop.py +485 -0
- package/tools/validate_skills_schema.py +575 -0
- package/tools/verify_all.py +668 -44
- package/tools/welcome_page.py +2 -2
|
@@ -1,15 +1,44 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: surgical-coding-principles
|
|
3
3
|
description: "Enforce four behavioral principles (Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution) when writing or modifying test automation code. Use when implementing Page Classes, editing test scripts, or changing hub tools to prevent assumption drift and over-engineering."
|
|
4
|
+
category: architecture_and_analysis
|
|
5
|
+
version: "1.0.0"
|
|
6
|
+
policies:
|
|
7
|
+
network: none
|
|
8
|
+
shell: none
|
|
9
|
+
filesystem: workspace-sandbox
|
|
4
10
|
---
|
|
5
|
-
|
|
6
11
|
# Surgical Coding Principles — Enterprise Minimal-Diff Discipline
|
|
7
12
|
|
|
13
|
+
> **Author Attribution & MIT License Guard:** Synapse Hub is open-source software created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under the MIT License.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 1. Trigger & Activation
|
|
18
|
+
|
|
19
|
+
- **Trigger Clause:** Enforce four behavioral principles (Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution) when writing or modifying test automation code. Use when implementing Page Classes, editing test scripts, or changing hub tools to prevent assumption drift and over-engineering.
|
|
20
|
+
- **Activation Scope:** Domain workflows for `08-code-quality` involving `surgical-coding-principles`.
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## 2. Non-Goals & Boundary Constraints
|
|
25
|
+
|
|
26
|
+
- **What NOT to do:**
|
|
27
|
+
- Do NOT perform broad speculative edits across unrelated files.
|
|
28
|
+
- Do NOT reformat untouched lines of code creating noisy diffs.
|
|
29
|
+
- Do NOT modify code without reading the target file and verifying callers first.
|
|
30
|
+
- **Sibling Skill Boundaries:**
|
|
31
|
+
- lean-code-ladder decides what to build; surgical-coding-principles restricts where and how to modify existing files.
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 3. Ordered Execution Workflow
|
|
36
|
+
|
|
8
37
|
Specialized skill for reducing the three classic LLM coding failure modes — silent assumptions, over-engineering, and out-of-scope edits — across Page Classes, test scripts, and `tools/*.py` maintenance.
|
|
9
38
|
|
|
10
39
|
---
|
|
11
40
|
|
|
12
|
-
|
|
41
|
+
### The Four Principles
|
|
13
42
|
|
|
14
43
|
```mermaid
|
|
15
44
|
flowchart LR
|
|
@@ -20,7 +49,7 @@ flowchart LR
|
|
|
20
49
|
|
|
21
50
|
**Tradeoff:** these principles bias toward caution over speed. For trivial, single-line fixes, apply judgment and do not ritualize.
|
|
22
51
|
|
|
23
|
-
|
|
52
|
+
### Principle 1: Think Before Coding
|
|
24
53
|
|
|
25
54
|
- **Rule:** Do not assume; do not hide confusion. Before implementing, state assumptions explicitly and ask when uncertain.
|
|
26
55
|
- **Enforcement:**
|
|
@@ -28,13 +57,13 @@ flowchart LR
|
|
|
28
57
|
- If a simpler approach exists, say so before writing code; push back when warranted.
|
|
29
58
|
- If something is unclear, stop, name what is confusing, and ask. Proceeding on a guess converts one clarification into one full rework cycle.
|
|
30
59
|
|
|
31
|
-
|
|
60
|
+
### Principle 2: Simplicity First
|
|
32
61
|
|
|
33
62
|
- **Rule:** Write the minimum code that solves the stated problem. Nothing speculative.
|
|
34
63
|
- **Forbidden:** features beyond what was asked; abstractions for single-use code; "flexibility" or configurability that was not requested; error handling for impossible scenarios.
|
|
35
64
|
- **Self-test:** if 200 lines were written and 50 would do, rewrite. Ask: "Would a senior engineer call this overcomplicated?" If yes, simplify before continuing.
|
|
36
65
|
|
|
37
|
-
|
|
66
|
+
### Principle 3: Surgical Changes
|
|
38
67
|
|
|
39
68
|
- **Rule:** Touch only what the request requires. Clean up only the mess your own change created.
|
|
40
69
|
- **When editing existing code (Page Classes, test scripts, hub tools):**
|
|
@@ -44,7 +73,7 @@ flowchart LR
|
|
|
44
73
|
- **Orphan rule:** remove imports, variables, or functions that YOUR change made unused; leave pre-existing dead code untouched unless asked.
|
|
45
74
|
- **The test:** every changed line must trace directly to the user's request.
|
|
46
75
|
|
|
47
|
-
|
|
76
|
+
### Principle 4: Goal-Driven Execution
|
|
48
77
|
|
|
49
78
|
- **Rule:** Transform every task into a verifiable goal with explicit success criteria, then loop until verified.
|
|
50
79
|
- **Rewrites:** "add validation" becomes "write tests for invalid inputs, then make them pass"; "fix the bug" becomes "write a test that reproduces it, then make it pass" (pair with `test-driven-development`).
|
|
@@ -58,7 +87,7 @@ flowchart LR
|
|
|
58
87
|
|
|
59
88
|
Strong success criteria allow independent looping; weak criteria ("make it work") force constant clarification.
|
|
60
89
|
|
|
61
|
-
|
|
90
|
+
### Pre-Diff Self-Check
|
|
62
91
|
|
|
63
92
|
Before handing back any change, verify all boxes:
|
|
64
93
|
|
|
@@ -70,7 +99,7 @@ Before handing back any change, verify all boxes:
|
|
|
70
99
|
|
|
71
100
|
These principles are working if diffs shrink, rewrites due to overcomplication disappear, and clarifying questions arrive before implementation instead of after mistakes.
|
|
72
101
|
|
|
73
|
-
|
|
102
|
+
### Boundary vs Sibling Skills (Do Not Confuse)
|
|
74
103
|
|
|
75
104
|
| Sibling | Owns | Hand-off |
|
|
76
105
|
|---|---|---|
|
|
@@ -78,12 +107,28 @@ These principles are working if diffs shrink, rewrites due to overcomplication d
|
|
|
78
107
|
| `code-refactoring-refactor-clean` | Deliberate debt-elimination refactors | A refactor task still obeys surgical scope: diff lines trace to the refactor request |
|
|
79
108
|
| `lean-code-ladder` | The 7-rung reuse-first decision ladder | Use the ladder to choose the solution; use this skill to keep the diff disciplined |
|
|
80
109
|
|
|
81
|
-
|
|
110
|
+
### Reference Documentation
|
|
82
111
|
|
|
83
112
|
- `python3 tools/verify_all.py --mode hub` — 10 Quality Gates as the verification anchor for Goal-Driven Execution.
|
|
84
113
|
- `python3 tools/test_impact.py --git-diff` — scope the blast radius of a change before editing.
|
|
85
114
|
- `python3 tools/infer_linter.py` — confirm no fake-pass assertions were introduced by the change.
|
|
86
115
|
|
|
87
|
-
|
|
116
|
+
### Attribution
|
|
88
117
|
|
|
89
118
|
Adapted from **andrej-karpathy-skills** (https://github.com/multica-ai/andrej-karpathy-skills) — MIT License (declared in repository `plugin.json`), by forrestchang, derived from Andrej Karpathy's published observations on LLM coding pitfalls. Principles re-scoped for enterprise QA automation in Synapse Hub; wording, structure, and examples modified.
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## 4. Verification Points & DoD
|
|
123
|
+
|
|
124
|
+
1. Shortest working diff that achieves the requirement.
|
|
125
|
+
2. Existing comments, docstrings, and unrelated logic preserved intact.
|
|
126
|
+
3. Callers of modified functions verified to prevent regression.
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
## 5. Handoff Protocol
|
|
131
|
+
|
|
132
|
+
- **Deliverables:** Minimal surgical patch diff and caller impact verification report.
|
|
133
|
+
- **Next Subagent:** pom-crafter
|
|
134
|
+
- **Output Format:** Clean POM code, structured JSON telemetry, or validated markdown handoff.
|
|
@@ -3,18 +3,46 @@ name: technical-debt-harvester
|
|
|
3
3
|
description: "Harvest shortcut: comments into a tracked technical debt ledger. Use when auditing code compromises, tracking deferred refactorings, or scanning for shortcut markers."
|
|
4
4
|
category: architecture_and_analysis
|
|
5
5
|
version: "1.0.0"
|
|
6
|
+
policies:
|
|
7
|
+
network: none
|
|
8
|
+
shell: read-only
|
|
9
|
+
filesystem: read-only
|
|
6
10
|
---
|
|
7
|
-
|
|
8
11
|
# Technical Debt Harvester — Pragmatic Shortcut & Deferral Tracker
|
|
9
12
|
|
|
13
|
+
> **Author Attribution & MIT License Guard:** Synapse Hub is open-source software created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under the MIT License.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 1. Trigger & Activation
|
|
18
|
+
|
|
19
|
+
- **Trigger Clause:** Harvest shortcut: comments into a tracked technical debt ledger. Use when auditing code compromises, tracking deferred refactorings, or scanning for shortcut markers.
|
|
20
|
+
- **Activation Scope:** Domain workflows for `08-code-quality` involving `technical-debt-harvester`.
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## 2. Non-Goals & Boundary Constraints
|
|
25
|
+
|
|
26
|
+
- **What NOT to do:**
|
|
27
|
+
- Do NOT hide or disguise technical shortcuts; mark every deliberate simplification explicitly.
|
|
28
|
+
- Do NOT leave shortcut comments without stating the operational limit and upgrade trigger.
|
|
29
|
+
- Do NOT alter code behavior when harvesting or indexing debt markers.
|
|
30
|
+
- **Sibling Skill Boundaries:**
|
|
31
|
+
- lean-code-ladder allows pragmatic shortcuts; technical-debt-harvester tracks, catalogs, and schedules debt retirement.
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 3. Ordered Execution Workflow
|
|
36
|
+
|
|
10
37
|
Harvest deliberate shortcut comments (`shortcut: <limit>, <when to upgrade>`) across the entire repository into a structured Markdown ledger so pragmatic compromises do not silently rot into permanent defects.
|
|
11
38
|
|
|
12
39
|
---
|
|
13
40
|
|
|
14
|
-
|
|
41
|
+
### The Shortcut Comment Standard
|
|
15
42
|
|
|
16
43
|
When writing lean code or taking a pragmatic shortcut under time or scope constraints, leave an inline comment specifying the **ceiling (limit)** and the **upgrade trigger**:
|
|
17
44
|
|
|
45
|
+
<!-- classification: illustrative -->
|
|
18
46
|
```python
|
|
19
47
|
# Format:
|
|
20
48
|
# shortcut: <the limit>, <when to upgrade>
|
|
@@ -28,7 +56,7 @@ Any shortcut comment that omits an upgrade trigger is classified as `no-trigger`
|
|
|
28
56
|
|
|
29
57
|
---
|
|
30
58
|
|
|
31
|
-
|
|
59
|
+
### Supported Comment Syntaxes
|
|
32
60
|
|
|
33
61
|
The harvester automatically detects markers across all common language comment styles:
|
|
34
62
|
- `# shortcut:` (Python, Bash, Ruby, YAML)
|
|
@@ -41,8 +69,9 @@ The harvester automatically detects markers across all common language comment s
|
|
|
41
69
|
|
|
42
70
|
---
|
|
43
71
|
|
|
44
|
-
|
|
72
|
+
### Automation CLI
|
|
45
73
|
|
|
74
|
+
<!-- classification: illustrative -->
|
|
46
75
|
```bash
|
|
47
76
|
# Scan working directory and display ledger
|
|
48
77
|
python3 tools/debt_harvester.py
|
|
@@ -58,6 +87,7 @@ python3 tools/debt_harvester.py --keyword "DEBT:"
|
|
|
58
87
|
```
|
|
59
88
|
|
|
60
89
|
Or via the unified CLI:
|
|
90
|
+
<!-- classification: illustrative -->
|
|
61
91
|
```bash
|
|
62
92
|
agent-qa debt
|
|
63
93
|
agent-qa debt --output DEBT_LEDGER.md
|
|
@@ -65,6 +95,22 @@ agent-qa debt --output DEBT_LEDGER.md
|
|
|
65
95
|
|
|
66
96
|
---
|
|
67
97
|
|
|
68
|
-
|
|
98
|
+
### Attribution
|
|
69
99
|
|
|
70
100
|
Adapted from **ponytail-debt** (https://github.com/DietrichGebert/ponytail) — MIT License, Copyright (c) 2026 DietrichGebert. Re-architected with native Python tooling for Synapse Hub.
|
|
101
|
+
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
## 4. Verification Points & DoD
|
|
105
|
+
|
|
106
|
+
1. All deliberate simplifications adhere to `shortcut: <the limit>, <when to upgrade>` syntax.
|
|
107
|
+
2. Automated debt scan parses all active shortcuts across the repository.
|
|
108
|
+
3. Debt ledger prioritizes items by operational risk and upgrade urgency.
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
## 5. Handoff Protocol
|
|
113
|
+
|
|
114
|
+
- **Deliverables:** Technical debt inventory report, shortcut registry ledger, and retirement roadmap.
|
|
115
|
+
- **Next Subagent:** quality-gatekeeper
|
|
116
|
+
- **Output Format:** Clean POM code, structured JSON telemetry, or validated markdown handoff.
|
|
@@ -1,28 +1,50 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: github-actions-templates
|
|
3
3
|
description: "Create production-ready GitHub Actions workflows for automated test suites and CI/CD. Use when wiring test pipelines, matrix shards, or quality gates into GitHub Actions."
|
|
4
|
+
category: architecture_and_analysis
|
|
5
|
+
version: "2.0.0"
|
|
6
|
+
policies:
|
|
7
|
+
network: none
|
|
8
|
+
shell: none
|
|
9
|
+
filesystem: workspace-sandbox
|
|
4
10
|
---
|
|
5
|
-
|
|
6
11
|
# GitHub Actions CI/CD Patterns for Test Automation
|
|
7
12
|
|
|
8
|
-
> **
|
|
13
|
+
> **Author Attribution & MIT License Guard:** Synapse Hub is open-source software created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under the MIT License.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 1. Trigger & Activation
|
|
18
|
+
|
|
19
|
+
- **Trigger Clause:** Use when configuring continuous integration pipelines, setting up multi-OS and multi-version test execution matrices, wiring quality gates into GitHub Actions, or generating automated test report artifacts.
|
|
20
|
+
- **Activation Scope:**
|
|
21
|
+
- Automated test suites (Playwright, Pytest, Katalon, Newman).
|
|
22
|
+
- Parallel matrix sharding across runners and execution stages.
|
|
23
|
+
- Quality Gate Definition of Done (DoD) verification.
|
|
9
24
|
|
|
10
25
|
---
|
|
11
26
|
|
|
12
|
-
##
|
|
27
|
+
## 2. Non-Goals & Boundary Constraints
|
|
13
28
|
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
-
|
|
29
|
+
- **What NOT to do:**
|
|
30
|
+
- Do NOT use unpinned mutable tags (`@v4`, `@main`) for third-party actions; always pin to immutable 40-character commit SHAs.
|
|
31
|
+
- Do NOT hardcode credentials or tokens in workflow files; inject secrets exclusively through repository secrets (`${{ secrets.TEST_TOKEN }}`).
|
|
32
|
+
- Do NOT retain video and trace artifacts indefinitely; cap retention between 7 and 14 days.
|
|
33
|
+
- **Sibling Skill Boundaries:**
|
|
34
|
+
- `verification-before-completion`: Enforces DoD evidence collection prior to declaring task completion.
|
|
35
|
+
- `github-actions-templates` (this skill): Provides workflow blueprints, matrix sharding, and supply-chain-secure pipeline definitions.
|
|
18
36
|
|
|
19
37
|
---
|
|
20
38
|
|
|
21
|
-
##
|
|
39
|
+
## 3. Ordered Execution Workflow
|
|
40
|
+
|
|
41
|
+
### Phase 1: Workflow Configuration & Matrix Architecture
|
|
22
42
|
|
|
23
|
-
|
|
43
|
+
Author or update the CI/CD pipeline template (see reference `examples/matrix_test_pipeline.yml`).
|
|
24
44
|
|
|
45
|
+
<!-- classification: illustrative -->
|
|
25
46
|
```yaml
|
|
47
|
+
# Supply chain security: Pin actions to immutable full 40-character commit SHAs to mitigate tag hijacking and malicious upstream mutation risks.
|
|
26
48
|
name: Enterprise Automated E2E Test Suite
|
|
27
49
|
|
|
28
50
|
on:
|
|
@@ -41,10 +63,10 @@ jobs:
|
|
|
41
63
|
|
|
42
64
|
steps:
|
|
43
65
|
- name: Checkout Code
|
|
44
|
-
uses: actions/checkout@v4
|
|
66
|
+
uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
|
|
45
67
|
|
|
46
68
|
- name: Setup Node.js
|
|
47
|
-
uses: actions/setup-node@v4
|
|
69
|
+
uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a # v4.2.0
|
|
48
70
|
with:
|
|
49
71
|
node-version: 20
|
|
50
72
|
cache: 'npm'
|
|
@@ -60,18 +82,33 @@ jobs:
|
|
|
60
82
|
|
|
61
83
|
- name: Upload Test Report & Screenshots
|
|
62
84
|
if: always()
|
|
63
|
-
uses: actions/upload-artifact@v4
|
|
85
|
+
uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 # v4.4.3
|
|
64
86
|
with:
|
|
65
87
|
name: playwright-report-shard-${{ strategy.job-index }}
|
|
66
88
|
path: playwright-report/
|
|
67
89
|
retention-days: 14
|
|
68
90
|
```
|
|
69
91
|
|
|
92
|
+
### Phase 2: Security & Supply Chain Invariants
|
|
93
|
+
|
|
94
|
+
1. **Dependency Pinning:** Pin all third-party GitHub Actions to 40-character commit SHAs with version comments to protect against compromised release tags.
|
|
95
|
+
2. **Secret Masking:** Never echo secrets into workflow steps; pass them as environment variables mapped from GitHub Secrets.
|
|
96
|
+
3. **Concurrency Governance:** Cancel stale runs on pull request updates:
|
|
97
|
+
`concurrency: { group: ${{ github.workflow }}-${{ github.ref }}, cancel-in-progress: true }`.
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## 4. Verification Points & DoD
|
|
102
|
+
|
|
103
|
+
1. **Syntax Validation:** Workflow passes YAML linting and GitHub Actions schema checks.
|
|
104
|
+
2. **Commit SHA Pinning:** All `uses:` directives reference 40-character commit hashes with supply chain risk disclosures.
|
|
105
|
+
3. **Secret Protection:** 0 exposed secrets in step definitions, run scripts, or job logs.
|
|
106
|
+
4. **Execution Verification:** Pipeline successfully executes test matrix and uploads artifacts upon completion.
|
|
107
|
+
|
|
70
108
|
---
|
|
71
109
|
|
|
72
|
-
##
|
|
110
|
+
## 5. Handoff Protocol
|
|
73
111
|
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
4. **Concurrency Governance:** Cancel outdated in-flight runs on new PR commits using `concurrency: { group: ${{ github.ref }}, cancel-in-progress: true }`.
|
|
112
|
+
- **Deliverables:** Production-ready `.github/workflows/*.yml` workflow definitions and example templates in `examples/`.
|
|
113
|
+
- **Next Subagent:** Pass to `test-runner` for local execution or `quality-gatekeeper` for CI/CD integration acceptance.
|
|
114
|
+
- **Output Format:** Valid GitHub Actions YAML syntax adhering to enterprise security baselines.
|
package/.agents/skills/09-ci-and-devops/github-actions-templates/examples/matrix_test_pipeline.yml
CHANGED
|
@@ -1,8 +1,9 @@
|
|
|
1
|
+
# Supply chain security: Pin actions to immutable full 40-character commit SHAs to mitigate tag hijacking and malicious upstream mutation risks.
|
|
1
2
|
name: Automated E2E Matrix
|
|
2
3
|
on: [push, pull_request]
|
|
3
4
|
jobs:
|
|
4
5
|
test:
|
|
5
6
|
runs-on: ubuntu-latest
|
|
6
7
|
steps:
|
|
7
|
-
- uses: actions/checkout@v4
|
|
8
|
+
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
|
|
8
9
|
- run: npx playwright test
|
|
@@ -1,16 +1,45 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: actor-qa-swarm
|
|
3
3
|
description: "Asynchronous Actor Model message broker and matrix sharding coordinator for multi-agent test execution. Use when distributing parallel test workloads or wiring decoupled subagent event pub/sub."
|
|
4
|
+
category: context_and_optimization
|
|
5
|
+
version: "1.0.0"
|
|
6
|
+
policies:
|
|
7
|
+
network: none
|
|
8
|
+
shell: workspace-sandbox
|
|
9
|
+
filesystem: workspace-sandbox
|
|
4
10
|
---
|
|
5
|
-
|
|
6
11
|
# Actor QA Swarm Skill — Asynchronous Actor Messaging & Matrix Sharding
|
|
7
12
|
|
|
13
|
+
> **Author Attribution & MIT License Guard:** Synapse Hub is open-source software created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under the MIT License.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 1. Trigger & Activation
|
|
18
|
+
|
|
19
|
+
- **Trigger Clause:** Asynchronous Actor Model message broker and matrix sharding coordinator for multi-agent test execution. Use when distributing parallel test workloads or wiring decoupled subagent event pub/sub.
|
|
20
|
+
- **Activation Scope:** Domain workflows for `10-agent-orchestration` involving `actor-qa-swarm`.
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## 2. Non-Goals & Boundary Constraints
|
|
25
|
+
|
|
26
|
+
- **What NOT to do:**
|
|
27
|
+
- Do NOT allow subagents to share mutable global state; communicate via isolated message passing.
|
|
28
|
+
- Do NOT spawn unbounded subagent hierarchies that exceed token and resource ceilings.
|
|
29
|
+
- Do NOT allow subagents to stall on trivial decisions (follow Jesse Vincent Protocol).
|
|
30
|
+
- **Sibling Skill Boundaries:**
|
|
31
|
+
- agent-orchestration-multi-agent-optimize schedules work; actor-qa-swarm provides the Actor Model execution harness for concurrent subagents.
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 3. Ordered Execution Workflow
|
|
36
|
+
|
|
8
37
|
> **Paradigm Attribution:** Inspired by **Microsoft AutoGen v0.4+ (AG2 Actor Framework)**.
|
|
9
38
|
> **Core Principle:** Transition from synchronous lock-step file coordination to an asynchronous Actor Model. Subagents exchange messages via non-blocking mailboxes and subscribe to test failure events in real time.
|
|
10
39
|
|
|
11
40
|
---
|
|
12
41
|
|
|
13
|
-
|
|
42
|
+
### The Actor Swarm Architecture
|
|
14
43
|
|
|
15
44
|
```mermaid
|
|
16
45
|
flowchart TD
|
|
@@ -37,10 +66,11 @@ flowchart TD
|
|
|
37
66
|
|
|
38
67
|
---
|
|
39
68
|
|
|
40
|
-
|
|
69
|
+
### CLI Tool Usage
|
|
41
70
|
|
|
42
71
|
Autonomous commands via `tools/autogen_qa_broker.py`:
|
|
43
72
|
|
|
73
|
+
<!-- classification: illustrative -->
|
|
44
74
|
```bash
|
|
45
75
|
# 1. Dispatch regression suite across 4 parallel shards
|
|
46
76
|
python tools/autogen_qa_broker.py dispatch-shards \
|
|
@@ -70,8 +100,24 @@ python tools/autogen_qa_broker.py check-health
|
|
|
70
100
|
|
|
71
101
|
---
|
|
72
102
|
|
|
73
|
-
|
|
103
|
+
### Strict Operating Invariants
|
|
74
104
|
|
|
75
105
|
- **Deadlock Prevention:** Enforce 300s timeout ceilings on actor response waits.
|
|
76
106
|
- **Asynchronous Execution:** No subagent shall block the main thread waiting for another subagent's response.
|
|
77
107
|
- **Zero Raw Selectors:** Messages instructing code synthesis must strictly enforce Clean POM standards.
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## 4. Verification Points & DoD
|
|
112
|
+
|
|
113
|
+
1. Subagents maintain isolated state directories and strictly bounded role assignments.
|
|
114
|
+
2. Messages between agents follow structured context, content, and action contracts.
|
|
115
|
+
3. Execution finishes within allocated token budget and concurrency limits.
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
|
|
119
|
+
## 5. Handoff Protocol
|
|
120
|
+
|
|
121
|
+
- **Deliverables:** Swarm execution traces, subagent state records, and aggregated task deliverables.
|
|
122
|
+
- **Next Subagent:** orchestrator
|
|
123
|
+
- **Output Format:** Clean POM code, structured JSON telemetry, or validated markdown handoff.
|
package/.agents/skills/10-agent-orchestration/agent-orchestration-multi-agent-optimize/SKILL.md
CHANGED
|
@@ -1,15 +1,44 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: agent-orchestration-multi-agent-optimize
|
|
3
3
|
description: "Profile, benchmark, and orchestrate multi-agent test workloads and token throughput. Use when orchestrating multi-agent swarms, partitioning workloads, or optimizing agent roles."
|
|
4
|
+
category: context_and_optimization
|
|
5
|
+
version: "2.0.0"
|
|
6
|
+
policies:
|
|
7
|
+
network: none
|
|
8
|
+
shell: none
|
|
9
|
+
filesystem: read-only
|
|
4
10
|
---
|
|
5
|
-
|
|
6
11
|
# Multi-Agent Optimization & Orchestration Skill
|
|
7
12
|
|
|
13
|
+
> **Author Attribution & MIT License Guard:** Synapse Hub is open-source software created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under the MIT License.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 1. Trigger & Activation
|
|
18
|
+
|
|
19
|
+
- **Trigger Clause:** Profile, benchmark, and orchestrate multi-agent test workloads and token throughput. Use when orchestrating multi-agent swarms, partitioning workloads, or optimizing agent roles.
|
|
20
|
+
- **Activation Scope:** Domain workflows for `10-agent-orchestration` involving `agent-orchestration-multi-agent-optimize`.
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## 2. Non-Goals & Boundary Constraints
|
|
25
|
+
|
|
26
|
+
- **What NOT to do:**
|
|
27
|
+
- Do NOT dispatch tasks to subagents with incomplete or ambiguous task briefings.
|
|
28
|
+
- Do NOT spawn parallel subagents for sequential dependent tasks.
|
|
29
|
+
- Do NOT omit timeout and failure recovery handlers for worker agents.
|
|
30
|
+
- **Sibling Skill Boundaries:**
|
|
31
|
+
- actor-qa-swarm provides actor primitives; agent-orchestration-multi-agent-optimize plans and coordinates multi-agent workload sharding.
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 3. Ordered Execution Workflow
|
|
36
|
+
|
|
8
37
|
> **Target:** Optimize multi-agent test workloads, reduce context overhead, streamline agent handoffs, and monitor token consumption across autonomous test swarms.
|
|
9
38
|
|
|
10
39
|
---
|
|
11
40
|
|
|
12
|
-
|
|
41
|
+
### When to Use
|
|
13
42
|
|
|
14
43
|
- Managing multi-agent coordination, test suite sharding, and throughput.
|
|
15
44
|
- Profiling sub-agent task decomposition to eliminate redundant execution.
|
|
@@ -18,7 +47,7 @@ description: "Profile, benchmark, and orchestrate multi-agent test workloads and
|
|
|
18
47
|
|
|
19
48
|
---
|
|
20
49
|
|
|
21
|
-
|
|
50
|
+
### Core Orchestration Principles
|
|
22
51
|
|
|
23
52
|
1. **Single Front-Door Protocol:**
|
|
24
53
|
- All inbound tasks route through `orchestrator` to prevent split-brain execution.
|
|
@@ -32,8 +61,9 @@ description: "Profile, benchmark, and orchestrate multi-agent test workloads and
|
|
|
32
61
|
|
|
33
62
|
---
|
|
34
63
|
|
|
35
|
-
|
|
64
|
+
### Workload Sharding & Matrix Execution
|
|
36
65
|
|
|
66
|
+
<!-- classification: illustrative -->
|
|
37
67
|
```python
|
|
38
68
|
# Multi-agent workload partition example
|
|
39
69
|
def shard_test_workload(suite_files: list, max_agents: int = 4) -> list:
|
|
@@ -46,7 +76,7 @@ def shard_test_workload(suite_files: list, max_agents: int = 4) -> list:
|
|
|
46
76
|
|
|
47
77
|
---
|
|
48
78
|
|
|
49
|
-
|
|
79
|
+
### Token & Latency Governance
|
|
50
80
|
|
|
51
81
|
| Optimization Layer | Baseline (Naive) | Optimized (Synapse Swarm) | Savings |
|
|
52
82
|
| :--- | :--- | :--- | :--- |
|
|
@@ -57,7 +87,7 @@ def shard_test_workload(suite_files: list, max_agents: int = 4) -> list:
|
|
|
57
87
|
|
|
58
88
|
---
|
|
59
89
|
|
|
60
|
-
|
|
90
|
+
### Verification & Safety Guidelines
|
|
61
91
|
|
|
62
92
|
- Always establish baseline metrics before applying workflow changes.
|
|
63
93
|
- Ensure subagent dynamic test data uses unique runtime IDs (`AUTO_<timestamp>_<agentId>`).
|
|
@@ -65,7 +95,7 @@ def shard_test_workload(suite_files: list, max_agents: int = 4) -> list:
|
|
|
65
95
|
|
|
66
96
|
---
|
|
67
97
|
|
|
68
|
-
|
|
98
|
+
### Hierarchical Process & Manager Delegation
|
|
69
99
|
|
|
70
100
|
> *Borrowed and adapted from the crewAI hierarchical process model (MIT license, crewAIInc/crewAI).*
|
|
71
101
|
|
|
@@ -86,3 +116,19 @@ The hub's default is a flat swarm with the `orchestrator` as single front-door
|
|
|
86
116
|
4. **Escalate structure, not authority** — the hierarchy speeds coordination;
|
|
87
117
|
Truth Anchor, safety firewall and quality gates apply identically at every
|
|
88
118
|
level. Delegation never bypasses a gate.
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## 4. Verification Points & DoD
|
|
123
|
+
|
|
124
|
+
1. Task decomposed into independent, parallelizable sub-milestones.
|
|
125
|
+
2. Subagent dispatch briefings are 100% self-contained (`BRIEFING.md` format).
|
|
126
|
+
3. Consolidated outputs verified against definition of done before milestone completion.
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
## 5. Handoff Protocol
|
|
131
|
+
|
|
132
|
+
- **Deliverables:** Milestone orchestration plan, dispatch records, and consolidated verification summary.
|
|
133
|
+
- **Next Subagent:** orchestrator
|
|
134
|
+
- **Output Format:** Clean POM code, structured JSON telemetry, or validated markdown handoff.
|
|
@@ -1,16 +1,45 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: event-stream-qa-orchestrator
|
|
3
3
|
description: "Immutable EventStream orchestrator recording deterministic action/observation timelines with SHA-256 hash chains and reversible checkpoint rollbacks. Use when tracing test executions and managing replayable state."
|
|
4
|
+
category: context_and_optimization
|
|
5
|
+
version: "1.0.0"
|
|
6
|
+
policies:
|
|
7
|
+
network: localhost-only
|
|
8
|
+
shell: workspace-sandbox
|
|
9
|
+
filesystem: workspace-sandbox
|
|
4
10
|
---
|
|
5
|
-
|
|
6
11
|
# QA Event Stream Orchestrator Skill — Immutable Audit & Replay Timeline
|
|
7
12
|
|
|
13
|
+
> **Author Attribution & MIT License Guard:** Synapse Hub is open-source software created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under the MIT License.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 1. Trigger & Activation
|
|
18
|
+
|
|
19
|
+
- **Trigger Clause:** Immutable EventStream orchestrator recording deterministic action/observation timelines with SHA-256 hash chains and reversible checkpoint rollbacks. Use when tracing test executions and managing replayable state.
|
|
20
|
+
- **Activation Scope:** Domain workflows for `10-agent-orchestration` involving `event-stream-qa-orchestrator`.
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## 2. Non-Goals & Boundary Constraints
|
|
25
|
+
|
|
26
|
+
- **What NOT to do:**
|
|
27
|
+
- Do NOT poll in tight synchronous loops when waiting for asynchronous background tasks.
|
|
28
|
+
- Do NOT drop or miss event notifications in the event stream pipeline.
|
|
29
|
+
- Do NOT process event payloads without schema and boundary validation.
|
|
30
|
+
- **Sibling Skill Boundaries:**
|
|
31
|
+
- actor-qa-swarm coordinates actor agents; event-stream-qa-orchestrator processes asynchronous event streams and reactive test pipelines.
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 3. Ordered Execution Workflow
|
|
36
|
+
|
|
8
37
|
> **Paradigm Attribution:** Inspired by **All-Hands-AI OpenHands (EventStream & CodeAct Runtime)**.
|
|
9
38
|
> **Core Principle:** Treat automated testing sessions as an append-only, immutable stream of events. Prevent state corruption and lost context by chaining each event with cryptographic SHA-256 hashes and enabling deterministic check-pointed rollbacks.
|
|
10
39
|
|
|
11
40
|
---
|
|
12
41
|
|
|
13
|
-
|
|
42
|
+
### The EventStream Pipeline
|
|
14
43
|
|
|
15
44
|
```mermaid
|
|
16
45
|
flowchart LR
|
|
@@ -35,10 +64,11 @@ flowchart LR
|
|
|
35
64
|
|
|
36
65
|
---
|
|
37
66
|
|
|
38
|
-
|
|
67
|
+
### CLI Tool Usage
|
|
39
68
|
|
|
40
69
|
Autonomous commands via `tools/qa_event_stream.py`:
|
|
41
70
|
|
|
71
|
+
<!-- classification: illustrative -->
|
|
42
72
|
```bash
|
|
43
73
|
# 1. Initialize stream
|
|
44
74
|
python tools/qa_event_stream.py init-stream \
|
|
@@ -72,8 +102,24 @@ python tools/qa_event_stream.py rollback \
|
|
|
72
102
|
|
|
73
103
|
---
|
|
74
104
|
|
|
75
|
-
|
|
105
|
+
### Strict Operating Invariants
|
|
76
106
|
|
|
77
107
|
- **Hash Chain Integrity:** All events must compute `SHA-256(prev_hash | session_id | event_type | actor | payload | timestamp)`.
|
|
78
108
|
- **Zero Log Tampering:** Never edit `timeline.jsonl` lines manually; always append via the CLI tool.
|
|
79
109
|
- **UTF-8 No BOM:** Timeline files must remain clean UTF-8 without byte-order marks.
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## 4. Verification Points & DoD
|
|
114
|
+
|
|
115
|
+
1. Event stream pipeline handles test execution events asynchronously.
|
|
116
|
+
2. Task status and heartbeat updates recorded via reactive event subscriptions.
|
|
117
|
+
3. Zero zombie or hanging background worker tasks.
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## 5. Handoff Protocol
|
|
122
|
+
|
|
123
|
+
- **Deliverables:** Event pipeline logs, reactive execution traces, and stream processing telemetry.
|
|
124
|
+
- **Next Subagent:** orchestrator
|
|
125
|
+
- **Output Format:** Clean POM code, structured JSON telemetry, or validated markdown handoff.
|