GW2Suggest Workspace

Companion app for Guild Wars 2 that helps groups of players find achievements to tackle together — FastAPI backend, Vue 3 frontend, Ansible deployment.

Repository layout

This repository holds the workspace-level configuration only. The three components are independent git repositories (gitignored here, cloned side-by-side into this directory):

Directory	Repository	What it is
api/	ssh://git@git.hackthehell.de/gw2suggest/api.git	FastAPI backend: player data sync, GW2 metadata, achievement suggestions
frontend/	ssh://git@git.hackthehell.de/gw2suggest/frontend.git	Vue 3 + TypeScript single-page application
deploy/	ssh://git@git.hackthehell.de/gw2suggest/deploy.git	Ansible playbooks and provisioning for Debian 13+ servers

Workspace-tracked files:

• AGENTS.md — orientation for AI coding agents (opencode): workspace map, runtime summary, cross-cutting quality gates. Each component has its own AGENTS.md with its commands, architecture, and conventions.
• opencode.json — workspace-level opencode settings: permission grants for common lint/test/build commands.
• .opencode-mem-project — marker so opencode-mem treats every session under this workspace as one project with shared memory.

Setting up a new machine

git clone ssh://git@git.hackthehell.de/gw2suggest/workspace.git gw2suggest
cd gw2suggest
git clone ssh://git@git.hackthehell.de/gw2suggest/api.git
git clone ssh://git@git.hackthehell.de/gw2suggest/frontend.git
git clone ssh://git@git.hackthehell.de/gw2suggest/deploy.git

For dependencies and per-component commands, see the respective AGENTS.md and README.md (uv for api/ and deploy/, npm for frontend/).

Note: ~/.config/opencode/ (global opencode settings, agents, plugins) is not versioned here and must be replicated separately when moving machines.