Wildcat Crossroads Harness

Wildcat Crossroads Harness is a portable project harness for AI-agent-led software work.

It creates the operating system around a repo: agent contracts, workflow rules, tracker setup, docs taxonomy, testing and eval guidance, production intake, observability, secrets policy, release discipline, Obsidian mirrors, and self-improvement loops.

It does not try to build the app for you. It builds the harness that helps agents and humans build real software progressively, safely, and with less drift.

Install

Run it without installing:

npx wildcat-harness wildcat --help

Or install globally:

npm install -g wildcat-harness
wildcat --help

Requires Node.js >= 22.

Status

Early (v0.1.0): the TypeScript CLI and the core value loop — init, update, doctor, links, plus tracker, Obsidian, e2e, evals, and sandbox commands — are implemented, and the harness dogfoods its own repository. Brownfield adoption analysis is post-v1.

The canonical design lives at:

• docs/design/wildcat-crossroads-harness.md

CLI

wildcat setup profile
wildcat init
wildcat setup
wildcat setup github-project
wildcat setup obsidian
wildcat doctor
wildcat update
wildcat index
wildcat librarian
wildcat e2e
wildcat evals
wildcat sandbox

Core Idea

Safety rails, not train tracks.

Wildcat should be deterministic where repeatability matters, advisory where project context matters, and explicit about which parts are active, stubbed, advisory, or disabled.

First Implementation Path

1. Finish the canonical design spec.
2. Add TypeScript CLI skeleton with strict schemas.
3. Implement wildcat setup profile.
4. Implement greenfield wildcat init.
5. Harden the foundation (update-safe locks, managed regions, thin adapter projections) and dogfood on real repos.
6. Add wildcat update, doctor, and links — the core value loop.
7. Add GitHub Project setup (lite) and Obsidian cockpit support.
8. Add e2e, evals, sandbox, and librarian loops.
9. Post-v1: brownfield analysis and adoption plans.

Harness

This repository is managed with Wildcat Crossroads Harness — it dogfoods its own tool. Start here:

• AGENTS.md — canonical agent contract.
• WORKFLOW.md — how work moves through this repo.
• docs/harness/index.md — harness cockpit and reading gate.
• docs/adoption-checklist.md — how the harness was adopted by hand (brownfield).

License

MIT © Jeremy Hoenig