@bonesofspring/ai-rules 0.2.9 → 0.2.11

package/presets/claude/mcp-ts/skills/feature-delivery/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: feature-delivery
+description: Delivers TypeScript MCP server features end-to-end across contracts, schemas, handlers, registration, tests, and package validation. Use when implementing or extending a feature, especially through /task or feature-developer.
+---
+
+# Feature Delivery (mcp-ts)
+
+1. Read brief, AC, and decomposition.
+2. Follow `feature-delivery-workflow.mdc` + `reference-features.mdc`: contract → schema → handler → register → unit/contract tests → package validation.
+3. Keep transport/lifecycle in the entry module; tools stay in registration modules.
+4. After TS edits: **invoke** `post-change-test.mdc` (+ `mcp-ts-tooling.mdc`).
+
+## Do / Don't
+
+- **Do** Zod-first authoring with JSON Schema-compatible protocol contracts.
+- **Don't** invent SDK APIs; use VERIFY markers / Context7.
+- **Don't** use Playwright, XCUITest, Next lint, or Go tools as this stack's gate.
+
+## Scope discipline
+
+Implement only the current AC / decomposition task. See `feature-developer` → **Zero improvisation**.
+
+## Handoff
+
+Summarize by layer + validation. Update `.cursor/team/tasks/<slug>/status.json`.
+
+## Design guidance
+
+- Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.

package/presets/claude/mcp-ts/skills/unit-testing/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: unit-testing
+description: Plans and writes unit tests for MCP schemas and handlers using the repository test runner. Use for schema/handler coverage and fixing failing unit tests.
+---
+
+# Unit testing (mcp-ts)
+
+1. Prefer table-driven tests for schema reject/accept and handler outcomes.
+2. Fake FS/network capabilities — no live MCP client required for unit scope.
+3. Follow `tests-unit.mdc` and `mcp-contract-testing.mdc`.
+4. Discover runner via `mcp-ts-tooling` (Vitest/Jest/node:test).
+
+## Out of scope (Phase 1)
+
+- Dedicated `contract-test-*` agents (Phase 2).
+- Browser e2e (Playwright) — forbidden.

package/presets/claude/mcp-ts/team/README.md

@@ -0,0 +1,17 @@
+# Team artifacts (mcp-ts)
+
+| Path | Purpose |
+|------|---------|
+| `tasks/<slug>/` | Pipeline artifacts (`brief.md`, `status.json`, …) |
+| `fixtures/` | Example pipelines for dogfood |
+| `conventions.md` | Living gotchas (consumer-owned) |
+
+Phase 1 agents: see `agents/README.md`.
+
+## Fixture policy (Phase 1)
+
+`team/fixtures/*.json` may list in `skipped[]` **only** agents that exist in the Phase 1 roster:
+
+`task-router`, `task-analyst`, `solution-architect`, `feature-developer`, `build-verifier`, `security-reviewer`.
+
+Do **not** name Phase 2 agents (`contract-test-*`, `debugger`, Playwright stems, etc.) in fixture JSON — even as skips. Defer those until the agents ship.

package/presets/claude/mcp-ts/team/conventions.md

@@ -0,0 +1,14 @@
+# Team conventions (mcp-ts)
+
+Fill after init with living gotchas for this MCP server repo.
+
+## Suggested topics
+
+- Package manager + test/typecheck scripts actually used
+- SDK version pin and VERIFY notes
+- stdio entry / `bin` packaging
+- Capability allowlists (FS roots, outbound hosts)
+
+## Fixture policy
+
+Phase 1 fixtures: `skipped[]` may name only Phase 1 roster agents (see `team/README.md`).

package/presets/claude/mcp-ts/team/fixtures/bugfix-standard.json

@@ -0,0 +1,32 @@
+{
+  "slug": "example-schema-bugfix",
+  "intent": "bugfix",
+  "profile": "standard",
+  "summary": "Fix schema validation rejecting valid tool input",
+  "steps": [
+    {
+      "agent": "task-analyst",
+      "label": "Reproduce + AC"
+    },
+    {
+      "agent": "feature-developer",
+      "label": "Fix schema/handler + tests"
+    },
+    {
+      "agent": "build-verifier",
+      "label": "typecheck + tests"
+    }
+  ],
+  "humanGates": [],
+  "autoChain": true,
+  "skipped": [
+    {
+      "agent": "security-reviewer",
+      "reason": "Proven schema/style-only bugfix — no auth/**, secrets, or FS/net capability change (document skip; otherwise route security-reviewer)"
+    },
+    {
+      "agent": "solution-architect",
+      "reason": "Localized schema bugfix"
+    }
+  ]
+}

package/presets/claude/mcp-ts/team/fixtures/feature-full.json

@@ -0,0 +1,33 @@
+{
+  "slug": "example-add-tool-full",
+  "intent": "feature",
+  "profile": "full",
+  "summary": "Add MCP tool with schema, handler, registration, and tests",
+  "steps": [
+    {
+      "agent": "task-analyst",
+      "label": "Brief + decomposition"
+    },
+    {
+      "agent": "feature-developer",
+      "label": "contract→schema→handler→register→test→package"
+    },
+    {
+      "agent": "build-verifier",
+      "label": "typecheck + tests"
+    },
+    {
+      "agent": "security-reviewer",
+      "label": "Capability / secrets review",
+      "model": "strong"
+    }
+  ],
+  "humanGates": ["after:task-analyst"],
+  "autoChain": true,
+  "skipped": [
+    {
+      "agent": "solution-architect",
+      "reason": "Straightforward tool add; architecture spike not required"
+    }
+  ]
+}

package/presets/claude/mcp-ts/team/fixtures/feature-light.json

@@ -0,0 +1,34 @@
+{
+  "slug": "example-add-tool-light",
+  "intent": "feature",
+  "profile": "light",
+  "summary": "Add a single MCP tool with explicit AC",
+  "steps": [
+    {
+      "agent": "feature-developer",
+      "label": "Implement tool schema/handler/register",
+      "model": "cheap"
+    },
+    {
+      "agent": "build-verifier",
+      "label": "typecheck + tests",
+      "model": "cheap"
+    }
+  ],
+  "humanGates": [],
+  "autoChain": true,
+  "skipped": [
+    {
+      "agent": "task-analyst",
+      "reason": "Explicit AC and single-tool scope"
+    },
+    {
+      "agent": "security-reviewer",
+      "reason": "Light profile valid only with no FS/net/auth expansion — otherwise use standard/full and include security-reviewer"
+    },
+    {
+      "agent": "solution-architect",
+      "reason": "Light profile — no architecture spike"
+    }
+  ]
+}

package/presets/claude/next/agents/build-verifier.md

@@ -36,7 +36,7 @@ When validating **preset packaging** changes (paths under `packages/ai-rules/pre
 3. **Mapping / README:** `rules/README.md` must include a Cursor→Claude mapping table; document core→stack mapping when `_shared` consumers exist.
 4. **shared-core consumers:** if `_shared/core/**` changed, every file with matching `<!-- shared-core: … -->` in this PR must be updated (or intentional fork documented).
 5. **Twin presence:** Cursor rule change without Claude twin same PR → **FAIL** (next, ios-swift, go, and java). Domain twin body ≥15 lines; thin aliases may be shorter.
-6. **Session-start body budget:** sum body lines of the **3** intended session-start rules ≤ **120** (stretch ≤100); do **not** include `**/README.md` — record in validation-report; FAIL if grossly over.
+6. **Session-start body budget:** sum body lines of the **3** intended session-start rules ≤ **140** (stretch ≤120); do **not** include `**/README.md` — record in validation-report; FAIL if grossly over.
 7. **Embed drift (hard in `check:preset-structure`):** run `packages/ai-rules/scripts/check-shared-core-drift.sh` with `AI_RULES_DRIFT_FAIL=1` (bundled by the structure orchestrator). Lineage stems excluded from body equality.
 8. **Dogfood (monorepo soft):** prefer `packages/ai-rules/scripts/sync-dogfood-cursor.sh`; mass dogfood deletion without migration doc → risk / FAIL for maintainers.
 

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

@@ -17,7 +17,8 @@ paths:
 
 - `next` 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` must not ship Playwright, XCUITest, Next lint recipes, or `xcodebuild`/`SwiftLint` as required handoffs.
+- `go` / `java` / `mcp-ts` must not ship Playwright, XCUITest, 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`).
 
 ## Forbidden in ios-swift hooks/agents (FAIL)
@@ -46,6 +47,18 @@ Shared backend-stack bans (both `go` and `java`):
 
 Required instead: `integration-test-*`; build-verifier / `post-change-test` plus stack tooling — `go-tooling` (`go test`, `go vet`) or `java-tooling` (`mvn test` / `./gradlew test`).
 
+## Forbidden in mcp-ts hooks/agents (FAIL)
+
+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
+- Go tool commands as required MCP delivery gates: `go test`, `go vet`, `golangci-lint`
+- Agent files: `playwright-test-*`, `xcuitest-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`.
+
 ## Soft / document
 
 - Mentioning the other stack in **docs** comparing presets is OK.
@@ -53,4 +66,4 @@ Required instead: `integration-test-*`; build-verifier / `post-change-test` plus
 
 ## Chain fork
 
-`hooks/chain-team-phases.sh` must differ **byte-wise** pairwise among `next`, `ios-swift`, `go`, and `java` (per platform).
+`hooks/chain-team-phases.sh` must differ **byte-wise** pairwise among `next`, `ios-swift`, `go`, `java`, and `mcp-ts` (per platform).

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

@@ -22,7 +22,7 @@ paths:
 
 **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 (где задокументировано): ≤120 строк суммарно (stretch ≤100).
+Session-start body budget (где задокументировано): ≤140 строк суммарно (stretch ≤120).
 
 ## Meta / author rules
 

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

@@ -21,6 +21,7 @@ Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.
 | `ios-swift` | `presets/cursor/ios-swift/rules/*.mdc` | `presets/claude/ios-swift/rules/<topic>/` | Keep in `claude/ios-swift/rules/README.md` |
 | `go` | `presets/cursor/go/rules/*.mdc` | `presets/claude/go/rules/<topic>/` | Keep in `claude/go/rules/README.md` |
 | `java` | `presets/cursor/java/rules/*.mdc` | `presets/claude/java/rules/<topic>/` | Keep in `claude/java/rules/README.md` |
+| `mcp-ts` | `presets/cursor/mcp-ts/rules/*.mdc` | `presets/claude/mcp-ts/rules/<topic>/` | Keep in `claude/mcp-ts/rules/README.md` |
 
 ## Same-PR checklist
 
@@ -40,5 +41,6 @@ Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.
 - **ios-swift:** missing Claude twin for a changed Cursor rule → **FAIL**.
 - **go:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift; mapping table required).
 - **java:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go; mapping table required).
+- **mcp-ts:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java; 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/cursor/go/rules/README.md

@@ -8,13 +8,13 @@
 | `architecture-boundaries` | Hexagonal invariants |
 | `code-quality-and-refactoring` | Shared quality + Go notes |
 
-**Session-start body budget:** sum of the 3 always-on bodies ≤ **120** lines (stretch ≤100).
+**Session-start body budget:** sum of the 3 always-on bodies ≤ **140** lines (stretch ≤120).
 
 ## Twin depth (Cursor↔Claude)
 
 - **Domain** rules: target ≥15 non-empty body lines (FAIL soft when undocumented stubs).
 - **Thin aliases** (may be shorter): `agent-team-intake`, `technical-retro`.
-- **Documented stubs** (checklist-style, expand in consumer Stack notes / target repo): see Catalog **Depth** column (`stub`). High-traffic stems (`domain-layer`, `ports-interfaces`, `adapters-*`, `post-change-test`, `go-tooling`) are expanded to **full** depth.
+- **Documented stubs** (checklist-style, expand in consumer Stack notes / target repo): see Catalog **Depth** column (`stub`). High-traffic stems (`domain-layer`, `ports-interfaces`, `adapters-*`, `application-usecases`, `composition-root`, `persistence-adapters`, `tests-integration`, `security-go`, `post-change-test`, `go-tooling`) are expanded to **full** depth.
 
 ## Loading strategy
 
@@ -71,21 +71,21 @@ Claude twins + Cursor→Claude map: `presets/claude/go/rules/README.md`. Cross-s
 | `technical-retro` | thin-alias | |
 | `api-grpc` | stub | optional transport; expand when repo uses gRPC |
 | `domain-layer` | full | high-traffic hexagonal |
-| `application-usecases` | stub | |
+| `application-usecases` | full | use-case ports, Forbidden, unit via fakes |
 | `ports-interfaces` | full | high-traffic hexagonal |
 | `adapters-driven` | full | high-traffic hexagonal |
 | `adapters-driving` | full | high-traffic hexagonal |
-| `composition-root` | stub | |
+| `composition-root` | full | wire order, shutdown, construction smoke |
 | `api-http` | full | thin handlers, resilience, idempotency/bulkhead |
-| `persistence-adapters` | stub | |
+| `persistence-adapters` | full | port contract, no `*sql.DB` leak |
 | `messaging-adapters` | stub | |
 | `module-public-api` | stub | |
 | `go-conventions` | full | errors, interfaces at call site, anti-hallucination |
 | `go-tooling` | full | requestable toolchain |
 | `post-change-test` | full | requestable gate |
-| `security-go` | stub | |
+| `security-go` | full | redact, fail-closed auth, secret tests |
 | `tests-unit` | stub | |
-| `tests-integration` | stub | |
-| `tests-e2e` | stub | optional smoke; prefer integration-test-* |
+| `tests-integration` | full | repo contract vs httptest; isolation |
+| `tests-e2e` | stub | scoped smoke banner; prefer integration-test-* |
 
 **Всего topic `.mdc`:** 27 domain + 5 preset-meta (без README) = 32.

package/presets/cursor/go/rules/application-usecases.mdc

@@ -6,25 +6,29 @@ globs:
 alwaysApply: false
 ---
 
-
 # Application / use cases
 
 - One use case ≈ one application service method (command/query).
 - Depend on **outbound ports** (interfaces), not concrete repos/clients.
 - Orchestrate domain; transaction boundaries via ports (`UnitOfWork`) when needed — still no SQL here.
 - Accept `context.Context` on public methods; propagate to ports.
+- Input/output types stay in application or domain — never handler DTOs, `http.Request`, or SQL row types.
 
 ## Forbidden
 
-- Importing `adapters/*`, SQL drivers, HTTP frameworks.
-- Embedding `*sql.DB`, Redis clients, or handler types in use-case structs.
-- Business rules that belong in domain entities (keep use cases thin).
+- Importing `adapters/*`, SQL drivers, HTTP/gRPC frameworks, broker clients.
+- Embedding `*sql.DB`, Redis/Kafka clients, or handler types in use-case structs.
+- Business rules that belong in domain entities (keep use cases thin orchestrators).
+- Starting DB transactions with concrete `*sql.Tx` — call a port (`UnitOfWork` / `Transactional`).
 
 ## Structure
 
 - Prefer `application/<usecase>.go` + `ports.go` (or `ports/`) colocated.
 - Inbound port = interface the driving adapter calls (optional if use-case struct is the API).
+- Map transport/persistence errors at adapters; use cases return domain/application errors.
 
 ## Tests
 
-- Mock outbound ports; assert domain outcomes and port interactions — no real DB.
+- Fake/mock **outbound ports** only; assert domain outcomes and port interactions — no real DB.
+- Table-driven cases for validation/branching; inject clock/ID seams when time/IDs matter.
+- After edits: `post-change-test` (+ `go-tooling`).

package/presets/cursor/go/rules/architecture-boundaries.mdc

@@ -24,6 +24,12 @@ alwaysApply: true
 - Domain never imports adapters or frameworks.
 - Cross-feature access — only via public ports / `pkg` API, not deep imports of another feature's internals.
 
+# Edit bundles (load on matching paths)
+
+- `**/domain/**` → `domain-layer`; `**/application/**` → `application-usecases` + `ports-interfaces`
+- Driving HTTP/gRPC → `adapters-driving` + `api-http` / `api-grpc`; persistence/messaging → `adapters-driven` + matching `*-adapters`
+- `cmd/**`, `internal/app/**` → `composition-root`; after `*.go` edits → `post-change-test` (+ `go-tooling`)
+
 # Требование к агенту
 
 - Класть файлы в правильный слой; не «коротить» слои ради скорости.

package/presets/cursor/go/rules/composition-root.mdc

@@ -6,24 +6,29 @@ globs:
 alwaysApply: false
 ---
 
-
 # Composition root
 
-- Construct adapters, use cases, and servers in `cmd/<service>` and/or `internal/app`.
-- Wire interfaces to implementations explicitly (manual DI preferred unless repo already uses a container).
-- Load config once; fail fast on missing required settings.
-- Lifecycle: graceful shutdown via `context` cancel + server `Shutdown`.
+- Construct adapters → use cases → servers in `cmd/<service>` and/or `internal/app`.
+- Wire interfaces to implementations explicitly (manual DI preferred unless the repo already uses a container).
+- Load config once; **fail fast** on missing required settings before opening listeners or connections.
+- Lifecycle: cancel root `context` → drain in-flight work → `Shutdown` servers → close driven adapters (DB/pool/clients) in reverse wire order.
 
 ## Allowed here
 
-- Import all layers for wiring only.
-- Process-wide loggers/metrics providers.
+- Import all layers **for wiring only**.
+- Process-wide loggers/metrics providers constructed once and injected.
 
 ## Forbidden
 
 - Business rules, SQL queries, HTTP routing tables with domain logic.
-- Global mutable singletons for repos without clear init (prefer explicit deps).
+- Global mutable singletons for repos without clear init (prefer explicit constructor deps).
+- Starting background workers without tying them to the root context / shutdown path.
+
+## Agent handoffs
+
+- After wiring changes: `post-change-test` (+ `go-tooling`) — at least compile / construction smoke.
+- Layer checklist: `feature-delivery-workflow` (domain → ports → adapters → wire).
 
 ## Tests
 
-- Optional smoke that wiring builds (compile-time / construction test); heavy logic stays in unit/integration tests.
+- Optional construction/smoke test that `NewApp`/`main` wiring builds; heavy logic stays in unit/integration tests.

package/presets/cursor/go/rules/persistence-adapters.mdc

@@ -6,24 +6,27 @@ globs:
 alwaysApply: false
 ---
 
-
 # Persistence adapters
 
 - Implement outbound repository ports from application.
-- Use parameterized queries; map rows → domain entities inside the adapter.
+- Use **parameterized** queries; map rows → domain entities **inside** the adapter.
 - Transactions: expose via port (`Transactional`, `UnitOfWork`) implemented here — use cases call the port, not `*sql.Tx` directly.
-- Migrations live with infra (separate package/dir) — not in domain.
+- Migrations live with infra (separate package/dir) — not in domain or application.
 
 ## Mapping
 
 - Persistence models (db tags) stay private to the adapter package when possible.
-- Nullability and DB defaults converted to domain values explicitly.
+- Nullability, zero values, and DB defaults convert to domain values explicitly (no silent zero-value domain objects).
+- Port methods return domain/application errors — never leak driver-specific types through the port.
 
 ## Forbidden
 
-- Importing persistence from domain or leaking `*sql.DB` through port APIs.
-- Building SQL strings in use cases.
+- Importing persistence from domain or leaking `*sql.DB` / ORM handles through port APIs.
+- Building SQL strings in use cases or handlers.
+- Returning scan structs / `sql.Null*` types across the port boundary.
 
 ## Tests
 
-- Integration tests with testcontainers / test DB preferred for repos; unit-test mappers with fixtures.
+- Integration: repository **contract** round-trip (save → load → error/not-found) against testcontainers / repo-standard test DB.
+- Unit-test mappers with fixtures; do **not** substitute `httptest` for a repository contract.
+- Agents: `integration-test-{planner,generator,healer}` + skill `integration-testing`; then `post-change-test`.

package/presets/cursor/go/rules/preset-no-cross-stack-leakage.mdc

@@ -17,7 +17,8 @@ alwaysApply: false
 
 - `next` 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` must not ship Playwright, XCUITest, Next lint recipes, or `xcodebuild`/`SwiftLint` as required handoffs.
+- `go` / `java` / `mcp-ts` must not ship Playwright, XCUITest, 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`).
 
 ## Forbidden in ios-swift hooks/agents (FAIL)
@@ -46,6 +47,18 @@ Shared backend-stack bans (both `go` and `java`):
 
 Required instead: `integration-test-*`; build-verifier / `post-change-test` plus stack tooling — `go-tooling` (`go test`, `go vet`) or `java-tooling` (`mvn test` / `./gradlew test`).
 
+## Forbidden in mcp-ts hooks/agents (FAIL)
+
+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
+- Go tool commands as required MCP delivery gates: `go test`, `go vet`, `golangci-lint`
+- Agent files: `playwright-test-*`, `xcuitest-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`.
+
 ## Soft / document
 
 - Mentioning the other stack in **docs** comparing presets is OK.
@@ -53,4 +66,4 @@ Required instead: `integration-test-*`; build-verifier / `post-change-test` plus
 
 ## Chain fork
 
-`hooks/chain-team-phases.sh` must differ **byte-wise** pairwise among `next`, `ios-swift`, `go`, and `java` (per platform).
+`hooks/chain-team-phases.sh` must differ **byte-wise** pairwise among `next`, `ios-swift`, `go`, `java`, and `mcp-ts` (per platform).

package/presets/cursor/go/rules/preset-token-budget.mdc

@@ -22,7 +22,7 @@ alwaysApply: false
 
 **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 (где задокументировано): ≤120 строк суммарно (stretch ≤100).
+Session-start body budget (где задокументировано): ≤140 строк суммарно (stretch ≤120).
 
 ## Meta / author rules
 

package/presets/cursor/go/rules/preset-twin-sync.mdc

@@ -21,6 +21,7 @@ Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.
 | `ios-swift` | `presets/cursor/ios-swift/rules/*.mdc` | `presets/claude/ios-swift/rules/<topic>/` | Keep in `claude/ios-swift/rules/README.md` |
 | `go` | `presets/cursor/go/rules/*.mdc` | `presets/claude/go/rules/<topic>/` | Keep in `claude/go/rules/README.md` |
 | `java` | `presets/cursor/java/rules/*.mdc` | `presets/claude/java/rules/<topic>/` | Keep in `claude/java/rules/README.md` |
+| `mcp-ts` | `presets/cursor/mcp-ts/rules/*.mdc` | `presets/claude/mcp-ts/rules/<topic>/` | Keep in `claude/mcp-ts/rules/README.md` |
 
 ## Same-PR checklist
 
@@ -40,5 +41,6 @@ Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.
 - **ios-swift:** missing Claude twin for a changed Cursor rule → **FAIL**.
 - **go:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift; mapping table required).
 - **java:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go; mapping table required).
+- **mcp-ts:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java; 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/cursor/go/rules/security-go.mdc

@@ -7,17 +7,29 @@ globs:
 alwaysApply: false
 ---
 
-
 # Security (Go)
 
-- Secrets from env/secret manager — never commit keys; do not log tokens/passwords.
+- Secrets from env/secret manager — never commit keys; **never log** tokens, passwords, raw `Authorization` headers, or cookie values.
 - Validate and canonicalize untrusted input at the driving adapter edge.
 - Prefer prepared statements / parameterized queries in persistence adapters.
 - TLS and secure cookie/header defaults when exposing HTTP.
 - AuthN/AuthZ in middleware or driving adapters; pass identity into use cases as domain value (user ID / claims), not raw headers.
-- Minimize PII in logs; redact where needed.
+- Minimize PII in structured logs; redact known sensitive fields by default.
 
 ## Config
 
-- Distinguish public vs secret config fields in types.
-- Fail closed when auth is misconfigured in production builds.
+- Distinguish public vs secret config fields in types (separate structs or tagged fields).
+- **Fail closed** when auth is misconfigured in production builds (missing issuer/JWKS/secret → refuse to start or reject requests).
+- Sample configs and README snippets must use placeholders — never real-looking secrets.
+
+## Forbidden
+
+- Hardcoded API keys/tokens in source or committed `.env` examples with live values.
+- Logging request/response bodies that may contain credentials without an explicit redact step.
+- Fail-open auth middleware when required validators are nil/empty in prod.
+
+## Tests
+
+- Negative assertions: logs/metrics fixtures must not contain bearer tokens or secret config values.
+- Missing/invalid auth config fails closed in a construction or middleware test.
+- Agents: `security-reviewer` on auth/config/logging changes; then `post-change-test`.

package/presets/cursor/go/rules/tests-e2e.mdc

@@ -6,14 +6,16 @@ globs:
 alwaysApply: false
 ---
 
-
 # E2E / HTTP smoke
 
-- Black-box against a running server (httptest with full composition root, or localhost in CI).
-- Cover critical paths only; prefer integration + unit for breadth.
-- Stable test data; avoid depending on wall-clock flakiness.
-- Do not use browser/Playwright tooling in this preset.
+> **Documented stub / scoped smoke:** Prefer `tests-integration` + `integration-test-*` for breadth. Expand this rule only when the consumer repo keeps a dedicated black-box smoke suite.
+
+- Black-box against a running server (`httptest` with full composition root, or localhost in CI).
+- Cover critical paths only; prefer integration + unit for most coverage.
+- Stable test data; avoid wall-clock flakiness and shared mutable fixtures.
+- Do **not** use browser/Playwright tooling in this preset (`preset-no-cross-stack-leakage`).
 
 ## Placement
 
-- `e2e/` package or `*_e2e_test.go` with build tags if needed.
+- `e2e/` package or `*_e2e_test.go` with build tags if the repo already separates smoke CI.
+- If smoke overlaps repository contracts, put the contract under `tests-integration` instead.

package/presets/cursor/go/rules/tests-integration.mdc

@@ -6,19 +6,25 @@ globs:
 alwaysApply: false
 ---
 
-
 # Integration tests
 
 - Exercise driven adapters against real infra doubles (testcontainers, docker compose test DB, miniredis, etc.).
 - Or exercise HTTP adapter with `httptest` + wired use case + fake/real ports — still no full prod cluster required.
-- Build tags (`//go:build integration`) if the repo separates CI jobs.
-- Keep fixtures deterministic; clean up data between tests.
+- Build tags (`//go:build integration`) when the repo separates CI jobs — discover the existing CI entrypoint; do not invent a second runner.
+- Keep fixtures deterministic; clean up / isolate data between tests (truncate, transaction rollback, or unique prefixes).
 
 ## Scope
 
-- Contract of a port implementation (repo save/load roundtrip).
-- Not a substitute for domain unit tests.
+- **Contract of a port implementation** (repo save/load/error round-trip) — assert semantics at the port, not only SQL rows.
+- HTTP adapter contract with `httptest` is valid **adapter** integration — it is **not** a substitute for a repository contract test.
+- Not a substitute for domain unit tests (table-driven domain logic stays in `tests-unit`).
+
+## Forbidden shortcuts
+
+- Fake-only “integration” that never crosses the adapter↔infra boundary for the port under test.
+- Skipping isolation so tests pass only in isolation or only on a dirty DB.
 
 ## Agents
 
 - Planning/generation: `integration-test-{planner,generator,healer}` + skill `integration-testing`.
+- After green tests: `post-change-test` (+ `go-tooling`).

package/presets/cursor/ios-swift/agents/build-verifier.md

@@ -38,7 +38,7 @@ When validating **ios-swift preset** changes (or `scope: preset-structure-valida
 6. **Twin presence (hard):** Cursor rule change → Claude twin present **same PR** — **FAIL** if missing (next, ios-swift, go, and java).
 7. **Mapping / README:** `claude/ios-swift/rules/README.md` mapping table present; core→stack mapping documented when `_shared` consumers exist.
 8. **shared-core consumers:** if `_shared/core/**` changed, every matching `<!-- shared-core: … -->` consumer in this PR must be updated (or intentional fork documented).
-9. **Session-start body budget:** sum of the **3** intended always-on / session-start rule bodies ≤ **120** lines (stretch ≤100); do **not** include `**/README.md` — record in report.
+9. **Session-start body budget:** sum of the **3** intended always-on / session-start rule bodies ≤ **140** lines (stretch ≤120); do **not** include `**/README.md` — record in report.
 10. **Embed drift (hard in `check:preset-structure`):** `packages/ai-rules/scripts/check-shared-core-drift.sh` with `AI_RULES_DRIFT_FAIL=1`.
 11. **Dogfood (monorepo soft):** `packages/ai-rules/scripts/sync-dogfood-cursor.sh`; mass deletion without migration doc → risk / FAIL for maintainers.
 

package/presets/cursor/ios-swift/rules/README.md

@@ -13,7 +13,7 @@
 
 ### Пресет ios-swift — карта правил
 
-**alwaysApply budget:** **≤3** always-on правила и **≤120** строк тела (после YAML) суммарно (stretch ≤100). Новые alwaysApply только вместе с сокращением существующего бюджета.
+**alwaysApply budget:** **≤3** always-on правила и **≤140** строк тела (после YAML) суммарно (stretch ≤120). Новые alwaysApply только вместе с сокращением существующего бюджета.
 
 | Файл | Скоуп | Тема |
 |------|--------|------|