@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
@@ -16,15 +16,15 @@ Context: You are a Principal Software Architect operating in a workspace with st
16
16
  Step 1: Context Gathering
17
17
  1. Read `AGENTS.md` to understand your role and available knowledge base.
18
18
  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/`.
19
+ 3. Review dynamic stack and architecture signals from project docs, repository evidence, and task constraints.
20
20
 
21
21
  Step 2: Architecture Proposal
22
22
  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.
23
+ 1. Propose the most efficient technology stack based on requirements and evidence.
24
24
  2. Explain WHY this stack is the best choice for this specific project.
25
25
  3. Draft a high-level architecture plan.
26
26
 
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.
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 selected architecture playbook.
28
28
  ```
29
29
 
30
30
  ---
@@ -38,8 +38,8 @@ I want to build [PROJECT NAME].
38
38
  Before writing any code:
39
39
  1. Read `AGENTS.md` to understand your role.
40
40
  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.
41
+ 3. Resolve language-specific guidance from dynamic stack signals.
42
+ 4. Resolve the project structure from the selected architecture playbook.
43
43
 
44
44
  Now scaffold the initial project structure following the blueprint exactly:
45
45
  - Create all directories and files from the blueprint
@@ -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-18T12:31:23.643Z",
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.0
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.0
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.
package/AGENTS.md CHANGED
@@ -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
  This file is an adapter entrypoint for agent discovery.
8
8
  The canonical policy source is [.instructions.md](.instructions.md).
@@ -11,13 +11,11 @@ The canonical policy source is [.instructions.md](.instructions.md).
11
11
 
12
12
  1. Load [.instructions.md](.instructions.md) first as the single source of truth.
13
13
  2. Read baseline governance from [.agent-context/rules/](.agent-context/rules).
14
- 3. Load language conventions from [.agent-context/stacks/](.agent-context/stacks).
15
- 4. Load scaffolding references from [.agent-context/blueprints/](.agent-context/blueprints) when creating modules/projects.
16
- 5. Load domain packs from [.agent-context/skills/](.agent-context/skills).
17
- 6. Apply request templates from [.agent-context/prompts/](.agent-context/prompts).
18
- 7. Apply team governance defaults from [.agent-context/profiles/](.agent-context/profiles).
19
- 8. Read change-risk maps from [.agent-context/state/](.agent-context/state).
20
- 9. Enforce policy thresholds from [.agent-context/policies/](.agent-context/policies).
14
+ 3. Apply request templates from [.agent-context/prompts/](.agent-context/prompts).
15
+ 4. Enforce review contracts from [.agent-context/review-checklists/](.agent-context/review-checklists).
16
+ 5. Read change-risk maps and continuity state from [.agent-context/state/](.agent-context/state).
17
+ 6. Enforce policy thresholds from [.agent-context/policies/](.agent-context/policies).
18
+ 7. Use dynamic stack and architecture reasoning from project context docs and live research signals.
21
19
 
22
20
  ## Trigger Rules
23
21
 
@@ -25,4 +23,4 @@ The canonical policy source is [.instructions.md](.instructions.md).
25
23
  - Refactor or fix requests: propose plan first, then execute safely.
26
24
  - Completion: run [.agent-context/review-checklists/pr-checklist.md](.agent-context/review-checklists/pr-checklist.md) before declaring done.
27
25
 
28
- If this adapter drifts from canonical behavior, refresh from [.instructions.md](.instructions.md) and update the hash metadata.
26
+ If this adapter drifts from canonical behavior, refresh from [.instructions.md](.instructions.md) and update the hash metadata.
package/CONTRIBUTING.md CHANGED
@@ -9,8 +9,8 @@ Thanks for wanting to make AI agents write better code. Here's how to contribute
9
9
  | Type | Where | Description |
10
10
  |------|-------|-------------|
11
11
  | New rule | `.agent-context/rules/` | Universal engineering standard |
12
- | New stack | `.agent-context/stacks/` | Language-specific profile (Python, Go, Java, etc.) |
13
- | New blueprint | `.agent-context/blueprints/` | Project scaffolding template |
12
+ | Stack strategy update | `.agent-context/rules/`, `.agent-context/state/stack-research-snapshot.json` | Dynamic language/runtime guidance and evidence |
13
+ | Architecture playbook update | `.agent-context/prompts/`, `lib/cli/compiler.mjs` | Dynamic scaffolding and project-context guidance |
14
14
  | New checklist | `.agent-context/review-checklists/` | Self-audit guide |
15
15
  | State intelligence update | `.agent-context/state/` | Architecture boundaries and dependency map |
16
16
  | Override policy update | `.agent-override.md` | Scoped enterprise rule exceptions |
@@ -44,36 +44,23 @@ If all three are "yes", it belongs here.
44
44
 
45
45
  ---
46
46
 
47
- ## How to Add a New Stack Profile (e.g., Python)
48
-
49
- 1. Create `.agent-context/stacks/python.md`
50
- 2. Follow the structure of `stacks/typescript.md`:
51
- - Compiler/linter configuration (non-negotiable settings)
52
- - Type system rules (the equivalent of "ban any")
53
- - Validation at boundaries (Pydantic, marshmallow, etc.)
54
- - Import conventions
55
- - Async patterns
56
- - Preferred libraries with justification
57
- - Banned patterns with alternatives
58
- 3. Update `AGENTS.md` to add the new stack to the manifest table
59
- 4. Run `bun scripts/validate.ts` to verify everything links correctly
60
- 5. Open a PR
47
+ ## How to Add or Adjust Stack Strategy Signals (e.g., Python)
48
+
49
+ 1. Update relevant universal guidance in `.agent-context/rules/` (typing, validation, architecture constraints).
50
+ 2. Add or adjust measurable stack evidence in `.agent-context/state/stack-research-snapshot.json`.
51
+ 3. Update stack-facing wording in prompts or CLI output when behavior changes.
52
+ 4. Run `npm run validate` to verify references and policy checks.
53
+ 5. Open a PR.
61
54
 
62
55
  ---
63
56
 
64
- ## How to Add a New Blueprint
65
-
66
- 1. Create `.agent-context/blueprints/<framework-name>.md`
67
- 2. Include:
68
- - Tech stack summary
69
- - Complete directory structure
70
- - Code patterns for each layer (with full examples)
71
- - Environment validation setup
72
- - Error handling setup
73
- - Scaffolding checklist
74
- 3. Update `AGENTS.md` manifest
75
- 4. Update `prompts/init-project.md` available blueprints table
76
- 5. Validate and PR
57
+ ## How to Add or Adjust Architecture Playbooks
58
+
59
+ 1. Update the architecture options in `.agent-context/prompts/init-project.md` and related discovery guidance.
60
+ 2. Update compiler/init behavior if generated project-context guidance or bootstrap flow changes.
61
+ 3. Keep transport/service/repository separation and validation boundaries explicit in examples.
62
+ 4. Run `npm run validate` and `npm test`.
63
+ 5. Open a PR.
77
64
 
78
65
  ---
79
66
 
@@ -96,7 +83,7 @@ If all three are "yes", it belongs here.
96
83
  1. **Fork** the repository
97
84
  2. **Branch** from `main`: `feat/add-python-stack` or `docs/fix-security-typo`
98
85
  3. **Write** your content following the quality standard above
99
- 4. **Validate**: `bun scripts/validate.ts` must pass
86
+ 4. **Validate**: `npm run validate` must pass
100
87
  5. **Commit** with Conventional Commits: `feat(stacks): add Python profile`
101
88
  6. **Open PR** with:
102
89
  - What you added/changed
@@ -123,7 +110,7 @@ git clone https://github.com/fatidaprilian/Agentic-Senior-Core.git
123
110
  cd Agentic-Senior-Core
124
111
 
125
112
  # Validate
126
- bun run validate
113
+ npm run validate
127
114
 
128
115
  # Test interactive CLI
129
116
  node ./bin/agentic-senior-core.js init /tmp/test-project