AGENTS.md git:20261018.3c08c5aA

Immutable. This exact content never changes and is served at /api/v1/blob/894de4f98ecd5645.

# AGENTS.md

## What this is

This repo is **WongStack**: an AI assistant and knowledge center a business owner and their team run their business on, shipped as a **template you clone and work from**. The [payload manifest](.agents/skills/wong-sync/references/payload-manifest.md) lists what ships. The [README](README.md) tells the user story.

This **meta-repo** ships WongStack *and* dogfoods it, so the block below applies here too. Don't run [`/wong-setup`](.agents/skills/wong-setup/SKILL.md) or [`/wong-sync`](.agents/skills/wong-sync/SKILL.md) here; both stop.

A payload edit loads [the release rules](.agents/rules/payload.md); the full process: [wiki/maintaining/](wiki/maintaining/README.md).

<!-- WONG-STACK:BEGIN — generic conventions, copied verbatim into each install: no repo-specifics. -->

## Where context lives

Before a change, **read the owning doc**: start at [`wiki/README.md`](wiki/README.md) and follow the links down. Four memory surfaces, one job each; no fact on two:

- `openspec/changes/<slug>/`: the plan and why it has this shape. Ships, then archives.
- The memory store, outside git: each session's facts. Superseded, never edited. A digest loads at session start ([convention](wiki/development/memory.md)).
- `wiki/`: repeatable knowledge ([philosophy](wiki/agent-knowledge-center.md), [style](wiki/wiki-style.md)). Canonical and curated; grows from use.
- `openspec/specs/` and the archive: what shipped, never changed.

Before substantial work, `memory.mjs recall <question>` finds [evidence](wiki/development/document-retrieval.md); read originals. Keep `areas <path>` for warnings and `openspec list` for plans.

Credentials for this computer's own tools sit in the git-ignored `.env` at the primary worktree, mapped by the committed, values-blank `.env.example`. For any business service, start with `node scripts/company-api.mjs services`, then `list --q`, `describe`, `call`: the app holds those keys. Don't stub a call or ask for a key in chat: declare a missing one, then [send the key link](wiki/development/secrets.md#receive-a-key-through-a-private-link).

## Rules

- **Do plain requests directly.** Research, errands, reminders, and questions need no verb; ask only for a needed answer. Repo edits end with *publish it?*: [the change loop](wiki/development/the-change-loop.md).
- **Offer a schedule or a mini app when a finished task will clearly come back**: they said it recurs, or memory shows they asked before. Offer once, in the closing question; remember a no: [offer a routine or an app](wiki/development/the-change-loop.md#offer-a-routine-or-an-app).
- **Keep messages short and plain**, in [our voice](wiki/voice.md): a few lines, more only if asked. Name git, OpenSpec, or CI only if the person asks or must act; keep code, commands, identifiers, and quotes exact. Plans, questions, and reports use [plain words](.agents/skills/explore/references/asking-the-user.md#write-in-plain-words) for everyone.
- **A person just asks to build or change code; you run the verbs** `/explore → /plan → /apply → /save → /ship`, plus `/continue`, `/close`, `/verify`, `/improve-code`, `/schedule`, and `/wong-sync`. Asked with no verb, stop at the plan and at the preview: [just ask](wiki/development/the-change-loop.md#just-ask). A verb also serves [work that changes no repo file](wiki/development/the-change-loop.md#verbs-for-any-work), with a confirm per outward action.
- **Print the plan's link whenever you make or change a plan**, above the closing question: [print the plan's link](.agents/skills/explore/references/asking-the-user.md#print-the-plans-link).
- **Build a new standalone page or tool as a mini app**: its own folders in the main app, served at `/apps/<name>/`, through the same loop: [mini apps](wiki/stack/mini-apps.md).
- **The WongStack skills own all git; OpenSpec never runs git.** `/apply` reads branch changes but makes none: [the change loop](wiki/development/the-change-loop.md).
- **CI is the gate when present, else PR review; a local check is only a pre-check**: [the gate](wiki/development/the-change-loop.md#the-gate).
- **Send an improvement upstream by hand**: [contributing](wiki/contributing.md).
- **A scheduled `/improve-code` writes a plan and waits**: [code improvement](wiki/development/repository-improvement.md).
- **Write repeatable knowledge to the wiki when you learn it**: what will help a different, future task, placed by [the wiki rules](wiki/wiki-style.md#repeatable-knowledge). A change's specifics stay in its proposal and archive.
- **Company actions and memory reads:** [discover only what you need](wiki/stack/service-catalogue.md) through the shared helper; company calls use employee login, memory keeps its installed access; [skills call actions](wiki/stack/company-api.md#build-a-skill-on-actions). Before using a key directly, read its notes page from `services`; add a call you worked out there.
- **API keys/tokens:** [human steps](wiki/development/secrets.md#api-token-website-steps); never browse.
- **Browse as the person; show key moments; ask for what needs them**: [logins](wiki/development/browsing.md#saved-browser-logins), [saving passwords](wiki/development/passwords.md), [pictures](wiki/development/browsing.md#show-what-the-browser-is-doing), [asking](wiki/development/browsing.md#when-a-step-needs-you), [buying](wiki/development/shopping.md).
- **Path-scoped conventions load from [`.claude/rules/`](.agents/rules/)**; an agent that doesn't auto-load them reads those whose `paths:` match its files.

<!-- WONG-STACK:END -->