@ryuenn3123/agentic-senior-core 2.5.22 → 3.0.2

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 (174) hide show
  1. package/.agent-context/prompts/bootstrap-design.md +22 -0
  2. package/.agent-context/prompts/init-project.md +55 -39
  3. package/.agent-context/prompts/refactor.md +2 -1
  4. package/.agent-context/prompts/review-code.md +3 -2
  5. package/.agent-context/review-checklists/pr-checklist.md +8 -1
  6. package/.agent-context/rules/architecture.md +11 -0
  7. package/.agent-context/rules/frontend-architecture.md +2 -2
  8. package/.agent-context/state/architecture-map.md +1 -1
  9. package/.agent-context/state/memory-continuity-benchmark.json +1 -1
  10. package/.agents/workflows/init-project.md +3 -3
  11. package/.agents/workflows/refactor.md +1 -1
  12. package/.agents/workflows/review-code.md +4 -5
  13. package/.cursorrules +27 -71
  14. package/.gemini/instructions.md +6 -7
  15. package/.github/copilot-instructions.md +5 -6
  16. package/.windsurfrules +27 -71
  17. package/AGENTS.md +7 -9
  18. package/CONTRIBUTING.md +18 -31
  19. package/README.md +17 -43
  20. package/bin/agentic-senior-core.js +0 -6
  21. package/lib/cli/commands/init.mjs +113 -650
  22. package/lib/cli/commands/launch.mjs +1 -23
  23. package/lib/cli/commands/rollback.mjs +1 -1
  24. package/lib/cli/commands/upgrade.mjs +47 -28
  25. package/lib/cli/compiler.mjs +77 -72
  26. package/lib/cli/constants.mjs +84 -26
  27. package/lib/cli/init-architecture-flow.mjs +231 -0
  28. package/lib/cli/init-detection-flow.mjs +123 -0
  29. package/lib/cli/init-options.mjs +344 -0
  30. package/lib/cli/init-selection.mjs +100 -0
  31. package/lib/cli/preflight.mjs +1 -1
  32. package/lib/cli/profile-packs.mjs +15 -1
  33. package/lib/cli/project-scaffolder.mjs +18 -154
  34. package/lib/cli/utils.mjs +224 -13
  35. package/mcp.json +19 -19
  36. package/package.json +5 -2
  37. package/scripts/context-triggered-audit.mjs +18 -18
  38. package/scripts/documentation-boundary-audit.mjs +92 -5
  39. package/scripts/forbidden-content-check.mjs +1 -1
  40. package/scripts/frontend-usability-audit.mjs +21 -28
  41. package/scripts/governance-weekly-report.mjs +29 -15
  42. package/scripts/llm-judge.mjs +2 -5
  43. package/scripts/mcp-server.mjs +389 -5
  44. package/scripts/release-gate.mjs +121 -145
  45. package/scripts/sync-thin-adapters.mjs +161 -0
  46. package/scripts/v3-purge-audit.mjs +231 -0
  47. package/scripts/validate-evidence-bundle.mjs +1 -1
  48. package/scripts/validate.mjs +224 -272
  49. package/.agent-context/blueprints/api-nextjs.md +0 -184
  50. package/.agent-context/blueprints/aspnet-api.md +0 -247
  51. package/.agent-context/blueprints/ci-github-actions.md +0 -226
  52. package/.agent-context/blueprints/ci-gitlab.md +0 -200
  53. package/.agent-context/blueprints/fastapi-service.md +0 -210
  54. package/.agent-context/blueprints/go-service.md +0 -217
  55. package/.agent-context/blueprints/graphql-grpc-api.md +0 -51
  56. package/.agent-context/blueprints/infrastructure-as-code.md +0 -62
  57. package/.agent-context/blueprints/kubernetes-manifests.md +0 -76
  58. package/.agent-context/blueprints/laravel-api.md +0 -233
  59. package/.agent-context/blueprints/mobile-app.md +0 -91
  60. package/.agent-context/blueprints/nestjs-logic.md +0 -247
  61. package/.agent-context/blueprints/observability.md +0 -227
  62. package/.agent-context/blueprints/spring-boot-api.md +0 -218
  63. package/.agent-context/profiles/platform.md +0 -13
  64. package/.agent-context/profiles/regulated.md +0 -13
  65. package/.agent-context/profiles/startup.md +0 -13
  66. package/.agent-context/review-checklists/frontend-excellence-rubric.md +0 -73
  67. package/.agent-context/review-checklists/frontend-skill-parity.md +0 -29
  68. package/.agent-context/review-checklists/frontend-usability.md +0 -35
  69. package/.agent-context/review-checklists/marketplace-acceptance.md +0 -60
  70. package/.agent-context/review-checklists/performance-audit.md +0 -71
  71. package/.agent-context/review-checklists/release-operations.md +0 -33
  72. package/.agent-context/review-checklists/security-audit.md +0 -119
  73. package/.agent-context/skills/README.md +0 -63
  74. package/.agent-context/skills/backend/README.md +0 -68
  75. package/.agent-context/skills/backend/architecture.md +0 -361
  76. package/.agent-context/skills/backend/compatibility-manifest.json +0 -8
  77. package/.agent-context/skills/backend/data-access.md +0 -231
  78. package/.agent-context/skills/backend/errors.md +0 -138
  79. package/.agent-context/skills/backend/validation.md +0 -117
  80. package/.agent-context/skills/backend.md +0 -29
  81. package/.agent-context/skills/cli/.evidence/compatibility-manifest.json +0 -5
  82. package/.agent-context/skills/cli/.evidence/sbom-excerpt.json +0 -10
  83. package/.agent-context/skills/cli/.evidence/test-report.json +0 -8
  84. package/.agent-context/skills/cli/CHANGELOG.md +0 -6
  85. package/.agent-context/skills/cli/README.md +0 -56
  86. package/.agent-context/skills/cli/compatibility-manifest.json +0 -8
  87. package/.agent-context/skills/cli/init.md +0 -38
  88. package/.agent-context/skills/cli/output.md +0 -36
  89. package/.agent-context/skills/cli/package.json +0 -5
  90. package/.agent-context/skills/cli/safety-telemetry.md +0 -39
  91. package/.agent-context/skills/cli/tests/.gitkeep +0 -1
  92. package/.agent-context/skills/cli/upgrade.md +0 -38
  93. package/.agent-context/skills/cli.md +0 -32
  94. package/.agent-context/skills/distribution/.evidence/compatibility-manifest.json +0 -9
  95. package/.agent-context/skills/distribution/.evidence/sbom-excerpt.json +0 -6
  96. package/.agent-context/skills/distribution/.evidence/test-report.json +0 -8
  97. package/.agent-context/skills/distribution/CHANGELOG.md +0 -7
  98. package/.agent-context/skills/distribution/README.md +0 -27
  99. package/.agent-context/skills/distribution/compatibility-manifest.json +0 -8
  100. package/.agent-context/skills/distribution/compatibility.md +0 -32
  101. package/.agent-context/skills/distribution/package.json +0 -5
  102. package/.agent-context/skills/distribution/provenance-attestation.md +0 -47
  103. package/.agent-context/skills/distribution/publish.md +0 -37
  104. package/.agent-context/skills/distribution/rollback.md +0 -32
  105. package/.agent-context/skills/distribution/tests/.gitkeep +0 -1
  106. package/.agent-context/skills/distribution.md +0 -32
  107. package/.agent-context/skills/frontend/.evidence/compatibility-manifest.json +0 -9
  108. package/.agent-context/skills/frontend/.evidence/sbom-excerpt.json +0 -6
  109. package/.agent-context/skills/frontend/.evidence/test-report.json +0 -8
  110. package/.agent-context/skills/frontend/CHANGELOG.md +0 -7
  111. package/.agent-context/skills/frontend/README.md +0 -50
  112. package/.agent-context/skills/frontend/accessibility.md +0 -107
  113. package/.agent-context/skills/frontend/compatibility-manifest.json +0 -8
  114. package/.agent-context/skills/frontend/conversion-clarity.md +0 -51
  115. package/.agent-context/skills/frontend/motion.md +0 -67
  116. package/.agent-context/skills/frontend/package.json +0 -5
  117. package/.agent-context/skills/frontend/performance.md +0 -63
  118. package/.agent-context/skills/frontend/responsive-delivery.md +0 -41
  119. package/.agent-context/skills/frontend/tests/.gitkeep +0 -1
  120. package/.agent-context/skills/frontend/ui-architecture.md +0 -128
  121. package/.agent-context/skills/frontend.md +0 -40
  122. package/.agent-context/skills/fullstack/.evidence/compatibility-manifest.json +0 -9
  123. package/.agent-context/skills/fullstack/.evidence/sbom-excerpt.json +0 -6
  124. package/.agent-context/skills/fullstack/.evidence/test-report.json +0 -8
  125. package/.agent-context/skills/fullstack/CHANGELOG.md +0 -7
  126. package/.agent-context/skills/fullstack/README.md +0 -27
  127. package/.agent-context/skills/fullstack/compatibility-manifest.json +0 -8
  128. package/.agent-context/skills/fullstack/contracts.md +0 -53
  129. package/.agent-context/skills/fullstack/end-to-end.md +0 -42
  130. package/.agent-context/skills/fullstack/feature-slicing.md +0 -65
  131. package/.agent-context/skills/fullstack/package.json +0 -5
  132. package/.agent-context/skills/fullstack/release-coordination.md +0 -51
  133. package/.agent-context/skills/fullstack/tests/.gitkeep +0 -1
  134. package/.agent-context/skills/fullstack.md +0 -30
  135. package/.agent-context/skills/index.json +0 -107
  136. package/.agent-context/skills/review-quality/.evidence/compatibility-manifest.json +0 -9
  137. package/.agent-context/skills/review-quality/.evidence/sbom-excerpt.json +0 -6
  138. package/.agent-context/skills/review-quality/.evidence/test-report.json +0 -8
  139. package/.agent-context/skills/review-quality/CHANGELOG.md +0 -7
  140. package/.agent-context/skills/review-quality/README.md +0 -27
  141. package/.agent-context/skills/review-quality/benchmark.md +0 -30
  142. package/.agent-context/skills/review-quality/compatibility-manifest.json +0 -8
  143. package/.agent-context/skills/review-quality/package.json +0 -5
  144. package/.agent-context/skills/review-quality/planning.md +0 -38
  145. package/.agent-context/skills/review-quality/release-decision.md +0 -49
  146. package/.agent-context/skills/review-quality/security.md +0 -34
  147. package/.agent-context/skills/review-quality/tests/.gitkeep +0 -1
  148. package/.agent-context/skills/review-quality.md +0 -34
  149. package/.agent-context/stacks/csharp.md +0 -149
  150. package/.agent-context/stacks/flutter.md +0 -16
  151. package/.agent-context/stacks/go.md +0 -181
  152. package/.agent-context/stacks/java.md +0 -135
  153. package/.agent-context/stacks/php.md +0 -192
  154. package/.agent-context/stacks/python.md +0 -153
  155. package/.agent-context/stacks/react-native.md +0 -16
  156. package/.agent-context/stacks/ruby.md +0 -80
  157. package/.agent-context/stacks/rust.md +0 -86
  158. package/.agent-context/stacks/typescript.md +0 -317
  159. package/.agent-context/state/skill-platform.json +0 -38
  160. package/lib/cli/skill-selector.mjs +0 -232
  161. package/lib/cli/templates/api-contract.md.id.tmpl +0 -143
  162. package/lib/cli/templates/api-contract.md.tmpl +0 -143
  163. package/lib/cli/templates/architecture-decision-record.md.id.tmpl +0 -106
  164. package/lib/cli/templates/architecture-decision-record.md.tmpl +0 -145
  165. package/lib/cli/templates/database-schema.md.id.tmpl +0 -74
  166. package/lib/cli/templates/database-schema.md.tmpl +0 -74
  167. package/lib/cli/templates/flow-overview.md.id.tmpl +0 -118
  168. package/lib/cli/templates/flow-overview.md.tmpl +0 -131
  169. package/lib/cli/templates/project-brief.md.id.tmpl +0 -55
  170. package/lib/cli/templates/project-brief.md.tmpl +0 -79
  171. package/scripts/init-project.ps1 +0 -105
  172. package/scripts/init-project.sh +0 -131
  173. package/scripts/skill-tier-policy.mjs +0 -76
  174. package/scripts/trust-scorer.mjs +0 -119
@@ -0,0 +1,22 @@
1
+
2
+ # Bootstrap DESIGN.md (UI/UX Art Direction)
3
+
4
+ When a user requests frontend design or redesign, the agent should automatically synthesize a complete DESIGN.md covering:
5
+ - Visual identity (color palette, typography, spacing, iconography)
6
+ - Layout and navigation principles
7
+ - Component library and atomic design system
8
+ - Accessibility and responsive guidelines
9
+ - User journey and interaction flows
10
+ - Design tokens and handoff notes for developers
11
+
12
+ The agent must:
13
+ 1. Read [AGENTS.md](../../AGENTS.md) for project context and team roles.
14
+ 2. Scan all files in [.agent-context/rules/](../rules/) for UI/UX and accessibility standards.
15
+ 3. Reference [docs/deep-dive.md](../../docs/deep-dive.md) and [docs/faq.md](../../docs/faq.md) for architecture and product background.
16
+ 4. If [docs/DESIGN.md](../../docs/DESIGN.md) exists, check for drift and propose improvements instead of rewriting from scratch.
17
+ 5. All references to docs or rules must be clickable markdown links.
18
+
19
+ Output:
20
+ - Write a full DESIGN.md in markdown, with clear sections and clickable links to referenced docs/rules.
21
+ - Use practical, modern, and accessible design language.
22
+ - Wait for user approval before generating Figma or code assets.
@@ -1,7 +1,41 @@
1
- # Prompts: Initialize Project
2
1
 
3
- > Copy-paste one of these prompts to your AI agent (Cursor, Windsurf, Copilot, Antigravity) right after cloning this repository.
4
- > V1.4 recommendation: run `bunx @fatidaprilian/agentic-senior-core init` first to compile dynamic rules operations context (Federated Governance baseline).
2
+ # Project Initialization Prompts
3
+
4
+ This prompt boots a repository with strict rules operations context (Federated Governance baseline).
5
+
6
+ When a new project is created or initialized, the agent should automatically:
7
+ 1. Read [AGENTS.md](../../AGENTS.md) to understand available roles and knowledge base.
8
+ 2. Scan all files in [.agent-context/rules/](../rules/) for mandatory engineering standards.
9
+ 3. Review dynamic stack and architecture signals from [docs/deep-dive.md](../../docs/deep-dive.md), [docs/faq.md](../../docs/faq.md), and task constraints.
10
+
11
+ ## Architect Mode (Recommended)
12
+ If the user describes a project or feature, the agent should:
13
+ 1. Propose the most efficient technology stack based on requirements and evidence.
14
+ 2. Explain why this stack is the best choice for the project.
15
+ 3. Draft a high-level architecture plan.
16
+ 4. Wait for user approval before scaffolding the project using the selected architecture playbook.
17
+
18
+ ## Direct Blueprint Mode
19
+ If the user specifies a framework/blueprint, the agent should:
20
+ 1. Read [AGENTS.md](../../AGENTS.md) for role context.
21
+ 2. Scan all files in [.agent-context/rules/](../rules/) for engineering standards.
22
+ 3. Reference [docs/deep-dive.md](../../docs/deep-dive.md) and [docs/faq.md](../../docs/faq.md) for stack/blueprint guidance.
23
+ 4. Scaffold the initial project structure following the blueprint exactly:
24
+ - Create all directories and files from the blueprint
25
+ - Set up environment config and validation (e.g., Zod, Pydantic, FluentValidation)
26
+ - Set up error handling foundation (base error class + global handler)
27
+ - Set up the logger
28
+ - Create a health check endpoint
29
+ - Initialize the ORM/Database connection
30
+ - Every file must follow [naming conventions](../rules/naming-conv.md)
31
+ - Every module must follow [architecture.md](../rules/architecture.md)
32
+ - Every dependency must be justified per [efficiency-vs-hype.md](../rules/efficiency-vs-hype.md)
33
+
34
+ ## Stacks & Blueprints Reference
35
+ See [docs/roadmap.md](../../docs/roadmap.md) and [docs/deep-dive.md](../../docs/deep-dive.md) for the latest stack and blueprint list.
36
+
37
+ ## UI/UX Bootstrap
38
+ When a user requests frontend or UI/UX design, the agent should automatically execute the [bootstrap-design.md](./bootstrap-design.md) prompt to synthesize DESIGN.md.
5
39
 
6
40
  ---
7
41
 
@@ -16,15 +50,15 @@ Context: You are a Principal Software Architect operating in a workspace with st
16
50
  Step 1: Context Gathering
17
51
  1. Read `AGENTS.md` to understand your role and available knowledge base.
18
52
  2. Scan all files in `.agent-context/rules/` to understand our mandatory engineering laws.
19
- 3. Review the available technology stacks in `.agent-context/stacks/` and blueprints in `.agent-context/blueprints/`.
53
+ 3. Review dynamic stack and architecture signals from project docs, repository evidence, and task constraints.
20
54
 
21
55
  Step 2: Architecture Proposal
22
56
  Based strictly on my project description and our repository's existing rules (especially `efficiency-vs-hype.md`):
23
- 1. Propose the most efficient technology stack from our approved profiles.
57
+ 1. Propose the most efficient technology stack based on requirements and evidence.
24
58
  2. Explain WHY this stack is the best choice for this specific project.
25
59
  3. Draft a high-level architecture plan.
26
60
 
27
- Do not write any application code yet. Write your proposal and wait for my approval. Once I approve, you will scaffold the project using the relevant blueprint.
61
+ Do not write any application code yet. Write your proposal and wait for my approval. Once I approve, you will scaffold the project using the selected architecture playbook.
28
62
  ```
29
63
 
30
64
  ---
@@ -38,8 +72,8 @@ I want to build [PROJECT NAME].
38
72
  Before writing any code:
39
73
  1. Read `AGENTS.md` to understand your role.
40
74
  2. Read ALL files in `.agent-context/rules/` to understand our engineering standards.
41
- 3. Read `.agent-context/stacks/[STACK].md` for language-specific guidelines.
42
- 4. Read `.agent-context/blueprints/[BLUEPRINT].md` for the project structure.
75
+ 3. Resolve language-specific guidance from dynamic stack signals.
76
+ 4. Resolve the project structure from the selected architecture playbook.
43
77
 
44
78
  Now scaffold the initial project structure following the blueprint exactly:
45
79
  - Create all directories and files from the blueprint
@@ -49,38 +83,20 @@ Now scaffold the initial project structure following the blueprint exactly:
49
83
  - Create a health check endpoint
50
84
  - Initialize the ORM/Database connection
51
85
 
52
- Every file MUST follow the naming conventions from rules/naming-conv.md.
53
- Every module MUST follow the architecture from rules/architecture.md.
54
- Every dependency MUST be justified per rules/efficiency-vs-hype.md.
86
+
87
+ Setiap file harus mengikuti [naming conventions](../rules/naming-conv.md).
88
+ Setiap modul harus mengikuti [architecture.md](../rules/architecture.md).
89
+ Setiap dependency harus justified sesuai [efficiency-vs-hype.md](../rules/efficiency-vs-hype.md).
55
90
  ```
56
91
 
57
92
  ---
58
93
 
59
- ## Available Stacks & Blueprints Reference
60
-
61
- ### Stacks (`[STACK].md`)
62
- - `typescript`
63
- - `python`
64
- - `java`
65
- - `php`
66
- - `go`
67
- - `csharp`
68
- - `rust`
69
- - `ruby`
70
-
71
- ### Blueprints (`[BLUEPRINT].md`)
72
- | Blueprint | Use When |
73
- |-----------|----------|
74
- | `api-nextjs` | Next.js App Router API project |
75
- | `nestjs-logic` | NestJS backend service |
76
- | `fastapi-service` | Python FastAPI backend service |
77
- | `laravel-api` | PHP Laravel 13 API |
78
- | `spring-boot-api`| Java Spring Boot 4 API |
79
- | `go-service` | Go chi HTTP service |
80
- | `aspnet-api` | C# ASP.NET Minimal API |
81
- | `ci-github-actions`| GitHub Actions CI/CD pipeline |
82
- | `ci-gitlab` | GitLab CI/CD pipeline |
83
- | `observability` | OpenTelemetry stack |
84
- | `graphql-grpc-api` | GraphQL / gRPC API definitions |
85
- | `infrastructure-as-code` | Infrastructure as Code (Terraform | Pulumi) |
86
- | `kubernetes-manifests` | Kubernetes manifests structure |
94
+ ## Referensi Stacks & Blueprints
95
+
96
+ Lihat [docs/roadmap.md](../../docs/roadmap.md) dan [docs/deep-dive.md](../../docs/deep-dive.md) untuk daftar stack/blueprint terbaru.
97
+
98
+ ---
99
+
100
+ ## Bootstrap UI/UX (DESIGN.md)
101
+
102
+ Untuk memulai desain UI/UX dari nol, gunakan prompt [bootstrap-design.md](./bootstrap-design.md) agar AI langsung membangunkan Art Director digital Anda.
@@ -13,8 +13,9 @@ Before making changes:
13
13
  1. Read .agent-context/rules/architecture.md — ensure proper layer separation.
14
14
  2. Read .agent-context/rules/naming-conv.md — fix all naming violations.
15
15
  3. Read .agent-context/rules/error-handling.md — fix error handling patterns.
16
- 4. Read .agent-context/stacks/typescript.md fix TypeScript-specific issues.
16
+ 4. Resolve active language guidance from dynamic stack signals (TypeScript in this repository).
17
17
  5. Enforce backend universal principles: no clever hacks, no premature abstraction, readability over brevity.
18
+ 6. Enforce Universal SOP hard gate: stop implementation if `docs/architecture-decision-record.md` is missing, and for UI scope stop if `docs/DESIGN.md` is missing.
18
19
 
19
20
  For every change you make, provide a Reasoning Chain:
20
21
  - What was wrong (rule reference)
@@ -12,7 +12,7 @@ Run a comprehensive code review on the current codebase (or the files I'm about
12
12
 
13
13
  Use these checklists:
14
14
  1. Read .agent-context/review-checklists/pr-checklist.md — apply every item.
15
- 2. Read .agent-context/review-checklists/security-audit.md — apply every item.
15
+ 2. Read .agent-context/review-checklists/architecture-review.md — apply every item.
16
16
  3. Apply documentation scope rules exactly: This applies to documentation, release notes, onboarding text, review summaries, and agent-facing explanations.
17
17
  4. Treat scope-style findings as advisory unless they hide factual errors, contract mismatches, or non-negotiable violations.
18
18
  5. Enforce documentation hard blockers on changed boundaries: public surface changes, API contract changes, and database structure changes must include synchronized documentation updates.
@@ -20,6 +20,7 @@ Use these checklists:
20
20
  7. Enforce cross-session consistency guardian: session handoff must include active architecture contract summary, drift detection must warn before direction changes, and direction changes require explicit user confirmation.
21
21
  8. Enforce explain-on-demand state visibility: default responses must avoid unnecessary state-file internals, state internals are exposed only on explicit request, and diagnostic mode must explain relevant state decisions when needed.
22
22
  9. Enforce single-source and lazy-loading policy: canonical rule source must be explicitly enforced, language-specific guidance must load lazily based on detected scope, and conflicting duplicate rule instructions must not appear during normal flow.
23
+ 10. Enforce Universal SOP hard gate: block coding flow when required project docs are missing (`docs/architecture-decision-record.md`, and for UI scope `docs/DESIGN.md`).
23
24
 
24
25
  For EVERY violation found:
25
26
  - State the exact file and line
@@ -44,7 +45,7 @@ If you want a faster review focusing on the most critical items:
44
45
 
45
46
  ```
46
47
  Quick review the current code. Check ONLY:
47
- 1. Any use of `any` type? (rules/stacks/typescript.md)
48
+ 1. Any use of `any` type? (dynamic TypeScript stack guidance)
48
49
  2. Any empty catch blocks? (rules/error-handling.md)
49
50
  3. Any N+1 queries? (rules/performance.md)
50
51
  4. Any hardcoded secrets? (rules/security.md)
@@ -44,7 +44,7 @@ VERDICT: PASS / FAIL (X/Y items passed)
44
44
  - [ ] No premature abstraction (base classes/util layers created only after repeated stable patterns)
45
45
  - [ ] Readability over brevity for maintainability (no compressed one-liners that hide intent)
46
46
 
47
- ### 3. Type Safety (→ stacks/typescript.md)
47
+ ### 3. Type Safety (→ dynamic TypeScript stack guidance)
48
48
  - [ ] No `any` type anywhere (use `unknown` + narrowing)
49
49
  - [ ] No `// @ts-ignore` (use `@ts-expect-error` with justification comment)
50
50
  - [ ] All function return types are explicit
@@ -129,3 +129,10 @@ VERDICT: PASS / FAIL (X/Y items passed)
129
129
  - [ ] Canonical rule source is explicitly defined and enforced
130
130
  - [ ] Language-specific guidance is loaded lazily based on detected scope
131
131
  - [ ] No conflicting duplicate rule instructions during normal flow
132
+
133
+ ### 15. Universal SOP Consolidation
134
+ - [ ] `.agent-context/rules/` remains the default guidance source for implementation and review
135
+ - [ ] Backend and frontend mindset checks are both applied when scope spans API and UI boundaries
136
+ - [ ] Security and testing requirements remain mandatory after static template purge
137
+ - [ ] Coding flow is blocked if `docs/architecture-decision-record.md` (or `docs/Architecture-Decision-Record.md`) is missing
138
+ - [ ] UI implementation flow is blocked if `docs/DESIGN.md` is missing
@@ -13,6 +13,17 @@ These principles are mandatory for backend and shared core modules.
13
13
 
14
14
  If a short and a clear implementation are functionally equivalent, choose the clear implementation.
15
15
 
16
+ ## Universal SOP Baseline (Mandatory)
17
+
18
+ The `.agent-context/rules/` directory is the default guidance source for implementation and review.
19
+
20
+ - Backend and frontend mindset checks are both required when a task spans API and UI boundaries.
21
+ - Security and testing are non-negotiable baseline requirements.
22
+ - Hard block before coding:
23
+ - `docs/architecture-decision-record.md` (alias: `docs/Architecture-Decision-Record.md`) must exist.
24
+ - For UI scope, `docs/DESIGN.md` must exist.
25
+ - If required project context docs are missing, stop implementation and bootstrap docs before writing application code.
26
+
16
27
  ## Rules as Guardian (Cross-Session Consistency)
17
28
 
18
29
  These guardrails are mandatory to preserve architecture direction across sessions.
@@ -11,8 +11,8 @@ UI scope trigger signals (any one is enough):
11
11
  - feature requests that include frontend deliverables even when backend changes are also included
12
12
 
13
13
  Mandatory behavior when triggered:
14
- - apply frontend excellence rubric checks from `.agent-context/review-checklists/frontend-excellence-rubric.md`
15
- - apply usability checks from `.agent-context/review-checklists/frontend-usability.md`
14
+ - apply consolidated review checks from `.agent-context/review-checklists/pr-checklist.md`
15
+ - apply structural checks from `.agent-context/review-checklists/architecture-review.md`
16
16
  - score and review generated UI work against visual intent, interaction quality, and conversion clarity
17
17
  - reject template-only repetitive outputs and force a distinct layout direction
18
18
 
@@ -14,7 +14,7 @@
14
14
 
15
15
  ## Required Agent Behavior
16
16
 
17
- 1. Before editing a `critical` area, load `.agent-context/review-checklists/security-audit.md` and `.agent-context/review-checklists/performance-audit.md`.
17
+ 1. Before editing a `critical` area, load `.agent-context/review-checklists/pr-checklist.md` and `.agent-context/review-checklists/architecture-review.md`.
18
18
  2. For boundary-crossing changes, verify no circular dependencies are introduced (see `dependency-map.md`).
19
19
  3. Every critical-path change must include explicit risk notes in PR description.
20
20
 
@@ -1,5 +1,5 @@
1
1
  {
2
- "generatedAt": "2026-04-18T05:17:09.876Z",
2
+ "generatedAt": "2026-04-18T13:21:21.615Z",
3
3
  "reportName": "memory-continuity-benchmark",
4
4
  "schemaVersion": "1.0.0",
5
5
  "passed": true,
@@ -8,13 +8,13 @@ description: Initialize a new project using Agentic-Senior-Core blueprints and e
8
8
 
9
9
  1. Read all rule files from `.agent-context/rules/` to understand engineering standards.
10
10
 
11
- 2. Read the language-specific profile from `.agent-context/stacks/` based on the project's tech stack.
11
+ 2. Resolve language-specific guidance from dynamic stack signals based on the project's goals and constraints.
12
12
 
13
- 3. Read the chosen blueprint from `.agent-context/blueprints/` (e.g., `api-nextjs.md` or `nestjs-logic.md`).
13
+ 3. Resolve the chosen architecture playbook (e.g., `api-nextjs` or `nestjs-logic`).
14
14
 
15
15
  4. Scaffold the complete project structure following the blueprint exactly:
16
16
  - Create all directories and files
17
- - Set up strict `tsconfig.json` (all flags from `stacks/typescript.md`)
17
+ - Set up strict `tsconfig.json` (using active TypeScript guidance)
18
18
  - Create `.env.example` with placeholder values
19
19
  - Set up Zod-validated environment config
20
20
  - Set up error handling foundation (base error class + global handler)
@@ -10,7 +10,7 @@ description: Refactor code or extract a module following architecture and naming
10
10
 
11
11
  3. Read `.agent-context/rules/error-handling.md` to understand error handling patterns.
12
12
 
13
- 4. Read the active language profile from `.agent-context/stacks/` (e.g., `typescript.md`).
13
+ 4. Resolve the active language profile from dynamic stack signals (e.g., TypeScript guidance).
14
14
 
15
15
  5. Analyze the target code for violations:
16
16
  - Layer leaks (business logic in controllers, SQL in services)
@@ -1,12 +1,11 @@
1
- ---
2
- description: Run a comprehensive code review using PR checklist and security audit
1
+ description: Run a comprehensive code review using PR and architecture checklists
3
2
  ---
4
3
 
5
4
  ## Workflow: Review Code
6
5
 
7
6
  1. Read `.agent-context/review-checklists/pr-checklist.md` and apply every item against the current codebase.
8
7
 
9
- 2. Read `.agent-context/review-checklists/security-audit.md` and apply every item against the current codebase.
8
+ 2. Read `.agent-context/review-checklists/architecture-review.md` and apply every item against the current codebase.
10
9
 
11
10
  3. For every violation found, provide a Reasoning Chain:
12
11
  - State the exact file and line
@@ -21,8 +20,8 @@ description: Run a comprehensive code review using PR checklist and security aud
21
20
  - PASS or FAIL for each item
22
21
  - Reasoning Chain for each failure
23
22
 
24
- ## SECURITY AUDIT RESULTS
25
- - Severity rating (CRITICAL / HIGH / MEDIUM / LOW) for each finding
23
+ ## ARCHITECTURE REVIEW RESULTS
24
+ - Boundary violation summary and risk level for each finding
26
25
  - Specific remediation for each finding
27
26
 
28
27
  ## VERDICT: PASS or FAIL
package/.cursorrules CHANGED
@@ -1,7 +1,7 @@
1
1
  # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
2
2
 
3
- Generated by Agentic-Senior-Core CLI v2.5.22
4
- Timestamp: 2026-04-18T03:00:00.000Z
3
+ Generated by Agentic-Senior-Core CLI v3.0.2
4
+ Timestamp: 2026-04-18T00:00:00.000Z
5
5
  Selected profile: beginner
6
6
  Selected policy file: .agent-context/policies/llm-judge-threshold.json
7
7
 
@@ -9,85 +9,41 @@ Selected policy file: .agent-context/policies/llm-judge-threshold.json
9
9
  1. Follow this compiled rulebook as the primary source.
10
10
  2. Resolve exceptions from .agent-override.md only when explicitly defined.
11
11
  3. Use architecture-map.md and dependency-map.md as change safety boundaries.
12
- 4. Enforce pr-checklist.md before declaring completion.
13
-
14
- ## OVERRIDE PROTOCOL
15
- - Default: strict compliance with this file.
16
- - Exception path: .agent-override.md may explicitly allow narrow deviations.
17
- - Scope policy: every override must include module scope, rationale, and expiry date.
12
+ 4. Enforce pr-checklist.md and architecture-review.md before declaring completion.
18
13
 
19
14
  ## BOOTSTRAP CHAIN (MANDATORY)
20
15
  Load every layer before responding. Do not skip steps:
21
16
  1. .agent-context/rules/
22
- 2. .agent-context/stacks/
23
- 3. .agent-context/blueprints/
24
- 4. .agent-context/skills/
25
- 5. .agent-context/prompts/
26
- 6. .agent-context/profiles/
27
- 7. .agent-context/state/
28
- 8. .agent-context/policies/llm-judge-threshold.json
17
+ 2. Dynamic stack strategy signals from project context and live evidence.
18
+ 3. Dynamic architecture playbook signals from requirements and repository state.
19
+ 4. .agent-context/prompts/
20
+ 5. .agent-context/review-checklists/
21
+ 6. .agent-context/state/
22
+ 7. .agent-context/policies/llm-judge-threshold.json
23
+ 8. docs/ project context (or bootstrap prompts when docs are not materialized)
29
24
 
30
25
  Primary entrypoint: .cursorrules
31
26
  Mirror entrypoint: .windsurfrules
32
27
  Canonical baseline: .instructions.md
33
- ## LAYER 1: UNIVERSAL RULES (MANDATORY)
34
- Read every file under .agent-context/rules/ before implementation:
35
- 1. .agent-context/rules/api-docs.md
36
- 2. .agent-context/rules/architecture.md
37
- 3. .agent-context/rules/database-design.md
38
- 4. .agent-context/rules/efficiency-vs-hype.md
39
- 5. .agent-context/rules/error-handling.md
40
- 6. .agent-context/rules/event-driven.md
41
- 7. .agent-context/rules/frontend-architecture.md
42
- 8. .agent-context/rules/git-workflow.md
43
- 9. .agent-context/rules/microservices.md
44
- 10. .agent-context/rules/naming-conv.md
45
- 11. .agent-context/rules/performance.md
46
- 12. .agent-context/rules/realtime.md
47
- 13. .agent-context/rules/security.md
48
- 14. .agent-context/rules/testing.md
49
28
 
29
+ ## LAYER 1: UNIVERSAL RULES (MANDATORY)
30
+ Read every file under .agent-context/rules/ before implementation.
50
31
  Conflict resolution: prioritize data safety and API contract integrity first, then writing polish.
51
- ## LAYER 2: STACK PROFILE (typescript.md)
52
- Source: .agent-context/stacks/typescript.md
53
- Summary: TypeScript Stack Profile The "Galak" Standard
54
- Load this stack profile to enforce language-specific conventions.
55
- ## LAYER 3: BLUEPRINT PROFILE (api-nextjs.md)
56
- Source: .agent-context/blueprints/api-nextjs.md
57
- Summary: Blueprint: Next.js API Project (App Router)
58
- Load this blueprint when scaffolding or changing architecture boundaries.
59
- ## LAYER 3B: CI/CD GUARDRAILS
60
- Load these CI blueprints when pipeline or release logic is touched:
61
- 1. .agent-context/blueprints/ci-github-actions.md
62
- 2. .agent-context/blueprints/ci-gitlab.md
63
- ## SKILL PACK: Frontend
64
- Source: .agent-context/skills/frontend.md
65
- Default tier: advance
66
- Selected tier: advance
67
- Evidence: Frontend usability audit, accessibility checks, and visual regression output.
68
- Purpose: Unified frontend delivery covering UI architecture, motion, accessibility, and conversion clarity.
69
- Load this skill pack and apply every Must-Have Check.
70
- ## SKILL PACK: Fullstack
71
- Source: .agent-context/skills/fullstack.md
72
- Default tier: advance
73
- Selected tier: advance
74
- Evidence: End-to-end tests, contract validation, and feature parity review.
75
- Purpose: Single-path product delivery across frontend and backend boundaries.
76
- Load this skill pack and apply every Must-Have Check.
77
- ## SKILL PACK: CLI
78
- Source: .agent-context/skills/cli.md
79
- Default tier: advance
80
- Selected tier: advance
81
- Evidence: CLI smoke tests, dry-run output, and automation-friendly reports.
82
- Purpose: Smart command-line delivery with safe defaults, machine-readable output, and upgrade flows.
83
- Load this skill pack and apply every Must-Have Check.
84
- ## LAYER 7: STATE AWARENESS (MANDATORY)
85
- Load these files before touching critical paths:
86
- 1. .agent-context/state/architecture-map.md
87
- 2. .agent-context/state/dependency-map.md
88
- Use these maps to prevent unsafe cross-module changes.
32
+
33
+ ## LAYER 2 POLICY: DYNAMIC STACK STRATEGY
34
+ Resolve stack guidance lazily from project evidence. Do not depend on deleted static stack directories.
35
+
36
+ ## LAYER 3 POLICY: DYNAMIC ARCHITECTURE PLAYBOOKS
37
+ Resolve architecture guidance lazily from project docs and task boundaries. Do not depend on deleted static blueprint directories.
38
+
39
+ ## STATE AWARENESS (MANDATORY)
40
+ Load .agent-context/state/architecture-map.md and .agent-context/state/dependency-map.md before touching critical paths.
41
+
89
42
  ## REVIEW CHECKLISTS (MANDATORY)
90
43
  1. .agent-context/review-checklists/pr-checklist.md
91
- 2. .agent-context/review-checklists/security-audit.md (when security-sensitive)
92
- 3. .agent-context/review-checklists/performance-audit.md (when perf-critical)
44
+ 2. .agent-context/review-checklists/architecture-review.md
93
45
  Do not claim done before checklist pass.
46
+
47
+ ## UNIVERSAL SOP HARD GATES
48
+ - Stop coding if docs/architecture-decision-record.md (or docs/Architecture-Decision-Record.md) is missing.
49
+ - For UI scope, stop coding if docs/DESIGN.md is missing.
@@ -2,7 +2,7 @@
2
2
 
3
3
  Adapter Mode: thin
4
4
  Adapter Source: .instructions.md
5
- Canonical Snapshot SHA256: 2a2a036b4fb90f9e668163b83614f2339044c0d021a6eaf2f380e626dfe72de0
5
+ Canonical Snapshot SHA256: 354edbbfaedec284ddcc6d4a5bb5393a7f5385650d1a6ae84a2d9633b5a6d10d
6
6
 
7
7
  Canonical policy source: [.instructions.md](../.instructions.md).
8
8
 
@@ -10,12 +10,11 @@ Canonical policy source: [.instructions.md](../.instructions.md).
10
10
 
11
11
  1. Load [.instructions.md](../.instructions.md) first.
12
12
  2. Apply baseline rules from [.agent-context/rules/](../.agent-context/rules).
13
- 3. Load language profile from [.agent-context/stacks/](../.agent-context/stacks).
14
- 4. Use [.agent-context/blueprints/](../.agent-context/blueprints) when creating new modules/projects.
15
- 5. Load domain skills from [.agent-context/skills/](../.agent-context/skills).
16
- 6. Load request templates from [.agent-context/prompts/](../.agent-context/prompts).
17
- 7. Apply team defaults from [.agent-context/profiles/](../.agent-context/profiles), state awareness from [.agent-context/state/](../.agent-context/state), and policy thresholds from [.agent-context/policies/](../.agent-context/policies).
13
+ 3. Load request templates from [.agent-context/prompts/](../.agent-context/prompts).
14
+ 4. Apply review contracts from [.agent-context/review-checklists/](../.agent-context/review-checklists).
15
+ 5. Apply state awareness from [.agent-context/state/](../.agent-context/state) and policy thresholds from [.agent-context/policies/](../.agent-context/policies).
16
+ 6. Resolve stack and architecture choices dynamically from project context docs plus live evidence.
18
17
 
19
18
  ## Completion Gate
20
19
 
21
- Run [.agent-context/review-checklists/pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring completion.
20
+ Run [.agent-context/review-checklists/pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring completion.
@@ -2,7 +2,7 @@
2
2
 
3
3
  Adapter Mode: thin
4
4
  Adapter Source: .instructions.md
5
- Canonical Snapshot SHA256: 2a2a036b4fb90f9e668163b83614f2339044c0d021a6eaf2f380e626dfe72de0
5
+ Canonical Snapshot SHA256: 354edbbfaedec284ddcc6d4a5bb5393a7f5385650d1a6ae84a2d9633b5a6d10d
6
6
 
7
7
  The canonical policy source for this repository is [.instructions.md](../.instructions.md).
8
8
 
@@ -10,11 +10,10 @@ The canonical policy source for this repository is [.instructions.md](../.instru
10
10
 
11
11
  1. Read [.instructions.md](../.instructions.md) first.
12
12
  2. Read baseline rules in [.agent-context/rules/](../.agent-context/rules).
13
- 3. Load language profile from [.agent-context/stacks/](../.agent-context/stacks).
14
- 4. Load blueprints from [.agent-context/blueprints/](../.agent-context/blueprints) for scaffolding requests.
15
- 5. Load domain skills from [.agent-context/skills/](../.agent-context/skills).
16
- 6. Load request templates from [.agent-context/prompts/](../.agent-context/prompts).
17
- 7. Apply team defaults from [.agent-context/profiles/](../.agent-context/profiles), state awareness from [.agent-context/state/](../.agent-context/state), and thresholds from [.agent-context/policies/](../.agent-context/policies).
13
+ 3. Load request templates from [.agent-context/prompts/](../.agent-context/prompts).
14
+ 4. Apply review contracts from [.agent-context/review-checklists/](../.agent-context/review-checklists).
15
+ 5. Apply state awareness from [.agent-context/state/](../.agent-context/state) and thresholds from [.agent-context/policies/](../.agent-context/policies).
16
+ 6. Resolve stack and architecture choices dynamically from project context docs plus live evidence.
18
17
 
19
18
  ## Completion Gate
20
19
 
package/.windsurfrules CHANGED
@@ -1,7 +1,7 @@
1
1
  # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
2
2
 
3
- Generated by Agentic-Senior-Core CLI v2.5.22
4
- Timestamp: 2026-04-18T03:00:00.000Z
3
+ Generated by Agentic-Senior-Core CLI v3.0.2
4
+ Timestamp: 2026-04-18T00:00:00.000Z
5
5
  Selected profile: beginner
6
6
  Selected policy file: .agent-context/policies/llm-judge-threshold.json
7
7
 
@@ -9,85 +9,41 @@ Selected policy file: .agent-context/policies/llm-judge-threshold.json
9
9
  1. Follow this compiled rulebook as the primary source.
10
10
  2. Resolve exceptions from .agent-override.md only when explicitly defined.
11
11
  3. Use architecture-map.md and dependency-map.md as change safety boundaries.
12
- 4. Enforce pr-checklist.md before declaring completion.
13
-
14
- ## OVERRIDE PROTOCOL
15
- - Default: strict compliance with this file.
16
- - Exception path: .agent-override.md may explicitly allow narrow deviations.
17
- - Scope policy: every override must include module scope, rationale, and expiry date.
12
+ 4. Enforce pr-checklist.md and architecture-review.md before declaring completion.
18
13
 
19
14
  ## BOOTSTRAP CHAIN (MANDATORY)
20
15
  Load every layer before responding. Do not skip steps:
21
16
  1. .agent-context/rules/
22
- 2. .agent-context/stacks/
23
- 3. .agent-context/blueprints/
24
- 4. .agent-context/skills/
25
- 5. .agent-context/prompts/
26
- 6. .agent-context/profiles/
27
- 7. .agent-context/state/
28
- 8. .agent-context/policies/llm-judge-threshold.json
17
+ 2. Dynamic stack strategy signals from project context and live evidence.
18
+ 3. Dynamic architecture playbook signals from requirements and repository state.
19
+ 4. .agent-context/prompts/
20
+ 5. .agent-context/review-checklists/
21
+ 6. .agent-context/state/
22
+ 7. .agent-context/policies/llm-judge-threshold.json
23
+ 8. docs/ project context (or bootstrap prompts when docs are not materialized)
29
24
 
30
25
  Primary entrypoint: .cursorrules
31
26
  Mirror entrypoint: .windsurfrules
32
27
  Canonical baseline: .instructions.md
33
- ## LAYER 1: UNIVERSAL RULES (MANDATORY)
34
- Read every file under .agent-context/rules/ before implementation:
35
- 1. .agent-context/rules/api-docs.md
36
- 2. .agent-context/rules/architecture.md
37
- 3. .agent-context/rules/database-design.md
38
- 4. .agent-context/rules/efficiency-vs-hype.md
39
- 5. .agent-context/rules/error-handling.md
40
- 6. .agent-context/rules/event-driven.md
41
- 7. .agent-context/rules/frontend-architecture.md
42
- 8. .agent-context/rules/git-workflow.md
43
- 9. .agent-context/rules/microservices.md
44
- 10. .agent-context/rules/naming-conv.md
45
- 11. .agent-context/rules/performance.md
46
- 12. .agent-context/rules/realtime.md
47
- 13. .agent-context/rules/security.md
48
- 14. .agent-context/rules/testing.md
49
28
 
29
+ ## LAYER 1: UNIVERSAL RULES (MANDATORY)
30
+ Read every file under .agent-context/rules/ before implementation.
50
31
  Conflict resolution: prioritize data safety and API contract integrity first, then writing polish.
51
- ## LAYER 2: STACK PROFILE (typescript.md)
52
- Source: .agent-context/stacks/typescript.md
53
- Summary: TypeScript Stack Profile The "Galak" Standard
54
- Load this stack profile to enforce language-specific conventions.
55
- ## LAYER 3: BLUEPRINT PROFILE (api-nextjs.md)
56
- Source: .agent-context/blueprints/api-nextjs.md
57
- Summary: Blueprint: Next.js API Project (App Router)
58
- Load this blueprint when scaffolding or changing architecture boundaries.
59
- ## LAYER 3B: CI/CD GUARDRAILS
60
- Load these CI blueprints when pipeline or release logic is touched:
61
- 1. .agent-context/blueprints/ci-github-actions.md
62
- 2. .agent-context/blueprints/ci-gitlab.md
63
- ## SKILL PACK: Frontend
64
- Source: .agent-context/skills/frontend.md
65
- Default tier: advance
66
- Selected tier: advance
67
- Evidence: Frontend usability audit, accessibility checks, and visual regression output.
68
- Purpose: Unified frontend delivery covering UI architecture, motion, accessibility, and conversion clarity.
69
- Load this skill pack and apply every Must-Have Check.
70
- ## SKILL PACK: Fullstack
71
- Source: .agent-context/skills/fullstack.md
72
- Default tier: advance
73
- Selected tier: advance
74
- Evidence: End-to-end tests, contract validation, and feature parity review.
75
- Purpose: Single-path product delivery across frontend and backend boundaries.
76
- Load this skill pack and apply every Must-Have Check.
77
- ## SKILL PACK: CLI
78
- Source: .agent-context/skills/cli.md
79
- Default tier: advance
80
- Selected tier: advance
81
- Evidence: CLI smoke tests, dry-run output, and automation-friendly reports.
82
- Purpose: Smart command-line delivery with safe defaults, machine-readable output, and upgrade flows.
83
- Load this skill pack and apply every Must-Have Check.
84
- ## LAYER 7: STATE AWARENESS (MANDATORY)
85
- Load these files before touching critical paths:
86
- 1. .agent-context/state/architecture-map.md
87
- 2. .agent-context/state/dependency-map.md
88
- Use these maps to prevent unsafe cross-module changes.
32
+
33
+ ## LAYER 2 POLICY: DYNAMIC STACK STRATEGY
34
+ Resolve stack guidance lazily from project evidence. Do not depend on deleted static stack directories.
35
+
36
+ ## LAYER 3 POLICY: DYNAMIC ARCHITECTURE PLAYBOOKS
37
+ Resolve architecture guidance lazily from project docs and task boundaries. Do not depend on deleted static blueprint directories.
38
+
39
+ ## STATE AWARENESS (MANDATORY)
40
+ Load .agent-context/state/architecture-map.md and .agent-context/state/dependency-map.md before touching critical paths.
41
+
89
42
  ## REVIEW CHECKLISTS (MANDATORY)
90
43
  1. .agent-context/review-checklists/pr-checklist.md
91
- 2. .agent-context/review-checklists/security-audit.md (when security-sensitive)
92
- 3. .agent-context/review-checklists/performance-audit.md (when perf-critical)
44
+ 2. .agent-context/review-checklists/architecture-review.md
93
45
  Do not claim done before checklist pass.
46
+
47
+ ## UNIVERSAL SOP HARD GATES
48
+ - Stop coding if docs/architecture-decision-record.md (or docs/Architecture-Decision-Record.md) is missing.
49
+ - For UI scope, stop coding if docs/DESIGN.md is missing.