@adityaaria/agent-os 1.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 (129) hide show
  1. package/AGENTS.md +41 -0
  2. package/AGENT_OS_BOOTSTRAP.md +29 -0
  3. package/ENTRYPOINT.md +118 -0
  4. package/LICENSE +21 -0
  5. package/README.md +230 -0
  6. package/adapters/antigravity/README.md +9 -0
  7. package/adapters/antigravity/plugin.json +13 -0
  8. package/adapters/claude/CLAUDE.md +16 -0
  9. package/adapters/claude/README.md +10 -0
  10. package/adapters/codex/README.md +20 -0
  11. package/adapters/cursor/README.md +9 -0
  12. package/adapters/cursor/agent-os.rules.md +18 -0
  13. package/bin/agent-os.mjs +98 -0
  14. package/core/AUTO_PROJECT_DETECTOR.md +99 -0
  15. package/core/COMPLIANCE_GATE.md +19 -0
  16. package/core/FRAMEWORK_AUDITOR.md +35 -0
  17. package/core/KNOWLEDGE_REGENERATOR.md +30 -0
  18. package/core/KNOWLEDGE_VALIDATOR.md +29 -0
  19. package/core/PROJECT_CONTEXT_STANDARD.md +19 -0
  20. package/core/QUALITY_GATES.md +42 -0
  21. package/core/REPORTING_STANDARD.md +47 -0
  22. package/core/SKILL_ORCHESTRATOR.md +63 -0
  23. package/core/TASK_ROUTER.md +33 -0
  24. package/core/TRACEABILITY_STANDARD.md +40 -0
  25. package/package.json +28 -0
  26. package/scripts/install.mjs +690 -0
  27. package/scripts/lib/cli-utils.mjs +148 -0
  28. package/scripts/lib/run-utils.mjs +185 -0
  29. package/scripts/lib/telegram-audit-log.mjs +50 -0
  30. package/scripts/lib/telegram-bot-utils.mjs +413 -0
  31. package/scripts/lib/telegram-utils.mjs +127 -0
  32. package/scripts/orchestrate.mjs +230 -0
  33. package/scripts/quality-static.mjs +19 -0
  34. package/scripts/report-export.mjs +86 -0
  35. package/scripts/report-notify.mjs +169 -0
  36. package/scripts/run-execution.mjs +83 -0
  37. package/scripts/run-list.mjs +44 -0
  38. package/scripts/run-status.mjs +38 -0
  39. package/scripts/run-step.mjs +173 -0
  40. package/scripts/setup-wizard.mjs +116 -0
  41. package/scripts/sync-runtime.mjs +87 -0
  42. package/scripts/telegram-bot.mjs +88 -0
  43. package/scripts/telegram-check.mjs +94 -0
  44. package/scripts/telegram-poll.mjs +176 -0
  45. package/scripts/validate-framework.mjs +290 -0
  46. package/skills/api-contract-audit/SKILL.md +26 -0
  47. package/skills/api-contract-audit/checklist.md +16 -0
  48. package/skills/api-contract-audit/examples.md +3 -0
  49. package/skills/api-contract-audit/report-template.md +39 -0
  50. package/skills/api-contract-audit/workflow.md +15 -0
  51. package/skills/audit/SKILL.md +28 -0
  52. package/skills/audit/checklist.md +18 -0
  53. package/skills/audit/examples.md +26 -0
  54. package/skills/audit/report-template.md +39 -0
  55. package/skills/audit/workflow.md +15 -0
  56. package/skills/bug-fix/SKILL.md +25 -0
  57. package/skills/bug-fix/checklist.md +18 -0
  58. package/skills/bug-fix/examples.md +26 -0
  59. package/skills/bug-fix/report-template.md +39 -0
  60. package/skills/bug-fix/workflow.md +10 -0
  61. package/skills/database-impact-analysis/SKILL.md +27 -0
  62. package/skills/database-impact-analysis/checklist.md +16 -0
  63. package/skills/database-impact-analysis/examples.md +3 -0
  64. package/skills/database-impact-analysis/report-template.md +39 -0
  65. package/skills/database-impact-analysis/workflow.md +14 -0
  66. package/skills/enhancement/SKILL.md +27 -0
  67. package/skills/enhancement/checklist.md +19 -0
  68. package/skills/enhancement/examples.md +26 -0
  69. package/skills/enhancement/report-template.md +39 -0
  70. package/skills/enhancement/workflow.md +10 -0
  71. package/skills/enterprise-certification/SKILL.md +19 -0
  72. package/skills/enterprise-certification/checklist.md +17 -0
  73. package/skills/enterprise-certification/report-template.md +39 -0
  74. package/skills/enterprise-certification/workflow.md +14 -0
  75. package/skills/knowledge-evolution/SKILL.md +23 -0
  76. package/skills/knowledge-evolution/checklist.md +17 -0
  77. package/skills/knowledge-evolution/report-template.md +39 -0
  78. package/skills/knowledge-evolution/workflow.md +14 -0
  79. package/skills/new-page/SKILL.md +26 -0
  80. package/skills/new-page/checklist.md +21 -0
  81. package/skills/new-page/examples.md +26 -0
  82. package/skills/new-page/report-template.md +39 -0
  83. package/skills/new-page/workflow.md +10 -0
  84. package/skills/project-onboarding/SKILL.md +27 -0
  85. package/skills/project-onboarding/checklist.md +18 -0
  86. package/skills/project-onboarding/examples.md +26 -0
  87. package/skills/project-onboarding/report-template.md +39 -0
  88. package/skills/project-onboarding/workflow.md +9 -0
  89. package/skills/release-readiness/SKILL.md +27 -0
  90. package/skills/release-readiness/checklist.md +16 -0
  91. package/skills/release-readiness/examples.md +3 -0
  92. package/skills/release-readiness/report-template.md +39 -0
  93. package/skills/release-readiness/workflow.md +14 -0
  94. package/skills/repository-health/SKILL.md +26 -0
  95. package/skills/repository-health/checklist.md +20 -0
  96. package/skills/repository-health/report-template.md +39 -0
  97. package/skills/repository-health/workflow.md +14 -0
  98. package/skills/selenium-e2e/SKILL.md +83 -0
  99. package/skills/selenium-e2e/checklist.md +29 -0
  100. package/skills/selenium-e2e/examples.md +26 -0
  101. package/skills/selenium-e2e/report-template.md +39 -0
  102. package/skills/selenium-e2e/workflow.md +9 -0
  103. package/skills/self-audit/SKILL.md +19 -0
  104. package/skills/self-audit/checklist.md +14 -0
  105. package/skills/self-audit/report-template.md +39 -0
  106. package/skills/self-audit/workflow.md +11 -0
  107. package/skills/traceability-analysis/SKILL.md +25 -0
  108. package/skills/traceability-analysis/checklist.md +17 -0
  109. package/skills/traceability-analysis/examples.md +3 -0
  110. package/skills/traceability-analysis/report-template.md +39 -0
  111. package/skills/traceability-analysis/workflow.md +17 -0
  112. package/templates/API_RULES.md +20 -0
  113. package/templates/ARCHITECTURE.md +20 -0
  114. package/templates/BUSINESS_FLOW.md +20 -0
  115. package/templates/COMMANDS.md +20 -0
  116. package/templates/DATABASE_RULES.md +20 -0
  117. package/templates/DEPENDENCY_MAP.md +20 -0
  118. package/templates/DEPLOYMENT_RULES.md +20 -0
  119. package/templates/DOMAIN_MODEL.md +20 -0
  120. package/templates/FE_BE_TRACEABILITY.md +20 -0
  121. package/templates/KNOWN_LIMITATIONS.md +20 -0
  122. package/templates/MODULE_CATALOG.md +20 -0
  123. package/templates/PROJECT_PROFILE.md +20 -0
  124. package/templates/RISK_REGISTER.md +20 -0
  125. package/templates/SECURITY_RULES.md +20 -0
  126. package/templates/TECHNICAL_DEBT.md +20 -0
  127. package/templates/TECH_STACK.md +20 -0
  128. package/templates/TESTING_RULES.md +47 -0
  129. package/templates/UI_UX_RULES.md +20 -0
@@ -0,0 +1,39 @@
1
+ # Executive Summary
2
+ * **Trigger Detected**: N/A. Reason: Populated during skill execution.
3
+ * **Purpose**: N/A. Reason: Populated during skill execution.
4
+
5
+ # Scope
6
+ * **Target**: N/A. Reason: Populated during skill execution.
7
+
8
+ # Knowledge Confidence
9
+ * **Score**: N/A. Reason: Populated during skill execution.
10
+
11
+ # Knowledge Classification
12
+ * **Classification**: N/A. Reason: Populated during skill execution.
13
+
14
+ # Traceability Matrix
15
+ | Layer | File | Function | Notes |
16
+ | ----- | ---- | -------- | ----- |
17
+ | Framework | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. |
18
+
19
+ # Evidence
20
+ * N/A. Reason: Populated during skill execution.
21
+
22
+ # Root Cause
23
+ * N/A. Reason: Populated during skill execution.
24
+
25
+ # Impact
26
+ * N/A. Reason: Populated during skill execution.
27
+
28
+ # Recommendation
29
+ * **Quick Win**: N/A. Reason: Populated during skill execution.
30
+ * **Long Term Improvement**: N/A. Reason: Populated during skill execution.
31
+
32
+ # Quality Gate
33
+ * N/A. Reason: Populated during skill execution.
34
+
35
+ # Enterprise Readiness
36
+ * N/A. Reason: Populated during skill execution.
37
+
38
+ # Final Decision
39
+ N/A. Reason: Populated during skill execution.
@@ -0,0 +1,10 @@
1
+ # New Page Workflow
2
+
3
+ 1. **Pre-flight Check**: Parse the new page request and verify scope.
4
+ 2. **Knowledge Retrieval**: Load applicable `.agent-os/knowledge/` (Business Rules, Workflows, Technical).
5
+ 3. **Traceability Mapping**: Trace the new requirement across the unified 10-layer chain.
6
+ 4. **Design**: Plan the page structure and API integrations.
7
+ 5. **Implementation**: Build the page.
8
+ 6. **Knowledge Impact Assessment**: Explicitly determine if Business Rules, Workflows, APIs, DTOs, Entities, Database, or User Journeys changed.
9
+ 7. **Execution Validation**: Verify the page via testing.
10
+ 8. **Final Reporting**: Generate the standard Report Template.
@@ -0,0 +1,27 @@
1
+ # PROJECT-ONBOARDING SKILL
2
+
3
+ ## Purpose
4
+ To autonomously analyze a new or existing repository, deeply detecting the Tech Stack, Architecture, FE-BE mappings, and database structures, generating rich foundational knowledge for all other skills.
5
+
6
+ ## Responsibilities
7
+ - Detect Architecture (Monolith, Microservice, Hybrid).
8
+ - Detect Tech Stack (Frontend, Backend, Database).
9
+ - Identify Business Modules/Domains.
10
+ - Map high-level FE-BE relationships.
11
+ - Establish `.agent-os/project/` knowledge files.
12
+
13
+ ## Workflow
14
+ Follow the detailed workflow in `workflow.md` for this skill.
15
+
16
+ ## Required Inputs
17
+ Minimal Prompting: `ONBOARD` or automatically triggered when joining a new workspace.
18
+
19
+ ## Expected Outputs
20
+ Project Knowledge Report and a fully populated `.agent-os/project` directory.
21
+
22
+ ## Execution Rules
23
+ - Never rely solely on folder names; inspect source code for frameworks (e.g., `package.json`, `pom.xml`, `build.gradle`).
24
+ - Collect explicit evidence of architecture (e.g., API Gateway configurations, monolith routing).
25
+
26
+ ## Minimal Prompting Target
27
+ - Agent automatically scans the current directory and parent directories to find project boundaries.
@@ -0,0 +1,18 @@
1
+ # PROJECT-ONBOARDING CHECKLIST
2
+
3
+ ## Entry Criteria
4
+ - [ ] Workspace directory is accessible.
5
+
6
+ ## Execution
7
+ - [ ] Repository Scan complete.
8
+ - [ ] Architecture detected.
9
+ - [ ] Tech Stack detected.
10
+ - [ ] Module list generated.
11
+ - [ ] FE-BE Mapping generated.
12
+ - [ ] Database mapped.
13
+ - [ ] `.agent-os/project/` knowledge files populated.
14
+
15
+ ## Exit Criteria / Definition of Done
16
+ - [ ] Project Knowledge Report generated.
17
+ - [ ] Enterprise Readiness Score calculated.
18
+ - [ ] Quality Gate set to PASS.
@@ -0,0 +1,26 @@
1
+ # PROJECT-ONBOARDING EXAMPLES
2
+
3
+ ### Example 1
4
+ ```txt
5
+ ANALYZE PROJECT: Initialize this repository.
6
+ ```
7
+
8
+ ### Example 2
9
+ ```txt
10
+ ANALYZE PROJECT: Re-scan after moving to Monorepo.
11
+ ```
12
+
13
+ ### Example 3
14
+ ```txt
15
+ ANALYZE PROJECT: Update database rules.
16
+ ```
17
+
18
+ ### Example 4
19
+ ```txt
20
+ ANALYZE PROJECT: Document the new Auth flow.
21
+ ```
22
+
23
+ ### Example 5
24
+ ```txt
25
+ ANALYZE PROJECT: Generate Module Catalog.
26
+ ```
@@ -0,0 +1,39 @@
1
+ # Executive Summary
2
+ * **Trigger Detected**: N/A. Reason: Populated during skill execution.
3
+ * **Purpose**: N/A. Reason: Populated during skill execution.
4
+
5
+ # Scope
6
+ * **Target**: N/A. Reason: Populated during skill execution.
7
+
8
+ # Knowledge Confidence
9
+ * **Score**: N/A. Reason: Populated during skill execution.
10
+
11
+ # Knowledge Classification
12
+ * **Classification**: N/A. Reason: Populated during skill execution.
13
+
14
+ # Traceability Matrix
15
+ | Layer | File | Function | Notes |
16
+ | ----- | ---- | -------- | ----- |
17
+ | Framework | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. |
18
+
19
+ # Evidence
20
+ * N/A. Reason: Populated during skill execution.
21
+
22
+ # Root Cause
23
+ * N/A. Reason: Populated during skill execution.
24
+
25
+ # Impact
26
+ * N/A. Reason: Populated during skill execution.
27
+
28
+ # Recommendation
29
+ * **Quick Win**: N/A. Reason: Populated during skill execution.
30
+ * **Long Term Improvement**: N/A. Reason: Populated during skill execution.
31
+
32
+ # Quality Gate
33
+ * N/A. Reason: Populated during skill execution.
34
+
35
+ # Enterprise Readiness
36
+ * N/A. Reason: Populated during skill execution.
37
+
38
+ # Final Decision
39
+ N/A. Reason: Populated during skill execution.
@@ -0,0 +1,9 @@
1
+ # Project Onboarding Workflow
2
+
3
+ 1. **Pre-flight Check**: Parse the onboarding request and root repository context.
4
+ 2. **Technical Knowledge Generation**: Scan the repository structure and define the architecture, dependencies, and code standards in `.agent-os/knowledge/technical/`.
5
+ 3. **Business Rules Generation**: Extract explicit business constraints and document them using the standard template in `.agent-os/knowledge/business-rules/`.
6
+ 4. **Workflow Knowledge Generation**: Extract step-by-step user/system flows and document them in `.agent-os/knowledge/workflows/`.
7
+ 5. **Traceability Knowledge Generation**: Generate the unified 10-layer traceability mapping across the repository inside `.agent-os/knowledge/traceability/`.
8
+ 6. **Repository Summary Generation**: Aggregate the high-level metrics and health of the project.
9
+ 7. **Final Reporting**: Generate the standard Project Onboarding Report Template to present all findings.
@@ -0,0 +1,27 @@
1
+ # RELEASE-READINESS SKILL
2
+
3
+ ## Purpose
4
+ To audit the overall readiness of the system for production deployment by evaluating Deployment, Regression, Performance, and Security risks.
5
+
6
+ ## Responsibilities
7
+ - Audit Deployment Risk.
8
+ - Audit Regression Risk.
9
+ - Audit Performance Risk.
10
+ - Audit Security Risk.
11
+ - Assess Rollback Readiness.
12
+
13
+ ## Workflow
14
+ Follow the detailed workflow in `workflow.md` for this skill.
15
+
16
+ ## Required Inputs
17
+ Minimal Prompting: `AUDIT: Release Readiness`
18
+
19
+ ## Expected Outputs
20
+ Release Readiness Report with a final Readiness Score (0-100).
21
+
22
+ ## Execution Rules
23
+ - Compile signals from existing automated tests, pipeline status, and code audits.
24
+ - Output a strict PASS/FAIL based on the final Score.
25
+
26
+ ## Minimal Prompting Target
27
+ - Agent autonomously assesses the main branch or current state without needing explicit parameters.
@@ -0,0 +1,16 @@
1
+ # RELEASE-READINESS CHECKLIST
2
+
3
+ ## Entry Criteria
4
+ - [ ] Release candidate or environment is identified.
5
+
6
+ ## Execution
7
+ - [ ] Deployment risk audited.
8
+ - [ ] Regression risk audited.
9
+ - [ ] Performance risk audited.
10
+ - [ ] Security risk audited.
11
+ - [ ] Rollback readiness verified.
12
+
13
+ ## Exit Criteria / Definition of Done
14
+ - [ ] Release Readiness Report generated.
15
+ - [ ] Enterprise Readiness Score calculated.
16
+ - [ ] Quality Gate set to PASS.
@@ -0,0 +1,3 @@
1
+ # EXAMPLES
2
+
3
+ To be populated by Agent OS automatically based on project context.
@@ -0,0 +1,39 @@
1
+ # Executive Summary
2
+ * **Trigger Detected**: N/A. Reason: Populated during skill execution.
3
+ * **Purpose**: N/A. Reason: Populated during skill execution.
4
+
5
+ # Scope
6
+ * **Target**: N/A. Reason: Populated during skill execution.
7
+
8
+ # Knowledge Confidence
9
+ * **Score**: N/A. Reason: Populated during skill execution.
10
+
11
+ # Knowledge Classification
12
+ * **Classification**: N/A. Reason: Populated during skill execution.
13
+
14
+ # Traceability Matrix
15
+ | Layer | File | Function | Notes |
16
+ | ----- | ---- | -------- | ----- |
17
+ | Framework | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. |
18
+
19
+ # Evidence
20
+ * N/A. Reason: Populated during skill execution.
21
+
22
+ # Root Cause
23
+ * N/A. Reason: Populated during skill execution.
24
+
25
+ # Impact
26
+ * N/A. Reason: Populated during skill execution.
27
+
28
+ # Recommendation
29
+ * **Quick Win**: N/A. Reason: Populated during skill execution.
30
+ * **Long Term Improvement**: N/A. Reason: Populated during skill execution.
31
+
32
+ # Quality Gate
33
+ * N/A. Reason: Populated during skill execution.
34
+
35
+ # Enterprise Readiness
36
+ * N/A. Reason: Populated during skill execution.
37
+
38
+ # Final Decision
39
+ N/A. Reason: Populated during skill execution.
@@ -0,0 +1,14 @@
1
+ # RELEASE-READINESS WORKFLOW
2
+
3
+ You MUST execute these explicit steps sequentially:
4
+
5
+ 1. **Pre Validation** (Verify all Execution Reports and dependency artifacts exist)
6
+ 2. **Deployment Audit** (Check CI/CD pipelines, env vars, build status)
7
+ 3. **Regression Audit** (Check test coverage, E2E test results)
8
+ 4. **Performance Audit** (Assess bundle sizes, N+1 query risks)
9
+ 5. **Security Audit** (Assess exposed secrets, package vulnerabilities)
10
+ 6. **Rollback Assessment** (Check database migration reversibility)
11
+ 7. **Execution Validation** (Ensure all metrics collected)
12
+ 8. **Generate Readiness Score**
13
+ 9. **Generate Assessment Report**
14
+ 10. **Post Validation** (Verify report conforms to Enterprise Standard)
@@ -0,0 +1,26 @@
1
+ # REPOSITORY-HEALTH SKILL
2
+
3
+ ## Purpose
4
+ To autonomously audit and score the holistic health of the repository, providing a top-level classification of enterprise readiness based on documentation, coverage, and debt metrics.
5
+
6
+ ## Responsibilities
7
+ - Audit Documentation Coverage.
8
+ - Audit Knowledge Coverage.
9
+ - Audit Test Coverage.
10
+ - Audit Traceability Coverage.
11
+ - Assess Dependency Risk.
12
+ - Assess Technical Debt.
13
+ - Audit Architecture Consistency.
14
+
15
+ ## Workflow
16
+ Follow the detailed workflow in `workflow.md` for this skill.
17
+
18
+ ## Required Inputs
19
+ Minimal Prompting: `AUDIT: Repository Health`
20
+
21
+ ## Expected Outputs
22
+ Repository Health Report containing a final score (0-100) and Classification (Excellent, Good, Fair, Poor, Critical).
23
+
24
+ ## Execution Rules
25
+ - Must strictly validate findings against the Anti-Assumption Framework.
26
+ - If test coverage cannot be detected, it must be marked as ASSUMED and heavily penalized.
@@ -0,0 +1,20 @@
1
+ # REPOSITORY-HEALTH CHECKLIST
2
+
3
+ ## Entry Criteria
4
+ - [ ] Pre Validation complete.
5
+
6
+ ## Execution
7
+ - [ ] Documentation Coverage audited.
8
+ - [ ] Knowledge Coverage audited.
9
+ - [ ] Test Coverage audited.
10
+ - [ ] Traceability Coverage audited.
11
+ - [ ] Dependency Risk audited.
12
+ - [ ] Technical Debt assessed.
13
+ - [ ] Architecture Consistency audited.
14
+ - [ ] Execution Validation complete.
15
+
16
+ ## Exit Criteria / Definition of Done
17
+ - [ ] Post Validation complete.
18
+ - [ ] Repository Health Report generated.
19
+ - [ ] Score and Classification (Excellent to Critical) assigned.
20
+ - [ ] Quality Gate set to PASS.
@@ -0,0 +1,39 @@
1
+ # Executive Summary
2
+ * **Trigger Detected**: N/A. Reason: Populated during skill execution.
3
+ * **Purpose**: N/A. Reason: Populated during skill execution.
4
+
5
+ # Scope
6
+ * **Target**: N/A. Reason: Populated during skill execution.
7
+
8
+ # Knowledge Confidence
9
+ * **Score**: N/A. Reason: Populated during skill execution.
10
+
11
+ # Knowledge Classification
12
+ * **Classification**: N/A. Reason: Populated during skill execution.
13
+
14
+ # Traceability Matrix
15
+ | Layer | File | Function | Notes |
16
+ | ----- | ---- | -------- | ----- |
17
+ | Framework | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. |
18
+
19
+ # Evidence
20
+ * N/A. Reason: Populated during skill execution.
21
+
22
+ # Root Cause
23
+ * N/A. Reason: Populated during skill execution.
24
+
25
+ # Impact
26
+ * N/A. Reason: Populated during skill execution.
27
+
28
+ # Recommendation
29
+ * **Quick Win**: N/A. Reason: Populated during skill execution.
30
+ * **Long Term Improvement**: N/A. Reason: Populated during skill execution.
31
+
32
+ # Quality Gate
33
+ * N/A. Reason: Populated during skill execution.
34
+
35
+ # Enterprise Readiness
36
+ * N/A. Reason: Populated during skill execution.
37
+
38
+ # Final Decision
39
+ N/A. Reason: Populated during skill execution.
@@ -0,0 +1,14 @@
1
+ # REPOSITORY-HEALTH WORKFLOW
2
+
3
+ You MUST execute these explicit steps sequentially:
4
+
5
+ 1. **Pre Validation** (Check if Knowledge exists)
6
+ 2. **Scan Documentation** (Check Readme, Swagger, internal wikis)
7
+ 3. **Scan Knowledge Coverage** (Check `.agent-os/project` integrity)
8
+ 4. **Scan Test Coverage** (Check Jest/Cypress coverage reports)
9
+ 5. **Scan Traceability** (Check missing links in `traceability-analysis`)
10
+ 6. **Scan Dependencies** (Check for CVEs or outdated packages)
11
+ 7. **Scan Architecture** (Check for monolith/microservice consistency)
12
+ 8. **Execution Validation** (Ensure all metrics collected)
13
+ 9. **Generate Repository Health Report**
14
+ 10. **Post Validation** (Verify report conforms to Enterprise standard)
@@ -0,0 +1,83 @@
1
+ # SELENIUM-E2E SKILL
2
+
3
+ ## Purpose
4
+ To execute enterprise-grade automated End-to-End browser tests, capable of autonomously generating comprehensive scenarios from simple user prompts without requiring prior setup by the user.
5
+
6
+ ## Responsibilities
7
+ - Conduct strict Environment Readiness Audits before execution.
8
+ - Perform deep Frontend (FE) Analysis (routes, components, validation).
9
+ - Enforce strict FE-BE Traceability (UI Action -> Component -> API -> DTO -> Entity).
10
+ - Automatically generate robust test scenarios (Happy Path, Validation, Negative Testing, Edge Case).
11
+ - Validate selectors and wait strategies against enterprise standards.
12
+ - Produce standardized, audit-ready Execution Reports.
13
+
14
+ ## Workflow
15
+ Follow the detailed workflow in `workflow.md` for this skill.
16
+
17
+ ## Required Inputs
18
+ A simple prompt indicating the target scope, e.g.:
19
+ ```txt
20
+ TEST: Halaman Request Leave
21
+ - tambah data
22
+ - edit data
23
+ - hapus data
24
+ ```
25
+
26
+ ## Expected Outputs
27
+ Comprehensive execution report covering Test Scenarios, Traceability Matrix, Technical Debt, Root Cause Analysis, and Enterprise Readiness Score.
28
+
29
+ ## Execution Rules
30
+
31
+ ### 1. Environment Detection (MANDATORY)
32
+ **Before any testing**, you MUST audit the environment.
33
+ - **Dependencies**: Check `package.json` for `selenium-webdriver` and `chromedriver`/`geckodriver`. If missing, abort and report:
34
+ ```txt
35
+ STATUS: ENVIRONMENT_NOT_READY
36
+ MISSING:
37
+ - selenium-webdriver
38
+ - chromedriver
39
+ INSTALLATION GUIDE:
40
+ npm install selenium-webdriver
41
+ npm install chromedriver --save-dev
42
+ ```
43
+ - **Browsers**: Verify availability of Google Chrome, Chromium, or Microsoft Edge. Report as blocker if none found.
44
+ - **Test Folder**: Check for `tests/`, `tests/e2e/`, `automation/`, or `e2e/`. Recommend standard structure if missing.
45
+ - **CI/CD**: Check for GitHub Actions, GitLab CI, or Jenkins. Report readiness.
46
+
47
+ ### 2. FE Analysis
48
+ Do not generate tests solely based on UI appearance. You MUST read:
49
+ - Routes and Views
50
+ - Components and Modals
51
+ - Forms (identify required/optional fields)
52
+ - Tables (pagination, search, filter)
53
+ - Validation Rules
54
+
55
+ ### 3. FE-BE Traceability
56
+ You MUST trace the execution flow back to the database layer.
57
+ **Trace Pattern**: `UI Action -> FE Component -> API Client -> Backend Controller -> Service -> DTO -> Entity`.
58
+
59
+ ### 4. Scenario Generation
60
+ You MUST automatically generate the following scenarios:
61
+ - **Happy Path**: View Page, Search, Filter, Create, Edit, Delete.
62
+ - **Validation**: Required Fields, Invalid Formats, Max Length, Duplicate Data.
63
+ - **Negative Testing**: API Errors, Unauthorized, Forbidden, Network Failures.
64
+ - **Edge Case**: Empty Data, Large Data, Slow Responses.
65
+
66
+ ### 5. Selector Validation
67
+ **Audit selectors prioritizing:**
68
+ 1. `data-testid`
69
+ 2. `id`
70
+ 3. `name`
71
+ 4. `aria-label`
72
+ **Forbidden**: Long XPaths, brittle CSS selectors, `nth-child`. Report these as Technical Debt.
73
+
74
+ ### 6. Wait Strategy Validation
75
+ **Audit wait commands:**
76
+ - **Forbidden**: `sleep()`, `setTimeout()`. Report if found.
77
+ - **Required**: Explicit Waits and Expected Conditions.
78
+
79
+ ## Quality Gates
80
+ - Environment Audit passed.
81
+ - Traceability Matrix completed.
82
+ - Scenario Matrix executed.
83
+ - Report generated matching standard template.
@@ -0,0 +1,29 @@
1
+ # SELENIUM-E2E CHECKLIST
2
+
3
+ Before concluding the task, ensure all items are complete:
4
+
5
+ ## 1. Environment Readiness
6
+ - [ ] Checked `package.json` for Selenium dependencies.
7
+ - [ ] Checked for target browsers.
8
+ - [ ] Checked/established standard test folder structure.
9
+ - [ ] Verified CI/CD integration status.
10
+
11
+ ## 2. Analysis & Planning
12
+ - [ ] Conducted FE Analysis (Routes, Components, Validation).
13
+ - [ ] Mapped FE-BE Traceability (UI Action -> Component -> API -> DTO -> Entity).
14
+ - [ ] Generated comprehensive Scenario Matrix (Happy Path, Validation, Negative, Edge Case).
15
+
16
+ ## 3. Scripting & Validation
17
+ - [ ] Wrote scripts using standard structures.
18
+ - [ ] Validated Selectors: Eliminated long XPaths, CSS selectors, `nth-child` in favor of `data-testid`, `id`, `name`.
19
+ - [ ] Validated Waits: Eliminated `sleep()`, `setTimeout()` in favor of explicit waits/expected conditions.
20
+
21
+ ## 4. Execution & Root Cause
22
+ - [ ] Executed tests locally.
23
+ - [ ] Collected Evidence (Screenshots, Console Logs, Network Logs).
24
+ - [ ] Performed deep Root Cause Analysis on failures (FE, BE, API, Data, Env).
25
+
26
+ ## 5. Reporting
27
+ - [ ] Generated standardized `report-template.md`.
28
+ - [ ] Calculated Enterprise Readiness Score (0-100).
29
+ - [ ] Provided Actionable Recommendations (Quick Win, Medium, Long Term).
@@ -0,0 +1,26 @@
1
+ # SELENIUM-E2E EXAMPLES
2
+
3
+ ### Example 1
4
+ ```txt
5
+ TEST: E2E for User Login.
6
+ ```
7
+
8
+ ### Example 2
9
+ ```txt
10
+ TEST: E2E for Checkout process.
11
+ ```
12
+
13
+ ### Example 3
14
+ ```txt
15
+ TEST: Verify 404 page.
16
+ ```
17
+
18
+ ### Example 4
19
+ ```txt
20
+ TEST: Test form validation errors.
21
+ ```
22
+
23
+ ### Example 5
24
+ ```txt
25
+ TEST: E2E for multi-language toggle.
26
+ ```
@@ -0,0 +1,39 @@
1
+ # Executive Summary
2
+ * **Trigger Detected**: N/A. Reason: Populated during skill execution.
3
+ * **Purpose**: N/A. Reason: Populated during skill execution.
4
+
5
+ # Scope
6
+ * **Target**: N/A. Reason: Populated during skill execution.
7
+
8
+ # Knowledge Confidence
9
+ * **Score**: N/A. Reason: Populated during skill execution.
10
+
11
+ # Knowledge Classification
12
+ * **Classification**: N/A. Reason: Populated during skill execution.
13
+
14
+ # Traceability Matrix
15
+ | Layer | File | Function | Notes |
16
+ | ----- | ---- | -------- | ----- |
17
+ | Framework | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. |
18
+
19
+ # Evidence
20
+ * N/A. Reason: Populated during skill execution.
21
+
22
+ # Root Cause
23
+ * N/A. Reason: Populated during skill execution.
24
+
25
+ # Impact
26
+ * N/A. Reason: Populated during skill execution.
27
+
28
+ # Recommendation
29
+ * **Quick Win**: N/A. Reason: Populated during skill execution.
30
+ * **Long Term Improvement**: N/A. Reason: Populated during skill execution.
31
+
32
+ # Quality Gate
33
+ * N/A. Reason: Populated during skill execution.
34
+
35
+ # Enterprise Readiness
36
+ * N/A. Reason: Populated during skill execution.
37
+
38
+ # Final Decision
39
+ N/A. Reason: Populated during skill execution.
@@ -0,0 +1,9 @@
1
+ # Selenium E2E Workflow
2
+
3
+ 1. **Environment Check**: Verify `selenium-webdriver` and `chromedriver` are installed. Verify browser availability. Verify test directory exists. If missing, generate a Setup Guide (`npm install selenium-webdriver chromedriver --save-dev`).
4
+ 2. **Knowledge Retrieval**: Load applicable `.agent-os/knowledge/` (Business Rules, Workflows, Technical).
5
+ 3. **Traceability Mapping**: Trace the test coverage across the unified 10-layer chain.
6
+ 4. **Scenario Generation**: Plan the E2E test scenarios based on business logic.
7
+ 5. **Implementation**: Write the Selenium tests.
8
+ 6. **Execution Validation**: Run the tests and capture failures/screenshots.
9
+ 7. **Final Reporting**: Generate the standard E2E Report Template incorporating Environment Status, Results, and Failures.
@@ -0,0 +1,19 @@
1
+ # SELF-AUDIT SKILL
2
+
3
+ ## Purpose
4
+ To continuously audit Agent OS internal structure against the Enterprise Certification Framework. This skill is responsible for preventing quality regressions.
5
+
6
+ ## Responsibilities
7
+ - Execute all 5 Validators in `.agent-os/validators/`.
8
+ - Verify the Enterprise Traceability Chain.
9
+ - Output the 100-point Enterprise Scorecard.
10
+ - Enforce the "Non Negotiable Rule" for framework regression.
11
+
12
+ ## Workflow
13
+ Follow the detailed workflow in `workflow.md` for this skill.
14
+
15
+ ## Required Inputs
16
+ Minimal Prompting: `AUDIT: Agent OS`
17
+
18
+ ## Expected Outputs
19
+ Agent OS Health Report (incorporating the Enterprise Scorecard).
@@ -0,0 +1,14 @@
1
+ # SELF-AUDIT CHECKLIST
2
+
3
+ ## Entry Criteria
4
+ - [ ] Self Audit trigger detected.
5
+
6
+ ## Execution
7
+ - [ ] All 5 Validator checks executed and PASSED.
8
+ - [ ] Registry Audit PASSED.
9
+ - [ ] README Consistency Validation PASSED.
10
+ - [ ] Enterprise Scorecard calculated.
11
+
12
+ ## Exit Criteria / Definition of Done
13
+ - [ ] Agent OS Health Report generated.
14
+ - [ ] Quality Gate set to PASS.
@@ -0,0 +1,39 @@
1
+ # Executive Summary
2
+ * **Trigger Detected**: N/A. Reason: Populated during skill execution.
3
+ * **Purpose**: N/A. Reason: Populated during skill execution.
4
+
5
+ # Scope
6
+ * **Target**: N/A. Reason: Populated during skill execution.
7
+
8
+ # Knowledge Confidence
9
+ * **Score**: N/A. Reason: Populated during skill execution.
10
+
11
+ # Knowledge Classification
12
+ * **Classification**: N/A. Reason: Populated during skill execution.
13
+
14
+ # Traceability Matrix
15
+ | Layer | File | Function | Notes |
16
+ | ----- | ---- | -------- | ----- |
17
+ | Framework | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. |
18
+
19
+ # Evidence
20
+ * N/A. Reason: Populated during skill execution.
21
+
22
+ # Root Cause
23
+ * N/A. Reason: Populated during skill execution.
24
+
25
+ # Impact
26
+ * N/A. Reason: Populated during skill execution.
27
+
28
+ # Recommendation
29
+ * **Quick Win**: N/A. Reason: Populated during skill execution.
30
+ * **Long Term Improvement**: N/A. Reason: Populated during skill execution.
31
+
32
+ # Quality Gate
33
+ * N/A. Reason: Populated during skill execution.
34
+
35
+ # Enterprise Readiness
36
+ * N/A. Reason: Populated during skill execution.
37
+
38
+ # Final Decision
39
+ N/A. Reason: Populated during skill execution.
@@ -0,0 +1,11 @@
1
+ # Self Audit Workflow
2
+
3
+ 1. **Pre-flight Check**: Parse the self audit request.
4
+ 2. **Validator Execution**: Execute all 5 Validator checks from `.agent-os/validators/`.
5
+ 3. **Skill Coverage Check**: Validate existence of the 6 core V1.0 skills (`project-onboarding`, `audit`, `bug-fix`, `enhancement`, `new-page`, `selenium-e2e`, plus `knowledge-evolution` and `self-audit`).
6
+ 4. **Knowledge Coverage Check**: Evaluate existence of data within `.agent-os/knowledge/`.
7
+ 5. **Template Quality Check**: Sweep all `report-template.md` and `workflow.md` files for legacy placeholders or deviations from the 11-section standard.
8
+ 6. **Traceability Coverage Check**: Verify the 10-layer Traceability Matrix is strictly enforced.
9
+ 7. **Knowledge Structure Check**: Verify `business-rules`, `workflows`, `technical`, and `traceability` folders exist and use the new templates.
10
+ 8. **Report Quality Check**: Validate structure of recent execution reports.
11
+ 9. **Final Reporting**: Generate the Agent OS Health Report and calculate the Readiness Score.