harness-init

What problem does it solve?

Many client analytics engagements start with repetitive, inconsistent repository setup and documentation creation, which wastes time and introduces variability in standards. This Skill removes manual scaffolding work and enforces a consistent one-shot-build harness so agents and developers start from the same structured baseline.

Core Features & Use Cases

• Idempotent Scaffolding: Creates a kyros-agent-workflow directory tree and seed documents and safely re-applies template updates without overwriting unrelated content.
• Template Processing & CLAUDE.md Handling: Replaces PROJECT_NAME and CREATED_DATE placeholders, inserts or replaces harness sections inside CLAUDE.md using marker-aware logic, and appends when needed.
• Repo Initialization & Safeguards: Detects existing one-shot-build projects to avoid accidental overwrite, optionally initializes git, and makes an initial commit for reproducible project bootstrapping.
• Use Case: Start a new client analytics engagement and instantly produce a standardized repository layout, coding standards, definition-of-done, and critical patterns for downstream agent workflows.

Quick Start

Run harness-init, provide the project name when asked, and allow the harness to create the kyros-agent-workflow structure and CLAUDE.md in the current directory.