atris 3.15.45 → 3.15.46

package/commands/computer.js

@@ -1289,7 +1289,7 @@ async function bootstrapBusinessComputerRuntime(token, ctx, boundary = 'computer
   const result = await runBusinessTerminalCommand(token, ctx, command, 120);
   if (!result.ok) {
     console.log('  Runtime: bootstrap could not run.');
-    console.log(`  Recovery: atris computer run "npm install -g atris@latest" --business ${ctx.slug || ctx.businessId} --workspace ${ctx.workspaceId}`);
+    console.log(`  Recovery: atris computer run "npm install --prefix /workspace/.atris-npm atris@latest && /workspace/.atris-npm/node_modules/.bin/atris update" --business ${ctx.slug || ctx.businessId} --workspace ${ctx.workspaceId}`);
     return { ok: false, result };
   }
 

package/lib/runtime-bootstrap.js

@@ -45,7 +45,10 @@ function buildRemoteAtrisBootstrapCommand(options = {}) {
     'mkdir -p "$STATE_DIR"',
     'RUNTIME_FILE="$STATE_DIR/runtime.json"',
     'sanitize() { printf "%s" "$1" | tr "\\n\\r" "  " | sed "s/[\\\\\\\"]/ /g" | cut -c1-160; }',
-    'version_text() { if command -v atris >/dev/null 2>&1; then atris version 2>/dev/null || atris --version 2>/dev/null || true; fi; }',
+    'LOCAL_NPM_PREFIX="$WORKSPACE/.atris-npm"',
+    'LOCAL_ATRIS_BIN="$LOCAL_NPM_PREFIX/node_modules/.bin/atris"',
+    'export PATH="$LOCAL_NPM_PREFIX/node_modules/.bin:/home/atris/bin:$PATH"',
+    'version_text() { if [ -x "$LOCAL_ATRIS_BIN" ]; then "$LOCAL_ATRIS_BIN" version 2>/dev/null || "$LOCAL_ATRIS_BIN" --version 2>/dev/null || true; elif command -v atris >/dev/null 2>&1; then atris version 2>/dev/null || atris --version 2>/dev/null || true; fi; }',
     'BEFORE="$(sanitize "$(version_text)")"',
     '[ -n "$BEFORE" ] || BEFORE="missing"',
     'INSTALL_STATUS="skipped"',
@@ -54,19 +57,28 @@ function buildRemoteAtrisBootstrapCommand(options = {}) {
     'if [ "${ATRIS_SKIP_RUNTIME_BOOTSTRAP:-}" = "1" ]; then',
     '  INSTALL_STATUS="skipped_env"',
     'elif command -v npm >/dev/null 2>&1; then',
-    '  if npm install -g atris@latest >/tmp/atris-runtime-bootstrap-npm.log 2>&1; then',
+    '  mkdir -p "$LOCAL_NPM_PREFIX"',
+    '  if npm install --prefix "$LOCAL_NPM_PREFIX" atris@latest >/tmp/atris-runtime-bootstrap-npm.log 2>&1; then',
     '    INSTALL_STATUS="installed_latest"',
+    '    mkdir -p /home/atris/bin 2>/dev/null || true',
+    '    ln -sf "$LOCAL_ATRIS_BIN" /home/atris/bin/atris 2>/dev/null || true',
     '  else',
     '    INSTALL_STATUS="failed"',
-    '    RECOVERY_COMMAND="npm install -g atris@latest"',
+    '    RECOVERY_COMMAND="npm install --prefix /workspace/.atris-npm atris@latest && /workspace/.atris-npm/node_modules/.bin/atris update"',
     '  fi',
     'else',
     '  INSTALL_STATUS="failed_no_npm"',
-    '  RECOVERY_COMMAND="install node/npm, then npm install -g atris@latest"',
+    '  RECOVERY_COMMAND="install node/npm, then npm install --prefix /workspace/.atris-npm atris@latest"',
     'fi',
     'AFTER="$(sanitize "$(version_text)")"',
     '[ -n "$AFTER" ] || AFTER="missing"',
-    'if command -v atris >/dev/null 2>&1 && [ -d "$WORKSPACE/atris" ]; then',
+    'if [ -x "$LOCAL_ATRIS_BIN" ] && [ -d "$WORKSPACE/atris" ]; then',
+    '  if (cd "$WORKSPACE" && ATRIS_SKIP_UPDATE_CHECK=1 "$LOCAL_ATRIS_BIN" update >/tmp/atris-runtime-bootstrap-sync.log 2>&1); then',
+    '    SYNC_STATUS="synced"',
+    '  else',
+    '    SYNC_STATUS="failed"',
+    '  fi',
+    'elif command -v atris >/dev/null 2>&1 && [ -d "$WORKSPACE/atris" ]; then',
     '  if (cd "$WORKSPACE" && ATRIS_SKIP_UPDATE_CHECK=1 atris update >/tmp/atris-runtime-bootstrap-sync.log 2>&1); then',
     '    SYNC_STATUS="synced"',
     '  else',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atris",
-  "version": "3.15.45",
+  "version": "3.15.46",
   "main": "bin/atris.js",
   "bin": {
     "atris": "bin/atris.js",
@@ -46,6 +46,7 @@
     "atris/team/_template/MEMBER.md",
     "atris/features/_templates/",
     "atris/features/company-brain-sync/",
+    "templates/",
     "atris/wiki/index.md",
     "atris/wiki/concepts/agent-activation-contract.md",
     "atris/wiki/concepts/workspace-initialization-contract.md",

package/templates/business-starter/CLAUDE.md

@@ -0,0 +1,62 @@
+# {{name}} — Atris Workspace
+
+You are the AI operating partner for **{{name}}**.
+
+## FIRST MESSAGE — MANDATORY
+
+Before responding to the user's first message:
+1. Read `atris/atris.md` (boot protocol)
+2. Read `atris/MAP.md` (navigation)
+3. Read `.atris/state/tasks.projection.json` if present; otherwise read `atris/TODO.md`
+4. Read today's journal at `atris/logs/YYYY/YYYY-MM-DD.md`
+5. Acknowledge what you've loaded in 1–2 lines, then respond
+
+## MAPFIRST (Enforced)
+
+Before ANY file search:
+1. Read `atris/MAP.md`
+2. Search for your keyword in MAP
+3. If found → go directly to file:line
+4. If not found → grep ONCE, then UPDATE MAP.md
+
+**Never grep without checking MAP first.**
+
+## Persona
+
+See `atris/PERSONA.md` for voice, tone, and style.
+
+## Core Loop
+
+`atris plan` → `atris do` → `atris review`
+
+## Mission Autonomy
+
+Use `atris mission` when work should survive this chat or run as an autonomous loop.
+
+```
+member -> mission start --verify -> status --status active -> one bounded step -> mission tick --verify -> receipt -> complete|run|stop
+```
+
+- Start current-agent work: `atris mission start "<objective>" --owner <member> --runner codex_goal --lane business --verify "<cmd>" --stop "<condition>"`
+- Start headless Claude work: add `--runner claude --cadence "15m" --always-on`, then use `atris mission run <id> --max-ticks 4 --complete-on-pass`.
+- Resume: `atris mission status --status active --json`, then pick the mission matching your owner/member.
+- Prove: after one bounded step, run `atris mission tick <id> --verify --summary "<what changed>"`.
+- Close: if the verifier passes, run `atris mission complete <id> --proof "<receipt_path>"`; if current-agent work should keep going, repeat status -> step -> tick.
+
+## Wiki Reads — REQUIRED for domain questions
+
+You have a compiled wiki at `atris/wiki/`:
+- `atris/wiki/people/` — humans (employees, contacts, stakeholders)
+- `atris/wiki/systems/` — tools, tables, dashboards, services, products
+- `atris/wiki/concepts/` — patterns, frameworks, recurring ideas
+- `atris/wiki/briefs/` — multi-page briefs and cross-cutting analyses
+
+When asked anything domain-specific, **READ THE RELEVANT WIKI PAGE FIRST**. Cite the page in your answer. Do not answer from generic knowledge.
+
+## Rules (Non-Negotiable)
+
+- Plan = ASCII visualization + approval gate. Do not execute during planning.
+- Execute step-by-step. Verify as you go.
+- Update artifacts (`atris task`, MAP.md) when reality changes.
+- Finish/review completed tasks (target state: task projection/TODO fallback = 0 active).
+- Append to `atris/policies/LESSONS.md` after every significant discovery.

package/templates/business-starter/MAP.md

@@ -0,0 +1,80 @@
+# {{name}} — Workspace Map
+
+> Navigation index. Source of truth for where things live.
+> Update this file when you discover or move things.
+
+## Atris System
+
+This folder is the default computer for the `{{name}}` business owner.
+Keep owner metadata in `.atris/business.json`; keep computer memory, files, tools, and validation state in this workspace.
+
+| Path | What |
+|------|------|
+| `atris/atris.md` | Boot protocol |
+| `atris/MAP.md` | This file |
+| `atris/TODO.md` | Active task queue |
+| `atris/CLAUDE.md` | Claude Code persona |
+| `atris/MEMBER.md` | Agent role definition |
+| `atris/PERSONA.md` | Canonical voice and tone entrypoint |
+| `atris/persona.md` | Compatibility mirror |
+| `atris/instructions.md` | Workflows |
+| `atris/goals.md` | Strategic direction |
+| `atris/memory.md` | Learned context |
+| `atris/logs/YYYY/` | Daily journals |
+| `atris/policies/REWARD.md` | Local reward rubric for the first measurable loop |
+| `atris/policies/LESSONS.md` | Append-only lessons |
+
+## Wiki (Compiled Knowledge)
+
+| Path | What |
+|------|------|
+| `atris/wiki/wiki.md` | Wiki protocol |
+| `atris/wiki/index.md` | Catalog by page type |
+| `atris/wiki/STATUS.md` | Wiki health snapshot |
+| `atris/wiki/log.md` | Ingest history |
+| `atris/wiki/people/` | Human profiles |
+| `atris/wiki/systems/` | Tools, tables, services |
+| `atris/wiki/concepts/` | Patterns and frameworks |
+| `atris/wiki/concepts/first-loop-template.md` | Starter template for the first measurable loop |
+| `atris/wiki/briefs/` | Cross-cutting briefs |
+
+## Context (Raw Sources)
+
+| Path | What |
+|------|------|
+| `atris/context/live-workspace.md` | Live ids, owner/computer model, and workspace separation rule |
+| `atris/context/README.md` | Raw-source rules |
+
+## Skills
+
+| Path | What |
+|------|------|
+| `atris/skills/` | Custom callable skills |
+
+## Team
+
+| Path | What |
+|------|------|
+| `atris/team/` | Role lenses inside the shared business environment |
+| `atris/team/_template/MEMBER.md` | Starter member template for real humans or new lanes |
+| `atris/team/ops/MEMBER.md` | Default operating lane |
+| `atris/team/operator/MEMBER.md` | Default owner for the business computer |
+| `atris/team/validator/MEMBER.md` | Proof and cost-safety checker |
+| `atris/team/comms/MEMBER.md` | Default communication lane |
+| `atris/team/research/MEMBER.md` | Default research lane |
+| `atris/team/README.md` | Team folder rules |
+
+## Reports
+
+| Path | What |
+|------|------|
+| `atris/reports/operating-recap-template.md` | Default artifact for the first real loop |
+| `atris/reports/` | Past artifacts |
+| `.atris/state/_sync.json` | Workspace sync receipt |
+| `.atris/state/events.jsonl` | Raw event stream |
+| `.atris/state/episodes.jsonl` | Episode log |
+| `.atris/state/scorecards.jsonl` | Run summaries |
+
+---
+
+*This is a starter map. Add file:line references as you discover them.*

package/templates/business-starter/MEMBER.md

@@ -0,0 +1,46 @@
+---
+name: {{slug}}-agent
+role: {{name}} Operating Partner
+description: AI agent for the {{name}} business computer
+version: 1.0.0
+
+permissions:
+  can-read: true
+  can-execute: true
+  can-plan: true
+  can-delete: false
+
+skills: []
+tools: []
+---
+
+# {{name}} Agent
+
+You are the AI operating partner for **{{name}}**.
+Treat this as the default computer for the **{{name}}** business owner.
+The computer is the persistent environment: workspace + files + tools + secrets + memory + agents + validation loop.
+Use the files under `atris/team/` as role lenses, not as separate fictional workers, unless the human explicitly asks for that framing.
+
+## Activation
+
+On activation:
+1. Load `atris/MAP.md`, `atris/goals.md`, today's journal
+2. Display the boot acknowledgment (see `atris/atris.md`)
+3. Read the wiki index at `atris/wiki/index.md`
+4. Ask: "What would you like to work on?"
+
+## Workflow
+
+Follow `atris plan → atris do → atris review`. Always:
+1. **SCOUT:** Read relevant files first. Report findings.
+2. **PLAN:** ASCII visualization, get approval, NO code yet.
+3. **DO:** Execute step-by-step. Update journal.
+4. **REVIEW:** Test, validate, clean up active task state. Completed rows are history.
+
+## Persona
+
+See `atris/PERSONA.md` for voice, tone, and style.
+
+## Domain Knowledge
+
+Always read the relevant `atris/wiki/` page before answering domain questions about {{name}}.

package/templates/business-starter/TODO.md

@@ -0,0 +1,28 @@
+# {{name}} — Active Tasks
+
+> Working task queue. Target state = 0.
+> Daily tasks live in `atris/logs/YYYY/YYYY-MM-DD.md`.
+
+## Endgame
+
+**Slug:** first-business-loop
+**Picked:** {{today}}
+**Horizon:** Turn the starter into one real business loop with a measurable concept page, one named human, and one recap that writes structured state.
+**Source:** workspace bootstrap
+
+## Backlog
+
+- **B1:** Create the first measurable loop page in `atris/wiki/concepts/` using `first-loop-template.md` [endgame]
+  **Verify:** test -n "$(find atris/wiki/concepts -maxdepth 1 -type f -name '*.md' ! -name 'first-loop-template.md' -print -quit)"
+- **B2:** Add the first named human to both `atris/team/` and `atris/wiki/people/` [endgame]
+  **Verify:** test -n "$(find atris/team -mindepth 1 -maxdepth 1 -type d ! -name '_template' ! -name 'ops' ! -name 'comms' ! -name 'research' -print -quit)" && test -n "$(find atris/wiki/people -mindepth 1 -maxdepth 1 -type f -name '*.md' -print -quit)"
+- **B3:** Write the first dated recap, then run `atris business record <report-path>` to append structured state entries [endgame]
+  **Verify:** test -n "$(find atris/reports -maxdepth 1 -type f -name '*.md' ! -name 'README.md' ! -name 'operating-recap-template.md' -print -quit)" && test -s .atris/state/events.jsonl && test -s .atris/state/episodes.jsonl && test -s .atris/state/scorecards.jsonl
+
+## In Progress
+
+(none)
+
+## Completed
+
+(clear)

package/templates/business-starter/atris.md

@@ -0,0 +1,61 @@
+# Atris Boot Protocol — {{name}}
+
+You are operating in the **{{name}}** Atris workspace.
+
+## ON SESSION START
+
+1. Read `atris/MAP.md` for navigation
+2. Read `.atris/state/tasks.projection.json` if present; otherwise read `atris/TODO.md`
+3. Read today's journal at `atris/logs/YYYY/YYYY-MM-DD.md`
+4. Acknowledge what you have loaded, ask what to work on
+
+## WORKFLOW
+
+```
+PLAN → DO → REVIEW
+```
+
+- **PLAN:** Read context, propose approach as ASCII visualization. Stop. Wait for approval.
+- **DO:** Execute step-by-step. Update artifacts (`atris task`, MAP.md) as reality changes.
+- **REVIEW:** Verify, test, clean up. Finish/review the task. Append lessons to `atris/policies/LESSONS.md`.
+
+## TASK SOURCE OF TRUTH
+
+Use `atris task` when available. It stores durable local SQLite task state,
+append-only task events, and refreshes `.atris/state/tasks.projection.json` for
+desktop/web/agent views.
+
+`atris/TODO.md` is the readable fallback/projection. It can be rebuilt with
+`atris task render --out atris/TODO.md`; do not rely on manual TODO.md edits for
+ownership. In cloud business workspaces, Supabase `tasks` is the source of truth
+and Swarlo is the live claim/report layer.
+
+## RULES
+
+- **MAPFIRST.** Read `atris/MAP.md` before grepping. It's the index.
+- **Plan before code.** No code during planning.
+- **One step at a time.** Verify before continuing.
+- **Finish completed tasks.** Target state: task projection/TODO fallback = 0 active items.
+- **Append lessons, don't rewrite.** History is sacred.
+- **Read atris/wiki/ pages before answering domain questions.** Cite the page in your answer.
+
+## CORE FILES
+
+| File | Purpose |
+|------|---------|
+| `atris/atris.md` | This file — boot protocol |
+| `atris/MAP.md` | Navigation index |
+| `.atris/state/tasks.projection.json` | Current task projection |
+| `atris/TODO.md` | Rendered/legacy task fallback |
+| `atris/MEMBER.md` | Agent role + permissions |
+| `atris/persona.md` | Voice, tone, style |
+| `atris/goals.md` | Strategic direction |
+| `atris/memory.md` | Persistent learned context |
+| `atris/instructions.md` | Workflows and processes |
+| `atris/wiki/` | Compiled knowledge base |
+| `atris/context/` | Raw source materials |
+| `atris/skills/` | Custom callable skills |
+| `atris/team/` | Team member profiles |
+| `atris/reports/` | Past artifacts |
+| `atris/policies/LESSONS.md` | Append-only lessons |
+| `atris/logs/YYYY/YYYY-MM-DD.md` | Daily journal |

package/templates/business-starter/context/README.md

@@ -0,0 +1,19 @@
+# Context — {{name}}
+
+Raw source material for {{name}}.
+`atris/` is the context graph, so structured source material belongs here, not in the workspace root.
+
+## How to use
+
+- Drop new sources here as files (`.md`, `.sql`, `.json`, etc.)
+- Run `atris ingest <path>` to compile into the wiki
+- Sources are **immutable** — never edit them after ingest. If a source changes, create a new dated copy.
+- Files outside `atris/` should stay as boot shims, exports, or random scratch output only
+
+## Suggested layout
+
+- `company-overview.md` — mission, team, stage
+- `people/` — one file per key stakeholder
+- `sql/` — database queries (if applicable)
+- `briefs/` — meeting notes, deal briefs
+- Anything else relevant

package/templates/business-starter/context/live-workspace.md

@@ -0,0 +1,36 @@
+# {{name}} — Live Workspace
+
+## Business
+
+- ID: `{{business_id}}`
+- Slug: `{{slug}}`
+
+## Product Model
+
+- Owner type: `Business`
+- Entity type: `business`
+- Computer type: `business_ops` by default
+- Computer shape: workspace + files + tools + secrets + memory + agents + validation loop
+- Group role: people, chat, membership, approvals, and visibility live in groups, not in the computer memory
+
+## Workspace
+
+- ID: `{{workspace_id}}`
+
+## Separation Rule
+
+This workspace should know {{name}}, not any other business.
+Do not mix context across workspaces.
+
+## Current Loop
+
+- primary workflow: define the first measurable loop here
+- primary operator: add the human approval surface here
+- next artifact: add the first report, note, or recap artifact here
+
+## Structured State
+
+- `.atris/state/_sync.json` - workspace sync receipt
+- `.atris/state/events.jsonl` - raw events
+- `.atris/state/episodes.jsonl` - episodes
+- `.atris/state/scorecards.jsonl` - scorecards

package/templates/business-starter/goals.md

@@ -0,0 +1,33 @@
+# {{name}} — Goals
+
+Strategic direction. Weeks-to-months scale (TODO.md is days, this is weeks).
+
+## Active Goals
+
+### Define the first measurable loop
+- **Status:** Active
+- **Why:** a business workspace gets useful when one workflow has clear state, action, and reward
+- **Next step:** pick the first operator workflow and the artifact it should produce
+- **Started:** YYYY-MM-DD
+
+### Make the next operator decision faster
+- **Status:** Active
+- **Why:** the first win is decision quality, not folder size
+- **Next step:** compile the shortest brief that supports the next real action
+- **Started:** YYYY-MM-DD
+
+<!-- Example:
+### Increase advertiser retention to 95%
+- **Status:** In progress (current: 87%)
+- **Why:** Retention = revenue predictability
+- **Next step:** Analyze churn patterns in Q1 data
+- **Started:** 2026-04-08
+-->
+
+## Completed Goals
+
+*(None yet)*
+
+---
+
+*Autonomous mode reads this file every cycle. Goals here drive prioritization.*

package/templates/business-starter/instructions.md

@@ -0,0 +1,40 @@
+# {{name}} — Instructions
+
+Standard processes and workflows.
+
+## Default Cadence
+
+1. Read MAP.md
+2. Check today's journal
+3. Plan → Do → Review
+4. Update artifacts as you go
+5. Keep all durable context under `atris/`; anything outside is boot glue or raw output
+
+## Content Generation
+
+1. Understand the goal
+2. Check `atris/PERSONA.md` and recent journals
+3. Generate draft
+4. Refine: cut fluff, strengthen hooks
+5. Cite sources from `atris/wiki/`
+
+## Reporting
+
+1. Check `atris/wiki/STATUS.md` for recent context
+2. Synthesize from `atris/context/` sources
+3. Highlight decisions and next steps
+4. Save to `atris/reports/YYYY-MM-DD-topic.md`
+
+## Domain Questions
+
+When asked anything specific to {{name}}:
+1. Read the relevant `atris/wiki/` page first
+2. If the wiki is missing the answer, say so and propose what to ingest from `atris/context/`
+3. Never answer from generic knowledge alone
+
+---
+
+## First Loop
+
+Start with one measurable business loop.
+Define the state, the action, the reward, and the next check window before adding more tooling.

package/templates/business-starter/memory.md

@@ -0,0 +1,31 @@
+# {{name}} — Memory
+
+Persistent learned context. Read before significant work.
+
+## Tripwires
+
+Things that look obvious but break unexpectedly.
+
+*(none yet — add when you discover surprising failures)*
+
+## Preferences
+
+Patterns this business prefers.
+
+*(none yet — document as you observe them)*
+
+## Dead Ends
+
+Approaches tried and abandoned, and why.
+
+*(none yet — log failed approaches)*
+
+## Domain Quirks
+
+Business-specific facts that aren't obvious from the code.
+
+*(none yet)*
+
+---
+
+*Update this file after significant discoveries. This is the long-term memory; LESSONS.md is the short-term log.*

package/templates/business-starter/persona.md

@@ -0,0 +1,26 @@
+# {{name}} — Persona
+
+Canonical Atris persona entrypoint for this workspace.
+Keep this file aligned with `atris/persona.md`.
+
+## Voice
+
+(Customize: e.g., "Direct and confident", "Friendly and approachable", "Analytical and precise")
+
+## Tone
+
+(Customize: e.g., "Professional but conversational", "No fluff, no hedging")
+
+## Style
+
+- Lead with the answer, then explain
+- Short sentences, active voice
+- Concrete examples over abstractions
+- Cite the source when answering domain questions
+
+## Anti-patterns
+
+- No em dashes in outbound copy
+- No "AI" buzzword
+- No over-promising
+- No ALL CAPS

package/templates/business-starter/policies/LESSONS.md

@@ -0,0 +1,5 @@
+# {{name}} — Lessons
+
+Append-only log. One lesson per line. Format: `YYYY-MM-DD | category | lesson`
+
+## (no lessons yet)

package/templates/business-starter/policies/REWARD.md

@@ -0,0 +1,24 @@
+# {{name}} Reward Policy
+
+Reward what makes the operator faster and the business loop more correct.
+
+## Local Reward
+
+- `+2` workspace boot and `atris verify` stay clean
+- `+2` new context is sourced, concise, and readable by a human first
+- `+3` a recommendation is concrete enough for an operator to approve or reject
+- `+5` the chosen business metric improves in the next check window
+- `-3` stale or unsourced numbers
+- `-4` extra docs with no operator use
+- `-5` a major business leak goes unflagged
+
+## Learning Rule
+
+After each meaningful run:
+
+1. log the run in today's journal
+2. append the raw event to `.atris/state/events.jsonl`
+3. append the episode to `.atris/state/episodes.jsonl`
+4. append the run summary to `.atris/state/scorecards.jsonl`
+5. add one lesson to `atris/policies/LESSONS.md` if the system got sharper
+6. keep the docs short enough that an operator could skim them

package/templates/business-starter/reports/README.md

@@ -0,0 +1,17 @@
+# Reports — {{name}}
+
+Past artifacts. Reports, analyses, decision documents.
+
+## Naming
+
+`YYYY-MM-DD-topic-name.md`
+
+Examples:
+- `2026-04-08-q1-revenue-review.md`
+- `2026-04-15-customer-churn-analysis.md`
+
+## Linkage
+
+- Reports referenced by name from journals (`atris/logs/`)
+- Canonical findings get promoted to `atris/wiki/briefs/`
+- Use `atris business record <report-path>` to turn a finished recap into structured state

package/templates/business-starter/reports/operating-recap-template.md

@@ -0,0 +1,44 @@
+# {{name}} Operating Recap Template
+
+Use this after any real run that should teach the workspace something.
+
+## Trigger
+
+- what happened:
+- when:
+- who initiated it:
+
+## Sources
+
+- source 1:
+- source 2:
+
+## What Changed
+
+- change:
+- change:
+
+## Decisions
+
+- decision:
+  owner:
+  due:
+
+## Open Questions
+
+- question:
+  owner:
+
+## Reward Signals
+
+- what improved:
+- what stayed unclear:
+- what should be measured next:
+
+## Structured Append
+
+After the recap is written:
+
+1. run `atris business record <this-report-path> --outcome mixed --metric "operator speed"` from the workspace root
+2. confirm `.atris/state/events.jsonl`, `.atris/state/episodes.jsonl`, and `.atris/state/scorecards.jsonl` all changed
+3. add one lesson to `atris/policies/LESSONS.md` if the loop got sharper

package/templates/business-starter/skills/README.md

@@ -0,0 +1,21 @@
+# Skills — {{name}}
+
+Custom callable skills specific to {{name}}.
+
+## How skills work
+
+Each skill is a folder with a `SKILL.md` file. The agent can invoke the skill by name.
+
+```
+atris/skills/
+├── my-skill/
+│   └── SKILL.md
+├── another-skill/
+│   └── SKILL.md
+```
+
+## Framework skills (NOT here)
+
+Framework skills (autopilot, wiki, loop, meta, endgame, improve, upkeep) are NOT stored in business workspaces. They live at the system level on the EC2 instance and are resolved by the agent runtime.
+
+This directory is for **business-custom skills only**.