/project-onboarding-adapter

name: project-onboarding-adapter
description: 'Adapt frontend projects, configure supported agent roles, or diagnose WebDev setup read-only. Excludes app code and model changes during updates.'
id: 'agents.skills.project-onboarding-adapter.skill'
title: 'Project Onboarding Adapter'
doc_type: 'skill'
layer: 'skill'
status: 'active'
publishable: true
local_only: false
skill: 'project-onboarding-adapter'
tags:
    - 'agents/skill-package'
    - 'agents/onboarding'
    - 'frontend/project-context'
parent: []
related:
    - '[[skills/project-onboarding-adapter/references/langfuse-installation]]'
    - '[[skills/project-onboarding-adapter/references/installation-diagnostics]]'
    - '[[skills/project-onboarding-adapter/references/claude-agent-bootstrap]]'
    - '[[templates/project/claude-agent-profile]]'
    - '[[templates/project/model-routing-profile]]'
    - '[[skills/project-onboarding-adapter/references/codex-model-bootstrap]]'
    - '[[skills/project-onboarding-adapter/references/model-workload-matrix]]'
    - '[[common/host-instruction-migration-rules|Host Instruction Migration]]'
    - '[[common/project-fact-provenance-rules|Project Fact Provenance]]'
    - '[[templates/project/verification-profile|Verification Profile Template]]'
    - '[[common/core/runtime-core-policy|Portable Runtime Core Policy]]'
    - '[[common/readme-policy|README Read And Edit Policy]]'
    - '[[profiles/react-typescript/PROFILE|React TypeScript Profile]]'
    - '[[skills/project-onboarding-adapter/references/adaptation-checklist|Adaptation Checklist]]'
    - '[[skills/project-onboarding-adapter/references/path-audit-checklist|Path Audit Checklist]]'
    - '[[common/client-adaptation-policy|Client Adaptation Policy]]'
    - '[[common/tool-capability-model|Tool Capability Model]]'
    - '[[common/mcp-installation-policy|MCP Installation Policy]]'
    - '[[common/target-stack-policy|Target Stack Policy]]'
    - '[[common/skill-applicability-policy|Skill Applicability Policy]]'
    - '[[common/context-compaction-rules|Context Compaction Rules]]'
    - '[[templates/project/client-profile|Client Profile Template]]'
    - '[[templates/project/mcp-profile|MCP Profile Template]]'
    - '[[skills/project-context-adapter/SKILL|Project Context Adapter]]'
    - '[[skills/mcp-toolchain-manager/SKILL|MCP Toolchain Manager]]'
depends_on:
    - '[[AGENTS|Canonical Agent Policy]]'

Project Onboarding Adapter

Purpose

Adapt this `.agents` bundle to a host frontend project without creating application source files. For React or Next.js, cache normal target-stack facts. For a non-target frontend project, cache only the detected stack boundary and the framework-agnostic skills that remain usable.

Onboarding must also adapt natively to the installed client target. It creates or refreshes the smallest appropriate host pointer, records client facts in local-only `project/client-profile.md`, and records tool capabilities in local-only `project/mcp-profile.md`.

Natural Language Trigger Aliases

Route adaptation, initialization, and project-context bootstrap commands here, including `адаптируйся`, `инициализируй .agents`, and `Adapt this .agents bundle to my project.` Full Codex onboarding includes model setup; explicit GPT requests also trigger that phase. A facts-only request does not.

When To Use

• The user asks to check WebDev installation or diagnose inactive subagents.

• The user explicitly requests economical GPT subagent setup or reconfiguration in a supported Codex project.
• The user asks to adapt this bundle to a new React or Next.js project.
• The user asks to adapt this bundle to a non-target frontend project while keeping applicable design, QA, review, lint, planning, MCP, context, and skill-authoring workflows.
• The user asks to create or refresh the host-root pointer, native client pointer, local project overlays, MCP profile, client profile, design-reference profile, verification facts, loop memory, or path indexes.

When Not To Use

• An existing Kit needs a version update: use `webdev-kit-updater`, preserving

existing project overlays instead of repeating onboarding.

• Ordinary screenshot-to-code implementation.
• Narrow project overlay refresh after implementation.
• Reusable skill authoring.
• Application scaffolding, package installation, or source file creation.
• Stack-specific React/Next architecture or implementation guidance for a non-target frontend project unless the user explicitly changes the supported stack.

Diagnostic Branch

For installation checks or questions about inactive subagents, read `references/installation-diagnostics.md` and follow only that read-only branch. Do not continue into the adaptation workflow or model bootstrap.

Required Context

1. Read the host-root native instruction pointer if present and needed for adaptation: `AGENTS.md`, `CLAUDE.md`, or client rules. Inspect the minimal pointer section for detection; read the entire file for requested migration using `common/host-instruction-migration-rules.md`. 2. Read bundle-local `AGENTS.md` when shipped and `common/core/runtime-core-policy.md`. Native plugins use their generated skill prelude; do not require an absent shared-policy entrypoint. 3. Read `common/client-adaptation-policy.md` and only the adapter for the resolved canonical target. 4. Read `profiles/react-typescript/PROFILE.md` and its owning policies only when repository evidence confirms the profile. 5. Read `common/skill-applicability-policy.md` when the detected or suspected stack is outside the target stack. 6. Read `common/tool-capability-model.md` and `tool-capabilities-manifest.json` for capability selection. 7. Read `common/context-compaction-rules.md` when loop memory or resumable workflow setup is requested. 8. Read existing `project/**` overlays when present. 9. Inspect only relevant manifests, configs, source entrypoints, routes, styles, assets, and verification scripts. 10. Read `templates/project/client-profile.md` and `te