Files
Patrick Russell e39c051e66 docs(appbuilder-project-init): address PR review on bootstrap clarity
Two follow-ups from PR review on adobe/skills#91:

1. **Name vs ID disambiguation across `aio console` commands**
   bootstrap.md mixed `--projectName`/`--workspaceName` (used by
   create/add/list) with `--projectId`/`--workspaceId` (used by select)
   without saying which goes where. Added an "Identifier convention"
   section near the top of bootstrap.md, with a quick table
   (create/add → names; select → IDs; `aio app use` → currently
   selected) and a copy-pasteable `jq` recipe to resolve a name to an
   ID via `aio console project list --json` /
   `aio console workspace list --json`. Also added a recovery-table
   row pointing back at the convention when a `select` step fails for
   want of an ID.

2. **`--no-config-validation` escape hatch missing from bootstrap.md
   recovery table; SKILL.md should enumerate which commands actually
   validate**
   - bootstrap.md: added a recovery-table row for "post-bootstrap
     `aio app *` fails on schema validation" that names
     `--no-config-validation` as the one-shot unblock and links to
     the corresponding section in debugging.md.
   - SKILL.md: expanded the validation troubleshooting bullet to
     enumerate the specific commands that trigger validation —
     `aio app init`, `aio app add (action|web-assets|extension|event|service)`,
     `aio app delete …`, `aio app build`, `aio app deploy`,
     `aio app undeploy`, `aio app run`, `aio app dev`, `aio app use`,
     `aio app info` — so agents know exactly when the flag applies and
     don't reach for it speculatively.

Validation: SKILL.md description still 995 chars (under 1024 limit);
`npx skills-ref validate` passes locally.
2026-04-23 16:52:05 -07:00
..