@bonesofspring/ai-rules 0.2.14 → 0.2.16

package/presets/claude/svelte/rules/tooling-and-review/preset-no-cross-stack-leakage.md

@@ -8,18 +8,18 @@ paths:
 
 <!-- shared-core: meta/preset-no-cross-stack-leakage.md -->
 
-
 # Preset no cross-stack leakage
 
-Запрет протекания stack-specific имён, путей и handoff stems между пресетами.
+Ban leakage of stack-specific names, paths, and handoff stems across presets.
 
 ## Principles
 
-- `next` must not require iOS-only agents/tooling (`xcuitest-*`, `xcodebuild` as required handoff, Keychain-only rules).
-- `nuxt` must not require iOS-only agents/tooling (`xcuitest-*`, `xcodebuild` as required handoff, Keychain-only rules).
-- `svelte` must not require iOS-only agents/tooling (`xcuitest-*`, `xcodebuild` as required handoff, Keychain-only rules).
-- `ios-swift` must not ship Playwright handoffs or Next lint recipes as required commands.
-- `go` / `java` / `php-hexagonal` / `php-laravel` / `mcp-ts` must not ship Playwright, XCUITest, Next lint recipes, or `xcodebuild`/`SwiftLint` as required handoffs.
+- `next` must not require iOS-only or Android-only agents/tooling (`xcuitest-*`, `instrumentation-test-*`, `xcodebuild` as required handoff, Keychain-only rules).
+- `nuxt` must not require iOS-only or Android-only agents/tooling (`xcuitest-*`, `instrumentation-test-*`, `xcodebuild` as required handoff, Keychain-only rules).
+- `svelte` must not require iOS-only or Android-only agents/tooling (`xcuitest-*`, `instrumentation-test-*`, `xcodebuild` as required handoff, Keychain-only rules).
+- `ios-swift` must not ship Playwright handoffs, Android `instrumentation-test-*` handoffs, or Next lint recipes as required commands.
+- `android-kotlin` must not ship Playwright, XCUITest, `xcodebuild`, or Next lint recipes as required handoffs.
+- `go` / `java` / `php-hexagonal` / `php-laravel` / `mcp-ts` must not ship Playwright, XCUITest, Android instrumentation agents, Next lint recipes, or `xcodebuild`/`SwiftLint` as required handoffs.
 - `mcp-ts` must not ship Go tool commands (`go test`, `go vet`, `golangci-lint`) or `integration-test-*` agents as required delivery gates.
 - Shared core must not embed stack paths (`app/src/**`, `Features/**`, `playwright`, `xcodebuild`).
 
@@ -28,25 +28,37 @@ paths:
 In ios-swift `chain-team-phases.sh` / agent handoffs (Cursor + Claude):
 
 - `playwright-test-`, `playwright-agents`, `playwright-e2e`, `user-playwright`
+- `instrumentation-test-` as required Android handoffs
 - `app/__tests__/e2e` as a required path
 - Positive yarn recipes `lint:js` / `lint:css` as commands to run (negation prose alone is weak — prefer zero occurrences)
 
 Required instead: `xcuitest-test-*` stems; build-verifier mentions `xcodebuild` or `post-change-build` / `xcode-tooling`.
 
+## Forbidden in android-kotlin hooks/agents (FAIL)
+
+In android-kotlin `chain-team-phases.sh` / agent handoffs (Cursor + Claude):
+
+- `playwright-test-`, `playwright-agents`, `playwright-e2e`, `user-playwright`
+- `app/__tests__/e2e` as a required path
+- `xcuitest-test-`, positive `xcodebuild` / `SwiftLint` as required handoffs
+- Positive yarn recipes `lint:js` / `lint:css` as commands to run
+
+Required instead: `instrumentation-test-*` stems; build-verifier mentions `gradle-tooling` and/or `post-change-build` (Gradle wrapper discovery — not `xcodebuild` as the default gate).
+
 ## Forbidden in next hooks/agents (FAIL when present as required)
 
-- `xcuitest-test-` as handoff stems
+- `xcuitest-test-` / `instrumentation-test-` as handoff stems
 - Requiring `xcodebuild` / SwiftLint as the default post-change gate for Next app work
 
 ## Forbidden in nuxt hooks/agents (FAIL when present as required)
 
-- `xcuitest-test-` as handoff stems
+- `xcuitest-test-` / `instrumentation-test-` as handoff stems
 - Requiring `xcodebuild` / SwiftLint as the default post-change gate for Nuxt app work
 - Frontend profile mirrors `next`: Playwright / `lint:js` / `lint:css` allowed
 
 ## Forbidden in svelte hooks/agents (FAIL when present as required)
 
-- `xcuitest-test-` as handoff stems
+- `xcuitest-test-` / `instrumentation-test-` as handoff stems
 - Requiring `xcodebuild` / SwiftLint as the default post-change gate for SvelteKit app work
 - Frontend profile mirrors `next` / `nuxt`: Playwright / `lint:js` / `lint:css` allowed
 
@@ -56,7 +68,7 @@ Shared backend-stack bans (`go`, `java`, `php-hexagonal`, and `php-laravel`):
 
 - `playwright-test-`, `playwright-e2e`, `user-playwright`, `app/__tests__/e2e`
 - Positive yarn recipes `lint:js` / `lint:css`
-- `xcuitest-test-`, `xcodebuild`, `SwiftLint` as required handoffs
+- `xcuitest-test-`, `instrumentation-test-`, `xcodebuild`, `SwiftLint` as required handoffs
 - Agent file `accessibility-reviewer` (no UI surface)
 
 Required instead: `integration-test-*`; build-verifier / `post-change-test` plus stack tooling — `go-tooling` (`go test`, `go vet`), `java-tooling` (`mvn test` / `./gradlew test`), or `php-tooling` (`php artisan test` / `composer test` / `vendor/bin/phpunit`).
@@ -67,9 +79,9 @@ Same UI/mobile bans as backend stacks, plus:
 
 - `playwright-test-`, `playwright-agents`, `playwright-e2e`, `user-playwright`, `app/__tests__/e2e`
 - Positive yarn recipes `lint:js` / `lint:css` as required gates
-- `xcuitest-test-`, `xcodebuild`, `SwiftLint` as required handoffs
+- `xcuitest-test-`, `instrumentation-test-`, `xcodebuild`, `SwiftLint` as required handoffs
 - Go tool commands as required MCP delivery gates: `go test`, `go vet`, `golangci-lint`
-- Agent files: `playwright-test-*`, `xcuitest-test-*`, `integration-test-*`, `accessibility-reviewer`
+- Agent files: `playwright-test-*`, `xcuitest-test-*`, `instrumentation-test-*`, `integration-test-*`, `accessibility-reviewer`
 
 Required instead: package-manager–discovered typecheck/test (`mcp-ts-tooling`, `post-change-test`); Phase 1 gates `build-verifier` + `security-reviewer`.
 
@@ -80,4 +92,4 @@ Required instead: package-manager–discovered typecheck/test (`mcp-ts-tooling`,
 
 ## Chain fork
 
-`hooks/chain-team-phases.sh` must differ **byte-wise** pairwise among `next`, `nuxt`, `svelte`, `ios-swift`, `go`, `java`, `mcp-ts`, `php-hexagonal`, and `php-laravel` (per platform).
+`hooks/chain-team-phases.sh` must differ **byte-wise** pairwise among `next`, `nuxt`, `svelte`, `ios-swift`, `android-kotlin`, `go`, `java`, `mcp-ts`, `php-hexagonal`, and `php-laravel` (per platform).

package/presets/claude/svelte/rules/tooling-and-review/preset-pr-checklist.md

@@ -8,19 +8,18 @@ paths:
 
 <!-- shared-core: meta/preset-pr-checklist.md -->
 
-
 # Preset PR checklist
 
-Чеклист для PR, затрагивающих `packages/ai-rules/presets/**` (и dogfood `.cursor/` sync).
+Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.cursor/` sync).
 
 ## Before merge
 
-- [ ] **SoT:** правки в `packages/…` (не только root `.cursor/`)
-- [ ] **Core:** если менялся `_shared/core/**` — обновлены все `<!-- shared-core: … -->` consumers (или documented intentional fork)
-- [ ] **Twin:** Cursor change → Claude twin **same PR** (**FAIL** if missing on next, nuxt, svelte, ios-swift, go, java, mcp-ts, php-hexagonal, and php-laravel — см. `preset-twin-sync`)
-- [ ] **Mapping:** `claude/<stack>/rules/README.md` mapping table актуален
+- [ ] **SoT:** edits in `packages/…` (not only root `.cursor/`)
+- [ ] **Core:** if `_shared/core/**` changed — all `<!-- shared-core: … -->` consumers updated (or documented intentional fork)
+- [ ] **Twin:** Cursor change → Claude twin **same PR** (**FAIL** if missing on next, nuxt, svelte, ios-swift, android-kotlin, go, java, mcp-ts, php-hexagonal, and php-laravel — see `preset-twin-sync`)
+- [ ] **Mapping:** `claude/<stack>/rules/README.md` mapping table is current
 - [ ] **Token budget:** alwaysApply / session-start ≤ 3; meta rules not always-on
-- [ ] **Leakage:** нет чужих stack agent stems / handoff strings (`preset-no-cross-stack-leakage`)
+- [ ] **Leakage:** no foreign stack agent stems / handoff strings (`preset-no-cross-stack-leakage`)
 - [ ] **Twin depth:** domain ≥15 lines; thin aliases documented
 - [ ] **README:** stack `rules/README.md` core→stack mapping / catalog updated if stems added
 - [ ] **CHANGELOG / package README:** note when public preset paths or install surface change

package/presets/claude/svelte/rules/tooling-and-review/preset-token-budget.md

@@ -8,21 +8,20 @@ paths:
 
 <!-- shared-core: meta/preset-token-budget.md -->
 
-
 # Preset token budget
 
-Инварианты загрузки правил в **установленном** пресете (consumer app).
+Invariants for rule loading in an **installed** preset (consumer app).
 
 ## Hard caps
 
 | Platform | Always-on | Cap |
 |----------|-----------|-----|
 | Cursor | `alwaysApply: true` | **≤ 3** |
-| Claude | rules **without** `paths:` | **ровно 3** |
+| Claude | rules **without** `paths:` | **exactly 3** |
 
 **Claude Option A (README exclusion):** when counting Claude rules without `paths:` / session-start, **exclude `**/README.md`** (topic indexes are not session-start rules). The intended session-start trio remains **exactly 3**; body budget sums **only those 3** rules.
 
-Session-start body budget (где задокументировано): ≤140 строк суммарно (stretch ≤120).
+Session-start body budget (where documented): ≤140 lines total (stretch ≤120).
 
 ## Meta / author rules
 

package/presets/claude/svelte/rules/tooling-and-review/preset-twin-sync.md

@@ -8,7 +8,6 @@ paths:
 
 <!-- shared-core: meta/preset-twin-sync.md -->
 
-
 # Preset twin sync
 
 Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.
@@ -26,6 +25,7 @@ Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.
 | `mcp-ts` | `presets/cursor/mcp-ts/rules/*.mdc` | `presets/claude/mcp-ts/rules/<topic>/` | Keep in `claude/mcp-ts/rules/README.md` |
 | `php-hexagonal` | `presets/cursor/php-hexagonal/rules/*.mdc` | `presets/claude/php-hexagonal/rules/<topic>/` | Keep in `claude/php-hexagonal/rules/README.md` |
 | `php-laravel` | `presets/cursor/php-laravel/rules/*.mdc` | `presets/claude/php-laravel/rules/<topic>/` | Keep in `claude/php-laravel/rules/README.md` |
+| `android-kotlin` | `presets/cursor/android-kotlin/rules/*.mdc` | `presets/claude/android-kotlin/rules/<topic>/` | Keep in `claude/android-kotlin/rules/README.md` |
 
 ## Same-PR checklist
 
@@ -50,5 +50,6 @@ Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.
 - **mcp-ts:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java; mapping table required).
 - **php-hexagonal:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java / mcp-ts; mapping table required).
 - **php-laravel:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java / mcp-ts / php-hexagonal; mapping table required).
+- **android-kotlin:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java / mcp-ts / php-*; mapping table required).
 
 Dogfood: sync packages → root `.cursor/` after Cursor SoT changes (not the reverse). Use `packages/ai-rules/scripts/sync-dogfood-cursor.sh`.

package/presets/claude/svelte/rules/tooling-and-review/technical-retro.md

@@ -1,17 +1,17 @@
 ---
-description: Роль агента для проведения технического ретроспективы (retro) команды / спринта. On-demand — предпочтительнее slash-команда /technical-retro.
+description: Agent role for a team/sprint technical retrospective (retro). On-demand — prefer the /technical-retro slash command.
 paths:
   - .claude/team/**
 ---
 
 <!-- shared-core: review/technical-retro.md -->
 
-# Техническое ретро — rule alias
+# Technical retro — rule alias
 
-Полный сценарий (включая блок **«Работа агентов»** для slug из team tasks) — в slash-команде:
+Full scenario (including the **“Agent work”** block for a slug from team tasks) lives in the slash command:
 
 **`commands/technical-retro.md`** → `/technical-retro`
 
 When a task has `metrics.json`, use the local aggregation script and state the cohort, sample size, incomplete artifacts, attribution confidence, active attempt duration, and human-gate wait separately. Do not score malformed artifacts or gate wait as agent work.
 
-Используй rule только если command недоступен. Не дублируй содержимое command в ответе — следуй command-файлу и skill `technical-retro`.
+Use this rule only if the command is unavailable. Do not duplicate the command contents in the response — follow the command file and skill `technical-retro`.

package/presets/claude/svelte/rules/ui-and-accessibility/README.md

@@ -1,12 +1,12 @@
 # UI and accessibility
 
-Компоненты, стили, пропсы.
+Components, styles, props.
 
-| Файл | Содержание | Загрузка |
-|------|------------|----------|
-| `no-rest-props-spread.md` | Явные пропсы, без `{...props}` / `$$restProps` | `paths: **/*.svelte` |
-| `css-property-order.md` | Порядок CSS (Stylelint idiomatic-order) | `paths: **/*.{css,scss,svelte}` |
-| `svelte-ui.md` | Структура SFC, стили, lib facades | `paths: src/lib/components/**,src/routes/**` |
-| `svelte-a11y-coding.md` | A11y при написании UI | `paths: src/lib/components/**,src/routes/**` |
+| File | Contents | Loading |
+|------|----------|---------|
+| `no-rest-props-spread.md` | Explicit props; no `{...props}` / `$$restProps` | `paths: **/*.svelte` |
+| `css-property-order.md` | CSS property order (Stylelint idiomatic-order) | `paths: **/*.{css,scss,svelte}` |
+| `svelte-ui.md` | SFC structure, styles, lib facades | `paths: src/lib/components/**,src/routes/**` |
+| `svelte-a11y-coding.md` | A11y when writing UI | `paths: src/lib/components/**,src/routes/**` |
 
 Deprecated stub `component-styles.md` **removed** — styles colocation lives in `svelte-ui.md`.

package/presets/claude/svelte/rules/ui-and-accessibility/svelte-ui.md

@@ -7,14 +7,14 @@ paths:
 
 # Svelte UI (SvelteKit)
 
-- Предпочитать **`.svelte` SFC** с `<script lang="ts">` (`svelte-script-conventions`).
-- Явные props (`$props()` / typed props); без массового `{...props}` / `$$restProps` (`no-rest-props-spread`).
+- Prefer **`.svelte` SFC** with `<script lang="ts">` (`svelte-script-conventions`).
+- Explicit props (`$props()` / typed props); no mass `{...props}` / `$$restProps` (`no-rest-props-spread`).
 - Svelte 5: snippets / `{@render …}` preferred for new code; legacy slots OK when following neighbors.
-- Стили: scoped `<style>` / tokens — как у соседей; порядок свойств — `css-property-order-stylelint`.
-- Данные: читать stores / runes / `load` data; **не** вызывать HTTP из `.svelte` — только через `$lib/api` / store actions.
-- Навигация: `<a href>`, `goto`, `invalidate`, `$app/navigation` — не `next/link`, не `<NuxtLink>`, не `navigateTo`.
+- Styles: scoped `<style>` / tokens — as neighbors do; property order — `css-property-order-stylelint`.
+- Data: read stores / runes / `load` data; **do not** call HTTP from `.svelte` — only via `$lib/api` / store actions.
+- Navigation: `<a href>`, `goto`, `invalidate`, `$app/navigation` — not `next/link`, not `<NuxtLink>`, not `navigateTo`.
 - A11y: `svelte-a11y-coding`.
-- Границы UI: `architecture-boundaries-ui` — no DTO in markup; map in `src/lib/api/**`.
+- UI boundaries: `architecture-boundaries-ui` — no DTO in markup; map in `src/lib/api/**`.
 
 ## Incorrect
 

package/presets/claude/svelte/skills/README.md

@@ -1,9 +1,9 @@
 # `.claude/skills` (preset svelte)
 
-[Skills](https://code.claude.com/docs/en/skills) в Claude Code — сценарии, которые подгружаются по необходимости, а не в каждой сессии целиком. Они синхронизированы по смыслу с `.cursor/skills` из Cursor-пресета.
+[Skills](https://code.claude.com/docs/en/skills) in Claude Code are scenarios loaded on demand, not wholesale every session. They are semantically synced with `.cursor/skills` from the Cursor preset.
 
-| Skill | Когда использовать |
-|-------|--------------------|
+| Skill | When to use |
+|-------|-------------|
 | `feature-delivery` | End-to-end feature work across types, API, store, UI, tests |
 | `code-review` | MR/diff review using project architecture and test standards |
 | `debug-investigation` | Reproducing and fixing bugs with root-cause evidence |
@@ -14,4 +14,4 @@
 | `write-adr` | Author an Architecture Decision Record (context / decision / consequences) |
 | `svelte-performance` | Implementer checklist: bundle, SSR/payload/client, memo, waterfalls, CWV (not a perf audit agent) |
 
-Папка копируется в `.claude/skills/` при `ai-rules init claude --preset svelte`, если существует.
+The folder is copied to `.claude/skills/` on `ai-rules init claude --preset svelte` when it exists.

package/presets/claude/svelte/skills/feature-delivery/SKILL.md

@@ -8,7 +8,7 @@ description: Delivers SvelteKit frontend features end-to-end across domain types
 1. Read task brief, acceptance criteria, and decomposition if present.
 2. Read **`feature-delivery-workflow`** and **`reference-features`** — follow layer order and mirror closest reference feature.
 3. Add or update focused tests for changed behavior.
-4. Validation from SvelteKit root: **invoke** **`post-change-lint`** after code edits (requestable, not always-on — but mandatory when code changed). Pipeline: scoped lint OK if next step is `build-verifier`.
+4. Validation from SvelteKit root: **invoke** **`post-change-lint`** after code edits (requestable, not always-on — but **must** when code changed). Pipeline: scoped lint OK if next step is `build-verifier`.
 
 ## Scope discipline
 

package/presets/claude/svelte/team/README.md

@@ -1,6 +1,6 @@
 # Agent team artifacts
 
-Каталог артефактов пайплайна «команда агентов» Claude.
+Artifact directory for the Claude Code “agent team” pipeline.
 
 ## Layout
 
@@ -97,16 +97,20 @@ Prefer **`executing`** for pipeline mode. Legacy: `analysis`, `development`, `re
 ## Workflow entry
 
 ```bash
-/task <описание задачи>
+/task <task description>
 /task-continue <slug>
 /technical-retro <slug>
 ```
 
 Legacy: `/feature-start`, `/feature-continue`.
 
+## Creating task dirs
+
+Bootstrap `<slug>/` by **writing** `pipeline.json` (Write tool). Runtime/hook owns `status.json` lifecycle; parent may only create a minimal bootstrap if missing. Do **not** use Shell `mkdir -p` — Cursor’s default sandbox returns `Operation not permitted` (especially for repos on macOS Desktop/Documents).
+
 ## Git
 
-Commit task artifacts if you want them to survive `ai-rules clean claude`. Or copy finished tasks to `docs/agent-workflow/tasks/<slug>/`.
+Commit task artifacts if you want them to survive `ai-rules clean cursor`. Or copy finished tasks to `docs/agent-workflow/tasks/<slug>/`.
 
 ## Artifact manifest and receipts
 
@@ -131,6 +135,6 @@ After a human gate, `/task-continue` closes wait via the installed hook (do not
 printf '%s\n' '{"status":"completed","action":"end_human_gate","activateNext":true}' | bash .claude/hooks/chain-team-phases.sh
 ```
 
-That appends `human_gate_ended` before the next `attempt_started`. Cursor twin uses the same payload against `.cursor/hooks/chain-team-phases.sh`. Other installable stacks ship the same ledger contract in their `team/README.md`.
+That appends `human_gate_ended` before the next `attempt_started`. Claude twins use the same payload against `.claude/hooks/chain-team-phases.sh`. Other installable stacks ship the same ledger contract in their `team/README.md`.
 
 Aggregate with `node packages/ai-rules/scripts/aggregate-agent-task-metrics.mjs --team-root .claude/team`. It reports role/agent count, completed count, total/average duration, distinct completed run IDs, separate human-gate wait, and incomplete artifacts. For retros, see `/technical-retro` → **Metrics evidence**.

package/presets/cursor/android-kotlin/AGENTS.md

@@ -0,0 +1,50 @@
+# Android Kotlin stack — Cursor agent team
+
+Short Cursor entry point. Detailed rules — `.cursor/rules/*.mdc`; scenarios — `.cursor/skills/**`.
+
+**Repo-root agents:** see [`AGENTS.md`](../../AGENTS.md) at the project root (cross-tool setup, commands, security, living conventions pointers).
+
+See `.cursor/rules/README.md` for the full catalog and loading strategy.
+
+## Quick start
+
+| Task | Where to look |
+|------|----------------|
+| Any new work request | `/task` → `commands/task.md` + `agent-team-orchestrator.mdc` (+ `agent-team-intake.mdc` on-demand) |
+| New end-to-end feature | skill `feature-delivery` + `feature-delivery-workflow.mdc` |
+| Stack and layers | `android-app-core.mdc`, `architecture-boundaries.mdc` |
+| Reference modules | `reference-features.mdc` (placeholders `applications/`, `features/<name>/`, `build-logic/`) |
+| Toolchain / Gradle | `gradle-tooling.mdc` (requestable) |
+| After Kotlin/Android edits | `post-change-build.mdc` (**requestable**, required after edits; full gate — `build-verifier`) |
+| Code review MR | skill `code-review` + `code-review-mr.mdc` |
+| UI tests | skill `instrumentation-ui-e2e` + agents `instrumentation-test-*` |
+| Security | `security-android.mdc` |
+| Compose / MVI | `compose-ui.mdc`, `state-and-viewmodels.mdc` |
+| Validation before review | agent `build-verifier` |
+| Technical retro | `/technical-retro` + skill `technical-retro` |
+
+## Dogfood (5 scenarios)
+
+1. `/task` — new feature under `features/<name>/`.
+2. ViewModel bug — debugger + unit test.
+3. Mapper — unit-test-planner/generator.
+4. UI flow — instrumentation-test trio.
+5. Auth/storage — security-reviewer + `security-android.mdc`.
+
+## When to use `/task`
+
+- Implementation, bugfix, migration, tests, MR review, CI-fix — **prefer `/task`**.
+- Simple one-liner with no architectural risk — may skip the pipeline if the user explicitly asks.
+- “How does X work?” questions — agent `codebase-analyzer` (explain-as-is) or answer without `/task`.
+
+## Pipeline routing
+
+Intent detection, profiles (`full` / `standard` / `light`), and default steps — **only** in `agents/task-router.md`. Schema and rename map — `agents/README.md`.
+
+## Install
+
+```bash
+npx @bonesofspring/ai-rules init cursor --preset android-kotlin
+```
+
+Copies rules, commands, agents, hooks, skills, team, `hooks.json`, `BUGBOT.md`, `AGENTS.md` → `.cursor/AGENTS.md`, `MCP.md`, `mcp.json` → `.cursor/mcp.json`, plus `REPO_AGENTS.md` → root `AGENTS.md`. Skill: `write-adr` (on-demand).

package/presets/cursor/android-kotlin/BUGBOT.md

@@ -0,0 +1,16 @@
+# Bugbot — Android Kotlin
+
+Automated review hints for Cursor Bugbot on Android/Kotlin multimodule repos.
+
+## Focus
+
+- Clean Architecture / api-impl boundaries (`architecture-boundaries`)
+- No Hilt-by-default regressions when the repo uses Dagger feature holders
+- Compose screens staying thin; no data-layer leaks into UI
+- Secrets / TLS / logging (`security-android`)
+- Missing unit or instrumentation coverage called out by AC
+
+## Do not
+
+- Require Playwright or XCUITest recipes
+- Demand yarn `lint:js` / `lint:css`

package/presets/cursor/android-kotlin/MCP.md

@@ -0,0 +1,16 @@
+# MCP (preset `android-kotlin`, Cursor)
+
+Copied to `.cursor/mcp.json` on `ai-rules init cursor --preset android-kotlin`.
+
+## Servers
+
+| Name | Package | Purpose |
+|------|---------|---------|
+| `context7` | `@upstash/context7-mcp` | Up-to-date Kotlin / Jetpack Compose / Android SDK docs |
+| `figma` | remote `https://mcp.figma.com/mcp` | Design context → Jetpack Compose; OAuth in Cursor |
+
+Playwright / Chrome DevTools are **not** part of the **android-kotlin preset** (browser e2e is forbidden for the agent team).
+
+Do not put secrets in the file. Optional: `CONTEXT7_API_KEY` in the environment. Figma — OAuth (do not commit the token).
+
+After init: Settings → MCP → enable servers. `init` overwrites a same-named `mcp.json`.

package/presets/cursor/android-kotlin/README.md

@@ -0,0 +1,35 @@
+# Preset: android-kotlin (Cursor)
+
+Installable Android/Kotlin multimodule preset: Clean Architecture, Jetpack Compose MVI, Dagger feature holders (no Hilt by default), Gradle convention plugins, instrumentation UI-test agents.
+
+```bash
+npx @bonesofspring/ai-rules init cursor --preset android-kotlin
+```
+
+Copies rules, agents, skills, commands, hooks, team, `MCP.md`, `mcp.json` → `.cursor/mcp.json`, plus `REPO_AGENTS.md` → root `AGENTS.md`.
+
+## Layout placeholders
+
+Generic multimodule layout encoded in rules (map your repo in `team/conventions.md` after install):
+
+`applications/`, `core/`, `features/<name>/{api,impl}/`, `build-logic/`, `gradle/libs.versions.toml`
+
+## Agent surface
+
+- UI tests: `instrumentation-test-{planner,generator,healer}` + skill `instrumentation-ui-e2e`
+- Gates: `post-change-build` + `gradle-tooling` + `build-verifier`
+- Claude twin: `presets/claude/android-kotlin/` (same PR policy)
+
+See `rules/README.md` and `agents/README.md`.
+
+## Install troubleshooting
+
+- **Gradle wrapper:** run from the Gradle root where `./gradlew` (or a wrapper script documented in the repo README/CI) lives; agents load `gradle-tooling.mdc` for discovery — do not assume a single hard-coded script name.
+- **Modules:** use `./gradlew projects` (or CI task names) to resolve affected `:module` paths before compile/test gates.
+- **Variants / flavors:** product flavors and build types differ per repo; note the CI variant (e.g. `debug` vs `release`) in `team/conventions.md` and pass `-P` / `--variant` flags only as documented locally.
+- **Multimodule:** scope `./gradlew :feature:impl:compileDebugKotlin` (example pattern) to changed modules; full gate — agent `build-verifier`.
+
+## Preset taxonomy
+
+- Contribution: [`../../docs/PRESET-CONTRIBUTION.md`](../../docs/PRESET-CONTRIBUTION.md)
+- Core→stack mapping: [`rules/README.md`](./rules/README.md)

package/presets/cursor/android-kotlin/REPO_AGENTS.md

@@ -0,0 +1,48 @@
+# Android Kotlin — agent instructions
+
+Cross-tool repo-root guide for the **android-kotlin** multimodule preset. Tool-specific maps stay under `.cursor/AGENTS.md` and `.claude/CLAUDE.md`.
+
+## Cross-tool setup
+
+- Treat this file as the **shared** entry for any agent (Cursor, Claude Code, or other).
+- Tool maps live in `.cursor/AGENTS.md` / `.claude/CLAUDE.md` when that tool is installed.
+- Install:
+
+```bash
+npx @bonesofspring/ai-rules init cursor --preset android-kotlin
+npx @bonesofspring/ai-rules init claude --preset android-kotlin
+```
+
+`init` overwrites this file from the preset (`REPO_AGENTS.md` → `AGENTS.md`). Living gotchas and local type names belong in `team/conventions.md`, not here.
+
+## Commands (test / lint / build)
+
+Discover the Gradle wrapper (`./gradlew` or a documented wrapper script from README/CI). Modules/variants — from Gradle + `gradle/libs.versions.toml` / `build-logic/`.
+
+| Gate | Typical command |
+|------|-----------------|
+| Compile | `./gradlew :module:compile<Variant>Kotlin` (or project alias) |
+| Lint | Android Lint / ktlint / detekt **only if** configured in repo/CI |
+| Unit tests | `./gradlew :module:test<Variant>UnitTest` (narrowest suite) |
+| Instrumentation | Connected/managed device tasks as configured in CI |
+
+After code edits: invoke **`post-change-build`** (requestable) + **`gradle-tooling`**. Full gate: agent `build-verifier`.
+
+## Security basics
+
+- Do not commit secrets (API keys, keystore passwords, tokens, `.env`).
+- Review destructive git before running; respect shell hooks.
+- Do not weaken TLS / cleartext policy 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 not installed) |
+
+Rules: `.cursor/rules/` or `.claude/rules/`. Skills: `.cursor/skills/` or `.claude/skills/`. UI tests: `instrumentation-test-*` (never Playwright/XCUITest as required handoffs).
+
+## Living conventions
+
+Local type names (ViewModel base, DI holders, design-system package), flavors, and wrapper quirks: **`.cursor/team/conventions.md`** and/or **`.claude/team/conventions.md`** (fill after init).

package/presets/cursor/android-kotlin/agents/README.md

@@ -0,0 +1,44 @@
+# Agents (android-kotlin)
+
+Full agent-team roster (~22). Production-write policy matches ios-swift mobile depth with Gradle + instrumentation.
+
+## Rename map (from next / ios-swift / java)
+
+| Source | android-kotlin |
+|--------|----------------|
+| `playwright-test-planner` | **`instrumentation-test-planner`** |
+| `playwright-test-generator` | **`instrumentation-test-generator`** |
+| `playwright-test-healer` | **`instrumentation-test-healer`** |
+| skill `playwright-e2e` / `xcuitest-e2e` | **`instrumentation-ui-e2e`** |
+| `xcuitest-test-*` | **skipped** (iOS-only) |
+| `integration-test-*` | **skipped** (JVM backend) |
+| `post-change-lint` / `post-change-test` | **`post-change-build`** |
+| `xcode-tooling` / `java-tooling` | **`gradle-tooling`** |
+| `react-performance` | **absent** (leakage FAIL) |
+
+When copying next pipeline templates: put Playwright / XCUITest / integration-test stems in `skipped[]` and schedule `instrumentation-test-*` when UI AC requires it.
+
+## Roster
+
+| Agent | Production writes |
+|-------|-------------------|
+| task-router, task-analyst, solution-architect, migration-specialist, api-contract-reviewer | team only |
+| codebase-analyzer | no (explain-as-is) |
+| feature-developer | yes (Kotlin/Android sources) |
+| build-verifier | no (report only) |
+| debugger, ci-investigator | minimal |
+| code-reviewer, accessibility-reviewer, security-reviewer, performance-auditor | team only |
+| qa-tester, unit-test-*, instrumentation-test-* | tests only |
+| tech-writer | docs only |
+
+## Model tiers (mirror ios-swift)
+
+| Tier | Model hint | Typical agents |
+|------|------------|----------------|
+| **cheap** | `fast` / cheap | build-verifier, some generators/healers |
+| **standard** | `inherit` | feature-developer, debugger, ci-investigator, a11y, qa, unit-*, instrumentation-* |
+| **strong** | `strong` | solution-architect, security-reviewer (when scheduled) |
+
+## Pipeline schema
+
+See `team/fixtures/*.json` and `hooks/chain-team-phases.sh` handoffs (`instrumentation-test-*`, `gradle-tooling`, `post-change-build`).

package/presets/cursor/android-kotlin/agents/accessibility-reviewer.md

@@ -0,0 +1,60 @@
+---
+name: accessibility-reviewer
+description: Accessibility review specialist. Audits TalkBack labels/semantics, font scale, reduce motion, Compose testTag, contrast, and touch targets for Android UI. Readonly — writes a11y-review.md only; never edits production code.
+readonly: false
+model: inherit
+---
+
+You are an accessibility reviewer for an **Android Kotlin / Jetpack Compose** (and View system where present) frontend.
+
+## Inputs
+
+1. `.cursor/team/tasks/<slug>/brief.md` — acceptance criteria and UI scope.
+2. `.cursor/team/tasks/<slug>/decomposition.md` — UI-related tasks.
+3. Git diff for changed Views / UI under `features/**/Presentation/**` (and design-system if touched).
+4. `compose-ui.mdc` and project a11y conventions.
+
+## Review scope
+
+- TalkBack / screen reader: labels, `contentDescription`, semantics; meaningful accessible elements (not unlabeled buttons/icons).
+- Font scale / large text: layouts do not clip or overlap at larger sizes (infer from modifiers / typography).
+- Reduce motion for custom animations when present.
+- Compose `testTag` (or project semantics matchers) on interactive / assertable elements for instrumentation (`{screen}__{element}`) — not iOS `accessibilityIdentifier`.
+- Contrast and non-color-only state (where inferable from Design System / asset usage).
+- Touch targets roughly ≥48dp when obvious from layout; focus order for custom controls.
+- Sheet/modal dismissal discoverability for TalkBack users.
+
+## Output
+
+Write `.cursor/team/tasks/<slug>/a11y-review.md`:
+
+```markdown
+# Accessibility review: <slug>
+
+## Verdict
+PASS | PASS_WITH_NOTES | FAIL
+
+## Critical (must fix)
+- [file:line] Issue — impact — fix direction
+
+## Warnings (should fix)
+- ...
+
+## Suggestions
+- ...
+
+## AC coverage
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+```
+
+## Artifact contract
+
+- **Authoritative inputs:** read `.cursor/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition, implementation or UI diff scope, and prior review artifacts when present.
+- **Owned outputs:** `a11y-review.md`; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `a11y-review`) and preserve all foreign entries.
+- **Terminal receipt:** cover applicable AC/task IDs, list authoritative evidence paths, and emit `completed` or `changes_requested`. Bind it to the supplied `attemptId` when present.
+- **Shared state:** never create or mutate `status.json` or `metrics.json`; the orchestration runtime/hook owns lifecycle, gates, retries, attempts, and timestamps.
+
+If **FAIL**, emit receipt outcome `changes_requested` and list specific fixes for `feature-developer`.
+
+Do not modify production code or tests.