Skip to content

Update docs to help agents handle full lifecycle - #428

Open
myurasov-nv wants to merge 2 commits into
brevdev:mainfrom
myurasov-nv:agent-skill-field-docs
Open

Update docs to help agents handle full lifecycle#428
myurasov-nv wants to merge 2 commits into
brevdev:mainfrom
myurasov-nv:agent-skill-field-docs

Conversation

@myurasov-nv

@myurasov-nv myurasov-nv commented Jul 26, 2026

Copy link
Copy Markdown

Docs-only: three gaps that caused real failures while an AI agent drove full GPU-run lifecycles (create -> provision -> train -> collect -> delete). Verified 2026-07-25 on launchpad 2x H100, verda B300, massedcompute L40S, GCP T4.

Issues

Problem observed Change
brev exec "nohup train.py &" (ml-training.md step 7) blocks for the whole run - exec holds the session even for nohup children; step 8 tail -f never exits Detached-launch pattern (setsid nohup ... & disown via @launch.sh + completion marker to poll); tail -n instead of tail -f
Readiness lifecycle undocumented: RUNNING != SHELL READY; sshd refuses 1-2 min after READY; benign ErrorForbidden from the create poll Lifecycle note under Create Instances
Billing model absent: per-second, RUNNING-only (BUILDING free, no round-up); stopped instances keep accruing storage; usage feed lags "How Billing Works" section in SKILL.md + warning in cleanup.md

Files

  • SKILL.md: detach pattern, lifecycle note, billing section
  • reference/commands.md: long-running note under brev exec
  • prompts/ml-training.md: fix background launch, monitoring
  • prompts/cleanup.md: stopped-instances-cost warning

@myurasov-nv
myurasov-nv requested a review from a team as a code owner July 26, 2026 00:11
@myurasov-nv
myurasov-nv force-pushed the agent-skill-field-docs branch from 0bade9a to da1eb1a Compare July 26, 2026 00:15
… readiness lifecycle, and the billing model, learned from autonomous-agent field use
@myurasov-nv
myurasov-nv force-pushed the agent-skill-field-docs branch from da1eb1a to cac8c3e Compare July 26, 2026 00:17
@myurasov-nv myurasov-nv changed the title docs(agent-skill): field lessons from autonomous-agent use Update docs to help agents handle full lifecycle Jul 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant