harness-bootstrap

Initialize a repository's Harness control plane with AGENTS.md, docs, and manifest.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Refinex-Space/Refinex-Skills --skill harness-bootstrap
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: harness-bootstrap
Source: https://github.com/Refinex-Space/Refinex-Skills/tree/main/skills/harness-bootstrap
Command: npx skills add https://github.com/Refinex-Space/Refinex-Skills --skill harness-bootstrap

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Bootstrap or initialize the repository's Harness control plane to enable deterministic agent work. This capability ensures cross-session continuity, verifiable progress, and drift detection by embedding a self-describing control plane into the repository.

Core Features & Use Cases

  • Phase-driven bootstrap: Phase 1 reconnaissance, Phase 2 control plane initialization, Phase 3 baseline verification.
  • Documentation scaffolding: root AGENTS.md, docs/ PLANS, ARCHITECTURE, OBSERVABILITY, exec-plans structure, and a generated harness manifest.
  • Drift protection: automated validation script and manifest-based checks to detect and repair drift while preserving unmanaged docs.
  • Declarative governance: explicit handling of managed vs unmanaged artifacts and a canonical control plane inventory.

Quick Start

Run harness-bootstrap to initialize the repository's Harness control plane.

Frequently Asked Questions about harness-bootstrap

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

FAQPage Schema
What is a repository control plane and when do I need to bootstrap one?▼

A repository control plane enables deterministic agent work by embedding self-describing structures for cross-session continuity. You need to bootstrap a control plane when initializing or upgrading a repository to ensure verifiable progress and drift detection.

How do I set up AGENTS.md and documentation scaffolding for deterministic agent work?▼

To set up documentation scaffolding, run a bootstrap process that creates a root AGENTS.md, docs directory with PLANS, ARCHITECTURE, OBSERVABILITY, exec-plans structures, and a generated manifest to guide agent exploration, planning, and verification.

Does bootstrapping a control plane preserve my existing unmanaged documentation?▼

Bootstrapping a control plane explicitly preserves unmanaged documents through declarative governance. It applies automated validation scripts and manifest-based checks to detect drift while maintaining existing files that fall outside its managed artifacts.

How does manifest-based drift detection work for repository documentation?▼

Manifest-based drift detection works by generating a machine-readable inventory of managed artifacts during initialization, then running an automated validation script to verify consistency and identify deviations from the canonical control plane state.

Can I use this bootstrap process for an upgraded repository or is it only for new repos?▼

You can use the control plane bootstrap for both new and upgraded repositories. It performs phase-driven initialization including reconnaissance, control plane setup, and baseline verification to establish or restore a deterministic working environment.