skills.rest
m0n0x41d
m0n0x41dCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

h-onboard

Bootstraps Haft project memory and prepares profile reviews through one onboarding surface.

1.4k|102|Updated Dec 10, 2025
Search Tags:#project memory#mcp#Onboarding#Setup#Governance#haft#profile review
One-click install
npx skills add https://github.com/m0n0x41d/haft --skill h-onboard
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: h-onboard
Source: https://github.com/m0n0x41d/haft/tree/main/internal/cli/skill/h-onboard
Command: npx skills add https://github.com/m0n0x41d/haft --skill h-onboard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up Haft governance in a repository involves initialization, project-profile declaration, and specification orientation, and doing these steps ad hoc risks inconsistent state or unreviewed profile changes. This Skill provides one readable onboarding contract that detects setup status, prepares profile reviews, and routes only explicit human decisions into canonical state.

Core Features & Use Cases

  • Status Detection: Reads a single closed onboarding status (needs_init, needs_profile, profile_review_ready, ready) via the haft_onboard MCP tool and drives the correct next step.
  • Profile Review Preparation: Prepares non-binding project-profile reviews from repository detection or explicit operator scopes, with evidence paths and realization kinds, while keeping canonical profile changes as explicit human acts.
  • Bounded Relation Changes: Prepares predecessor-pinned profile-change reviews for adding or replacing a single scope entity reference, failing closed if the ledger head changed.
  • Use Case: A developer clones a repository with no Haft state, asks the agent to set up project memory, and the Skill runs haft init, prepares a scope profile review from repository evidence, and waits for the operator's explicit approval before applying it.

Quick Start

Ask the agent to onboard this repository with Haft and set up project memory for the current project.

Frequently Asked Questions about h-onboard

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

FAQPage Schema
How do I set up Haft project memory in a new repository?▼

Run haft init to create the .haft state directories and default project memory, then call the haft_onboard status action to confirm readiness. The Skill handles this sequence automatically and never asks you to configure memory schemas manually.

How do I declare a project profile for Haft onboarding?▼

Use the profile_prepare action, which either detects scopes from repository evidence or accepts explicit scopes with a basis, label, realization_kind, and evidence paths. The result is a non-binding review carrier; applying it requires an explicit operator request through haft onboard profile apply.

Can Haft onboarding change my project profile automatically?▼

No. Automatic onboarding may inspect and prepare reviews, but applying any profile or relation change requires a direct, unambiguous operator request. Profiles with human-authored or legacy provenance are never replaced through the automatic path.

What does the ready onboarding status actually mean?▼

The ready status means only that project setup is complete: the canonical profile and structured project memory are available. It does not establish specification applicability, spec health, or release readiness, which require separate checks via h-spec or haft spec status.

Why does profile_prepare return needs_scope_review?▼

It returns needs_scope_review when repository detection cannot establish a scope basis, and it writes no canonical profile state in that case. Supply explicit scopes with a readable basis and evidence paths to proceed.

Related Skills

Explore More Software Engineering Skills→
JubaKitiashviliJubaKitiashvili
41

erne-init

Initialize ERNE agents and dashboard in a React Native/Expo project.

Community
Advanced
SpreadWorksSpreadWorks
2

sdd-forge.flow-impl

Orchestrate the SDD implementation workflow with gate checks and progress tracking.

Official
Advanced
mengblommengblom

decision-log

Document major decisions with context and rationale in markdown records.

Community
Basic
michaelvolzmichaelvolz

setup

Guide contributors to rely on ce:review's automatic reviewer selection.

Community
Basic