@bonesofspring/ai-rules 0.2.23 → 0.2.24

package/presets/opencode/next/OPENCODE.md

@@ -0,0 +1,65 @@
+# Next.js stack — OpenCode agent team
+
+Short OpenCode entry. Native discovery: `.opencode/agents/`,
+`.opencode/skills/`, `.opencode/commands/`. Rule files under
+`.opencode/rules/*.md` are **not** auto-loaded.
+
+Root `AGENTS.md` is native always-on. Read it first, then this file.
+
+## How to load
+
+- Essential rules: Read immediately (paths below). Do not preload the catalog.
+- Other rules: lazy `Read` `.opencode/rules/<stem>.md` when the task matches.
+- Agents: native `@name` / Task from `.opencode/agents/`.
+- Commands: native `/task` from `.opencode/commands/`.
+- After a producer receipt, run `bash .opencode/hooks/chain-team-phases.sh`.
+  Agents must not write lifecycle fields in `status.json` / `metrics.json`.
+
+## Essential rules (read every turn)
+
+- `.opencode/rules/next-app-core.md`
+- `.opencode/rules/package-manager.md`
+- `.opencode/rules/code-quality-and-refactoring.md`
+- `.opencode/rules/ai-local-overlay.md`
+
+See `.opencode/rules/README.md` for the full catalog and loading strategy.
+
+**Platform docs:** published with the `@bonesofspring/ai-rules` package
+(`docs/OPENCODE.md`, `docs/OPENCODE-COMPATIBILITY.md`) — **not** copied into
+the consumer repo. Source: https://github.com/bonesofspring/ai-rules
+
+**Repo-root agents:** see [`AGENTS.md`](../../AGENTS.md) at the project root (cross-tool setup, commands, security, living conventions pointers).
+
+## Quick start
+
+| Task | Where to look |
+|------|----------------|
+| Any new work task | `/task` → `commands/task.md` + `agent-team-orchestrator.md` (+ `agent-team-intake.md` on-demand) |
+| New end-to-end feature | skill `feature-delivery` + `feature-delivery-workflow.md` |
+| Stack and layers | `next-app-core.md` |
+| Reference features | `reference-features.md` (fill paths in the repo) |
+| After code edits | `post-change-lint.md` (**requestable**, but required after edits; full gate — `build-verifier`) |
+| Code review MR | skill `code-review` + `code-review-mr.md` |
+| Security (auth/forms/env) | `security-next.md` + agent `security-reviewer` |
+| Validation before review | agent `build-verifier` |
+| Technical retro | `/technical-retro` + skill `technical-retro` |
+
+## When to use `/task`
+
+- Implementation, bugfix, migration, tests, MR review, CI fix — **prefer `/task`**.
+- Simple one-liner without architectural risk — may skip the pipeline if the user explicitly asks.
+- Questions «как работает X» (how does X work) — agent `codebase-analyzer` (explain-as-is) or answer without `/task`. <!-- i18n-keep: E4 -->
+
+## Pipeline routing
+
+Intent detection, profiles (`full` / `standard` / `light`), and default steps — **only** in `agents/task-router.md`. Schema and examples — `agents/README.md`.
+
+## Install
+
+```bash
+npx @bonesofspring/ai-rules init opencode --preset next
+```
+
+Copies rules, commands, agents, hooks, skills, team, `OPENCODE.md` →
+`.opencode/AGENTS.md`, `MCP.md`, `opencode.json` → project `opencode.json`
+(`mcp` merge), plus `REPO_AGENTS.md` → root `AGENTS.md`.

package/presets/opencode/next/README.md

@@ -0,0 +1,16 @@
+# Next.js preset (OpenCode)
+
+Sibling adapter derived from `presets/cursor/next`. Platform id `opencode`;
+runtime `opencode`. Consumer install root is `.opencode/` (native agents,
+skills, commands) plus root `AGENTS.md` and `opencode.json`.
+
+Mapping: `adapter-map.json`. Do not derive this tree from Claude.
+
+```bash
+npx @bonesofspring/ai-rules init opencode --preset next
+```
+
+`releasedStacks` currently lists **`next`** only.
+
+Omitted from this pilot: `BUGBOT.md`, `hooks.json`, hook examples, and
+unwired `guard-shell-command.sh`.

package/presets/opencode/next/REPO_AGENTS.md

@@ -0,0 +1,97 @@
+# 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`.
+
+When this OpenCode preset is installed, read `.opencode/AGENTS.md` on every
+turn. Do not write `~/.config/opencode/**`. Do not mutate
+`.opencode/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, 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.
+
+## OpenCode load map
+
+After install, also read:
+
+- `.opencode/AGENTS.md` — OpenCode load map, roles, and procedures
+- `.opencode/rules/next-app-core.md`
+- `.opencode/rules/package-manager.md`
+- `.opencode/rules/code-quality-and-refactoring.md`
+- `.opencode/rules/ai-local-overlay.md`
+
+Do **not** preload the full `.opencode/rules/` catalog. Native agents live in
+`.opencode/agents/`; skills in `.opencode/skills/`; slash commands in
+`.opencode/commands/` (`/task`). After a producer receipt run
+`bash .opencode/hooks/chain-team-phases.sh`.
+
+## 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.