arkaos 5.6.0 → 5.7.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 +8 -0
- package/departments/brand/skills/design-system/SKILL.md +4 -2
- package/departments/brand/skills/motion-design/SKILL.md +362 -0
- package/departments/brand/skills/motion-design/references/director/choreography.md +93 -0
- package/departments/brand/skills/motion-design/references/director/context-adaptation.md +83 -0
- package/departments/brand/skills/motion-design/references/director/core-philosophy.md +53 -0
- package/departments/brand/skills/motion-design/references/director/decision-framework.md +91 -0
- package/departments/brand/skills/motion-design/references/director/disney-principles.md +102 -0
- package/departments/brand/skills/motion-design/references/director/emotion-mapping.md +71 -0
- package/departments/brand/skills/motion-design/references/director/motion-personality.md +89 -0
- package/departments/brand/skills/motion-design/references/director/narrative-structure.md +62 -0
- package/departments/brand/skills/motion-design/references/motion-design-skill.LICENSE +21 -0
- package/departments/brand/skills/motion-design/references/patterns/ambient-continuous.md +81 -0
- package/departments/brand/skills/motion-design/references/patterns/entrance-exit.md +82 -0
- package/departments/brand/skills/motion-design/references/patterns/multi-element.md +69 -0
- package/departments/brand/skills/motion-design/references/patterns/state-feedback.md +96 -0
- package/departments/brand/skills/motion-design/references/reference/property-selection.md +95 -0
- package/departments/brand/skills/motion-design/references/reference/quality-checklist.md +67 -0
- package/departments/brand/skills/motion-design/references/reference/timing-easing-tables.md +106 -0
- package/departments/brand/skills/motion-design/references/reference/troubleshooting.md +73 -0
- 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
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
# State & Feedback Patterns
|
|
2
|
+
|
|
3
|
+
## Button Press
|
|
4
|
+
|
|
5
|
+
### Playful
|
|
6
|
+
- Press: scale 0.95 (60ms, ease-out); Release: overshoot 1.05 (80ms); Settle: 1.0 (120ms, spring)
|
|
7
|
+
- Secondary: shadow shrinks/grows; color darkens/brightens. Total ~260ms
|
|
8
|
+
|
|
9
|
+
### Premium
|
|
10
|
+
- Press: scale 0.98 (80ms); Release: 1.0 (150ms, no overshoot)
|
|
11
|
+
- Opacity dims to 90% on press. Total ~230ms
|
|
12
|
+
|
|
13
|
+
### Corporate
|
|
14
|
+
- Press: scale 0.97 (60ms); Release: 1.0 (100ms); overshoot 0-2%
|
|
15
|
+
- Background darkens 10%. Total ~160ms
|
|
16
|
+
|
|
17
|
+
## Hover States
|
|
18
|
+
|
|
19
|
+
| Element | Effect | Duration |
|
|
20
|
+
|---------|--------|----------|
|
|
21
|
+
| Button | Scale 1.02-1.05 | <100ms |
|
|
22
|
+
| Card | Scale 1.01-1.02 + shadow lift | <100ms |
|
|
23
|
+
| Link | Color change + underline | <100ms |
|
|
24
|
+
| Icon | Scale 1.1 + rotation 2-5° | <100ms |
|
|
25
|
+
| Image | Scale 1.03 (overflow hidden) | 150ms |
|
|
26
|
+
|
|
27
|
+
Hover enter <100ms; hover exit 150-200ms (slower = polished).
|
|
28
|
+
|
|
29
|
+
## Toggle / Switch
|
|
30
|
+
- Thumb slides (120-180ms, ease-in-out); track color transitions simultaneously
|
|
31
|
+
- Slight squash in movement direction
|
|
32
|
+
- Playful: bounce at destination; Premium: smooth, no overshoot
|
|
33
|
+
|
|
34
|
+
## Success State
|
|
35
|
+
|
|
36
|
+
### Checkmark Success
|
|
37
|
+
1. Container: scale 0.9→1.0 (200ms, ease-out-back, 5-10% overshoot)
|
|
38
|
+
2. Checkmark: stroke draw (150ms, ease-out, 100ms delay)
|
|
39
|
+
3. Color: to green (200ms); ambient glow/particles (300ms)
|
|
40
|
+
4. Total: 400-500ms
|
|
41
|
+
|
|
42
|
+
### Confirmation Badge
|
|
43
|
+
1. Badge scales from 0 (200ms, ease-out-back)
|
|
44
|
+
2. Text fades in (150ms, 50ms delay)
|
|
45
|
+
3. Background pulse (300ms, sine)
|
|
46
|
+
|
|
47
|
+
### Payment Success
|
|
48
|
+
1. Spinner → checkmark crossfade (200ms)
|
|
49
|
+
2. Checkmark draws (200ms); container → success color (200ms)
|
|
50
|
+
3. Text fades in (200ms, 100ms delay); optional confetti (300-500ms)
|
|
51
|
+
|
|
52
|
+
## Error State
|
|
53
|
+
|
|
54
|
+
### Error Shake
|
|
55
|
+
- Horizontal oscillation ±10-15px, 2-3 cycles decreasing amplitude
|
|
56
|
+
- ease-in-out, 300-400ms total; red tint; no overshoot; settles at origin
|
|
57
|
+
|
|
58
|
+
### Inline Validation
|
|
59
|
+
1. Error text slides down + fades in (200ms)
|
|
60
|
+
2. Border → red (150ms); icon scales in (150ms, 50ms delay)
|
|
61
|
+
3. Optional single shake (200ms)
|
|
62
|
+
|
|
63
|
+
### Form Submission Error
|
|
64
|
+
1. Button returns to normal (200ms)
|
|
65
|
+
2. Error message slides in (250ms)
|
|
66
|
+
3. Affected fields highlight red (150ms, staggered 30ms)
|
|
67
|
+
4. Smooth scroll to first error (300ms, ease-in-out)
|
|
68
|
+
|
|
69
|
+
## Loading States
|
|
70
|
+
|
|
71
|
+
### Spinner
|
|
72
|
+
- Continuous 360°, linear, 1000-1500ms/rev; optional breathing pulse (2-3s)
|
|
73
|
+
|
|
74
|
+
### Skeleton
|
|
75
|
+
- Gradient sweep L→R, 1500-2000ms; base 10-20% opacity, peak 30-40%
|
|
76
|
+
|
|
77
|
+
### Progress Bar
|
|
78
|
+
- Width/transform, ease-in-out; optional color milestones + shimmer
|
|
79
|
+
|
|
80
|
+
### Indeterminate
|
|
81
|
+
- Oscillating position/width, 1500-2500ms, ease-in-out; continuous, never frantic
|
|
82
|
+
|
|
83
|
+
## Warning State
|
|
84
|
+
1. Yellow/amber border (150ms)
|
|
85
|
+
2. Warning icon scales in (150ms, subtle overshoot)
|
|
86
|
+
3. Optional icon pulse (2-3s, sine); text fades in (200ms, 50ms delay)
|
|
87
|
+
|
|
88
|
+
## Disabled / Enabled
|
|
89
|
+
|
|
90
|
+
- **Disabling**: opacity to 50-60% (200ms); optional scale to 98%
|
|
91
|
+
- **Enabling**: opacity to 100% (200ms); optional scale pulse 98%→100%
|
|
92
|
+
|
|
93
|
+
## Focus States
|
|
94
|
+
- Focus ring: scale 95%→100% + opacity (150ms)
|
|
95
|
+
- Card focus: scale 1.01, shadow increase (150ms)
|
|
96
|
+
- Tab nav focus: <100ms; must work with reduced-motion
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# Property Selection
|
|
2
|
+
|
|
3
|
+
## Position
|
|
4
|
+
|
|
5
|
+
| Direction | Meaning |
|
|
6
|
+
|-----------|---------|
|
|
7
|
+
| Upward | Growth, improvement, aspiration |
|
|
8
|
+
| Downward | Settling, completion, grounding |
|
|
9
|
+
| Leftward | Regression, backward, departure |
|
|
10
|
+
| Rightward | Progression, forward, arrival |
|
|
11
|
+
| Toward center | Focus, convergence |
|
|
12
|
+
| Away from center | Distribution, expansion |
|
|
13
|
+
|
|
14
|
+
## Scale
|
|
15
|
+
|
|
16
|
+
| Direction | Meaning |
|
|
17
|
+
|-----------|---------|
|
|
18
|
+
| Scale up | Importance, activation, proximity |
|
|
19
|
+
| Scale down | Deprioritization, distance |
|
|
20
|
+
| Pulse | Attention, heartbeat, life |
|
|
21
|
+
| Breathing | Presence, waiting |
|
|
22
|
+
|
|
23
|
+
## Rotation
|
|
24
|
+
|
|
25
|
+
| Range | Meaning |
|
|
26
|
+
|-------|---------|
|
|
27
|
+
| Small (5-15°) | Subtle adjustment |
|
|
28
|
+
| Medium (45-90°) | Transformation |
|
|
29
|
+
| Full (360°) | Completion, processing |
|
|
30
|
+
| Continuous | Ongoing activity |
|
|
31
|
+
|
|
32
|
+
## Opacity
|
|
33
|
+
|
|
34
|
+
| Direction | Meaning |
|
|
35
|
+
|-----------|---------|
|
|
36
|
+
| Fade in | Arrival, enablement |
|
|
37
|
+
| Fade out | Departure, disablement |
|
|
38
|
+
| Partial | Secondary, disabled state |
|
|
39
|
+
|
|
40
|
+
**Rule**: NEVER opacity alone for important state changes. Combine with position or scale.
|
|
41
|
+
|
|
42
|
+
## Color
|
|
43
|
+
|
|
44
|
+
| Transition | Meaning |
|
|
45
|
+
|-----------|---------|
|
|
46
|
+
| To green | Success, go |
|
|
47
|
+
| To red | Error, stop |
|
|
48
|
+
| To blue | Trust, active |
|
|
49
|
+
| To gray | Disabled, inactive |
|
|
50
|
+
| Brightening | Activation, focus |
|
|
51
|
+
| Dimming | Deactivation, background |
|
|
52
|
+
|
|
53
|
+
## Combined Properties
|
|
54
|
+
|
|
55
|
+
| Combination | Best For |
|
|
56
|
+
|-------------|----------|
|
|
57
|
+
| Position + Opacity | Content appearing/disappearing |
|
|
58
|
+
| Scale + Opacity | Cards, modals, notifications |
|
|
59
|
+
| Position + Scale | Selected items, focused content |
|
|
60
|
+
| Rotation + Scale | Celebrations, playful activation |
|
|
61
|
+
| Position + Rotation | Organic transitions |
|
|
62
|
+
| Color + Scale | State emphasis |
|
|
63
|
+
|
|
64
|
+
Primary property carries meaning; secondary adds polish. Two properties is the sweet spot.
|
|
65
|
+
|
|
66
|
+
## Property Selection by Goal
|
|
67
|
+
|
|
68
|
+
| Goal | Primary | Secondary | Avoid |
|
|
69
|
+
|------|---------|-----------|-------|
|
|
70
|
+
| Entrance | position | opacity | rotation |
|
|
71
|
+
| Exit | position | opacity | scale up |
|
|
72
|
+
| Button press | scale | color | position |
|
|
73
|
+
| Hover | scale or color | opacity | position |
|
|
74
|
+
| Success | scale | color + opacity | position |
|
|
75
|
+
| Error | position (shake) | color | scale |
|
|
76
|
+
| Loading | rotation | opacity | position |
|
|
77
|
+
| Toggle | position | color | rotation |
|
|
78
|
+
| Notification | position + scale | opacity | rotation |
|
|
79
|
+
| Delete | scale + opacity | position | grow |
|
|
80
|
+
| Selection | scale | color, opacity | rotation |
|
|
81
|
+
| Progress | position or scale | color | opacity |
|
|
82
|
+
|
|
83
|
+
## Performance
|
|
84
|
+
|
|
85
|
+
| Property | Performance |
|
|
86
|
+
|----------|-------------|
|
|
87
|
+
| transform (translate, scale, rotate) | Excellent — GPU-accelerated |
|
|
88
|
+
| opacity | Excellent — GPU-accelerated |
|
|
89
|
+
| color / background-color | Good — triggers paint |
|
|
90
|
+
| clip-path | Good — GPU on modern browsers |
|
|
91
|
+
| width / height | Poor — triggers layout |
|
|
92
|
+
| margin / padding | Poor — triggers layout |
|
|
93
|
+
| box-shadow | Poor — expensive paint |
|
|
94
|
+
|
|
95
|
+
**Rule**: Prefer transform + opacity for all motion.
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# Quality Checklist
|
|
2
|
+
|
|
3
|
+
## Visual Quality
|
|
4
|
+
- [ ] Elements >40px for motion, >100px for detail
|
|
5
|
+
- [ ] Readable at full speed without slow-motion
|
|
6
|
+
- [ ] Clear primary, secondary, ambient layers
|
|
7
|
+
- [ ] Counter-motion for balance where needed
|
|
8
|
+
- [ ] Natural arcs (unless intentionally mechanical)
|
|
9
|
+
- [ ] 1/3 rule (distance): no unbroken motion >1/3 container
|
|
10
|
+
- [ ] 1/3 rule (density): max 1/3 elements active simultaneously
|
|
11
|
+
|
|
12
|
+
## Technical Quality
|
|
13
|
+
- [ ] No linear easing on spatial movement
|
|
14
|
+
- [ ] Duration matches element type table
|
|
15
|
+
- [ ] Ease-out entrances, ease-in exits
|
|
16
|
+
- [ ] Duration proportional to distance
|
|
17
|
+
- [ ] Entrance duration >= exit duration
|
|
18
|
+
- [ ] Not opacity-only for important state changes
|
|
19
|
+
- [ ] Stagger total <500ms
|
|
20
|
+
- [ ] Follow-through: child elements offset 50-150ms
|
|
21
|
+
|
|
22
|
+
## Emotional Quality
|
|
23
|
+
- [ ] Target emotion identified before properties
|
|
24
|
+
- [ ] Personality archetype matches brand
|
|
25
|
+
- [ ] Setup → action → resolution structure
|
|
26
|
+
- [ ] Intensity matches interaction importance
|
|
27
|
+
- [ ] Consistent: same interaction = same motion
|
|
28
|
+
- [ ] Appropriate on 100th viewing
|
|
29
|
+
|
|
30
|
+
## Performance Quality
|
|
31
|
+
- [ ] Primary motion uses transform + opacity
|
|
32
|
+
- [ ] <20 animated elements per viewport
|
|
33
|
+
- [ ] No layout-triggering properties animated
|
|
34
|
+
- [ ] Elements staggered, not simultaneous
|
|
35
|
+
- [ ] Maintains 60fps (30fps acceptable for ambient)
|
|
36
|
+
|
|
37
|
+
## Accessibility Quality
|
|
38
|
+
- [ ] prefers-reduced-motion alternative provided
|
|
39
|
+
- [ ] No vestibular triggers without alternative
|
|
40
|
+
- [ ] Same interaction = same animation
|
|
41
|
+
- [ ] Critical info not motion-only
|
|
42
|
+
- [ ] Animations >5s are pausable
|
|
43
|
+
|
|
44
|
+
## Severity Tiers
|
|
45
|
+
|
|
46
|
+
### CRITICAL
|
|
47
|
+
- Linear easing on spatial movement
|
|
48
|
+
- Opacity-only for important states
|
|
49
|
+
- Exceeds 1/3 screen rule
|
|
50
|
+
- Missing primary layer
|
|
51
|
+
- Stagger >500ms
|
|
52
|
+
- Layout property animation causing jank
|
|
53
|
+
|
|
54
|
+
### HIGH
|
|
55
|
+
- Missing secondary layer
|
|
56
|
+
- Duration mismatch with element type
|
|
57
|
+
- Wrong directional easing
|
|
58
|
+
- Inconsistent personality
|
|
59
|
+
- No follow-through
|
|
60
|
+
- Missing reduced-motion alternative
|
|
61
|
+
|
|
62
|
+
### MEDIUM
|
|
63
|
+
- Missing ambient layer
|
|
64
|
+
- No anticipation phase
|
|
65
|
+
- Overshoot mismatch
|
|
66
|
+
- Could use better arcs
|
|
67
|
+
- Missing counter-motion
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
# Timing & Easing Tables
|
|
2
|
+
|
|
3
|
+
## Duration by Element Type
|
|
4
|
+
|
|
5
|
+
| Element | Duration |
|
|
6
|
+
|---------|----------|
|
|
7
|
+
| Tooltip / micro-feedback | 80-120ms |
|
|
8
|
+
| Button / toggle | 120-180ms |
|
|
9
|
+
| Icon transition | 150-250ms |
|
|
10
|
+
| Card enter/exit | 200-350ms |
|
|
11
|
+
| Modal / dialog | 300-400ms |
|
|
12
|
+
| Page transition | 400-600ms |
|
|
13
|
+
| Dramatic reveal | 600-1200ms |
|
|
14
|
+
| Ambient | 2000-20000ms |
|
|
15
|
+
|
|
16
|
+
## Distance-Duration Scaling
|
|
17
|
+
|
|
18
|
+
50px=0.8x | 100px=1.0x | 200px=1.3x | 300px=1.5x | 400px=1.6x | Full screen=1.8-2.0x
|
|
19
|
+
|
|
20
|
+
## Enter vs. Exit
|
|
21
|
+
Entrance = base (100%). Exit = 65-75% of entrance.
|
|
22
|
+
|
|
23
|
+
## Interactive Feedback
|
|
24
|
+
|
|
25
|
+
| Interaction | Max Latency |
|
|
26
|
+
|------------|-------------|
|
|
27
|
+
| Hover | <100ms |
|
|
28
|
+
| Press/tap | <150ms |
|
|
29
|
+
| Release/settle | 200-300ms |
|
|
30
|
+
| Error shake | 300-400ms |
|
|
31
|
+
| Long press | 500-800ms |
|
|
32
|
+
| Drag start | <50ms |
|
|
33
|
+
|
|
34
|
+
## Duration by Personality
|
|
35
|
+
|
|
36
|
+
| Personality | Quick | Standard | Slow |
|
|
37
|
+
|------------|-------|----------|------|
|
|
38
|
+
| Playful | 150ms | 250ms | 400ms |
|
|
39
|
+
| Premium | 350ms | 500ms | 800ms |
|
|
40
|
+
| Corporate | 200ms | 300ms | 450ms |
|
|
41
|
+
| Energetic | 100ms | 180ms | 300ms |
|
|
42
|
+
|
|
43
|
+
## Easing: Directional Rules
|
|
44
|
+
|
|
45
|
+
Entrance=ease-out | Exit=ease-in | On-screen=ease-in-out | Looping=sine | Rotation/progress=linear
|
|
46
|
+
|
|
47
|
+
## Easing: Industry Standards
|
|
48
|
+
|
|
49
|
+
| Name | Cubic Bezier | Use |
|
|
50
|
+
|------|-------------|-----|
|
|
51
|
+
| MD3 Standard | (0.2, 0, 0, 1) | Default on-screen |
|
|
52
|
+
| MD3 Emphasized | (0.05, 0.7, 0.1, 1) | Entrances |
|
|
53
|
+
| MD3 Accelerate | (0.3, 0, 1, 1) | Exits |
|
|
54
|
+
| MD3 Decelerate | (0, 0, 0, 1) | Entering |
|
|
55
|
+
| Apple HIG | (0.25, 0.1, 0.25, 1) | iOS default |
|
|
56
|
+
| Apple Spring | stiffness:300 damping:20 | Interactive |
|
|
57
|
+
| Snappy UI | (0.2, 0, 0, 1) | Fast, decisive |
|
|
58
|
+
| Gentle float | (0.4, 0, 0.2, 1) | Ambient |
|
|
59
|
+
| Bounce settle | (0.175, 0.885, 0.32, 1.275) | Playful |
|
|
60
|
+
| Elastic snap | (0.68, -0.55, 0.265, 1.55) | Dramatic |
|
|
61
|
+
|
|
62
|
+
## Material-Based Easing
|
|
63
|
+
|
|
64
|
+
| Material | Duration Scale | Overshoot |
|
|
65
|
+
|----------|---------------|-----------|
|
|
66
|
+
| Rigid (metal) | 1.2x | 0% |
|
|
67
|
+
| Elastic (rubber) | 0.8x | 15-25% |
|
|
68
|
+
| Fluid (water) | 1.5x | 5% |
|
|
69
|
+
| Paper (cards) | 1.0x | 3-5% |
|
|
70
|
+
| Gas (smoke) | 2.0x | 0% |
|
|
71
|
+
| Glass | 0.9x | 0% |
|
|
72
|
+
|
|
73
|
+
## Spring Parameters
|
|
74
|
+
|
|
75
|
+
| Feel | Stiffness | Damping |
|
|
76
|
+
|------|-----------|---------|
|
|
77
|
+
| Very stiff | 400+ | 25-30 |
|
|
78
|
+
| Standard | 250-350 | 18-24 |
|
|
79
|
+
| Bouncy | 150-250 | 10-15 |
|
|
80
|
+
| Very bouncy | 100-200 | 5-10 |
|
|
81
|
+
| Gentle | 100-150 | 20-25 |
|
|
82
|
+
|
|
83
|
+
Damping: <1.0=oscillates, 1.0=fastest no-oscillation, >1.0=slow settle.
|
|
84
|
+
|
|
85
|
+
## Stagger Patterns
|
|
86
|
+
|
|
87
|
+
| Pattern | Delay | Budget |
|
|
88
|
+
|---------|------|--------|
|
|
89
|
+
| Micro cascade | 20-40ms | <200ms |
|
|
90
|
+
| Standard | 50-100ms | <400ms |
|
|
91
|
+
| Dramatic | 100-200ms | <600ms |
|
|
92
|
+
| Wave | 30-60ms | <500ms |
|
|
93
|
+
|
|
94
|
+
Direction: top-to-bottom (lists) | L-to-R (horizontal) | center-out (hero) | random (organic) | reverse (exits)
|
|
95
|
+
|
|
96
|
+
Total stagger MUST stay <500ms.
|
|
97
|
+
|
|
98
|
+
## Overshoot Budget
|
|
99
|
+
|
|
100
|
+
| Context | Overshoot |
|
|
101
|
+
|---------|-----------|
|
|
102
|
+
| Success | 5-10% |
|
|
103
|
+
| Error | 0% |
|
|
104
|
+
| Feedback | 2-5% |
|
|
105
|
+
| Celebration | 15-25% |
|
|
106
|
+
| Premium | 0% |
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# Troubleshooting
|
|
2
|
+
|
|
3
|
+
## Looks Robotic
|
|
4
|
+
- Linear easing → use ease-out (entrance) or ease-in-out
|
|
5
|
+
- Straight paths → add 10-20px arc at midpoint
|
|
6
|
+
- Uniform timing → stagger 50-100ms between elements
|
|
7
|
+
- Everything synced → offset start/stop 50-150ms
|
|
8
|
+
- No secondary → add shadow, icon reaction, ambient
|
|
9
|
+
|
|
10
|
+
## Feels Too Slow
|
|
11
|
+
- Duration exceeds type budget → check duration table
|
|
12
|
+
- ease-in-out when ease-out works → ease-out feels faster
|
|
13
|
+
- Too much anticipation → reduce to 10% or remove
|
|
14
|
+
- Stagger exceeded → total <500ms
|
|
15
|
+
- Overshoot settle too long → increase damping
|
|
16
|
+
|
|
17
|
+
## Feels Too Fast / Jarring
|
|
18
|
+
- Duration below minimum → modals 300ms+, pages 400ms+
|
|
19
|
+
- No easing → add ease-out minimum
|
|
20
|
+
- Missing resolution → add 50-100ms settle
|
|
21
|
+
- No anticipation on large motion → add 100-200ms wind-up
|
|
22
|
+
|
|
23
|
+
## Feels Cheap / Flat
|
|
24
|
+
- Only primary motion → add secondary + ambient
|
|
25
|
+
- Opacity-only → combine with position or scale
|
|
26
|
+
- Same easing everywhere → vary primary vs secondary
|
|
27
|
+
- No follow-through → child elements trail 50-150ms
|
|
28
|
+
- No overshoot → add 3-10%
|
|
29
|
+
|
|
30
|
+
## Too Distracting
|
|
31
|
+
- Too many moving → 1/3 rule
|
|
32
|
+
- Amplitude too large → reduce to minimum
|
|
33
|
+
- Competing heroes → one per moment, dim rest
|
|
34
|
+
- Ambient too prominent → 10-20% amplitude, slower
|
|
35
|
+
- No breathing room → 100-200ms pause between beats
|
|
36
|
+
|
|
37
|
+
## No Personality
|
|
38
|
+
- Default easing → apply archetype's signature
|
|
39
|
+
- Same duration for all → use personality palette
|
|
40
|
+
- No consistent entrance → define one for project
|
|
41
|
+
- Mixed archetypes → pick one for 90%+
|
|
42
|
+
|
|
43
|
+
## Inconsistent Feel
|
|
44
|
+
- Different easing same-type → standardize per motion type
|
|
45
|
+
- Duration varies same type → use palette consistently
|
|
46
|
+
- Entry direction changes → one origin everywhere
|
|
47
|
+
- Overshoot inconsistent → apply rules consistently
|
|
48
|
+
|
|
49
|
+
## Performance (Dropped Frames)
|
|
50
|
+
- Animating width/height/margin → use transform
|
|
51
|
+
- Too many elements → <20 per viewport
|
|
52
|
+
- Complex shadows/filters → simplify or pre-render
|
|
53
|
+
- No GPU acceleration → transform + opacity
|
|
54
|
+
- All simultaneous → stagger to spread load
|
|
55
|
+
|
|
56
|
+
## Quick Diagnostic
|
|
57
|
+
|
|
58
|
+
1. No linear on spatial movement
|
|
59
|
+
2. Duration matches element type
|
|
60
|
+
3. Primary + secondary layers
|
|
61
|
+
4. Consistent personality
|
|
62
|
+
5. Directional easing correct
|
|
63
|
+
6. 1/3 screen rule
|
|
64
|
+
7. 1/3 element rule
|
|
65
|
+
8. Follow-through present
|
|
66
|
+
9. Every motion has purpose
|
|
67
|
+
10. Fine on 100th viewing
|
|
68
|
+
|
|
69
|
+
## Personality Mistakes
|
|
70
|
+
- **Playful**: overshoot >25% = broken; not everything bounces; short+bounce = glitchy
|
|
71
|
+
- **Premium**: too subtle = invisible; too slow = waiting; zero = broken
|
|
72
|
+
- **Corporate**: too conservative = boring; playful easing breaks trust; identical = monotonous
|
|
73
|
+
- **Energetic**: max everywhere = nothing stands out; too many particles; no settle = chaos
|
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.7.0 — 89 agents, 17 departments, 339 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.7.0 — 89 agents, 17 departments, 339 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.7.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.7.0 — 89 agents, 17 departments, 339 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.7.0 — 89 agents, 17 departments, 339 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.7.0 — 89 agents, 17 departments, 339 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.7.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.7.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.7.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.7.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.7.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.7.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.7.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.7.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.7.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.7.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.7.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.7.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.7.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.7.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.7.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.7.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.7.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
|
|