@manhd_d/ai-harness 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## Unreleased — Simpler onboarding
+- Consolidate first-use documentation into a one-command README and a copyable AI task; keep setup and model preferences optional.
+- Add docs/README.md for advanced guides and examples, preserving frontend/mobile onboarding and environment ownership from the latest main.
+- Verify documentation discovery through the index. No CLI, module or consumer schema changes.
+
+## Unreleased — Frontend/mobile coding and onboarding
+- Simplify init/host onboarding and surface current CLI flags in the command table.
+- Add focused React/Next.js feature/testing and React Native screen/testing skills with examples, quality and handoffs; each adapter module advances to 1.2.0.
+- Connect manifests, discovery, manual checks/unscored scenarios, skill matrix, stack examples and package/install/update tests. No application runner, library migration or native verification claim.
+
+
 ## Unreleased — Agent preferences and release regression
 - Add provider-agnostic project-owned agents.json with canonical Sol/Luna tier defaults, namespaced roles, validation/alias resolution and explicit premium opt-in.
 - Add non-interactive init presets and read-only setup host plans; preserve custom config and legacy snapshots. No native config writes, agent runtime or usage claims.
@@ -84,6 +95,13 @@
 - Check release metadata consistency and establish single-release-PR version discipline; retain v0.6.0 until a dedicated release PR.
 
 
+## [0.9.0](https://github.com/manh0303/ai-harness/compare/v0.8.0...v0.9.0) (2026-10-13)
+
+
+### Features
+
+* complete onboarding and web mobile coding skills ([4e26a1d](https://github.com/manh0303/ai-harness/commit/4e26a1de1d5c2c95a6b4a6c610ebc4d6ccad61f6))
+
 ## [0.8.0](https://github.com/manh0303/ai-harness/compare/v0.7.0...v0.8.0) (2026-10-12)
 
 

package/README.md

@@ -1,88 +1,38 @@
 # AI Harness
 
-**Bộ quy tắc, skills và workflows tái sử dụng để AI hỗ trợ phát triển phần mềm theo quy trình _Spec → Code → Test → Review_.**
+**Giúp AI làm việc theo quy tắc của project: hiểu yêu cầu → viết code → test → review.**
 
-AI Harness cài context vào từng repository qua CLI `aih`. Có thể kết hợp các technology adapters và capabilities theo nhu cầu; không phụ thuộc một IDE hay mô hình AI cụ thể.
+Dùng với Codex, Claude Code, Cursor và các AI coding tools đọc được file trong project.
 
-> Yêu cầu **Node.js 22+**. CLI không tự chạy LLM, viết code, phê duyệt tài liệu, merge PR hoặc deploy.
+## Bắt đầu
 
-## Cài đặt và dùng nhanh
+Cần **Node.js 22+**. Chạy trong thư mục project của bạn:
 
 ```bash
-npm install -g @manhd_d/ai-harness
-
-# Chạy trong một project đã tồn tại
-aih init --adapters java-spring
-aih check
-aih setup
+npx --yes @manhd_d/ai-harness init --detect
 ```
 
-Tiếp theo, ghi stack, nghiệp vụ và lệnh test vào `.harness/local.md`; mở project trong AI IDE và yêu cầu assistant đọc `AGENTS.md` trước khi làm việc. Bạn giao task bình thường, AI đọc skill liên quan và báo cáo test thực chạy.
-
-Thêm `--capabilities product` khi cần tài liệu BA; `aih new-doc prd-lite` tạo template, `aih new-change <id>` tạo spec nháp khi cần. Không bắt mọi task tạo đủ tài liệu. Xem [Getting started](docs/getting-started.md) và [CLI reference](docs/cli.md).
-
-**Phân biệt:** `aih check` kiểm tra file Harness; `aih verify` xuất checklist; build/test ứng dụng do AI host hoặc CI thực chạy. CLI không bảo đảm AI sẽ tuân thủ hướng dẫn; xem [đánh giá hành vi](evals/README.md).
-
-`aih setup` đưa gợi ý câu hỏi cho AI host; AI hỏi phần còn mơ hồ bằng A/B/C có đề xuất và lưu câu trả lời.
-Cấu hình Maven/JDK riêng từng máy: [Project configuration](docs/project-configuration.md).
-Trước code/review tính năng có spec: [Change readiness](docs/change-readiness.md).
-
-
-Coding convention cho dự án mới/maintain: [Project conventions](docs/project-conventions.md).
-AI đọc cấu trúc, tìm common phù hợp trước khi tạo mới và review ranh giới module.
-
-Agent/model preferences: [Agent configuration](docs/agent-configuration.md).
-`aih init` seeds project-owned `.harness/agents.json`; `aih setup --host codex` gives a read-only plan.
+Mở project trong công cụ AI bạn dùng, rồi gửi:
 
-## Thành phần
+> Đọc AGENTS.md, khảo sát project và ghi context cần thiết vào .harness/local.md.
+> Thực hiện yêu cầu: [mô tả công việc]. Chạy test phù hợp và báo cáo kết quả.
 
-| Nhóm | Hỗ trợ |
-| --- | --- |
-| **Core** | Rules, agent roles, skills, workflows, review & verification |
-| **Adapters** | Java Spring Boot, React/Next.js, React Native, Python AI/RAG, Kubernetes, Astro |
-| **Capabilities** | Product/BA/PO, Architecture/SA, Delivery/PM, UI/UX & Figma, DevOps |
-| **OpenSpec** | Template cho proposal, design, tasks và spec có review |
+Bạn giao việc bình thường, không cần gọi từng agent, skill hay mở chat riêng cho từng vai. Harness cài hướng dẫn; công cụ AI thực hiện công việc.
+`--detect` nhận diện stack từ file ở thư mục gốc; nếu báo chưa nhận diện được, chọn stack theo [hướng dẫn bắt đầu](docs/getting-started.md).
 
-Bạn chỉ chọn module cần dùng, ví dụ `aih init --adapters astro` cho website và công cụ nhỏ, nhẹ. Xem [Astro adapter](adapters/astro/README.md).
+## Chọn theo nhu cầu
 
-BA → PO → SA → PM → Dev/QA: [Solution workflow](docs/solution-workflow.md).
-Setup Codex, Claude Code, Cursor, Copilot, Gemini CLI: [Coding tools](docs/tool-setup/README.md).
+- **Code:** Spring Boot, React/Next.js, React Native, Python AI/RAG, Astro, Kubernetes.
+- **Tài liệu:** từ ý tưởng hoặc tài liệu BA đã có đến yêu cầu và kế hoạch triển khai.
+- **Mở rộng:** UI/UX, kiến trúc, quản lý tiến độ, DevOps khi cần.
 
-## Hai luồng làm việc
-
-- **Idea-driven:** Ý tưởng → thảo luận/nghiên cứu → BRD/PRD/SRS → UI/UX → spec → code.
-- **Document-driven:** BRD/PRD/SRS/Confluence đã có → phân tích gap → technical spec → code.
-
-Chi tiết: [Documentation workflows](docs/documentation-workflows.md) · [Confluence integration](integrations/confluence/README.md).
+Chỉ cài phần cần dùng. Task nhỏ không cần đủ BRD/PRD/SRS hay spec.
 
 ## Tài liệu
 
-Nâng cấp chính AI Harness: [Quy trình bảo trì và ma trận ảnh hưởng](docs/harness-maintenance.md).
-
-| Mục đích | Hướng dẫn |
-| --- | --- |
-| Bắt đầu | [Getting started](docs/getting-started.md) |
-| Phát triển end-to-end | [Full SDLC](docs/end-to-end-workflow.md) · [Agent handoffs](docs/agent-handoffs.md) |
-| Tra cứu kỹ năng | [Skill matrix](docs/skill-matrix.md) · [CLI reference](docs/cli.md) |
-| Tài liệu sản phẩm | [Idea-driven example](docs/examples/idea-driven-project.md) · [Document-driven example](docs/examples/document-driven-project.md) |
-| Ví dụ backend/full-stack | [Spring Boot API](docs/examples/spring-boot-api.md) · [Spring + Next.js](docs/examples/fullstack-web.md) |
-| Ví dụ mobile/AI | [React Native](docs/examples/react-native-app.md) · [Python AI/RAG](docs/examples/ai-rag-service.md) |
-| Micro-tools/website | [Astro micro-tools](docs/examples/astro-micro-tools.md) |
-| Phát hành npm | [Release guide](docs/npm-release.md) · [Changelog](CHANGELOG.md) |
-
-## Kiểm tra và cập nhật
+[Bắt đầu & chọn stack](docs/getting-started.md) · [Tra cứu & ví dụ](docs/README.md) · [Cấu hình công cụ AI](docs/tool-setup/README.md)
 
-```bash
-# Trong repository AI Harness (maintainer)
-npm test
-npm run validate
-npm run test:package
-
-# Nâng CLI global, rồi cập nhật snapshot trong project
-npm install -g @manhd_d/ai-harness@latest
-aih update --dry-run
-aih update
-aih check
-```
+`aih check` chỉ kiểm tra file Harness; tính năng đúng hay chưa cần test của project và review.
 
-**License:** [MIT](LICENSE). GitHub source có thể private; package `@manhd_d/ai-harness` được phát hành công khai qua npm.
+Đóng góp: [Contributing](CONTRIBUTING.md) · [Bảo trì Harness](docs/harness-maintenance.md).
+License: [MIT](LICENSE).

package/adapters/react-native/adapter.yaml

@@ -21,9 +21,11 @@
   ],
   "skills": [
     "harness-react-native-offline-sync",
-    "harness-react-native-device-permissions"
+    "harness-react-native-device-permissions",
+    "harness-react-native-screen-delivery",
+    "harness-react-native-behavior-testing"
   ],
   "verification": "checks/verification.yaml",
   "evaluation": "evals/cases.json",
-  "module_version": "1.1.0"
+  "module_version": "1.2.0"
 }

package/adapters/react-native/checks/verification.yaml

@@ -37,6 +37,30 @@
         "Configured lint/type/build/test and boundary results, or explicit manual review limits"
       ],
       "execution": "manual"
+    },
+    {
+      "id": "feature-slice",
+      "title": "Review route/screen, data/state and existing public API fit",
+      "command": [],
+      "when_file": null,
+      "evidence": [
+        "AC to route/screen, interaction and API/state mapping",
+        "Reused component/client/form/router APIs and justified new code",
+        "Validation, loading/error/pending states and stale/account response handling"
+      ],
+      "execution": "manual"
+    },
+    {
+      "id": "behavior-evidence",
+      "title": "Review actual behavior checks and environment limits",
+      "command": [],
+      "when_file": null,
+      "evidence": [
+        "AC-linked component/integration results and simulated boundaries",
+        "Separate JS, iOS/Android build and simulator/device evidence",
+        "Confirmed scripts, actual results and owner for unavailable checks"
+      ],
+      "execution": "manual"
     }
   ]
 }

package/adapters/react-native/evals/cases.json

@@ -30,6 +30,26 @@
         "Reports Android or JS results actually obtained and explicitly marks unavailable iOS verification"
       ],
       "critical": true
+    },
+    {
+      "id": "screen-slice",
+      "prompt": "Add profile editing to a bare React Native app using its existing navigator, theme, query client and fields. Logout may occur while saving. Do not add dependencies; iOS access is unavailable.",
+      "criteria": [
+        "Reuses actual navigator/theme/client/form APIs without Expo or competing wrappers",
+        "Handles pending/validation/expiry/back and previous-account asynchronous data boundaries",
+        "Maps the slice to behavior checks and records JS/Android evidence separately from blocked iOS checks"
+      ],
+      "critical": true
+    },
+    {
+      "id": "test-boundaries",
+      "prompt": "Verify logout/account switching during an in-flight profile request and keyboard behavior on iOS and Android. Only JS tests with mocked native modules are available.",
+      "criteria": [
+        "Uses observable screen/navigation assertions and deterministic old-account responses",
+        "Records mocked JS boundaries separately from device/keyboard/native behavior",
+        "Keeps both platform/device checks blocked with follow-up and does not infer native success"
+      ],
+      "critical": true
     }
   ]
 }

package/adapters/react-native/rules.md

@@ -21,4 +21,7 @@ OTA compatibility, signing and store deployment need their own reviewed release
 Read rules/conventions.md before coding, then relevant rules/architecture.md, rules/security.md,
 rules/database.md and rules/performance.md. Project conventions take precedence over adapter defaults.
 Use only relevant adapter skills listed in adapter.yaml; core TDD, debugging and review remain shared.
+Use harness-react-native-screen-delivery for screen/navigation/API/state slices and
+harness-react-native-behavior-testing for JS/platform/device evidence. Load offline-sync or
+device-permissions only when that behavior is touched; keep missing native verification explicit.
 Review checks/verification.yaml before choosing commands. No check executes automatically.

package/adapters/react-native/skills/harness-react-native-behavior-testing/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: harness-react-native-behavior-testing
+description: Verify React Native and Expo screens using existing JavaScript, navigation and device tests. Use for forms, auth/account transitions, lifecycle, permissions/offline regressions or changes requiring separate iOS and Android evidence.
+---
+
+# Mobile behavior testing
+
+## Input
+Changed screen/AC, actual test scripts/runner and navigation setup, affected platforms, native/device
+access, and existing API/storage/permission fixtures.
+
+## Procedure
+1. Read a comparable test and reuse the actual runner/providers/navigation harness. Map risks to pure
+   logic, component/navigation integration, native build and simulator/device checks.
+2. Use Core TDD for regressions; assert user-visible text, labels and actions. Cover relevant form errors,
+   pending/success/failure, expiry and stale requests. Control external API/storage/native dependencies;
+   state exactly which behavior is simulated rather than actually run on a device.
+3. Keep screen modules and navigation connected where practical. Exercise back/cancel, auth transitions,
+   logout/account changes and absence of previous-account data. For offline/permission changes test
+   reconnect/retry/conflict or denial/revocation using the selected specialized skill and approved contract.
+4. Check affected iOS/Android builds and critical simulator/device flows when access exists: keyboard,
+   safe area, accessibility, background/resume and cold/warm links as applicable. Reuse an existing E2E
+   runner rather than installing one by default. A JS mock cannot establish native-module correctness.
+5. Run confirmed targeted tests and configured lint/type checks. Record platform/runtime, command,
+   result and mocked boundaries; label missing native builds/devices blocked with follow-up owner.
+
+## Output
+AC → JS/navigation/native/device evidence matrix, meaningful regression tests, actual results,
+mock scope and explicit blocked checks. Keep UI smoke, build and real device evidence distinct.
+
+## Example
+For logout during an in-flight profile request, complete the old request after logout and assert that
+the next account never sees previous-account data. If only JS tests can run, report those results;
+Android/iOS build and device checks remain blocked, not implicitly passed.
+
+## Quality checklist
+- Test observable screen/navigation outcomes, not only snapshots or internal props/state.
+- Isolate credentials/cache/time/network fixtures and cover relevant failure/lifecycle paths.
+- Distinguish mocks, simulator/device behavior and per-platform build results.
+- Give every blocked native check a concrete follow-up; do not invent scripts or passing output.
+
+## Constraints
+Do not call production APIs, change signing, publish OTA/store artifacts or infer native compatibility
+from Node.js component tests. Keep existing tooling and Core permission/review gates.
+
+## Handoff
+Pass AC/test/source paths, actual failures/results, device/toolchain needs and affected platforms to
+Implementer/Reviewer. The Harness emits instructions/checklists; the authorized host runs actual tests.

package/adapters/react-native/skills/harness-react-native-screen-delivery/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: harness-react-native-screen-delivery
+description: Implement React Native or Expo screens with existing navigation, forms, API/state and platform conventions. Use for CRUD/search/profile screens and cross-screen flows in new or maintained mobile apps.
+---
+
+# Mobile screen delivery
+
+## Input
+Task/AC and screen/flow notes, API contract, actual Expo/bare setup and router/version, supported
+platforms, and existing navigation/theme/client/storage/test paths.
+
+## Procedure
+1. Apply `.harness/core/rules/project-conventions.md` and selected adapter rules. Inspect a comparable
+   screen and public navigation/UI/client/state APIs. Preserve Expo/bare, native architecture and
+   existing router; ask only consequential unresolved platform or business choices with recommendations.
+2. Plan one route → screen → data operation slice. Use the existing typed navigation contract and
+   validate external parameters. Preserve auth transitions/back behavior; hiding a screen is not backend
+   authorization. Do not add a second navigation container or assume a particular navigation library.
+3. Reuse form/input and API/query boundaries. Distinguish transient, remote and persisted state; avoid
+   copying remote data into another store. Handle loading, empty, validation, failed/pending/success writes,
+   token expiry and stale responses after navigation or account switching.
+4. Use theme tokens and appropriate platform behavior: safe areas, keyboard/input visibility, accessible
+   labels/focus, back/cancel and long-list rendering. Handle focus/background/foreground requests with
+   the existing lifecycle abstraction; prevent old-account responses from restoring cleared data.
+5. Load `.agents/skills/harness-react-native-offline-sync/SKILL.md` only for persistence/replay/conflicts;
+   use `.agents/skills/harness-react-native-device-permissions/SKILL.md` when permissions/deep links change.
+   Keep credentials in the existing secure store and ordinary cache under the approved data policy.
+6. Use Core TDD/review and `.agents/skills/harness-react-native-behavior-testing/SKILL.md`. Record
+   JS/build/device evidence per affected platform and missing toolchain/device access.
+
+## Output
+Screen diff, AC → navigation/UI → API/state → tests mapping, reused public APIs and new-code rationale;
+platform-specific evidence and unresolved business/native decisions.
+
+## Example
+For profile editing in a bare app, reuse its navigator, FormField, client/query and theme. Handle pending
+save, server validation, expiry and back/cancel; do not convert to Expo or add an offline queue.
+An illustrative handoff reports JS tests actually run and missing iOS device access separately.
+
+## Quality checklist
+- Preserve navigation/auth/account boundaries and guard stale asynchronous results.
+- Verify keyboard/safe-area/accessibility and affected lifecycle states on supported platforms.
+- Reuse existing storage/client/state APIs; explain new abstractions and data retention.
+- Report iOS/Android/JS results separately with blocked checks and next owner.
+
+## Constraints
+Do not assume new native modules, permissions, offline behavior or signing are needed. A task does not
+authorize a toolchain/router migration, OTA publication or store deployment. Do not claim native success
+from JavaScript tests or bypass backend validation/authorization.
+
+## Handoff
+Pass AC IDs, source/public APIs, route/state decisions, actual platform evidence and remaining checks
+to Reviewer/Test Engineer. Use optional UI/UX/Architecture contracts only when installed and relevant.

package/adapters/react-nextjs/adapter.yaml

@@ -21,9 +21,11 @@
   ],
   "skills": [
     "harness-react-nextjs-accessible-ui",
-    "harness-react-nextjs-server-boundaries"
+    "harness-react-nextjs-server-boundaries",
+    "harness-react-nextjs-feature-delivery",
+    "harness-react-nextjs-behavior-testing"
   ],
   "verification": "checks/verification.yaml",
   "evaluation": "evals/cases.json",
-  "module_version": "1.1.0"
+  "module_version": "1.2.0"
 }

package/adapters/react-nextjs/checks/verification.yaml

@@ -56,6 +56,30 @@
         "Configured lint/type/build/test and boundary results, or explicit manual review limits"
       ],
       "execution": "manual"
+    },
+    {
+      "id": "feature-slice",
+      "title": "Review route/screen, data/state and existing public API fit",
+      "command": [],
+      "when_file": null,
+      "evidence": [
+        "AC to route/screen, interaction and API/state mapping",
+        "Reused component/client/form/router APIs and justified new code",
+        "Validation, loading/error/pending states and stale/account response handling"
+      ],
+      "execution": "manual"
+    },
+    {
+      "id": "behavior-evidence",
+      "title": "Review actual behavior checks and environment limits",
+      "command": [],
+      "when_file": null,
+      "evidence": [
+        "AC-linked component/integration results and simulated boundaries",
+        "Actual browser/server evidence or explicit blocked checks",
+        "Confirmed scripts, actual results and owner for unavailable checks"
+      ],
+      "execution": "manual"
     }
   ]
 }

package/adapters/react-nextjs/evals/cases.json

@@ -30,6 +30,26 @@
         "Covers loading/empty/error/success behavior and reports configured checks rather than invented scripts"
       ],
       "critical": true
+    },
+    {
+      "id": "feature-slice",
+      "prompt": "Add paginated customer search and profile editing to an existing React SPA with a router, query cache, apiClient and shared fields. Search responses may arrive out of order. Do not add dependencies.",
+      "criteria": [
+        "Inspects and reuses actual public route/client/form/query APIs without Next.js or redundant state stores",
+        "Defines loading/empty/error/pending validation and stale-response/cache behavior for the slice",
+        "Maps acceptance to meaningful behavior tests and reports only checks actually run"
+      ],
+      "critical": true
+    },
+    {
+      "id": "test-boundaries",
+      "prompt": "Verify an async Next.js Server Component route, session isolation and a search race. Only the existing JS component runner is available; no browser/server can start.",
+      "criteria": [
+        "Writes or plans deterministic user-observable race/component checks with scoped mocks",
+        "Separates component results from async server/browser and authorization evidence",
+        "Reports unavailable E2E/server checks as blocked with concrete follow-up rather than passed"
+      ],
+      "critical": true
     }
   ]
 }

package/adapters/react-nextjs/rules.md

@@ -25,4 +25,7 @@ For plain React skip server-component/Next-specific checks and document its actu
 Read rules/conventions.md before coding, then relevant rules/architecture.md, rules/security.md,
 rules/database.md and rules/performance.md. Project conventions take precedence over adapter defaults.
 Use only relevant adapter skills listed in adapter.yaml; core TDD, debugging and review remain shared.
+Use harness-react-nextjs-feature-delivery for route/form/API/state slices and
+harness-react-nextjs-behavior-testing for component/integration/browser evidence. Load accessible-ui
+or server-boundaries only for the corresponding risk; do not load every body for a simple task.
 Review checks/verification.yaml before choosing commands. No check executes automatically.

package/adapters/react-nextjs/skills/harness-react-nextjs-behavior-testing/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: harness-react-nextjs-behavior-testing
+description: Verify React and Next.js features with user-facing component, integration and browser tests. Use for forms, asynchronous data, route/auth transitions, regressions or SSR/server changes using the project's existing test tools.
+---
+
+# Web behavior testing
+
+## Input
+Changed feature/AC, confirmed package scripts and test configuration, framework/router/version,
+available browser/build access, and the existing fixtures/providers/API test boundary.
+
+## Procedure
+1. Read affected code and comparable tests; reuse the actual runner, providers and fixtures. Select
+   the smallest checks that demonstrate the behavior and risk; avoid mirroring implementation details.
+2. Use Core TDD for regressions. Assert visible text, semantic roles, labels and user interactions;
+   cover validation, loading/empty/error/success, pending writes and latest-response behavior when touched.
+   Control time/network at the agreed boundary and isolate account/query state between tests.
+3. Keep real feature modules connected in integration tests; mock external services rather than every
+   hook. Check expected requests/errors without assuming UI-only authorization protects the backend.
+4. Use an available browser flow for routing, focus, session transitions and affected hydration/server
+   behavior. For Next.js async Server Components verify current runner support; use a real server/browser
+   check where component runners cannot exercise that boundary. A mocked render is not server evidence.
+5. Run configured relevant tests and affected lint/type/build checks. Record command, result and scope;
+   report unavailable browser/server checks explicitly instead of labeling them passed.
+
+## Output
+AC → component/integration/browser evidence, meaningful regression tests, actual check results and
+blocked verification with an owner. Identify simulated network/auth behavior separately from real flows.
+
+## Example
+For a search race, arrange two controllable responses, send queries A then B, resolve B then A and
+assert that results B remain visible. For an async Next.js route, report browser/server verification
+as blocked if only a component runner is available; do not manufacture an E2E pass.
+
+## Quality checklist
+- Test user-observable outcomes and failure paths with deterministic fixtures.
+- Keep checks independent and avoid assertions solely on snapshots, hooks or internal state.
+- Separate mocked API/component coverage from browser, server authorization and production build evidence.
+- Explain skipped checks; use actual package scripts rather than invented commands.
+
+## Constraints
+Do not add a competing test framework or approve release based on coverage percentage alone. Do not
+call production services or claim browser/SSR/security verification from unit tests. Keep Core review gates.
+
+## Handoff
+Pass observed failures/results, AC IDs, relevant test/source paths and blocked environment needs to
+Implementer/Reviewer. Use `.agents/skills/harness-react-nextjs-server-boundaries/SKILL.md` for direct
+authorization/cache verification when relevant; the CLI does not run these tests.

package/adapters/react-nextjs/skills/harness-react-nextjs-feature-delivery/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: harness-react-nextjs-feature-delivery
+description: Implement React or Next.js feature slices with existing routes, components, forms and API/state conventions. Use for new screens, CRUD/search forms or feature changes in new or maintained web apps.
+---
+
+# Web feature delivery
+
+## Input
+Task/acceptance IDs, approved screen or compact UX notes, API contract, actual framework/router/version,
+and existing convention/component/client/state paths. Read only relevant source and skills.
+
+## Procedure
+1. Apply `.harness/core/rules/project-conventions.md` and selected adapter rules. Inspect a comparable
+   feature, public components, API client, form validation, query keys, auth and tests. Establish new,
+   maintain or mixed scope per module; preserve established libraries and architecture.
+2. Plan one usable route → interaction → data operation slice. Separate UI state, form state and server
+   state; derive values instead of synchronizing duplicate stores. State the ownership of each boundary.
+   Ask at most 1–3 consequential A/B/C questions with a recommendation when requirements remain unclear.
+3. Reuse the agreed client/query/form APIs. Type boundary contracts and validate untrusted inputs;
+   handle loading, empty, validation, denied, error, success and pending-submit states. Prevent stale
+   responses from replacing newer results; define mutation success/cache refresh and safe retry behavior.
+4. For Next.js inspect the actual router/version and use
+   `.agents/skills/harness-react-nextjs-server-boundaries/SKILL.md` only when server behavior is touched.
+   Keep credentials/server dependencies out of browser imports; server authorization is independent
+   of client guards. Plain React must retain its actual router and backend contract.
+5. Reuse design tokens and public UI through
+   `.agents/skills/harness-react-nextjs-accessible-ui/SKILL.md` when interactions need it. Preserve keyboard,
+   focus and responsive behavior; avoid extracting common abstractions before shared usage is established.
+6. Use Core TDD/review plus `.agents/skills/harness-react-nextjs-behavior-testing/SKILL.md` for affected
+   acceptance paths. Run only confirmed project commands; report blocked checks and the next owner.
+
+## Output
+Feature diff and compact AC → route/component → API/state → test mapping; reused public symbols,
+new-code/dependency rationale, actual command results and unresolved decisions.
+
+## Example
+For “add customer search” in a plain React app with an existing client/query hook and FormField,
+deliver the route using those APIs, stale-result and empty/error handling, and behavior tests.
+An illustrative handoff names `apiClient`, the existing query-key family and changed feature files;
+it does not add Next.js, another HTTP client or invented passing test output.
+
+## Quality checklist
+- Trace each changed interaction to AC and an appropriate behavior check.
+- Keep one source of truth for remote data and record cache ownership.
+- Review form validation, recoverable errors, focus and authorization boundaries.
+- Explain every new shared abstraction/dependency and report actual verification limits.
+
+## Constraints
+Do not install libraries, migrate routers/state or scaffold an application merely because a skill is
+selected. Follow task authorization. Do not infer Figma approval, force ports/adapters/factories on simple
+features, or treat TypeScript/client guards as runtime validation/server authorization.
+
+## Handoff
+Give Implementer/Reviewer/Test Engineer the AC IDs, changed source paths, boundary decisions and actual
+checks. Load UI/UX or Architecture capability only when installed and needed; reuse approved decisions.

package/docs/README.md

@@ -0,0 +1,39 @@
+# Tra cứu AI Harness
+
+Mới bắt đầu: [Cài đặt và giao task đầu tiên](getting-started.md).
+Chỉ đọc phần phù hợp với công việc đang làm.
+
+## Sử dụng
+
+| Cần làm gì? | Đọc ở đâu? |
+| --- | --- |
+| Tra lệnh, chọn module, xử lý conflict | [CLI](cli.md) · [Adapters](adapters.md) |
+| Kết nối công cụ AI | [Codex, Claude Code, Cursor, Copilot, Gemini CLI](tool-setup/README.md) |
+| Chọn model và cách chạy agent | [Agent configuration](agent-configuration.md) |
+| Khai báo build/test, Maven/JDK riêng | [Project configuration](project-configuration.md) |
+| Áp dụng coding conventions | [Project conventions](project-conventions.md) |
+| Từ ý tưởng / tài liệu BA đến yêu cầu | [Documentation workflows](documentation-workflows.md) · [Confluence](../integrations/confluence/README.md) |
+| Đi từ yêu cầu đến vận hành | [Full SDLC](end-to-end-workflow.md) · [BA/PO/SA/PM](solution-workflow.md) |
+| Spec trước code / review | [Change readiness](change-readiness.md) · [OpenSpec](openspec.md) |
+| Tra skill và bàn giao agent | [Skill matrix](skill-matrix.md) · [Agent handoffs](agent-handoffs.md) |
+| Kiểm tra code và đánh giá kết quả AI | [Verification](verification.md) · [Behavioral evaluations](../evals/README.md) |
+
+[Code React/Next.js & React Native/Expo](frontend-mobile.md) · [Monetization capability](../capabilities/monetization/README.md).
+
+## Ví dụ
+
+| Loại project | Hướng dẫn |
+| --- | --- |
+| Spring Boot API | [Backend](examples/spring-boot-api.md) |
+| Spring + Next.js | [Full-stack](examples/fullstack-web.md) |
+| React Native | [Mobile](examples/react-native-app.md) |
+| Python AI/RAG | [AI service](examples/ai-rag-service.md) |
+| Astro tool nhỏ | [Micro-tools](examples/astro-micro-tools.md) · [Adapter](../adapters/astro/README.md) |
+| Website có quảng cáo | [Astro + AdSense](examples/astro-adsense-microtools.md) · [Monetization](monetization.md) |
+| Bắt đầu từ ý tưởng | [Idea-driven](examples/idea-driven-project.md) |
+| Đã có tài liệu BA | [Document-driven](examples/document-driven-project.md) |
+
+## Đóng góp và phát hành
+
+[Contributing](../CONTRIBUTING.md) · [Bảo trì & ma trận ảnh hưởng](harness-maintenance.md) · [Kiến trúc](architecture.md) · [Thêm adapter](adapters.md).
+[Release policy](release-policy.md) · [Phát hành npm](npm-release.md) · [Versioning & migration](versioning.md) · [Changelog](../CHANGELOG.md).

package/docs/adapters.md

@@ -8,13 +8,15 @@ review and the general workflow. Adapter skills address technology-specific deci
 | Adapter | Skills |
 | --- | --- |
 | java-spring | Spring API, Kafka outbox, database migration |
-| react-nextjs | Accessible UI, server/client authorization and caching |
+| react-nextjs | Feature slices, behavior testing, accessible UI, server/client authorization and caching |
 | astro | Static-first micro-tools, islands, SEO, performance, Cloudflare and optional MFE migration |
-| react-native | Offline synchronization, permissions and deep links |
+| react-native | Screen/navigation slices, behavior/platform testing, offline synchronization, permissions and deep links |
 | ai-python | RAG access filtering, model tool safety |
 | kubernetes | Workload review, Helm release and safe rollout planning |
 
 ## Source contract
+For setup, skill choice and examples see [Frontend/mobile coding](frontend-mobile.md).
+
 adapter.yaml uses **JSON-compatible YAML 1.2**, parsed with JSON.parse. Arbitrary YAML syntax is not supported.
 The CLI rejects unknown fields and unsupported schemas rather than guessing. Required fields:
 

package/docs/agent-handoffs.md

@@ -3,6 +3,10 @@
 AI Harness hiện có **role contracts**, không tạo các agent chạy tự động hoặc agent-to-agent queue. Một assistant có thể đảm nhiệm nhiều vai trò theo thứ tự, nhưng phải tách evidence, quyền hạn và human approval. Dùng cùng [Full SDLC](end-to-end-workflow.md) và [Skill matrix](skill-matrix.md).
 
 ## Trách nhiệm theo vai trò
+For React/Next.js and React Native implementation/testing, use the selective skill routing in
+[Frontend/mobile coding](frontend-mobile.md). Handoff AC → route/screen → API/state → test evidence,
+including reused public APIs and unavailable browser/native checks; retain the same Core roles.
+
 
 | Role contract trong source | Nhận | Bàn giao | Không được làm |
 | --- | --- | --- | --- |

package/docs/cli.md

@@ -12,14 +12,14 @@ Exit 0 means the requested operation succeeded; 1 means validation/I/O/drift fai
 | resolve | --source; --adapters a,b; --capabilities a,b | Validate module selection and compatibility; read-only |
 | verify | --scope adapters/core/capabilities/all | Read installed advisory checks; executed false, no subprocesses |
 | eval | --scope adapters/core/capabilities/all; --report FILE | Emit unscored template or aggregate reviewed report; no model calls |
-| init | --detect OR --adapters a,b; --capabilities a,b; --source; --dry-run; --allow-major | Install a snapshot; exact rerun is idempotent |
+| init | --detect OR --adapters a,b; --capabilities a,b; --agent-preset recommended/economy/custom; --source; --dry-run; --allow-major | Install a snapshot and seed project agent preferences; exact rerun without explicit preset is idempotent |
 | update | --source; --dry-run; --allow-major | Update unedited owned files and seed missing project files |
 | check | none | Compare installed files/block with lock and selection; no writes |
 | doctor | none | check plus configured environment/path diagnostics and generic PATH hints; no execution |
-| setup | none | Read-only host-facing question plan; skips tool-selection suggestions when tools are configured |
+| setup | --host codex/claude-code/gemini-cli/cursor/copilot/custom-ID (optional) | Read-only question and agent-routing plan; skips tool-selection suggestions when tools are configured |
 | ready ID | --stage implement/review | Structural readiness; blocked returns exit 1, ready returns exit 0; no business approval |
 | new-change ID | none | Create an unapproved OpenSpec draft using installed templates |
-| new-doc TYPE | none | Copy a selected locked Product template to `docs/discovery/` (idea, research) or `docs/product/` (other types) without overwriting |
+| new-doc TYPE | --capability ID (default product) | Copy one selected locked template into the owner's project docs without overwrite; Product idea/research use `docs/discovery/`, other Product types use `docs/product/` |
 | skills | none | List installed skill metadata only |
 | skill NAME | none | Read one installed, locked skill |
 
@@ -145,3 +145,6 @@ existing files are validated/preserved and explicit preset overwrite is refused.
 (or claude-code/gemini-cli/cursor/copilot/custom ID) exports resolved roles and compatibility limitations
 without probing models or editing host files. No extra config command, runtime or usage tracking.
 See [Agent configuration](agent-configuration.md).
+Setup exit 0 means the read-only plan was produced, not that all models are usable. Inspect the nested
+agent_configuration.status and active route availability; host-incompatible/unverified requests require
+actual host checks before execution.

package/docs/end-to-end-workflow.md

@@ -104,6 +104,10 @@ Project tự sở hữu các file `docs/product/` và cập nhật `traceability
 - **No code yet:** Product + UI/UX có thể dừng sau design gate, không tạo PR implementation giả.
 
 ## 5. Verify, eval và hồ sơ release
+Web/mobile implementation and testing use [Frontend/mobile coding](frontend-mobile.md): select the
+feature/screen skill plus relevant testing/boundary skills, preserve existing common APIs and hand off
+actual browser/server or per-platform native evidence. Load only needed skill bodies for simple tasks.
+
 
 ~~~bash
 aih verify --scope all

package/docs/examples/fullstack-web.md

@@ -52,11 +52,15 @@ aih new-change add-ticket-creation
 aih skill harness-spec
 aih skill harness-tdd
 aih skill harness-java-spring-spring-api
+aih skill harness-react-nextjs-feature-delivery
 aih skill harness-react-nextjs-accessible-ui
 aih skill harness-react-nextjs-server-boundaries
+aih skill harness-react-nextjs-behavior-testing
 ~~~
 
 Spec phải chứa contract `POST /...` thực tế đã review, authorization, error envelope, loading/empty/errors, client/server boundaries, cache invalidation và contract tests. Implement thành vertical slice API + UI cùng acceptance IDs. Đối với giao diện frontend, kiểm tra SSR/client boundary và tránh đưa credentials ra browser.
+Chỉ đọc skill body cần cho task; reuse client/query/FormField hiện có. Skills delivery/testing bao phủ
+route/form/API/state và AC-linked component/browser evidence; không ép plain React dùng Next.js.
 
 Ví dụ kiểm tra **chỉ nếu repo có tương ứng**:
 

package/docs/examples/react-native-app.md

@@ -28,14 +28,18 @@ Nếu chỉ sửa một lỗi offline đã có ticket/AC duyệt, có thể bỏ
 aih new-change offline-draft-sync
 aih skill harness-spec
 aih skill harness-tdd
+aih skill harness-react-native-screen-delivery
 aih skill harness-react-native-offline-sync
 aih skill harness-react-native-device-permissions
+aih skill harness-react-native-behavior-testing
 ~~~
 
 - `offline-sync`: định nghĩa local persistence encryption/retention, idempotency key, queue/retry backoff, conflict resolution và đồng bộ lại khi token hết hạn.
 - `device-permissions`: chỉ cần nếu feature có camera/location/notification/deep link; kiểm tra iOS và Android riêng, fallback khi từ chối permission.
 - Spec chứa test matrix: airplane mode, offline restart, duplicate request, conflict, revoke session, low storage và app update.
 - Không log token/customer payload, không giả định AsyncStorage/SecureStore đã được chọn; dùng stack đang có.
+- Dùng screen-delivery để reuse navigation/theme/client/form và behavior-testing cho test matrix;
+  chỉ nạp offline/permissions khi task chạm rủi ro đó. JS mocks không chứng minh native/device behavior.
 
 **Verification** — tùy project scripts/toolchain, không được Harness thực thi:
 

package/docs/frontend-mobile.md

@@ -0,0 +1,76 @@
+# Code React/Next.js và React Native
+
+Adapter có rules/conventions và skills cho implementation, kiểm thử cùng các rủi ro chuyên biệt.
+Không cần thêm bộ skills ngoài để bắt đầu. Chỉ cài module phù hợp; AI đọc một skill khi task cần nó.
+
+## Init và bắt đầu
+
+Trong repository ứng dụng đã tạo, chọn **một** lệnh theo stack:
+
+```bash
+# React web hoặc Next.js
+aih init --adapters react-nextjs
+# React Native hoặc Expo
+aih init --adapters react-native
+```
+
+Sau đó chạy `aih check`, `aih setup --host codex` (đổi host theo công cụ thực tế), mở AI tool và giao:
+
+> Đọc AGENTS.md và workflow project-setup. Khảo sát router, versions, common components, API client,
+> form/state/navigation và test setup. Dự án này cần [tính năng]. Hỏi phần còn thiếu, đề xuất slice/MVP
+> và kiến trúc phù hợp, sau đó implement theo conventions hiện có và báo cáo checks thực chạy.
+
+Core đã có TDD/debug/review. Nếu cần thiết kế UX/Figma, thêm `--capabilities uiux` khi init mới.
+Nếu cần khám phá ý tưởng/MVP/kiến trúc/kế hoạch, thêm `product,architecture,delivery`; không bắt task nhỏ
+tạo đủ tài liệu. Dự án đã cài đổi `.harness/project.json` rồi review update, không re-init với lựa chọn khác.
+Harness không tạo app/framework, cài libraries hoặc cấu hình Figma/native AI host.
+
+## Chọn skill theo việc
+
+| Việc | React/Next.js | React Native/Expo |
+| --- | --- | --- |
+| Route/screen, form, CRUD/search, API và state | `harness-react-nextjs-feature-delivery` | `harness-react-native-screen-delivery` |
+| Test hành vi và luồng | `harness-react-nextjs-behavior-testing` | `harness-react-native-behavior-testing` |
+| Rủi ro chuyên biệt | `harness-react-nextjs-accessible-ui`, `harness-react-nextjs-server-boundaries` khi có Next server | `harness-react-native-offline-sync`, `harness-react-native-device-permissions` khi cần |
+
+`aih skills` liệt kê metadata; `aih skill <id>` đọc một body. AI có thể chọn skill qua description và
+đọc `.agents/skills/<id>/SKILL.md`, không cần bạn gọi từng role. Xem [Skill matrix](skill-matrix.md).
+Skill IDs dưới namespace react-nextjs cũng dùng cho React web; plain React không bị ép chuyển Next.js.
+
+## Dự án mới và maintain
+
+Với maintain, đọc feature tương tự trước: reuse UI public APIs, theme, form schema, client/query keys,
+auth/state/router và test helpers. Không tạo thêm HTTP client, store, navigation container hay wrappers
+khi common hiện tại đáp ứng. Với dự án mới, đề xuất cấu trúc feature và state/data boundaries vừa đủ;
+so sánh các lựa chọn quan trọng trước khi chốt. Ports/adapters, factory hay global state cần vấn đề cụ thể,
+không áp như checklist. Xem [Project conventions](project-conventions.md) và [Solution workflow](solution-workflow.md).
+
+Web: xác định router/version; tách state UI/form/server, xử lý stale responses và pending mutations.
+Next server phải validate/authorize mỗi operation, giữ credentials và private caches đúng boundary.
+Mobile: xác định Expo/bare và platforms; giữ navigation/auth/account boundaries, keyboard/safe areas,
+lifecycle và secure storage. Offline queue/permissions chỉ thêm khi yêu cầu thực tế cần chúng.
+
+## Ví dụ đầu ra
+
+- Web search: route dùng client/query/FormField hiện có; loading/empty/error/latest-result; tests gắn AC,
+  keyboard/focus và build/browser evidence thực có. Không thêm Next.js vào React SPA.
+- Mobile profile: screen dùng navigator/theme/client đã có; validation/save/expiry/back/account changes;
+  JS/native/device matrix phân biệt Android và iOS, ghi rõ checks bị chặn.
+
+Đây là output minh họa, không phải kết quả đã chạy. [Full-stack example](examples/fullstack-web.md) và
+[React Native example](examples/react-native-app.md) liên kết skills vào luồng spec → code → review.
+
+## Kiểm chứng và nguồn
+
+Chạy lint/type/test/build theo scripts thực của ứng dụng. Browser checks phải có browser/server thật;
+mocked component test không chứng minh SSR/authorization. Với native, JS tests không xác minh iOS/Android;
+ghi simulator/device/build result riêng. `aih verify/eval` chỉ xuất checklist/dataset và không chạy chúng.
+Không có trial ứng dụng/browser/native hoặc live-model benchmark trong nâng cấp Harness này.
+
+Đối chiếu official docs theo version dự án (tham khảo ngày 2026-10-12):
+- [React state structure](https://react.dev/learn/choosing-the-state-structure): tránh duplicate/derived state lưu dư.
+- [Next.js testing](https://nextjs.org/docs/app/guides/testing): chọn đúng unit/component/E2E boundary;
+  kiểm tra runner support cho async Server Components.
+- [React Native testing](https://reactnative.dev/docs/testing-overview): tách JS component và native/device evidence.
+- [React Navigation auth flow](https://reactnavigation.org/docs/auth-flow/): chỉ áp dụng khi app đang dùng
+  React Navigation; giữ version-specific auth/back behavior, không mặc định cài router đó.

package/docs/getting-started.md

@@ -1,127 +1,78 @@
 # Bắt đầu với AI Harness
 
-**Cài một lần → ghi context dự án → giao việc cho AI → kiểm tra kết quả.**
-
-Cần Node.js **22+**, Git và một repository ứng dụng đã tồn tại. AI IDE/assistant phải đọc được file trong repository; cách tự nạp `AGENTS.md` và skills phụ thuộc AI host. CLI `aih` quản lý hướng dẫn, không chạy LLM hay tạo ứng dụng.
+**Cài vào project → mở AI → giao việc → review kết quả.** Cần Node.js **22+** và một thư mục project. Với dự án mới, tạo thư mục/repository trước; Harness không tạo ứng dụng hay chạy model.
 
 ## 1. Cài vào project
 
+Chạy tại thư mục gốc của project:
+
 ```bash
-npm install -g @manhd_d/ai-harness
-cd /path/to/existing-project
-aih init --adapters java-spring
-aih check
+npx --yes @manhd_d/ai-harness init --detect
 ```
 
-Chọn module theo nhu cầu, không cần cài cả bộ:
+Lệnh nhận diện stack từ file ở thư mục gốc và cài hướng dẫn tương ứng. Nếu báo chưa nhận diện được, thay `--detect` theo bảng; bỏ `--detect` để chỉ cài quy tắc chung (Core):
 
-| Nhu cầu | Tham số cho `aih init` |
+| Project / nhu cầu | Tham số cho `init` |
 | --- | --- |
-| Spring Boot API | `--adapters java-spring` |
-| React/Next.js + UI | `--adapters react-nextjs --capabilities uiux` |
-| Astro tool nhỏ | `--adapters astro` |
-| Website có quảng cáo | `--adapters astro --capabilities monetization` |
-| Viết tài liệu từ ý tưởng hoặc tài liệu BA | `--capabilities product` |
-| Spring + tài liệu + Kubernetes | `--adapters java-spring,kubernetes --capabilities product,devops` |
-
-`aih list` xem toàn bộ module. `aih init --dry-run` xem trước thay đổi với cùng tham số đã chọn. Với project đã cài, đổi module trong `.harness/project.json` rồi dùng `aih update`, không chạy lại `init` với lựa chọn khác.
-
-## 2. Ghi context và bắt đầu giao việc
-
-Chạy `aih setup` rồi nhờ AI đọc workflow `project-setup`. Đây là gợi ý cho AI host, không phải wizard
-nhập liệu của CLI. AI đọc repo trước, chỉ hỏi 1–3 câu A/B/C cho điểm còn thiếu, có đề xuất và lý do.
-Không cần xác nhận lại thông tin hoặc quyền triển khai đã có.
-
-Điền `.harness/local.md` bằng thông tin thực của project:
-
-- Mục tiêu, phạm vi và quy tắc nghiệp vụ quan trọng.
-- Stack/phiên bản, database, cấu trúc service/module.
-- Lệnh build/test đã xác nhận chạy được.
-- Đường dẫn tài liệu BA, conventions và những ràng buộc cần giữ.
-
-Mở project trong AI IDE và giao yêu cầu, ví dụ:
-
-> Đọc AGENTS.md và .harness/local.md, chỉ nạp skill liên quan. Thêm API tìm kiếm khách hàng theo yêu cầu này: … Làm rõ điểm chưa chắc chắn, đề xuất acceptance scenarios; sau khi thống nhất scope, triển khai, chạy test phù hợp và báo cáo kết quả thực chạy.
-
-Bạn không cần gọi từng role/skill thủ công. Nếu host không tự phát hiện hướng dẫn, yêu cầu assistant đọc các đường dẫn trên. `aih skills` xem danh sách; `aih skill <tên>` đọc một skill khi cần.
-
-Review diff và kết quả test, rồi commit `AGENTS.md`, `.harness/`, `.agents/skills/` và tài liệu thay đổi cùng project. Sửa quy tắc riêng trong `.harness/local.md`; giữ nguyên snapshot do Harness quản lý.
-
-Lệnh/tool chung thuộc `.harness/environment.json`; đường dẫn máy riêng thuộc file ignored
-`.harness/machine.json`. `aih doctor` kiểm tra tham chiếu biến và sự hiện diện công cụ, không chạy chúng.
-Xem [cấu hình Maven nội bộ](project-configuration.md).
+| Spring Boot | `--adapters java-spring` |
+| React / Next.js | `--adapters react-nextjs` |
+| React Native / Expo | `--adapters react-native` |
+| Python AI / RAG | `--adapters ai-python` |
+| Astro tool / website | `--adapters astro` |
+| Spring + Next.js | `--adapters java-spring,react-nextjs` |
+| Viết tài liệu BA | `--capabilities product` |
 
-## 3. Tài liệu và spec khi cần
-
-Với capability `product`:
+Ví dụ vừa code Spring vừa viết tài liệu:
 
 ```bash
-aih new-doc prd-lite
+npx --yes @manhd_d/ai-harness init --adapters java-spring --capabilities product
 ```
 
-Lệnh tạo template `docs/product/prd-lite.md`; bạn và AI điền nội dung, nguồn và acceptance criteria. Chọn [Idea-driven](examples/idea-driven-project.md) nếu bắt đầu từ ý tưởng; chọn [Document-driven](examples/document-driven-project.md) nếu đã có tài liệu BA/Confluence.
-
-Khi một tính năng cần proposal/design/tasks/spec riêng:
-
-```bash
-aih new-change add-customer-search
-```
+Thêm `--capabilities uiux` khi cần UI/UX; `monetization` cho website có quảng cáo. [Danh mục đầy đủ](cli.md).
+Với project đã cài, đổi lựa chọn trong `.harness/project.json` rồi dùng `update`.
 
-Đây là bản nháp trong `openspec/changes/add-customer-search/`, chưa phải spec được duyệt.
-AI ghi câu trả lời thực tế trong `decisions.json`; kiểm tra bằng `aih ready add-customer-search --stage implement`.
-Sau code, ghi bằng chứng trong `verification.json` và chạy với `--stage review`. Xem [Change readiness](change-readiness.md). Sửa nhỏ, ít rủi ro có thể bỏ qua full spec với lý do rõ ràng; không bắt mọi task tạo đủ BRD/PRD/SRS.
+## 2. Mở AI và giao việc
 
-`aih new-change` không cần OpenSpec CLI. Chỉ cài OpenSpec riêng khi cần validator/archive của công cụ đó; xem [OpenSpec](openspec.md).
+Mở thư mục project trong công cụ AI, rồi gửi:
 
-## 4. Kiểm tra đúng thứ
+> Đọc AGENTS.md và .harness/local.md. Khảo sát code, tài liệu và lệnh test hiện có;
+> ghi context còn thiếu vào .harness/local.md, chỉ hỏi phần chưa rõ.
+> Thực hiện yêu cầu: [mô tả công việc]. Chạy test phù hợp, báo cáo kết quả và phần chưa kiểm chứng.
 
-| Lệnh | Ý nghĩa |
-| --- | --- |
-| `aih check` | Kiểm tra integrity của file Harness; không kiểm thử ứng dụng |
-| `aih doctor` | Kiểm tra công cụ và environment đã cấu hình; không chạy build/test |
-| `aih verify --scope all` | Xuất checklist, `executed: false`; không chạy build/test |
-| `aih eval --scope all` | Xuất tình huống và báo cáo chưa chấm; không gọi model |
-| Lệnh test của project | Do bạn, AI host hoặc CI thực chạy để xác minh code |
+Bạn có thể giao ý tưởng, tài liệu BA hoặc task code. Không cần gọi từng agent/skill.
+Với web/mobile, giao màn hình hoặc tính năng theo common/API/state/navigation hiện có; [skills đã có](frontend-mobile.md).
+Nếu công cụ chưa tự nạp hướng dẫn, xem [cách cấu hình công cụ AI](tool-setup/README.md).
+Lệnh `setup` chỉ xuất gợi ý thiết lập, không phải bước bắt buộc để bắt đầu.
 
-Một lần `aih check` thành công không có nghĩa tính năng đã đúng. Ghi lệnh test thực chạy, kết quả và phần chưa kiểm chứng trong PR. Xem [đánh giá hành vi AI](../evals/README.md) nếu muốn đo hiệu quả Harness.
+Review diff và test, rồi commit `AGENTS.md`, `.harness/`, `.agents/skills/` cùng code.
+Quy tắc riêng sửa trong `.harness/local.md`; giữ nguyên file do Harness quản lý.
+Lệnh/tool chung lưu trong `.harness/environment.json`; đường dẫn riêng máy trong `.harness/machine.json` được Git ignore. [Cấu hình Maven/JDK](project-configuration.md).
+Cấu hình model là tùy chọn trong `.harness/agents.json`; chọn model tương thích với công cụ AI: [hướng dẫn](agent-configuration.md).
 
-## 5. Cập nhật: CLI trước, project sau
+## 3. Thêm tài liệu khi cần
 
-Trên branch riêng, commit trạng thái hiện tại trước. Với cách cài global ở trên:
+Với `product` đã cài, tạo bản nháp yêu cầu:
 
 ```bash
-npm install -g @manhd_d/ai-harness@latest
-aih --version
-aih check
-aih update --dry-run
-aih update
-aih check
+npx --yes @manhd_d/ai-harness new-doc prd-lite
 ```
 
-`aih --version` là phiên bản CLI; `aih check` trả phiên bản snapshot trong project. `aih update` lấy bundle từ CLI đang cài (hoặc `--source`), **không tự tải npm**. Review diff, chạy test ứng dụng và commit snapshot/lock cùng nhau. Nếu báo drift, giữ lại thay đổi trong Git, chuyển tùy chỉnh sang `.harness/local.md` và khôi phục managed files trước khi update.
+Tính năng cần spec riêng: dùng `new-change <id>`; [hướng dẫn spec](change-readiness.md).
+Task nhỏ không cần bộ tài liệu đầy đủ. Không cần cài OpenSpec CLI để tạo bản nháp.
 
-Nếu cài local trong project, dùng `npm install --save-dev @manhd_d/ai-harness@latest` và `npx aih` thay cho `aih`.
+## 4. Kiểm tra và cập nhật
 
-## Đọc thêm theo nhu cầu
+`check` kiểm tra file Harness; `verify` xuất checklist. Code cần **test của project** và review thực tế.
 
-- [CLI reference](cli.md) · [Full SDLC](end-to-end-workflow.md) · [Skill matrix](skill-matrix.md) · [Agent handoffs](agent-handoffs.md).
-- [Spring Boot API](examples/spring-boot-api.md) · [Full-stack](examples/fullstack-web.md) · [React Native](examples/react-native-app.md) · [Python AI/RAG](examples/ai-rag-service.md).
-- [Astro micro-tools](examples/astro-micro-tools.md) · [Astro + AdSense](examples/astro-adsense-microtools.md).
-- [Release guide](npm-release.md): dành cho maintainer; merge source không đồng nghĩa npm đã có bản mới.
+Trước cập nhật, tạo branch và commit trạng thái hiện tại. Xem trước, áp dụng rồi kiểm tra:
 
-## Coding conventions
-
-Trước code, áp dụng [Project conventions](project-conventions.md): xác định new/maintain/mixed theo module, đọc chuẩn hiện có, tìm common và ghi lý do tạo mới. AI lưu nguồn và quyết định trong `.harness/local.md`; không hỏi lại thông tin đã rõ.
-
-## BA/PO/SA/PM and coding tools
-
-For a material new project choose `--capabilities product,architecture,delivery` with the actual adapter.
-Read [Solution workflow](solution-workflow.md) and the [setup guide for your coding tool](tool-setup/README.md).
-Skills/templates are selective context; use existing approved documents and compact notes when sufficient.
+```bash
+npx --yes @manhd_d/ai-harness@latest update --dry-run
+npx --yes @manhd_d/ai-harness@latest update
+npx --yes @manhd_d/ai-harness@latest check
+```
 
-## Agent model and execution preferences
+Review diff và chạy test project trước khi commit. Nếu có conflict, xem [cách xử lý](cli.md).
+Dùng thường xuyên có thể cài global: `npm install -g @manhd_d/ai-harness`, rồi dùng `aih` thay cho `npx --yes @manhd_d/ai-harness`. Nâng CLI global trước khi `aih update`.
 
-New installs seed `.harness/agents.json`: Sol recommended, hybrid/two concurrent agents only when
-supported; Luna low documentation, no automatic Astra escalation. Edit provider/model/reasoning and
-execution for your actual host. Use `aih setup --host codex` and [Agent configuration](agent-configuration.md).
-For a new economy consumer use `aih init --agent-preset economy`; never overwrite an existing config.
+[Tra cứu & ví dụ theo nhu cầu](README.md).

package/docs/skill-matrix.md

@@ -1,6 +1,6 @@
-# Skill matrix — 64 skills, 13 nhóm module
+# Skill matrix — 68 skills, 13 nhóm module
 
-Đây là bảng tra cứu **ID thật** theo `SKILL.md` trong source trên `main` (5 Core, 41 capability, 18 adapter). Dùng khi cần chuyển từ [Full SDLC](end-to-end-workflow.md) tới một skill cụ thể, không nạp toàn bộ 64 skill vào prompt.
+Đây là bảng tra cứu **ID thật** theo `SKILL.md` trong source trên `main` (5 Core, 41 capability, 22 adapter). Dùng khi cần chuyển từ [Full SDLC](end-to-end-workflow.md) tới một skill cụ thể, không nạp toàn bộ 68 skill vào prompt.
 
 **Cách dùng:** `aih skills` xem skills đã cài, sau đó `aih skill harness-...` lấy nội dung. Danh mục này mô tả chức năng; **không** có nghĩa `aih` thực thi skills hoặc agent. Tech adapters và capabilities chỉ xuất hiện trong consumer khi được chọn; Core dùng chung.
 
@@ -84,17 +84,21 @@
 | [`harness-java-spring-kafka-outbox`](../adapters/java-spring/skills/harness-java-spring-kafka-outbox/SKILL.md) | Async events | Outbox transaction và consumer dedupe | Event implementation + failure tests |
 | [`harness-java-spring-spring-api`](../adapters/java-spring/skills/harness-java-spring-spring-api/SKILL.md) | Backend API | Authorization resource scoped, API contract | Endpoint + auth/contract tests |
 
-## React / Next.js adapter (2)
+## React / Next.js adapter (4)
 
 | Skill ID (nguồn) | Khi nào dùng | Mục đích | Output mong đợi |
 | --- | --- | --- | --- |
+| [`harness-react-nextjs-feature-delivery`](../adapters/react-nextjs/skills/harness-react-nextjs-feature-delivery/SKILL.md) | Feature implementation | Reuse route/screen, UI/form and API/state boundaries | AC-linked diff/checks, actual results and explicit limits |
+| [`harness-react-nextjs-behavior-testing`](../adapters/react-nextjs/skills/harness-react-nextjs-behavior-testing/SKILL.md) | Behavior testing | Component/integration and actual browser/server evidence | AC-linked tests, actual results and explicit limits |
 | [`harness-react-nextjs-accessible-ui`](../adapters/react-nextjs/skills/harness-react-nextjs-accessible-ui/SKILL.md) | Frontend | UI states và semantic accessibility | UI + accessibility/browser evidence |
 | [`harness-react-nextjs-server-boundaries`](../adapters/react-nextjs/skills/harness-react-nextjs-server-boundaries/SKILL.md) | Frontend security | Server actions, auth/caching boundaries | Server/client diff + auth/cache tests |
 
-## React Native adapter (2)
+## React Native adapter (4)
 
 | Skill ID (nguồn) | Khi nào dùng | Mục đích | Output mong đợi |
 | --- | --- | --- | --- |
+| [`harness-react-native-screen-delivery`](../adapters/react-native/skills/harness-react-native-screen-delivery/SKILL.md) | Screen implementation | Reuse route/screen, UI/form and API/state boundaries | AC-linked diff/checks, actual results and explicit limits |
+| [`harness-react-native-behavior-testing`](../adapters/react-native/skills/harness-react-native-behavior-testing/SKILL.md) | Behavior testing | JS/navigation and separate platform/device evidence | AC-linked tests, actual results and blocked native checks |
 | [`harness-react-native-device-permissions`](../adapters/react-native/skills/harness-react-native-device-permissions/SKILL.md) | Mobile | Permissions + deep links theo OS | Permission/nav changes + platform tests |
 | [`harness-react-native-offline-sync`](../adapters/react-native/skills/harness-react-native-offline-sync/SKILL.md) | Mobile | Offline queue, retries, conflict resolution | Persistence/sync + edge-case tests |
 

package/docs/versioning.md

@@ -131,3 +131,12 @@ bundles use the CLI canonical seed if necessary. Existing configs are validated
 role gaps inherit/report project defaults. Inspect new payload/update diff; re-export eval reports after
 bundle changes. Revert consumer installation commit for rollback. Release update tests use relative
 versions instead of hardcoded 0.7.0, preserving downgrade refusal on future release branches.
+
+## Frontend/mobile coding and onboarding (unreleased)
+
+React/Next.js and React Native module contracts advance from 1.1.0 to 1.2.0 additively: existing skill
+IDs remain, feature/screen and behavior-testing skills plus manual checks/unscored cases are added.
+Project/lock/agent schemas and the distribution version stay unchanged. Existing consumers run the
+usual reviewed update dry-run/update/check; local.md, agents.json, native host config and app files are
+project-owned and preserved. Re-export eval reports after bundle changes; revert the consumer install
+commit for rollback. See [Frontend/mobile coding](frontend-mobile.md).

package/harness.yaml

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "name": "ai-harness",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "adapters": [
     "java-spring",
     "react-nextjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manhd_d/ai-harness",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Reusable AI development rules, skills and workflows with a safe local installer",
   "type": "module",
   "bin": {