Project Template

This repository is a reusable starting point for software projects: websites, backends, ML systems, AI agents, SQL/data projects, CLI tools, libraries, and other engineering work.

After cloning, start by telling the agent what the project is about. The agent should use board/milestone-000-bootstrap.md to fill the project identity, commands, documentation map, and quality gates before broad implementation.

First Use

1. Open AGENTS.md.
2. Answer the project bootstrap questions.
3. Let the agent update the project-specific files.
4. Start work from BOARD.md, one task id at a time.

Repository Layout

AGENTS.md                  Agent operating instructions
CLAUDE.md                  Claude Code entrypoint, delegates to AGENTS.md
BOARD.md                   Board index and task protocol
board/                     Active milestones and task lists
board/archive/             Completed milestone files
docs/                      Architecture, contracts, runtime flows, decisions
agent-skills/              Canonical source for project skills
.agents/skills/            Codex repo-local skills
.claude/skills/            Claude Code repo-local skills
tools/sync_skills.py       Optional maintenance tool for skill copies

Template Rule

Do not treat placeholder commands, domains, or architecture notes as facts. Replace them during project bootstrap.