@ryuenn3123/agentic-senior-core 6.16.0 → 6.16.1
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/.agents/plugins/agentic-senior-core/.codex-plugin/plugin.json +1 -1
- package/.agents/plugins/agentic-senior-core/plugin.json +1 -1
- package/.agents/plugins/agentic-senior-core/skills/asc/SKILL.md +10 -2
- package/.agents/plugins/agentic-senior-core/skills/asc-reference/SKILL.md +26 -13
- package/.agents/plugins/agentic-senior-core/skills/asc-test/SKILL.md +33 -15
- package/.agents/plugins/agentic-senior-core/skills/asc-ui/SKILL.md +51 -30
- package/gemini-extension.json +1 -1
- package/package.json +1 -1
- package/plugin.yaml +1 -1
|
@@ -79,6 +79,14 @@ asc uninstall # Clean up adapter files and hooks
|
|
|
79
79
|
|
|
80
80
|
## 6. On-Demand Reference Library
|
|
81
81
|
|
|
82
|
-
|
|
82
|
+
> [!IMPORTANT]
|
|
83
|
+
> **Reference Path Resolution:**
|
|
84
|
+
> Reference files do NOT reside in the user workspace root. They are located adjacent to this `SKILL.md` file:
|
|
85
|
+
> `<skill_directory>/references/<file>.md`
|
|
86
|
+
> Prepend this skill's directory path when calling `read_file`.
|
|
87
|
+
|
|
88
|
+
When authoring, refactoring, or tailoring skills, you MUST call `read_file` on `references/writing-skills.md` before generating skill files:
|
|
89
|
+
|
|
90
|
+
| Topic / Requirement | Mandatory Reference Path |
|
|
83
91
|
|---|---|
|
|
84
|
-
| Authoring skills, trigger descriptions & 150-line routers |
|
|
92
|
+
| Authoring skills, trigger descriptions & 150-line routers | `references/writing-skills.md` |
|
|
@@ -28,16 +28,28 @@ Every backend and infrastructure change must satisfy these baseline invariants:
|
|
|
28
28
|
|
|
29
29
|
---
|
|
30
30
|
|
|
31
|
-
## 2.
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
31
|
+
## 2. Architecture Pre-Flight Gate & Reference Library (BLOCKING)
|
|
32
|
+
|
|
33
|
+
> [!IMPORTANT]
|
|
34
|
+
> **Reference Path Resolution:**
|
|
35
|
+
> Reference files do NOT reside in the user workspace root. They are located adjacent to this `SKILL.md` file:
|
|
36
|
+
> `<skill_directory>/references/<file>.md`
|
|
37
|
+
> Prepend this skill's directory path when calling `read_file`.
|
|
38
|
+
|
|
39
|
+
Before modifying database schemas, writing API contracts, drafting Dockerfiles, or writing retry logic:
|
|
40
|
+
1. **Mandatory Ingestion (BLOCKING GATE):** Call `read_file` on the matching domain reference BEFORE drafting plans or changing code:
|
|
41
|
+
- REST semantics, cursor pagination, RFC 9457, GraphQL ➔ `references/api.md`
|
|
42
|
+
- B-Tree indexing, N+1 queries, row locking, expand-and-contract migrations ➔ `references/database.md`
|
|
43
|
+
- Multi-stage Docker, non-root users, 12-factor env, health probes ➔ `references/infrastructure.md`
|
|
44
|
+
- Timeouts, jittered backoff, circuit breakers, hard vs. soft dependencies ➔ `references/resilience.md`
|
|
45
|
+
*Do NOT generate migrations, endpoint signatures, or network clients until this reference is loaded.*
|
|
46
|
+
|
|
47
|
+
| Domain | Scope & Trigger | Mandatory Reference Path |
|
|
36
48
|
|---|---|---|
|
|
37
|
-
| **API Design** | REST semantics, cursor pagination, RFC 9457, GraphQL DataLoader
|
|
38
|
-
| **Database** | B-Tree indexing, N+1 prevention, row locking (`FOR UPDATE`), expand-and-contract |
|
|
39
|
-
| **Infrastructure** | Multi-stage Docker, non-root users, 12-factor env validation, liveness/readiness |
|
|
40
|
-
| **Resilience** |
|
|
49
|
+
| **API Design** | REST semantics, cursor pagination, RFC 9457 problem details, GraphQL DataLoader | `references/api.md` |
|
|
50
|
+
| **Database** | B-Tree indexing, N+1 prevention, row locking (`FOR UPDATE`), expand-and-contract migrations | `references/database.md` |
|
|
51
|
+
| **Infrastructure** | Multi-stage Docker, non-root users, 12-factor env validation, liveness/readiness probes | `references/infrastructure.md` |
|
|
52
|
+
| **Resilience** | Outbound timeouts, full jitter backoff, circuit breakers, hard vs soft dependencies | `references/resilience.md` |
|
|
41
53
|
|
|
42
54
|
---
|
|
43
55
|
|
|
@@ -55,7 +67,8 @@ Before writing integration code, classify external services:
|
|
|
55
67
|
## 4. Verification & Handoff Sweep
|
|
56
68
|
|
|
57
69
|
Before completing backend or infrastructure work:
|
|
58
|
-
1.
|
|
59
|
-
2. Verify
|
|
60
|
-
3.
|
|
61
|
-
4.
|
|
70
|
+
1. Confirm constraints from the loaded `references/*.md` file were applied in contracts, schemas, and configurations.
|
|
71
|
+
2. Verify query execution plan (`EXPLAIN ANALYZE`) for newly introduced SQL queries.
|
|
72
|
+
3. Verify all outbound network calls have timeout parameters.
|
|
73
|
+
4. Validate startup configuration fails fast on missing environment variables.
|
|
74
|
+
5. Confirm migrations run cleanly in both `up` and `down` directions.
|
|
@@ -21,9 +21,25 @@ Every feature, bugfix, or refactor must follow the Red-Green-Refactor sequence:
|
|
|
21
21
|
|
|
22
22
|
---
|
|
23
23
|
|
|
24
|
-
## 2. The Verification Gate
|
|
25
|
-
|
|
26
|
-
|
|
24
|
+
## 2. The Verification Gate & Pre-Flight Ingestion (BLOCKING)
|
|
25
|
+
|
|
26
|
+
> [!IMPORTANT]
|
|
27
|
+
> **Reference Path Resolution:**
|
|
28
|
+
> Reference files do NOT reside in the user workspace root. They are located adjacent to this `SKILL.md` file:
|
|
29
|
+
> `<skill_directory>/references/<file>.md`
|
|
30
|
+
> Prepend this skill's directory path when calling `read_file`.
|
|
31
|
+
|
|
32
|
+
Before writing tests, running suites, or claiming verification:
|
|
33
|
+
1. **Mandatory Ingestion (BLOCKING GATE):** Call `read_file` on the tier reference matching your testing requirement BEFORE taking action:
|
|
34
|
+
- Writing unit tests / TDD cycle ➔ `references/tdd-cycle.md`
|
|
35
|
+
- Behavior testing, boundary isolation, mocks/fakes ➔ `references/test-design.md`
|
|
36
|
+
- Playwright browser tests, locators, page objects ➔ `references/e2e-playwright.md`
|
|
37
|
+
- Acceptance criteria, UAT checklists, edge case quads ➔ `references/uat.md`
|
|
38
|
+
- Bug reproduction, root-cause verification, regression proof ➔ `references/regression-proof.md`
|
|
39
|
+
- Flaky tests, timing race conditions, 50-run stress loop ➔ `references/flaky-tests.md`
|
|
40
|
+
*Do NOT write test assertions or declare claims until this reference is loaded.*
|
|
41
|
+
|
|
42
|
+
2. **Never make a claim regarding test status without fresh execution evidence:**
|
|
27
43
|
|
|
28
44
|
```
|
|
29
45
|
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
|
|
@@ -81,24 +97,26 @@ Select the lowest testing tier that validates the requirement:
|
|
|
81
97
|
|
|
82
98
|
## 5. On-Demand Reference Library
|
|
83
99
|
|
|
84
|
-
|
|
100
|
+
> [!IMPORTANT]
|
|
101
|
+
> **Resolution Note:** All paths below are relative to this `SKILL.md` file's parent folder (`.../skills/asc-test/`). Prepend this skill's directory path when calling `read_file`.
|
|
85
102
|
|
|
86
|
-
|
|
|
103
|
+
| Testing Domain / Trigger | Mandatory Reference Path |
|
|
87
104
|
|---|---|
|
|
88
|
-
| Red-Green-Refactor mechanics & whole-suite checks |
|
|
89
|
-
| Behavior testing, boundary isolation & mocking |
|
|
90
|
-
| Playwright E2E, reconnaissance & locator hierarchy |
|
|
91
|
-
| Given/When/Then acceptance criteria & edge case quad |
|
|
92
|
-
| 3-step bugfix verification & regression proof |
|
|
93
|
-
| Flakiness root causes & 50-run stress loop |
|
|
105
|
+
| Red-Green-Refactor mechanics & whole-suite checks | `references/tdd-cycle.md` |
|
|
106
|
+
| Behavior testing, boundary isolation & mocking | `references/test-design.md` |
|
|
107
|
+
| Playwright E2E, reconnaissance & locator hierarchy | `references/e2e-playwright.md` |
|
|
108
|
+
| Given/When/Then acceptance criteria & edge case quad | `references/uat.md` |
|
|
109
|
+
| 3-step bugfix verification & regression proof | `references/regression-proof.md` |
|
|
110
|
+
| Flakiness root causes & 50-run stress loop | `references/flaky-tests.md` |
|
|
94
111
|
|
|
95
112
|
---
|
|
96
113
|
|
|
97
114
|
## 6. Verification & Handoff Sweep
|
|
98
115
|
|
|
99
116
|
Before declaring any coding or testing task complete:
|
|
100
|
-
1. **
|
|
101
|
-
2. **
|
|
102
|
-
3. **
|
|
103
|
-
4. **
|
|
117
|
+
1. **Reference Compliance:** Confirm constraints from the loaded `references/*.md` file were applied.
|
|
118
|
+
2. **Regression Proof:** For bugfixes, confirm the test failed without the fix and passes with it.
|
|
119
|
+
3. **Whole-Suite Run:** Execute the full test suite (`ascx npm test` or project test runner); confirm exit code 0.
|
|
120
|
+
4. **No Assertions Weakened:** Verify no existing test assertions were deleted or commented out to simulate success.
|
|
121
|
+
5. **Hermetic State:** Ensure tests clean up temporary files, database records, and environment variables.
|
|
104
122
|
|
|
@@ -33,25 +33,44 @@ Every UI edit must satisfy these 15 rules without exception:
|
|
|
33
33
|
|
|
34
34
|
---
|
|
35
35
|
|
|
36
|
-
## 2. Pre-Flight & Material Inventory
|
|
37
|
-
|
|
38
|
-
Before declaring markup,
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
36
|
+
## 2. Pre-Flight & Material Inventory (BLOCKING GATE)
|
|
37
|
+
|
|
38
|
+
Before declaring markup, drafting redesign plans, or inspecting user code:
|
|
39
|
+
|
|
40
|
+
1. **Locate Skill Directory & References (MANDATORY):**
|
|
41
|
+
Reference files do NOT reside in the user workspace root. They are located adjacent to this `SKILL.md` file:
|
|
42
|
+
`<skill_directory>/references/<category>/<file>.md`
|
|
43
|
+
Identify the path of this `SKILL.md` file (provided by host/tooling) and resolve all reference paths relative to it.
|
|
44
|
+
|
|
45
|
+
2. **Step 1 — Surface Mode Ingestion (MANDATORY GATE):**
|
|
46
|
+
Classify the surface and execute `read_file` on the corresponding mode reference BEFORE inspecting files or writing code:
|
|
47
|
+
- Dashboards, settings, data tables, developer tools ➔ `references/modes/operate.md`
|
|
48
|
+
- Landing pages, pricing tiers, conversion flows ➔ `references/modes/persuade.md`
|
|
49
|
+
- Documentation, changelogs, knowledge bases ➔ `references/modes/read.md`
|
|
50
|
+
- Showcases, portfolios, interactive galleries ➔ `references/modes/experience.md`
|
|
51
|
+
*Do NOT proceed until you have read the mode reference into context.*
|
|
52
|
+
|
|
53
|
+
3. **Step 2 — Secondary Craft Ingestion:**
|
|
54
|
+
Execute `read_file` on at least one relevant craft reference for your task from Section 5 (e.g. `references/craft/typography.md`, `references/craft/color-surfaces.md`, or `references/divergence.md`).
|
|
55
|
+
|
|
56
|
+
4. **Step 3 — Workspace Material Inventory:**
|
|
57
|
+
Only AFTER loading the mode reference, inspect the workspace:
|
|
58
|
+
- **Design Tokens:** Read project CSS variables, Tailwind configuration, or existing components in `components/` or `ui/`. If `DESIGN.md` exists, read it (read-only). Never create or edit persistent checkpoint files.
|
|
59
|
+
- **Take Material Inventory:**
|
|
60
|
+
- **Real:** Concrete numbers, existing endpoints, actual data attributes.
|
|
61
|
+
- **Pictures:** Actual screenshots and product visual assets.
|
|
62
|
+
- **Absent:** Missing quotes, missing logos, or unverified metrics—these are omitted entirely.
|
|
44
63
|
|
|
45
64
|
---
|
|
46
65
|
|
|
47
66
|
## 3. Surface Modes & Ambition Scaling
|
|
48
67
|
|
|
49
|
-
|
|
68
|
+
Visual posture is governed by the surface type, not product branding. Every surface maps to an enforced mode reference file:
|
|
50
69
|
|
|
51
|
-
- **Operate (`references/modes/operate.md`):**
|
|
52
|
-
- **Persuade (`references/modes/persuade.md`):**
|
|
53
|
-
- **Read (`references/modes/read.md`):**
|
|
54
|
-
- **Experience (`references/modes/experience.md`):**
|
|
70
|
+
- **Operate (`references/modes/operate.md`):** Dense scannability, master-detail rails, `tabular-nums`, inline progressive disclosure.
|
|
71
|
+
- **Persuade (`references/modes/persuade.md`):** 80-word viewport budget, asymmetric posture, single signature element, zero equal-weight 3-card grids.
|
|
72
|
+
- **Read (`references/modes/read.md`):** 65–75ch measure (`max-w-prose`), dual-rail navigation, syntax-highlighted code blocks.
|
|
73
|
+
- **Experience (`references/modes/experience.md`):** Receding interface chrome, full-bleed visual canvas, tactile exploration.
|
|
55
74
|
|
|
56
75
|
---
|
|
57
76
|
|
|
@@ -64,28 +83,30 @@ Determine visual posture from the **surface**, not the product brand:
|
|
|
64
83
|
|
|
65
84
|
## 5. On-Demand Reference Library
|
|
66
85
|
|
|
67
|
-
|
|
86
|
+
> [!IMPORTANT]
|
|
87
|
+
> **Resolution Note:** All paths below are relative to this `SKILL.md` file's parent folder (`.../skills/asc-ui/`). When calling `read_file`, prepend this skill's directory path.
|
|
68
88
|
|
|
69
|
-
|
|
|
89
|
+
| Target Domain / Task Requirement | Mandatory Reference Path |
|
|
70
90
|
|---|---|
|
|
71
|
-
| Waivable defaults & waiver syntax |
|
|
72
|
-
| Typography, line-height & tabular numbers |
|
|
73
|
-
| Color tokens, 60-30-10 & elevation |
|
|
74
|
-
| Micro-interactions & GPU motion |
|
|
75
|
-
| Native surfaces (selection, caret, scrollbars) |
|
|
76
|
-
| 50% reduction, active verbs & i18n |
|
|
77
|
-
| Responsive reflow, dvh & touch targets |
|
|
78
|
-
| WCAG 2.2 AA contrast & keyboard operability |
|
|
79
|
-
| The Data State Quad & mutation feedback |
|
|
80
|
-
| Anti-convergence, 3 Waves of Tells & Mirror Test |
|
|
81
|
-
| Structured UI audit matrix |
|
|
91
|
+
| Waivable defaults & waiver syntax | `references/reflexes.md` |
|
|
92
|
+
| Typography, line-height & tabular numbers | `references/craft/typography.md` |
|
|
93
|
+
| Color tokens, 60-30-10 & elevation | `references/craft/color-surfaces.md` |
|
|
94
|
+
| Micro-interactions & GPU motion | `references/craft/motion.md` |
|
|
95
|
+
| Native surfaces (selection, caret, scrollbars) | `references/craft/browser-surfaces.md` |
|
|
96
|
+
| 50% reduction, active verbs & i18n | `references/copy-i18n.md` |
|
|
97
|
+
| Responsive reflow, dvh & touch targets | `references/mobile-responsive.md` |
|
|
98
|
+
| WCAG 2.2 AA contrast & keyboard operability | `references/accessibility.md` |
|
|
99
|
+
| The Data State Quad & mutation feedback | `references/states-feedback.md` |
|
|
100
|
+
| Anti-convergence, 3 Waves of Tells & Mirror Test | `references/divergence.md` |
|
|
101
|
+
| Structured UI audit matrix | `references/redesign-audit.md` |
|
|
82
102
|
|
|
83
103
|
---
|
|
84
104
|
|
|
85
105
|
## 6. Verification & Handoff Sweep
|
|
86
106
|
|
|
87
107
|
Before completing any UI task, run this mechanical check:
|
|
88
|
-
1. **
|
|
89
|
-
2. **
|
|
90
|
-
3. **
|
|
91
|
-
4. **
|
|
108
|
+
1. **Reference Compliance:** Confirm constraints from the loaded `references/modes/<mode>.md` and craft references were strictly applied.
|
|
109
|
+
2. **State Quad:** Loading skeleton, empty state, error with retry, and populated data are all handled.
|
|
110
|
+
3. **Pending Feedback:** Buttons disable and display feedback during ongoing mutations.
|
|
111
|
+
4. **Contrast & Focus:** Verify keyboard tab flow and high-contrast `:focus-visible` styling.
|
|
112
|
+
5. **Lint Check:** Verify changes against `hooks/lib/known-ui-slop-patterns.json`.
|
package/gemini-extension.json
CHANGED
package/package.json
CHANGED
package/plugin.yaml
CHANGED