project-setuplisted
Install: claude install-skill YevheniiaQA/qa-agent-toolkit
# Project Setup
The first skill to run on any new project. Everything downstream reads the
profile this skill creates, so a wrong value here surfaces as a confusing failure
three stages later.
The profile itself takes twenty minutes to write. Finding out what goes in it is
the actual work, and it is mostly asking people questions. Do that asking
efficiently: gather every unknown into one message rather than discovering them
one at a time over three days.
## Cascading configuration
Nothing is shared between projects except non-secret defaults. A token belongs to
the project it was issued for. A global Jira token lets an agent working on project B
file tickets in project A, and one wrong "file a bug" then lands in a real tracker.
```
~/.qa-agent/.env shared NON-secret defaults only — never tokens
└── projects/<project>/profile.env project settings, INTEGRATIONS list (no secrets)
├── projects/<project>/secrets.env this project's tokens only (chmod 600), optional
└── projects/<project>/profile.<sub>.env sub-product overrides
```
The workspace selects its project with a one-line `.qa-project` file. A ticket key
(`PLAT-42` → `plat`) is the fallback when no `.qa-project` file is found. Load with
`source ~/.qa-agent/bin/qa-env.sh && qa_load`. It parses files literally and never
`source`s them, because a password containing a backtick or `$(...)` would otherwise run.
`INTEGRATIONS` lists the external systems the proje