These guides apply across the Replica monorepo. Start with Contributing for setup and the contribution workflow.
Get started with Replica walks new users through installing Copilot, adding their team's repository and canvas, creating and publishing a prototype, sharing feedback, and adding controls.
Set up a prototype repository guides agents through new or existing repository targets, starter installation, the fresh-session handoff, and a verified local preview before optional product guidance or team setup.
Set up and configure your prototype environment walks environment maintainers through creating the shared repository, adding design-system guidance and templates, deploying Hub with Docker, connecting builds, and inviting the team.
- Coding conventions: small, complete changes and behavior-focused tests.
- Documentation conventions: plain language, product discussions, and useful diagrams.
- Testing and review: choosing checks, reviewing changes, and dependency updates.
Commits and pull requests follow the contribution conventions. Agents start with the root instructions, then read the instructions for the area they are changing.
- Hub documentation covers the Rails application, deployment, previews, and review collaboration.
- Starter instructions and setup guide cover the copyable prototype app and skills.
- Build action setup covers the shared action.
- Controls documentation covers the shared engine and definition schema owned by Hub.
- Prototype canvas covers the Copilot plugin and injected Controls integration.
Keep project-specific behavior and commands in those guides. The starter is copied into independent repositories, so its instructions must work without this monorepo's root documentation.