[nshki]

Why

To continue improving how agents work in this codebase.

What changes

A few clarifying pieces of documentation were added. I ran tests with sub-agents to ensure that the changes resulted in desired behavior. The added documentation was based on sessions and PR feedback from the past couple weeks across the team.

[Copilot]

🔵 Needs a closer look

The PR makes broad repository-wide changes to agent, testing, documentation, authoring, review, and stacked-PR guidance that require maintainer confirmation against team policies, schema/type patterns, and GitHub’s supported workflow.

No open issues 🎉

What changed in this PR

This documentation-only pull request improves guidance for agent-assisted development and review across Replica, covering Hub TypeScript organization, meaningful testing, design discussions, and stacked pull requests.

Changes:

• Clarifies where Hub constants, schemas, types, and implementation details should live.
• Expands guidance for meaningful success, failure, security, and data-loss test coverage.
• Refines design-question responses and preserving agreed requirements.
• Documents the expected GitHub stacked pull request workflow.

File	Summary	Review findings
hub/​docs/​coding-conventions.md	Adds Hub TypeScript organization guidance.	Nit: Separate or scope schema and constant guidance to match existing Hub patterns.
docs/​testing-and-review.md	Expands guidance on meaningful coverage and avoiding redundant tests.	Nit: Remove the routine test-summary sentence from the pull request description or replace it with a concrete verification gap.
docs/​documentation-conventions.md	Clarifies design-question responses and maintaining agreed requirements.	No comments.
CONTRIBUTING.md	Documents the GitHub stacked pull request workflow.	No comments.

_{Review effort: Lite (auto)}