@ryuenn3123/agentic-senior-core 1.9.0 → 1.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/.agent-context/blueprints/mobile-app.md +21 -21
  2. package/.agent-context/policies/llm-judge-threshold.json +19 -19
  3. package/.agent-context/profiles/platform.md +13 -13
  4. package/.agent-context/profiles/regulated.md +13 -13
  5. package/.agent-context/profiles/startup.md +13 -13
  6. package/.agent-context/review-checklists/frontend-skill-parity.md +28 -28
  7. package/.agent-context/review-checklists/frontend-usability.md +33 -33
  8. package/.agent-context/review-checklists/release-operations.md +29 -29
  9. package/.agent-context/skills/README.md +62 -62
  10. package/.agent-context/skills/backend/README.md +67 -67
  11. package/.agent-context/skills/backend/architecture.md +360 -360
  12. package/.agent-context/skills/backend/data-access.md +230 -230
  13. package/.agent-context/skills/backend/errors.md +137 -137
  14. package/.agent-context/skills/backend/validation.md +116 -116
  15. package/.agent-context/skills/backend.md +28 -28
  16. package/.agent-context/skills/cli/README.md +49 -49
  17. package/.agent-context/skills/cli/init.md +37 -37
  18. package/.agent-context/skills/cli/output.md +35 -35
  19. package/.agent-context/skills/cli/upgrade.md +37 -37
  20. package/.agent-context/skills/cli.md +28 -28
  21. package/.agent-context/skills/distribution/README.md +18 -18
  22. package/.agent-context/skills/distribution/compatibility.md +31 -31
  23. package/.agent-context/skills/distribution/publish.md +36 -36
  24. package/.agent-context/skills/distribution/rollback.md +31 -31
  25. package/.agent-context/skills/distribution.md +28 -28
  26. package/.agent-context/skills/frontend/README.md +35 -35
  27. package/.agent-context/skills/frontend/accessibility.md +107 -107
  28. package/.agent-context/skills/frontend/motion.md +66 -66
  29. package/.agent-context/skills/frontend/performance.md +62 -62
  30. package/.agent-context/skills/frontend/ui-architecture.md +128 -128
  31. package/.agent-context/skills/frontend.md +29 -29
  32. package/.agent-context/skills/fullstack/README.md +18 -18
  33. package/.agent-context/skills/fullstack/contracts.md +52 -52
  34. package/.agent-context/skills/fullstack/end-to-end.md +41 -41
  35. package/.agent-context/skills/fullstack/feature-slicing.md +64 -64
  36. package/.agent-context/skills/fullstack.md +26 -26
  37. package/.agent-context/skills/index.json +107 -107
  38. package/.agent-context/skills/review-quality/README.md +18 -18
  39. package/.agent-context/skills/review-quality/benchmark.md +29 -29
  40. package/.agent-context/skills/review-quality/planning.md +37 -37
  41. package/.agent-context/skills/review-quality/security.md +33 -33
  42. package/.agent-context/skills/review-quality.md +27 -27
  43. package/.agent-context/stacks/flutter.md +16 -16
  44. package/.agent-context/stacks/react-native.md +16 -16
  45. package/.agent-context/state/architecture-map.md +25 -25
  46. package/.agent-context/state/benchmark-analysis.json +431 -431
  47. package/.agent-context/state/benchmark-thresholds.json +10 -10
  48. package/.agent-context/state/benchmark-watchlist.json +19 -19
  49. package/.agent-context/state/dependency-map.md +32 -32
  50. package/.agent-context/state/skill-platform.json +38 -38
  51. package/.agent-override.md +36 -36
  52. package/.cursorrules +140 -140
  53. package/.github/ISSUE_TEMPLATE/v1.7-frontend-work-item.yml +54 -54
  54. package/.github/workflows/benchmark-detection.yml +38 -38
  55. package/.github/workflows/benchmark-intelligence.yml +50 -50
  56. package/.github/workflows/frontend-usability-gate.yml +36 -36
  57. package/.github/workflows/publish.yml +32 -0
  58. package/.github/workflows/release-gate.yml +32 -32
  59. package/.github/workflows/sbom-compliance.yml +32 -32
  60. package/.windsurfrules +106 -106
  61. package/AGENTS.md +181 -181
  62. package/README.md +318 -318
  63. package/bin/agentic-senior-core.js +1556 -1556
  64. package/mcp.json +92 -92
  65. package/package.json +1 -1
  66. package/scripts/benchmark-gate.mjs +121 -121
  67. package/scripts/benchmark-intelligence.mjs +140 -140
  68. package/scripts/detection-benchmark.mjs +138 -138
  69. package/scripts/frontend-usability-audit.mjs +87 -87
  70. package/scripts/generate-sbom.mjs +61 -61
  71. package/scripts/init-project.ps1 +104 -104
  72. package/scripts/llm-judge.mjs +664 -664
  73. package/scripts/release-gate.mjs +116 -116
  74. package/scripts/skill-tier-policy.mjs +75 -75
  75. package/scripts/validate.mjs +636 -636
@@ -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,20 +1,20 @@
1
- {
2
- "selectedProfile": "balanced",
3
- "profileThresholds": {
4
- "beginner": {
5
- "blockingSeverities": ["critical"],
6
- "failOnMalformedResponse": false,
7
- "failOnProviderError": false
8
- },
9
- "balanced": {
10
- "blockingSeverities": ["critical", "high"],
11
- "failOnMalformedResponse": true,
12
- "failOnProviderError": false
13
- },
14
- "strict": {
15
- "blockingSeverities": ["critical", "high", "medium"],
16
- "failOnMalformedResponse": true,
17
- "failOnProviderError": true
18
- }
19
- }
1
+ {
2
+ "selectedProfile": "balanced",
3
+ "profileThresholds": {
4
+ "beginner": {
5
+ "blockingSeverities": ["critical"],
6
+ "failOnMalformedResponse": false,
7
+ "failOnProviderError": false
8
+ },
9
+ "balanced": {
10
+ "blockingSeverities": ["critical", "high"],
11
+ "failOnMalformedResponse": true,
12
+ "failOnProviderError": false
13
+ },
14
+ "strict": {
15
+ "blockingSeverities": ["critical", "high", "medium"],
16
+ "failOnMalformedResponse": true,
17
+ "failOnProviderError": true
18
+ }
19
+ }
20
20
  }
@@ -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.