@bonesofspring/ai-rules 0.2.22 → 0.2.24

package/presets/mavis/next/README.md

@@ -0,0 +1,15 @@
+# Next.js preset (Mavis)
+
+Sibling adapter derived from `presets/cursor/next`. Platform id `mavis`;
+runtime `mcode`. Consumer install root is `.mavis/` (ai-rules-owned).
+
+Mapping: `adapter-map.json`. Do not derive this tree from Claude.
+
+```bash
+npx @bonesofspring/ai-rules init mavis --preset next
+```
+
+`releasedStacks` currently lists **`next`** only. Other stacks ship in WP-F after the Next pilot human gate.
+
+Omitted from this pilot: `BUGBOT.md`, `hooks.json`, hook examples, and
+unwired `guard-shell-command.sh`.

package/presets/mavis/next/REPO_AGENTS.md

@@ -0,0 +1,96 @@
+# Next.js — agent instructions
+
+Cross-tool repo-root guide. Tool-specific maps stay under `.cursor/AGENTS.md`,
+`.claude/CLAUDE.md`, `.mavis/AGENTS.md`, and `.opencode/AGENTS.md`.
+
+**.mavis/** is an ai-rules-owned namespace, not a MiniMax-native discovery path.
+When this Mavis preset is installed, read `.mavis/AGENTS.md` on every turn.
+Do not write `~/.minimax/**`. Do not mutate
+`.mavis/team/tasks/<slug>/status.json` or `metrics.json` — the chain runner
+owns those files.
+
+## Cross-tool setup
+
+- Treat this file as the **shared** entry for any agent (Cursor, Claude Code,
+  Mavis / MiniMax Code, OpenCode, or other).
+- Install:
+
+```bash
+npx @bonesofspring/ai-rules init cursor --preset next
+npx @bonesofspring/ai-rules init claude --preset next
+npx @bonesofspring/ai-rules init mavis --preset next
+npx @bonesofspring/ai-rules init opencode --preset next
+```
+
+`init` overwrites this file from the preset (`REPO_AGENTS.md` → `AGENTS.md`).
+Living gotchas belong in `team/conventions.md`, not here.
+
+## Mavis compatibility entry
+
+After install, also read:
+
+- `.mavis/AGENTS.md` — Mavis load map, roles, and procedures
+- `.mavis/rules/next-app-core.md`
+- `.mavis/rules/package-manager.md`
+- `.mavis/rules/code-quality-and-refactoring.md`
+- `.mavis/rules/ai-local-overlay.md`
+
+Launch roles with `mcode exec --file .mavis/agents/<role>.md`. Start work with
+the task procedure in `.mavis/commands/task.md`.
+
+## Commands (test / lint / build)
+
+Working directory for app scripts: **`app/`**. Detect the package manager from
+lockfile / `packageManager` (`package-manager` rule).
+
+| Gate | Typical command |
+|------|-----------------|
+| Lint JS | `yarn lint:js` (or project equivalent) from `app/` |
+| Lint CSS | `yarn lint:css` from `app/` |
+| Unit tests | project unit script under `app/` |
+| Build | project `build` under `app/` |
+
+After code edits: invoke **`post-change-lint`** (requestable). Full gate: agent
+`build-verifier`.
+
+## Security basics
+
+- Do not commit secrets (`.env`, tokens, credentials).
+- Review destructive git (`reset --hard`, force-push) before running; respect
+  shell hooks.
+- Do not weaken CI or skip hooks unless the user explicitly asks.
+
+## Tool entry points
+
+| Tool | Map |
+|------|-----|
+| Cursor | `.cursor/AGENTS.md` (optional if Cursor not installed) |
+| Claude Code | `.claude/CLAUDE.md` (optional if Claude Code not installed) |
+| Mavis | `.mavis/AGENTS.md` (optional if Mavis not installed) |
+| OpenCode | `.opencode/AGENTS.md` (optional if OpenCode not installed) |
+
+Rules: `.cursor/rules/`, `.claude/rules/`, `.mavis/rules/`, or `.opencode/rules/`.
+Skills: `.cursor/skills/`, `.claude/skills/`, `.mavis/skills/`, or `.opencode/skills/`.
+
+## Living conventions
+
+Gotchas, local patterns, and team decisions:
+**`.cursor/team/conventions.md`**, **`.claude/team/conventions.md`**,
+**`.mavis/team/conventions.md`**, and/or **`.opencode/team/conventions.md`**
+(fill after init; not overwritten on every dogfood sync when already present).
+
+## Local overlay (`.ai.local/`) — MANDATORY
+
+A `.ai.local/` directory MAY exist at the repo root or at any nesting depth in
+monorepos. **All agents MUST read and apply it on every turn.** Rules there
+override preset rules; in conflicts, the local rule wins.
+`override: kill <preset-rule-name>` drops the named preset rule from the
+agent's context entirely.
+
+Plain markdown rules under `.ai.local/rules/*.md` are read by the agent with
+higher priority than preset rules. Living gotchas live in
+`.ai.local/conventions.md`.
+
+Authoring guide: `docs/LOCAL-OVERLAY.md` in the `@bonesofspring/ai-rules`
+package. The `ai-local-overlay` rule is the mechanism; this `MANDATORY`
+section is the reinforcement.