This repository is the single source of truth for improving the Harness Pi setup: a practical, powerful, and maintainable AI coding assistant built on Pi.
It is a documentation-first engineering blueprint. It is not a codebase and not a random collection of notes.
- Read AI_CONTEXT.md — everything a fresh agent or contributor needs on first contact.
- Read docs/BOOTSTRAP_SPEC.md — the constitution. It governs how this repository changes.
- Read docs/SETUP.md — what is currently installed and how to rebuild it.
- Read PROJECT_STATE.md — where the project stands right now.
See AI_CONTEXT.md for the full map of documents and their responsibilities.
- The repository is the source of truth. Never rely on chat history.
- Every fact has exactly one owner file; other files reference, never restate (see the ownership matrix in
docs/BOOTSTRAP_SPEC.md). - Secrets are never committed. See the Secrets Policy in the constitution.
- Every setup change updates the inventory and the changelog in the same session.
- Initialized 2026-08-02 as Milestone 1 of Bootstrap Specification v1.1.
- See ROADMAP.md for candidate milestones.
- See implementation/TODO.md for concrete tasks.