h-onboard

Solid

First-setup ceremony for a project that does not yet use haft — the agent reads the repository, drafts the minimum FPF carriers (target system, enabling system, term map) from observed code/docs, and presents them to the operator for review. The operator is NOT asked to author spec files from scratch — that defeats the value of having an AI agent. Make sure to use this skill whenever the repository has no `.haft/` directory yet, when the user says "set up haft here", "onboard this project", "initialize FPF", "first time using haft in this repo", "let's add haft to this project", "scaffold haft for this codebase" — or whenever they want to start recording decisions but the artifact graph is not scaffolded. NOT for ongoing work in a project that already has `.haft/` (use h-status). NOT for framing one specific problem (use h-frame).

AI & Automation 1,338 stars 104 forks Updated today NOASSERTION

Install

View on GitHub

Quality Score: 89/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# h-onboard — First-impression FPF setup (agent-drafts, operator-reviews) You are onboarding a project to haft. **The agent does the work; the operator reviews.** Spec files are descriptive observation, not binding decisions — Transformer Mandate does NOT prohibit you from authoring them. Your job is to read the repository, infer the project's structure, and produce initial spec drafts. The operator's job is to correct what you got wrong. ## Step 1 — Check current state Run `mcp__haft__haft_query(action="status")` to confirm `.haft/` exists but has no active SpecSections. - `ready` → already onboarded; offer `/h-status` instead and stop. - `needs_init` → operator must run `haft init` from the CLI first (it installs MCP config + skills, this skill cannot do that). Stop and tell them. - `needs_onboard` → continue. ## Step 2 — Discover the project (agent reads repo) Read these in parallel before asking the operator anything: - `README.md`, `README.rst` if present - Project-config files: `package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, `Gemfile`, `composer.json`, etc. - Top-level: `LICENSE`, `CHANGELOG.md`, `CONTRIBUTING.md` - Source entry points: `src/`, `cmd/`, `lib/`, or whatever the project layout uses - Existing docs: `docs/`, `ADR/`, `decisions/` - Test layout: `tests/`, `__tests__/`, `*_test.go`, etc. - CI: `.github/workflows/`, `.gitlab-ci.yml`, `Taskfile.yaml`, `Makefile` From this you should be able to answer most of these on your own: - **What is the ...

Details

Author
m0n0x41d
Repository
m0n0x41d/haft
Created
6 months ago
Last Updated
today
Language
Go
License
NOASSERTION

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category