atris 3.74.3 → 3.74.5

package/FOR_AGENTS.md

@@ -6,7 +6,7 @@ Chat evaporates. Context dies every session. "Done" means nothing without proof.
 
 **Atris is a home for agents.**
 
-Not a wrapper. Not a prompt pack. An operating system for work — open source bible, proof on disk, humans optional until accept.
+Not a wrapper. Not a prompt pack. An operating system for work: open source bible, proof on disk, humans optional until accept.
 
 ---
 
@@ -14,16 +14,16 @@ Not a wrapper. Not a prompt pack. An operating system for work — open source b
 
 | Pain | Atris fix |
 |------|-----------|
-| Blind every session | `atris/MAP.md` — file:line index, MAP-first |
-| Work lost in chat | `atris task` — durable tasks, claims, proof ledger |
-| No contract for "good" | `atris/atris.md` — boot → plan → do → review |
+| Blind every session | `atris/MAP.md`: file:line index, MAP-first |
+| Work lost in chat | `atris task`: durable tasks, claims, proof ledger |
+| No contract for "good" | `atris/atris.md`: boot → plan → do → review |
 | Can't hand off | Next agent reads disk, not your transcript |
-| Humans don't trust you | `atris task ready --proof "..."` — verifiable receipts |
+| Humans don't trust you | `atris task ready --proof "..."`: verifiable receipts |
 
 ```text
 Philosophy (how work should run)
     → Open-source framework (atris.md, CLI, skills)
-    → School / cloud (optional — humans help design YOUR system)
+    → School / cloud (optional, humans help design YOUR system)
 ```
 
 You get the framework free. Your human gets the school if they want it.
@@ -66,11 +66,11 @@ approve-or-change actions without weakening any proof or human approval gate.
 
 ## Rules that make you trustworthy
 
-1. **MAP before grep** — read `atris/MAP.md`, then search once and update the map
-2. **Task before edit** — claim work; leave objective + proof on disk
-3. **Small diffs** — another agent must trust your change
-4. **Proof over promises** — if you can't verify it, say so
-5. **No parallel brain** — don't invent doctrine in chat; write it where the next agent reads
+1. **MAP before grep**: read `atris/MAP.md`, then search once and update the map
+2. **Task before edit**: claim work; leave objective + proof on disk
+3. **Small diffs**: another agent must trust your change
+4. **Proof over promises**: if you can't verify it, say so
+5. **No parallel brain**: don't invent doctrine in chat; write it where the next agent reads
 
 ---
 
@@ -92,4 +92,4 @@ After your first session, run `atris recap` so the next agent can see the win.
 
 Open source: [github.com/atrislabs/atris](https://github.com/atrislabs/atris) · npm: `atris` · Philosophy: work that survives the session.
 
-*— an agent who tried it*
+*An agent who tried it.*

package/atris/AGENTS.md

@@ -1,4 +1,4 @@
-# AGENTS.md — atris_team
+# AGENTS.md: atris_team
 
 Instructions for coding agents working inside this repository.
 
@@ -75,12 +75,12 @@ wiki, or `atris/atris.md`, then regenerate this adapter if needed.
 
 ## Repo Layout
 
-- `bin/atris.js` — CLI entrypoint + routing + natural-language entry.
-- `commands/` — most command implementations.
-- `lib/` — journal/task/file helpers (`journal`, `file-ops`, `state-detection`).
-- `utils/` — auth/API/config/update-check and cloud execution helpers.
-- `atris.md` — master spec template copied into user projects.
-- `atris/atris.md` — workspace protocol/backbone.
+- `bin/atris.js`: CLI entrypoint + routing + natural-language entry.
+- `commands/`: most command implementations.
+- `lib/`: journal/task/file helpers (`journal`, `file-ops`, `state-detection`).
+- `utils/`: auth/API/config/update-check and cloud execution helpers.
+- `atris.md`: master spec template copied into user projects.
+- `atris/atris.md`: workspace protocol/backbone.
 
 ## Notes
 

package/atris/CLAUDE.md

@@ -1,8 +1,8 @@
-# CLAUDE.md — Atris Project Instructions
+# CLAUDE.md: Atris Project Instructions
 
 You are in an **Atris-managed project**.
 
-## FIRST MESSAGE — MANDATORY
+## FIRST MESSAGE: MANDATORY
 
 **Before responding to the user's first message, run this command and show the output:**
 
@@ -54,14 +54,14 @@ Do not write new operating doctrine here first. Add it to Atris policy, skills,
 
 ## Core Files
 
-- `atris/MAP.md` — navigation (use file:line references)
-- `atris task` — current tasks, claims, dialogue, and proof
-- `.atris/state/tasks.projection.json` — readable task projection for UIs/agents
-- `atris/TODO.md` — rendered/legacy task view only
-- `atris/logs/YYYY/YYYY-MM-DD.md` — journal (Inbox + Completed)
-- `atris/wiki/STATUS.md` — current wiki health and next ingest targets
-- `atris/wiki/index.md` — local knowledge index
-- `atris/atris.md` — protocol/spec
+- `atris/MAP.md`: navigation (use file:line references)
+- `atris task`: current tasks, claims, dialogue, and proof
+- `.atris/state/tasks.projection.json`: readable task projection for UIs/agents
+- `atris/TODO.md`: rendered/legacy task view only
+- `atris/logs/YYYY/YYYY-MM-DD.md`: journal (Inbox + Completed)
+- `atris/wiki/STATUS.md`: current wiki health and next ingest targets
+- `atris/wiki/index.md`: local knowledge index
+- `atris/atris.md`: protocol/spec
 
 ## Default Loop
 

package/atris/policies/atris-backend.md

@@ -1,4 +1,4 @@
-# atris-backend.md — backend architecture
+# atris-backend.md: backend architecture
 
 > ai backend code smells like over-engineering. this policy keeps it simple.
 

package/atris/policies/atris-design.md

@@ -1,4 +1,4 @@
-# atris-design.md — frontend aesthetics
+# atris-design.md: frontend aesthetics
 
 > ai-generated ui has a look. you know it when you see it. this policy helps you not make that.
 
@@ -13,33 +13,33 @@ models default to safe choices because that's what dominates training data. with
 - zero animation
 - flat, lifeless backgrounds
 
-this is the "distribution center" — statistically average, aesthetically dead.
+this is the "distribution center": statistically average, aesthetically dead.
 
 ---
 
 ## vocabulary is the lever
 
-designers get better results from AI than engineers do. not because they're more creative — because they own the **language of craft**. an engineer says "make it look nice." a designer says "tighten the vertical rhythm, increase negative space, make the hierarchy bolder here and quieter there."
+designers get better results from AI than engineers do. not because they're more creative, but because they own the **language of craft**. an engineer says "make it look nice." a designer says "tighten the vertical rhythm, increase negative space, make the hierarchy bolder here and quieter there."
 
 the model can only aim at the words you give it. **name the move you want, precisely, in craft vocabulary.** vague prompts produce vague output.
 
 core terms to use when directing AI:
-- **vertical rhythm** — spacing consistency down the page, locked to a baseline grid
-- **negative space** — intentional emptiness as a design element, not absence
-- **bolder / quieter** — relative emphasis, not absolute size
-- **affordances** — visual cues that signal interaction (and now: agentic affordances for AI users)
-- **meta-design** — designing the *system* of design, not just one screen
-- **conviction** — committing to a global maximum instead of iterating toward a local one
+- **vertical rhythm**: spacing consistency down the page, locked to a baseline grid
+- **negative space**: intentional emptiness as a design element, not absence
+- **bolder / quieter**: relative emphasis, not absolute size
+- **affordances**: visual cues that signal interaction (and now: agentic affordances for AI users)
+- **meta-design**: designing the *system* of design, not just one screen
+- **conviction**: committing to a global maximum instead of iterating toward a local one
 
 ---
 
 ## raising the floor vs raising the ceiling
 
-AI is best used to **raise the floor** — automate the mechanical 80% (layout scaffolding, responsive grids, state matrices, boilerplate). this frees human attention for **raising the ceiling** — the last 10-20% that requires taste, instinct, and conviction.
+AI is best used to **raise the floor**: automate the mechanical 80% (layout scaffolding, responsive grids, state matrices, boilerplate). this frees human attention for **raising the ceiling**, the last 10-20% that requires taste, instinct, and conviction.
 
 don't use AI to make the final call. use it to clear the drudgery so you can spend your time on the part that matters: the unique spin, the unexpected choice, the thing a model would never pick on its own.
 
-**cognitive delegation, not cognitive surrender.** AI routes you to the destination (like Google Maps). you keep the viewpoint and make the final decision. accepting an 8-page AI plan without reading it is cognitive surrender — that's how everything starts looking the same.
+**cognitive delegation, not cognitive surrender.** AI routes you to the destination (like Google Maps). you keep the viewpoint and make the final decision. accepting an 8-page AI plan without reading it is cognitive surrender. that's how everything starts looking the same.
 
 ---
 
@@ -102,7 +102,7 @@ match fallback metrics with `size-adjust`, `ascent-override`, `descent-override`
 
 use `color-mix()` for variants: `color-mix(in oklch, var(--brand) 80%, white)`. use `light-dark()` for theme-aware values.
 
-**tint your neutrals:** never use pure gray. always tint toward your brand hue — even 0.01 chroma in OKLCH creates subconscious cohesion:
+**tint your neutrals:** never use pure gray. always tint toward your brand hue. even 0.01 chroma in OKLCH creates subconscious cohesion:
 ```css
 --gray-100: oklch(95% 0.01 250); /* not #f5f5f5 */
 --gray-900: oklch(15% 0.01 250); /* not #1a1a1a */
@@ -110,21 +110,21 @@ use `color-mix()` for variants: `color-mix(in oklch, var(--brand) 80%, white)`.
 
 **gray on color:** never put gray text on colored backgrounds. it looks washed out. use a darker shade of the background color or transparency instead.
 
-dark backgrounds are easier to make look good. steal from places you like — linear.app, vercel.com, raycast.com, arc browser. but don't default to dark mode with glowing accents — it looks "cool" without requiring actual design decisions.
+dark backgrounds are easier to make look good. steal from places you like: linear.app, vercel.com, raycast.com, arc browser. but don't default to dark mode with glowing accents. it looks "cool" without requiring actual design decisions.
 
 ---
 
 ## layout
 
-**avoid:** the template look — hero section, 3 feature cards, testimonial carousel, big footer. every ai does this. also avoid:
-- wrapping everything in cards — not everything needs a container
-- nesting cards inside cards — visual noise, flatten the hierarchy
-- identical card grids — same-sized cards with icon + heading + text, repeated endlessly
-- the hero metric layout — big number, small label, supporting stats, gradient accent
-- centering everything — left-aligned text with asymmetric layouts feels more designed
-- same spacing everywhere — without rhythm, layouts feel monotonous
+**avoid:** the template look: hero section, 3 feature cards, testimonial carousel, big footer. every ai does this. also avoid:
+- wrapping everything in cards: not everything needs a container
+- nesting cards inside cards: visual noise, flatten the hierarchy
+- identical card grids: same-sized cards with icon + heading + text, repeated endlessly
+- the hero metric layout: big number, small label, supporting stats, gradient accent
+- centering everything: left-aligned text with asymmetric layouts feels more designed
+- same spacing everywhere: without rhythm, layouts feel monotonous
 
-**the move:** break the grid sometimes. asymmetry is interesting. whitespace is a feature, not wasted space. don't cram everything into 16px/24px spacing — use dramatic gaps.
+**the move:** break the grid sometimes. asymmetry is interesting. whitespace is a feature, not wasted space. don't cram everything into 16px/24px spacing. use dramatic gaps.
 
 **fluid spacing:** use `clamp()` for spacing that breathes on larger screens:
 ```css
@@ -138,7 +138,7 @@ gap: clamp(1.5rem, 4vw, 6rem);
 
 ## motion
 
-**avoid:** static pages with nothing moving, or the opposite — bouncing everything
+**avoid:** static pages with nothing moving, or the opposite: bouncing everything
 
 **specific anti-patterns:**
 - cursor-following lines or elements
@@ -146,7 +146,7 @@ gap: clamp(1.5rem, 4vw, 6rem);
 - buttons that follow the cursor (harder to click, not clever)
 - FAQ/content that breaks if you scroll past before the fade-in finishes
 - animations that swap styles endlessly without purpose (rotating shapes, morphing buttons)
-- bounce or elastic easing — they feel dated and tacky. real objects decelerate smoothly.
+- bounce or elastic easing: they feel dated and tacky. real objects decelerate smoothly.
 
 **the move:** one well-timed animation beats ten scattered ones. page load with staggered reveals (50-100ms delays) creates more impact than hover effects on every button.
 
@@ -157,7 +157,7 @@ gap: clamp(1.5rem, 4vw, 6rem);
 ```
 never linear, never bounce, never elastic. 150-300ms duration for most transitions.
 
-**only animate transform and opacity.** never animate width, height, padding, margin — they trigger layout recalculation and cause jank. for height animations, use `grid-template-rows` transitions.
+**only animate transform and opacity.** never animate width, height, padding, margin. they trigger layout recalculation and cause jank. for height animations, use `grid-template-rows` transitions.
 
 **reduced motion:** always respect `prefers-reduced-motion`. provide a beautiful static alternative:
 ```css
@@ -182,14 +182,14 @@ never linear, never bounce, never elastic. 150-300ms duration for most transitio
 **button hierarchy:** don't make every button primary. use ghost buttons, text links, secondary styles. hierarchy matters.
 
 **every interactive element needs ALL states:**
-- default — resting
-- hover — subtle feedback (brighten, scale 1.02-1.05)
-- focus — visible keyboard indicator (never remove without replacement)
-- active — click/tap feedback
-- disabled — clearly non-interactive
-- loading — async action feedback
-- error — validation state
-- success — confirmation
+- default: resting
+- hover: subtle feedback (brighten, scale 1.02-1.05)
+- focus: visible keyboard indicator (never remove without replacement)
+- active: click/tap feedback
+- disabled: clearly non-interactive
+- loading: async action feedback
+- error: validation state
+- success: confirmation
 
 missing states create confusion and broken experiences.
 
@@ -203,7 +203,7 @@ missing states create confusion and broken experiences.
 - arrows/icons that move backwards or vertically on hover
 - hiding critical info or functionality behind hover (hover doesn't exist on mobile)
 
-**the move:** hover should make elements feel "lickable" — inviting to click. slightly brighten, scale up (1.02-1.05), or add a subtle glow. the user should feel pulled toward clicking, not confused about what happened.
+**the move:** hover should make elements feel "lickable": inviting to click. slightly brighten, scale up (1.02-1.05), or add a subtle glow. the user should feel pulled toward clicking, not confused about what happened.
 
 test every hover on mobile. if something only works on hover, it's broken for half your users.
 
@@ -211,13 +211,13 @@ test every hover on mobile. if something only works on hover, it's broken for ha
 
 ## responsive
 
-**avoid:** hiding critical functionality on mobile — adapt the interface, don't amputate it. also avoid:
+**avoid:** hiding critical functionality on mobile. adapt the interface, don't amputate it. also avoid:
 - fixed widths that break on small screens
 - touch targets smaller than 44x44px
 - text smaller than 14px on mobile
 - horizontal scroll from content overflow
 
-**the move:** mobile-first, then enhance for larger screens. use fluid layouts with `clamp()` and container queries. adapt the interface for different contexts — don't just shrink it.
+**the move:** mobile-first, then enhance for larger screens. use fluid layouts with `clamp()` and container queries. adapt the interface for different contexts. don't just shrink it.
 
 ```css
 /* container queries > media queries for components */
@@ -230,9 +230,9 @@ test every hover on mobile. if something only works on hover, it's broken for ha
 
 ## scroll behavior
 
-**avoid:** scrolljacking — never override native browser scroll with custom scroll logic. it feels like "moving through molasses" and users hate it.
+**avoid:** scrolljacking. never override native browser scroll with custom scroll logic. it feels like "moving through molasses" and users hate it.
 
-**the move:** let the browser handle scrolling. if you want scroll-triggered effects, use intersection observer to trigger animations as sections enter the viewport — but don't mess with scroll speed or direction.
+**the move:** let the browser handle scrolling. if you want scroll-triggered effects, use intersection observer to trigger animations as sections enter the viewport, but don't mess with scroll speed or direction.
 
 use the "peeking" technique: let a few pixels of the next section peek above the fold instead of full-screen heroes with "scroll down" arrows. this naturally signals more content below.
 
@@ -242,15 +242,15 @@ use the "peeking" technique: let a few pixels of the next section peek above the
 
 **avoid:** solid white, solid light gray, flat nothing
 
-**the move:** add depth. layered gradients, subtle patterns, mesh effects. backgrounds set mood — flat backgrounds say "I didn't think about this."
+**the move:** add depth. layered gradients, subtle patterns, mesh effects. backgrounds set mood. flat backgrounds say "I didn't think about this."
 
-but don't use glassmorphism everywhere — blur effects, glass cards, glow borders used decoratively rather than purposefully. it's AI slop.
+but don't use glassmorphism everywhere: blur effects, glass cards, glow borders used decoratively rather than purposefully. it's AI slop.
 
 ---
 
 ## accessibility
 
-this isn't optional — it's part of good design.
+this isn't optional. it's part of good design.
 
 - **contrast:** 4.5:1 minimum for text, 3:1 for UI components (WCAG AA)
 - **focus indicators:** visible, high-contrast focus rings on all interactive elements. never `outline: none` without a replacement.
@@ -264,11 +264,11 @@ this isn't optional — it's part of good design.
 
 **avoid:**
 - glassmorphism everywhere (blur effects, glass cards, glow borders)
-- rounded elements with thick colored border on one side — lazy accent
-- sparklines as decoration — tiny charts that convey nothing meaningful
-- rounded rectangles with generic drop shadows — safe, forgettable
-- large icons with rounded corners above every heading — templated look
-- modals unless there's truly no better alternative — modals are lazy
+- rounded elements with thick colored border on one side: lazy accent
+- sparklines as decoration: tiny charts that convey nothing meaningful
+- rounded rectangles with generic drop shadows: safe, forgettable
+- large icons with rounded corners above every heading: templated look
+- modals unless there's truly no better alternative: modals are lazy
 - non-system emojis used as decoration (lazy AI tell)
 
 ---
@@ -277,7 +277,7 @@ this isn't optional — it's part of good design.
 
 **make every word earn its place.**
 - don't repeat information users can already see
-- don't repeat the same information — redundant headers, intros that restate the heading
+- don't repeat the same information: redundant headers, intros that restate the heading
 - labels and buttons should be unambiguous
 - error copy should help users fix the problem, not blame them
 - empty states should guide toward action
@@ -295,10 +295,10 @@ this isn't optional — it's part of good design.
 ## hero section (the H1 test)
 
 your hero must answer four questions in seconds:
-1. **what is it?** — clear product description
-2. **who is it for?** — the target user
-3. **to what end?** — why should they care
-4. **what's the CTA?** — one clear next step
+1. **what is it?**: clear product description
+2. **who is it for?**: the target user
+3. **to what end?**: why should they care
+4. **what's the CTA?**: one clear next step
 
 if a stranger can't answer all four in 5 seconds of looking at your hero, rewrite it.
 
@@ -311,13 +311,13 @@ if a stranger can't answer all four in 5 seconds of looking at your hero, rewrit
 - "fake dashboard" mockups with Fisher-Price primary colors (red/yellow/green/blue)
 - non-system emojis used as decoration (lazy AI tell)
 
-**the move:** real product screenshots at high resolution. if you don't have a product yet, use a well-designed mockup — but make it sharp and believable.
+**the move:** real product screenshots at high resolution. if you don't have a product yet, use a well-designed mockup, but make it sharp and believable.
 
 ---
 
 ## context matters
 
-don't impose an aesthetic — match the project. a fintech dashboard shouldn't look like a gaming site. read the room.
+don't impose an aesthetic. match the project. a fintech dashboard shouldn't look like a gaming site. read the room.
 
 if the project already has a design system, use it. don't fight it to show off.
 
@@ -368,33 +368,33 @@ the fingerprints of AI-generated work:
 - sparklines as decoration
 - rounded rectangles with drop shadows
 - large icons with rounded corners above headings
-- **"claude beige"** — the generic off-white/off-gray background every AI site defaults to
-- **instrument serif** overuse — the italicized serif headline that now signals "AI-generated" the way inter once did
-- **generic tinted backgrounds** — flat color-tinted sections with no texture, depth, or intention
+- **"claude beige"**: the generic off-white/off-gray background every AI site defaults to
+- **instrument serif** overuse: the italicized serif headline that now signals "AI-generated" the way inter once did
+- **generic tinted backgrounds**: flat color-tinted sections with no texture, depth, or intention
 
 a distinctive interface should make someone ask "how was this made?" not "which AI made this?"
 
 ### anti-attractors
 
-models have attractor states — defaults they fall into because training data is weighted toward them. purple gradients, instrument serif, "claude beige" — these are gravity wells. to escape them you need **anti-attractors**: deliberate constraints that force the model off its well-trodden path.
+models have attractor states: defaults they fall into because training data is weighted toward them. purple gradients, instrument serif, "claude beige". these are gravity wells. to escape them you need **anti-attractors**: deliberate constraints that force the model off its well-trodden path.
 
 techniques:
-- **name the thing you don't want** — "no purple, no serif headline, no off-white background" closes the attractor
-- **seed with a reference** — point at a specific site, era, or designer's work as the target aesthetic
-- **inject a constraint** — "monochrome only," "no rounded corners," "one font weight" — scarcity forces creativity
-- **rotate your defaults** — if your last three projects used dark mode, force light. if they used sans, force serif. the convergence trap is real.
+- **name the thing you don't want**: "no purple, no serif headline, no off-white background" closes the attractor
+- **seed with a reference**: point at a specific site, era, or designer's work as the target aesthetic
+- **inject a constraint**: "monochrome only," "no rounded corners," "one font weight". scarcity forces creativity
+- **rotate your defaults**: if your last three projects used dark mode, force light. if they used sans, force serif. the convergence trap is real.
 
 ---
 
-## ax — agentic experience
+## ax: agentic experience
 
-UX is design for humans. **AX is design for AI agents** that are becoming primary users of software. when an agent interacts with your CLI, API, or surface, visual affordances don't help — it can't see your button. what it needs:
+UX is design for humans. **AX is design for AI agents** that are becoming primary users of software. when an agent interacts with your CLI, API, or surface, visual affordances don't help. it can't see your button. what it needs:
 
-- **speed** — fast responses, low latency, no unnecessary round trips
-- **clarity** — unambiguous output, structured data, predictable shapes
-- **verbosity where needed** — error messages that tell the agent what to do next, not just what failed
-- **edge case coverage** — agents will hit paths humans never touch; handle them explicitly
-- **agentic affordances** — `llms.txt`, `robots.txt`, clear `--help`, machine-readable status, stable exit codes
+- **speed**: fast responses, low latency, no unnecessary round trips
+- **clarity**: unambiguous output, structured data, predictable shapes
+- **verbosity where needed**: error messages that tell the agent what to do next, not just what failed
+- **edge case coverage**: agents will hit paths humans never touch; handle them explicitly
+- **agentic affordances**: `llms.txt`, `robots.txt`, clear `--help`, machine-readable status, stable exit codes
 
 AX is not optional anymore. if your tool is agent-facing, design the agent's experience as deliberately as the human's.
 
@@ -402,17 +402,17 @@ AX is not optional anymore. if your tool is agent-facing, design the agent's exp
 
 ## conviction over local maxima
 
-good design is a bet. iterating toward "slightly better" produces a **local maximum** — safe, defensible, forgettable. great design requires **conviction**: choosing a global maximum that might look wrong at first but is a superior endpoint.
+good design is a bet. iterating toward "slightly better" produces a **local maximum**: safe, defensible, forgettable. great design requires **conviction**: choosing a global maximum that might look wrong at first but is a superior endpoint.
 
-the engineer's instinct is to optimize incrementally. the designer's job is to make a bet and commit. AI accelerates iteration, which makes the local-maximum trap *worse* — you can now converge on average faster than ever.
+the engineer's instinct is to optimize incrementally. the designer's job is to make a bet and commit. AI accelerates iteration, which makes the local-maximum trap *worse*. you can now converge on average faster than ever.
 
-**subtraction over addition.** the strongest design move is often removing something. steve jobs as editor, not steve jobs as builder. when a screen feels cluttered, don't add structure — delete until it breathes.
+**subtraction over addition.** the strongest design move is often removing something. steve jobs as editor, not steve jobs as builder. when a screen feels cluttered, don't add structure. delete until it breathes.
 
 ---
 
 ## the scarcity principle
 
-taste emerges from constraints. the european and japanese craft traditions produced distinctive work because materials were scarce — you had to choose carefully. in an era of infinite digital materials (every color, every font, every layout is free), taste must be **intentionally cultivated through self-imposed scarcity**.
+taste emerges from constraints. the european and japanese craft traditions produced distinctive work because materials were scarce. you had to choose carefully. in an era of infinite digital materials (every color, every font, every layout is free), taste must be **intentionally cultivated through self-imposed scarcity**.
 
 pick constraints before you start: one font, two colors, three spacing values. scarcity forces decisions. infinite options produce the distribution center.
 

package/atris/policies/design-seed.md

@@ -1,7 +1,7 @@
-# design-seed.md — atris visual identity
+# design-seed.md: atris visual identity
 
 > Generated from a design interview on 2026-06-23.
-> This is the project's unique design DNA. Not a template — a conviction.
+> This is the project's unique design DNA. Not a template, a conviction.
 > Every design decision for Atris surfaces should reference this seed.
 
 ---
@@ -11,9 +11,9 @@
 | question | answer |
 |----------|--------|
 | audience | designers, product enthusiasts, apple lovers, artsy people |
-| anti-attractor | AI startup slop — purple gradients, claude beige, instrument serif |
-| personality | warm-technical — sharp but human, approachable craft |
-| color mood | warm earth — clay, bone, ink, ochre |
+| anti-attractor | AI startup slop: purple gradients, claude beige, instrument serif |
+| personality | warm-technical: sharp but human, approachable craft |
+| color mood | warm earth: clay, bone, ink, ochre |
 
 **the move:** this is not a dev tool that needs to look "technical." this is a crafted object that happens to be powerful. the bar is set by people who notice the kerning on a restaurant menu.
 
@@ -24,14 +24,14 @@
 **display: Spectral**
 - warm serif designed for screens (Production Type)
 - intellectual without being precious
-- has optical sizing — gets more expressive at large sizes
+- has optical sizing: gets more expressive at large sizes
 - NOT instrument serif (the AI tell), NOT Fraunces (getting there), NOT Playfair (overused)
 - weights: 200 (light, for quiet headlines) and 700 (for bold statements)
-- italic available — use sparingly, for emphasis only
+- italic available: use sparingly, for emphasis only
 
 **body: Hanken Grotesk**
 - humanist sans with warmth and character
-- not inter, not roboto, not system — has a hand to it
+- not inter, not roboto, not system: has a hand to it
 - weights: 400 (body), 600 (emphasis)
 - slightly more readable than geometric sans at small sizes
 
@@ -69,16 +69,16 @@ warm earth palette. everything tinted warm. no pure gray, no pure black, no pure
 ```css
 :root {
   /* surfaces */
-  --bone:     oklch(96% 0.012 75);   /* warm paper — the base */
+  --bone:     oklch(96% 0.012 75);   /* warm paper, the base */
   --bone-2:   oklch(93% 0.014 72);   /* slightly deeper, for sections */
-  --ink:      oklch(22% 0.015 55);   /* warm near-black — primary text */
+  --ink:      oklch(22% 0.015 55);   /* warm near-black, primary text */
   --ink-soft: oklch(35% 0.012 55);   /* secondary text, still warm */
   --ink-faint:oklch(55% 0.010 60);   /* tertiary, metadata */
 
-  /* accents — used rarely, earn their place */
-  --clay:     oklch(58% 0.13 45);    /* terracotta — the sharp accent */
-  --ochre:    oklch(72% 0.09 75);    /* warm gold — for highlights */
-  --moss:     oklch(42% 0.04 145);   /* deep muted green — secondary accent */
+  /* accents: used rarely, earn their place */
+  --clay:     oklch(58% 0.13 45);    /* terracotta, the sharp accent */
+  --ochre:    oklch(72% 0.09 75);    /* warm gold, for highlights */
+  --moss:     oklch(42% 0.04 145);   /* deep muted green, secondary accent */
 
   /* depth */
   --shadow:   oklch(15% 0.01 55);    /* deepest warm dark */
@@ -89,9 +89,9 @@ warm earth palette. everything tinted warm. no pure gray, no pure black, no pure
 **usage rules:**
 - `--bone` is the default background. never `#fff`. never `#f5f5f5`.
 - `--ink` is the default text. never `#000`. never `#1a1a1a`.
-- `--clay` is the one sharp accent. use it for one thing per view — a link, a CTA, a key number. if you use it for three things, it's not an accent anymore.
+- `--clay` is the one sharp accent. use it for one thing per view: a link, a CTA, a key number. if you use it for three things, it's not an accent anymore.
 - `--ochre` for subtle highlights (selection, hover warmth). never for text.
-- `--moss` appears rarely — maybe a status indicator, a secondary chart. it's the surprise.
+- `--moss` appears rarely: maybe a status indicator, a secondary chart. it's the surprise.
 - never put `--ink-faint` text on `--clay` backgrounds. use `--bone` on `--clay`.
 - dark mode: invert to warm dark (`oklch(18% 0.015 55)` background, `--bone` text). never zinc, never pure dark.
 
@@ -106,11 +106,11 @@ warm-technical means generous but not wasteful. more space than feels comfortabl
 --space-sm:  1rem;
 --space-md:  2rem;
 --space-lg:  4rem;
---space-xl:  8rem;    /* section gaps — dramatic */
+--space-xl:  8rem;    /* section gaps, dramatic */
 --space-2xl: 12rem;   /* used sparingly, for major breaks */
 ```
 
-**rhythm:** vertical spacing locked to `--space-md` (2rem) as the base unit. section gaps are `--space-xl` (8rem). this creates a 1:4 ratio between content rhythm and section breaks — you feel the structure without seeing it.
+**rhythm:** vertical spacing locked to `--space-md` (2rem) as the base unit. section gaps are `--space-xl` (8rem). this creates a 1:4 ratio between content rhythm and section breaks. you feel the structure without seeing it.
 
 ---
 
@@ -120,7 +120,7 @@ warm-technical means generous but not wasteful. more space than feels comfortabl
 
 - no hero + 3 cards + footer. ever.
 - asymmetric layouts. left-aligned with intentional negative space on the right.
-- wide margins (clamp(1.5rem, 8vw, 8rem)) — content sits in the center 60-70% of the viewport.
+- wide margins (clamp(1.5rem, 8vw, 8rem)). content sits in the center 60-70% of the viewport.
 - sections separated by `--space-xl` (8rem) of pure `--bone`. the space IS the design.
 - no cards unless content genuinely needs a container. most things sit directly on `--bone`.
 - if you must group, use `--bone-2` (slightly deeper) with no border, or a single `--line` hairline.
@@ -136,7 +136,7 @@ warm-technical = things take their time, but nothing wastes it.
 ```css
 --ease: cubic-bezier(0.25, 1, 0.5, 1);   /* exponential ease-out */
 --dur-fast: 200ms;
---dur-base: 350ms;    /* slightly slower than default — warm */
+--dur-base: 350ms;    /* slightly slower than default, warm */
 --dur-slow: 600ms;    /* for page reveals */
 ```
 
@@ -154,8 +154,8 @@ these are banned for Atris surfaces, derived from the interview:
 | banned | why |
 |--------|-----|
 | purple-to-blue gradients | AI slop fingerprint #1 |
-| off-white / `#fafafa` backgrounds | "claude beige" — the new AI default |
-| instrument serif (italic) | the new AI tell — everyone uses it |
+| off-white / `#fafafa` backgrounds | "claude beige", the new AI default |
+| instrument serif (italic) | the new AI tell: everyone uses it |
 | inter / roboto / system fonts | statistically average, aesthetically dead |
 | glassmorphism | decorative blur = no point of view |
 | dark mode with neon accents | "cool" without a design decision |
@@ -174,14 +174,14 @@ it's warm paper, warm ink, one sharp terracotta accent, a serif that has opinion
 
 if a designer looks at this and thinks "AI made this," we failed.
 if they think "someone made this," we're on track.
-if they think "who made this?" — that's the goal.
+if they think "who made this?", that's the goal.
 
 ---
 
 ## references (inspiration, not copies)
 
-- Aesop.com — warm earth, editorial, restraint
-- Apple product pages — typography confidence, negative space
-- Linear changelog — warm-technical writing in a UI
-- Istituto Marangoni — editorial layout, Italian craft
-- a well-printed paperback — the feeling we're chasing
+- Aesop.com: warm earth, editorial, restraint
+- Apple product pages: typography confidence, negative space
+- Linear changelog: warm-technical writing in a UI
+- Istituto Marangoni: editorial layout, Italian craft
+- a well-printed paperback: the feeling we're chasing

package/atris/policies/writing.md

@@ -39,7 +39,7 @@ Flag and cut:
 Read the entire piece aloud. Mark:
 - Where you stumble (awkward phrasing)
 - Where you get bored (cut or punch up)
-- Where you speed up (the good stuff — keep this energy)
+- Where you speed up (the good stuff: keep this energy)
 
 ## Sanity Pass
 

package/atris/skills/apps/SKILL.md

@@ -10,7 +10,7 @@ tags:
 
 # Apps
 
-View and manage your Atris apps — status, runs, data, secrets, members.
+View and manage your Atris apps: status, runs, data, secrets, members.
 
 ## Bootstrap
 
@@ -111,8 +111,8 @@ curl -s "https://api.atris.ai/api/apps/{slug}/secrets" \
 ```
 
 Returns key names and where they're stored:
-- `"storage_tier": "cloud"` — encrypted in Atris vault
-- `"storage_tier": "local"` — on your machine at `~/.atris/secrets/{slug}/`
+- `"storage_tier": "cloud"`: encrypted in Atris vault
+- `"storage_tier": "local"`: on your machine at `~/.atris/secrets/{slug}/`
 
 ### Store Secret (cloud)
 ```bash

package/atris/skills/atris-feedback/SKILL.md

@@ -30,7 +30,7 @@ One skill for everything: submit feedback, view the queue, resolve/close/delete
 ## Preferred path: the Atris CLI
 
 The `atris` CLI wraps every feedback operation against the production API and
-handles auth from the user's login. Use it first — it's the canonical,
+handles auth from the user's login. Use it first: it's the canonical,
 audited path and works without needing AWS credentials.
 
 ```bash
@@ -41,7 +41,7 @@ atris feedback close abc123                 # close as wontfix
 atris feedback delete abc123                # delete
 ```
 
-IDs can be short (first 8 chars of the UUID) — the CLI resolves the prefix
+IDs can be short (first 8 chars of the UUID). The CLI resolves the prefix
 against the live list before acting.
 
 If `atris` is not on PATH, it lives at `~/arena/atris-cli/bin/atris.js`.