harness-adopt

Adopts Harness Engineering workflow into existing projects through non-destructive scanning and planning.

Updated May 15, 2026
One-click install
npx skills add https://github.com/Alan-IFT/harness-kit --skill harness-adopt-alan-ift
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: harness-adopt
Source: https://github.com/Alan-IFT/harness-kit/tree/main/skills/harness-adopt
Command: npx skills add https://github.com/Alan-IFT/harness-kit --skill harness-adopt-alan-ift

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding an AI-driven development workflow to a project that already has code, tests, and CI is risky: existing conventions, configs, and files like CLAUDE.md can be silently overwritten. This Skill scans the repository, extracts existing conventions, proposes an adoption plan, and applies it only after explicit user confirmation. ## Core Features & Use Cases - Repository Reconnaissance: Detects languages, frameworks, test runners, databases, CI systems, and existing rule files (README, CONTRIBUTING, .editorconfig, lint configs) to build a project profile. - Plan-Before-Apply Gating: Writes a PLAN.md listing every file to add, files it will not touch, and conflicts, then waits for an explicit "apply" before making any change. - Merge and Overwrite Modes: Never overwrites existing files without per-file confirmation; merges Claude Code hook settings per event and logs conflicts to CONFLICTS.md. - Use Case: You inherit a NestJS + Prisma backend with Vitest tests and GitHub Actions. Run the skill to detect the stack, extract conventions from CONTRIBUTING.md into a draft rules fragment, review the plan, and apply the 7-agent Harness workflow without touching source code or CI. ## Quick Start Tell the AI to run /harness-adopt in the root of your existing project to scan the codebase and propose a non-destructive Harness adoption plan.

Frequently Asked Questions about harness-adopt

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add an AI agent workflow to an existing project?▼

Run /harness-adopt in the project root. It scans the repo for languages, frameworks, test runners, and CI, extracts conventions from README and CONTRIBUTING, writes a plan to .harness-adopt/PLAN.md, and applies it only after you reply "apply".

What is the difference between harness-adopt and harness-init?▼

harness-adopt targets projects that already have code, tests, and CI, applying changes non-destructively with conflict gating. harness-init is designed for empty projects starting from scratch.

Will harness-adopt overwrite my existing CLAUDE.md or settings?▼

No. If .harness/, .claude/agents/, or CLAUDE.md already exist, the skill asks whether to cancel, merge, or overwrite. Merge mode skips conflicting files and logs them to CONFLICTS.md; overwrite mode prompts per file.

Does harness-adopt modify CI files or install packages?▼

No. The skill never modifies .github/workflows or other CI files and never runs package install commands like npm install, making it safe to run on an unfamiliar codebase.

What stacks and project types does harness-adopt detect?▼

Detection covers Node (package.json with Next, Nest, Vite, Prisma), Python (pyproject.toml, requirements.txt with FastAPI, Django, Flask), Go (go.mod), and Rust (Cargo.toml). It infers fullstack versus backend type and asks for confirmation.

What are the limitations of harness-adopt?▼

Stack detection covers Node, Python, and Go basics only; exotic stacks need manual edits. Rule extraction is keyword and heading based rather than semantic, and conflict resolution is per-file keep-or-overwrite with no three-way merge.