Craft Adopt

One workflow to make a project Craft-ready. Does not copy upstream skills — scaffolds project artifacts, installs domain skill profiles, and verifies local installs.

Quick Start: 1-Click Domain Skill Installer

From your Craft clone, run the unified installer for any domain profile (saas, engineering, product, uiux, all):

# 1-Click Install for specific domain profile
bash scripts/craft-install.sh --profile saas --project-dir /path/to/project

# Or install all profiles
bash scripts/craft-install.sh --profile all

When to use

• New greenfield or brownfield project adopting Craft
• User says: "adopt craft", "set up engineering ledger", "bootstrap craft", "install craft skills"
• After cloning Craft on a new machine (verify deps or setup domain profiles)

When NOT to use

• Questions about what Craft is (read README)
• Adding a new skill to craft repo (use craft-promote or manual skill authoring)

Domain Skill Profiles

Craft v0.2.0 organizes skills into purpose-built domain profiles:

Workflow

1. Verify machine dependencies & install profile

Run the 1-click installer:

bash scripts/craft-install.sh --profile saas

Or verify existing dependencies:

bash $CRAFT/skills/craft-adopt/scripts/verify-deps.sh

2. Scaffold ledger in target project

TARGET=/path/to/project
CRAFT=/path/to/craft   # local clone path

mkdir -p "$TARGET/docs/engineering-ledger"
mkdir -p "$TARGET/docs/decisions"

cp "$CRAFT/skills/engineering-ledger/templates/"* "$TARGET/docs/engineering-ledger/"

Initialize INDEX.md with project name, date, phase Shape, and link to AGENTS.md.

3. Wire AGENTS.md

Append (do not replace existing content):

## Craft (Orchestration, Skills & Ledger)

- **Read Ledger First**: Non-trivial work must read `docs/engineering-ledger/INDEX.md` and active phase in `phases.md` before taking action.
- **Mandatory Skill-First Routing**: Every discussion, architecture design, development, and debugging task **must flow through the corresponding skill** in `.agents/skills/`. Before executing any phase, cross-check installed skills and load the best domain skill:
  - *Ideation & Discovery*: Load `idea-refine` or `interview-me` to sharpen ambiguous requirements.
  - *System Architecture & Design*: Load `system-design` (stress-test failure modes, trade-offs, scaling, data models) along with building blocks (`api-design`, `architecture-diagram`, `caching`, `resilience-failure`, `data-storage`, `messaging-streaming`).
  - *Specification & Decisions*: Load `spec-driven-development`. For irreversible forks, create an ADR in `docs/decisions/` per `documentation-and-adrs`.
  - *Implementation & TDD*: Load `incremental-implementation` for thin slices and `test-driven-development` (Red-Green-Refactor).
  - *Debugging & Errors*: Load `debugging-and-error-recovery` (systematic root cause analysis, never guess).
  - *Verification & Quality*: Load `constraint-driven-development` and `code-review-and-quality` before completing features.
  - *UI / Frontend*: Load `ui-ux-pro-max` and `frontend-ui-engineering`.
- **Anti-Drift**: Use the single best skill for the active phase (via `using-craft`). Never bypass skills or invent ad-hoc processes when an established skill exists.
- **Phase Transition Thresholds**: Never jump phases without satisfying the previous phase's exit gate evidence in `phases.md`. Anti-drift thresholds must be verified before proceeding to prevent premature implementation.
- **Market Validation Gate**: In `docs/northstar.md`, evaluate the Market Validation Score (0–10). A score of >= 7/10 is required to enter `Build`. If < 7, stop or pivot.
- **Durable Ledger Updates**: Append tactical decisions (`DR-###`) and lessons (`LL-###`) to `docs/engineering-ledger/`, and update `INDEX.md` before ending substantive sessions.

4. Optional project manifest pointer

Create $TARGET/craft.project.yaml:

craft_version: "0.2.0"
profiles:
  - saas
  - engineering
ledger_path: docs/engineering-ledger
adr_path: docs/decisions
manifest_ref: DTiapan/craft craft.manifest.yaml

5. Initialize phases.md

Set first phase row to in_progress for current work (usually Shape or Build for brownfield).

Verification gate

Before claiming adopt complete:

• docs/engineering-ledger/ has INDEX, phases, attack-plans, decisions, lessons
• docs/decisions/ exists (may be empty)
• AGENTS.md mentions Craft + ledger path
• verify-deps.sh passes (or 1-click installer executed)
• No upstream SKILL.md files copied into project

Anti-patterns

Artifacts

See also docs/adoption.md.