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.