Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
381 changes: 97 additions & 284 deletions AGENTS.md

Large diffs are not rendered by default.

3 changes: 2 additions & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,8 @@ Mobile app: [apps/mobile/README.md](../apps/mobile/README.md)
## Working on T3 Code

Everything below is for maintainers. Setup lives in the [root README](../README.md);
policy in [CONTRIBUTING.md](../CONTRIBUTING.md); agent rules in [AGENTS.md](../AGENTS.md).
policy in [CONTRIBUTING.md](../CONTRIBUTING.md); fork branch model and agent rules in
[AGENTS.md](../AGENTS.md).

- [Architecture overview](./internals/overview.md)
- [Workspace layout](./internals/workspace-layout.md)
Expand Down
35 changes: 0 additions & 35 deletions docs/fork-base.md

This file was deleted.

44 changes: 0 additions & 44 deletions docs/fork-stack.md

This file was deleted.

14 changes: 7 additions & 7 deletions docs/internals/scripts.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,16 +61,16 @@ authenticated.
- `vp run typecheck`: Strict TypeScript checks for all packages.
- `vp run test`: Runs workspace tests.
- `vp run lint:mobile`: Mobile native static analysis (`scripts/mobile-native-static-check.ts`).
- `pnpm pr:ready`: Agent publish path — runs the ship gate (`vp check`, `vpr typecheck`,
`vp run test`), then marks the open draft PR ready. Do not use raw `gh pr ready` from coding
agents; the `.tools/bin/gh` shim blocks undraft side channels (installed by
`scripts/install-git-hooks.mjs` on `prepare`).
- `pnpm pr:ready`: Agent publish path — requires HEAD to contain latest `fork/dev`, runs the full
ship gate (`vp check`, `vpr typecheck`, `vp run test`), then marks the open draft PR ready. Do
not use raw `gh pr ready` from coding agents; the `.tools/bin/gh` shim runs the same gate first
(installed by `scripts/install-git-hooks.mjs` on `prepare`).
- `pnpm test:agent-gate`: Unit tests for the agent pre-push / PR-state / gh-policy helpers.
- Husky: `pre-commit` runs `pnpm lint-staged` (`vp fmt` on staged files + `vp lint --fix` on staged
code files);
`pre-push` runs `scripts/agent-pre-push.mjs` (agents only: static gate — `vp check` + typecheck —
on draft / no PR; full ship gate including unit tests on ready PRs / publish; staged SHA cache in
`.run/agent-ship-gate.json`).
`pre-push` runs `scripts/agent-pre-push.mjs` (agents only: changed-file `vp check` +
`vpr typecheck` on draft / no PR; full ship gate including unit tests on ready PRs / publish;
full-gate SHA cache in `.run/agent-ship-gate.json`).
- `node apps/server/scripts/t3-sqlite-state.ts <query|exec> --base-dir <path> ...`: Inspects or seeds
an isolated T3 SQLite database; writes create a private backup first.

Expand Down
6 changes: 3 additions & 3 deletions docs/operations/ci.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# CI quality gates

- `.github/workflows/fork-ci.yml` runs the fork quality gates for pull requests and for exact
`fork/integration` SHAs dispatched by the stack workflow. The inherited upstream `ci.yml` workflow
is disabled so updates to the exact `main` mirror do not duplicate those checks.
- `.github/workflows/fork-ci.yml` runs the fork quality gates for pull requests targeting
`fork/dev` and for pushes to `fork/dev`. The inherited upstream `ci.yml` workflow is disabled so
updates to the `main` mirror do not duplicate those checks.
- `.github/workflows/release.yml` builds macOS (`arm64` and `x64`), Linux (`x64`), and Windows (`x64`) desktop artifacts from a single `v*.*.*` tag and publishes one GitHub release.
- The release workflow auto-enables signing only when platform credentials are present. macOS passkey builds additionally require `APPLE_TEAM_ID` and the `MACOS_PROVISIONING_PROFILE` secret; Windows uses Azure Trusted Signing. Without the core signing credentials, it still releases unsigned artifacts.
- See [Release Checklist](./release.md) for the full release/signing setup checklist.
Loading
Loading