These guides apply across the Replica monorepo. Start with Contributing for setup and the contribution workflow.
Create your first local prototype walks you through the starter and canvas without Hub, then adding approved team guidance and building a useful prototype.
Set up shared hosting and team feedback starts with hosting requirements, then team guidance and a useful local prototype. Teams can arrange hosting alongside that work, then connect Hub, publish, and invite teammates.
Join your team's Replica environment walks authors through using an existing team repository and Hub, creating and publishing a prototype, sharing feedback, and adding controls.
Set up a prototype repository is the supporting agent guide for new or existing repository targets, starter installation, session handoff, and verification. People following the walkthroughs above do not need to follow its agent instructions.
- 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. Its operator walkthroughs cover VM installation, Azure DNS/HTTPS, GitHub App connection, updates, source builds, patches, and recovery.
- Starter development owns the catalog, shared bundle, assembly contract and checks. Minimal instructions and CoreAI instructions own their apps. The copied Replica instructions, workflow guide and troubleshooting guide use paths in the assembled repository.
- 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.