Back to list
mylukin

init-harness

by mylukin

Stop AI agents from half-building features. Ship complete code in one session.

243🍴 20📅 Jan 23, 2026

SKILL.md


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

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

User SaysTDD ModeEffect
"strict TDD" / "require tests"strictTests REQUIRED - check/done fail without tests
"recommended" / "optional tests" / (default)recommendedTests suggested but not enforced
"disable TDD" / "no TDD"disabledNo TDD guidance

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

Modes

ModeCommandEffect
Merge (default)agent-foreman initKeep existing + add new features
Freshagent-foreman init --mode newReplace all features
Previewagent-foreman init --mode scanShow without changes

Task Types

TypeCommandUse Case
Code (default)agent-foreman initSoftware development
Opsagent-foreman init --task-type opsOperational tasks, runbooks
Dataagent-foreman init --task-type dataETL, data pipelines
Infraagent-foreman init --task-type infraInfrastructure provisioning
Manualagent-foreman init --task-type manualManual-only verification

Auto-Detection

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

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

Score

Total Score

60/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

+5
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

+5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon