Add repository-local agent guidance in AGENTS.md, with a compatible CLAUDE.md fallback so tools that only discover Claude's conventional filename receive the same instructions.
Follow the proven webnet/webnet arrangement: make CLAUDE.md a symlink to AGENTS.md so there is one source of truth, and explain the relationship at the top of the file.
Content to cover
Repository structure and the npm-workspaces/Turbo conventions once introduced.
Canonical install, build, typecheck, lint, format, and test commands.
Gitea/tea forge routing and safe issue/PR workflows.
Exact active-model attribution requirements for commits and Agent/* labels.
Branch/worktree expectations.
Dependency-management and lockfile rules.
Test expectations, including backend contract tests and integration tests.
Any project-specific coding style and generated-file constraints.
Acceptance criteria
AGENTS.md is the canonical maintained file.
CLAUDE.md resolves to the same content without requiring duplicate edits.
Instructions match commands that actually exist in the repository.
The fallback behavior is documented clearly enough that contributors do not edit both paths independently.
## Goal
Add repository-local agent guidance in `AGENTS.md`, with a compatible `CLAUDE.md` fallback so tools that only discover Claude's conventional filename receive the same instructions.
Follow the proven `webnet/webnet` arrangement: make `CLAUDE.md` a symlink to `AGENTS.md` so there is one source of truth, and explain the relationship at the top of the file.
## Content to cover
- Repository structure and the npm-workspaces/Turbo conventions once introduced.
- Canonical install, build, typecheck, lint, format, and test commands.
- Gitea/`tea` forge routing and safe issue/PR workflows.
- Exact active-model attribution requirements for commits and `Agent/*` labels.
- Branch/worktree expectations.
- Dependency-management and lockfile rules.
- Test expectations, including backend contract tests and integration tests.
- Any project-specific coding style and generated-file constraints.
## Acceptance criteria
- `AGENTS.md` is the canonical maintained file.
- `CLAUDE.md` resolves to the same content without requiring duplicate edits.
- Instructions match commands that actually exist in the repository.
- The fallback behavior is documented clearly enough that contributors do not edit both paths independently.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Goal
Add repository-local agent guidance in
AGENTS.md, with a compatibleCLAUDE.mdfallback so tools that only discover Claude's conventional filename receive the same instructions.Follow the proven
webnet/webnetarrangement: makeCLAUDE.mda symlink toAGENTS.mdso there is one source of truth, and explain the relationship at the top of the file.Content to cover
teaforge routing and safe issue/PR workflows.Agent/*labels.Acceptance criteria
AGENTS.mdis the canonical maintained file.CLAUDE.mdresolves to the same content without requiring duplicate edits.