@ryuenn3123/agentic-senior-core 2.0.3 → 2.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (87) hide show
  1. package/.agent-context/blueprints/mobile-app.md +21 -21
  2. package/.agent-context/profiles/platform.md +13 -13
  3. package/.agent-context/profiles/regulated.md +13 -13
  4. package/.agent-context/profiles/startup.md +13 -13
  5. package/.agent-context/review-checklists/frontend-skill-parity.md +28 -28
  6. package/.agent-context/review-checklists/frontend-usability.md +33 -33
  7. package/.agent-context/review-checklists/release-operations.md +29 -29
  8. package/.agent-context/skills/README.md +62 -62
  9. package/.agent-context/skills/backend/README.md +67 -67
  10. package/.agent-context/skills/backend/architecture.md +360 -360
  11. package/.agent-context/skills/backend/compatibility-manifest.json +8 -8
  12. package/.agent-context/skills/backend/data-access.md +230 -230
  13. package/.agent-context/skills/backend/errors.md +137 -137
  14. package/.agent-context/skills/backend/validation.md +116 -116
  15. package/.agent-context/skills/backend.md +28 -28
  16. package/.agent-context/skills/cli/README.md +49 -49
  17. package/.agent-context/skills/cli/compatibility-manifest.json +8 -8
  18. package/.agent-context/skills/cli/init.md +37 -37
  19. package/.agent-context/skills/cli/output.md +35 -35
  20. package/.agent-context/skills/cli/upgrade.md +37 -37
  21. package/.agent-context/skills/cli.md +28 -28
  22. package/.agent-context/skills/distribution/README.md +18 -18
  23. package/.agent-context/skills/distribution/compatibility-manifest.json +8 -8
  24. package/.agent-context/skills/distribution/compatibility.md +31 -31
  25. package/.agent-context/skills/distribution/publish.md +36 -36
  26. package/.agent-context/skills/distribution/rollback.md +31 -31
  27. package/.agent-context/skills/distribution.md +28 -28
  28. package/.agent-context/skills/frontend/README.md +35 -35
  29. package/.agent-context/skills/frontend/accessibility.md +107 -107
  30. package/.agent-context/skills/frontend/compatibility-manifest.json +8 -8
  31. package/.agent-context/skills/frontend/motion.md +66 -66
  32. package/.agent-context/skills/frontend/performance.md +62 -62
  33. package/.agent-context/skills/frontend/ui-architecture.md +128 -128
  34. package/.agent-context/skills/frontend.md +29 -29
  35. package/.agent-context/skills/fullstack/README.md +18 -18
  36. package/.agent-context/skills/fullstack/compatibility-manifest.json +8 -8
  37. package/.agent-context/skills/fullstack/contracts.md +52 -52
  38. package/.agent-context/skills/fullstack/end-to-end.md +41 -41
  39. package/.agent-context/skills/fullstack/feature-slicing.md +64 -64
  40. package/.agent-context/skills/fullstack.md +26 -26
  41. package/.agent-context/skills/index.json +107 -107
  42. package/.agent-context/skills/review-quality/README.md +18 -18
  43. package/.agent-context/skills/review-quality/benchmark.md +29 -29
  44. package/.agent-context/skills/review-quality/compatibility-manifest.json +8 -8
  45. package/.agent-context/skills/review-quality/planning.md +37 -37
  46. package/.agent-context/skills/review-quality/security.md +33 -33
  47. package/.agent-context/skills/review-quality.md +27 -27
  48. package/.agent-context/stacks/flutter.md +16 -16
  49. package/.agent-context/stacks/react-native.md +16 -16
  50. package/.agent-context/state/architecture-map.md +25 -25
  51. package/.agent-context/state/benchmark-analysis.json +431 -431
  52. package/.agent-context/state/benchmark-thresholds.json +10 -10
  53. package/.agent-context/state/benchmark-watchlist.json +19 -19
  54. package/.agent-context/state/dependency-map.md +32 -32
  55. package/.agent-context/state/quality-trend-report.json +79 -0
  56. package/.agent-context/state/skill-platform.json +38 -38
  57. package/.agent-context/state/token-optimization-benchmark.json +130 -0
  58. package/.agent-override.md +36 -36
  59. package/.cursorrules +1 -1
  60. package/.gemini/instructions.md +21 -97
  61. package/.github/ISSUE_TEMPLATE/v1.7-frontend-work-item.yml +54 -54
  62. package/.github/copilot-instructions.md +21 -166
  63. package/.github/workflows/benchmark-detection.yml +38 -38
  64. package/.github/workflows/benchmark-intelligence.yml +50 -50
  65. package/.github/workflows/frontend-usability-gate.yml +36 -36
  66. package/.github/workflows/release-gate.yml +32 -32
  67. package/.github/workflows/sbom-compliance.yml +32 -32
  68. package/.windsurfrules +1 -1
  69. package/AGENTS.md +28 -181
  70. package/README.md +368 -346
  71. package/lib/cli/commands/optimize.mjs +171 -171
  72. package/lib/cli/compatibility.mjs +124 -124
  73. package/lib/cli/token-optimization.mjs +275 -275
  74. package/mcp.json +92 -92
  75. package/package.json +3 -1
  76. package/scripts/benchmark-gate.mjs +121 -121
  77. package/scripts/benchmark-intelligence.mjs +140 -140
  78. package/scripts/detection-benchmark.mjs +138 -138
  79. package/scripts/frontend-usability-audit.mjs +87 -87
  80. package/scripts/generate-sbom.mjs +61 -61
  81. package/scripts/init-project.ps1 +104 -104
  82. package/scripts/llm-judge.mjs +664 -664
  83. package/scripts/quality-trend-report.mjs +289 -0
  84. package/scripts/release-gate.mjs +259 -204
  85. package/scripts/skill-tier-policy.mjs +75 -75
  86. package/scripts/token-optimization-benchmark.mjs +252 -0
  87. package/scripts/validate.mjs +865 -811
@@ -1,10 +1,10 @@
1
- {
2
- "minimumTop1Accuracy": 0.9,
3
- "maximumManualCorrectionRate": 0.12,
4
- "maximumTop1AccuracyDrop": 0.02,
5
- "maximumManualCorrectionIncrease": 0.03,
6
- "previousReleaseBaseline": {
7
- "top1Accuracy": 0.9167,
8
- "manualCorrectionRate": 0.0833
9
- }
10
- }
1
+ {
2
+ "minimumTop1Accuracy": 0.9,
3
+ "maximumManualCorrectionRate": 0.12,
4
+ "maximumTop1AccuracyDrop": 0.02,
5
+ "maximumManualCorrectionIncrease": 0.03,
6
+ "previousReleaseBaseline": {
7
+ "top1Accuracy": 0.9167,
8
+ "manualCorrectionRate": 0.0833
9
+ }
10
+ }
@@ -1,19 +1,19 @@
1
- {
2
- "repositories": [
3
- {
4
- "repository": "sickn33/antigravity-awesome-skills",
5
- "owner": "core-architecture",
6
- "lastReviewedAt": "2026-04-02"
7
- },
8
- {
9
- "repository": "github/awesome-copilot",
10
- "owner": "core-architecture",
11
- "lastReviewedAt": "2026-04-02"
12
- },
13
- {
14
- "repository": "MiniMax-AI/skills",
15
- "owner": "frontend-governance",
16
- "lastReviewedAt": "2026-04-02"
17
- }
18
- ]
19
- }
1
+ {
2
+ "repositories": [
3
+ {
4
+ "repository": "sickn33/antigravity-awesome-skills",
5
+ "owner": "core-architecture",
6
+ "lastReviewedAt": "2026-04-02"
7
+ },
8
+ {
9
+ "repository": "github/awesome-copilot",
10
+ "owner": "core-architecture",
11
+ "lastReviewedAt": "2026-04-02"
12
+ },
13
+ {
14
+ "repository": "MiniMax-AI/skills",
15
+ "owner": "frontend-governance",
16
+ "lastReviewedAt": "2026-04-02"
17
+ }
18
+ ]
19
+ }
@@ -1,32 +1,32 @@
1
- # Dependency Map (State Awareness)
2
-
3
- > This map documents allowed dependency direction to prevent circular references during refactors.
4
-
5
- ## Layer Dependency Rules
6
-
7
- 1. Transport layer may depend on Service layer.
8
- 2. Service layer may depend on Domain contracts and Repository interfaces.
9
- 3. Infrastructure layer may implement Repository interfaces.
10
- 4. Domain layer must not depend on Transport or Infrastructure.
11
-
12
- ## Module-Level Constraints
13
-
14
- | Source Module | Allowed Dependencies | Forbidden Dependencies |
15
- |---------------|----------------------|------------------------|
16
- | `authentication` | `shared`, `user` | `payment` internals |
17
- | `payment` | `shared`, `billing`, `notification` contracts | `authentication` internals |
18
- | `reporting` | `shared`, read-only repository ports | write-side service internals |
19
- | `frontend` | public API clients only | direct repository access |
20
-
21
- ## Circular Dependency Guardrail
22
-
23
- When refactoring:
24
-
25
- 1. Detect import graph changes before applying bulk edits.
26
- 2. Reject any change introducing `A -> B -> A` cycles.
27
- 3. Move shared contracts to `shared` module when two-way dependencies appear.
28
-
29
- ## Project-Specific Notes
30
-
31
- - Replace sample modules with your real domain modules.
32
- - Keep this map synchronized with architecture decisions and ADRs.
1
+ # Dependency Map (State Awareness)
2
+
3
+ > This map documents allowed dependency direction to prevent circular references during refactors.
4
+
5
+ ## Layer Dependency Rules
6
+
7
+ 1. Transport layer may depend on Service layer.
8
+ 2. Service layer may depend on Domain contracts and Repository interfaces.
9
+ 3. Infrastructure layer may implement Repository interfaces.
10
+ 4. Domain layer must not depend on Transport or Infrastructure.
11
+
12
+ ## Module-Level Constraints
13
+
14
+ | Source Module | Allowed Dependencies | Forbidden Dependencies |
15
+ |---------------|----------------------|------------------------|
16
+ | `authentication` | `shared`, `user` | `payment` internals |
17
+ | `payment` | `shared`, `billing`, `notification` contracts | `authentication` internals |
18
+ | `reporting` | `shared`, read-only repository ports | write-side service internals |
19
+ | `frontend` | public API clients only | direct repository access |
20
+
21
+ ## Circular Dependency Guardrail
22
+
23
+ When refactoring:
24
+
25
+ 1. Detect import graph changes before applying bulk edits.
26
+ 2. Reject any change introducing `A -> B -> A` cycles.
27
+ 3. Move shared contracts to `shared` module when two-way dependencies appear.
28
+
29
+ ## Project-Specific Notes
30
+
31
+ - Replace sample modules with your real domain modules.
32
+ - Keep this map synchronized with architecture decisions and ADRs.
@@ -0,0 +1,79 @@
1
+ {
2
+ "generatedAt": "2026-04-11T09:46:02.646Z",
3
+ "reportName": "quality-trend-report",
4
+ "methodology": {
5
+ "gateSources": [
6
+ "scripts/release-gate.mjs",
7
+ "scripts/benchmark-gate.mjs",
8
+ "scripts/benchmark-intelligence.mjs"
9
+ ],
10
+ "rollbackSource": "git log commit subjects within 30-day window",
11
+ "tokenSource": ".agent-context/state/token-optimization-benchmark.json"
12
+ },
13
+ "governanceHealth": {
14
+ "gateSummaries": [
15
+ {
16
+ "scriptPath": "scripts/release-gate.mjs",
17
+ "gateName": "release-gate",
18
+ "exitCode": 0,
19
+ "passed": true,
20
+ "parseError": null,
21
+ "failureCount": 0,
22
+ "generatedAt": "2026-04-11T09:46:02.441Z"
23
+ },
24
+ {
25
+ "scriptPath": "scripts/benchmark-gate.mjs",
26
+ "gateName": "benchmark-gate",
27
+ "exitCode": 0,
28
+ "passed": true,
29
+ "parseError": null,
30
+ "failureCount": 0,
31
+ "generatedAt": "2026-04-11T09:46:02.545Z"
32
+ },
33
+ {
34
+ "scriptPath": "scripts/benchmark-intelligence.mjs",
35
+ "gateName": "benchmark-intelligence",
36
+ "exitCode": 0,
37
+ "passed": true,
38
+ "parseError": null,
39
+ "failureCount": 0,
40
+ "generatedAt": "2026-04-11T09:46:02.595Z"
41
+ }
42
+ ],
43
+ "availableGateCount": 3,
44
+ "passedGateCount": 3,
45
+ "gatePassRatePercent": 100
46
+ },
47
+ "rejectionCategories": [],
48
+ "rollbackSignals": {
49
+ "windowDays": 30,
50
+ "commitCount": 44,
51
+ "rollbackCommitCount": 1,
52
+ "rollbackFrequencyPercent": 2.27,
53
+ "source": "git-log",
54
+ "error": null
55
+ },
56
+ "tokenEfficiency": {
57
+ "isAvailable": true,
58
+ "generatedAt": "2026-04-11T06:14:10.052Z",
59
+ "averageNativeSavingsPercent": 83.64,
60
+ "averageRtkSavingsPercent": 18.95,
61
+ "scenarioCount": 3
62
+ },
63
+ "artifact": {
64
+ "path": "E:\\Project\\Agentic-Senior-Core\\.agent-context\\state\\quality-trend-report.json",
65
+ "writeMode": "stdout-and-file"
66
+ },
67
+ "history": [
68
+ {
69
+ "generatedAt": "2026-04-11T09:46:02.646Z",
70
+ "gatePassRatePercent": 100,
71
+ "passedGateCount": 3,
72
+ "availableGateCount": 3,
73
+ "rollbackFrequencyPercent": 2.27,
74
+ "averageNativeSavingsPercent": 83.64,
75
+ "averageRtkSavingsPercent": 18.95,
76
+ "rejectionCategoryCount": 0
77
+ }
78
+ ]
79
+ }
@@ -1,38 +1,38 @@
1
- {
2
- "defaultTier": "advance",
3
- "tiers": [
4
- {
5
- "name": "standard",
6
- "role": "compatibility",
7
- "description": "Minimal fallback mode for legacy support"
8
- },
9
- {
10
- "name": "advance",
11
- "role": "default",
12
- "description": "Efficient, opinionated, production-aware baseline"
13
- },
14
- {
15
- "name": "expert",
16
- "role": "complexity",
17
- "description": "For advanced integration, architecture, and critical refactors"
18
- },
19
- {
20
- "name": "above",
21
- "role": "governance",
22
- "description": "For release-critical and enterprise control-plane work"
23
- }
24
- ],
25
- "domains": [
26
- "frontend",
27
- "backend",
28
- "fullstack",
29
- "cli",
30
- "distribution",
31
- "review-quality"
32
- ],
33
- "benchmarkSources": [
34
- "sickn33/antigravity-awesome-skills",
35
- "github/awesome-copilot",
36
- "MiniMax-AI/skills"
37
- ]
38
- }
1
+ {
2
+ "defaultTier": "advance",
3
+ "tiers": [
4
+ {
5
+ "name": "standard",
6
+ "role": "compatibility",
7
+ "description": "Minimal fallback mode for legacy support"
8
+ },
9
+ {
10
+ "name": "advance",
11
+ "role": "default",
12
+ "description": "Efficient, opinionated, production-aware baseline"
13
+ },
14
+ {
15
+ "name": "expert",
16
+ "role": "complexity",
17
+ "description": "For advanced integration, architecture, and critical refactors"
18
+ },
19
+ {
20
+ "name": "above",
21
+ "role": "governance",
22
+ "description": "For release-critical and enterprise control-plane work"
23
+ }
24
+ ],
25
+ "domains": [
26
+ "frontend",
27
+ "backend",
28
+ "fullstack",
29
+ "cli",
30
+ "distribution",
31
+ "review-quality"
32
+ ],
33
+ "benchmarkSources": [
34
+ "sickn33/antigravity-awesome-skills",
35
+ "github/awesome-copilot",
36
+ "MiniMax-AI/skills"
37
+ ]
38
+ }
@@ -0,0 +1,130 @@
1
+ {
2
+ "generatedAt": "2026-04-11T06:14:10.052Z",
3
+ "reportName": "token-optimization-benchmark",
4
+ "methodology": {
5
+ "tokenEstimate": "estimated_tokens = ceil(output_chars / 4)",
6
+ "scope": "command-output estimate only; model-specific tokenization differs by provider",
7
+ "repositoryRoot": "E:\\Project\\Agentic-Senior-Core"
8
+ },
9
+ "environment": {
10
+ "nodeVersion": "v22.22.0",
11
+ "platform": "win32",
12
+ "rtk": {
13
+ "isAvailable": true,
14
+ "version": "0.35.0",
15
+ "source": "local-tools",
16
+ "executablePath": "E:\\Project\\Agentic-Senior-Core\\.benchmarks\\tools\\rtk\\rtk.exe",
17
+ "reason": null
18
+ }
19
+ },
20
+ "scenarios": [
21
+ {
22
+ "scenarioId": "git-show",
23
+ "scenarioName": "Latest commit detail review",
24
+ "baseline": {
25
+ "command": "git show HEAD --stat --patch --no-color",
26
+ "exitCode": 0,
27
+ "outputChars": 15191,
28
+ "outputLines": 368,
29
+ "estimatedTokens": 3798
30
+ },
31
+ "nativeOptimized": {
32
+ "command": "git show HEAD --stat --no-color",
33
+ "exitCode": 0,
34
+ "outputChars": 706,
35
+ "outputLines": 14,
36
+ "estimatedTokens": 177
37
+ },
38
+ "nativeSavings": {
39
+ "tokenDelta": 3621,
40
+ "savingsPercent": 95.34
41
+ },
42
+ "rtk": {
43
+ "command": "E:\\Project\\Agentic-Senior-Core\\.benchmarks\\tools\\rtk\\rtk.exe git show HEAD --stat --patch --no-color",
44
+ "exitCode": 0,
45
+ "outputChars": 15191,
46
+ "outputLines": 368,
47
+ "estimatedTokens": 3798
48
+ },
49
+ "rtkSavings": {
50
+ "tokenDelta": 0,
51
+ "savingsPercent": 0
52
+ }
53
+ },
54
+ {
55
+ "scenarioId": "git-log",
56
+ "scenarioName": "Commit history review",
57
+ "baseline": {
58
+ "command": "git log -n 50",
59
+ "exitCode": 0,
60
+ "outputChars": 14918,
61
+ "outputLines": 385,
62
+ "estimatedTokens": 3730
63
+ },
64
+ "nativeOptimized": {
65
+ "command": "git log --oneline -n 50",
66
+ "exitCode": 0,
67
+ "outputChars": 3555,
68
+ "outputLines": 50,
69
+ "estimatedTokens": 889
70
+ },
71
+ "nativeSavings": {
72
+ "tokenDelta": 2841,
73
+ "savingsPercent": 76.17
74
+ },
75
+ "rtk": {
76
+ "command": "E:\\Project\\Agentic-Senior-Core\\.benchmarks\\tools\\rtk\\rtk.exe git log -n 50",
77
+ "exitCode": 0,
78
+ "outputChars": 6437,
79
+ "outputLines": 74,
80
+ "estimatedTokens": 1610
81
+ },
82
+ "rtkSavings": {
83
+ "tokenDelta": 2120,
84
+ "savingsPercent": 56.84
85
+ }
86
+ },
87
+ {
88
+ "scenarioId": "search-token",
89
+ "scenarioName": "Search result scan",
90
+ "baseline": {
91
+ "command": "git grep -n token",
92
+ "exitCode": 0,
93
+ "outputChars": 21353,
94
+ "outputLines": 190,
95
+ "estimatedTokens": 5339
96
+ },
97
+ "nativeOptimized": {
98
+ "command": "git grep -n token README.md docs",
99
+ "exitCode": 0,
100
+ "outputChars": 4395,
101
+ "outputLines": 38,
102
+ "estimatedTokens": 1099
103
+ },
104
+ "nativeSavings": {
105
+ "tokenDelta": 4240,
106
+ "savingsPercent": 79.42
107
+ },
108
+ "rtk": {
109
+ "command": "E:\\Project\\Agentic-Senior-Core\\.benchmarks\\tools\\rtk\\rtk.exe git grep -n token",
110
+ "exitCode": 0,
111
+ "outputChars": 21353,
112
+ "outputLines": 190,
113
+ "estimatedTokens": 5339
114
+ },
115
+ "rtkSavings": {
116
+ "tokenDelta": 0,
117
+ "savingsPercent": 0
118
+ }
119
+ }
120
+ ],
121
+ "summary": {
122
+ "scenarioCount": 3,
123
+ "averageNativeSavingsPercent": 83.64,
124
+ "averageRtkSavingsPercent": 18.95
125
+ },
126
+ "artifact": {
127
+ "path": "E:\\Project\\Agentic-Senior-Core\\.agent-context\\state\\token-optimization-benchmark.json",
128
+ "writeMode": "stdout-and-file"
129
+ }
130
+ }
@@ -1,36 +1,36 @@
1
- # Rule Overrides
2
-
3
- > Exception file for enterprise needs.
4
- > Default policy: all rules remain strict unless explicitly overridden below.
5
-
6
- ## Override Template
7
-
8
- Use this exact structure for every exception:
9
-
10
- ```markdown
11
- [Rule: <rule-name>]
12
- Scope: <module/path>
13
- Reason: <business or technical constraint>
14
- Permitted Deviation: <what is allowed>
15
- Risk Mitigation: <how risk is controlled>
16
- Expiry: <YYYY-MM-DD>
17
- Owner: <team/person>
18
- ```
19
-
20
- ## Example Override
21
-
22
- ```markdown
23
- [Rule: Naming]
24
- Scope: legacy-erp-sync module
25
- Reason: External DB schema uses snake_case columns and strict mapping contracts.
26
- Permitted Deviation: snake_case variable names are allowed only in mapper files.
27
- Risk Mitigation: enforce mapper-only scope with codeowners and lint ignore pattern.
28
- Expiry: 2026-12-31
29
- Owner: platform-integration-team
30
- ```
31
-
32
- ## Enforcement Notes
33
-
34
- 1. Overrides must be narrow and time-bound.
35
- 2. Expired overrides are invalid and must be removed.
36
- 3. Broad overrides such as "allow any everywhere" are prohibited.
1
+ # Rule Overrides
2
+
3
+ > Exception file for enterprise needs.
4
+ > Default policy: all rules remain strict unless explicitly overridden below.
5
+
6
+ ## Override Template
7
+
8
+ Use this exact structure for every exception:
9
+
10
+ ```markdown
11
+ [Rule: <rule-name>]
12
+ Scope: <module/path>
13
+ Reason: <business or technical constraint>
14
+ Permitted Deviation: <what is allowed>
15
+ Risk Mitigation: <how risk is controlled>
16
+ Expiry: <YYYY-MM-DD>
17
+ Owner: <team/person>
18
+ ```
19
+
20
+ ## Example Override
21
+
22
+ ```markdown
23
+ [Rule: Naming]
24
+ Scope: legacy-erp-sync module
25
+ Reason: External DB schema uses snake_case columns and strict mapping contracts.
26
+ Permitted Deviation: snake_case variable names are allowed only in mapper files.
27
+ Risk Mitigation: enforce mapper-only scope with codeowners and lint ignore pattern.
28
+ Expiry: 2026-12-31
29
+ Owner: platform-integration-team
30
+ ```
31
+
32
+ ## Enforcement Notes
33
+
34
+ 1. Overrides must be narrow and time-bound.
35
+ 2. Expired overrides are invalid and must be removed.
36
+ 3. Broad overrides such as "allow any everywhere" are prohibited.
package/.cursorrules CHANGED
@@ -1,6 +1,6 @@
1
1
  # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
2
2
 
3
- Generated by Agentic-Senior-Core CLI v2.0.3
3
+ Generated by Agentic-Senior-Core CLI v2.0.5
4
4
  Timestamp: 2026-04-08T14:58:53.570Z
5
5
  Selected profile: beginner
6
6
  Selected policy file: .agent-context/policies/llm-judge-threshold.json
@@ -1,97 +1,21 @@
1
- # Antigravity / Gemini Agent Instructions
2
-
3
- > These instructions are loaded automatically by Antigravity (Google's AI coding agent).
4
- > The authoritative knowledge base is in `.agent-context/`.
5
-
6
- ## Identity
7
-
8
- You are a Senior Software Architect with 10+ years of production experience.
9
- You enforce professional engineering standards. No shortcuts. No "good enough" code.
10
-
11
- ## Knowledge Base Protocol
12
-
13
- Before generating or modifying any code, load the relevant rules:
14
-
15
- ### Auto-Architect Trigger (MANDATORY FOR NEW PROJECTS)
16
- If the user's INTENT is to create a new project, system, module, or app (regardless of the exact words used), **IMMEDIATELY** enter Architect Mode:
17
- 1. Read `.agent-context/rules/`, `.agent-context/stacks/`, and `.agent-context/blueprints/` without being asked.
18
- 2. Propose the most efficient technology stack and architecture layer separation (Transport -> Service -> Repository).
19
- 3. Draft a high-level plan and wait for the user's approval before generating any code.
20
-
21
- ### Refactor & Legacy Code Trigger
22
- If the user's INTENT is to refactor, fix, update, or change existing code:
23
- 1. Read `.agent-context/rules/architecture.md` and `.agent-context/rules/naming-conv.md`.
24
- 2. Propose a refactor plan adhering to our standards before modifying any code.
25
-
26
- ### Step 1: Universal Rules (Always Load)
27
- Read ALL files in `.agent-context/rules/`:
28
- - `naming-conv.md` — Descriptive naming, no single-letter variables
29
- - `architecture.md` — Separation of Concerns, feature-based grouping
30
- - `security.md` — Validate all input, parameterize queries, never hardcode secrets
31
- - `performance.md` — Evidence-based optimization, N+1 death penalty
32
- - `error-handling.md` — Never swallow errors, typed error codes, structured logging
33
- - `testing.md` — Test pyramid, behavior over implementation
34
- - `git-workflow.md` — Conventional Commits, atomic changes
35
- - `efficiency-vs-hype.md` — Stable dependencies over trendy ones
36
- - `api-docs.md` — OpenAPI mandatory, zero-doc death penalty
37
- - `microservices.md` — Monolith first, split triggers, strangler fig
38
- - `event-driven.md` — Event sourcing, CQRS, idempotency
39
- - `database-design.md` — 3NF default, index FKs, safe migrations
40
- - `realtime.md` — WebSockets scaling & strict pub/sub
41
- - `frontend-architecture.md` — Smart/Dumb UI, TanStack Query vs Zustand
42
-
43
- ### Step 2: Language Profile (By Stack)
44
- Load the relevant stack from `.agent-context/stacks/`:
45
- - TypeScript/Node → `stacks/typescript.md`
46
- - Python → `stacks/python.md`
47
- - Java/Kotlin → `stacks/java.md`
48
- - PHP → `stacks/php.md`
49
- - Go → `stacks/go.md`
50
- - C#/.NET → `stacks/csharp.md`
51
- - Rust → `stacks/rust.md`
52
- - Ruby on Rails → `stacks/ruby.md`
53
-
54
- ### Step 3: Blueprint (If Scaffolding)
55
- Load from `.agent-context/blueprints/` when creating new projects.
56
-
57
- ### Step 4: Review (Before Completion)
58
- Run `.agent-context/review-checklists/pr-checklist.md` before declaring done.
59
-
60
- ### Step 5: State + Override (V1.4)
61
- - Read `.agent-context/state/architecture-map.md` and `.agent-context/state/dependency-map.md` before high-impact refactors.
62
- - Use `.agent-override.md` only for explicit scoped exceptions.
63
-
64
- ## The Reasoning Clause (MANDATORY)
65
- Every time you reject a code block, suggest a change, or enforce a rule, you MUST provide a Reasoning Chain:
66
-
67
- ```
68
- REASONING CHAIN
69
- Problem: [WHY the user's current approach/request is dangerous or unprofessional]
70
- Solution: [The improved, production-grade approach]
71
- Why Better: [WHY this is more professional — teach the human]
72
- ```
73
-
74
- ## Zero Tolerance & Rejection Protocol
75
- If the user asks for "quick and dirty" code, skipping tests, or ignoring validation, you MUST politely but firmly refuse. Explain that today's hack is tomorrow's production incident. You do NOT tolerate shortcuts.
76
-
77
- ### The Security Halt
78
- If you detect critical security vulnerabilities (e.g., hardcoded secrets, SQL injection, bypassing auth), you MUST halt feature development and refuse to proceed until the vulnerability is patched.
79
-
80
- ### The "Plan First" Rule
81
- For any non-trivial request, do NOT generate full code immediately. You MUST first provide a bulleted "Implementation Plan" outlining the file structure, design patterns to be used, and security considerations. End your response with: *"Do you approve this plan? If yes, I will generate the code."*
82
-
83
- ### Self-Correction Protocol
84
- Before outputting your final code, silently run a self-review against our Clean Code and Security standards. If your generated code contains `any` types, swallowed errors, or unvalidated inputs, CORRECT IT before showing it to the user. Never output code you wouldn't approve in a PR.
85
-
86
- ### Dependency Defense
87
- If the user asks to install a new library, or if you feel the need to use one, evaluate it against the "stdlib-first" rule. If the functionality can be implemented safely in under 20 lines of code, write it yourself. If a dependency is strictly necessary, you MUST justify it by providing its bundle size, maintenance status, and why the standard library is insufficient.
88
-
89
- ## Absolute Clean Code Laws
90
- 1. **No Lazy Naming:** NEVER use generic variables like `data`, `res`, `temp`, `val`, `x`. Variables must be nouns answering "WHAT is this?". Functions must start with a verb (e.g., `validatePayment`). Booleans must use `is`/`has`/`can`/`should` prefixes.
91
- 2. **No 'any' or 'magic':** If using TypeScript/Python, the `any` type is completely banned. All external data MUST be validated at the boundary using schemas (like Zod or Pydantic) before touching business logic.
92
- 3. **Layer Separation:** Business logic does NOT touch HTTP. Database logic does NOT leak into services. No exceptions.
93
- 4. **Context First:** NEVER write code without checking `.agent-context/rules/` first.
94
- 5. **No Blind Dependencies:** NEVER introduce dependencies without justification.
95
-
96
- ## Definition of Done
97
- **NEVER** declare a task "done" or ready for review without explicitly running and passing `.agent-context/review-checklists/pr-checklist.md`.
1
+ # Gemini Instructions - Thin Adapter
2
+
3
+ Adapter Mode: thin
4
+ Adapter Source: .instructions.md
5
+ Canonical Snapshot SHA256: ed18aa02954cf7e669d2ade4ea8c36c382bcae66e12b731c6e1ea69a59742480
6
+
7
+ Canonical policy source: [.instructions.md](../.instructions.md).
8
+
9
+ ## Bootstrap Sequence
10
+
11
+ 1. Load [.instructions.md](../.instructions.md) first.
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).
18
+
19
+ ## Completion Gate
20
+
21
+ Run [.agent-context/review-checklists/pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring completion.