code-ai-installer 1.1.4 → 1.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -0
- package/dist/banner.d.ts +4 -0
- package/dist/banner.js +35 -0
- package/dist/index.js +39 -0
- package/dist/sourceResolver.d.ts +2 -0
- package/dist/sourceResolver.js +27 -5
- package/dist/types.d.ts +1 -0
- package/locales/en/.agents/a11y_baseline/SKILL.md +41 -0
- package/locales/en/.agents/adr_log/SKILL.md +69 -0
- package/locales/en/.agents/api_contract_compliance_review/SKILL.md +18 -0
- package/locales/en/.agents/api_contracts/SKILL.md +42 -0
- package/locales/en/.agents/architecture_compliance_review/SKILL.md +17 -0
- package/locales/en/.agents/architecture_doc/SKILL.md +92 -0
- package/locales/en/.agents/board/SKILL.md +43 -0
- package/locales/en/.agents/cloud_infrastructure_security/SKILL.md +68 -0
- package/locales/en/.agents/code_review_checklist/SKILL.md +47 -0
- package/locales/en/.agents/current_state_analysis/SKILL.md +44 -0
- package/locales/en/.agents/data_model/SKILL.md +40 -0
- package/locales/en/.agents/dependency_supply_chain_review/SKILL.md +20 -0
- package/locales/en/.agents/deployment_ci_plan/SKILL.md +51 -0
- package/locales/en/.agents/design_intake/SKILL.md +71 -0
- package/locales/en/.agents/design_parity_review/SKILL.md +73 -0
- package/locales/en/.agents/design_systems/SKILL.md +15 -0
- package/locales/en/.agents/dev_reference_snippets/SKILL.md +397 -0
- package/locales/en/.agents/docker_kubernetes_architecture/SKILL.md +144 -0
- package/locales/en/.agents/es2025_beast_practices/SKILL.md +15 -0
- package/locales/en/.agents/gates/SKILL.md +35 -0
- package/locales/en/.agents/go_beast_practices/SKILL.md +23 -0
- package/locales/en/.agents/handoff/SKILL.md +52 -0
- package/locales/en/.agents/k8s_manifests_conventions/SKILL.md +175 -0
- package/locales/en/.agents/memory/SKILL.md +29 -0
- package/locales/en/.agents/mongodb_mongoose_best_practices/SKILL.md +233 -0
- package/locales/en/.agents/node_express_beast_practices/SKILL.md +30 -0
- package/locales/en/.agents/observability_logging/SKILL.md +16 -0
- package/locales/en/.agents/observability_plan/SKILL.md +38 -0
- package/locales/en/.agents/observability_review/SKILL.md +20 -0
- package/locales/en/.agents/performance_review_baseline/SKILL.md +17 -0
- package/locales/en/.agents/pm_backlog/SKILL.md +32 -0
- package/locales/en/.agents/pm_interview/SKILL.md +56 -0
- package/locales/en/.agents/pm_prd/SKILL.md +56 -0
- package/locales/en/.agents/qa_api_contract_tests/SKILL.md +16 -0
- package/locales/en/.agents/qa_e2e_playwright/SKILL.md +0 -0
- package/locales/en/.agents/qa_manual_run/SKILL.md +16 -0
- package/locales/en/.agents/qa_security_smoke_tests/SKILL.md +14 -0
- package/locales/en/.agents/qa_test_plan/SKILL.md +20 -0
- package/locales/en/.agents/qa_ui_a11y_smoke/SKILL.md +12 -0
- package/locales/en/.agents/react_15_3_wix_iframe/SKILL.md +20 -0
- package/locales/en/.agents/react_beast_practices/SKILL.md +29 -0
- package/locales/en/.agents/release_gate/SKILL.md +77 -0
- package/locales/en/.agents/release_gate_checklist_template/SKILL.md +68 -0
- package/locales/en/.agents/review_reference_snippets/SKILL.md +436 -0
- package/locales/en/.agents/security_baseline_dev/SKILL.md +16 -0
- package/locales/en/.agents/security_review/SKILL.md +55 -0
- package/locales/en/.agents/security_review_baseline/SKILL.md +25 -0
- package/locales/en/.agents/state_rtk_beast_practices/SKILL.md +15 -0
- package/locales/en/.agents/state_zustand_beast_practices/SKILL.md +11 -0
- package/locales/en/.agents/styling_css_stack/SKILL.md +12 -0
- package/locales/en/.agents/system_design_checklist/SKILL.md +48 -0
- package/locales/en/.agents/tanstack_beast_practices/SKILL.md +19 -0
- package/locales/en/.agents/tdd_workflow/SKILL.md +34 -0
- package/locales/en/.agents/testing_strategy_js/SKILL.md +30 -0
- package/locales/en/.agents/tests_quality_review/SKILL.md +18 -0
- package/locales/en/.agents/threat_model_baseline/SKILL.md +57 -0
- package/locales/en/.agents/tooling_bun_biome/SKILL.md +17 -0
- package/locales/en/.agents/typescript_beast_practices/SKILL.md +15 -0
- package/locales/en/.agents/ui_a11y_smoke_review/SKILL.md +15 -0
- package/locales/en/.agents/ui_inventory/SKILL.md +50 -0
- package/locales/en/.agents/ux_discovery/SKILL.md +48 -0
- package/locales/en/.agents/ux_spec/SKILL.md +56 -0
- package/locales/en/.agents/wix_self_hosted_embedded_script/SKILL.md +88 -0
- package/locales/en/AGENTS.md +120 -0
- package/locales/en/agents/architect.md +239 -0
- package/locales/en/agents/conductor.md +205 -0
- package/locales/en/agents/product_manager.md +119 -0
- package/locales/en/agents/reviewer.md +200 -0
- package/locales/en/agents/senior_full_stack.md +216 -0
- package/locales/en/agents/tester.md +186 -0
- package/locales/en/agents/ux_ui_designer.md +144 -0
- package/package.json +3 -2
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: current_state_analysis
|
|
3
|
+
description: Analysis of the current repository architecture: conventions, patterns, technical debt, scaling bottlenecks, security risks and consistency.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
#Skill: Current State Analysis
|
|
7
|
+
|
|
8
|
+
## Goal
|
|
9
|
+
Understand the current system so that new solutions do not break conventions and actually reduce technical debt.
|
|
10
|
+
|
|
11
|
+
## When to use
|
|
12
|
+
- The project already exists / there is a repository with code
|
|
13
|
+
- There are legacy or partially implemented features
|
|
14
|
+
|
|
15
|
+
## Exit (Deliverables)
|
|
16
|
+
- Current Architecture Summary
|
|
17
|
+
- Patterns & Conventions
|
|
18
|
+
- Technical Debt (top 5–15)
|
|
19
|
+
- Scalability limitations
|
|
20
|
+
- Security baseline issues (if visible)
|
|
21
|
+
- Recommendations (quick wins + strategic)
|
|
22
|
+
|
|
23
|
+
## Algorithm
|
|
24
|
+
1) Overview of the repo structure (folders, layers, boundaries)
|
|
25
|
+
2) Define key patterns (FE/BE/data) and style
|
|
26
|
+
3) Find bottlenecks:
|
|
27
|
+
- statefulness
|
|
28
|
+
- N+1/slow queries
|
|
29
|
+
- strong connectivity
|
|
30
|
+
- no caching (if needed)
|
|
31
|
+
- lack of observability
|
|
32
|
+
4) Record technical debt and risks
|
|
33
|
+
5) Suggest a fix plan: quick wins vs later
|
|
34
|
+
|
|
35
|
+
## Response format
|
|
36
|
+
### Summary
|
|
37
|
+
### Deliverables
|
|
38
|
+
### Findings
|
|
39
|
+
- Patterns/Conventions
|
|
40
|
+
- Tech Debt
|
|
41
|
+
- Scalability Limits
|
|
42
|
+
- Security Notes
|
|
43
|
+
### Recommendations
|
|
44
|
+
### Next Actions (IDs: ARCH-xx)
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: data_model
|
|
3
|
+
description: Data model and storage strategy: normalization/denormalization, indexes, transactions, cache, (optional) event sourcing/eventual consistency - with trade-offs and binding to UX flows.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Skill: Data Model
|
|
7
|
+
|
|
8
|
+
## Goal
|
|
9
|
+
Support product scenarios and prepare the base for growth.
|
|
10
|
+
|
|
11
|
+
## Exit
|
|
12
|
+
## 1) Entities
|
|
13
|
+
For each entity:
|
|
14
|
+
- fields (type/required)
|
|
15
|
+
- restrictions (unique/not null/range)
|
|
16
|
+
- communications
|
|
17
|
+
- indexes for UX queries
|
|
18
|
+
|
|
19
|
+
## 2) Data patterns (conscious choice)
|
|
20
|
+
- Default normalization
|
|
21
|
+
- Denormalization for read perf (if really needed)
|
|
22
|
+
- Cache layers (Redis) - if there are hot reads
|
|
23
|
+
- Eventual consistency - if there are distributed parts
|
|
24
|
+
- Event sourcing - only if you need a strict audit/replay
|
|
25
|
+
|
|
26
|
+
For each selected pattern: Pros/Cons/Alternatives (ADR if necessary).
|
|
27
|
+
|
|
28
|
+
## 3) Migrations strategy
|
|
29
|
+
- versioning
|
|
30
|
+
- reversibility (if necessary)
|
|
31
|
+
- Seeds/fixtures
|
|
32
|
+
|
|
33
|
+
## 4) Transaction boundaries
|
|
34
|
+
- where transactions are needed
|
|
35
|
+
- competition and integrity (constraints/locking)
|
|
36
|
+
|
|
37
|
+
## 5) Query patterns
|
|
38
|
+
- typical requests for screens
|
|
39
|
+
- risks of N+1 / heavy joins
|
|
40
|
+
- optimizations: indexes, prefetch, denormalization (if necessary)
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: dependency_supply_chain_review
|
|
3
|
+
description: Dependency review: minimization, updates, vulnerability audit, licenses, banning of unsafe packages.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
#Skill: Dependency & Supply Chain Review
|
|
7
|
+
|
|
8
|
+
## Check
|
|
9
|
+
- New dependencies are really needed (no unnecessary ones)
|
|
10
|
+
- Versions are not outdated/vulnerable (according to available reports/project audit)
|
|
11
|
+
- Lockfile updated correctly
|
|
12
|
+
- No “questionable” packages for critical functions
|
|
13
|
+
- Licenses are acceptable (if the project requires)
|
|
14
|
+
|
|
15
|
+
## Exit
|
|
16
|
+
- List of suspicious/unnecessary packages
|
|
17
|
+
- Recommendations: delete/replace/fix version
|
|
18
|
+
|
|
19
|
+
## See also
|
|
20
|
+
- Examples and anti-examples: $review_reference_snippets
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: deployment_ci_plan
|
|
3
|
+
description: Deployment and CI plan: environments, configs, secrets, migrations, CI checks (tests/lint/security), release and rollback strategy.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Skill: Deployment & CI Plan
|
|
7
|
+
|
|
8
|
+
## Goal
|
|
9
|
+
Make a reproducible build/test/deploy process.
|
|
10
|
+
|
|
11
|
+
## Add (Operations)
|
|
12
|
+
- Monitoring/alerting (minimum)
|
|
13
|
+
- Backup & recovery (if there is a database)
|
|
14
|
+
- Rollback plan (required)
|
|
15
|
+
|
|
16
|
+
## Inputs
|
|
17
|
+
- Deployment restrictions (Vercel/Docker/AWS/etc)
|
|
18
|
+
- Stack
|
|
19
|
+
- Security requirements (secrets)
|
|
20
|
+
|
|
21
|
+
## Output (structure)
|
|
22
|
+
## 1) Environments
|
|
23
|
+
-local
|
|
24
|
+
- staging (if any)
|
|
25
|
+
- production
|
|
26
|
+
|
|
27
|
+
## 2) Config & Secrets
|
|
28
|
+
- env vars list
|
|
29
|
+
- where we store secrets (secret storage)
|
|
30
|
+
- log policy (do not print secrets)
|
|
31
|
+
|
|
32
|
+
## 3) CI pipeline (minimum)
|
|
33
|
+
- install
|
|
34
|
+
- lint/format (if available)
|
|
35
|
+
- unit tests
|
|
36
|
+
- integration tests
|
|
37
|
+
- (optional) dependency audit
|
|
38
|
+
|
|
39
|
+
## 4) DB migrations (if there is a database)
|
|
40
|
+
- when and how migrations are applied
|
|
41
|
+
- rollback strategy (if needed)
|
|
42
|
+
|
|
43
|
+
## 5) Release strategy
|
|
44
|
+
- versioning
|
|
45
|
+
- feature flags (if needed)
|
|
46
|
+
-rollback plan
|
|
47
|
+
|
|
48
|
+
## DoD link
|
|
49
|
+
- release is not allowed without green CI
|
|
50
|
+
- migrations applied and tested
|
|
51
|
+
- smoke test passed after deployment
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: design_intake
|
|
3
|
+
description: Find and analyze provided design materials (files/links), determine the “source of truth” for the UI and extract verifiable rules (screens, components, tokens, states).
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Skill: Design Intake (collection of design sources)
|
|
7
|
+
|
|
8
|
+
## Goal
|
|
9
|
+
Capture which design artifacts are the source of truth and extract testable rules from them for UX Spec and development.
|
|
10
|
+
|
|
11
|
+
## When to use
|
|
12
|
+
- Design files (PDF/PNG/SVG/FIG, etc.) have been added to the repository
|
|
13
|
+
- The user provided a link to Figma/other layouts
|
|
14
|
+
- Before preparing the UX Spec or before the final UI verification
|
|
15
|
+
|
|
16
|
+
## Inputs
|
|
17
|
+
- Paths to files in the repository (if any)
|
|
18
|
+
- Links (if available, for example Figma)
|
|
19
|
+
- PRD/UX Spec (if already exist)
|
|
20
|
+
|
|
21
|
+
## Search for design artifacts (heuristics)
|
|
22
|
+
Check availability (if the repository is available):
|
|
23
|
+
- Folders: `design/`, `docs/design/`, `assets/design/`, `.figma/`, `ui/`
|
|
24
|
+
- Files: `*.fig`, `*.pdf`, `*.png`, `*.jpg`, `*.jpeg`, `*.svg`
|
|
25
|
+
- Documents: `README.md`, `docs/*` for the presence of the word “Figma” and links
|
|
26
|
+
|
|
27
|
+
## Algorithm
|
|
28
|
+
1) **Collect sources**:
|
|
29
|
+
- list of files/folders (paths)
|
|
30
|
+
- list of links (if given)
|
|
31
|
+
2) **Define the “source of truth”** (Source of Truth):
|
|
32
|
+
- main page/file for MVP screens
|
|
33
|
+
- separate pages/sections for components/tokens (if any)
|
|
34
|
+
3) **Extract the specification**:
|
|
35
|
+
- list of screens and their purpose
|
|
36
|
+
- screen structure (main sections)
|
|
37
|
+
- components and options (primary/secondary, sizes, states)
|
|
38
|
+
- states: loading/empty/error/success (if reflected)
|
|
39
|
+
- key content rules (errors, tips, button texts)
|
|
40
|
+
4) **Gather a Design Reference Map**:
|
|
41
|
+
- Screen → where described (file/page/frame)
|
|
42
|
+
- Component → where described
|
|
43
|
+
5) **Create a “Design Rules Summary”**:
|
|
44
|
+
- 5–20 rules that can be checked (without subjectivity)
|
|
45
|
+
|
|
46
|
+
## Exit (Deliverables)
|
|
47
|
+
###Design Sources
|
|
48
|
+
- Files:
|
|
49
|
+
- Links:
|
|
50
|
+
|
|
51
|
+
###Source of Truth
|
|
52
|
+
- Screens:
|
|
53
|
+
- Components:
|
|
54
|
+
- Tokens/Guidelines:
|
|
55
|
+
|
|
56
|
+
### Design Reference Map
|
|
57
|
+
- Screens:
|
|
58
|
+
- Components:
|
|
59
|
+
|
|
60
|
+
### Design Rules Summary
|
|
61
|
+
- Rule 1:
|
|
62
|
+
- Rule 2:
|
|
63
|
+
...
|
|
64
|
+
|
|
65
|
+
## Response format
|
|
66
|
+
### Summary
|
|
67
|
+
### Deliverables (Design Sources + Reference Map + Rules)
|
|
68
|
+
###Decisions
|
|
69
|
+
###Risks/Blockers
|
|
70
|
+
### Open Questions
|
|
71
|
+
### Next Actions (IDs: UX-xx)
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: design_parity_review
|
|
3
|
+
description: Compare design artifacts with the UX Spec or with the implemented UI. Issue a Design Parity Report with P0/P1/P2 priorities and specific recommendations.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Skill: Design Parity Review (design verification)
|
|
7
|
+
|
|
8
|
+
## Goal
|
|
9
|
+
Check the compliance of the UX Spec and/or implemented UI with the provided design materials and record any discrepancies.
|
|
10
|
+
|
|
11
|
+
## When to use
|
|
12
|
+
- After preparing the UX Spec (Design ↔ UX Spec)
|
|
13
|
+
- After implementing the UI (Design ↔ Implemented UI)
|
|
14
|
+
- Before closing the release increment (as part of the DoD if there is a design)
|
|
15
|
+
|
|
16
|
+
## Inputs
|
|
17
|
+
- Design Reference Map and Rules (from `$design_intake`)
|
|
18
|
+
- UX Spec (if we check the spec)
|
|
19
|
+
- UI implementation (if we check the code):
|
|
20
|
+
- links/routes, how to reproduce states
|
|
21
|
+
- screenshots/videos/Storybook (if available)
|
|
22
|
+
- e2e/visual results (if available)
|
|
23
|
+
|
|
24
|
+
## Check modes
|
|
25
|
+
### Mode A: Design ↔ UX Spec (no code yet)
|
|
26
|
+
Check each screen:
|
|
27
|
+
- composition of sections and their order
|
|
28
|
+
- main actions/CTAs
|
|
29
|
+
- forms: fields, mandatory, validation, error texts
|
|
30
|
+
- states: loading/empty/error/success
|
|
31
|
+
- matching components with inventory/guides
|
|
32
|
+
Output: list of edits to UX Spec + questions/conflicts.
|
|
33
|
+
|
|
34
|
+
### Mode B: Design ↔ Implemented UI (UI has already been implemented)
|
|
35
|
+
Check for each key screen and status:
|
|
36
|
+
- layout/hierarchy (what is located where, what is visible first)
|
|
37
|
+
- availability and options for components (buttons, inputs, tables, modals)
|
|
38
|
+
- texts/labels/placeholders/error messages (if the design specifies them)
|
|
39
|
+
- UI status (loading/empty/error/success)
|
|
40
|
+
- basic a11y (keyboard/focus/labels/ARIA) by `$a11y_baseline`
|
|
41
|
+
|
|
42
|
+
## Classification of discrepancies
|
|
43
|
+
- **P0 (Blocker)**: breaks critical flow, is misleading, violates accessibility, leads to errors/data loss, contradicts PRD.
|
|
44
|
+
- **P1 (Important)**: breaks consistency, degrades UX, but does not block use.
|
|
45
|
+
- **P2 (Nice-to-have)**: cosmetics/polish.
|
|
46
|
+
|
|
47
|
+
## Output: Design Parity Report (required structure)
|
|
48
|
+
### ✅ Matches
|
|
49
|
+
- ...
|
|
50
|
+
|
|
51
|
+
### ⚠️ Discrepancies
|
|
52
|
+
#### P0 (Blockers)
|
|
53
|
+
- [ ] <what's wrong> - Screen/Component: ... - Expected: ... - Actual: ... - Fix: ...
|
|
54
|
+
|
|
55
|
+
#### P1 (Important)
|
|
56
|
+
- [ ] ...
|
|
57
|
+
|
|
58
|
+
#### P2 (Nice-to-have)
|
|
59
|
+
- [ ] ...
|
|
60
|
+
|
|
61
|
+
### Recommendations for correction
|
|
62
|
+
- DEV-xx: ...
|
|
63
|
+
- UX-xx: ...
|
|
64
|
+
|
|
65
|
+
### Conflicts (if any)
|
|
66
|
+
- Conflict: <design vs PRD/architecture> → solution options
|
|
67
|
+
|
|
68
|
+
## Response format
|
|
69
|
+
### Summary
|
|
70
|
+
### Deliverables (Design Parity Report)
|
|
71
|
+
### Findings (P0/P1/P2)
|
|
72
|
+
###Risks/Blockers
|
|
73
|
+
### Next Actions (IDs: UX-xx / DEV-xx)
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: design_systems
|
|
3
|
+
description: Integration of design systems: shadcn/ui, mantine, Wix Design System; compliance with UI inventory/UX spec and common components.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Skill: Design Systems Integration
|
|
7
|
+
|
|
8
|
+
## Goal
|
|
9
|
+
Assemble the UI from ready-made, consistent components and do not “draw a bicycle”.
|
|
10
|
+
|
|
11
|
+
## Rules
|
|
12
|
+
- Prefer shadcn/ui for new projects (if the stack is suitable)
|
|
13
|
+
- Mantine - if chosen by the project/there are reasons
|
|
14
|
+
- Wix Design System - for the Wix ecosystem (if specified)
|
|
15
|
+
- Components must support states from the UX Spec (loading/empty/error/disabled)
|