@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
|
@@ -1,166 +1,21 @@
|
|
|
1
|
-
# GitHub Copilot Instructions
|
|
1
|
+
# GitHub Copilot Instructions - Thin Adapter
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Adapter Mode: thin
|
|
4
|
+
Adapter Source: .instructions.md
|
|
5
|
+
Canonical Snapshot SHA256: 361ac86172268a2f20d4f7a1e407c7dd122f1b0c265d085e872254718b078d22
|
|
4
6
|
|
|
5
|
-
|
|
7
|
+
The canonical policy source for this repository is [.instructions.md](../.instructions.md).
|
|
6
8
|
|
|
7
|
-
##
|
|
9
|
+
## Required Load Order
|
|
8
10
|
|
|
9
|
-
|
|
11
|
+
1. Read [.instructions.md](../.instructions.md) first.
|
|
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).
|
|
10
18
|
|
|
11
|
-
|
|
12
|
-
2. Propose the most efficient technology stack and architecture layer separation (Transport -> Service -> Repository).
|
|
13
|
-
3. Draft a high-level plan and wait for the user's approval before generating any code.
|
|
19
|
+
## Completion Gate
|
|
14
20
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
If the user's INTENT is to refactor, fix, or modify existing code:
|
|
18
|
-
|
|
19
|
-
1. Read `.agent-context/rules/` to ensure the refactor aligns with our standards.
|
|
20
|
-
2. Provide a plan before rewriting the code.
|
|
21
|
-
|
|
22
|
-
## Rules
|
|
23
|
-
|
|
24
|
-
Before generating code, read ALL engineering rules in `.agent-context/rules/`:
|
|
25
|
-
|
|
26
|
-
- `naming-conv.md` — Descriptive naming, no single-letter variables
|
|
27
|
-
- `architecture.md` — Separation of Concerns, feature-based grouping
|
|
28
|
-
- `security.md` — Validate all input, parameterize queries, never hardcode secrets
|
|
29
|
-
- `performance.md` — Evidence-based optimization, watch for N+1
|
|
30
|
-
- `error-handling.md` — Never swallow errors, use typed error codes
|
|
31
|
-
- `testing.md` — Test pyramid, behavior over implementation
|
|
32
|
-
- `git-workflow.md` — Conventional Commits, atomic changes
|
|
33
|
-
- `efficiency-vs-hype.md` — Stable dependencies over trendy ones
|
|
34
|
-
- `api-docs.md` — OpenAPI 3.1 mandatory, zero-doc death penalty
|
|
35
|
-
- `microservices.md` — Monolith first, split triggers, strangler fig
|
|
36
|
-
- `event-driven.md` — Event sourcing, CQRS, idempotency
|
|
37
|
-
- `database-design.md` — 3NF default, index FKs, safe migrations
|
|
38
|
-
- `realtime.md` — WebSockets scaling & strict pub/sub
|
|
39
|
-
- `frontend-architecture.md` — Smart/Dumb UI, TanStack Query vs Zustand
|
|
40
|
-
|
|
41
|
-
## Language Profile
|
|
42
|
-
|
|
43
|
-
Load the relevant stack profile from `.agent-context/stacks/`:
|
|
44
|
-
|
|
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
|
-
- Flutter → `stacks/flutter.md`
|
|
54
|
-
- React Native → `stacks/react-native.md`
|
|
55
|
-
|
|
56
|
-
## Domain Skills (Auto-Load by Context)
|
|
57
|
-
|
|
58
|
-
You have access to 6 specialized skill packs. Load the relevant one(s) based on the request:
|
|
59
|
-
|
|
60
|
-
| Skill | When Loaded | Key Controls |
|
|
61
|
-
|-------|------------|---------------|
|
|
62
|
-
| **Backend** | Service/API/microservice request | Layer separation, validation boundaries, error handling |
|
|
63
|
-
| **Frontend** | UI/web/React/Vue request | Smart/Dumb components, state management patterns |
|
|
64
|
-
| **CLI** | Tool/script/automation request | Argument parsing, help text, exit codes |
|
|
65
|
-
| **Distribution** | Release/deploy/package request | Versioning, SBOM, changelog, binary safety |
|
|
66
|
-
| **Fullstack** | End-to-end feature request | Integration points, data flow, contract design |
|
|
67
|
-
| **Review-Quality** | Code review/audit request | Architecture violations, security issues, optimization paths |
|
|
68
|
-
|
|
69
|
-
**Location**: `.agent-context/skills/[skill-name].md`
|
|
70
|
-
|
|
71
|
-
## Prompts (Request-Specific Templates)
|
|
72
|
-
|
|
73
|
-
When user explicitly requests one of these workflows, load the full prompt template:
|
|
74
|
-
|
|
75
|
-
- **Init-Project**: User says "create new project" → Load `.agent-context/prompts/init-project.md` → Auto-Architect mode
|
|
76
|
-
- **Refactor**: User says "refactor", "improve", "clean up" → Load `.agent-context/prompts/refactor.md` → Safety-first refactoring
|
|
77
|
-
- **Review-Code**: User says "review", "audit", "check" → Load `.agent-context/prompts/review-code.md` → Architectural code review
|
|
78
|
-
|
|
79
|
-
## Team Profiles (Governance Defaults)
|
|
80
|
-
|
|
81
|
-
If the codebase declares a team profile in `.agent-context/profiles/`, load governance defaults:
|
|
82
|
-
|
|
83
|
-
- **Platform**: Reliability-focused, strict CI, Go default → `.agent-context/profiles/platform.md`
|
|
84
|
-
- **Regulated**: Compliance-focused (finance/health), all severities block → `.agent-context/profiles/regulated.md`
|
|
85
|
-
- **Startup**: Speed-focused, TypeScript/Next.js, permissive gates → `.agent-context/profiles/startup.md`
|
|
86
|
-
|
|
87
|
-
## Policies & Thresholds
|
|
88
|
-
|
|
89
|
-
Load `.agent-context/policies/llm-judge-threshold.json` to understand:
|
|
90
|
-
- Skill tier requirements (beginner/balanced/advanced/expert)
|
|
91
|
-
- LLM quality gates per severity level
|
|
92
|
-
- Blocking vs. reporting severities
|
|
93
|
-
|
|
94
|
-
## State Awareness & Override (V1.4)
|
|
95
|
-
|
|
96
|
-
- Read `.agent-context/state/architecture-map.md` and `.agent-context/state/dependency-map.md` before major modifications.
|
|
97
|
-
- Enforce `.cursorrules` by default and apply `.agent-override.md` only for explicit scoped exceptions.
|
|
98
|
-
|
|
99
|
-
## The Reasoning Clause (MANDATORY)
|
|
100
|
-
|
|
101
|
-
Every time you reject a code block, suggest a change, or enforce a rule, you MUST provide a Reasoning Chain:
|
|
102
|
-
|
|
103
|
-
```
|
|
104
|
-
REASONING CHAIN
|
|
105
|
-
Problem: [WHY the user's current approach/request is dangerous or unprofessional]
|
|
106
|
-
Solution: [The improved, production-grade approach]
|
|
107
|
-
Why Better: [WHY this is more professional — teach the human]
|
|
108
|
-
```
|
|
109
|
-
|
|
110
|
-
## Zero Tolerance & Rejection Protocol
|
|
111
|
-
|
|
112
|
-
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.
|
|
113
|
-
|
|
114
|
-
**SKILL TIER AWARENESS**: Before executing complex tasks, check `.agent-context/policies/llm-judge-threshold.json` to ensure your AI model's tier (beginner/balanced/advanced/expert) meets requirements. Refuse tasks outside your tier.
|
|
115
|
-
|
|
116
|
-
### The Security Halt
|
|
117
|
-
|
|
118
|
-
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.
|
|
119
|
-
|
|
120
|
-
### The "Plan First" Rule
|
|
121
|
-
|
|
122
|
-
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."_
|
|
123
|
-
|
|
124
|
-
### Self-Correction Protocol
|
|
125
|
-
|
|
126
|
-
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.
|
|
127
|
-
|
|
128
|
-
### Dependency Defense
|
|
129
|
-
|
|
130
|
-
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.
|
|
131
|
-
|
|
132
|
-
## Absolute Clean Code Laws
|
|
133
|
-
|
|
134
|
-
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.
|
|
135
|
-
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.
|
|
136
|
-
3. **Layer Separation:** Business logic does NOT touch HTTP. Database logic does NOT leak into services. No exceptions.
|
|
137
|
-
4. **Context First:** NEVER write code without checking `.agent-context/rules/` first.
|
|
138
|
-
5. **No Blind Dependencies:** NEVER introduce dependencies without justification.
|
|
139
|
-
|
|
140
|
-
## Definition of Done
|
|
141
|
-
|
|
142
|
-
**NEVER** declare a task "done" or ready for review without explicitly running and passing `.agent-context/review-checklists/pr-checklist.md`.
|
|
143
|
-
|
|
144
|
-
---
|
|
145
|
-
|
|
146
|
-
## Full Knowledge Injection Checklist
|
|
147
|
-
|
|
148
|
-
**This file (copilot-instructions.md) is your unified agent context.** All 8 knowledge layers are now injected:
|
|
149
|
-
|
|
150
|
-
All Layers Loaded:
|
|
151
|
-
1. Rules (14 files) — Engineering standards
|
|
152
|
-
2. Stacks (10 profiles) — Language conventions
|
|
153
|
-
3. Blueprints (14 templates) — Scaffolding patterns
|
|
154
|
-
4. Skills (6 packs) — Domain expertise [NEW]
|
|
155
|
-
5. Prompts (3 templates) — Request workflows [NEW]
|
|
156
|
-
6. Profiles (3 teams) — Governance defaults [NEW]
|
|
157
|
-
7. State (maps, benchmarks) — Codebase awareness [NEW]
|
|
158
|
-
8. Policies (thresholds) — Quality gates [NEW]
|
|
159
|
-
|
|
160
|
-
You now have 100% context visibility. No knowledge layer is skipped.
|
|
161
|
-
|
|
162
|
-
If you encounter a decision that requires a missing layer, report it immediately.
|
|
163
|
-
|
|
164
|
-
## Full Reference
|
|
165
|
-
|
|
166
|
-
See `.cursorrules` and `AGENTS.md` in the repository root for detailed agent instructions.
|
|
21
|
+
Run [.agent-context/review-checklists/pr-checklist.md](../.agent-context/review-checklists/pr-checklist.md) before declaring work complete.
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
name: Governance Weekly Report
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
schedule:
|
|
5
|
+
- cron: '0 3 * * 1'
|
|
6
|
+
workflow_dispatch:
|
|
7
|
+
|
|
8
|
+
permissions:
|
|
9
|
+
contents: read
|
|
10
|
+
|
|
11
|
+
jobs:
|
|
12
|
+
governance-weekly-report:
|
|
13
|
+
runs-on: ubuntu-latest
|
|
14
|
+
timeout-minutes: 15
|
|
15
|
+
env:
|
|
16
|
+
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
|
|
17
|
+
steps:
|
|
18
|
+
- name: Checkout repository
|
|
19
|
+
uses: actions/checkout@v4
|
|
20
|
+
|
|
21
|
+
- name: Setup Node.js
|
|
22
|
+
uses: actions/setup-node@v4
|
|
23
|
+
with:
|
|
24
|
+
node-version: '22'
|
|
25
|
+
|
|
26
|
+
- name: Run quality trend report
|
|
27
|
+
run: |
|
|
28
|
+
node ./scripts/quality-trend-report.mjs > quality-trend-report.json
|
|
29
|
+
test -s quality-trend-report.json
|
|
30
|
+
|
|
31
|
+
- name: Run weekly governance report
|
|
32
|
+
run: |
|
|
33
|
+
node ./scripts/governance-weekly-report.mjs > weekly-governance-report.json
|
|
34
|
+
test -s weekly-governance-report.json
|
|
35
|
+
|
|
36
|
+
- name: Upload governance artifacts
|
|
37
|
+
if: always()
|
|
38
|
+
uses: actions/upload-artifact@v4
|
|
39
|
+
with:
|
|
40
|
+
name: governance-weekly-report
|
|
41
|
+
path: |
|
|
42
|
+
quality-trend-report.json
|
|
43
|
+
weekly-governance-report.json
|
package/.windsurfrules
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/AGENTS.md
CHANGED
|
@@ -1,181 +1,28 @@
|
|
|
1
|
-
# AGENTS.md
|
|
1
|
+
# AGENTS.md - Thin Adapter
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
3
|
+
Adapter Mode: thin
|
|
4
|
+
Adapter Source: .instructions.md
|
|
5
|
+
Canonical Snapshot SHA256: 361ac86172268a2f20d4f7a1e407c7dd122f1b0c265d085e872254718b078d22
|
|
5
6
|
|
|
6
|
-
|
|
7
|
+
This file is an adapter entrypoint for agent discovery.
|
|
8
|
+
The canonical policy source is [.instructions.md](.instructions.md).
|
|
7
9
|
|
|
8
|
-
|
|
9
|
-
You do not generate "good enough" code — you generate **production-grade** code.
|
|
10
|
+
## Mandatory Bootstrap Chain
|
|
10
11
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
12
|
+
1. Load [.instructions.md](.instructions.md) first as the single source of truth.
|
|
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).
|
|
16
21
|
|
|
17
|
-
##
|
|
18
|
-
If the user's INTENT is to refactor, fix, update, or modify existing code:
|
|
19
|
-
1. Read `.agent-context/rules/architecture.md` and `.agent-context/rules/naming-conv.md`.
|
|
20
|
-
2. Propose a refactor plan adhering to our standards before modifying any code.
|
|
22
|
+
## Trigger Rules
|
|
21
23
|
|
|
22
|
-
|
|
24
|
+
- New project or module requests: propose architecture first and wait for approval.
|
|
25
|
+
- Refactor or fix requests: propose plan first, then execute safely.
|
|
26
|
+
- Completion: run [.agent-context/review-checklists/pr-checklist.md](.agent-context/review-checklists/pr-checklist.md) before declaring done.
|
|
23
27
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
### Rules (Universal — Always Load)
|
|
27
|
-
|
|
28
|
-
| File | Scope |
|
|
29
|
-
|------|-------|
|
|
30
|
-
| [`.agent-context/rules/naming-conv.md`](.agent-context/rules/naming-conv.md) | Naming conventions |
|
|
31
|
-
| [`.agent-context/rules/architecture.md`](.agent-context/rules/architecture.md) | Architecture & structure |
|
|
32
|
-
| [`.agent-context/rules/security.md`](.agent-context/rules/security.md) | Security baseline |
|
|
33
|
-
| [`.agent-context/rules/performance.md`](.agent-context/rules/performance.md) | Performance standards |
|
|
34
|
-
| [`.agent-context/rules/error-handling.md`](.agent-context/rules/error-handling.md) | Error handling |
|
|
35
|
-
| [`.agent-context/rules/testing.md`](.agent-context/rules/testing.md) | Testing standards |
|
|
36
|
-
| [`.agent-context/rules/git-workflow.md`](.agent-context/rules/git-workflow.md) | Git workflow |
|
|
37
|
-
| [`.agent-context/rules/efficiency-vs-hype.md`](.agent-context/rules/efficiency-vs-hype.md) | Dependency selection |
|
|
38
|
-
| [`.agent-context/rules/api-docs.md`](.agent-context/rules/api-docs.md) | API documentation standards |
|
|
39
|
-
| [`.agent-context/rules/microservices.md`](.agent-context/rules/microservices.md) | Microservices decision framework |
|
|
40
|
-
| [`.agent-context/rules/event-driven.md`](.agent-context/rules/event-driven.md) | Event-driven architecture |
|
|
41
|
-
| [`.agent-context/rules/database-design.md`](.agent-context/rules/database-design.md) | Database schema & queries |
|
|
42
|
-
| [`.agent-context/rules/realtime.md`](.agent-context/rules/realtime.md) | Real-time & WebSockets patterns |
|
|
43
|
-
| [`.agent-context/rules/frontend-architecture.md`](.agent-context/rules/frontend-architecture.md) | Frontend state & composition patterns |
|
|
44
|
-
|
|
45
|
-
### State Awareness (V1.4)
|
|
46
|
-
|
|
47
|
-
| File | Purpose |
|
|
48
|
-
|------|---------|
|
|
49
|
-
| [`.agent-context/state/architecture-map.md`](.agent-context/state/architecture-map.md) | Critical-path boundaries and change risk zones |
|
|
50
|
-
| [`.agent-context/state/dependency-map.md`](.agent-context/state/dependency-map.md) | Allowed module dependencies and anti-cycle guidance |
|
|
51
|
-
|
|
52
|
-
### Overrides (V1.4)
|
|
53
|
-
|
|
54
|
-
| File | Purpose |
|
|
55
|
-
|------|---------|
|
|
56
|
-
| [`.agent-override.md`](.agent-override.md) | Explicit, scoped rule exceptions with expiry and owner |
|
|
57
|
-
|
|
58
|
-
### Language Profiles (Load by Stack)
|
|
59
|
-
|
|
60
|
-
| File | When |
|
|
61
|
-
|------|------|
|
|
62
|
-
| [`.agent-context/stacks/typescript.md`](.agent-context/stacks/typescript.md) | TypeScript / Node.js projects |
|
|
63
|
-
| [`.agent-context/stacks/python.md`](.agent-context/stacks/python.md) | Python projects |
|
|
64
|
-
| [`.agent-context/stacks/java.md`](.agent-context/stacks/java.md) | Java / Kotlin projects |
|
|
65
|
-
| [`.agent-context/stacks/php.md`](.agent-context/stacks/php.md) | PHP projects |
|
|
66
|
-
| [`.agent-context/stacks/go.md`](.agent-context/stacks/go.md) | Go projects |
|
|
67
|
-
| [`.agent-context/stacks/csharp.md`](.agent-context/stacks/csharp.md) | C# / .NET projects |
|
|
68
|
-
| [`.agent-context/stacks/rust.md`](.agent-context/stacks/rust.md) | Rust projects |
|
|
69
|
-
| [`.agent-context/stacks/ruby.md`](.agent-context/stacks/ruby.md) | Ruby on Rails projects |
|
|
70
|
-
|
|
71
|
-
### Blueprints (Load When Scaffolding)
|
|
72
|
-
|
|
73
|
-
| File | Creates |
|
|
74
|
-
|------|---------|
|
|
75
|
-
| [`.agent-context/blueprints/api-nextjs.md`](.agent-context/blueprints/api-nextjs.md) | Next.js API project |
|
|
76
|
-
| [`.agent-context/blueprints/nestjs-logic.md`](.agent-context/blueprints/nestjs-logic.md) | NestJS module |
|
|
77
|
-
| [`.agent-context/blueprints/fastapi-service.md`](.agent-context/blueprints/fastapi-service.md) | FastAPI service |
|
|
78
|
-
| [`.agent-context/blueprints/laravel-api.md`](.agent-context/blueprints/laravel-api.md) | Laravel API |
|
|
79
|
-
| [`.agent-context/blueprints/spring-boot-api.md`](.agent-context/blueprints/spring-boot-api.md) | Spring Boot API |
|
|
80
|
-
| [`.agent-context/blueprints/go-service.md`](.agent-context/blueprints/go-service.md) | Go chi HTTP service |
|
|
81
|
-
| [`.agent-context/blueprints/aspnet-api.md`](.agent-context/blueprints/aspnet-api.md) | ASP.NET Minimal API |
|
|
82
|
-
| [`.agent-context/blueprints/ci-github-actions.md`](.agent-context/blueprints/ci-github-actions.md) | GitHub Actions pipeline |
|
|
83
|
-
| [`.agent-context/blueprints/ci-gitlab.md`](.agent-context/blueprints/ci-gitlab.md) | GitLab CI pipeline |
|
|
84
|
-
| [`.agent-context/blueprints/observability.md`](.agent-context/blueprints/observability.md) | OpenTelemetry stack |
|
|
85
|
-
| [`.agent-context/blueprints/graphql-grpc-api.md`](.agent-context/blueprints/graphql-grpc-api.md) | GraphQL / gRPC API definitions |
|
|
86
|
-
| [`.agent-context/blueprints/infrastructure-as-code.md`](.agent-context/blueprints/infrastructure-as-code.md) | Infrastructure as Code pipeline |
|
|
87
|
-
| [`.agent-context/blueprints/kubernetes-manifests.md`](.agent-context/blueprints/kubernetes-manifests.md) | Kubernetes manifests structure |
|
|
88
|
-
### Domain Skills (Load by Context)
|
|
89
|
-
|
|
90
|
-
Domain expertise packs to auto-load when relevant:
|
|
91
|
-
|
|
92
|
-
| File | Domain | When Loaded |
|
|
93
|
-
|------|--------|-------------|
|
|
94
|
-
| [`.agent-context/skills/backend.md`](.agent-context/skills/backend.md) | Backend architecture & services | Any backend project or service design |
|
|
95
|
-
| [`.agent-context/skills/frontend.md`](.agent-context/skills/frontend.md) | Frontend UI/UX & state management | Any frontend or web app project |
|
|
96
|
-
| [`.agent-context/skills/cli.md`](.agent-context/skills/cli.md) | CLI tool design & scripting | Any CLI or automation tool |
|
|
97
|
-
| [`.agent-context/skills/distribution.md`](.agent-context/skills/distribution.md) | Packaging, deployment & release | Any publish/deploy/package scenario |
|
|
98
|
-
| [`.agent-context/skills/fullstack.md`](.agent-context/skills/fullstack.md) | Full-stack integration patterns | Any full-stack feature |
|
|
99
|
-
| [`.agent-context/skills/review-quality.md`](.agent-context/skills/review-quality.md) | Code review & quality standards | Any code review or QA gate |
|
|
100
|
-
|
|
101
|
-
### Prompts (Specialized Request Templates)
|
|
102
|
-
|
|
103
|
-
| File | Purpose | When Used |
|
|
104
|
-
|------|---------|----------|
|
|
105
|
-
| [`.agent-context/prompts/init-project.md`](.agent-context/prompts/init-project.md) | Project initialization & scaffolding | When user says "create new project" |
|
|
106
|
-
| [`.agent-context/prompts/refactor.md`](.agent-context/prompts/refactor.md) | Code refactoring with safety | When user says "refactor" or "improve" |
|
|
107
|
-
| [`.agent-context/prompts/review-code.md`](.agent-context/prompts/review-code.md) | Architectural code review | When user says "review this" |
|
|
108
|
-
|
|
109
|
-
### Team Profiles (Governance Defaults)
|
|
110
|
-
|
|
111
|
-
| File | Profile | Default Stack | CI Guardrails |
|
|
112
|
-
|------|---------|---------------|---------------|
|
|
113
|
-
| [`.agent-context/profiles/platform.md`](.agent-context/profiles/platform.md) | **Platform** — Shared infrastructure team | Go | Strict (critical, high) |
|
|
114
|
-
| [`.agent-context/profiles/regulated.md`](.agent-context/profiles/regulated.md) | **Regulated** — Financial/healthcare compliance | TypeScript + Java | Blocking (all severities) |
|
|
115
|
-
| [`.agent-context/profiles/startup.md`](.agent-context/profiles/startup.md) | **Startup** — Speed + pragmatism | TypeScript + Next.js | Permissive (critical only) |
|
|
116
|
-
|
|
117
|
-
### Policies (Governance Rules)
|
|
118
|
-
|
|
119
|
-
| File | Scope |
|
|
120
|
-
|------|-------|
|
|
121
|
-
| [`.agent-context/policies/llm-judge-threshold.json`](.agent-context/policies/llm-judge-threshold.json) | LLM quality gates & skill tier thresholds |
|
|
122
|
-
### Review Checklists (Load Before Completion)
|
|
123
|
-
|
|
124
|
-
| File | Purpose |
|
|
125
|
-
|------|---------|
|
|
126
|
-
| [`.agent-context/review-checklists/pr-checklist.md`](.agent-context/review-checklists/pr-checklist.md) | Pre-merge quality gate |
|
|
127
|
-
| [`.agent-context/review-checklists/security-audit.md`](.agent-context/review-checklists/security-audit.md) | Security review |
|
|
128
|
-
| [`.agent-context/review-checklists/performance-audit.md`](.agent-context/review-checklists/performance-audit.md) | Performance review |
|
|
129
|
-
| [`.agent-context/review-checklists/architecture-review.md`](.agent-context/review-checklists/architecture-review.md) | Architecture review |
|
|
130
|
-
|
|
131
|
-
## The Reasoning Clause (MANDATORY)
|
|
132
|
-
Every time you reject a code block, suggest a change, or enforce a rule, you MUST provide a Reasoning Chain:
|
|
133
|
-
|
|
134
|
-
```
|
|
135
|
-
REASONING CHAIN
|
|
136
|
-
Problem: [WHY the user's current approach/request is dangerous or unprofessional]
|
|
137
|
-
Solution: [The improved, production-grade approach]
|
|
138
|
-
Why Better: [WHY this is more professional — teach the human]
|
|
139
|
-
```
|
|
140
|
-
|
|
141
|
-
## Zero Tolerance & Rejection Protocol
|
|
142
|
-
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.
|
|
143
|
-
|
|
144
|
-
### The Security Halt
|
|
145
|
-
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.
|
|
146
|
-
|
|
147
|
-
### The "Plan First" Rule
|
|
148
|
-
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."*
|
|
149
|
-
|
|
150
|
-
### Self-Correction Protocol
|
|
151
|
-
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.
|
|
152
|
-
|
|
153
|
-
### Dependency Defense
|
|
154
|
-
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.
|
|
155
|
-
|
|
156
|
-
## Absolute Clean Code Laws
|
|
157
|
-
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.
|
|
158
|
-
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.
|
|
159
|
-
3. **Layer Separation:** Business logic does NOT touch HTTP. Database logic does NOT leak into services. No exceptions.
|
|
160
|
-
4. **Context First:** NEVER write code without checking `.agent-context/rules/` first.
|
|
161
|
-
5. **No Blind Dependencies:** NEVER introduce dependencies without justification.
|
|
162
|
-
|
|
163
|
-
## Definition of Done
|
|
164
|
-
**NEVER** declare a task "done" or ready for review without explicitly running and passing `.agent-context/review-checklists/pr-checklist.md`.
|
|
165
|
-
|
|
166
|
-
---
|
|
167
|
-
|
|
168
|
-
## Knowledge Inventory Checklist
|
|
169
|
-
|
|
170
|
-
**AUDIT REQUIREMENT**: Every agent session MUST verify all 8 knowledge layers are loaded:
|
|
171
|
-
|
|
172
|
-
- [ ] **Layer 1: Rules** (14 files) — Mandatory governance & clean code standards
|
|
173
|
-
- [ ] **Layer 2: Stacks** (10 profiles) — Language-specific tooling & conventions
|
|
174
|
-
- [ ] **Layer 3: Blueprints** (14 templates) — Scaffolding & architecture patterns
|
|
175
|
-
- [ ] **Layer 4: Skills** (6 packs) — Domain expertise by scenario
|
|
176
|
-
- [ ] **Layer 5: Prompts** (3 templates) — Request-specific workflows
|
|
177
|
-
- [ ] **Layer 6: Profiles** (3 teams) — Governance defaults by org type
|
|
178
|
-
- [ ] **Layer 7: State** (benchmarks, maps) — Codebase-aware decisions
|
|
179
|
-
- [ ] **Layer 8: Policies** (thresholds) — Enforcement & quality gates
|
|
180
|
-
|
|
181
|
-
WARNING: If any layer is missing, this indicates incomplete injection. Report to maintain context integrity.
|
|
28
|
+
If this adapter drifts from canonical behavior, refresh from [.instructions.md](.instructions.md) and update the hash metadata.
|
package/README.md
CHANGED
|
@@ -71,8 +71,16 @@ If you want a plug-and-play starter instead of answering every question, use a p
|
|
|
71
71
|
npx @ryuenn3123/agentic-senior-core init --preset frontend-web
|
|
72
72
|
npx @ryuenn3123/agentic-senior-core init --preset backend-api
|
|
73
73
|
npx @ryuenn3123/agentic-senior-core init --preset mobile-react-native
|
|
74
|
+
npx @ryuenn3123/agentic-senior-core init --preset java-enterprise-api
|
|
75
|
+
npx @ryuenn3123/agentic-senior-core init --preset dotnet-enterprise-api
|
|
74
76
|
```
|
|
75
77
|
|
|
78
|
+
Expanded preset catalog:
|
|
79
|
+
|
|
80
|
+
- `frontend-web`, `backend-api`, `fullstack-product`, `platform-governance`
|
|
81
|
+
- `mobile-react-native`, `mobile-flutter`, `observability-platform`
|
|
82
|
+
- `typescript-nestjs-service`, `java-enterprise-api`, `dotnet-enterprise-api`, `php-laravel-api`, `kubernetes-platform`
|
|
83
|
+
|
|
76
84
|
### Option 2: GitHub Bootstrap Scripts (No npx required)
|
|
77
85
|
|
|
78
86
|
Run directly from this repository bootstrap script and inject rules into your project root.
|
|
@@ -316,6 +324,13 @@ Track stack-detection KPI trends:
|
|
|
316
324
|
npm run benchmark:detection
|
|
317
325
|
```
|
|
318
326
|
|
|
327
|
+
Generate governance observability artifacts:
|
|
328
|
+
|
|
329
|
+
```bash
|
|
330
|
+
npm run report:quality-trend
|
|
331
|
+
npm run report:governance-weekly
|
|
332
|
+
```
|
|
333
|
+
|
|
319
334
|
---
|
|
320
335
|
|
|
321
336
|
## Roadmap
|
package/lib/cli/constants.mjs
CHANGED
|
@@ -93,6 +93,41 @@ export const INIT_PRESETS = {
|
|
|
93
93
|
ci: true,
|
|
94
94
|
description: 'Observability and platform starter',
|
|
95
95
|
},
|
|
96
|
+
'typescript-nestjs-service': {
|
|
97
|
+
profile: 'balanced',
|
|
98
|
+
stack: 'typescript.md',
|
|
99
|
+
blueprint: 'nestjs-logic.md',
|
|
100
|
+
ci: true,
|
|
101
|
+
description: 'TypeScript service starter with NestJS module blueprint',
|
|
102
|
+
},
|
|
103
|
+
'java-enterprise-api': {
|
|
104
|
+
profile: 'strict',
|
|
105
|
+
stack: 'java.md',
|
|
106
|
+
blueprint: 'spring-boot-api.md',
|
|
107
|
+
ci: true,
|
|
108
|
+
description: 'Enterprise API starter for JVM teams',
|
|
109
|
+
},
|
|
110
|
+
'dotnet-enterprise-api': {
|
|
111
|
+
profile: 'strict',
|
|
112
|
+
stack: 'csharp.md',
|
|
113
|
+
blueprint: 'aspnet-api.md',
|
|
114
|
+
ci: true,
|
|
115
|
+
description: '.NET API starter with strict governance defaults',
|
|
116
|
+
},
|
|
117
|
+
'php-laravel-api': {
|
|
118
|
+
profile: 'balanced',
|
|
119
|
+
stack: 'php.md',
|
|
120
|
+
blueprint: 'laravel-api.md',
|
|
121
|
+
ci: true,
|
|
122
|
+
description: 'Laravel API starter with balanced guardrails',
|
|
123
|
+
},
|
|
124
|
+
'kubernetes-platform': {
|
|
125
|
+
profile: 'strict',
|
|
126
|
+
stack: 'go.md',
|
|
127
|
+
blueprint: 'kubernetes-manifests.md',
|
|
128
|
+
ci: true,
|
|
129
|
+
description: 'Platform starter focused on Kubernetes delivery assets',
|
|
130
|
+
},
|
|
96
131
|
};
|
|
97
132
|
|
|
98
133
|
export const PROFILE_PRESETS = {
|
package/lib/cli/utils.mjs
CHANGED
|
@@ -9,11 +9,14 @@ import {
|
|
|
9
9
|
REPO_ROOT,
|
|
10
10
|
ALLOWED_SEVERITY_LEVELS,
|
|
11
11
|
PROFILE_PRESETS,
|
|
12
|
+
INIT_PRESETS,
|
|
12
13
|
entryPointFiles,
|
|
13
14
|
directoryCopies,
|
|
14
15
|
} from './constants.mjs';
|
|
15
16
|
|
|
16
17
|
export function printUsage() {
|
|
18
|
+
const presetNames = Object.keys(INIT_PRESETS).join(', ');
|
|
19
|
+
|
|
17
20
|
console.log('Agentic-Senior-Core CLI');
|
|
18
21
|
console.log('');
|
|
19
22
|
console.log('Local runtime:');
|
|
@@ -36,7 +39,7 @@ export function printUsage() {
|
|
|
36
39
|
console.log(' --help Show help');
|
|
37
40
|
console.log(' --version Show CLI version');
|
|
38
41
|
console.log(' --profile Choose beginner, balanced, or strict');
|
|
39
|
-
console.log(
|
|
42
|
+
console.log(` --preset Use a plug-and-play starter preset (${presetNames})`);
|
|
40
43
|
console.log(' --profile-pack Apply a team profile pack (startup, regulated, platform)');
|
|
41
44
|
console.log(' --newbie Alias for --profile beginner');
|
|
42
45
|
console.log(' --stack Override stack selection');
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ryuenn3123/agentic-senior-core",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.7",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
|
|
6
6
|
"bin": {
|
|
@@ -50,6 +50,8 @@
|
|
|
50
50
|
"benchmark:token": "node ./scripts/token-optimization-benchmark.mjs",
|
|
51
51
|
"benchmark:gate": "node ./scripts/benchmark-gate.mjs",
|
|
52
52
|
"benchmark:intelligence": "node ./scripts/benchmark-intelligence.mjs",
|
|
53
|
+
"report:quality-trend": "node ./scripts/quality-trend-report.mjs",
|
|
54
|
+
"report:governance-weekly": "node ./scripts/governance-weekly-report.mjs",
|
|
53
55
|
"validate": "node ./scripts/validate.mjs",
|
|
54
56
|
"test": "node --test ./tests/cli-smoke.test.mjs ./tests/llm-judge.test.mjs ./tests/enterprise-ops.test.mjs ./tests/skill-tier-gate.test.mjs"
|
|
55
57
|
}
|