init-harness

@mylukin/init-harness

mylukin

240

20 forks

Updated 1/18/2026

View on GitHub

Creates AI agent task management structure with feature backlog (ai/tasks/), TDD enforcement, and progress tracking. Use when setting up agent-foreman, initializing feature-driven development, creating task backlog, or enabling TDD mode. Triggers on 'init harness', 'setup feature tracking', 'create feature backlog', 'enable strict TDD', 'initialize agent-foreman'.

Installation

$skills install @mylukin/init-harness

Claude Code

Cursor

Copilot

Codex

Antigravity

Details

Repositorymylukin/agent-foreman

Pathplugins/agent-foreman/skills/init-harness/SKILL.md

Branchmain

Scoped Name@mylukin/init-harness

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions

name: init-harness description: Creates AI agent task management structure with feature backlog (ai/tasks/), TDD enforcement, and progress tracking. Use when setting up agent-foreman, initializing feature-driven development, creating task backlog, or enabling TDD mode. Triggers on 'init harness', 'setup feature tracking', 'create feature backlog', 'enable strict TDD', 'initialize agent-foreman'. allowed-tools: [Bash, Read, Glob, Grep, Write, Edit] user-invocable: true

⚡ Init Harness

One command: agent-foreman init

Quick Start

agent-foreman init

Creates: ai/tasks/, ai/progress.log, ai/init.sh, CLAUDE.md

TDD Mode (Default: Recommended)

During init, you'll be prompted for TDD mode. Recommended is the default (tests suggested but not required).

User Says	TDD Mode	Effect
"strict TDD" / "require tests"	`strict`	Tests REQUIRED - check/done fail without tests
"recommended" / "optional tests" / (default)	`recommended`	Tests suggested but not enforced
"disable TDD" / "no TDD"	`disabled`	No TDD guidance

The prompt auto-skips after 10 seconds with recommended mode.

Modes

Mode	Command	Effect
Merge (default)	`agent-foreman init`	Keep existing + add new features
Fresh	`agent-foreman init --mode new`	Replace all features
Preview	`agent-foreman init --mode scan`	Show without changes

Task Types

Type	Command	Use Case
Code (default)	`agent-foreman init`	Software development
Ops	`agent-foreman init --task-type ops`	Operational tasks, runbooks
Data	`agent-foreman init --task-type data`	ETL, data pipelines
Infra	`agent-foreman init --task-type infra`	Infrastructure provisioning
Manual	`agent-foreman init --task-type manual`	Manual-only verification

Auto-Detection

ARCHITECTURE.md exists → use it (fast)
Source code exists → AI scan + auto-save ARCHITECTURE.md
Empty project → generate from goal

Pre-Init (Recommended)

For existing projects:

agent-foreman init --analyze    # First: understand project
agent-foreman init              # Then: create harness

Created Files

ai/
├── tasks/              # Task backlog (modular markdown)
│   ├── index.json      # Task index
│   └── {module}/       # Module directories
│       └── {id}.md     # Individual tasks
├── progress.log        # Session audit log
├── init.sh             # Bootstrap script
└── capabilities.json   # Detected test/lint/build
CLAUDE.md               # AI agent instructions
docs/ARCHITECTURE.md    # Auto-generated architecture doc

More by mylukin

View all

feature-next

240

Implements a single task following the next → implement → check → done workflow with TDD support. Use when working on one specific task, implementing a single feature from the backlog, or following TDD red-green-refactor cycle. Triggers on 'next task', 'next feature', 'implement feature', 'work on feature', 'single task mode', 'what should I work on'.

feature-run

240

Executes unattended batch processing of all pending tasks with autonomous decision-making. Use when running all tasks automatically, batch processing without supervision, completing entire feature backlog, or working on a specific task by ID. Triggers on 'run all tasks', 'complete all features', 'batch processing', 'unattended mode', 'auto-complete tasks', 'run feature'.

foreman-spec

240

Multi-role requirement analysis and task breakdown workflow using 4 specialized AI agents (PM, UX, Tech, QA). Each agent conducts web research before analysis to gather industry best practices, case studies, and current trends. Supports Quick Mode (parallel, ~3 min, one Q&A session) and Deep Mode (serial, ~8 min, Q&A after EACH agent so answers inform subsequent analysis). Triggers on 'foreman-spec', 'spec feature', 'break down requirement', 'define tasks', 'spec this'.

project-analyze

240

Scans codebases to generate architecture documentation (ARCHITECTURE.md). Use when joining an existing project, understanding codebase structure, exploring project architecture, or preparing for agent-foreman init. Triggers on 'analyze project', 'understand codebase', 'explore architecture', 'scan project structure', 'survey project'.