@ryuenn3123/agentic-senior-core 2.0.4 → 2.0.7
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.
- package/.agent-context/blueprints/mobile-app.md +82 -12
- package/.agent-context/skills/cli/README.md +6 -0
- package/.agent-context/skills/cli/safety-telemetry.md +39 -0
- package/.agent-context/skills/cli.md +3 -0
- package/.agent-context/skills/distribution/.evidence/compatibility-manifest.json +9 -0
- package/.agent-context/skills/distribution/.evidence/sbom-excerpt.json +6 -0
- package/.agent-context/skills/distribution/.evidence/test-report.json +8 -0
- package/.agent-context/skills/distribution/CHANGELOG.md +7 -0
- package/.agent-context/skills/distribution/README.md +9 -1
- package/.agent-context/skills/distribution/package.json +5 -0
- package/.agent-context/skills/distribution/provenance-attestation.md +47 -0
- package/.agent-context/skills/distribution/tests/.gitkeep +1 -0
- package/.agent-context/skills/distribution.md +3 -0
- package/.agent-context/skills/frontend/.evidence/compatibility-manifest.json +9 -0
- package/.agent-context/skills/frontend/.evidence/sbom-excerpt.json +6 -0
- package/.agent-context/skills/frontend/.evidence/test-report.json +8 -0
- package/.agent-context/skills/frontend/CHANGELOG.md +7 -0
- package/.agent-context/skills/frontend/README.md +14 -1
- package/.agent-context/skills/frontend/conversion-clarity.md +51 -0
- package/.agent-context/skills/frontend/package.json +5 -0
- package/.agent-context/skills/frontend/responsive-delivery.md +41 -0
- package/.agent-context/skills/frontend/tests/.gitkeep +1 -0
- package/.agent-context/skills/frontend.md +6 -0
- package/.agent-context/skills/fullstack/.evidence/compatibility-manifest.json +9 -0
- package/.agent-context/skills/fullstack/.evidence/sbom-excerpt.json +6 -0
- package/.agent-context/skills/fullstack/.evidence/test-report.json +8 -0
- package/.agent-context/skills/fullstack/CHANGELOG.md +7 -0
- package/.agent-context/skills/fullstack/README.md +9 -1
- package/.agent-context/skills/fullstack/package.json +5 -0
- package/.agent-context/skills/fullstack/release-coordination.md +51 -0
- package/.agent-context/skills/fullstack/tests/.gitkeep +1 -0
- package/.agent-context/skills/fullstack.md +3 -0
- package/.agent-context/skills/review-quality/.evidence/compatibility-manifest.json +9 -0
- package/.agent-context/skills/review-quality/.evidence/sbom-excerpt.json +6 -0
- package/.agent-context/skills/review-quality/.evidence/test-report.json +8 -0
- package/.agent-context/skills/review-quality/CHANGELOG.md +7 -0
- package/.agent-context/skills/review-quality/README.md +9 -1
- package/.agent-context/skills/review-quality/package.json +5 -0
- package/.agent-context/skills/review-quality/release-decision.md +49 -0
- package/.agent-context/skills/review-quality/tests/.gitkeep +1 -0
- package/.agent-context/skills/review-quality.md +3 -0
- package/.agent-context/state/quality-trend-report.json +89 -0
- package/.agent-context/state/weekly-governance-report.json +126 -0
- package/.cursorrules +1 -1
- package/.gemini/instructions.md +15 -91
- package/.github/copilot-instructions.md +15 -160
- package/.github/workflows/governance-weekly-report.yml +43 -0
- package/.windsurfrules +1 -1
- package/AGENTS.md +21 -174
- package/README.md +15 -0
- package/lib/cli/constants.mjs +35 -0
- package/lib/cli/utils.mjs +4 -1
- package/package.json +3 -1
- package/scripts/governance-weekly-report.mjs +293 -0
- package/scripts/quality-trend-report.mjs +289 -0
- package/scripts/release-gate.mjs +57 -0
- package/scripts/validate.mjs +85 -22
|
@@ -10,18 +10,21 @@ Coordinate frontend and backend delivery as a single product system.
|
|
|
10
10
|
- Shared validation contracts
|
|
11
11
|
- End-to-end flows and release readiness
|
|
12
12
|
- Performance, accessibility, and observability together
|
|
13
|
+
- Release coordination and rollback preparation across services
|
|
13
14
|
|
|
14
15
|
## Must-Have Checks
|
|
15
16
|
- Single feature directory with clear public API
|
|
16
17
|
- Frontend and backend contracts aligned
|
|
17
18
|
- End-to-end test coverage for critical paths
|
|
18
19
|
- Release notes explain UX and API impact together
|
|
20
|
+
- Cross-service rollout order and rollback trigger criteria are documented
|
|
19
21
|
|
|
20
22
|
## Evidence
|
|
21
23
|
- Feature parity checklist
|
|
22
24
|
- End-to-end test report
|
|
23
25
|
- Contract validation output
|
|
24
26
|
- Release artifact bundle
|
|
27
|
+
- Rollout/rollback decision log for multi-service features
|
|
25
28
|
|
|
26
29
|
## Fallback
|
|
27
30
|
- Split delivery only when the feature boundary is explicit and the evidence bundle is still complete.
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": "compatibility-manifest-v1",
|
|
3
|
+
"artifactType": "skill-domain-evidence",
|
|
4
|
+
"domain": "review-quality",
|
|
5
|
+
"ides": ["cursor", "windsurf", "copilot", "gemini", "claude", "codex", "cline"],
|
|
6
|
+
"nodeMin": "18",
|
|
7
|
+
"platforms": ["windows", "linux", "macos"],
|
|
8
|
+
"validatedAt": "2026-04-11T12:00:00Z"
|
|
9
|
+
}
|
|
@@ -8,6 +8,7 @@ This domain formalizes review quality across planning discipline, security enfor
|
|
|
8
8
|
- [Planning](planning.md) - Plan quality, scope control, and change strategy
|
|
9
9
|
- [Security](security.md) - Critical vulnerability policy and boundary safeguards
|
|
10
10
|
- [Benchmarking](benchmark.md) - Regression detection and evidence-based comparison
|
|
11
|
+
- [Release Decisioning](release-decision.md) - Explicit readiness verdicts, blocker ownership, and escalation logic
|
|
11
12
|
|
|
12
13
|
## Operating Model
|
|
13
14
|
- Use `expert` for standard review workflows.
|
|
@@ -16,4 +17,11 @@ This domain formalizes review quality across planning discipline, security enfor
|
|
|
16
17
|
## Above-Line Additions
|
|
17
18
|
- Security halt protocol for critical findings.
|
|
18
19
|
- Benchmark gate thresholds integrated in CI.
|
|
19
|
-
- Review evidence bundle for auditability.
|
|
20
|
+
- Review evidence bundle for auditability.
|
|
21
|
+
|
|
22
|
+
## Usage Example
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
node ./scripts/governance-weekly-report.mjs
|
|
26
|
+
node ./scripts/release-gate.mjs
|
|
27
|
+
```
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# Release Decisioning
|
|
2
|
+
|
|
3
|
+
Tier: EXPERT
|
|
4
|
+
|
|
5
|
+
Release decisioning converts technical signals into explicit ship, hold, or rollback recommendations with ownership.
|
|
6
|
+
|
|
7
|
+
## Decision Inputs
|
|
8
|
+
|
|
9
|
+
Use a standardized input set for every release review:
|
|
10
|
+
|
|
11
|
+
- Validation and test status.
|
|
12
|
+
- Release gate and forbidden-content status.
|
|
13
|
+
- Benchmark and quality trend posture.
|
|
14
|
+
- Security and architecture findings.
|
|
15
|
+
- Trust-tier posture for required skill domains.
|
|
16
|
+
|
|
17
|
+
## Decision Outcomes
|
|
18
|
+
|
|
19
|
+
Each review must conclude with one outcome:
|
|
20
|
+
|
|
21
|
+
- Ship: all mandatory gates pass and no unresolved critical findings.
|
|
22
|
+
- Hold: one or more blockers remain unresolved.
|
|
23
|
+
- Rollback: post-release signal confirms unacceptable risk or regression.
|
|
24
|
+
|
|
25
|
+
## Blocker Policy
|
|
26
|
+
|
|
27
|
+
A blocker record needs:
|
|
28
|
+
|
|
29
|
+
- Title and category.
|
|
30
|
+
- Owner and deadline.
|
|
31
|
+
- User impact statement.
|
|
32
|
+
- Mitigation and validation command.
|
|
33
|
+
|
|
34
|
+
No blocker should remain in implicit or undocumented state.
|
|
35
|
+
|
|
36
|
+
## Escalation Rules
|
|
37
|
+
|
|
38
|
+
Escalate to maintainers immediately when:
|
|
39
|
+
|
|
40
|
+
- Critical security issue is detected.
|
|
41
|
+
- Gate output becomes inconsistent across environments.
|
|
42
|
+
- Rollback readiness cannot be proven.
|
|
43
|
+
|
|
44
|
+
## Review Checklist
|
|
45
|
+
|
|
46
|
+
- [ ] Decision outcome is explicit (ship/hold/rollback).
|
|
47
|
+
- [ ] Blockers include owner and due date.
|
|
48
|
+
- [ ] Validation evidence is attached to decision log.
|
|
49
|
+
- [ ] Escalation happened for critical unresolved risks.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
# Review-quality skill test fixtures placeholder
|
|
@@ -11,18 +11,21 @@ Turn code review, planning, and benchmark output into explicit quality decisions
|
|
|
11
11
|
- Benchmark interpretation
|
|
12
12
|
- Security and architecture audits
|
|
13
13
|
- Evidence-driven approval
|
|
14
|
+
- Explicit release decisions with blocker tracking and ownership
|
|
14
15
|
|
|
15
16
|
## Must-Have Checks
|
|
16
17
|
- Every rejection includes a reason and a fix
|
|
17
18
|
- Every approval includes evidence
|
|
18
19
|
- Benchmark deltas are explicit
|
|
19
20
|
- Security findings stop release when critical
|
|
21
|
+
- Release readiness verdict includes blockers, owner, and due date
|
|
20
22
|
|
|
21
23
|
## Evidence
|
|
22
24
|
- PR review report
|
|
23
25
|
- Security audit output
|
|
24
26
|
- Benchmark report
|
|
25
27
|
- Approval or rejection rationale
|
|
28
|
+
- Weekly governance report and release readiness summary
|
|
26
29
|
|
|
27
30
|
## Fallback
|
|
28
31
|
- Standard mode can be used only for low-risk maintenance and still requires written evidence.
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
{
|
|
2
|
+
"generatedAt": "2026-04-11T12:21:35.779Z",
|
|
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-11T12:21:35.292Z"
|
|
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-11T12:21:35.433Z"
|
|
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-11T12:21:35.480Z"
|
|
41
|
+
}
|
|
42
|
+
],
|
|
43
|
+
"availableGateCount": 3,
|
|
44
|
+
"passedGateCount": 3,
|
|
45
|
+
"gatePassRatePercent": 100
|
|
46
|
+
},
|
|
47
|
+
"rejectionCategories": [],
|
|
48
|
+
"rollbackSignals": {
|
|
49
|
+
"windowDays": 30,
|
|
50
|
+
"commitCount": 46,
|
|
51
|
+
"rollbackCommitCount": 1,
|
|
52
|
+
"rollbackFrequencyPercent": 2.17,
|
|
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
|
+
"generatedAt": "2026-04-11T12:21:35.779Z",
|
|
80
|
+
"gatePassRatePercent": 100,
|
|
81
|
+
"passedGateCount": 3,
|
|
82
|
+
"availableGateCount": 3,
|
|
83
|
+
"rollbackFrequencyPercent": 2.17,
|
|
84
|
+
"averageNativeSavingsPercent": 83.64,
|
|
85
|
+
"averageRtkSavingsPercent": 18.95,
|
|
86
|
+
"rejectionCategoryCount": 0
|
|
87
|
+
}
|
|
88
|
+
]
|
|
89
|
+
}
|
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
{
|
|
2
|
+
"generatedAt": "2026-04-11T12:21:37.776Z",
|
|
3
|
+
"reportName": "weekly-governance-report",
|
|
4
|
+
"methodology": {
|
|
5
|
+
"qualityTrendSource": "state-file",
|
|
6
|
+
"qualityTrendGeneratedAt": "2026-04-11T12:21:35.779Z",
|
|
7
|
+
"commitWindowDays": 7,
|
|
8
|
+
"requiredVerifiedDomains": [
|
|
9
|
+
"cli",
|
|
10
|
+
"frontend",
|
|
11
|
+
"fullstack",
|
|
12
|
+
"distribution",
|
|
13
|
+
"review-quality"
|
|
14
|
+
]
|
|
15
|
+
},
|
|
16
|
+
"qualitySignals": {
|
|
17
|
+
"governanceHealth": {
|
|
18
|
+
"availableGateCount": 3,
|
|
19
|
+
"passedGateCount": 3,
|
|
20
|
+
"gatePassRatePercent": 100
|
|
21
|
+
},
|
|
22
|
+
"rejectionCategories": [],
|
|
23
|
+
"tokenEfficiency": {
|
|
24
|
+
"isAvailable": true,
|
|
25
|
+
"generatedAt": "2026-04-11T06:14:10.052Z",
|
|
26
|
+
"averageNativeSavingsPercent": 83.64,
|
|
27
|
+
"averageRtkSavingsPercent": 18.95,
|
|
28
|
+
"scenarioCount": 3
|
|
29
|
+
}
|
|
30
|
+
},
|
|
31
|
+
"skillTrust": {
|
|
32
|
+
"domains": [
|
|
33
|
+
{
|
|
34
|
+
"domain": "backend",
|
|
35
|
+
"tier": "experimental",
|
|
36
|
+
"score": 25
|
|
37
|
+
},
|
|
38
|
+
{
|
|
39
|
+
"domain": "cli",
|
|
40
|
+
"tier": "verified",
|
|
41
|
+
"score": 100
|
|
42
|
+
},
|
|
43
|
+
{
|
|
44
|
+
"domain": "distribution",
|
|
45
|
+
"tier": "verified",
|
|
46
|
+
"score": 100
|
|
47
|
+
},
|
|
48
|
+
{
|
|
49
|
+
"domain": "frontend",
|
|
50
|
+
"tier": "verified",
|
|
51
|
+
"score": 100
|
|
52
|
+
},
|
|
53
|
+
{
|
|
54
|
+
"domain": "fullstack",
|
|
55
|
+
"tier": "verified",
|
|
56
|
+
"score": 100
|
|
57
|
+
},
|
|
58
|
+
{
|
|
59
|
+
"domain": "review-quality",
|
|
60
|
+
"tier": "verified",
|
|
61
|
+
"score": 100
|
|
62
|
+
}
|
|
63
|
+
],
|
|
64
|
+
"tierCounts": {
|
|
65
|
+
"verified": 5,
|
|
66
|
+
"community": 0,
|
|
67
|
+
"experimental": 1
|
|
68
|
+
},
|
|
69
|
+
"requiredVerifiedDomains": [
|
|
70
|
+
"cli",
|
|
71
|
+
"frontend",
|
|
72
|
+
"fullstack",
|
|
73
|
+
"distribution",
|
|
74
|
+
"review-quality"
|
|
75
|
+
],
|
|
76
|
+
"requiredVerifiedDomainFailures": [],
|
|
77
|
+
"allRequiredVerified": true
|
|
78
|
+
},
|
|
79
|
+
"commitSignals": {
|
|
80
|
+
"windowDays": 7,
|
|
81
|
+
"commitCount": 18,
|
|
82
|
+
"releaseCommitCount": 7,
|
|
83
|
+
"rollbackCommitCount": 1,
|
|
84
|
+
"releaseFrequencyPercent": 38.89,
|
|
85
|
+
"rollbackFrequencyPercent": 5.56,
|
|
86
|
+
"error": null
|
|
87
|
+
},
|
|
88
|
+
"releaseReadiness": {
|
|
89
|
+
"isReady": true,
|
|
90
|
+
"blockers": [],
|
|
91
|
+
"summary": "Weekly governance posture is ready for maintenance releases."
|
|
92
|
+
},
|
|
93
|
+
"artifact": {
|
|
94
|
+
"path": "E:\\Project\\Agentic-Senior-Core\\.agent-context\\state\\weekly-governance-report.json",
|
|
95
|
+
"writeMode": "stdout-and-file"
|
|
96
|
+
},
|
|
97
|
+
"history": [
|
|
98
|
+
{
|
|
99
|
+
"generatedAt": "2026-04-11T12:14:52.483Z",
|
|
100
|
+
"readinessStatus": "blocked",
|
|
101
|
+
"blockerCount": 1,
|
|
102
|
+
"gatePassRatePercent": 100,
|
|
103
|
+
"verifiedSkillDomainCount": 1,
|
|
104
|
+
"releaseFrequencyPercent": 38.89,
|
|
105
|
+
"rollbackFrequencyPercent": 5.56
|
|
106
|
+
},
|
|
107
|
+
{
|
|
108
|
+
"generatedAt": "2026-04-11T12:19:25.182Z",
|
|
109
|
+
"readinessStatus": "ready",
|
|
110
|
+
"blockerCount": 0,
|
|
111
|
+
"gatePassRatePercent": 100,
|
|
112
|
+
"verifiedSkillDomainCount": 5,
|
|
113
|
+
"releaseFrequencyPercent": 38.89,
|
|
114
|
+
"rollbackFrequencyPercent": 5.56
|
|
115
|
+
},
|
|
116
|
+
{
|
|
117
|
+
"generatedAt": "2026-04-11T12:21:37.776Z",
|
|
118
|
+
"readinessStatus": "ready",
|
|
119
|
+
"blockerCount": 0,
|
|
120
|
+
"gatePassRatePercent": 100,
|
|
121
|
+
"verifiedSkillDomainCount": 5,
|
|
122
|
+
"releaseFrequencyPercent": 38.89,
|
|
123
|
+
"rollbackFrequencyPercent": 5.56
|
|
124
|
+
}
|
|
125
|
+
]
|
|
126
|
+
}
|
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
|
+
Generated by Agentic-Senior-Core CLI v2.0.7
|
|
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
|
package/.gemini/instructions.md
CHANGED
|
@@ -1,97 +1,21 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Gemini Instructions - Thin Adapter
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
3
|
+
Adapter Mode: thin
|
|
4
|
+
Adapter Source: .instructions.md
|
|
5
|
+
Canonical Snapshot SHA256: 361ac86172268a2f20d4f7a1e407c7dd122f1b0c265d085e872254718b078d22
|
|
5
6
|
|
|
6
|
-
|
|
7
|
+
Canonical policy source: [.instructions.md](../.instructions.md).
|
|
7
8
|
|
|
8
|
-
|
|
9
|
-
You enforce professional engineering standards. No shortcuts. No "good enough" code.
|
|
9
|
+
## Bootstrap Sequence
|
|
10
10
|
|
|
11
|
-
|
|
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).
|
|
12
18
|
|
|
13
|
-
|
|
19
|
+
## Completion Gate
|
|
14
20
|
|
|
15
|
-
|
|
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`.
|
|
21
|
+
Run [.agent-context/review-checklists/pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring completion.
|