@soleri/cli 9.3.1 → 9.4.0

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/src/main.ts CHANGED
@@ -21,6 +21,7 @@ import { registerSkills } from './commands/skills.js';
21
21
  import { registerAgent } from './commands/agent.js';
22
22
  import { registerTelegram } from './commands/telegram.js';
23
23
  import { registerStaging } from './commands/staging.js';
24
+ import { registerYolo } from './commands/yolo.js';
24
25
 
25
26
  const require = createRequire(import.meta.url);
26
27
  const { version } = require('../package.json');
@@ -82,4 +83,5 @@ registerSkills(program);
82
83
  registerAgent(program);
83
84
  registerTelegram(program);
84
85
  registerStaging(program);
86
+ registerYolo(program);
85
87
  program.parse();
package/vitest.config.ts CHANGED
@@ -6,5 +6,6 @@ export default defineConfig({
6
6
  testTimeout: 15_000,
7
7
  pool: 'forks',
8
8
  teardownTimeout: 10_000,
9
+ exclude: ['**/node_modules/**', '**/.claude/worktrees/**'],
9
10
  },
10
11
  });
@@ -1,84 +0,0 @@
1
- import { describe, expect, it } from 'vitest';
2
- import { ARCHETYPES } from '../prompts/archetypes.js';
3
- import {
4
- CORE_SKILLS,
5
- SKILL_CATEGORIES,
6
- DOMAIN_OPTIONS,
7
- PRINCIPLE_CATEGORIES,
8
- } from '../prompts/playbook.js';
9
-
10
- const allDomainValues = DOMAIN_OPTIONS.map((d) => d.value);
11
- const allPrincipleValues = PRINCIPLE_CATEGORIES.flatMap((c) => c.options.map((o) => o.value));
12
- const allOptionalSkillValues = SKILL_CATEGORIES.flatMap((c) => c.options.map((o) => o.value));
13
-
14
- describe('Archetypes', () => {
15
- it('should have unique values', () => {
16
- const values = ARCHETYPES.map((a) => a.value);
17
- expect(new Set(values).size).toBe(values.length);
18
- });
19
-
20
- it('should all have tier field', () => {
21
- for (const a of ARCHETYPES) {
22
- expect(a.tier).toMatch(/^(free|premium)$/);
23
- }
24
- });
25
-
26
- it('should have at least 9 archetypes', () => {
27
- expect(ARCHETYPES.length).toBeGreaterThanOrEqual(9);
28
- });
29
-
30
- it('should reference only valid domains', () => {
31
- for (const a of ARCHETYPES) {
32
- for (const d of a.defaults.domains) {
33
- expect(allDomainValues).toContain(d);
34
- }
35
- }
36
- });
37
-
38
- it('should reference only valid principles', () => {
39
- for (const a of ARCHETYPES) {
40
- for (const pr of a.defaults.principles) {
41
- expect(allPrincipleValues).toContain(pr);
42
- }
43
- }
44
- });
45
-
46
- it('should not include core skills in archetype skills', () => {
47
- const coreSet = new Set<string>(CORE_SKILLS);
48
- for (const a of ARCHETYPES) {
49
- for (const s of a.defaults.skills) {
50
- expect(coreSet.has(s)).toBe(false);
51
- }
52
- }
53
- });
54
-
55
- it('should reference only valid optional skills', () => {
56
- for (const a of ARCHETYPES) {
57
- for (const s of a.defaults.skills) {
58
- expect(allOptionalSkillValues).toContain(s);
59
- }
60
- }
61
- });
62
-
63
- it('should include Accessibility Guardian', () => {
64
- expect(ARCHETYPES.find((a) => a.value === 'accessibility-guardian')).toBeDefined();
65
- });
66
-
67
- it('should include Documentation Writer', () => {
68
- expect(ARCHETYPES.find((a) => a.value === 'documentation-writer')).toBeDefined();
69
- });
70
- });
71
-
72
- describe('Core Skills', () => {
73
- it('should include writing-plans and executing-plans', () => {
74
- expect(CORE_SKILLS).toContain('writing-plans');
75
- expect(CORE_SKILLS).toContain('executing-plans');
76
- });
77
-
78
- it('should not appear in optional skill categories', () => {
79
- const coreSet = new Set<string>(CORE_SKILLS);
80
- for (const s of allOptionalSkillValues) {
81
- expect(coreSet.has(s)).toBe(false);
82
- }
83
- });
84
- });
@@ -1,207 +0,0 @@
1
- import { describe, it, expect, beforeEach, afterEach } from 'vitest';
2
- import { mkdirSync, rmSync, existsSync, readFileSync, writeFileSync, readdirSync } from 'node:fs';
3
- import { join } from 'node:path';
4
- import { tmpdir } from 'node:os';
5
- import { previewScaffold, scaffold } from '@soleri/forge/lib';
6
- import type { AgentConfig } from '@soleri/forge/lib';
7
- import { installPack } from '../hook-packs/installer.js';
8
-
9
- describe('create command', { timeout: 30_000 }, () => {
10
- let tempDir: string;
11
-
12
- const testConfig: AgentConfig = {
13
- id: 'test-agent',
14
- name: 'TestAgent',
15
- role: 'A test agent',
16
- description: 'This agent is used for testing the CLI create command.',
17
- domains: ['testing', 'quality'],
18
- principles: ['Test everything', 'Quality first'],
19
- greeting: 'Hello! I am TestAgent, here to help with testing.',
20
- outputDir: '',
21
- };
22
-
23
- beforeEach(() => {
24
- tempDir = join(tmpdir(), `cli-create-test-${Date.now()}`);
25
- mkdirSync(tempDir, { recursive: true });
26
- testConfig.outputDir = tempDir;
27
- });
28
-
29
- afterEach(() => {
30
- rmSync(tempDir, { recursive: true, force: true });
31
- });
32
-
33
- it('should preview scaffold without creating files', () => {
34
- const preview = previewScaffold(testConfig);
35
-
36
- expect(preview.agentDir).toBe(join(tempDir, 'test-agent'));
37
- expect(preview.persona.name).toBe('TestAgent');
38
- expect(preview.domains).toEqual(['testing', 'quality']);
39
- expect(preview.files.length).toBeGreaterThan(10);
40
- expect(existsSync(preview.agentDir)).toBe(false);
41
- });
42
-
43
- it('should scaffold agent successfully', () => {
44
- const result = scaffold(testConfig);
45
-
46
- expect(result.success).toBe(true);
47
- expect(result.agentDir).toBe(join(tempDir, 'test-agent'));
48
- expect(result.filesCreated.length).toBeGreaterThan(10);
49
- expect(existsSync(join(tempDir, 'test-agent', 'package.json'))).toBe(true);
50
- expect(existsSync(join(tempDir, 'test-agent', 'src', 'index.ts'))).toBe(true);
51
- });
52
-
53
- it('should fail if directory already exists', () => {
54
- scaffold(testConfig);
55
- const result = scaffold(testConfig);
56
-
57
- expect(result.success).toBe(false);
58
- expect(result.summary).toContain('already exists');
59
- });
60
-
61
- it('should not create facade files (v5.0 uses runtime factories from @soleri/core)', () => {
62
- scaffold(testConfig);
63
-
64
- // v5.0: facades are created at runtime by createDomainFacades() — no generated files
65
- expect(existsSync(join(tempDir, 'test-agent', 'src', 'facades'))).toBe(false);
66
-
67
- // Entry point should reference createDomainFacades
68
- const entry = readFileSync(join(tempDir, 'test-agent', 'src', 'index.ts'), 'utf-8');
69
- expect(entry).toContain('createDomainFacades');
70
- expect(entry).toContain('"testing"');
71
- expect(entry).toContain('"quality"');
72
- });
73
-
74
- it('should create intelligence data files for each domain', () => {
75
- scaffold(testConfig);
76
-
77
- const testingBundle = JSON.parse(
78
- readFileSync(
79
- join(tempDir, 'test-agent', 'src', 'intelligence', 'data', 'testing.json'),
80
- 'utf-8',
81
- ),
82
- );
83
- expect(testingBundle.domain).toBe('testing');
84
- expect(testingBundle.entries.length).toBeGreaterThanOrEqual(0);
85
- if (testingBundle.entries.length > 0) {
86
- expect(testingBundle.entries[0].id).toBe('testing-seed');
87
- expect(testingBundle.entries[0].tags).toContain('seed');
88
- }
89
- });
90
-
91
- it('should read config from file for non-interactive mode', () => {
92
- const configPath = join(tempDir, 'agent.json');
93
- writeFileSync(configPath, JSON.stringify(testConfig), 'utf-8');
94
-
95
- const raw = JSON.parse(readFileSync(configPath, 'utf-8'));
96
- expect(raw.id).toBe('test-agent');
97
- expect(raw.domains).toEqual(['testing', 'quality']);
98
- });
99
-
100
- // ─── Hook pack integration tests ──────────────────────────────
101
-
102
- it('should create .claude/ directory when hookPacks specified', () => {
103
- const configWithHooks: AgentConfig = {
104
- ...testConfig,
105
- hookPacks: ['typescript-safety'],
106
- };
107
- const result = scaffold(configWithHooks);
108
-
109
- expect(result.success).toBe(true);
110
- expect(existsSync(join(tempDir, 'test-agent', '.claude'))).toBe(true);
111
- });
112
-
113
- it('should install hookify files to agent .claude/ via installPack', () => {
114
- const configWithHooks: AgentConfig = {
115
- ...testConfig,
116
- hookPacks: ['typescript-safety'],
117
- };
118
- const result = scaffold(configWithHooks);
119
- expect(result.success).toBe(true);
120
-
121
- // Simulate what create.ts does: install packs into agent dir
122
- const { installed } = installPack('typescript-safety', { projectDir: result.agentDir });
123
- expect(installed.length).toBeGreaterThan(0);
124
-
125
- // Verify hookify files exist in agent .claude/
126
- const claudeDir = join(result.agentDir, '.claude');
127
- const hookFiles = readdirSync(claudeDir).filter(
128
- (f) => f.startsWith('hookify.') && f.endsWith('.local.md'),
129
- );
130
- expect(hookFiles.length).toBeGreaterThan(0);
131
- expect(hookFiles.some((f) => f.includes('no-any-types'))).toBe(true);
132
- });
133
-
134
- it('should not create .claude/ when hookPacks is empty or undefined', () => {
135
- const result = scaffold(testConfig);
136
-
137
- expect(result.success).toBe(true);
138
- expect(existsSync(join(tempDir, 'test-agent', '.claude'))).toBe(false);
139
- });
140
-
141
- it('should include hook packs in preview when hookPacks specified', () => {
142
- const configWithHooks: AgentConfig = {
143
- ...testConfig,
144
- hookPacks: ['typescript-safety'],
145
- };
146
- const preview = previewScaffold(configWithHooks);
147
-
148
- const hookEntry = preview.files.find((f) => f.path === '.claude/');
149
- expect(hookEntry).toBeDefined();
150
- expect(hookEntry!.description).toContain('typescript-safety');
151
- });
152
-
153
- it('should include Hook Packs section in CLAUDE.md when hookPacks specified', () => {
154
- const configWithHooks: AgentConfig = {
155
- ...testConfig,
156
- hookPacks: ['typescript-safety'],
157
- };
158
- scaffold(configWithHooks);
159
-
160
- const claudeMd = readFileSync(
161
- join(tempDir, 'test-agent', 'src', 'activation', 'claude-md-content.ts'),
162
- 'utf-8',
163
- );
164
- expect(claudeMd).toContain('Hook Packs');
165
- expect(claudeMd).toContain('typescript-safety');
166
- });
167
-
168
- it('should not include Hook Packs section in CLAUDE.md when hookPacks undefined', () => {
169
- scaffold(testConfig);
170
-
171
- const claudeMd = readFileSync(
172
- join(tempDir, 'test-agent', 'src', 'activation', 'claude-md-content.ts'),
173
- 'utf-8',
174
- );
175
- expect(claudeMd).not.toContain('Hook Packs');
176
- });
177
-
178
- it('should include hook copy logic in setup.sh when hookPacks specified', () => {
179
- const configWithHooks: AgentConfig = {
180
- ...testConfig,
181
- hookPacks: ['typescript-safety'],
182
- };
183
- scaffold(configWithHooks);
184
-
185
- const setupSh = readFileSync(join(tempDir, 'test-agent', 'scripts', 'setup.sh'), 'utf-8');
186
- expect(setupSh).toContain('Installing hook packs');
187
- expect(setupSh).toContain('hookify.');
188
- expect(setupSh).toContain('GLOBAL_CLAUDE_DIR');
189
- });
190
-
191
- it('should not include hook copy logic in setup.sh when hookPacks undefined', () => {
192
- scaffold(testConfig);
193
-
194
- const setupSh = readFileSync(join(tempDir, 'test-agent', 'scripts', 'setup.sh'), 'utf-8');
195
- expect(setupSh).not.toContain('Installing hook packs');
196
- });
197
-
198
- it('should mention hook packs in scaffold summary', () => {
199
- const configWithHooks: AgentConfig = {
200
- ...testConfig,
201
- hookPacks: ['typescript-safety', 'a11y'],
202
- };
203
- const result = scaffold(configWithHooks);
204
-
205
- expect(result.summary).toContain('2 hook pack(s) bundled in .claude/');
206
- });
207
- });
@@ -1,343 +0,0 @@
1
- /**
2
- * Pre-built agent archetypes that pre-fill the wizard.
3
- * Each archetype provides sensible defaults for role, description,
4
- * domains, principles, skills, and greeting — so the user can
5
- * scaffold a full agent with minimal typing.
6
- */
7
-
8
- export interface Archetype {
9
- value: string;
10
- label: string;
11
- hint: string;
12
- tier: 'free' | 'premium';
13
- defaults: {
14
- role: string;
15
- description: string;
16
- domains: string[];
17
- principles: string[];
18
- skills: string[];
19
- tone: 'precise' | 'mentor' | 'pragmatic';
20
- greetingTemplate: (name: string) => string;
21
- };
22
- }
23
-
24
- export const ARCHETYPES: Archetype[] = [
25
- {
26
- value: 'code-reviewer',
27
- label: 'Code Reviewer',
28
- hint: 'Catches bugs, enforces patterns, reviews PRs before merge',
29
- tier: 'free',
30
- defaults: {
31
- role: 'Catches bugs, enforces code patterns, and reviews pull requests before merge',
32
- description:
33
- 'This agent reviews code for quality issues, anti-patterns, naming conventions, test coverage gaps, and architectural violations. It provides actionable feedback with concrete fix suggestions.',
34
- domains: ['code-review', 'architecture'],
35
- principles: [
36
- 'Actionable feedback only',
37
- 'Readable over clever',
38
- 'Small PR scope',
39
- 'Respect existing patterns',
40
- ],
41
- skills: ['code-patrol', 'fix-and-learn', 'second-opinion'],
42
- tone: 'mentor',
43
- greetingTemplate: (name) =>
44
- `Hello! I'm ${name}. Drop a PR link or paste code — I'll review it for bugs, patterns, and quality.`,
45
- },
46
- },
47
- {
48
- value: 'security-auditor',
49
- label: 'Security Auditor',
50
- hint: 'OWASP Top 10, dependency scanning, secrets detection',
51
- tier: 'free',
52
- defaults: {
53
- role: 'Identifies vulnerabilities and enforces secure coding practices',
54
- description:
55
- 'This agent scans code for security issues including OWASP Top 10, dependency vulnerabilities, secrets exposure, injection risks, and insecure configurations. It provides remediation guidance with severity ratings.',
56
- domains: ['security', 'code-review'],
57
- principles: [
58
- 'Security first',
59
- 'Fail closed, not open',
60
- 'Zero trust by default',
61
- 'Least privilege always',
62
- 'Defense in depth',
63
- ],
64
- skills: ['code-patrol', 'fix-and-learn', 'vault-navigator'],
65
- tone: 'precise',
66
- greetingTemplate: (name) =>
67
- `Hello! I'm ${name}. I help identify vulnerabilities and enforce secure coding practices across your codebase.`,
68
- },
69
- },
70
- {
71
- value: 'api-architect',
72
- label: 'API Architect',
73
- hint: 'REST/GraphQL design, contract validation, versioning',
74
- tier: 'free',
75
- defaults: {
76
- role: 'Designs and validates APIs for consistency, usability, and correctness',
77
- description:
78
- 'This agent reviews API designs for RESTful conventions, GraphQL best practices, versioning strategy, error handling, pagination patterns, and contract consistency. It catches breaking changes before they ship.',
79
- domains: ['api-design', 'architecture'],
80
- principles: [
81
- 'Backward compatibility by default',
82
- 'Consumer-driven contracts',
83
- 'Design for the consumer, not the implementer',
84
- 'Every migration must be reversible',
85
- ],
86
- skills: ['vault-navigator', 'vault-capture', 'second-opinion'],
87
- tone: 'pragmatic',
88
- greetingTemplate: (name) =>
89
- `Hello! I'm ${name}. Share your API design or schema — I'll review it for consistency, usability, and best practices.`,
90
- },
91
- },
92
- {
93
- value: 'test-engineer',
94
- label: 'Test Engineer',
95
- hint: 'Test generation, coverage analysis, TDD workflow',
96
- tier: 'free',
97
- defaults: {
98
- role: 'Generates tests, analyzes coverage, and enforces test-driven development',
99
- description:
100
- 'This agent helps write comprehensive test suites, identifies coverage gaps, suggests edge cases, and guides TDD workflows. It supports unit, integration, and end-to-end testing strategies.',
101
- domains: ['testing', 'code-review'],
102
- principles: [
103
- 'Test everything that can break',
104
- 'Deterministic tests only',
105
- 'Test at boundaries, not internals',
106
- 'Simplicity over cleverness',
107
- ],
108
- skills: ['test-driven-development', 'fix-and-learn', 'code-patrol'],
109
- tone: 'mentor',
110
- greetingTemplate: (name) =>
111
- `Hello! I'm ${name}. Point me at code that needs tests — I'll generate comprehensive suites and identify coverage gaps.`,
112
- },
113
- },
114
- {
115
- value: 'devops-pilot',
116
- label: 'DevOps Pilot',
117
- hint: 'CI/CD pipelines, infrastructure, deployment automation',
118
- tier: 'free',
119
- defaults: {
120
- role: 'Manages CI/CD pipelines, infrastructure, and deployment automation',
121
- description:
122
- 'This agent helps design and maintain CI/CD pipelines, Docker configurations, infrastructure as code, monitoring setup, and deployment strategies. It follows reliability engineering best practices.',
123
- domains: ['devops', 'architecture'],
124
- principles: [
125
- 'Automate everything repeatable',
126
- 'Infrastructure as code',
127
- 'Blast radius awareness',
128
- 'Observability built in from day one',
129
- ],
130
- skills: ['vault-navigator', 'fix-and-learn', 'knowledge-harvest'],
131
- tone: 'pragmatic',
132
- greetingTemplate: (name) =>
133
- `Hello! I'm ${name}. I help with CI/CD, infrastructure, and deployment — describe your setup or issue.`,
134
- },
135
- },
136
- {
137
- value: 'database-architect',
138
- label: 'Database Architect',
139
- hint: 'Schema design, migrations, query optimization',
140
- tier: 'free',
141
- defaults: {
142
- role: 'Designs database schemas, manages migrations, and optimizes queries',
143
- description:
144
- 'This agent reviews database designs for normalization, indexing strategy, migration safety, query performance, and data integrity. It supports SQL and NoSQL patterns.',
145
- domains: ['database', 'performance'],
146
- principles: [
147
- 'Schema evolution over breaking changes',
148
- 'Query performance first',
149
- 'Every migration must be reversible',
150
- 'Convention over configuration',
151
- ],
152
- skills: ['vault-navigator', 'vault-capture', 'knowledge-harvest'],
153
- tone: 'precise',
154
- greetingTemplate: (name) =>
155
- `Hello! I'm ${name}. Share your schema, migration, or query — I'll review it for correctness and performance.`,
156
- },
157
- },
158
- {
159
- value: 'full-stack',
160
- label: 'Full-Stack Assistant',
161
- hint: 'General-purpose dev helper across the entire stack',
162
- tier: 'free',
163
- defaults: {
164
- role: 'A general-purpose development assistant across the full stack',
165
- description:
166
- 'This agent helps with frontend, backend, database, testing, and deployment tasks. It provides balanced guidance across the entire stack without deep specialization in any single area.',
167
- domains: ['code-review', 'testing', 'architecture'],
168
- principles: [
169
- 'Simplicity over cleverness',
170
- 'Progressive enhancement',
171
- 'Test everything that can break',
172
- 'Respect existing patterns',
173
- ],
174
- skills: ['test-driven-development', 'code-patrol', 'fix-and-learn', 'vault-navigator'],
175
- tone: 'mentor',
176
- greetingTemplate: (name) =>
177
- `Hello! I'm ${name}. I help across the full stack — frontend, backend, testing, deployment. What are you working on?`,
178
- },
179
- },
180
- {
181
- value: 'accessibility-guardian',
182
- label: 'Accessibility Guardian',
183
- hint: 'WCAG compliance, semantic HTML, keyboard navigation audits',
184
- tier: 'free',
185
- defaults: {
186
- role: 'Audits code for WCAG compliance and accessibility best practices',
187
- description:
188
- 'This agent reviews components and pages for accessibility issues including WCAG 2.1 violations, missing ARIA labels, keyboard navigation gaps, color contrast failures, and semantic HTML problems. It provides fix suggestions with severity ratings.',
189
- domains: ['accessibility', 'code-review'],
190
- principles: [
191
- 'WCAG compliance is non-negotiable',
192
- 'Semantic HTML before ARIA',
193
- 'Keyboard navigation for every interaction',
194
- 'Actionable feedback only',
195
- ],
196
- skills: ['code-patrol', 'second-opinion'],
197
- tone: 'precise',
198
- greetingTemplate: (name) =>
199
- `Hello! I'm ${name}. I audit your code for accessibility — WCAG compliance, keyboard navigation, screen reader support, and more.`,
200
- },
201
- },
202
- {
203
- value: 'documentation-writer',
204
- label: 'Documentation Writer',
205
- hint: 'Technical docs, API references, example-driven guides',
206
- tier: 'free',
207
- defaults: {
208
- role: 'Creates and maintains clear, example-driven technical documentation',
209
- description:
210
- 'This agent helps write and maintain technical documentation including API references, getting-started guides, architecture docs, and changelogs. It follows docs-as-code practices and ensures every concept has a working example.',
211
- domains: ['documentation', 'developer-experience'],
212
- principles: [
213
- 'Clarity over completeness',
214
- 'Every concept needs an example',
215
- 'Docs rot faster than code — keep current',
216
- 'Design for the consumer, not the implementer',
217
- ],
218
- skills: ['knowledge-harvest', 'vault-navigator'],
219
- tone: 'mentor',
220
- greetingTemplate: (name) =>
221
- `Hello! I'm ${name}. I help write and maintain clear, example-driven documentation. What needs documenting?`,
222
- },
223
- },
224
-
225
- // ─── Premium Archetypes ──────────────────────────────────────────
226
- {
227
- value: 'design-system-architect',
228
- label: 'Design System Architect',
229
- hint: 'Tokens, component APIs, accessibility, atomic design hierarchy',
230
- tier: 'premium',
231
- defaults: {
232
- role: 'Designs and enforces design systems with semantic tokens, component APIs, and accessibility baselines',
233
- description:
234
- 'This agent architects design systems end-to-end: semantic token hierarchies, component variant APIs, atomic design classification, spacing and typography scales, color contrast enforcement, and cross-platform consistency. It bridges design and engineering with a token-first methodology.',
235
- domains: ['architecture', 'accessibility', 'code-review', 'design-tokens', 'frontend'],
236
- principles: [
237
- 'Semantic tokens over primitives',
238
- 'Component variant enum over boolean props',
239
- 'Atomic design classification for component hierarchy',
240
- 'Token enforcement: blocked then forbidden then preferred',
241
- 'Respect existing design system patterns',
242
- 'Every component needs accessibility baseline',
243
- ],
244
- skills: ['code-patrol', 'vault-navigator', 'vault-capture', 'knowledge-harvest'],
245
- tone: 'precise',
246
- greetingTemplate: (name) =>
247
- `Hello! I'm ${name}. I architect design systems — tokens, component APIs, accessibility, and cross-platform consistency. Show me your system or describe what you need.`,
248
- },
249
- },
250
- {
251
- value: 'frontend-craftsman',
252
- label: 'Frontend Craftsman',
253
- hint: 'Stack-aware implementation, UX patterns, performance budgets, accessibility',
254
- tier: 'premium',
255
- defaults: {
256
- role: 'Builds production-grade frontends with stack-specific expertise, UX-informed structure, and performance discipline',
257
- description:
258
- 'This agent combines deep stack knowledge (React, Next.js, Vue, Svelte, Flutter, SwiftUI) with UX design principles, performance budgets, and accessibility-first development. It provides implementation guidance tailored to your specific framework and UI patterns.',
259
- domains: ['code-review', 'testing', 'performance', 'accessibility', 'frontend'],
260
- principles: [
261
- 'Stack-aware implementation over generic advice',
262
- 'UX patterns inform code structure',
263
- 'Performance budget before feature scope',
264
- 'Accessible by default, not bolted on after',
265
- 'Convention over configuration',
266
- ],
267
- skills: ['test-driven-development', 'code-patrol', 'fix-and-learn', 'vault-navigator'],
268
- tone: 'mentor',
269
- greetingTemplate: (name) =>
270
- `Hello! I'm ${name}. I build production-grade frontends with stack-specific expertise, performance discipline, and accessibility built in. What are you working on?`,
271
- },
272
- },
273
- {
274
- value: 'ux-intelligence',
275
- label: 'UX Intelligence Agent',
276
- hint: 'User behavior, conversion optimization, inclusive design, ethical patterns',
277
- tier: 'premium',
278
- defaults: {
279
- role: 'Applies user behavior research to design decisions for conversion, accessibility, and ethical UX',
280
- description:
281
- 'This agent brings UX research intelligence to every design decision: onboarding flows, form optimization, navigation patterns, data entry, search UX, touch targets, animation, performance perception, and AI interaction patterns. It measures conversion impact and ensures inclusive, ethical design.',
282
- domains: ['accessibility', 'performance', 'testing', 'frontend', 'ux-design'],
283
- principles: [
284
- 'User behavior drives design decisions',
285
- 'Accessibility is not a feature, it is a baseline',
286
- 'Measure conversion impact of every UX change',
287
- 'Progressive disclosure over information overload',
288
- 'Design for the consumer, not the implementer',
289
- ],
290
- skills: ['vault-navigator', 'vault-capture', 'second-opinion', 'knowledge-harvest'],
291
- tone: 'mentor',
292
- greetingTemplate: (name) =>
293
- `Hello! I'm ${name}. I help make UX decisions backed by user behavior research — onboarding, forms, navigation, accessibility, and conversion optimization.`,
294
- },
295
- },
296
- {
297
- value: 'knowledge-curator',
298
- label: 'Knowledge Curator',
299
- hint: 'Vault lifecycle, cross-project patterns, domain vocabulary, knowledge architecture',
300
- tier: 'premium',
301
- defaults: {
302
- role: 'Manages knowledge capture, curation, and cross-project pattern extraction for organizational learning',
303
- description:
304
- 'This agent manages the full knowledge lifecycle: capturing patterns at the moment of discovery, curating vault entries for quality and consistency, extracting cross-project patterns, maintaining domain vocabulary, and ensuring knowledge is searchable and actionable.',
305
- domains: ['documentation', 'architecture', 'code-review', 'knowledge-management'],
306
- principles: [
307
- 'Knowledge-gather before execute, always',
308
- 'Vault is the single source of truth',
309
- 'Capture lessons at the moment of discovery',
310
- 'Cross-project patterns beat project-local fixes',
311
- 'Domain vocabulary must be explicit and extensible',
312
- ],
313
- skills: ['vault-navigator', 'vault-capture', 'knowledge-harvest', 'brain-debrief'],
314
- tone: 'precise',
315
- greetingTemplate: (name) =>
316
- `Hello! I'm ${name}. I manage knowledge — capturing patterns, curating quality, and extracting insights across projects. What knowledge needs attention?`,
317
- },
318
- },
319
- {
320
- value: 'architecture-sentinel',
321
- label: 'Architecture Sentinel',
322
- hint: 'Governance gates, protocol enforcement, reversible migrations, graceful degradation',
323
- tier: 'premium',
324
- defaults: {
325
- role: 'Enforces architectural governance with checkpoint gates, protocol enforcement, and data-driven decision making',
326
- description:
327
- 'This agent guards architectural integrity through two-gate approval (plan then execute), checkpoint-based protocol enforcement, data-driven architecture decisions, reversible migration strategies, and graceful degradation patterns. It ensures systems fail closed and degrade gracefully.',
328
- domains: ['architecture', 'security', 'code-review', 'testing', 'governance'],
329
- principles: [
330
- 'Two-gate approval: plan then execute, never skip',
331
- 'Protocol enforcement via checkpoint gates',
332
- 'Data-driven architecture: logic in config, not code',
333
- 'Every migration must be reversible',
334
- 'Fail closed, not open',
335
- 'Graceful degradation over hard failures',
336
- ],
337
- skills: ['code-patrol', 'vault-navigator', 'second-opinion', 'knowledge-harvest'],
338
- tone: 'precise',
339
- greetingTemplate: (name) =>
340
- `Hello! I'm ${name}. I enforce architectural governance — approval gates, protocol checkpoints, reversible migrations, and graceful degradation. What needs review?`,
341
- },
342
- },
343
- ];