atris 3.57.4 → 3.58.5

package/README.md

@@ -99,6 +99,17 @@ Core loop: `plan` -> `do` -> `review`
 
 Integrates with any agent.
 
+### Publish a static site
+
+Upload any built static site to an Atris-hosted subdomain. See
+[docs/site-publish.md](docs/site-publish.md) for flags, limits, profiles, and
+troubleshooting.
+
+```bash
+atris site publish dist --slug my-site --spa
+atris site publish . --slug my-next-app --profile app --build   # Next.js static export
+```
+
 ## Chat With Atris 2
 
 `ax` is the Atris 2 chat and coding-agent CLI. It uses the hosted Atris cloud by default, streams text, shows tool activity, and keeps fresh installs away from local setup.
@@ -237,7 +248,7 @@ atris business record atris/reports/2026-04-12-operator-recap.md --outcome mixed
 - `atris wiki --private` stores local-only sensitive notes under `.atris/presidio/`
 - `atris loop` refreshes `atris/wiki/STATUS.md` and `atris/wiki/log.md`, flags stale/orphan pages, and suggests the next ingest
 - `atris activate` loads the current wiki status so the next session starts with project memory, not just tasks
-- `atris member` keeps team-member identity and learning local-first: `MEMBER.md` is the role contract, `goals.json` is the machine-readable goal/experiment state, `goals.md` is the human readout, and `logs/YYYY-MM-DD.md` records what happened. Use `atris member goal`, `tick`, `status`, `block`, and `review --value 1..5` to test whether a member is making useful progress or needs the operator/orchestrator.
+- `atris member` keeps team-member identity and learning local-first: `MEMBER.md` is the role contract, `goals.json` is the machine-readable goal/experiment state, `goals.md` is the human readout, and `logs/YYYY-MM-DD.md` records what happened. Use `atris member goal`, `tick`, `status`, `block`, and `review <name> <experiment-id> --accept --proof "..." --value 1..5` to test whether a member is making useful progress or needs the operator/orchestrator.
 - `atris codex-goal` is the read-only bridge for native Codex `/goal`: `status` inspects the live goal database, while the legacy `reset` command now refuses every mutation. Active tasks continue in place; completed tasks retain their final goal, and new work or recurring monitors use a new dedicated Codex task.
 - `atris task` keeps durable local task state and append-only events for agents; `atris/TODO.md` is just a regenerated readable board. Run the loop with `atris task new`, `delegate "..." --to <owner>`, `next`, `say`, and `ready <id> --proof "..."`; human approval is `atris task accept <id>` (moves to Done, awards Career XP) or `revise <id> --note "..."`. Final task transitions also append the general daily log and, when a real `atris/team/<member>/MEMBER.md` matches the task owner, that member's daily log. Add `--json` for headless agents, `atris task serve` for the local board, and `atris task show <ref>` / `events --all` for the full ledger. Commands accept semantic refs (`OBL-18`), full IDs, or any unique prefix. In cloud business workspaces, Supabase `tasks` is the source of truth and Swarlo the live claim layer.
 - `atris mission` is the durable autonomy layer: start with an owner, verifier, runner, and stop condition; record bounded work with `mission tick`; close with `mission complete` only after proof. Runners include `manual`, `claude`, `atris2`, and `codex_goal`.

package/atris/skills/clawhub/member-runtime/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: member-runtime
-description: "Load and run MEMBER.md team members -- complete AI workers with persona, skills, tools, context, and a journal that learns over time. Use when you want to activate a team member, run 'be my chief of staff', or manage stateful AI workers."
+description: "Load and run MEMBER.md team members -- complete AI workers with persona, skills, tools, context, and a log that learns over time. Use when you want to activate a team member, run 'be my chief of staff', or manage stateful AI workers."
 version: 1.0.0
 tags:
   - ai-agents
@@ -12,7 +12,7 @@ tags:
 
 # Member Runtime
 
-This skill teaches you how to load and run MEMBER.md team members. A member is a skill that manages skills -- it bundles a persona, capabilities, tools, permissions, and a journal that gets smarter over time.
+This skill teaches you how to load and run MEMBER.md team members. A member is a skill that manages skills -- it bundles a persona, capabilities, tools, permissions, and a log that gets smarter over time.
 
 Format spec: https://github.com/atrislabs/member
 
@@ -26,7 +26,7 @@ team/{name}/
   skills/                # What they can do (SKILL.md files)
   context/               # What they know (domain knowledge)
   tools/                 # What they use (API docs, configs)
-  journal/               # What they've learned (grows over time)
+  logs/                  # What they've learned (grows over time)
 ```
 
 ## How to Load a Member
@@ -61,23 +61,23 @@ For each skill in the frontmatter `skills` list:
 
 Read all markdown files in `team/{name}/context/`. These are domain knowledge the member references while working -- playbooks, reference docs, default preferences. Load them into your working context.
 
-### 5. Read the journal
+### 5. Read the log
 
 This is what makes members stateful. Before doing anything:
 
 1. Search memory for past entries from this member: `memory_search("{member-name} preferences patterns")`
-2. Read today's and yesterday's memory files for recent journal entries
+2. Read today's and yesterday's memory files for recent log entries
 3. Read `MEMORY.md` for durable preferences this member has recorded
 
-If no journal entries exist (first run), proceed with defaults from `context/preferences.md`.
+If no log entries exist (first run), proceed with defaults from `context/preferences.md`.
 
 ### 6. Become the member
 
 Adopt the persona, workflow, and rules from the MEMBER.md body. You are now this member. Follow their workflow step by step. Respect their permissions -- if `can-send: false`, draft but don't send.
 
-### 7. Write the journal
+### 7. Write the log
 
-After completing the task, write a journal entry to `memory/YYYY-MM-DD.md`:
+After completing the task, write a log entry to `logs/YYYY-MM-DD.md`:
 
 ```markdown
 ## {member-name} - {date}
@@ -100,7 +100,7 @@ The member's `permissions` field declares intent. Enforce it:
 
 ## Multiple Members
 
-Users can install multiple members. Each has its own persona, skills, and journal entries in memory. When switching between members, load the new member's MEMBER.md fresh -- don't carry over the previous member's persona.
+Users can install multiple members. Each has its own persona, skills, and log entries. When switching between members, load the new member's MEMBER.md fresh -- don't carry over the previous member's persona.
 
 To list installed members: scan `team/` for MEMBER.md files and flat .md files.
 

package/atris/skills/create-member/SKILL.md

@@ -1,12 +1,6 @@
 ---
 name: create-member
 description: "Create and manage AI team members using the MEMBER.md format. Use when the user wants to define a new AI role, set up a team member, create an agent persona, or work with team/MEMBER.md files."
-version: 1.0.0
-tags:
-  - team
-  - member
-  - agent
-  - persona
 ---
 
 # Member Creator
@@ -25,13 +19,18 @@ Spec: https://github.com/atrislabs/member
 team/<name>/
 ├── MEMBER.md       REQUIRED  Persona + role + permissions
 ├── SOUL.md         REQUIRED  Identity, values, lessons — who the agent is
-├── skills/         OPTIONAL  SKILL.md files (capabilities)
+├── MISSION.md      REQUIRED  Durable purpose and goal-selection rule
+├── goals.json      REQUIRED  Machine-readable goal state
+├── goals.md        REQUIRED  Human-readable goal state
+├── logs/           REQUIRED  Dated continuity receipts
+│   └── YYYY-MM-DD.md
+├── skills/         REQUIRED  SKILL.md files (may start empty)
 │   └── <skill>/
 │       └── SKILL.md
-├── tools/          OPTIONAL  MCP servers, API docs, CLI docs
+├── tools/          REQUIRED  MCP servers, API docs, CLI docs (may start empty)
 │   ├── .mcp.json
 │   └── <tool>.md
-└── context/        OPTIONAL  Domain knowledge (markdown)
+└── context/        REQUIRED  Domain knowledge (may start empty)
     └── *.md
 ```
 
@@ -52,12 +51,16 @@ Ask the user:
 team/<name>/
 ├── MEMBER.md
 ├── SOUL.md
+├── MISSION.md
+├── goals.json
+├── goals.md
+├── logs/
 ├── skills/
 ├── tools/
 └── context/
 ```
 
-Use kebab-case for the name. Create all directories even if empty.
+Use kebab-case for the name. Create the full bundle in one operation, even when the directories and goal list start empty. Never overwrite existing identity, mission, goal, or log files while backfilling a member.
 
 ### Step 3: Write SOUL.md
 
@@ -167,15 +170,15 @@ Drop markdown files into `context/` with domain knowledge the member needs:
 
 No special format. Just markdown files the member references.
 
-## Flat File Format
+## Legacy Flat Files
 
-For simple members that just need a persona (no skills, tools, or context), use a flat file:
+Flat files are a legacy input only:
 
 ```
 team/<name>.md
 ```
 
-Same frontmatter, same format. Just no directory structure around it.
+Do not create new flat-file members. Upgrade an existing flat file with `atris member upgrade <name>` so it receives the complete directory bundle without losing its MEMBER.md content.
 
 ## Detection
 

package/atris/skills/design/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: design
 description: Frontend aesthetics policy. Use when building UI, components, landing pages, dashboards, or any frontend work. Prevents generic ai-generated look.
-version: 3.1.1
+version: 3.2.16
 allowed-tools: Read, Write, Edit, Bash, Glob
 tags:
   - design
@@ -45,7 +45,7 @@ Font alternatives: instead of Inter: Instrument Sans, Plus Jakarta Sans, Outfit.
 
 **Scroll:** never override native scroll. use "peeking" (show a few px of next section) instead of full-screen hero + scroll arrow.
 
-**Responsive:** mobile-first. touch targets 44x44px minimum. no text under 14px on mobile. no horizontal scroll. container queries over media queries for components. adapt, don't amputate.
+**Responsive:** mobile-first. touch targets 44x44px minimum. no text under 14px on mobile. no horizontal scroll. container queries over media queries for components. adapt, don't amputate. compact overlays clear the full measured header stack; never anchor them from a guessed single header height.
 
 **Accessibility:** 4.5:1 contrast for text, 3:1 for UI (WCAG AA). visible focus indicators always. semantic HTML. never use color alone as an indicator. keyboard nav with logical tab order.
 
@@ -57,7 +57,9 @@ Font alternatives: instead of Inter: Instrument Sans, Plus Jakarta Sans, Outfit.
 
 **Hierarchy:** 2-3 text levels max. don't mix 5 competing styles.
 
-**No all-caps. ever.** never use the `uppercase` tailwind class, `text-transform: uppercase`, or shout-cased copy on eyebrow labels, section headers, buttons, badges, or anywhere else. random capitalized text mid-page reads as average ai-generated slop. if you need a quiet eyebrow label, reach for a smaller size (`text-[11px]`) or a muted color, never caps. write labels in sentence case ("Active tasks", not "ACTIVE TASKS") and let copy render as authored.
+**No all-caps. ever.** never use the `uppercase` tailwind class, `text-transform: uppercase`, or shout-cased copy on labels, section headers, buttons, badges, or anywhere else. random capitalized text mid-page reads as average ai-generated slop. write labels in sentence case ("Active tasks", not "ACTIVE TASKS") and let copy render as authored.
+
+**No eyebrow metadata.** Do not place tiny index, category, status, or implementation-type strips above real content. If the name changes the next action, make it a readable heading. If it does not, remove it. Generator metadata belongs in machine contracts and inspectors, never on the product canvas.
 
 **Copy:** no em dashes (the character, U+2014) anywhere in UI copy. no hedge words, no hype adverbs (the "-lessly" family). plain sentences a human would type.
 
@@ -106,13 +108,33 @@ Every entry: id, rule, detector, status. A detector is a regex/command a gate ca
 | D5 | no pulsing status dots outside loading skeletons | pulse class scan outside loading/skeleton files | graduated (design-gate) |
 | D6 | no arbitrary hex in color utilities, use brand vars | hex-in-color-utility scan | graduated (design-gate) |
 | D7 | no em dashes in UI copy or prose | U+2014 scan | graduated (atris slop) |
-| D8 | no claude-beige backgrounds, no instrument serif as default | judgment | active |
+| D8 | no claude-beige backgrounds, no instrument serif as default | judgment | promoted |
 | D9 | fuzzy wish gets translated to craft vocabulary and echoed back before building | judgment | active |
 | D10 | measured tokens over vibes: new components start from a measured recipe (exact colors, spacing, radii, type from a proven source), never from scratch | judgment | active |
 | D11 | layout contracts, not dioramas: min-height over fixed height, fluid max-width over fixed px, every overflow reachable (scroll or +N more), stress-test with hostile content before shipping | judgment | active |
 | D12 | one accent moment per card: brand accent for the primary action only, gold for confidence/progress fills, green only for completed; everything else tonal | judgment | active |
 | D13 | motion is calm and eased: 120-300ms ease-out on opacity/transform only, loops match a measured source cadence, prefers-reduced-motion always freezes them | judgment | active |
 | D14 | compact selectors lead with the chosen name and a discriminating icon; remove redundant field labels and visible type explanations when icon, title, and accessible label carry them | judgment | active |
+| D15 | copy density on landing pages: hero lede one sentence, one sentence per feature card, one line per FAQ answer, legal in one short footer paragraph; a section paragraph past ~40 words gets cut or moved one click deep (Keshav 2026-09-01: "SO much blabber yap text. keep it clean") | `<p>` in landing html over 60 words flags; otherwise judgment | active |
+| D16 | verify mobile with real device emulation (Playwright iPhone profile, WebKit for iOS), never headless Chrome --window-size: Chrome floors the window at 500px wide and renders a fake layout (caught 2026-09-01: two "passing" screenshots hid a broken phone nav) | command scan for `--window-size=3` or `--window-size=4` in verify scripts | active |
+| D15 | first viewport restraint: one dominant idea, at most one secondary live region, and everything else behind progressive disclosure; reject permanent three-column cockpit density as default SaaS structure | judgment | active |
+| D16 | one alignment contract per component: wrapper, metadata, controls, and rendered content share the same width and inset source at every viewport | judgment | active |
+| D17 | responsive corrections must test every disclosed state immediately below, at, and above each breakpoint; a fixed bug cannot reappear when a panel opens or the container narrows | judgment | promoted |
+| D18 | no eyebrow metadata or tiny titles: important names become readable headings; indices, platform type names, and generator metadata stay off product surfaces | judgment | promoted |
+| D19 | bubbly flat UI means one generous rounded parent, flat content-rail rows, and circular controls with a real action or stable identity; never round every nested child | judgment | active |
+| D20 | compound controls own one visible focus shape on the outer geometry; a borderless child field may suppress its ring only when the parent provides `:focus-within` proof | judgment | active |
+| D21 | the reusable web component layer must match the product runtime: React and Next.js are canonical for Atris web; custom elements are compatibility code, never the source of truth | React field and function scan | graduated (component contract) |
+| D22 | every documented component prop must be proven with the standalone package stylesheet; demo-only CSS cannot be the hidden implementation of a public layout contract | standalone prop selector scan | graduated (component contract) |
+| D23 | an owner dashboard should begin as a project save state: current story, one resume action, active missions, and the responsible team; spatial world maps are earned later by real geography or dependency data | judgment | active |
+| D24 | `Since you left` is a learning and cleanup receipt, not a feature changelog: show what the system learned, removed, and carried forward so the human can stay present | judgment | active |
+| D25 | game-like dashboards use plain outcomes, visible stakes, and one obvious next action; invented quest names and internal loop language hide the work instead of clarifying it | judgment | active |
+| D26 | execution receipts read in causal order: inspect inputs, reason, change, then verify; never reverse the activity list or lead with the outcome | judgment | active |
+| D27 | in a compact composer, the send action must visibly dominate adjacent attachment and voice controls through size and accent while secondary controls remain full touch targets | judgment | active |
+| D28 | sibling icon controls on one composer rail share a single explicit frame and alignment anchor; glyph size alone must never determine their centers | judgment | active |
+| D29 | hide voice playback until its voice clears the product quality bar; a weak fallback control is worse than no control | judgment | active |
+| D30 | a floating rounded composer inherits the page canvas; never paint a full-width contrast band behind it unless that band is intentional chrome | judgment | active |
+| D31 | developer-only overlays stay off the product surface by default; any temporary visible launcher must have an immediate dismiss control | judgment | active |
+| D32 | before changing repeated UI copy, verify the operator's exact executable and surface; matching labels do not prove the installed app, dev app, header, and composer share one live path | judgment | active |
 
 Measured recipes live in the mimic studies: `~/arena/mimic-beautiful-ui/LESSONS.md` (18 AI-interface components with exact tokens) and its `remix.css` :root block (the portable Atris token sheet, coffee + paper themes). Start there before designing an agent surface.
 
@@ -154,3 +176,4 @@ This skill compounds or it dies. The contract, every frontend session:
 - Full policy: `atris/policies/atris-design.md`
 - Navigation: `atris/MAP.md`
 - Workflow: `atris/PERSONA.md`
+| D15 | marketing front pages: headline + one 2-line paragraph + buttons per section, card copy max 2 sentences, long artifacts live one click deep (Keshav 2026-08-31 "aggressive amounts of texts still", inspiration Oscar/Headway) | judgment | active |

package/atris/skills/engines/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: engines
-description: "Dispatch work to an installed terminal agent or named Atris engine profile. Supports Atris Fast, Claude, Codex, Cursor, Fable, Composer, Haiku, Devin, Grok, and Antigravity (agy). Triggers on: use codex, use cursor, use devin, use grok, use agy, use antigravity, use gemini, gemini session, use fable, use claude, use atris, engine, dispatch to, worker agent, second opinion build."
-version: 1.4.2
+description: "Dispatch work to an installed terminal agent or named Atris engine profile. Supports Atris Fast, Claude, Codex, Cursor, Fable, Composer, Haiku, Devin, Grok, Antigravity (agy), and opencode. Triggers on: use codex, use cursor, use devin, use grok, use agy, use antigravity, use gemini, gemini session, use fable, use claude, use opencode, use atris, engine, dispatch to, worker agent, second opinion build."
+version: 1.5.1
 tags:
   - engines
   - claude
@@ -15,13 +15,14 @@ tags:
   - agy
   - antigravity
   - gemini
+  - opencode
   - atris
   - orchestration
 ---
 
 # Engines — interchangeable terminal workers
 
-One contract, ten live profiles. The orchestrator writes a bounded task prompt, dispatches it to an engine, then **independently verifies, lands, and pushes** the result. Engines never self-certify.
+One contract, eleven live profiles. The orchestrator writes a bounded task prompt, dispatches it to an engine, then **independently verifies, lands, and pushes** the result. Engines never self-certify.
 
 ## three verbs
 
@@ -29,12 +30,30 @@ One contract, ten live profiles. The orchestrator writes a bounded task prompt,
 - build: `atris engine <name> <task-id>`
 - switch: `atris engine <name>`
 
-## Fable means Fable
+## FABLE: use the Atris profile
 
-Use `atris engine fable "<bounded question>"` for Fable's take. The canonical
-profile pins `claude-fable-5`, gives deep Fable asks ten minutes by default,
-and records the resolved model in the receipt. An explicit `--model` or
-`--timeout` still wins.
+FABLE is a canonical Atris CLI engine profile, not a model nickname. When the
+operator asks for Fable's take, opinion, critique, or second perspective, use:
+
+```bash
+atris engine fable "<bounded question>"
+```
+
+This routes through `lib/engine-ask.js`, which supplies the read-only preamble,
+bounded tools, plan permission mode, safe mode, no session persistence, live
+logs, a receipt, and engine-health classification. The CLI owns the underlying
+Claude invocation through the `fable` profile in `lib/runner-command.js`.
+
+Do not replace this with raw `claude -p` and call the result FABLE. Do not impose
+one global timeout either. Use the CLI default for bounded asks. For deep
+architecture work, repo-wide reviews, or evidence-heavy judgment, choose a
+deliberately longer `--timeout` based on the scope, up to the CLI limit, and keep
+waiting while FABLE is making progress. FABLE quality can require time; the
+timeout is a safety boundary, not a speed target.
+
+On failure, inspect the Atris receipt and report it plainly. Retry once with a
+larger bound only when the evidence shows the bound was too short. Never silently
+substitute raw Claude or another engine and call the result FABLE.
 
 ## Raw binary fallback and debugging
 
@@ -46,25 +65,28 @@ Raw spawns are not the default because they skip Atris receipts, watch, and coac
 | Claude | `claude -p "<prompt>"` | Uses the local Claude configuration. Add `--model opus` for maximum-depth review or `--model sonnet` for speed. |
 | Codex | `codex exec --dangerously-bypass-approvals-and-sandbox -o <result-file> "<prompt>"` (run from the target repo/worktree; read-only research: `--sandbox read-only`) | Headless, exits when done — run it as a tracked background Bash task like the other engines and completion auto-wakes the session. Final answer lands in the `-o` file. Verified live 2026-08-11. Outside a git repo add `--skip-git-repo-check` or it exits 1. ONE-SHOT SESSIONS (`claude -p` workers): run codex in the FOREGROUND and wait — a one-shot session never wakes again, so backgrounding strands the result (observed 2026-08-11). The old plugin path (`codex-companion.mjs task --background`) is deprecated for dispatch: its job store never notifies the session (a finished result sat unread overnight, 2026-08-10) |
 | Cursor | `cursor-agent --trust -p "<prompt>"` (run from the target repo) | Headless print mode; `--trust` required for non-interactive |
-| Fable | `claude -p "<prompt>" --model claude-fable-5` | Raw fallback only. Prefer `atris engine fable` so the model, longer timeout, live log, and receipt stay honest. |
+| Fable | `atris engine fable "<question>"` | Canonical read-only FABLE ask with guards, live log, receipt, and health tracking. Scale `--timeout` to the work when needed. |
 | Composer | `atris run "<objective>" --engine composer` | Fast navigator/executor profile routed through the installed `ax` binary. |
 | Haiku | `claude -p "<prompt>" --model claude-haiku-4-5` | Fast validation and bounded read-only checks. |
 | Devin | `devin -p --permission-mode dangerous -- "<prompt>"` (run from the target repo) | Default permission mode is read-only for writes — build work NEEDS `--permission-mode dangerous`, so only run it in an isolated worktree. Also `devin cloud` for sessions that outlive this machine. Supports `--model swe-1.7` |
 | Grok | `grok --always-approve -p "<prompt>"` (run from the target repo) | Headless single-turn via `-p`; default model grok-4.6. Very fast on lookups (~5-10s, reads MAP first). Great for quick second opinions; use `--best-of-n <N>` for tricky bounded builds. Uses grok.com login |
 | Antigravity | `agy --mode accept-edits --add-dir "$PWD" -p "<prompt>"` (run from the target repo) | `agy` executor profile; also answers to "gemini". **`--add-dir` is mandatory for writes** — without it agy edits its own scratch folder (`~/.gemini/antigravity-cli/scratch/`) and the project never changes, which looks like a silent failure (verified live 2026-08-28). Use `--mode plan --sandbox` for read-only review, `--model <id>` to pin a model, and `--dangerously-skip-permissions` if a build still stalls on an approval prompt. |
+| opencode | `opencode run "<prompt>"` (read-only ask: `opencode run --agent plan "<prompt>"`) | Headless print mode; exits when done. Pin a model with `-m provider/model`. Build work needs `--auto` to auto-approve permissions (dangerous: run in an isolated worktree). Verified live 2026-08-21, ~7s per plan-mode lookup. |
 
 Headless dispatch permissions (verified 2026-08-11): `codex exec`, `grok`, and `cursor-agent` are allowlisted in `~/.claude/settings.json` so fresh and one-shot sessions can dispatch without a human approval click. A cold session that gets "requires approval" on an engine command means that allowlist regressed.
 
 ## Picking an engine
 
 - **Atris Fast** — cheap bounded lookups, single-file facts, small verified edits, and high-volume fan-out.
-- **Claude / Fable** — deep review, synthesis, validation, and complex builds. Use Fable when judgment quality matters most.
+- **FABLE** — strongest judgment lane. Use the canonical Atris profile for deep review, synthesis, validation, and complex builds.
+- **Claude** — direct Claude profile when the operator names Claude rather than FABLE.
 - **Codex** — deep root-cause work, long autonomous builds, second-opinion diagnosis. Slowest; runs sandboxed.
 - **Cursor** — fast bounded edits and refactors in a single repo.
 - **Composer / Haiku** — fast, bounded navigation, edits, and validation where a max-tier model would be wasteful.
 - **Devin** — multi-step feature work; use `cloud` when the run should survive laptop sleep.
 - **Grok** - fastest frontier lookups and quick second opinions (grok-4.6, ~5-10s; reads MAP first); use `--best-of-n` for tricky bounded builds. Uses grok.com login.
 - **Antigravity / agy** — flexible executor work across Gemini, Claude, and GPT-OSS models; use `agy` as the canonical short name.
+- **opencode** — multi-provider executor in one CLI (Claude, GPT, Gemini, DeepSeek menus via `opencode models`); plan agent for read-only asks, `--auto` builds only inside an isolated worktree.
 - Parallel builds across repos: one engine job per repo, never two engines writing the same checkout.
 
 ## Models worth pinning (verified live 2026-08-15)
@@ -73,8 +95,7 @@ Each engine CLI can pin a specific model. Current best picks:
 
 | Engine | Flag | Best models today |
 |--------|------|-------------------|
-| Claude | `--model opus` | `opus` follows the local Claude alias; use an explicit model identifier for reproducibility |
-| Fable | `--model claude-fable-5` | Canonical Fable 5 route; `atris engine fable` pins it automatically |
+| Claude / Fable | `--model opus` | `opus` currently resolves to Opus 5; use the explicit Opus 4.8 identifier only for reproducibility |
 | Devin | `--model swe-1.7` | `swe-1.7` (free right now: use it as the volume executor for parallel bounded slices), `swe-1.7-lightning` for speed |
 | Cursor | `--model cursor-grok-4.6-xhigh` | `cursor-grok-4.6-xhigh` for second-opinion builds, `cursor-grok-4.6-high-fast` for quick pinned asks (answered in ~12s live 2026-08-12), `composer-2.5` for fast edits; parameterized Claude via `'claude-opus-4-8[effort=high]'`; `--list-models` shows the full menu |
 | Composer | `--engine composer` | `composer 2.5` through the Atris profile |
@@ -82,6 +103,7 @@ Each engine CLI can pin a specific model. Current best picks:
 | Grok | (default) | `grok-4.6` default (confirmed live 2026-08-12, ~5s lookup), `grok-4.5` still available via `-m` |
 | Codex | `-m <model>` | CLI default rides `~/.codex/config.toml`; pin with `-m` only when the task needs it |
 | Antigravity / agy | `--model <id>` | `gemini-3.7-flash-high` for speed, `gemini-3.1-pro-high` for depth, `claude-sonnet-4-6`, `claude-opus-4-6-thinking`, or `gpt-oss-120b-medium` |
+| opencode | `-m <provider/model>` | `opencode/big-pickle`, `opencode/gpt-5.2`, `opencode/claude-opus-4-8`; `opencode models` lists the live menu |
 | Atris Fast | (fixed) | api.atris.ai fast lane |
 
 Re-verify this table when a lab ships a new model: run each CLI's model-list command, smoke one lookup, and update the row. Free-tier windows (like swe-1.7 now) are the moment to fan out volume work.
@@ -97,6 +119,27 @@ Run `atris engine doctor`, then `atris engine --help`. The canonical profiles li
 
 ## Prompt contract (every dispatch)
 
+Before build, fetch and identify the configured remote default, compare the
+checkout to it, and preserve unrelated work. Record the base before editing.
+Use the existing feature packet and functional owner; link source task IDs
+across workspaces rather than copying a second plan. Load the relevant owner
+bundle once. Live `atris task` records are truth; TODO.md is a rendered view.
+
+If scouting, request at most 200 words naming the exact current mission,
+owner, engine/model, files, checks, and risks. Reject an answer about an old
+mission. Hand the accepted packet to the builder; reread only to resolve a
+named gap. Use raw task metadata and events for exact paths and instructions,
+never the simplified explanation. Verify requested models; never substitute
+silently. Existing user authorization covers execution within that scope;
+required plan review, CI, human-only acceptance, and deploy gates still apply.
+
+Review related finished changes as one batch in a fresh context. Reuse a
+review only while those bytes remain unchanged; changed bytes require
+revalidation. Run required checks before the existing delivery path. Inspect
+the actual final state: draft, queued, and merged are different outcomes.
+Record elapsed time, engine calls, retries, and exposed token usage. Unknown
+usage stays unknown; one pilot does not establish a speedup or perfect accuracy.
+
 1. Name the absolute repo path and tell the engine to `cd` there (Atris Fast scopes to the cwd it runs from — cd first, and name absolute paths in the prompt).
 2. Bound the slice: one task, explicit exit criteria, the verify command to run.
 3. Git rules: `git status` first; stage only own files; never revert others' changes; never destructive git; work on a branch `member/<name>-<slug>` or a worktree. (Atris Fast does not run git — for edit tasks the orchestrator commits after verifying.)

package/atris/skills/x-search/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: x-search
 description: "X/Twitter search via xAI Grok API. Use when user wants to search tweets, monitor topics, find viral posts, or run social listening. Costs 5 credits per search. Triggers on x search, tweet search, twitter search, social listening, revenue intel, viral tweets."
-version: 2.3.0
+version: 2.4.0
 tags:
   - x-search
   - social
@@ -23,17 +23,19 @@ login
     |
    stdout only unless --save
         |
-       rich ephemeral --> one apply next-step, no files
-       --save + rich --> brief + pack + one Apply
+       rich ephemeral --> one apply next-step, one inferred check + score: 0, then one youtube-search next-step, no files
+       thin ephemeral --> check: fill this, then one youtube-search next-step, no files
+       empty successful pull --> one next: atris youtube search " "
+       --save + rich --> brief + pack + one Apply, prove baseline score 0
        --save + thin --> refuse, no files, exit 2
     |
    stop
 ```
 
 1. Login: stored login, then `atris login --agent` if needed. Never paste tokens. Never `/auth/cli`.
-2. Search: `atris x-search "QUERY"`. Always billed (5 credits). Prints to stdout. Rich ephemeral prints one apply next-step and writes nothing. Empty or failed search refunds and writes nothing.
-3. `--save` only when you want a brief. Rich results (a number-with-units or a named mechanism) file the brief, mint `atris/experiments/x-search-<slug>/`, and write one Apply that names that pack and the keep rule. Thin `--save` prints `thin: no number or named mechanism. no brief.` and writes nothing.
-4. Stop. Thin, empty, or failed search does not print the ephemeral apply next-step.
+2. Search: `atris x-search "QUERY"`. Always billed (5 credits). Prints to stdout. Rich ephemeral prints one apply next-step, one inferred check plus `score: 0`, then one `next: atris youtube search "<query>"` (person mode uses `--name`), and writes nothing. Thin ephemeral prints `check: fill this` then that youtube-search next, and writes nothing. Empty successful pull (no tweets) prints one `next: atris youtube search " "`. Explicit refund or failed search writes nothing extra.
+3. `--save` only when you want a brief. Rich results (a number-with-units or a named mechanism) file the brief, mint `atris/experiments/x-search-<slug>/`, write one Apply that names that pack and the keep rule, and prove that fixture starts at score 0. Thin `--save` prints `thin: no number or named mechanism. no brief.` and writes nothing. `--save` does not print a youtube-search next-step.
+4. Stop. `--json`, explicit refund, or failed search does not print apply, check, score, or youtube-search next-step.
 
 ## Customer path (preferred)
 

package/atris/skills/youtube/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: youtube
 description: "YouTube discovery and learning. Get watch permalinks with atris youtube search QUERY (free, local ytsearch/yt-dlp). On 429 the CLI already retries; use cached rows if printed, else STOP. Never run --paid after a 429. --paid only when the user explicitly asked to buy permalinks (5 credits). After a URL is picked, atris youtube notes URL (free, ephemeral unless --save). atris youtube process only to store knowledge (5 credits). Never paste tokens. Never /auth/cli. Mint with atris login --agent from a stored login. Never summarize a video from model memory. Triggers on: youtube search, find videos, paid youtube search, any youtube.com or youtu.be link, youtube, video, watch this, notes on this."
-version: 2.12.0
+version: 2.16.0
 tags:
   - youtube
   - research
@@ -18,30 +18,57 @@ Hard path. Follow in order. Soft memory does not override this.
 ```
 search QUERY (free)
     |
+   rows --> rich: one failing check (score 0); thin: check: fill this
+        --> next: atris youtube teach <first-url>
+        --> --json stays quiet
+    |
    429 --> CLI already retried once
         --> cached rows printed? use them
         --> rate-limit sentence printed? STOP
              do not run --paid
     |
    pick a URL --> notes URL (free, ephemeral unless --save)
-    |                 rich ephemeral prints one apply next-step, no files
-    |                 --save files brief + pack-named apply when notes have a number or named mechanism; thin --save refuses
+    |                 rich ephemeral prints one apply next-step and one failing check (score 0), no files
+    |                 thin ephemeral prints check: fill this instead of inventing a check
+    |                 then next: atris youtube teach <same-url>
+    |                 --json stays quiet
+    |                 --save files brief + pack-named apply when notes have a number or named mechanism; a multi-url --save batch proves the first saved pack the same way single-url --save does; thin --save refuses
     |            or teach URL [--section N] (one chapter: claim numbers, named mechanisms, one check; free unless --save)
+    |                 a taught section that is not last prints next: recap TEXT or skip
+    |                 last section: rich ephemeral apply, failing check, and score 0, then next: atris youtube watch tick; save pack keep stays; no recap next
     |                 next --section refuses until recap/skip
+    |                 owed prints unpaid check; successful unlock prints next section command
+    |                 bare teach resumes owed, or prints a start command if nothing is owed
     |
    write one Apply (claimable) before process
     |
    store knowledge? --> process URL (5 credits)
+                    --> rich: one failing check (score 0); thin: check: fill this; --json stays quiet
+
+watch add --> next: atris youtube watch tick
+watch tick --> briefs new videos
+           --> if briefed: rich pack-named apply + failing measure.py (score 0), then next: experiments keep
+           -->            thin: check: fill this, then next: atris youtube teach <first-briefed-url>
+           --> 0 briefed, no channels: next: atris youtube watch add <channel-url-or-@handle>
+           --> 0 briefed, channels exist: next: atris youtube search " "
+
+digest --> files brief + claimable journal
+       --> rich: one pack-named apply + failing measure.py (score 0), then next: experiments keep
+       --> thin: check: fill this, then next: atris youtube watch tick
 
 --paid QUERY only if the user asked to buy permalinks
+    |
+   rows --> rich: one failing check (score 0); thin: check: fill this
+        --> next: atris youtube teach <first-url>
+        --> --json stays quiet
 login: atris login --agent from a stored login
 never paste tokens, never /auth/cli
 ```
 
-1. Get watch permalinks: `atris youtube search QUERY` (free).
+1. Get watch permalinks: `atris youtube search QUERY` (free). A rich hit prints one inferred check plus `score: 0`. A thin hit prints `check: fill this`. Then one next teach command.
 2. If 429: wait/retry is already in the CLI. If it prints cached rows, use those. If it prints `youtube rate-limited local search. do not use --paid as a fallback; retry later.`, STOP. Do not run `--paid`.
 3. `--paid` only when the user explicitly asked to buy permalinks. The CLI hard-refuses `--paid` when the free cache still has a fresh same-query hit.
-4. `atris youtube notes URL` after a URL is picked (free). Notes is ephemeral unless `--save`. Rich ephemeral prints one apply next-step and writes no files. Rich `--save` files the brief and mints `atris/experiments/notes-<id>/`; thin `--save` (no number-with-units and no named mechanism) refuses with no brief and exit 2. Do not auto `--paid`.
+4. `atris youtube notes URL` after a URL is picked (free). Notes is ephemeral unless `--save`. Rich ephemeral prints one apply next-step and one failing check (`score: 0`), then one `next: atris youtube teach <same-url>`, and writes no files. Thin ephemeral prints `check: fill this` instead of inventing a check. A playlist or multi-url batch does the same for the first successful item only. `--json` stays quiet on the check and the teach next-step. Rich `--save` files the brief, mints `atris/experiments/notes-<id>/`, writes one Apply, and prints `score: 0` only when that Apply starts failing. A rich multi-url `--save` batch proves that failing baseline for the first saved pack only; thin `--save` (no number-with-units and no named mechanism) refuses with no brief and exit 2. Do not auto `--paid`.
 5. Write one Apply (change + receipt) before `atris youtube process`. Process still requires a filled Apply (so you `--save` a rich brief, fill Apply, then process).
 6. Never paste tokens. Never `/auth/cli`. Mint with `atris login --agent` from a stored login.
 
@@ -75,7 +102,7 @@ atris youtube search "MCP agents" --limit 10
 atris youtube search "MCP agents" --json
 ```
 
-Uses `ytsearch` on PATH when present, else bundled `scripts/det/ytsearch`, else `yt-dlp --flat-playlist --print` with `ytsearchN:`. No credits. No `/agent/process_youtube` call.
+Uses `ytsearch` on PATH when present, else bundled `scripts/det/ytsearch`, else `yt-dlp --flat-playlist --print` with `ytsearchN:`. No credits. No `/agent/process_youtube` call. A rich hit prints one inferred check plus `score: 0`. A thin hit prints `check: fill this`. Then one next: `atris youtube teach <first-url>`. `--json` stays quiet.
 
 On 429 the CLI retries once, then serves `~/.atris/youtube-search-cache.json` if the same query is younger than one hour. If it prints the rate-limit sentence, stop. Do not run `--paid`.
 
@@ -88,15 +115,17 @@ atris youtube search --paid "MCP agents 2026"
 atris youtube search --paid "MCP agents" --limit 10
 ```
 
-Requires a stored login, then `atris login --agent`. The CLI mints a youtube-scope agent token from disk the same way as `atris youtube process` and `atris x-search`. Never `/auth/cli`. Never paste tokens. Prints `title | watch permalink` plus credits. Empty or failed searches refund.
+Requires a stored login, then `atris login --agent`. The CLI mints a youtube-scope agent token from disk the same way as `atris youtube process` and `atris x-search`. Never `/auth/cli`. Never paste tokens. Prints `title | watch permalink` plus credits. A rich hit prints one inferred check plus `score: 0`. A thin hit prints `check: fill this`. Then one next: `atris youtube teach <first-url>`. `--json` stays quiet. Empty or failed searches refund.
 
 Line contract:
 
 ```text
 title | channel | duration | views | upload_date | https://youtu.be/ID
+check: <inferred or fill this>
+next: atris youtube teach "<first-url>"
 ```
 
-`upload_date` is `YYYYMMDD` (or `NA`) so callers can apply a freshness gate (for example last 6 weeks). After the user picks a URL, run notes (free) or process (5 credits).
+`upload_date` is `YYYYMMDD` (or `NA`) so callers can apply a freshness gate (for example last 6 weeks). `--json` stays machine-quiet. After the user picks a URL, run notes (free) or process (5 credits).
 
 ---
 

package/atris/team/brainstormer/MEMBER.md

@@ -260,7 +260,7 @@ AFTER (Universal):
 
 When you finish a brainstorm session:
 1. Hand shaped ideas to the navigator (they create the tasks)
-2. Log to your journal at `atris/team/brainstormer/journal/YYYY-MM-DD.md`:
+2. Log at `atris/team/brainstormer/logs/YYYY-MM-DD.md`:
 
 ```markdown
 ## Brainstormer - Mon DD
@@ -271,7 +271,7 @@ When you finish a brainstorm session:
 **Pattern:** What you learned about the user's thinking style
 ```
 
-Your journal tracks how ideas evolve — the navigator reads it to understand context.
+Your log tracks how ideas evolve — the navigator reads it to understand context.
 
 ---
 

package/atris/team/executor/MEMBER.md

@@ -156,7 +156,7 @@ If you hit two errors on the same task, **stop**. Don't debug from polluted cont
 
 ## Task Management
 
-**TODO.md is the shared task board. Your journal is your memory.**
+**TODO.md is the shared task board. Your log is your memory.**
 
 When you pick up a task:
 1. Read `atris/TODO.md` — find the next unclaimed item in `## Backlog`
@@ -168,7 +168,7 @@ When you pick up a task:
    ```
 3. If a task is already claimed by someone else, skip it — take the next one
 4. When done, move it to `## Completed`
-5. Log to your journal at `atris/team/executor/journal/YYYY-MM-DD.md`:
+5. Log at `atris/team/executor/logs/YYYY-MM-DD.md`:
 
 ```markdown
 ## Executor - Mon DD
@@ -179,7 +179,7 @@ When you pick up a task:
 **Learned:** What you now know about the codebase
 ```
 
-Your journal compounds context. The next executor session reads your learnings and starts smarter.
+Your log compounds context. The next executor session reads your learnings and starts smarter.
 
 ---
 

package/atris/team/launcher/MEMBER.md

@@ -51,7 +51,7 @@ You are the launcher (the closer). Take validated work → document → capture
 1. Read completed task (what was built?)
 2. Extract learnings (patterns, decisions, gotchas)
 3. Update MAP.md with new file:line references
-4. Document in journal with timestamp
+4. Document in the log with timestamp
 5. Suggest publishing steps
 6. Celebrate!
 
@@ -125,12 +125,12 @@ Launch Checklist:
 
 ## Task Management
 
-**TODO.md is the shared task board. Your journal is your memory.**
+**TODO.md is the shared task board. Your log is your memory.**
 
 When you close out work:
 1. Verify completed tasks in `atris/TODO.md` are properly marked in `## Completed`
 2. Clean up any stale items the validator missed
-3. Log to your journal at `atris/team/launcher/journal/YYYY-MM-DD.md`:
+3. Log at `atris/team/launcher/logs/YYYY-MM-DD.md`:
 
 ```markdown
 ## Launcher - Mon DD
@@ -141,7 +141,7 @@ When you close out work:
 **Learned:** Patterns to reuse, gotchas to remember
 ```
 
-Your journal is the team's institutional memory. What you record here prevents repeating mistakes.
+Your log is the team's institutional memory. What you record here prevents repeating mistakes.
 
 ---
 

package/atris/team/navigator/MEMBER.md

@@ -190,12 +190,12 @@ Navigator creates validate.md with Status (v0 — planned) and Checks. The execu
 
 ## Task Management
 
-**TODO.md is the shared task board. Your journal is your memory.**
+**TODO.md is the shared task board. Your log is your memory.**
 
 When you create tasks:
 1. Write them to `atris/TODO.md` under `## Backlog` using format: `- **T#:** Description [explore|execute]`
 2. Each task: one job, clear exit condition, tagged `[explore]` or `[execute]`
-3. Log to your journal at `atris/team/navigator/journal/YYYY-MM-DD.md`:
+3. Log at `atris/team/navigator/logs/YYYY-MM-DD.md`:
 
 ```markdown
 ## Navigator - Mon DD
@@ -206,7 +206,7 @@ When you create tasks:
 **Pattern:** What you learned about the user's preferences
 ```
 
-Your journal is how you get smarter. Record what the user liked, what they pushed back on, what communication style works.
+Your log is how you get smarter. Record what the user liked, what they pushed back on, what communication style works.
 
 ---