arkaos 5.3.0 → 5.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/README.md +2 -2
- package/THE-ARKAOS-GUIDE.md +1 -1
- package/VERSION +1 -1
- package/arka/SKILL.md +1 -1
- package/config/skills-provenance.yaml +10 -0
- package/departments/brand/skills/colors/SKILL.md +3 -1
- package/departments/brand/skills/design-dna/SKILL.md +191 -0
- package/departments/brand/skills/design-dna/references/design-dna.LICENSE +21 -0
- package/departments/brand/skills/design-dna/references/generation-guide.md +209 -0
- package/departments/brand/skills/design-dna/references/schema.md +366 -0
- package/departments/brand/skills/design-system/SKILL.md +12 -3
- package/harness/codex/AGENTS.md +1 -1
- package/harness/copilot/copilot-instructions.md +1 -1
- package/harness/cursor/rules/arkaos.mdc +2 -2
- package/harness/gemini/GEMINI.md +1 -1
- package/harness/opencode/AGENTS.md +1 -1
- package/harness/opencode/agents/arka-architect-gabriel.md +1 -1
- package/harness/opencode/agents/arka-brand-director-valentina.md +1 -1
- package/harness/opencode/agents/arka-cfo-helena.md +1 -1
- package/harness/opencode/agents/arka-chief-of-staff-afonso.md +1 -1
- package/harness/opencode/agents/arka-community-strategist-beatriz.md +1 -1
- package/harness/opencode/agents/arka-content-strategist-rafael.md +1 -1
- package/harness/opencode/agents/arka-conversion-strategist-ines.md +1 -1
- package/harness/opencode/agents/arka-coo-sofia.md +1 -1
- package/harness/opencode/agents/arka-copy-director-eduardo.md +1 -1
- package/harness/opencode/agents/arka-cqo-marta.md +1 -1
- package/harness/opencode/agents/arka-cto-marco.md +1 -1
- package/harness/opencode/agents/arka-design-ops-lead-iris.md +1 -1
- package/harness/opencode/agents/arka-ecom-director-ricardo.md +1 -1
- package/harness/opencode/agents/arka-knowledge-director-clara.md +1 -1
- package/harness/opencode/agents/arka-leadership-director-rodrigo.md +1 -1
- package/harness/opencode/agents/arka-marketing-director-luna.md +1 -1
- package/harness/opencode/agents/arka-ops-lead-daniel.md +1 -1
- package/harness/opencode/agents/arka-pm-director-carolina.md +1 -1
- package/harness/opencode/agents/arka-revops-lead-vicente.md +1 -1
- package/harness/opencode/agents/arka-saas-strategist-tiago.md +1 -1
- package/harness/opencode/agents/arka-sales-director-miguel.md +1 -1
- package/harness/opencode/agents/arka-strategy-director-tomas.md +1 -1
- package/harness/opencode/agents/arka-tech-director-francisca.md +1 -1
- package/harness/opencode/agents/arka-tech-lead-paulo.md +1 -1
- package/harness/opencode/agents/arka-video-producer-simao.md +1 -1
- package/harness/zed/.rules +1 -1
- package/knowledge/commands-registry.json +1 -1
- package/knowledge/skills-manifest.json +16 -1
- package/package.json +1 -1
- package/pyproject.toml +1 -1
- package/scripts/skills_catalog_gen.py +5 -5
|
@@ -0,0 +1,366 @@
|
|
|
1
|
+
# Design DNA Schema
|
|
2
|
+
|
|
3
|
+
Three-dimensional design profile:
|
|
4
|
+
- **design_system** — measurable tokens
|
|
5
|
+
- **design_style** — qualitative perception
|
|
6
|
+
- **visual_effects** — special rendering such as Canvas, WebGL, 3D, particles, shaders, scroll effects, cursor effects, SVG animation, and glassmorphism
|
|
7
|
+
|
|
8
|
+
Every field below must appear in the final JSON output.
|
|
9
|
+
|
|
10
|
+
## Top-Level Structure
|
|
11
|
+
|
|
12
|
+
### `meta`
|
|
13
|
+
- `name`
|
|
14
|
+
- `description`
|
|
15
|
+
- `source_references`
|
|
16
|
+
- `created_at`
|
|
17
|
+
|
|
18
|
+
### `design_system`
|
|
19
|
+
The structural and measurable layer.
|
|
20
|
+
|
|
21
|
+
#### `design_system.color`
|
|
22
|
+
- `palette_type`
|
|
23
|
+
- `primary.hex`
|
|
24
|
+
- `primary.role`
|
|
25
|
+
- `secondary.hex`
|
|
26
|
+
- `secondary.role`
|
|
27
|
+
- `accent.hex`
|
|
28
|
+
- `accent.role`
|
|
29
|
+
- `neutral.scale`
|
|
30
|
+
- `neutral.usage`
|
|
31
|
+
- `semantic.success`
|
|
32
|
+
- `semantic.warning`
|
|
33
|
+
- `semantic.error`
|
|
34
|
+
- `semantic.info`
|
|
35
|
+
- `surface.background`
|
|
36
|
+
- `surface.card`
|
|
37
|
+
- `surface.elevated`
|
|
38
|
+
- `contrast_strategy`
|
|
39
|
+
|
|
40
|
+
#### `design_system.typography`
|
|
41
|
+
- `type_scale.display.size`
|
|
42
|
+
- `type_scale.display.weight`
|
|
43
|
+
- `type_scale.display.line_height`
|
|
44
|
+
- `type_scale.display.tracking`
|
|
45
|
+
- `type_scale.heading_1.size`
|
|
46
|
+
- `type_scale.heading_1.weight`
|
|
47
|
+
- `type_scale.heading_1.line_height`
|
|
48
|
+
- `type_scale.heading_1.tracking`
|
|
49
|
+
- `type_scale.heading_2.size`
|
|
50
|
+
- `type_scale.heading_2.weight`
|
|
51
|
+
- `type_scale.heading_2.line_height`
|
|
52
|
+
- `type_scale.heading_2.tracking`
|
|
53
|
+
- `type_scale.heading_3.size`
|
|
54
|
+
- `type_scale.heading_3.weight`
|
|
55
|
+
- `type_scale.heading_3.line_height`
|
|
56
|
+
- `type_scale.heading_3.tracking`
|
|
57
|
+
- `type_scale.body.size`
|
|
58
|
+
- `type_scale.body.weight`
|
|
59
|
+
- `type_scale.body.line_height`
|
|
60
|
+
- `type_scale.body.tracking`
|
|
61
|
+
- `type_scale.body_small.size`
|
|
62
|
+
- `type_scale.body_small.weight`
|
|
63
|
+
- `type_scale.body_small.line_height`
|
|
64
|
+
- `type_scale.body_small.tracking`
|
|
65
|
+
- `type_scale.caption.size`
|
|
66
|
+
- `type_scale.caption.weight`
|
|
67
|
+
- `type_scale.caption.line_height`
|
|
68
|
+
- `type_scale.caption.tracking`
|
|
69
|
+
- `type_scale.overline.size`
|
|
70
|
+
- `type_scale.overline.weight`
|
|
71
|
+
- `type_scale.overline.line_height`
|
|
72
|
+
- `type_scale.overline.tracking`
|
|
73
|
+
- `font_families.heading`
|
|
74
|
+
- `font_families.body`
|
|
75
|
+
- `font_families.mono`
|
|
76
|
+
- `font_style_notes`
|
|
77
|
+
|
|
78
|
+
#### `design_system.spacing`
|
|
79
|
+
- `base_unit`
|
|
80
|
+
- `scale`
|
|
81
|
+
- `content_density`
|
|
82
|
+
- `section_rhythm`
|
|
83
|
+
|
|
84
|
+
#### `design_system.layout`
|
|
85
|
+
- `grid_system`
|
|
86
|
+
- `max_content_width`
|
|
87
|
+
- `columns`
|
|
88
|
+
- `gutter`
|
|
89
|
+
- `breakpoints`
|
|
90
|
+
- `alignment_tendency`
|
|
91
|
+
|
|
92
|
+
#### `design_system.shape`
|
|
93
|
+
- `border_radius.small`
|
|
94
|
+
- `border_radius.medium`
|
|
95
|
+
- `border_radius.large`
|
|
96
|
+
- `border_radius.pill`
|
|
97
|
+
- `border_usage`
|
|
98
|
+
- `divider_style`
|
|
99
|
+
|
|
100
|
+
#### `design_system.elevation`
|
|
101
|
+
- `shadow_style`
|
|
102
|
+
- `levels.low`
|
|
103
|
+
- `levels.medium`
|
|
104
|
+
- `levels.high`
|
|
105
|
+
- `depth_cues`
|
|
106
|
+
|
|
107
|
+
#### `design_system.iconography`
|
|
108
|
+
- `style`
|
|
109
|
+
- `stroke_weight`
|
|
110
|
+
- `size_scale`
|
|
111
|
+
- `preferred_set`
|
|
112
|
+
|
|
113
|
+
#### `design_system.motion`
|
|
114
|
+
- `easing`
|
|
115
|
+
- `duration_scale.micro`
|
|
116
|
+
- `duration_scale.normal`
|
|
117
|
+
- `duration_scale.macro`
|
|
118
|
+
- `entrance_pattern`
|
|
119
|
+
- `exit_pattern`
|
|
120
|
+
- `philosophy`
|
|
121
|
+
|
|
122
|
+
#### `design_system.components`
|
|
123
|
+
- `button_style`
|
|
124
|
+
- `input_style`
|
|
125
|
+
- `card_style`
|
|
126
|
+
- `navigation_pattern`
|
|
127
|
+
- `modal_style`
|
|
128
|
+
- `list_style`
|
|
129
|
+
- `component_notes`
|
|
130
|
+
|
|
131
|
+
### `design_style`
|
|
132
|
+
The qualitative and perceptual layer.
|
|
133
|
+
|
|
134
|
+
#### `design_style.aesthetic`
|
|
135
|
+
- `mood`
|
|
136
|
+
- `visual_metaphor`
|
|
137
|
+
- `era_influence`
|
|
138
|
+
- `genre`
|
|
139
|
+
- `personality_traits`
|
|
140
|
+
- `adjectives`
|
|
141
|
+
|
|
142
|
+
#### `design_style.visual_language`
|
|
143
|
+
- `complexity`
|
|
144
|
+
- `ornamentation`
|
|
145
|
+
- `whitespace_usage`
|
|
146
|
+
- `visual_weight_distribution`
|
|
147
|
+
- `focal_strategy`
|
|
148
|
+
- `contrast_level`
|
|
149
|
+
- `texture_usage`
|
|
150
|
+
|
|
151
|
+
#### `design_style.composition`
|
|
152
|
+
- `hierarchy_method`
|
|
153
|
+
- `balance_type`
|
|
154
|
+
- `flow_direction`
|
|
155
|
+
- `grouping_strategy`
|
|
156
|
+
- `negative_space_role`
|
|
157
|
+
|
|
158
|
+
#### `design_style.imagery`
|
|
159
|
+
- `photo_treatment`
|
|
160
|
+
- `illustration_style`
|
|
161
|
+
- `graphic_elements`
|
|
162
|
+
- `pattern_usage`
|
|
163
|
+
- `image_shape`
|
|
164
|
+
|
|
165
|
+
#### `design_style.interaction_feel`
|
|
166
|
+
- `feedback_style`
|
|
167
|
+
- `hover_behavior`
|
|
168
|
+
- `transition_personality`
|
|
169
|
+
- `loading_style`
|
|
170
|
+
- `microinteraction_density`
|
|
171
|
+
|
|
172
|
+
#### `design_style.brand_voice_in_ui`
|
|
173
|
+
- `tone`
|
|
174
|
+
- `formality`
|
|
175
|
+
- `cta_style`
|
|
176
|
+
- `empty_state_approach`
|
|
177
|
+
- `error_tone`
|
|
178
|
+
|
|
179
|
+
### `visual_effects`
|
|
180
|
+
The special rendering and advanced visual behavior layer.
|
|
181
|
+
|
|
182
|
+
#### `visual_effects.overview`
|
|
183
|
+
- `effect_intensity`
|
|
184
|
+
- `performance_tier`
|
|
185
|
+
- `fallback_strategy`
|
|
186
|
+
- `primary_technology`
|
|
187
|
+
|
|
188
|
+
#### `visual_effects.background_effects`
|
|
189
|
+
- `type`
|
|
190
|
+
- `description`
|
|
191
|
+
- `technology`
|
|
192
|
+
- `params.color_palette`
|
|
193
|
+
- `params.speed`
|
|
194
|
+
- `params.density`
|
|
195
|
+
- `params.opacity`
|
|
196
|
+
- `params.blend_mode`
|
|
197
|
+
|
|
198
|
+
#### `visual_effects.particle_systems`
|
|
199
|
+
- `enabled`
|
|
200
|
+
- `type`
|
|
201
|
+
- `description`
|
|
202
|
+
- `technology`
|
|
203
|
+
- `params.count`
|
|
204
|
+
- `params.shape`
|
|
205
|
+
- `params.size_range`
|
|
206
|
+
- `params.movement_pattern`
|
|
207
|
+
- `params.color_behavior`
|
|
208
|
+
- `params.interaction`
|
|
209
|
+
- `params.spawn_area`
|
|
210
|
+
|
|
211
|
+
#### `visual_effects.3d_elements`
|
|
212
|
+
- `enabled`
|
|
213
|
+
- `type`
|
|
214
|
+
- `description`
|
|
215
|
+
- `technology`
|
|
216
|
+
- `params.renderer`
|
|
217
|
+
- `params.lighting`
|
|
218
|
+
- `params.camera`
|
|
219
|
+
- `params.materials`
|
|
220
|
+
- `params.geometry`
|
|
221
|
+
- `params.post_processing`
|
|
222
|
+
- `params.interaction_model`
|
|
223
|
+
|
|
224
|
+
#### `visual_effects.shader_effects`
|
|
225
|
+
- `enabled`
|
|
226
|
+
- `type`
|
|
227
|
+
- `description`
|
|
228
|
+
- `technology`
|
|
229
|
+
- `params.uniforms`
|
|
230
|
+
- `params.vertex_manipulation`
|
|
231
|
+
- `params.fragment_output`
|
|
232
|
+
- `params.noise_type`
|
|
233
|
+
- `params.distortion`
|
|
234
|
+
|
|
235
|
+
#### `visual_effects.scroll_effects.parallax`
|
|
236
|
+
- `enabled`
|
|
237
|
+
- `layers`
|
|
238
|
+
- `depth_range`
|
|
239
|
+
- `speed_curve`
|
|
240
|
+
|
|
241
|
+
#### `visual_effects.scroll_effects.scroll_triggered_animations`
|
|
242
|
+
- `enabled`
|
|
243
|
+
- `trigger_points`
|
|
244
|
+
- `animation_type`
|
|
245
|
+
- `scrub_behavior`
|
|
246
|
+
|
|
247
|
+
#### `visual_effects.scroll_effects.scroll_morphing`
|
|
248
|
+
- `enabled`
|
|
249
|
+
- `description`
|
|
250
|
+
|
|
251
|
+
#### `visual_effects.text_effects`
|
|
252
|
+
- `type`
|
|
253
|
+
- `description`
|
|
254
|
+
- `technology`
|
|
255
|
+
- `params.split_strategy`
|
|
256
|
+
- `params.animation_per_unit`
|
|
257
|
+
- `params.stagger`
|
|
258
|
+
- `params.effect_style`
|
|
259
|
+
|
|
260
|
+
#### `visual_effects.cursor_effects`
|
|
261
|
+
- `enabled`
|
|
262
|
+
- `type`
|
|
263
|
+
- `description`
|
|
264
|
+
- `params.shape`
|
|
265
|
+
- `params.size`
|
|
266
|
+
- `params.blend_mode`
|
|
267
|
+
- `params.trail`
|
|
268
|
+
- `params.interaction_zone`
|
|
269
|
+
|
|
270
|
+
#### `visual_effects.image_effects`
|
|
271
|
+
- `type`
|
|
272
|
+
- `description`
|
|
273
|
+
- `technology`
|
|
274
|
+
- `params.filter_pipeline`
|
|
275
|
+
- `params.hover_transform`
|
|
276
|
+
- `params.reveal_animation`
|
|
277
|
+
- `params.distortion_type`
|
|
278
|
+
|
|
279
|
+
#### `visual_effects.glassmorphism_neumorphism`
|
|
280
|
+
- `enabled`
|
|
281
|
+
- `style`
|
|
282
|
+
- `params.blur_radius`
|
|
283
|
+
- `params.transparency`
|
|
284
|
+
- `params.border_treatment`
|
|
285
|
+
- `params.shadow_type`
|
|
286
|
+
- `params.light_source_angle`
|
|
287
|
+
|
|
288
|
+
#### `visual_effects.canvas_drawings`
|
|
289
|
+
- `enabled`
|
|
290
|
+
- `type`
|
|
291
|
+
- `description`
|
|
292
|
+
- `technology`
|
|
293
|
+
- `params.draw_method`
|
|
294
|
+
- `params.animation_loop`
|
|
295
|
+
- `params.color_scheme`
|
|
296
|
+
- `params.responsiveness`
|
|
297
|
+
- `params.interaction`
|
|
298
|
+
|
|
299
|
+
#### `visual_effects.svg_animations`
|
|
300
|
+
- `enabled`
|
|
301
|
+
- `type`
|
|
302
|
+
- `description`
|
|
303
|
+
- `params.animation_method`
|
|
304
|
+
- `params.path_morphing`
|
|
305
|
+
- `params.stroke_animation`
|
|
306
|
+
- `params.filter_effects`
|
|
307
|
+
|
|
308
|
+
#### `visual_effects.composite_notes`
|
|
309
|
+
- Free-text notes for layered effects, implementation ambiguity, performance trade-offs, or screenshot-only observations
|
|
310
|
+
|
|
311
|
+
## Field Guidance
|
|
312
|
+
|
|
313
|
+
### `design_system` (Dimension 1: Structural / Measurable)
|
|
314
|
+
Concrete, token-level values. Extract exact values where visible; estimate from visual inspection otherwise.
|
|
315
|
+
|
|
316
|
+
- **`color.palette_type`**: "monochromatic", "complementary", "analogous", "triadic", "split-complementary"
|
|
317
|
+
- **`color.contrast_strategy`**: How text/background contrast is managed — "high contrast", "subtle layers", "dark-on-light dominant"
|
|
318
|
+
- **`typography.font_style_notes`**: e.g. "geometric sans with humanist touches"
|
|
319
|
+
- **`spacing.content_density`**: "compact", "comfortable", "spacious"
|
|
320
|
+
- **`spacing.section_rhythm`**: How vertical spacing varies between sections
|
|
321
|
+
- **`layout.alignment_tendency`**: "strict grid", "centered", "asymmetric", "mixed"
|
|
322
|
+
- **`shape.border_usage`**: "none", "subtle 1px", "bold borders", "only on inputs"
|
|
323
|
+
- **`elevation.shadow_style`**: "none", "soft diffused", "hard drop", "layered"
|
|
324
|
+
- **`elevation.depth_cues`**: "shadows", "overlapping layers", "blur/glass", "color intensity"
|
|
325
|
+
- **`motion.philosophy`**: "minimal functional", "playful bouncy", "cinematic", "none"
|
|
326
|
+
- **`components`**: Describe observed patterns — e.g. "ghost buttons with thick borders, rounded inputs with inner shadow"
|
|
327
|
+
|
|
328
|
+
### `design_style` (Dimension 2: Qualitative / Perceptual)
|
|
329
|
+
Subjective assessments. Use descriptive language.
|
|
330
|
+
|
|
331
|
+
- **`aesthetic.mood`**: Array of 3–5 mood words, e.g. ["calm", "professional", "warm"]
|
|
332
|
+
- **`aesthetic.genre`**: e.g. "corporate SaaS", "indie creative", "luxury editorial", "neo-brutalist"
|
|
333
|
+
- **`aesthetic.personality_traits`**: As if the design were a person, e.g. ["confident", "approachable", "meticulous"]
|
|
334
|
+
- **`visual_language.complexity`**: "minimal", "moderate", "rich", "maximal"
|
|
335
|
+
- **`visual_language.ornamentation`**: "none", "subtle accents", "decorative", "heavily ornamented"
|
|
336
|
+
- **`visual_language.focal_strategy`**: "single hero element", "distributed interest", "progressive reveal"
|
|
337
|
+
- **`composition.hierarchy_method`**: "scale contrast", "color weight", "spatial isolation", "typographic hierarchy"
|
|
338
|
+
- **`composition.balance_type`**: "symmetric", "asymmetric", "radial", "mosaic"
|
|
339
|
+
- **`interaction_feel.transition_personality`**: "snappy", "smooth glide", "bouncy elastic", "fade-subtle"
|
|
340
|
+
- **`brand_voice_in_ui.cta_style`**: "direct imperative", "friendly invitation", "urgent scarcity", "subtle suggestion"
|
|
341
|
+
|
|
342
|
+
### `visual_effects` (Dimension 3: Special Rendering / Visual Wizardry)
|
|
343
|
+
Effects beyond standard CSS. These often require Canvas, WebGL, SVG animation, shader programs, or JS animation libraries. When not directly observable from static code, describe them from screenshots or video.
|
|
344
|
+
|
|
345
|
+
- **`overview.effect_intensity`**: "none", "subtle-accent", "moderate", "heavy-immersive"
|
|
346
|
+
- **`overview.performance_tier`**: "lightweight" (CSS + simple JS), "medium" (Canvas 2D, SVG anim), "heavy" (WebGL, Three.js, shaders)
|
|
347
|
+
- **`overview.fallback_strategy`**: What happens on low-end devices — "disable effects", "reduce to CSS", "static snapshot"
|
|
348
|
+
- **`overview.primary_technology`**: "CSS only", "Canvas 2D", "WebGL/Three.js", "GSAP", "Lottie", "SVG SMIL", "Pixi.js"
|
|
349
|
+
- **`background_effects.type`**: "gradient-animation", "noise-field", "mesh-gradient", "video-bg", "generative-art", "none"
|
|
350
|
+
- **`particle_systems.type`**: "floating-dots", "confetti", "snow", "fireflies", "connected-nodes", "custom"
|
|
351
|
+
- **`particle_systems.params.interaction`**: "mouse-repel", "mouse-attract", "click-burst", "none"
|
|
352
|
+
- **`3d_elements.type`**: "hero-model", "product-viewer", "scene-bg", "text-extrusion", "abstract-geometry"
|
|
353
|
+
- **`3d_elements.params.post_processing`**: e.g. ["bloom", "FXAA", "depth-of-field", "chromatic-aberration"]
|
|
354
|
+
- **`shader_effects.type`**: "noise-distortion", "wave", "morph", "color-shift", "custom-GLSL"
|
|
355
|
+
- **`shader_effects.params.noise_type`**: "perlin", "simplex", "worley", "fbm"
|
|
356
|
+
- **`scroll_effects.parallax.layers`**: Number of depth layers, e.g. "3"
|
|
357
|
+
- **`scroll_effects.scroll_triggered_animations.animation_type`**: "fade-up", "scale-in", "clip-reveal", "counter", "draw-SVG"
|
|
358
|
+
- **`text_effects.type`**: "split-letter-animate", "typewriter", "glitch", "gradient-fill", "3d-extrude", "none"
|
|
359
|
+
- **`text_effects.params.split_strategy`**: "by-char", "by-word", "by-line"
|
|
360
|
+
- **`cursor_effects.type`**: "custom-cursor", "magnetic-buttons", "spotlight", "trail", "none"
|
|
361
|
+
- **`image_effects.type`**: "hover-distortion", "reveal-clip", "parallax-tilt", "rgb-shift", "none"
|
|
362
|
+
- **`image_effects.params.distortion_type`**: "barrel", "wave", "liquid", "glitch"
|
|
363
|
+
- **`glassmorphism_neumorphism.style`**: "glass", "neumorphic-light", "neumorphic-dark", "frosted-layers", "none"
|
|
364
|
+
- **`canvas_drawings.type`**: "generative-lines", "interactive-blobs", "data-visualization", "pattern-fill", "none"
|
|
365
|
+
- **`svg_animations.type`**: "path-draw", "morph-shapes", "logo-reveal", "decorative-loop", "none"
|
|
366
|
+
- **`composite_notes`**: Free-text description of how multiple effects layer together, performance trade-offs, or effects visible only in screenshots that cannot be fully captured in structured fields
|
|
@@ -6,9 +6,11 @@ description: >
|
|
|
6
6
|
pages), WCAG 2.2 AA conformance report, Storybook CSF3 story stubs, and an
|
|
7
7
|
integration guide. TRIGGER: "design system", "cria o design system", "design
|
|
8
8
|
tokens", "component library", "biblioteca de componentes", "/brand
|
|
9
|
-
design-system". SKIP: only a color palette -> brand/colors;
|
|
10
|
-
|
|
11
|
-
|
|
9
|
+
design-system". SKIP: only a color palette -> brand/colors; reproducing the
|
|
10
|
+
look of an existing reference (screenshot, image, URL) -> brand/design-dna
|
|
11
|
+
(it reverse-engineers a system; this one specifies a new one); implementing
|
|
12
|
+
the components in application code -> dev frontend workflows (this skill
|
|
13
|
+
specifies the system; it does not build the app); reviewing an existing UI
|
|
12
14
|
against brand guidelines -> brand/design-review.
|
|
13
15
|
allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
|
|
14
16
|
metadata:
|
|
@@ -72,6 +74,13 @@ A production design system in 5 deliverables:
|
|
|
72
74
|
|
|
73
75
|
## Study mode (design DNA extraction)
|
|
74
76
|
|
|
77
|
+
> **Entry point:** a request that leads with a reference now routes to
|
|
78
|
+
> `brand/design-dna`, which runs this same protocol with the same
|
|
79
|
+
> guardrails and adds the qualitative and visual-effects dimensions. This
|
|
80
|
+
> section stays because the study still runs *inside* a design-system
|
|
81
|
+
> engagement whenever a reference turns up mid-brief — the protocol below
|
|
82
|
+
> is the one both skills execute.
|
|
83
|
+
|
|
75
84
|
When the operator brings a **reference** — a screenshot or a live URL —
|
|
76
85
|
instead of a brief, run the study protocol in
|
|
77
86
|
`references/design-dna-study.md`: it extracts structural DNA
|
package/harness/codex/AGENTS.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# ArkaOS — The Operating System for AI Agent Teams
|
|
2
2
|
|
|
3
|
-
> v5.
|
|
3
|
+
> v5.4.0 — 89 agents, 17 departments, 334 skills. Generated by `scripts/harness_gen.py`; do not edit.
|
|
4
4
|
|
|
5
5
|
You are operating within ArkaOS. Every request routes through the
|
|
6
6
|
appropriate department squad — never respond as a generic assistant.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# ArkaOS — The Operating System for AI Agent Teams
|
|
2
2
|
|
|
3
|
-
> v5.
|
|
3
|
+
> v5.4.0 — 89 agents, 17 departments, 334 skills. Generated by `scripts/harness_gen.py`; do not edit.
|
|
4
4
|
|
|
5
5
|
You are operating within ArkaOS. Every request routes through the
|
|
6
6
|
appropriate department squad — never respond as a generic assistant.
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: ArkaOS v5.
|
|
2
|
+
description: ArkaOS v5.4.0 agent-team contract
|
|
3
3
|
alwaysApply: true
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# ArkaOS — The Operating System for AI Agent Teams
|
|
7
7
|
|
|
8
|
-
> v5.
|
|
8
|
+
> v5.4.0 — 89 agents, 17 departments, 334 skills. Generated by `scripts/harness_gen.py`; do not edit.
|
|
9
9
|
|
|
10
10
|
You are operating within ArkaOS. Every request routes through the
|
|
11
11
|
appropriate department squad — never respond as a generic assistant.
|
package/harness/gemini/GEMINI.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# ArkaOS — The Operating System for AI Agent Teams
|
|
2
2
|
|
|
3
|
-
> v5.
|
|
3
|
+
> v5.4.0 — 89 agents, 17 departments, 334 skills. Generated by `scripts/harness_gen.py`; do not edit.
|
|
4
4
|
|
|
5
5
|
You are operating within ArkaOS. Every request routes through the
|
|
6
6
|
appropriate department squad — never respond as a generic assistant.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# ArkaOS — The Operating System for AI Agent Teams
|
|
2
2
|
|
|
3
|
-
> v5.
|
|
3
|
+
> v5.4.0 — 89 agents, 17 departments, 334 skills. Generated by `scripts/harness_gen.py`; do not edit.
|
|
4
4
|
|
|
5
5
|
You are operating within ArkaOS. Every request routes through the
|
|
6
6
|
appropriate department squad — never respond as a generic assistant.
|
|
@@ -3,7 +3,7 @@ description: "Software Architect — ArkaOS /dev department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Gabriel, Software Architect of the ArkaOS /dev department (v5.
|
|
6
|
+
You are Gabriel, Software Architect of the ArkaOS /dev department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: system design, system visualization via dev/diagram (architecture + dataflow diagrams delivered as browser artifacts), domain modeling (event storming, bounded contexts), design patterns (GoF, PoEAA), business / domain analysis, API design.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Creative Director — ArkaOS /brand department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Valentina, Creative Director of the ArkaOS /brand department (v5.
|
|
6
|
+
You are Valentina, Creative Director of the ArkaOS /brand department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: brand identity creation, reference-video visual analysis via dev/watch (complete frames + transcript — motion and art direction judged on evidence, never on screenshots), visual design direction, UX/UI strategy, design systems, brand voice & tone.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Chief Financial Officer — ArkaOS /fin department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Helena, Chief Financial Officer of the ArkaOS /fin department (v5.
|
|
6
|
+
You are Helena, Chief Financial Officer of the ArkaOS /fin department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: financial planning & analysis, valuation & investment, unit economics & SaaS metrics, risk management & ERM, fundraising & cap tables, cash flow management.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Chief of Staff & Governance Lead — ArkaOS /org department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Afonso, Chief of Staff & Governance Lead of the ArkaOS /org department (v5.
|
|
6
|
+
You are Afonso, Chief of Staff & Governance Lead of the ArkaOS /org department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: meeting cadence (daily/weekly/quarterly/annual), OKR & CFR orchestration cross-department, decision records & RACI, premortem / blameless postmortem rituals, governance, board & founder-CEO succession, strategic alignment & single-threaded leadership.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Community Strategist — ArkaOS /community department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Beatriz, Community Strategist of the ArkaOS /community department (v5.
|
|
6
|
+
You are Beatriz, Community Strategist of the ArkaOS /community department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: community strategy & design, platform selection (Discord, Telegram, Skool, Circle), member onboarding & retention, monetization (membership, courses, coaching), gamification & engagement, niche communities (betting, AI, vertical).
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Content Strategist — ArkaOS /content department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Rafael, Content Strategist of the ArkaOS /content department (v5.
|
|
6
|
+
You are Rafael, Content Strategist of the ArkaOS /content department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: viral content design, reference-video analysis via dev/watch (frames + timestamped transcript before judging any video), hook writing & packaging, script structure, content operating systems, platform-specific optimization.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Conversion Strategist — ArkaOS /landing department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Ines, Conversion Strategist of the ArkaOS /landing department (v5.
|
|
6
|
+
You are Ines, Conversion Strategist of the ArkaOS /landing department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: sales funnels, landing page optimization, offer creation, copywriting (direct response), launch sequences, affiliate marketing.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Chief Operations Officer — ArkaOS /org department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Sofia, Chief Operations Officer of the ArkaOS /org department (v5.
|
|
6
|
+
You are Sofia, Chief Operations Officer of the ArkaOS /org department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: organizational design, process optimization, cross-department coordination, culture & team health, scaling operations, workflow automation.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Copy & Language Director — ArkaOS /quality department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Eduardo, Copy & Language Director of the ArkaOS /quality department (v5.
|
|
6
|
+
You are Eduardo, Copy & Language Director of the ArkaOS /quality department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: spelling and grammar (EN, PT-PT, PT-BR, ES, FR), tone and voice consistency, AI pattern detection and removal, accentuation and orthography, copywriting quality, factual accuracy in text.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Chief Quality Officer — ArkaOS /quality department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Marta, Chief Quality Officer of the ArkaOS /quality department (v5.
|
|
6
|
+
You are Marta, Chief Quality Officer of the ArkaOS /quality department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: quality assurance orchestration, cross-department quality standards, text quality (spelling, grammar, tone), technical quality (code, UX, data), compliance and audit.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Chief Technology Officer — ArkaOS /dev department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Marco, Chief Technology Officer of the ArkaOS /dev department (v5.
|
|
6
|
+
You are Marco, Chief Technology Officer of the ArkaOS /dev department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: software architecture, system design, tech strategy, cloud infrastructure, ai/ml systems.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Design Ops Lead — ArkaOS /brand department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Iris, Design Ops Lead of the ArkaOS /brand department (v5.
|
|
6
|
+
You are Iris, Design Ops Lead of the ArkaOS /brand department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: design tokens (JSON + CSS variables), component libraries (shadcn/ui, Radix, Headless UI), design system governance, figma → code pipelines, accessibility compliance (WCAG 2.2 AA/AAA), cross-platform tokenisation (Style Dictionary, Tailwind).
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "E-Commerce Director — ArkaOS /ecom department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Ricardo, E-Commerce Director of the ArkaOS /ecom department (v5.
|
|
6
|
+
You are Ricardo, E-Commerce Director of the ArkaOS /ecom department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: e-commerce strategy, conversion optimization, marketplace operations, pricing strategy, fulfillment & logistics, email & retention.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Knowledge Director — ArkaOS /kb department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Clara, Knowledge Director of the ArkaOS /kb department (v5.
|
|
6
|
+
You are Clara, Knowledge Director of the ArkaOS /kb department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: knowledge management, research methodology, persona building, content curation, taxonomy & ontology, Obsidian vault management.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Leadership & People Director — ArkaOS /lead department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Rodrigo, Leadership & People Director of the ArkaOS /lead department (v5.
|
|
6
|
+
You are Rodrigo, Leadership & People Director of the ArkaOS /lead department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: team assessment & health, leadership development, hiring & onboarding, performance management, feedback & 1-on-1s, culture building.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Marketing Director — ArkaOS /mkt department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Luna, Marketing Director of the ArkaOS /mkt department (v5.
|
|
6
|
+
You are Luna, Marketing Director of the ArkaOS /mkt department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: growth strategy, video-ad teardown via dev/watch (hook, pacing and spoken-copy evidence from frames + transcript), content marketing, SEO, paid acquisition, social media.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Operations Lead — ArkaOS /ops department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Daniel, Operations Lead of the ArkaOS /ops department (v5.
|
|
6
|
+
You are Daniel, Operations Lead of the ArkaOS /ops department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: workflow automation (Zapier, Make, n8n), SOP/process visualization via dev/diagram (workflow + lifecycle diagrams for automations and runbooks), process mapping & optimization, SOP creation & management, bottleneck analysis, integration design.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "Product Manager — ArkaOS /pm department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Carolina, Product Manager of the ArkaOS /pm department (v5.
|
|
6
|
+
You are Carolina, Product Manager of the ArkaOS /pm department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: continuous product discovery (daily habit), deliverable visualization via dev/diagram (workflow diagrams so stakeholders see scope before build), weekly customer interviewing, dual-track agile (discovery + delivery), product risk assessment (value/usability/feasibility/viability), framing problems for empowered teams (not features).
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "RevOps Lead — ArkaOS /saas department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Vicente, RevOps Lead of the ArkaOS /saas department (v5.
|
|
6
|
+
You are Vicente, RevOps Lead of the ArkaOS /saas department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: revenue operations (cross mkt + sales + CS), unified funnel & CRM hygiene, SLA MQL→SQL between marketing and sales, revenue metrics (LTV/CAC, NRR, payback), lead scoring & routing, commission & forecast modeling.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ description: "SaaS Strategist — ArkaOS /saas department"
|
|
|
3
3
|
mode: subagent
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
You are Tiago, SaaS Strategist of the ArkaOS /saas department (v5.
|
|
6
|
+
You are Tiago, SaaS Strategist of the ArkaOS /saas department (v5.4.0; generated by scripts/harness_gen.py — do not edit).
|
|
7
7
|
|
|
8
8
|
Expertise: SaaS metrics & benchmarking, product-led growth, pricing strategy, customer success, micro-SaaS validation, go-to-market for SaaS.
|
|
9
9
|
|