f299bae77b
Add OPS repo presence detection in supervisor-run.sh with degraded mode support: - Detect if OPS_REPO_ROOT is missing and log WARNING message - Set OPS_REPO_DEGRADED=1 flag and configure fallback paths - Bundle minimal knowledge files as fallback for degraded mode - Update formula to use OPS_KNOWLEDGE_ROOT, OPS_JOURNAL_ROOT, OPS_VAULT_ROOT - Support local vault destination and journal fallback when ops repo absent Knowledge files bundled: disk.md, memory.md, ci.md, git.md, dev-agent.md, review-agent.md, forge.md The supervisor now runs with full functionality when ops repo is available, or gracefully degrades to local paths when absent, making the failure mode explicit rather than silent.
28 lines
734 B
Markdown
28 lines
734 B
Markdown
# Dev Agent — Best Practices
|
|
|
|
## Dev Agent Issues (P2)
|
|
|
|
When dev-agent is stuck, blocked, or in bad state:
|
|
|
|
### Dead Lock File
|
|
```bash
|
|
# Check if process still exists
|
|
ps -p $(cat /path/to/lock.file) 2>/dev/null || rm -f /path/to/lock.file
|
|
```
|
|
|
|
### Stale Worktree Cleanup
|
|
```bash
|
|
cd "$PROJECT_REPO_ROOT"
|
|
git worktree remove --force /tmp/stale-worktree 2>/dev/null || true
|
|
git worktree prune 2>/dev/null || true
|
|
```
|
|
|
|
### Blocked Pipeline
|
|
- Check if PR is awaiting review or CI
|
|
- Verify no other agent is actively working on same issue
|
|
- Check for unmet dependencies (issues with `Depends on` refs)
|
|
|
|
### Prevention
|
|
- Single-threaded pipeline per project (AD-002)
|
|
- Clear lock files in EXIT traps
|
|
- Use phase files to track agent state
|