Skip to content

Commit ff6a056

Browse files
committed
Keep development workflow within size budget
Condense the Codex configuration and app-directory guidance while retaining detailed XDG troubleshooting in the headless operation reference.
1 parent 8825f37 commit ff6a056

1 file changed

Lines changed: 9 additions & 26 deletions

File tree

skills/development-workflow/SKILL.md

Lines changed: 9 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -146,37 +146,20 @@ foundry profile active # Verify authentication
146146
foundry apps list # Check existing apps (avoid name collisions)
147147
```
148148

149-
Before treating a missing profile as an authentication failure, normalize the
150-
configuration lookup for agents that override XDG paths:
151-
152-
```bash
153-
export XDG_CONFIG_HOME="${XDG_CONFIG_HOME:-$HOME/.config}"
154-
foundry profile active
155-
```
156-
157-
The Foundry CLI reads profiles from
158-
`$XDG_CONFIG_HOME/foundry/configuration.yml`. Do not point
159-
`XDG_CONFIG_HOME` at the app workspace or copy credentials into it. If the
160-
profile exists but the assistant cannot access that directory, request write
161-
access to the existing Foundry configuration directory and retry. If either
162-
command still fails, see
163-
[references/headless-operation.md](references/headless-operation.md) for setup
164-
options (env vars, non-interactive profile creation).
149+
Before diagnosing a missing profile, export
150+
`XDG_CONFIG_HOME="${XDG_CONFIG_HOME:-$HOME/.config}"`. Never redirect it into
151+
the workspace or copy credentials. See
152+
[headless operation](references/headless-operation.md) for access and
153+
authentication failures.
165154

166155
### Step 4: Scaffold the App
167156

168157
**Prerequisite:** User must have confirmed the app name in Step 2. Do not run this without confirmation.
169158

170-
Choose the app location without asking the user:
171-
172-
1. If the current directory contains `manifest.yml`, use it as an existing app.
173-
2. If the current directory is not inside an unrelated repository, create the
174-
app there.
175-
3. If the current directory is an unrelated repository, create the app as a
176-
sibling under that repository's parent directory.
177-
4. If the selected parent is outside the assistant's writable sandbox, request
178-
write access for that directory and retry the CLI command. Do not fall back
179-
to putting the app inside the unrelated repository.
159+
Choose the location automatically: use an existing app when `manifest.yml` is
160+
present; otherwise create in the current directory, or beside it when the
161+
current directory is an unrelated repository. Request sandbox write access when
162+
needed; never put the app inside an unrelated repository as a fallback.
180163

181164
```bash
182165
foundry apps create --name "app-name" --description "description" --no-prompt --no-git

0 commit comments

Comments
 (0)