# Project workspace

Create one private repository per project from `Humbleteam-team/project-template` after its owner enables GitHub's Template repository setting.

Keep reviewed project context in `context/`. Put product source and client deliverables in folders agreed for the project. The template contains no client records, credentials, runtime history, or scheduled jobs.

The design-system record consists of `context/ds-tokens.html`, `context/ds-guide.md`, and `context/ds-status.md`. The token document is passive text; scripts, event handlers, network resources and credentials are excluded. It is the only HTML file in automatic context synchronization.

Attach an existing checkout using `humbleagents attach --project PROJECT-ID --path ABSOLUTE-PATH --repo Humbleteam-team/REPOSITORY`. Then run `humbleagents sync --project PROJECT-ID` to reconcile the allowlisted context documents with the employee's local workspace. Conflicting edits require review.

Source imports, connection selectors, caches, queues and plugin runtime state live outside this repository in the current user's humbleagents application-data directory. Do not copy employee credentials or raw mailboxes here. See `sources/README.md`.

GitHub controls who can read, clone, fetch, and push. Installing humbleagents does not grant repository permissions. Review changes using the repository's normal GitHub workflow.