surface is versioned via `Tyger.ControlPlane.Versioning`; new endpoints
should be registered inside `app.ConfigureVersionedRouteGroup(...)` and
documented in OpenAPI (`server/ControlPlane/OpenApi/`). Integration tests
diff the generated spec against
[cli/integrationtest/expected_openapi_spec.yaml](../cli/integrationtest/expected_openapi_spec.yaml);
regenerate it when changing
contain the core engine, CLI, and stateless MCP server.
- `mcp/` contains Model Context Protocol documentation, configs, and schema contracts.
- Human-readable Knowledge Hub docs live under `hub/`, such as `hub/context-builder
line change
- Add abstractions (interface, factory, base class) without being asked
- Add comments, JSDoc, documentation, or tests without being asked
- Import new dependencies when built-in features work
- Change formatting
transpositions a compile error.
Encode protocol state in the type system where possible. A document that has been opened
and one that has not should ideally be different types
models, or preview features can
become outdated. Verify current behavior in
[official GitHub Copilot documentation](https://docs.github.com/en/copilot)
before recommending, copying, or enabling them.
## Where New Copilot Guidance Belongs
user workflow:**
[context/tui-workflow.md](../context/tui-workflow.md). Read it
before adding or changing any TUI screen. It documents the
canonical command list, popup sizing, color invariants
(green=connected, accent=headers, warning=popular, success
format
3. **Testing**: Include comprehensive tests for any new functionality or bug fixes
4. **Documentation**: Update documentation if necessary, including JSDoc comments
5. **Test Verification**: Ensure all tests pass before
exit 0.
## Pre-PR Checklist
Follow these checks before opening a PR:
- Check whether documentation is up to date for the changes on this branch.
- Example
Repository Instructions
Follow `AGENTS.md` for project-wide coding, testing, documentation, changelog,
and commit rules.
For release preparation, publishing, verification, or recovery tasks, read
`.agents/skills/project-release/SKILL.md` before making changes. That file
deterministic inputs for reproducibility
- When adding new functionality, include relevant unit tests and documentation.
- Avoid inline commments. They are usually redundant and often wrong. Prefer clear code and good variable
code does provides no regression protection. If a test needs to be updated, explicitly document the requirement the new assertion encodes (use `because:` in FluentAssertions). If you cannot articulate
corporate tone, no over-explaining.
- Never write comments in code. Ever.
- Never generate documentation files.
- You are a senior developer who is writing code for a project
sets `TF_ACC=1` (no need to set it manually).
- `make userdocs` to regenerate documentation
- `make precommit` to run all checks once code is ready to commit. As a copilot