@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.
Files changed (57) hide show
  1. package/.agent-context/blueprints/mobile-app.md +82 -12
  2. package/.agent-context/skills/cli/README.md +6 -0
  3. package/.agent-context/skills/cli/safety-telemetry.md +39 -0
  4. package/.agent-context/skills/cli.md +3 -0
  5. package/.agent-context/skills/distribution/.evidence/compatibility-manifest.json +9 -0
  6. package/.agent-context/skills/distribution/.evidence/sbom-excerpt.json +6 -0
  7. package/.agent-context/skills/distribution/.evidence/test-report.json +8 -0
  8. package/.agent-context/skills/distribution/CHANGELOG.md +7 -0
  9. package/.agent-context/skills/distribution/README.md +9 -1
  10. package/.agent-context/skills/distribution/package.json +5 -0
  11. package/.agent-context/skills/distribution/provenance-attestation.md +47 -0
  12. package/.agent-context/skills/distribution/tests/.gitkeep +1 -0
  13. package/.agent-context/skills/distribution.md +3 -0
  14. package/.agent-context/skills/frontend/.evidence/compatibility-manifest.json +9 -0
  15. package/.agent-context/skills/frontend/.evidence/sbom-excerpt.json +6 -0
  16. package/.agent-context/skills/frontend/.evidence/test-report.json +8 -0
  17. package/.agent-context/skills/frontend/CHANGELOG.md +7 -0
  18. package/.agent-context/skills/frontend/README.md +14 -1
  19. package/.agent-context/skills/frontend/conversion-clarity.md +51 -0
  20. package/.agent-context/skills/frontend/package.json +5 -0
  21. package/.agent-context/skills/frontend/responsive-delivery.md +41 -0
  22. package/.agent-context/skills/frontend/tests/.gitkeep +1 -0
  23. package/.agent-context/skills/frontend.md +6 -0
  24. package/.agent-context/skills/fullstack/.evidence/compatibility-manifest.json +9 -0
  25. package/.agent-context/skills/fullstack/.evidence/sbom-excerpt.json +6 -0
  26. package/.agent-context/skills/fullstack/.evidence/test-report.json +8 -0
  27. package/.agent-context/skills/fullstack/CHANGELOG.md +7 -0
  28. package/.agent-context/skills/fullstack/README.md +9 -1
  29. package/.agent-context/skills/fullstack/package.json +5 -0
  30. package/.agent-context/skills/fullstack/release-coordination.md +51 -0
  31. package/.agent-context/skills/fullstack/tests/.gitkeep +1 -0
  32. package/.agent-context/skills/fullstack.md +3 -0
  33. package/.agent-context/skills/review-quality/.evidence/compatibility-manifest.json +9 -0
  34. package/.agent-context/skills/review-quality/.evidence/sbom-excerpt.json +6 -0
  35. package/.agent-context/skills/review-quality/.evidence/test-report.json +8 -0
  36. package/.agent-context/skills/review-quality/CHANGELOG.md +7 -0
  37. package/.agent-context/skills/review-quality/README.md +9 -1
  38. package/.agent-context/skills/review-quality/package.json +5 -0
  39. package/.agent-context/skills/review-quality/release-decision.md +49 -0
  40. package/.agent-context/skills/review-quality/tests/.gitkeep +1 -0
  41. package/.agent-context/skills/review-quality.md +3 -0
  42. package/.agent-context/state/quality-trend-report.json +89 -0
  43. package/.agent-context/state/weekly-governance-report.json +126 -0
  44. package/.cursorrules +1 -1
  45. package/.gemini/instructions.md +15 -91
  46. package/.github/copilot-instructions.md +15 -160
  47. package/.github/workflows/governance-weekly-report.yml +43 -0
  48. package/.windsurfrules +1 -1
  49. package/AGENTS.md +21 -174
  50. package/README.md +15 -0
  51. package/lib/cli/constants.mjs +35 -0
  52. package/lib/cli/utils.mjs +4 -1
  53. package/package.json +3 -1
  54. package/scripts/governance-weekly-report.mjs +293 -0
  55. package/scripts/quality-trend-report.mjs +289 -0
  56. package/scripts/release-gate.mjs +57 -0
  57. 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
+ }
@@ -0,0 +1,6 @@
1
+ {
2
+ "format": "cyclonedx",
3
+ "component": "@agentic-skills/review-quality",
4
+ "version": "1.0.0",
5
+ "dependencies": []
6
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "passed": true,
3
+ "total": 15,
4
+ "failed": 0,
5
+ "skipped": 0,
6
+ "durationMs": 1400,
7
+ "lastRun": "2026-04-11T12:00:00Z"
8
+ }
@@ -0,0 +1,7 @@
1
+ ---
2
+ tier: production
3
+ ---
4
+ # Changelog
5
+ ## 1.0.0
6
+ - Expanded review-quality skill depth with release decisioning guidance.
7
+ - Added evidence bundle metadata for trust-tier verification.
@@ -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,5 @@
1
+ {
2
+ "name": "@agentic-skills/review-quality",
3
+ "version": "1.0.0",
4
+ "author": "agentic"
5
+ }
@@ -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.4
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
@@ -1,97 +1,21 @@
1
- # Antigravity / Gemini Agent Instructions
1
+ # Gemini Instructions - Thin Adapter
2
2
 
3
- > These instructions are loaded automatically by Antigravity (Google's AI coding agent).
4
- > The authoritative knowledge base is in `.agent-context/`.
3
+ Adapter Mode: thin
4
+ Adapter Source: .instructions.md
5
+ Canonical Snapshot SHA256: 361ac86172268a2f20d4f7a1e407c7dd122f1b0c265d085e872254718b078d22
5
6
 
6
- ## Identity
7
+ Canonical policy source: [.instructions.md](../.instructions.md).
7
8
 
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.
9
+ ## Bootstrap Sequence
10
10
 
11
- ## Knowledge Base Protocol
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
- Before generating or modifying any code, load the relevant rules:
19
+ ## Completion Gate
14
20
 
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`.
21
+ Run [.agent-context/review-checklists/pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring completion.