@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.
Files changed (173) hide show
  1. package/.agent-context/prompts/init-project.md +5 -5
  2. package/.agent-context/prompts/refactor.md +2 -1
  3. package/.agent-context/prompts/review-code.md +3 -2
  4. package/.agent-context/review-checklists/pr-checklist.md +8 -1
  5. package/.agent-context/rules/architecture.md +11 -0
  6. package/.agent-context/rules/frontend-architecture.md +2 -2
  7. package/.agent-context/state/architecture-map.md +1 -1
  8. package/.agent-context/state/memory-continuity-benchmark.json +1 -1
  9. package/.agents/workflows/init-project.md +3 -3
  10. package/.agents/workflows/refactor.md +1 -1
  11. package/.agents/workflows/review-code.md +4 -5
  12. package/.cursorrules +27 -71
  13. package/.gemini/instructions.md +6 -7
  14. package/.github/copilot-instructions.md +5 -6
  15. package/.windsurfrules +27 -71
  16. package/AGENTS.md +7 -9
  17. package/CONTRIBUTING.md +18 -31
  18. package/README.md +21 -4
  19. package/bin/agentic-senior-core.js +0 -6
  20. package/lib/cli/commands/init.mjs +113 -650
  21. package/lib/cli/commands/launch.mjs +1 -23
  22. package/lib/cli/commands/rollback.mjs +1 -1
  23. package/lib/cli/commands/upgrade.mjs +1 -23
  24. package/lib/cli/compiler.mjs +77 -72
  25. package/lib/cli/constants.mjs +84 -26
  26. package/lib/cli/init-architecture-flow.mjs +231 -0
  27. package/lib/cli/init-detection-flow.mjs +123 -0
  28. package/lib/cli/init-options.mjs +344 -0
  29. package/lib/cli/init-selection.mjs +100 -0
  30. package/lib/cli/preflight.mjs +1 -1
  31. package/lib/cli/profile-packs.mjs +15 -1
  32. package/lib/cli/project-scaffolder.mjs +18 -154
  33. package/lib/cli/utils.mjs +16 -12
  34. package/mcp.json +19 -19
  35. package/package.json +5 -2
  36. package/scripts/context-triggered-audit.mjs +18 -18
  37. package/scripts/documentation-boundary-audit.mjs +92 -5
  38. package/scripts/forbidden-content-check.mjs +1 -1
  39. package/scripts/frontend-usability-audit.mjs +21 -28
  40. package/scripts/governance-weekly-report.mjs +29 -15
  41. package/scripts/llm-judge.mjs +2 -5
  42. package/scripts/mcp-server.mjs +389 -5
  43. package/scripts/release-gate.mjs +121 -145
  44. package/scripts/sync-thin-adapters.mjs +161 -0
  45. package/scripts/v3-purge-audit.mjs +231 -0
  46. package/scripts/validate-evidence-bundle.mjs +1 -1
  47. package/scripts/validate.mjs +224 -272
  48. package/.agent-context/blueprints/api-nextjs.md +0 -184
  49. package/.agent-context/blueprints/aspnet-api.md +0 -247
  50. package/.agent-context/blueprints/ci-github-actions.md +0 -226
  51. package/.agent-context/blueprints/ci-gitlab.md +0 -200
  52. package/.agent-context/blueprints/fastapi-service.md +0 -210
  53. package/.agent-context/blueprints/go-service.md +0 -217
  54. package/.agent-context/blueprints/graphql-grpc-api.md +0 -51
  55. package/.agent-context/blueprints/infrastructure-as-code.md +0 -62
  56. package/.agent-context/blueprints/kubernetes-manifests.md +0 -76
  57. package/.agent-context/blueprints/laravel-api.md +0 -233
  58. package/.agent-context/blueprints/mobile-app.md +0 -91
  59. package/.agent-context/blueprints/nestjs-logic.md +0 -247
  60. package/.agent-context/blueprints/observability.md +0 -227
  61. package/.agent-context/blueprints/spring-boot-api.md +0 -218
  62. package/.agent-context/profiles/platform.md +0 -13
  63. package/.agent-context/profiles/regulated.md +0 -13
  64. package/.agent-context/profiles/startup.md +0 -13
  65. package/.agent-context/review-checklists/frontend-excellence-rubric.md +0 -73
  66. package/.agent-context/review-checklists/frontend-skill-parity.md +0 -29
  67. package/.agent-context/review-checklists/frontend-usability.md +0 -35
  68. package/.agent-context/review-checklists/marketplace-acceptance.md +0 -60
  69. package/.agent-context/review-checklists/performance-audit.md +0 -71
  70. package/.agent-context/review-checklists/release-operations.md +0 -33
  71. package/.agent-context/review-checklists/security-audit.md +0 -119
  72. package/.agent-context/skills/README.md +0 -63
  73. package/.agent-context/skills/backend/README.md +0 -68
  74. package/.agent-context/skills/backend/architecture.md +0 -361
  75. package/.agent-context/skills/backend/compatibility-manifest.json +0 -8
  76. package/.agent-context/skills/backend/data-access.md +0 -231
  77. package/.agent-context/skills/backend/errors.md +0 -138
  78. package/.agent-context/skills/backend/validation.md +0 -117
  79. package/.agent-context/skills/backend.md +0 -29
  80. package/.agent-context/skills/cli/.evidence/compatibility-manifest.json +0 -5
  81. package/.agent-context/skills/cli/.evidence/sbom-excerpt.json +0 -10
  82. package/.agent-context/skills/cli/.evidence/test-report.json +0 -8
  83. package/.agent-context/skills/cli/CHANGELOG.md +0 -6
  84. package/.agent-context/skills/cli/README.md +0 -56
  85. package/.agent-context/skills/cli/compatibility-manifest.json +0 -8
  86. package/.agent-context/skills/cli/init.md +0 -38
  87. package/.agent-context/skills/cli/output.md +0 -36
  88. package/.agent-context/skills/cli/package.json +0 -5
  89. package/.agent-context/skills/cli/safety-telemetry.md +0 -39
  90. package/.agent-context/skills/cli/tests/.gitkeep +0 -1
  91. package/.agent-context/skills/cli/upgrade.md +0 -38
  92. package/.agent-context/skills/cli.md +0 -32
  93. package/.agent-context/skills/distribution/.evidence/compatibility-manifest.json +0 -9
  94. package/.agent-context/skills/distribution/.evidence/sbom-excerpt.json +0 -6
  95. package/.agent-context/skills/distribution/.evidence/test-report.json +0 -8
  96. package/.agent-context/skills/distribution/CHANGELOG.md +0 -7
  97. package/.agent-context/skills/distribution/README.md +0 -27
  98. package/.agent-context/skills/distribution/compatibility-manifest.json +0 -8
  99. package/.agent-context/skills/distribution/compatibility.md +0 -32
  100. package/.agent-context/skills/distribution/package.json +0 -5
  101. package/.agent-context/skills/distribution/provenance-attestation.md +0 -47
  102. package/.agent-context/skills/distribution/publish.md +0 -37
  103. package/.agent-context/skills/distribution/rollback.md +0 -32
  104. package/.agent-context/skills/distribution/tests/.gitkeep +0 -1
  105. package/.agent-context/skills/distribution.md +0 -32
  106. package/.agent-context/skills/frontend/.evidence/compatibility-manifest.json +0 -9
  107. package/.agent-context/skills/frontend/.evidence/sbom-excerpt.json +0 -6
  108. package/.agent-context/skills/frontend/.evidence/test-report.json +0 -8
  109. package/.agent-context/skills/frontend/CHANGELOG.md +0 -7
  110. package/.agent-context/skills/frontend/README.md +0 -50
  111. package/.agent-context/skills/frontend/accessibility.md +0 -107
  112. package/.agent-context/skills/frontend/compatibility-manifest.json +0 -8
  113. package/.agent-context/skills/frontend/conversion-clarity.md +0 -51
  114. package/.agent-context/skills/frontend/motion.md +0 -67
  115. package/.agent-context/skills/frontend/package.json +0 -5
  116. package/.agent-context/skills/frontend/performance.md +0 -63
  117. package/.agent-context/skills/frontend/responsive-delivery.md +0 -41
  118. package/.agent-context/skills/frontend/tests/.gitkeep +0 -1
  119. package/.agent-context/skills/frontend/ui-architecture.md +0 -128
  120. package/.agent-context/skills/frontend.md +0 -40
  121. package/.agent-context/skills/fullstack/.evidence/compatibility-manifest.json +0 -9
  122. package/.agent-context/skills/fullstack/.evidence/sbom-excerpt.json +0 -6
  123. package/.agent-context/skills/fullstack/.evidence/test-report.json +0 -8
  124. package/.agent-context/skills/fullstack/CHANGELOG.md +0 -7
  125. package/.agent-context/skills/fullstack/README.md +0 -27
  126. package/.agent-context/skills/fullstack/compatibility-manifest.json +0 -8
  127. package/.agent-context/skills/fullstack/contracts.md +0 -53
  128. package/.agent-context/skills/fullstack/end-to-end.md +0 -42
  129. package/.agent-context/skills/fullstack/feature-slicing.md +0 -65
  130. package/.agent-context/skills/fullstack/package.json +0 -5
  131. package/.agent-context/skills/fullstack/release-coordination.md +0 -51
  132. package/.agent-context/skills/fullstack/tests/.gitkeep +0 -1
  133. package/.agent-context/skills/fullstack.md +0 -30
  134. package/.agent-context/skills/index.json +0 -107
  135. package/.agent-context/skills/review-quality/.evidence/compatibility-manifest.json +0 -9
  136. package/.agent-context/skills/review-quality/.evidence/sbom-excerpt.json +0 -6
  137. package/.agent-context/skills/review-quality/.evidence/test-report.json +0 -8
  138. package/.agent-context/skills/review-quality/CHANGELOG.md +0 -7
  139. package/.agent-context/skills/review-quality/README.md +0 -27
  140. package/.agent-context/skills/review-quality/benchmark.md +0 -30
  141. package/.agent-context/skills/review-quality/compatibility-manifest.json +0 -8
  142. package/.agent-context/skills/review-quality/package.json +0 -5
  143. package/.agent-context/skills/review-quality/planning.md +0 -38
  144. package/.agent-context/skills/review-quality/release-decision.md +0 -49
  145. package/.agent-context/skills/review-quality/security.md +0 -34
  146. package/.agent-context/skills/review-quality/tests/.gitkeep +0 -1
  147. package/.agent-context/skills/review-quality.md +0 -34
  148. package/.agent-context/stacks/csharp.md +0 -149
  149. package/.agent-context/stacks/flutter.md +0 -16
  150. package/.agent-context/stacks/go.md +0 -181
  151. package/.agent-context/stacks/java.md +0 -135
  152. package/.agent-context/stacks/php.md +0 -192
  153. package/.agent-context/stacks/python.md +0 -153
  154. package/.agent-context/stacks/react-native.md +0 -16
  155. package/.agent-context/stacks/ruby.md +0 -80
  156. package/.agent-context/stacks/rust.md +0 -86
  157. package/.agent-context/stacks/typescript.md +0 -317
  158. package/.agent-context/state/skill-platform.json +0 -38
  159. package/lib/cli/skill-selector.mjs +0 -232
  160. package/lib/cli/templates/api-contract.md.id.tmpl +0 -143
  161. package/lib/cli/templates/api-contract.md.tmpl +0 -143
  162. package/lib/cli/templates/architecture-decision-record.md.id.tmpl +0 -106
  163. package/lib/cli/templates/architecture-decision-record.md.tmpl +0 -145
  164. package/lib/cli/templates/database-schema.md.id.tmpl +0 -74
  165. package/lib/cli/templates/database-schema.md.tmpl +0 -74
  166. package/lib/cli/templates/flow-overview.md.id.tmpl +0 -118
  167. package/lib/cli/templates/flow-overview.md.tmpl +0 -131
  168. package/lib/cli/templates/project-brief.md.id.tmpl +0 -55
  169. package/lib/cli/templates/project-brief.md.tmpl +0 -79
  170. package/scripts/init-project.ps1 +0 -105
  171. package/scripts/init-project.sh +0 -131
  172. package/scripts/skill-tier-policy.mjs +0 -76
  173. 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.