@ryuenn3123/agentic-senior-core 2.5.22 → 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/.agent-context/prompts/init-project.md +5 -5
- package/.agent-context/prompts/refactor.md +2 -1
- package/.agent-context/prompts/review-code.md +3 -2
- package/.agent-context/review-checklists/pr-checklist.md +8 -1
- package/.agent-context/rules/architecture.md +11 -0
- package/.agent-context/rules/frontend-architecture.md +2 -2
- package/.agent-context/state/architecture-map.md +1 -1
- package/.agent-context/state/memory-continuity-benchmark.json +1 -1
- package/.agents/workflows/init-project.md +3 -3
- package/.agents/workflows/refactor.md +1 -1
- package/.agents/workflows/review-code.md +4 -5
- package/.cursorrules +27 -71
- package/.gemini/instructions.md +6 -7
- package/.github/copilot-instructions.md +5 -6
- package/.windsurfrules +27 -71
- package/AGENTS.md +7 -9
- package/CONTRIBUTING.md +18 -31
- package/README.md +21 -4
- package/bin/agentic-senior-core.js +0 -6
- package/lib/cli/commands/init.mjs +113 -650
- package/lib/cli/commands/launch.mjs +1 -23
- package/lib/cli/commands/rollback.mjs +1 -1
- package/lib/cli/commands/upgrade.mjs +1 -23
- package/lib/cli/compiler.mjs +77 -72
- package/lib/cli/constants.mjs +84 -26
- package/lib/cli/init-architecture-flow.mjs +231 -0
- package/lib/cli/init-detection-flow.mjs +123 -0
- package/lib/cli/init-options.mjs +344 -0
- package/lib/cli/init-selection.mjs +100 -0
- package/lib/cli/preflight.mjs +1 -1
- package/lib/cli/profile-packs.mjs +15 -1
- package/lib/cli/project-scaffolder.mjs +18 -154
- package/lib/cli/utils.mjs +16 -12
- package/mcp.json +19 -19
- package/package.json +5 -2
- package/scripts/context-triggered-audit.mjs +18 -18
- package/scripts/documentation-boundary-audit.mjs +92 -5
- package/scripts/forbidden-content-check.mjs +1 -1
- package/scripts/frontend-usability-audit.mjs +21 -28
- package/scripts/governance-weekly-report.mjs +29 -15
- package/scripts/llm-judge.mjs +2 -5
- package/scripts/mcp-server.mjs +389 -5
- package/scripts/release-gate.mjs +121 -145
- package/scripts/sync-thin-adapters.mjs +161 -0
- package/scripts/v3-purge-audit.mjs +231 -0
- package/scripts/validate-evidence-bundle.mjs +1 -1
- package/scripts/validate.mjs +224 -272
- package/.agent-context/blueprints/api-nextjs.md +0 -184
- package/.agent-context/blueprints/aspnet-api.md +0 -247
- package/.agent-context/blueprints/ci-github-actions.md +0 -226
- package/.agent-context/blueprints/ci-gitlab.md +0 -200
- package/.agent-context/blueprints/fastapi-service.md +0 -210
- package/.agent-context/blueprints/go-service.md +0 -217
- package/.agent-context/blueprints/graphql-grpc-api.md +0 -51
- package/.agent-context/blueprints/infrastructure-as-code.md +0 -62
- package/.agent-context/blueprints/kubernetes-manifests.md +0 -76
- package/.agent-context/blueprints/laravel-api.md +0 -233
- package/.agent-context/blueprints/mobile-app.md +0 -91
- package/.agent-context/blueprints/nestjs-logic.md +0 -247
- package/.agent-context/blueprints/observability.md +0 -227
- package/.agent-context/blueprints/spring-boot-api.md +0 -218
- package/.agent-context/profiles/platform.md +0 -13
- package/.agent-context/profiles/regulated.md +0 -13
- package/.agent-context/profiles/startup.md +0 -13
- package/.agent-context/review-checklists/frontend-excellence-rubric.md +0 -73
- package/.agent-context/review-checklists/frontend-skill-parity.md +0 -29
- package/.agent-context/review-checklists/frontend-usability.md +0 -35
- package/.agent-context/review-checklists/marketplace-acceptance.md +0 -60
- package/.agent-context/review-checklists/performance-audit.md +0 -71
- package/.agent-context/review-checklists/release-operations.md +0 -33
- package/.agent-context/review-checklists/security-audit.md +0 -119
- package/.agent-context/skills/README.md +0 -63
- package/.agent-context/skills/backend/README.md +0 -68
- package/.agent-context/skills/backend/architecture.md +0 -361
- package/.agent-context/skills/backend/compatibility-manifest.json +0 -8
- package/.agent-context/skills/backend/data-access.md +0 -231
- package/.agent-context/skills/backend/errors.md +0 -138
- package/.agent-context/skills/backend/validation.md +0 -117
- package/.agent-context/skills/backend.md +0 -29
- package/.agent-context/skills/cli/.evidence/compatibility-manifest.json +0 -5
- package/.agent-context/skills/cli/.evidence/sbom-excerpt.json +0 -10
- package/.agent-context/skills/cli/.evidence/test-report.json +0 -8
- package/.agent-context/skills/cli/CHANGELOG.md +0 -6
- package/.agent-context/skills/cli/README.md +0 -56
- package/.agent-context/skills/cli/compatibility-manifest.json +0 -8
- package/.agent-context/skills/cli/init.md +0 -38
- package/.agent-context/skills/cli/output.md +0 -36
- package/.agent-context/skills/cli/package.json +0 -5
- package/.agent-context/skills/cli/safety-telemetry.md +0 -39
- package/.agent-context/skills/cli/tests/.gitkeep +0 -1
- package/.agent-context/skills/cli/upgrade.md +0 -38
- package/.agent-context/skills/cli.md +0 -32
- package/.agent-context/skills/distribution/.evidence/compatibility-manifest.json +0 -9
- package/.agent-context/skills/distribution/.evidence/sbom-excerpt.json +0 -6
- package/.agent-context/skills/distribution/.evidence/test-report.json +0 -8
- package/.agent-context/skills/distribution/CHANGELOG.md +0 -7
- package/.agent-context/skills/distribution/README.md +0 -27
- package/.agent-context/skills/distribution/compatibility-manifest.json +0 -8
- package/.agent-context/skills/distribution/compatibility.md +0 -32
- package/.agent-context/skills/distribution/package.json +0 -5
- package/.agent-context/skills/distribution/provenance-attestation.md +0 -47
- package/.agent-context/skills/distribution/publish.md +0 -37
- package/.agent-context/skills/distribution/rollback.md +0 -32
- package/.agent-context/skills/distribution/tests/.gitkeep +0 -1
- package/.agent-context/skills/distribution.md +0 -32
- package/.agent-context/skills/frontend/.evidence/compatibility-manifest.json +0 -9
- package/.agent-context/skills/frontend/.evidence/sbom-excerpt.json +0 -6
- package/.agent-context/skills/frontend/.evidence/test-report.json +0 -8
- package/.agent-context/skills/frontend/CHANGELOG.md +0 -7
- package/.agent-context/skills/frontend/README.md +0 -50
- package/.agent-context/skills/frontend/accessibility.md +0 -107
- package/.agent-context/skills/frontend/compatibility-manifest.json +0 -8
- package/.agent-context/skills/frontend/conversion-clarity.md +0 -51
- package/.agent-context/skills/frontend/motion.md +0 -67
- package/.agent-context/skills/frontend/package.json +0 -5
- package/.agent-context/skills/frontend/performance.md +0 -63
- package/.agent-context/skills/frontend/responsive-delivery.md +0 -41
- package/.agent-context/skills/frontend/tests/.gitkeep +0 -1
- package/.agent-context/skills/frontend/ui-architecture.md +0 -128
- package/.agent-context/skills/frontend.md +0 -40
- package/.agent-context/skills/fullstack/.evidence/compatibility-manifest.json +0 -9
- package/.agent-context/skills/fullstack/.evidence/sbom-excerpt.json +0 -6
- package/.agent-context/skills/fullstack/.evidence/test-report.json +0 -8
- package/.agent-context/skills/fullstack/CHANGELOG.md +0 -7
- package/.agent-context/skills/fullstack/README.md +0 -27
- package/.agent-context/skills/fullstack/compatibility-manifest.json +0 -8
- package/.agent-context/skills/fullstack/contracts.md +0 -53
- package/.agent-context/skills/fullstack/end-to-end.md +0 -42
- package/.agent-context/skills/fullstack/feature-slicing.md +0 -65
- package/.agent-context/skills/fullstack/package.json +0 -5
- package/.agent-context/skills/fullstack/release-coordination.md +0 -51
- package/.agent-context/skills/fullstack/tests/.gitkeep +0 -1
- package/.agent-context/skills/fullstack.md +0 -30
- package/.agent-context/skills/index.json +0 -107
- package/.agent-context/skills/review-quality/.evidence/compatibility-manifest.json +0 -9
- package/.agent-context/skills/review-quality/.evidence/sbom-excerpt.json +0 -6
- package/.agent-context/skills/review-quality/.evidence/test-report.json +0 -8
- package/.agent-context/skills/review-quality/CHANGELOG.md +0 -7
- package/.agent-context/skills/review-quality/README.md +0 -27
- package/.agent-context/skills/review-quality/benchmark.md +0 -30
- package/.agent-context/skills/review-quality/compatibility-manifest.json +0 -8
- package/.agent-context/skills/review-quality/package.json +0 -5
- package/.agent-context/skills/review-quality/planning.md +0 -38
- package/.agent-context/skills/review-quality/release-decision.md +0 -49
- package/.agent-context/skills/review-quality/security.md +0 -34
- package/.agent-context/skills/review-quality/tests/.gitkeep +0 -1
- package/.agent-context/skills/review-quality.md +0 -34
- package/.agent-context/stacks/csharp.md +0 -149
- package/.agent-context/stacks/flutter.md +0 -16
- package/.agent-context/stacks/go.md +0 -181
- package/.agent-context/stacks/java.md +0 -135
- package/.agent-context/stacks/php.md +0 -192
- package/.agent-context/stacks/python.md +0 -153
- package/.agent-context/stacks/react-native.md +0 -16
- package/.agent-context/stacks/ruby.md +0 -80
- package/.agent-context/stacks/rust.md +0 -86
- package/.agent-context/stacks/typescript.md +0 -317
- package/.agent-context/state/skill-platform.json +0 -38
- package/lib/cli/skill-selector.mjs +0 -232
- package/lib/cli/templates/api-contract.md.id.tmpl +0 -143
- package/lib/cli/templates/api-contract.md.tmpl +0 -143
- package/lib/cli/templates/architecture-decision-record.md.id.tmpl +0 -106
- package/lib/cli/templates/architecture-decision-record.md.tmpl +0 -145
- package/lib/cli/templates/database-schema.md.id.tmpl +0 -74
- package/lib/cli/templates/database-schema.md.tmpl +0 -74
- package/lib/cli/templates/flow-overview.md.id.tmpl +0 -118
- package/lib/cli/templates/flow-overview.md.tmpl +0 -131
- package/lib/cli/templates/project-brief.md.id.tmpl +0 -55
- package/lib/cli/templates/project-brief.md.tmpl +0 -79
- package/scripts/init-project.ps1 +0 -105
- package/scripts/init-project.sh +0 -131
- package/scripts/skill-tier-policy.mjs +0 -76
- package/scripts/trust-scorer.mjs +0 -119
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
# Team Profile Pack: Regulated
|
|
2
|
-
|
|
3
|
-
slug: regulated
|
|
4
|
-
displayName: Regulated Team
|
|
5
|
-
description: Compliance-first defaults with strict policy and locked CI guardrails.
|
|
6
|
-
defaultProfile: strict
|
|
7
|
-
defaultStack: typescript.md
|
|
8
|
-
defaultBlueprint: api-nextjs.md
|
|
9
|
-
ciGuardrails: true
|
|
10
|
-
lockCi: true
|
|
11
|
-
blockingSeverities: critical, high, medium
|
|
12
|
-
owner: governance-office
|
|
13
|
-
lastUpdated: 2026-03-19
|
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
# Team Profile Pack: Startup
|
|
2
|
-
|
|
3
|
-
slug: startup
|
|
4
|
-
displayName: Startup Team
|
|
5
|
-
description: Fast iteration with balanced guardrails and quick onboarding defaults.
|
|
6
|
-
defaultProfile: balanced
|
|
7
|
-
defaultStack: typescript.md
|
|
8
|
-
defaultBlueprint: api-nextjs.md
|
|
9
|
-
ciGuardrails: true
|
|
10
|
-
lockCi: false
|
|
11
|
-
blockingSeverities: critical, high
|
|
12
|
-
owner: product-engineering
|
|
13
|
-
lastUpdated: 2026-03-19
|
|
@@ -1,73 +0,0 @@
|
|
|
1
|
-
# Frontend Excellence Rubric (Designer-Grade)
|
|
2
|
-
|
|
3
|
-
Use this rubric to prevent template-like UI output and enforce intentional product design quality.
|
|
4
|
-
|
|
5
|
-
## Scoring Model
|
|
6
|
-
|
|
7
|
-
Score each dimension from 1 to 5.
|
|
8
|
-
- 1: weak or generic quality
|
|
9
|
-
- 3: acceptable production baseline
|
|
10
|
-
- 5: standout quality comparable to top manual design teams
|
|
11
|
-
|
|
12
|
-
Release recommendation:
|
|
13
|
-
- Minimum average score: 4.0
|
|
14
|
-
- No dimension below: 3
|
|
15
|
-
|
|
16
|
-
## 1. Visual Direction and Identity
|
|
17
|
-
- [ ] The page has a clear visual direction, not a generic starter layout.
|
|
18
|
-
- [ ] Composition, rhythm, and hierarchy feel intentional across sections.
|
|
19
|
-
- [ ] The output avoids obvious design-template repetition.
|
|
20
|
-
|
|
21
|
-
## 2. Typography Quality
|
|
22
|
-
- [ ] Font pairing is intentional and role-based (display, body, utility).
|
|
23
|
-
- [ ] Type scale is coherent across mobile and desktop.
|
|
24
|
-
- [ ] Line length, spacing, and emphasis improve readability and scanning.
|
|
25
|
-
|
|
26
|
-
## 3. Color System Diversity and Contrast
|
|
27
|
-
- [ ] Color palette is purposeful, with semantic roles and contrast-safe pairings.
|
|
28
|
-
- [ ] The result is not a default AI palette or copied trendy scheme without adaptation.
|
|
29
|
-
- [ ] Accent usage supports product intent and interaction priority.
|
|
30
|
-
|
|
31
|
-
## 4. Interaction Choreography
|
|
32
|
-
- [ ] Motion supports comprehension and hierarchy, not decorative noise.
|
|
33
|
-
- [ ] Entrance and transition timing are consistent and measured.
|
|
34
|
-
- [ ] Reduced-motion fallback preserves usability.
|
|
35
|
-
|
|
36
|
-
## 5. Responsiveness and Layout Intelligence
|
|
37
|
-
- [ ] Mobile layout is designed, not desktop squeezed into a narrow viewport.
|
|
38
|
-
- [ ] Breakpoint transitions preserve hierarchy, spacing rhythm, and action clarity.
|
|
39
|
-
- [ ] Navigation and key CTA remain explicit across viewport sizes.
|
|
40
|
-
|
|
41
|
-
## 6. Language and Content Consistency
|
|
42
|
-
- [ ] Content language is consistent across headline, body, CTA, and system messages for the same screen flow.
|
|
43
|
-
- [ ] Mixed-language output appears only when requested by user or product requirement.
|
|
44
|
-
- [ ] Terminology stays stable for repeated actions and labels.
|
|
45
|
-
|
|
46
|
-
## 7. Text Contrast and Collision Safety
|
|
47
|
-
- [ ] Text-to-background contrast is checked for every semantic token pair used in UI.
|
|
48
|
-
- [ ] No text color clashes with gradients, images, or accent surfaces.
|
|
49
|
-
- [ ] Primary and secondary text remain readable in all supported breakpoints.
|
|
50
|
-
|
|
51
|
-
## 8. UX Narrative and Conversion Clarity
|
|
52
|
-
- [ ] First viewport communicates value proposition and primary action immediately.
|
|
53
|
-
- [ ] Error, empty, and loading states provide clear next actions.
|
|
54
|
-
- [ ] User journey avoids dead ends and hidden critical actions.
|
|
55
|
-
|
|
56
|
-
## 9. Template Diversity and Originality
|
|
57
|
-
- [ ] Output is not a copy of a generic starter template or repeated AI layout pattern.
|
|
58
|
-
- [ ] Layout composition shows intentional variation in structure and hierarchy.
|
|
59
|
-
- [ ] Visual intent, interaction quality, and conversion clarity are all explicitly reviewed together.
|
|
60
|
-
|
|
61
|
-
## Low-Diversity Template Output Policy
|
|
62
|
-
- If output is judged as low-diversity template output, release is blocked until layout direction is revised.
|
|
63
|
-
- Reviewer must record the failing dimensions and expected redesign direction before re-run.
|
|
64
|
-
|
|
65
|
-
## Benchmark Expectation
|
|
66
|
-
- Treat MiniMax frontend references as baseline, not target ceiling.
|
|
67
|
-
- Target visual and interaction quality aligned with top award-grade manual design workflows (Awwwards-level reference quality).
|
|
68
|
-
- Prefer original composition and branded design systems over template cloning.
|
|
69
|
-
|
|
70
|
-
## Evidence for Release
|
|
71
|
-
- [ ] Rubric scorecard attached to release artifact.
|
|
72
|
-
- [ ] Screenshot set across key breakpoints attached.
|
|
73
|
-
- [ ] Accessibility and performance evidence attached alongside rubric score.
|
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
# Frontend Skill Parity Checklist
|
|
2
|
-
|
|
3
|
-
Use this checklist to enforce mandatory frontend parity aligned with benchmark-driven standards from `MiniMax-AI/skills` `frontend-dev` profile.
|
|
4
|
-
|
|
5
|
-
## Architecture and Composition
|
|
6
|
-
- [ ] Frontend structure follows feature-driven organization.
|
|
7
|
-
- [ ] Smart and dumb component separation is explicit and documented.
|
|
8
|
-
- [ ] Server state and client state boundaries are documented and enforced.
|
|
9
|
-
|
|
10
|
-
## Interaction and Motion
|
|
11
|
-
- [ ] Primary user journey includes intentional animation without motion overload.
|
|
12
|
-
- [ ] Reduced-motion fallback behavior is implemented and documented.
|
|
13
|
-
- [ ] Transition timing and easing are consistent across key screens.
|
|
14
|
-
|
|
15
|
-
## Accessibility and Responsiveness
|
|
16
|
-
- [ ] Keyboard navigation works on all critical flows.
|
|
17
|
-
- [ ] Contrast, typography scale, and focus visibility pass baseline checks.
|
|
18
|
-
- [ ] Layout behavior is validated across mobile and desktop breakpoints.
|
|
19
|
-
|
|
20
|
-
## UX Narrative and Conversion Clarity
|
|
21
|
-
- [ ] Page hierarchy communicates value proposition within first viewport.
|
|
22
|
-
- [ ] Primary calls to action are explicit and consistently placed.
|
|
23
|
-
- [ ] Error and empty states contain actionable guidance.
|
|
24
|
-
|
|
25
|
-
## Release Evidence
|
|
26
|
-
- [ ] Frontend parity checklist artifact is attached to release evidence.
|
|
27
|
-
- [ ] Frontend usability audit report is attached to release evidence.
|
|
28
|
-
- [ ] Frontend excellence rubric scorecard is attached to release evidence.
|
|
29
|
-
- [ ] Any parity waiver includes owner, expiry, and risk statement.
|
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
# Frontend Usability Checklist — V1.7 Gate
|
|
2
|
-
|
|
3
|
-
Run this checklist before claiming frontend work is production-ready.
|
|
4
|
-
|
|
5
|
-
## 1. Visual System
|
|
6
|
-
- [ ] Typography scale is consistent and tokenized.
|
|
7
|
-
- [ ] Color usage follows design tokens and avoids ad-hoc values.
|
|
8
|
-
- [ ] Spacing and layout rhythm is coherent across pages.
|
|
9
|
-
- [ ] Language and terminology stay consistent across headline, body, and CTA for the same flow.
|
|
10
|
-
|
|
11
|
-
## 2. Responsiveness
|
|
12
|
-
- [ ] Core pages are usable at mobile, tablet, and desktop breakpoints.
|
|
13
|
-
- [ ] Navigation remains accessible and understandable on small screens.
|
|
14
|
-
- [ ] No content overlap, clipped text, or horizontal scroll regressions.
|
|
15
|
-
|
|
16
|
-
## 3. Accessibility
|
|
17
|
-
- [ ] Keyboard-only navigation covers all critical user paths.
|
|
18
|
-
- [ ] Primary text and actionable controls meet WCAG AA contrast.
|
|
19
|
-
- [ ] Reduced-motion mode is respected for non-essential animations.
|
|
20
|
-
|
|
21
|
-
## 4. Interaction Quality
|
|
22
|
-
- [ ] Motion is meaningful, not decorative noise.
|
|
23
|
-
- [ ] Loading, empty, and error states are explicitly designed.
|
|
24
|
-
- [ ] CTA hierarchy is clear and supports user intent.
|
|
25
|
-
|
|
26
|
-
## 5. Performance and Stability
|
|
27
|
-
- [ ] Lighthouse mobile performance target is met on core pages.
|
|
28
|
-
- [ ] No severe layout shift during load and transition.
|
|
29
|
-
- [ ] Visual regression checks cover protected pages.
|
|
30
|
-
|
|
31
|
-
## 6. Documentation and Release Evidence
|
|
32
|
-
- [ ] Frontend architecture decision is documented.
|
|
33
|
-
- [ ] Visual baseline update process is documented.
|
|
34
|
-
- [ ] Release note includes usability and responsiveness evidence.
|
|
35
|
-
- [ ] Frontend excellence rubric scorecard is attached with release evidence.
|
|
@@ -1,60 +0,0 @@
|
|
|
1
|
-
# Marketplace Acceptance Checklist
|
|
2
|
-
|
|
3
|
-
Use this checklist to evaluate marketplace artifact submissions. Every gate must be verified before assigning a trust tier.
|
|
4
|
-
|
|
5
|
-
## Tier Assignment Rule
|
|
6
|
-
|
|
7
|
-
- **Verified**: all 20 gates pass, composite score >= 85
|
|
8
|
-
- **Community**: gates 1-4 pass, composite score >= 50
|
|
9
|
-
- **Experimental**: gate 1 passes, composite score >= 0
|
|
10
|
-
- **Rejected**: gate 1 fails or forbidden content detected
|
|
11
|
-
|
|
12
|
-
## Documentation (25%)
|
|
13
|
-
|
|
14
|
-
- [ ] 1. README.md exists and contains at least 200 characters of non-boilerplate content
|
|
15
|
-
- [ ] 2. README includes a usage example or getting-started section
|
|
16
|
-
- [ ] 3. README includes an API or configuration reference
|
|
17
|
-
- [ ] 4. License declaration is present (LICENSE file or header)
|
|
18
|
-
- [ ] 5. No placeholder-only content (no files that are entirely TODO or stub)
|
|
19
|
-
|
|
20
|
-
## Tests (25%)
|
|
21
|
-
|
|
22
|
-
- [ ] 6. At least one test file exists in a recognized test directory
|
|
23
|
-
- [ ] 7. All tests pass without errors when executed
|
|
24
|
-
- [ ] 8. Core exported functions have corresponding test cases
|
|
25
|
-
- [ ] 9. No skipped or disabled tests in critical code paths
|
|
26
|
-
- [ ] 10. Test execution command is documented in README or package metadata
|
|
27
|
-
|
|
28
|
-
## Evidence (25%)
|
|
29
|
-
|
|
30
|
-
- [ ] 11. Evidence bundle directory exists at artifact root (e.g. `evidence/` or `.evidence/`)
|
|
31
|
-
- [ ] 12. Compatibility manifest is present declaring supported runtimes and IDE versions
|
|
32
|
-
- [ ] 13. Validation report from the most recent CI run is present
|
|
33
|
-
- [ ] 14. Dependency list or SBOM excerpt is present
|
|
34
|
-
- [ ] 15. Evidence files are current (updated within the tier's maxDaysSinceUpdate threshold)
|
|
35
|
-
|
|
36
|
-
## Maintenance (25%)
|
|
37
|
-
|
|
38
|
-
- [ ] 16. Last meaningful update is within the tier's maxDaysSinceUpdate threshold
|
|
39
|
-
- [ ] 17. CHANGELOG.md exists with at least one entry for the current major version
|
|
40
|
-
- [ ] 18. No known critical or high-severity vulnerabilities in direct dependencies
|
|
41
|
-
- [ ] 19. Version follows semantic versioning (MAJOR.MINOR.PATCH)
|
|
42
|
-
- [ ] 20. Owner or maintainer is declared in package metadata or README
|
|
43
|
-
|
|
44
|
-
## Security (Mandatory, All Tiers)
|
|
45
|
-
|
|
46
|
-
- [ ] Forbidden content scan passes (no hardcoded secrets, API keys, or private paths)
|
|
47
|
-
- [ ] No `eval()` or dynamic code execution in published assets
|
|
48
|
-
- [ ] No network calls to undeclared external endpoints
|
|
49
|
-
|
|
50
|
-
## Scoring Notes
|
|
51
|
-
|
|
52
|
-
Composite score is calculated as:
|
|
53
|
-
|
|
54
|
-
```
|
|
55
|
-
score = (doc_score * 0.25) + (test_score * 0.25) + (evidence_score * 0.25) + (maintenance_score * 0.25)
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
Each dimension score is: (gates_passed / total_gates_in_dimension) * 100
|
|
59
|
-
|
|
60
|
-
Tier thresholds are defined in `.agent-context/marketplace/trust-tiers.json`.
|
|
@@ -1,71 +0,0 @@
|
|
|
1
|
-
# Performance Audit Checklist
|
|
2
|
-
|
|
3
|
-
> Run this on any code path that handles data, queries, or network requests.
|
|
4
|
-
> Performance problems are architectural — they don't fix themselves.
|
|
5
|
-
|
|
6
|
-
## Instructions for Agent
|
|
7
|
-
|
|
8
|
-
Evaluate every item below. For each finding, rate impact:
|
|
9
|
-
- **CRITICAL** — Will cause outage or severe degradation under normal load
|
|
10
|
-
- **HIGH** — Will degrade at scale, fix before production traffic
|
|
11
|
-
- **MEDIUM** — Wasted resources, fix in this sprint
|
|
12
|
-
- **LOW** — Optimization opportunity, track for later
|
|
13
|
-
|
|
14
|
-
## Context Trigger Policy
|
|
15
|
-
|
|
16
|
-
- Strict performance audit auto-runs for review requests, PR-intent workflows, and major feature completion.
|
|
17
|
-
- Small edits default to lightweight mode unless strict mode is explicitly forced.
|
|
18
|
-
- User can force strict mode manually at any time.
|
|
19
|
-
|
|
20
|
-
---
|
|
21
|
-
|
|
22
|
-
## Database & Queries
|
|
23
|
-
|
|
24
|
-
- [ ] **No N+1 queries** — No database queries inside loops. Use eager loading or joins.
|
|
25
|
-
- [ ] **No unbounded queries** — Every list query has LIMIT / pagination
|
|
26
|
-
- [ ] **No `SELECT *`** — Only select columns that are actually needed
|
|
27
|
-
- [ ] **Indexes exist for frequently queried columns** — WHERE, JOIN, ORDER BY columns
|
|
28
|
-
- [ ] **Composite indexes match query patterns** — Column order matters
|
|
29
|
-
- [ ] **No unnecessary COUNT(*)** — Use EXISTS for existence checks
|
|
30
|
-
- [ ] **Bulk operations used** — insertAll/updateAll instead of loops for batch work
|
|
31
|
-
- [ ] **Connection pool configured** — Not creating new connections per request
|
|
32
|
-
- [ ] **Query execution time logged** — Slow query detection enabled (> 200ms threshold)
|
|
33
|
-
|
|
34
|
-
## I/O & Network
|
|
35
|
-
|
|
36
|
-
- [ ] **No synchronous I/O in async context** — No blocking calls in event-loop code
|
|
37
|
-
- [ ] **HTTP requests have timeouts** — Connect (5s) and read (30s) timeouts configured
|
|
38
|
-
- [ ] **Parallel requests when independent** — Use Promise.all / asyncio.gather
|
|
39
|
-
- [ ] **Retry with backoff** — Network calls retry with exponential backoff + jitter
|
|
40
|
-
- [ ] **Response streaming for large data** — Don't buffer entire response in memory
|
|
41
|
-
- [ ] **File uploads size-limited** — Max upload size configured at server level
|
|
42
|
-
|
|
43
|
-
## Caching
|
|
44
|
-
|
|
45
|
-
- [ ] **Cache has invalidation strategy** — If cache exists, invalidation is documented
|
|
46
|
-
- [ ] **TTL is reasonable** — Not too long (stale data), not too short (no benefit)
|
|
47
|
-
- [ ] **Cache stampede prevented** — Locking or staggered TTL for popular keys
|
|
48
|
-
- [ ] **Cache key includes relevant context** — User ID, locale, version where needed
|
|
49
|
-
- [ ] **No caching of user-specific data in shared cache** — Privacy and correctness
|
|
50
|
-
|
|
51
|
-
## Memory
|
|
52
|
-
|
|
53
|
-
- [ ] **No unbounded in-memory collections** — Arrays/lists don't grow without limit
|
|
54
|
-
- [ ] **Streaming for large datasets** — Cursor/stream instead of loading all into memory
|
|
55
|
-
- [ ] **No memory leaks** — Event listeners cleaned up, intervals cleared, no circular refs
|
|
56
|
-
- [ ] **Resource cleanup** — File handles, DB connections, HTTP clients properly closed
|
|
57
|
-
|
|
58
|
-
## Frontend Performance (If Applicable)
|
|
59
|
-
|
|
60
|
-
- [ ] **No unnecessary re-renders** — Memoization where component receives same props
|
|
61
|
-
- [ ] **Images optimized** — Proper format (WebP), lazy loading, responsive sizes
|
|
62
|
-
- [ ] **Bundle size checked** — No 500KB library for a 5-function use case
|
|
63
|
-
- [ ] **API calls deduplicated** — Same data not fetched multiple times in same render
|
|
64
|
-
- [ ] **Pagination/virtualization for long lists** — Not rendering 10,000 DOM nodes
|
|
65
|
-
|
|
66
|
-
## General
|
|
67
|
-
|
|
68
|
-
- [ ] **No premature optimization** — Changes based on evidence, not assumptions
|
|
69
|
-
- [ ] **Hot paths identified** — Critical user-facing paths are optimized first
|
|
70
|
-
- [ ] **Compression enabled** — gzip/brotli for HTTP responses
|
|
71
|
-
- [ ] **Rate limiting configured** — API endpoints have request limits
|
|
@@ -1,33 +0,0 @@
|
|
|
1
|
-
# Release Operations Checklist (V1.8)
|
|
2
|
-
|
|
3
|
-
Use this checklist before promoting any release tag or package publish operation.
|
|
4
|
-
|
|
5
|
-
## 0) Terminology Boundary (Compliance and Audit)
|
|
6
|
-
- Compliance and audit artifacts keep the canonical enterprise term: `Federated Governance`.
|
|
7
|
-
- Developer-facing aliases are allowed outside compliance artifacts when first mention includes the canonical term in parentheses.
|
|
8
|
-
|
|
9
|
-
## 1) Versioning and Changelog Integrity
|
|
10
|
-
- `package.json` version is valid semantic version (`x.y.z`).
|
|
11
|
-
- `CHANGELOG.md` has a matching release header for the package version.
|
|
12
|
-
- `docs/roadmap.md` reflects release status and scope for the current milestone.
|
|
13
|
-
|
|
14
|
-
## 2) Quality Gates and Test Evidence
|
|
15
|
-
- `npm run validate` passes with zero failures.
|
|
16
|
-
- `npm run test` passes on the full suite.
|
|
17
|
-
- Frontend governance gate (`npm run audit:frontend-usability`) passes.
|
|
18
|
-
- Release governance gate (`npm run gate:release`) passes.
|
|
19
|
-
|
|
20
|
-
## 3) Supply Chain and Compliance Evidence
|
|
21
|
-
- SBOM is generated with `npm run sbom:generate`.
|
|
22
|
-
- CI uploads SBOM artifact for retention and audit traceability.
|
|
23
|
-
- CI uploads release-gate report artifact for each run.
|
|
24
|
-
|
|
25
|
-
## 4) Security and Override Governance
|
|
26
|
-
- `.agent-override.md` entries have valid `Owner` and `Expiry` metadata.
|
|
27
|
-
- No expired overrides remain active.
|
|
28
|
-
- Any temporary exception has explicit rollback owner and date.
|
|
29
|
-
|
|
30
|
-
## 5) Publish Readiness
|
|
31
|
-
- Release notes summarize scope, risks, and rollback steps.
|
|
32
|
-
- Required GitHub workflows are green on target commit.
|
|
33
|
-
- Tag and publish command are executed only after all checks pass.
|
|
@@ -1,119 +0,0 @@
|
|
|
1
|
-
# Security Audit Checklist — OWASP-Aligned
|
|
2
|
-
|
|
3
|
-
> Run this on any code that handles authentication, authorization,
|
|
4
|
-
> user input, or external data. When in doubt, run it anyway.
|
|
5
|
-
|
|
6
|
-
## Instructions for Agent
|
|
7
|
-
|
|
8
|
-
Evaluate every item below against the current code. For each finding, rate severity:
|
|
9
|
-
- 🔴 **CRITICAL** — Exploitable now, must fix before deploy
|
|
10
|
-
- 🟠 **HIGH** — Likely exploitable, fix in this PR
|
|
11
|
-
- 🟡 **MEDIUM** — Potential risk, fix before production
|
|
12
|
-
- 🟢 **LOW** — Minor, fix when convenient
|
|
13
|
-
|
|
14
|
-
Output format:
|
|
15
|
-
```
|
|
16
|
-
## SECURITY AUDIT RESULTS
|
|
17
|
-
━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
18
|
-
|
|
19
|
-
🔴 CRITICAL: [finding title]
|
|
20
|
-
Location: [file:line]
|
|
21
|
-
Risk: [what an attacker could do]
|
|
22
|
-
Fix: [specific remediation]
|
|
23
|
-
|
|
24
|
-
VERDICT: X findings (🔴 N critical, 🟠 N high, 🟡 N medium, 🟢 N low)
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
## Context Trigger Policy
|
|
28
|
-
|
|
29
|
-
- Strict security audit auto-runs for review requests, PR-intent workflows, and major feature completion.
|
|
30
|
-
- Small edits default to lightweight mode unless strict mode is explicitly forced.
|
|
31
|
-
- User can force strict mode manually at any time.
|
|
32
|
-
|
|
33
|
-
---
|
|
34
|
-
|
|
35
|
-
## A1: Injection (SQL, NoSQL, OS, LDAP)
|
|
36
|
-
|
|
37
|
-
- [ ] No string concatenation in SQL queries → use parameterized queries
|
|
38
|
-
- [ ] No string interpolation in OS commands → use argument arrays
|
|
39
|
-
- [ ] No raw user input in regex → escape or use validated patterns
|
|
40
|
-
- [ ] ORM/query builder used correctly (no raw queries with user input)
|
|
41
|
-
- [ ] No `eval()`, `new Function()`, or `exec()` with user-controlled input
|
|
42
|
-
|
|
43
|
-
## A2: Broken Authentication
|
|
44
|
-
|
|
45
|
-
- [ ] Passwords hashed with bcrypt (cost ≥ 12) or argon2
|
|
46
|
-
- [ ] No MD5, SHA1, or SHA256 for password hashing
|
|
47
|
-
- [ ] Rate limiting on login endpoints (max 5 per minute per IP)
|
|
48
|
-
- [ ] Session tokens are cryptographically random (≥ 256 bits)
|
|
49
|
-
- [ ] JWT tokens have reasonable expiration (≤ 15 min for access, ≤ 7 days refresh)
|
|
50
|
-
- [ ] Refresh token rotation implemented (invalidate old token on use)
|
|
51
|
-
- [ ] Password reset tokens are single-use and time-limited (≤ 1 hour)
|
|
52
|
-
|
|
53
|
-
## A3: Sensitive Data Exposure
|
|
54
|
-
|
|
55
|
-
- [ ] No secrets in source code (API keys, passwords, tokens)
|
|
56
|
-
- [ ] No secrets in git history (check with `git log -p | grep -i secret`)
|
|
57
|
-
- [ ] Sensitive fields excluded from API responses (password, tokens, internal IDs)
|
|
58
|
-
- [ ] Sensitive fields excluded from logs (passwords, tokens, PII)
|
|
59
|
-
- [ ] HTTPS enforced (HSTS header present)
|
|
60
|
-
- [ ] Sensitive cookies have `Secure`, `HttpOnly`, `SameSite` flags
|
|
61
|
-
|
|
62
|
-
## A4: Broken Access Control
|
|
63
|
-
|
|
64
|
-
- [ ] Authorization enforced server-side (not just client-side UI hiding)
|
|
65
|
-
- [ ] Resource ownership verified (user can only access their own data)
|
|
66
|
-
- [ ] Default deny — if no rule grants access, deny
|
|
67
|
-
- [ ] Admin endpoints require admin role verification
|
|
68
|
-
- [ ] No direct object reference without access check (IDOR prevention)
|
|
69
|
-
- [ ] CORS configured with specific origins (not `*`)
|
|
70
|
-
- [ ] File upload paths don't allow directory traversal
|
|
71
|
-
|
|
72
|
-
## A5: Security Misconfiguration
|
|
73
|
-
|
|
74
|
-
- [ ] Debug mode disabled in production (no stack traces to client)
|
|
75
|
-
- [ ] Default credentials changed
|
|
76
|
-
- [ ] Unnecessary features/endpoints disabled
|
|
77
|
-
- [ ] Security headers present:
|
|
78
|
-
- `Strict-Transport-Security`
|
|
79
|
-
- `Content-Security-Policy`
|
|
80
|
-
- `X-Content-Type-Options: nosniff`
|
|
81
|
-
- `X-Frame-Options: DENY`
|
|
82
|
-
- `Referrer-Policy`
|
|
83
|
-
- [ ] Error responses don't reveal framework/version info
|
|
84
|
-
|
|
85
|
-
## A6: XSS (Cross-Site Scripting)
|
|
86
|
-
|
|
87
|
-
- [ ] No `innerHTML`, `dangerouslySetInnerHTML`, or `v-html` with user data
|
|
88
|
-
- [ ] Output encoding applied when rendering user input
|
|
89
|
-
- [ ] Content-Security-Policy header restricts inline scripts
|
|
90
|
-
- [ ] URL parameters validated before rendering
|
|
91
|
-
|
|
92
|
-
## A7: Insecure Dependencies
|
|
93
|
-
|
|
94
|
-
- [ ] No known vulnerabilities in dependencies (`npm audit` clean)
|
|
95
|
-
- [ ] Dependencies are actively maintained (check pulse)
|
|
96
|
-
- [ ] Lock files committed and up-to-date
|
|
97
|
-
- [ ] No unnecessary dependencies (check efficiency-vs-hype.md)
|
|
98
|
-
|
|
99
|
-
## A8: Logging & Monitoring
|
|
100
|
-
|
|
101
|
-
- [ ] Authentication failures logged with IP and timestamp
|
|
102
|
-
- [ ] Authorization failures logged with userId and resource
|
|
103
|
-
- [ ] Critical operations logged (data deletion, role changes, exports)
|
|
104
|
-
- [ ] Logs do NOT contain passwords, tokens, or full credit card numbers
|
|
105
|
-
- [ ] Log injection prevented (sanitize user input before logging)
|
|
106
|
-
|
|
107
|
-
## A9: Rate Limiting
|
|
108
|
-
|
|
109
|
-
- [ ] Auth endpoints rate-limited
|
|
110
|
-
- [ ] API endpoints have reasonable rate limits
|
|
111
|
-
- [ ] File upload size limits configured
|
|
112
|
-
- [ ] Pagination limits enforced (prevent requesting 1M records)
|
|
113
|
-
|
|
114
|
-
## A10: Mass Assignment
|
|
115
|
-
|
|
116
|
-
- [ ] Input DTOs explicitly whitelist allowed fields
|
|
117
|
-
- [ ] No `Object.assign(entity, req.body)` without field filtering
|
|
118
|
-
- [ ] Admin-only fields (role, permissions) can't be set by regular users
|
|
119
|
-
- [ ] Database updates use explicit field sets, not spread operators on raw input
|
|
@@ -1,63 +0,0 @@
|
|
|
1
|
-
# Skill Platform
|
|
2
|
-
|
|
3
|
-
The skill platform is the internal skill system for Agentic-Senior-Core.
|
|
4
|
-
|
|
5
|
-
## Design Goals
|
|
6
|
-
- Unify skill content from benchmark repositories into one governed platform.
|
|
7
|
-
- Make `advance` the default operating tier.
|
|
8
|
-
- Keep `standard` only as a compatibility fallback.
|
|
9
|
-
- Require evidence, validation, and release gates for every skill pack.
|
|
10
|
-
|
|
11
|
-
## Tier Model
|
|
12
|
-
|
|
13
|
-
### standard
|
|
14
|
-
- Compatibility mode only.
|
|
15
|
-
- Minimal guidance.
|
|
16
|
-
- No default status for new work.
|
|
17
|
-
|
|
18
|
-
### advance
|
|
19
|
-
- Default operating tier.
|
|
20
|
-
- Efficient, opinionated, and production-aware.
|
|
21
|
-
- Used for normal feature delivery.
|
|
22
|
-
|
|
23
|
-
### expert
|
|
24
|
-
- For complex architecture, integration, and critical refactors.
|
|
25
|
-
- Requires stronger evidence and review depth.
|
|
26
|
-
|
|
27
|
-
### above
|
|
28
|
-
- For release-critical, cross-domain, or enterprise governance work.
|
|
29
|
-
- Requires full evidence bundle and explicit owner signoff.
|
|
30
|
-
|
|
31
|
-
## Domain Packs
|
|
32
|
-
- [Frontend](frontend/README.md)
|
|
33
|
-
- [Backend](backend/README.md)
|
|
34
|
-
- [Fullstack](fullstack/README.md)
|
|
35
|
-
- [CLI](cli/README.md)
|
|
36
|
-
- [Distribution](distribution/README.md)
|
|
37
|
-
- [Review Quality](review-quality/README.md)
|
|
38
|
-
|
|
39
|
-
## Folder Structure
|
|
40
|
-
```text
|
|
41
|
-
.agent-context/skills/
|
|
42
|
-
├── README.md
|
|
43
|
-
├── index.json
|
|
44
|
-
├── frontend/
|
|
45
|
-
├── backend/
|
|
46
|
-
├── fullstack/
|
|
47
|
-
├── cli/
|
|
48
|
-
├── distribution/
|
|
49
|
-
└── review-quality/
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
Each domain folder has its own README plus topic-level docs so the platform can scale like a curated skills library.
|
|
53
|
-
|
|
54
|
-
## Benchmark Sources
|
|
55
|
-
- sickn33/antigravity-awesome-skills
|
|
56
|
-
- github/awesome-copilot
|
|
57
|
-
- MiniMax-AI/skills
|
|
58
|
-
|
|
59
|
-
## Platform Rules
|
|
60
|
-
- Every skill pack must define purpose, inputs, outputs, validation, evidence, and fallback.
|
|
61
|
-
- Every skill pack must state the default tier it targets.
|
|
62
|
-
- Every release must include a skill parity check for the configured tiers.
|
|
63
|
-
- Every deviation from the default tier must be justified in the evidence bundle.
|
|
@@ -1,68 +0,0 @@
|
|
|
1
|
-
# Backend Engineering Skills
|
|
2
|
-
|
|
3
|
-
The backend domain covers server-side architecture, business logic, data access patterns, error handling, and operational concerns. Content consolidated from **antigravity-awesome-skills**, **awesome-copilot**, and **MiniMax-AI/skills**, with supercharging improvements ("above the line" automation and enforcement).
|
|
4
|
-
|
|
5
|
-
## Topics
|
|
6
|
-
|
|
7
|
-
- **[architecture.md](architecture.md)** - Layered design (Transport->Service->Repository), monolith vs microservices, SoC patterns, dependency management, strangler fig migrations
|
|
8
|
-
- **[validation.md](validation.md)** - Input sanitization, schema validation at API boundary, parameterized queries, typed errors
|
|
9
|
-
- **[data-access.md](data-access.md)** - Database design (3NF), query optimization (N+1 detection), safe zero-downtime migrations, indexing strategy
|
|
10
|
-
- **[errors.md](errors.md)** - Typed error codes, recovery patterns, debugging protocols, logging + correlation IDs
|
|
11
|
-
|
|
12
|
-
## What Makes Ours Different
|
|
13
|
-
|
|
14
|
-
- Layered Architecture (awesome-copilot) + Microservices Decision Framework (antigravity) + Project Structure (minimax)
|
|
15
|
-
- Dependency Auditor (ABOVE LINE) - Detect circular dependencies and enforce Transport->Service->Repository direction
|
|
16
|
-
- Zero-Downtime Migration Validator (ABOVE LINE) - Scan migrations, flag risky patterns, and suggest remediation
|
|
17
|
-
- Secrets Detector (ABOVE LINE) - Static scan for hardcoded API keys and database passwords
|
|
18
|
-
|
|
19
|
-
## Recommended Reading Order
|
|
20
|
-
|
|
21
|
-
1. `architecture.md` - Understand mental models (EXPERT tier)
|
|
22
|
-
2. `validation.md` - Protect at boundaries (ADVANCE tier)
|
|
23
|
-
3. `data-access.md` - Query strategy (EXPERT tier)
|
|
24
|
-
4. `errors.md` - Error handling pipeline (ADVANCE tier)
|
|
25
|
-
|
|
26
|
-
Then run:
|
|
27
|
-
```bash
|
|
28
|
-
npm run validate # Ensure tier structure
|
|
29
|
-
npm test # Verify examples compile
|
|
30
|
-
agentic-senior-core skill backend --tier expert # See consolidated content
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
## Tier Defaults per Topic
|
|
34
|
-
|
|
35
|
-
| Topic | Default Tier | Focus |
|
|
36
|
-
|-------|--------------|-------|
|
|
37
|
-
| architecture | EXPERT | Layering, dependencies, monolith->microservices migration |
|
|
38
|
-
| validation | ADVANCE | Boundary protection, Zod/Pydantic examples |
|
|
39
|
-
| data-access | EXPERT | 3NF design, N+1 patterns, safe migrations, indexed FKs |
|
|
40
|
-
| errors | ADVANCE | Typed codes, recovery, correlation IDs, logging |
|
|
41
|
-
|
|
42
|
-
## Comparative Coverage vs Benchmarks
|
|
43
|
-
|
|
44
|
-
| Aspect | antigravity | awesome-copilot | MiniMax | Ours |
|
|
45
|
-
|--------|-------------|-----------------|---------|------|
|
|
46
|
-
| Layered Architecture | Medium | High | Medium | High + policy enforcement |
|
|
47
|
-
| Monolith to Microservices | High | Medium | Medium | High + migration strategy |
|
|
48
|
-
| Database Design | Medium | High | Medium | High + guardrails |
|
|
49
|
-
| Error Handling | High | Medium | Medium | High + typed recovery path |
|
|
50
|
-
| Automation Tools | None | None | None | Dependency auditor, migration validator, secrets scanner |
|
|
51
|
-
|
|
52
|
-
## How to Use
|
|
53
|
-
|
|
54
|
-
**For init workflow:**
|
|
55
|
-
```bash
|
|
56
|
-
agentic-senior-core init --stack typescript --blueprint api-nextjs
|
|
57
|
-
# Activates: frontend, fullstack, backend, cli skills
|
|
58
|
-
# Default tier: advance
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
**For explicit skill selection:**
|
|
62
|
-
```bash
|
|
63
|
-
agentic-senior-core skill backend --tier expert
|
|
64
|
-
# Outputs: architecture + validation + data-access + errors at EXPERT level
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
**For skill reference in .cursorrules:**
|
|
68
|
-
Content from this domain automatically includes in `.cursorrules` when activated.
|