@ryuenn3123/agentic-senior-core 2.0.3 → 2.0.5
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/blueprints/mobile-app.md +21 -21
- package/.agent-context/profiles/platform.md +13 -13
- package/.agent-context/profiles/regulated.md +13 -13
- package/.agent-context/profiles/startup.md +13 -13
- package/.agent-context/review-checklists/frontend-skill-parity.md +28 -28
- package/.agent-context/review-checklists/frontend-usability.md +33 -33
- package/.agent-context/review-checklists/release-operations.md +29 -29
- package/.agent-context/skills/README.md +62 -62
- package/.agent-context/skills/backend/README.md +67 -67
- package/.agent-context/skills/backend/architecture.md +360 -360
- package/.agent-context/skills/backend/compatibility-manifest.json +8 -8
- package/.agent-context/skills/backend/data-access.md +230 -230
- package/.agent-context/skills/backend/errors.md +137 -137
- package/.agent-context/skills/backend/validation.md +116 -116
- package/.agent-context/skills/backend.md +28 -28
- package/.agent-context/skills/cli/README.md +49 -49
- package/.agent-context/skills/cli/compatibility-manifest.json +8 -8
- package/.agent-context/skills/cli/init.md +37 -37
- package/.agent-context/skills/cli/output.md +35 -35
- package/.agent-context/skills/cli/upgrade.md +37 -37
- package/.agent-context/skills/cli.md +28 -28
- package/.agent-context/skills/distribution/README.md +18 -18
- package/.agent-context/skills/distribution/compatibility-manifest.json +8 -8
- package/.agent-context/skills/distribution/compatibility.md +31 -31
- package/.agent-context/skills/distribution/publish.md +36 -36
- package/.agent-context/skills/distribution/rollback.md +31 -31
- package/.agent-context/skills/distribution.md +28 -28
- package/.agent-context/skills/frontend/README.md +35 -35
- package/.agent-context/skills/frontend/accessibility.md +107 -107
- package/.agent-context/skills/frontend/compatibility-manifest.json +8 -8
- package/.agent-context/skills/frontend/motion.md +66 -66
- package/.agent-context/skills/frontend/performance.md +62 -62
- package/.agent-context/skills/frontend/ui-architecture.md +128 -128
- package/.agent-context/skills/frontend.md +29 -29
- package/.agent-context/skills/fullstack/README.md +18 -18
- package/.agent-context/skills/fullstack/compatibility-manifest.json +8 -8
- package/.agent-context/skills/fullstack/contracts.md +52 -52
- package/.agent-context/skills/fullstack/end-to-end.md +41 -41
- package/.agent-context/skills/fullstack/feature-slicing.md +64 -64
- package/.agent-context/skills/fullstack.md +26 -26
- package/.agent-context/skills/index.json +107 -107
- package/.agent-context/skills/review-quality/README.md +18 -18
- package/.agent-context/skills/review-quality/benchmark.md +29 -29
- package/.agent-context/skills/review-quality/compatibility-manifest.json +8 -8
- package/.agent-context/skills/review-quality/planning.md +37 -37
- package/.agent-context/skills/review-quality/security.md +33 -33
- package/.agent-context/skills/review-quality.md +27 -27
- package/.agent-context/stacks/flutter.md +16 -16
- package/.agent-context/stacks/react-native.md +16 -16
- package/.agent-context/state/architecture-map.md +25 -25
- package/.agent-context/state/benchmark-analysis.json +431 -431
- package/.agent-context/state/benchmark-thresholds.json +10 -10
- package/.agent-context/state/benchmark-watchlist.json +19 -19
- package/.agent-context/state/dependency-map.md +32 -32
- package/.agent-context/state/quality-trend-report.json +79 -0
- package/.agent-context/state/skill-platform.json +38 -38
- package/.agent-context/state/token-optimization-benchmark.json +130 -0
- package/.agent-override.md +36 -36
- package/.cursorrules +1 -1
- package/.gemini/instructions.md +21 -97
- package/.github/ISSUE_TEMPLATE/v1.7-frontend-work-item.yml +54 -54
- package/.github/copilot-instructions.md +21 -166
- package/.github/workflows/benchmark-detection.yml +38 -38
- package/.github/workflows/benchmark-intelligence.yml +50 -50
- package/.github/workflows/frontend-usability-gate.yml +36 -36
- package/.github/workflows/release-gate.yml +32 -32
- package/.github/workflows/sbom-compliance.yml +32 -32
- package/.windsurfrules +1 -1
- package/AGENTS.md +28 -181
- package/README.md +368 -346
- package/lib/cli/commands/optimize.mjs +171 -171
- package/lib/cli/compatibility.mjs +124 -124
- package/lib/cli/token-optimization.mjs +275 -275
- package/mcp.json +92 -92
- package/package.json +3 -1
- package/scripts/benchmark-gate.mjs +121 -121
- package/scripts/benchmark-intelligence.mjs +140 -140
- package/scripts/detection-benchmark.mjs +138 -138
- package/scripts/frontend-usability-audit.mjs +87 -87
- package/scripts/generate-sbom.mjs +61 -61
- package/scripts/init-project.ps1 +104 -104
- package/scripts/llm-judge.mjs +664 -664
- package/scripts/quality-trend-report.mjs +289 -0
- package/scripts/release-gate.mjs +259 -204
- package/scripts/skill-tier-policy.mjs +75 -75
- package/scripts/token-optimization-benchmark.mjs +252 -0
- package/scripts/validate.mjs +865 -811
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
# Mobile App Blueprint
|
|
2
|
-
|
|
3
|
-
This blueprint defines the starter shape for a mobile product that needs a clean separation between UI, device integration, and backend contracts.
|
|
4
|
-
|
|
5
|
-
## Structure
|
|
6
|
-
|
|
7
|
-
- Transport: device events, navigation entry points, push notifications, and platform channels.
|
|
8
|
-
- Service: orchestration, screen-level state, validation, and user-facing workflows.
|
|
9
|
-
- Repository: remote API clients, local storage adapters, and persistence abstractions.
|
|
10
|
-
|
|
11
|
-
## Starter Rules
|
|
12
|
-
|
|
13
|
-
- Keep screens focused on rendering and user interaction only.
|
|
14
|
-
- Move API access, caching, and serialization into adapter layers.
|
|
15
|
-
- Use consistent error handling for offline, permission, and platform failures.
|
|
16
|
-
- Add release checks for signing, packaging, and crash telemetry before shipping.
|
|
17
|
-
|
|
18
|
-
## Recommended Stack Pairings
|
|
19
|
-
|
|
20
|
-
- React Native for teams that want JavaScript or TypeScript alignment.
|
|
21
|
-
- Flutter for teams that want a strongly structured UI toolkit.
|
|
1
|
+
# Mobile App Blueprint
|
|
2
|
+
|
|
3
|
+
This blueprint defines the starter shape for a mobile product that needs a clean separation between UI, device integration, and backend contracts.
|
|
4
|
+
|
|
5
|
+
## Structure
|
|
6
|
+
|
|
7
|
+
- Transport: device events, navigation entry points, push notifications, and platform channels.
|
|
8
|
+
- Service: orchestration, screen-level state, validation, and user-facing workflows.
|
|
9
|
+
- Repository: remote API clients, local storage adapters, and persistence abstractions.
|
|
10
|
+
|
|
11
|
+
## Starter Rules
|
|
12
|
+
|
|
13
|
+
- Keep screens focused on rendering and user interaction only.
|
|
14
|
+
- Move API access, caching, and serialization into adapter layers.
|
|
15
|
+
- Use consistent error handling for offline, permission, and platform failures.
|
|
16
|
+
- Add release checks for signing, packaging, and crash telemetry before shipping.
|
|
17
|
+
|
|
18
|
+
## Recommended Stack Pairings
|
|
19
|
+
|
|
20
|
+
- React Native for teams that want JavaScript or TypeScript alignment.
|
|
21
|
+
- Flutter for teams that want a strongly structured UI toolkit.
|
|
@@ -1,13 +1,13 @@
|
|
|
1
|
-
# Team Profile Pack: Platform
|
|
2
|
-
|
|
3
|
-
slug: platform
|
|
4
|
-
displayName: Platform Team
|
|
5
|
-
description: Reliability-oriented defaults for shared platform modules across teams.
|
|
6
|
-
defaultProfile: balanced
|
|
7
|
-
defaultStack: go.md
|
|
8
|
-
defaultBlueprint: go-service.md
|
|
9
|
-
ciGuardrails: true
|
|
10
|
-
lockCi: false
|
|
11
|
-
blockingSeverities: critical, high
|
|
12
|
-
owner: platform-foundation
|
|
13
|
-
lastUpdated: 2026-03-19
|
|
1
|
+
# Team Profile Pack: Platform
|
|
2
|
+
|
|
3
|
+
slug: platform
|
|
4
|
+
displayName: Platform Team
|
|
5
|
+
description: Reliability-oriented defaults for shared platform modules across teams.
|
|
6
|
+
defaultProfile: balanced
|
|
7
|
+
defaultStack: go.md
|
|
8
|
+
defaultBlueprint: go-service.md
|
|
9
|
+
ciGuardrails: true
|
|
10
|
+
lockCi: false
|
|
11
|
+
blockingSeverities: critical, high
|
|
12
|
+
owner: platform-foundation
|
|
13
|
+
lastUpdated: 2026-03-19
|
|
@@ -1,13 +1,13 @@
|
|
|
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
|
+
# 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 +1,13 @@
|
|
|
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
|
+
# 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,28 +1,28 @@
|
|
|
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
|
-
- [ ] Any parity waiver includes owner, expiry, and risk statement.
|
|
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
|
+
- [ ] Any parity waiver includes owner, expiry, and risk statement.
|
|
@@ -1,33 +1,33 @@
|
|
|
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
|
-
|
|
10
|
-
## 2. Responsiveness
|
|
11
|
-
- [ ] Core pages are usable at mobile, tablet, and desktop breakpoints.
|
|
12
|
-
- [ ] Navigation remains accessible and understandable on small screens.
|
|
13
|
-
- [ ] No content overlap, clipped text, or horizontal scroll regressions.
|
|
14
|
-
|
|
15
|
-
## 3. Accessibility
|
|
16
|
-
- [ ] Keyboard-only navigation covers all critical user paths.
|
|
17
|
-
- [ ] Primary text and actionable controls meet WCAG AA contrast.
|
|
18
|
-
- [ ] Reduced-motion mode is respected for non-essential animations.
|
|
19
|
-
|
|
20
|
-
## 4. Interaction Quality
|
|
21
|
-
- [ ] Motion is meaningful, not decorative noise.
|
|
22
|
-
- [ ] Loading, empty, and error states are explicitly designed.
|
|
23
|
-
- [ ] CTA hierarchy is clear and supports user intent.
|
|
24
|
-
|
|
25
|
-
## 5. Performance and Stability
|
|
26
|
-
- [ ] Lighthouse mobile performance target is met on core pages.
|
|
27
|
-
- [ ] No severe layout shift during load and transition.
|
|
28
|
-
- [ ] Visual regression checks cover protected pages.
|
|
29
|
-
|
|
30
|
-
## 6. Documentation and Release Evidence
|
|
31
|
-
- [ ] Frontend architecture decision is documented.
|
|
32
|
-
- [ ] Visual baseline update process is documented.
|
|
33
|
-
- [ ] Release note includes usability and responsiveness evidence.
|
|
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
|
+
|
|
10
|
+
## 2. Responsiveness
|
|
11
|
+
- [ ] Core pages are usable at mobile, tablet, and desktop breakpoints.
|
|
12
|
+
- [ ] Navigation remains accessible and understandable on small screens.
|
|
13
|
+
- [ ] No content overlap, clipped text, or horizontal scroll regressions.
|
|
14
|
+
|
|
15
|
+
## 3. Accessibility
|
|
16
|
+
- [ ] Keyboard-only navigation covers all critical user paths.
|
|
17
|
+
- [ ] Primary text and actionable controls meet WCAG AA contrast.
|
|
18
|
+
- [ ] Reduced-motion mode is respected for non-essential animations.
|
|
19
|
+
|
|
20
|
+
## 4. Interaction Quality
|
|
21
|
+
- [ ] Motion is meaningful, not decorative noise.
|
|
22
|
+
- [ ] Loading, empty, and error states are explicitly designed.
|
|
23
|
+
- [ ] CTA hierarchy is clear and supports user intent.
|
|
24
|
+
|
|
25
|
+
## 5. Performance and Stability
|
|
26
|
+
- [ ] Lighthouse mobile performance target is met on core pages.
|
|
27
|
+
- [ ] No severe layout shift during load and transition.
|
|
28
|
+
- [ ] Visual regression checks cover protected pages.
|
|
29
|
+
|
|
30
|
+
## 6. Documentation and Release Evidence
|
|
31
|
+
- [ ] Frontend architecture decision is documented.
|
|
32
|
+
- [ ] Visual baseline update process is documented.
|
|
33
|
+
- [ ] Release note includes usability and responsiveness evidence.
|
|
@@ -1,29 +1,29 @@
|
|
|
1
|
-
# Release Operations Checklist (V1.8)
|
|
2
|
-
|
|
3
|
-
Use this checklist before promoting any release tag or package publish operation.
|
|
4
|
-
|
|
5
|
-
## 1) Versioning and Changelog Integrity
|
|
6
|
-
- `package.json` version is valid semantic version (`x.y.z`).
|
|
7
|
-
- `CHANGELOG.md` has a matching release header for the package version.
|
|
8
|
-
- `docs/roadmap.md` reflects release status and scope for the current milestone.
|
|
9
|
-
|
|
10
|
-
## 2) Quality Gates and Test Evidence
|
|
11
|
-
- `npm run validate` passes with zero failures.
|
|
12
|
-
- `npm run test` passes on the full suite.
|
|
13
|
-
- Frontend governance gate (`npm run audit:frontend-usability`) passes.
|
|
14
|
-
- Release governance gate (`npm run gate:release`) passes.
|
|
15
|
-
|
|
16
|
-
## 3) Supply Chain and Compliance Evidence
|
|
17
|
-
- SBOM is generated with `npm run sbom:generate`.
|
|
18
|
-
- CI uploads SBOM artifact for retention and audit traceability.
|
|
19
|
-
- CI uploads release-gate report artifact for each run.
|
|
20
|
-
|
|
21
|
-
## 4) Security and Override Governance
|
|
22
|
-
- `.agent-override.md` entries have valid `Owner` and `Expiry` metadata.
|
|
23
|
-
- No expired overrides remain active.
|
|
24
|
-
- Any temporary exception has explicit rollback owner and date.
|
|
25
|
-
|
|
26
|
-
## 5) Publish Readiness
|
|
27
|
-
- Release notes summarize scope, risks, and rollback steps.
|
|
28
|
-
- Required GitHub workflows are green on target commit.
|
|
29
|
-
- Tag and publish command are executed only after all checks pass.
|
|
1
|
+
# Release Operations Checklist (V1.8)
|
|
2
|
+
|
|
3
|
+
Use this checklist before promoting any release tag or package publish operation.
|
|
4
|
+
|
|
5
|
+
## 1) Versioning and Changelog Integrity
|
|
6
|
+
- `package.json` version is valid semantic version (`x.y.z`).
|
|
7
|
+
- `CHANGELOG.md` has a matching release header for the package version.
|
|
8
|
+
- `docs/roadmap.md` reflects release status and scope for the current milestone.
|
|
9
|
+
|
|
10
|
+
## 2) Quality Gates and Test Evidence
|
|
11
|
+
- `npm run validate` passes with zero failures.
|
|
12
|
+
- `npm run test` passes on the full suite.
|
|
13
|
+
- Frontend governance gate (`npm run audit:frontend-usability`) passes.
|
|
14
|
+
- Release governance gate (`npm run gate:release`) passes.
|
|
15
|
+
|
|
16
|
+
## 3) Supply Chain and Compliance Evidence
|
|
17
|
+
- SBOM is generated with `npm run sbom:generate`.
|
|
18
|
+
- CI uploads SBOM artifact for retention and audit traceability.
|
|
19
|
+
- CI uploads release-gate report artifact for each run.
|
|
20
|
+
|
|
21
|
+
## 4) Security and Override Governance
|
|
22
|
+
- `.agent-override.md` entries have valid `Owner` and `Expiry` metadata.
|
|
23
|
+
- No expired overrides remain active.
|
|
24
|
+
- Any temporary exception has explicit rollback owner and date.
|
|
25
|
+
|
|
26
|
+
## 5) Publish Readiness
|
|
27
|
+
- Release notes summarize scope, risks, and rollback steps.
|
|
28
|
+
- Required GitHub workflows are green on target commit.
|
|
29
|
+
- Tag and publish command are executed only after all checks pass.
|
|
@@ -1,63 +1,63 @@
|
|
|
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.
|
|
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
63
|
- Every deviation from the default tier must be justified in the evidence bundle.
|
|
@@ -1,68 +1,68 @@
|
|
|
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:**
|
|
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
68
|
Content from this domain automatically includes in `.cursorrules` when activated.
|