v3.2.0 — CLI scaffolding

What's new

npx create-pilot CLI

Scaffold Pilot into any project with a single command:

npx create-pilot
npx create-pilot ./prd.md     # with PRD
npx create-pilot --force      # overwrite existing

Changes

• New: bin/create-pilot.js CLI for instant scaffolding
• New: package.json for npm distribution
• Changed: Repo restructured as publishable npm package
• Changed: Template files renamed for cross-platform compatibility
  • .cursorrules → cursorrules (copied as .cursorrules)
  • claude.md.template → claude-md (copied as claude.md)
• Changed: README rewritten

Installation

npx create-pilot

Then open your LLM and say: Read BOOT.txt

v3.1.0

What's new

Contract ownership enforced

• Orchestrator writes /pilot/* (except REPORT)
• Builder writes code + REPORT only
• Violations count toward 3-attempt limit

Evidence required in REPORT

• git_diff_files — changed files list
• verify.output — last 20 lines of verify command
• Git is truth. REPORT is a claim to verify.

Forbidden reads are hard violations

• Opening .env, .key, .pem = protocol violation
• Even "for context" = attempt increment

Batch mode improved

• Minimum lowered from 3 to 2 tasks
• Must be independently shippable
• No overlapping write scopes

Verification tightened

• Git diff on ALL verifies (not just HIGH risk)
• Preflight branch check before verify
• Explicit attempt increment rules

Structure

• STATE.json moved to /pilot/STATE.json
• New: claude.md.template for Claude Code users
• New: DESIGN-CONTRACT.json for UI specs
• New: /pilot/skills/ for knowledge modules

Core vs Optional

• Core: STATE + TASK + REPORT + scope + verify + attempts
• Optional: ROADMAP, DESIGN-CONTRACT, REVIEW, skills

Start simple. Add modules as needed.

Pilot v2.0.0

What's New in v2.0.0

Complete architecture rewrite for OpenCode-native multi-agent orchestration.

Multi-Agent Architecture

Agent	Role	Tool
Orchestrator	Plans, dispatches, verifies	OpenCode (Claude, GPT, etc.)
Builder	Executes tasks, writes code	Cursor
Reviewer	Audits HIGH-risk changes	Gemini, ChatGPT, any LLM

JSON Contracts

Structured communication replaces markdown files:

• pilot/TASK.json — Work package definition
• pilot/REPORT.json — Execution results
• pilot/ROADMAP.json — Milestone tracking
• pilot/REVIEW.json — Escalation handling

Work Packages

Batch multiple subtasks to reduce handoffs:

Risk	Batch Size
LOW	3-5 subtasks
MED	2-3 subtasks
HIGH	1 task only

Risk-Based Verification

• Light verify (LOW): Run tests, quick scope check
• Full verify (MED/HIGH): Branch validation, ghost file detection, acceptance criteria

Git-Verified Trust

Claims in REPORT.json verified against git diff and git status. No self-reporting trust.

3-Strike Rule

3 failed verification attempts → HALT state → human intervention required.

---

Breaking Changes

• All .md contracts replaced with .json
• New file structure in /pilot
• Requires OpenCode or similar terminal-enabled AI tool

Migration from v1

Replace your /pilot folder entirely. v1 markdown files are not compatible.

Quick Start

git clone https://github.com/clementrog/pilot.git
cp -r pilot/pilot your-project/pilot
cp pilot/ORCHESTRATOR.md pilot/BOOT.txt pilot/STATE.json pilot/.cursorrules your-project/
mkdir -p your-project/prd

Then open your project in OpenCode and say: Read BOOT.txt

Pilot v1.0.0

Drop-in /pilot folder for AI coding workflows.

Install:

1. Download pilot-v1.zip
2. Extract
3. Copy pilot/ folder to your repo
4. Paste pilot/CLAUDE.md into your Claude project instructions
5. Give PRD to Claude and ask to Fill STATE.md and CONTEXT.md
6. Say "status"
7. Build