ai-workspace-lab/xworkmate-bridge
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1f43a989a0
xworkmate-bridge/AGENTS.md
Cowork 3P d436729508 refactor: remove multi-agent orchestration engine, add coding standards 
- Delete internal/acp/multi_agent.go (610 lines) — Path B orchestration
- Remove multiAgent dispatch from orchestrator, jobs, http_handler
- Set multiAgent/multi_agent capabilities to false in catalog
- Remove TaskKindMultiAgent from types
- Remove redundant ErrorResponse() wrapper in shared/rpc.go
- Add anti-fallback coding standards to AGENTS.md
2026-06-04 07:40:23 +00:00

2.1 KiB
Raw Blame History

AGENTS

Deployment Naming Rules

Caddy config file naming

Use the following filename format for generated Caddy config files:

<server-name>-<release_id>-<hostname>-<domain>.caddy

Example:

console-6ebcdd6-jp-xhttp-contabo-console-svc-plus.caddy

Notes:

  • server-name is the service or site identifier, such as console
  • release_id is the normalized release identifier; use the release tag when available, otherwise use a short git commit id
  • hostname is the target host name
  • domain should be encoded in a filesystem-friendly form; replace . with -

Coding Standards

Anti-Fallback Rules

  1. No cascading fallback chains. Prefer explicit single-path resolution. If a value is missing, fail early with a clear error instead of trying progressively degraded alternatives.

  2. No silent error swallowing. Every error must be logged or returned. Do not use _ = fn() to suppress errors unless the function contract explicitly documents that the error is benign (e.g., Close() on a nil-safe receiver). For all other cases, log or propagate.

  3. No stale dead code. Unused functions, types, constants, and entire files must be removed, not commented out or guarded behind unreachable branches.

  4. No redundant indirection. One-line wrappers that simply delegate to another function must be removed. Call the canonical function directly.

  5. No hardcoded model defaults that bypass configuration. Model selection must route through the resolver/catalog, not be baked into library code.

  6. No multi-agent orchestration in the bridge. The bridge handles forwarding only. Any request that includes orchestration parameters (multiAgent, orchestrationMode, mode=multi-agent) must be rejected or treated as unrecognized.

Dead Code Elimination

  • Run go vet and ensure zero warnings before committing.
  • Run go build ./... and verify compilation succeeds after every refactor.
  • After removing a source file, verify that no remaining file imports it or references its exported symbols.
  • Do not modify *_test.go files. If a refactor breaks a test, adjust the production code to keep the test passing.