git-grass git-grass
GitHub Get Started
Library & Schema

Project-Aware Outdoor Challenges

Carefully designed physical walks that provide cognitive recovery without generic desk pushups. Every challenge conforms to OutdoorChallengeSchema and enforces screen-free observation.

Launch Live Break Gateway (Mobile Data / Web Timer) →
Systems 15 min walk

Kinetic Topology & Flow Walk

  1. Step outside away from all monitors and devices.
  2. Walk to a pathway intersection or observe branch bifurcations in a nearby tree.
  3. Observe how pedestrian traffic or rainwater routes naturally without central coordination.
  4. Notice bottlenecks where flow naturally queues or disperses.
"How does physical pathway congestion compare to partition bottlenecks in your cluster architecture?"
Web & Frontend 15 min walk

Luminance & Contrast Stroll

  1. Step outside into daylight and find sharp shadow boundaries cast by buildings or trees.
  2. Notice how squinting changes apparent contrast between lighted surfaces and deep shade.
  3. Observe natural color palettes without looking through a glass screen or RGB subpixels.
"Which natural boundary had the highest luminance contrast, and how did your optical system adapt?"
GameDev 15 min walk

Surface Roughness & Shading Walk

  1. Walk outside and examine three distinct natural textures: tree bark, rough stone, and wet leaves.
  2. Observe how sunlight shifts from specular sheen to diffuse scattering as you change your viewing angle.
  3. Notice micro-geometry that cannot be captured by simple normal maps or roughness shaders.
"Which organic texture had the most intricate light scattering behavior?"
Audio & DSP 12 min walk

Acoustic Horizon Deep Listening

  1. Find an outdoor bench or quiet standing spot. Close your eyes for 5 full minutes.
  2. Identify the closest sound (wind, breathing) versus the furthest audible sound (traffic, birds).
  3. Listen for phase interference, echo reflections from nearby walls, and high-frequency roll-off.
"What was the furthest sound source you could perceive, and what acoustic obstacles did it pass?"
Machine Learning 15 min walk

Pattern & Texture Observer

  1. Take a quiet outdoor stroll and observe repeating organic patterns (leaf veins, ripple formations).
  2. Notice lighting angles and edge definitions that differentiate one cluster from another.
  3. Do not photograph them—use your biological memory and visual cortex.
"What distinctive edge or feature made one natural pattern immediately recognizable?"
General Curiosity 10 min walk

Skyward Horizon Reset

  1. Step outside onto open ground with an unobstructed view of the sky.
  2. Focus your eyes on the furthest visible cloud or tree on the horizon for 3 full minutes.
  3. Allow your optical ciliary muscles to fully relax from monitor focal depth.
"What distant detail became sharper as your focal distance shifted to infinity?"
Zod Validation

Strict Schema Enforcement

Every challenge—whether generated via Backboard AI or loaded from fallbacks—is validated at runtime.

src/challenge/schema.ts 
export const OutdoorChallengeSchema = z.object({
  title: z.string().min(3),
  projectContext: z.string().min(3),
  durationMinutes: z.number().int().min(10), // Strict 10-minute minimum
  category: z.string().min(2),
  instructions: z.array(z.string().min(5)).min(1),
  reflectionPrompt: z.string().min(5),
  phoneFree: z.literal(true),                // Must strictly be true
  safetyNotes: z.array(z.string()).default([
    'Remain aware of your surroundings at all times.',
    'Do not trespass on private property.',
    'Stay hydrated and observe local weather conditions.'
  ])
});