project-adopter

Detect project layouts and generate standard developer tooling and documentation.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/levonk/dotfiles --skill project-adopter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-adopter
Source: https://github.com/levonk/dotfiles/tree/main/home/current/.chezmoitemplates/config/ai/skills/software-dev/project-adopter
Command: npx skills add https://github.com/levonk/dotfiles --skill project-adopter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires devbox, just, direnv, and includes scripts (resource) components.

What problem does it solve?

This skill helps teams adopt and standardize a modern developer UX by orchestrating detection, configuration, and AI-driven workflows across a project.

Core Features & Use Cases

  • Integration with Project Detection: automatically detects an existing project layout and suggests standard tooling.
  • Automated Configuration: generates devbox.json, justfile, .envrc, README, AGENTS.md, and integration points with AI workflows.
  • AI-Integrated Workflow: ties into ai-development-loop for a structured 9-step development lifecycle.
  • Safe, Non-Destructive Adoption: leverages surgical-config to non-destructively edit configs with automatic backups and loop protection.

Quick Start

To adopt standard UX in a new or existing project, run the adoption script: ./scripts/adopt-project.sh /path/to/project

Frequently Asked Questions about project-adopter

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

FAQPage Schema
How do I set up a standard developer UX with devbox, justfile, and direnv?

To set up a standard developer UX, you can use an automated adoption script that detects your project layout and generates configuration files like devbox.json, justfile, and .envrc. This establishes consistent tooling and environment setup across your project.

What is AI-guided project adoption for developer UX?

AI-guided project adoption for developer UX is a process that orchestrates detection, configuration, and AI-driven workflows to establish standardized tooling. It integrates with project-detection and AI development loops to provide a deterministic and safe configuration process.

How do I generate AGENTS.md and README files for an AI development loop?

You can generate AGENTS.md and README files for an AI development loop by running an automated project adoption script. This script ties into a structured AI-integrated workflow, creating the necessary documentation and integration points for your team.

What do I need to configure before running a devbox and justfile project adoption?

Before running a devbox and justfile project adoption, you need the underlying dependencies installed: devbox, just, and direnv. The adoption process then uses these tools to detect your project layout and generate the required configuration files.

Are there limitations when non-destructively editing project configurations with surgical-config?

When non-destructively editing project configurations with surgical-config, the main limitation is relying on its automatic backup and loop protection mechanisms. You should ensure your existing project layout is correctly detected to prevent unexpected configuration conflicts.

Does project-adopter work for both new projects and existing project migrations?

Yes, project-adopter works for both new projects and existing project migrations. It applies detection and configuration workflows to establish a consistent developer UX, enabling standardized tooling and AI-assisted workflows across teams regardless of the project's age.