AlignFirst Setup Guide

A one-time companion for setting up a consumer repository. It installs any subset of three independent tools:

• docmap — agent-discoverable documentation under docs/.
• workspace — worktree-based concurrent local dev environments.
• alignfirst skills — collaborative spec/plan/AAD/review protocols.

Pick any combination. Each has its own reference; this skill investigates the repo, agrees on scope, then follows the matching reference(s).

The entry-point files

A project has up to three Markdown entry points, one per reader:

• README.md — the human coder, and the one-time setup of a fresh clone (machine installation, plans repository link, main-worktree bootstrap).
• AGENTS.md (or CLAUDE.md) — the coding agent (Claude Code, alcode). The Step 3 references write their agent instructions here.
• DEVELOPMENT.md — the AI coder: an autonomous bot. Recurring operating knowledge only; setup-once procedures belong in README.md. It must reference neither README.md nor AGENTS.md.

The rest of the documentation (docs/, served by docmap) addresses everybody. The entry points are read every session, docs/ on demand — so anything consulted occasionally goes there, including multi-step procedures such as creating a merge request or writing a changeset. Move the whole procedure and leave no summary behind in an entry point.