You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Merging Dev_new_gui → main. All conflicts resolved (31 files), user_management router gap fixed. Verified no functionality lost from #4571 direct-to-main commit.
Copy file name to clipboardExpand all lines: CLAUDE.md
+67-11Lines changed: 67 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -102,15 +102,38 @@ See memory for [Worktree Isolation (CRITICAL)](https://github.com/mrveiss/AutoBo
102
102
Before spawning agents or starting worktree work:
103
103
104
104
1.**Verify branch isolation:**`git branch --show-current` in main session. Should be `Dev_new_gui`. If on a feature branch, STOP — you'll break parallel worktrees.
105
-
2.**Create worktrees correctly:** Each issue gets `.worktrees/issue-XXXX/` with dedicated branch. NO shared branches between worktrees.
106
-
3.**Check git status:**`git status` — main session must be clean (no uncommitted changes).
107
-
4.**Verify issue isn't resolved:** Check if issue is already closed or if `Dev_new_gui` already has the fix.
108
-
5.**Confirm approach:** For architectural decisions, state in 1-2 sentences and wait for confirmation.
105
+
2.**Verify Bash is approved:** Main session must have Bash permission approved — sub-agents inherit from parent. If Bash requires a prompt, approve it once before spawning any agents.
106
+
3.**Create worktrees correctly:** Each issue gets `.worktrees/issue-XXXX/` with dedicated branch. NO shared branches between worktrees.
107
+
4.**Check git status:**`git status` — main session must be clean (no uncommitted changes).
108
+
5.**Verify issue isn't resolved:** Check if issue is already closed or if `Dev_new_gui` already has the fix via `git log origin/Dev_new_gui --oneline --grep="#XXXX"`.
109
+
6.**Confirm approach:** For architectural decisions, state in 1-2 sentences and wait for confirmation.
109
110
110
111
**Critical:** If you accidentally switched to a feature branch during parallel work, immediately switch back to `Dev_new_gui`. You may have broken active worktrees.
111
112
112
113
---
113
114
115
+
## Branch Safety (MANDATORY)
116
+
117
+
**Never run these operations without explicit user confirmation:**
118
+
-`git reset --hard` — discards uncommitted work permanently
-`git clean -fd` / mass file deletion — unrecoverable
122
+
-`git cherry-pick` across divergent histories — high conflict risk
123
+
- Any operation touching `main` or `master` directly
124
+
125
+
**Before any bulk git operation:**
126
+
1. Run `git status` and `git diff --stat` — confirm exactly what will be affected
127
+
2. State the operation and its scope in one sentence to the user before executing
128
+
3. For branch deletions: verify the branch content is merged (`git branch -r --merged origin/Dev_new_gui`) before deleting
129
+
4. For file deletions: `grep -r` to confirm nothing references the files first
130
+
131
+
**If something goes wrong:** Stop immediately. Do not attempt recovery with more destructive commands. Report current state to user and wait for instructions.
132
+
133
+
**Why:** In past sessions, Claude staged 5,371 files for deletion in a worktree, nearly reset `main` during a cherry-pick with 30+ conflicts, and committed fixes to wrong branches. These incidents required manual recovery.
134
+
135
+
---
136
+
114
137
## Branching Discipline (Issue #4113)
115
138
116
139
**PROTECTED BRANCHES:** Direct commits are blocked by pre-commit hook.
When the user says "implement all X-labeled issues", "fix all Y bugs", or "run `/team-implement` on Z" — **launch immediately without asking for scope clarification.** The pattern is well-established.
172
+
173
+
Default behavior:
174
+
- Batch size: 3 agents max per round (API rate limit)
175
+
- All issues get their own worktree: `.worktrees/issue-XXXX/`
176
+
- Main session stays on `Dev_new_gui` — never switches
177
+
- Agents commit locally; main session pushes and creates PRs
178
+
- After each batch: review, merge, file discovery issues, then next batch
179
+
180
+
**Do NOT ask:** "Which issues should I include?", "Should I do them in parallel?", "How many at a time?" — just run the pre-flight checklist and start.
181
+
182
+
**Only stop to ask** if: a specific issue has unresolved dependencies, an architectural decision is needed, or the pre-flight checklist finds a problem (dirty branch, unresolved PRs, etc.).
183
+
184
+
---
185
+
146
186
## Parallel Agents Strategy
147
187
148
188
When spawning multiple agents for batch work with `/team-implement`:
@@ -204,16 +244,20 @@ After ALL PRs merged:
204
244
205
245
---
206
246
207
-
## Sub-Agent Permission Enforcement (NEW)
247
+
## Sub-Agent Permission Enforcement (CRITICAL)
248
+
249
+
Sub-agents without Bash permissions cannot complete git operations and will stall mid-batch, forcing manual intervention. This is the #1 cause of batch failures.
208
250
209
-
**When spawning agents for parallel work:**
251
+
**Required tools for every implementation agent:**`Bash, Read, Edit, Write, Grep, Glob`
2.**Document in agent prompt:** "If you lose Bash permissions, STOP and report — don't retry"
213
-
3.**Monitor for permission failures:** After each batch, check for "Permission denied" errors
214
-
4.**Main session as fallback:** If agent fails on git push, main session handles it (main session has full credentials)
253
+
**Every agent prompt MUST include this line:**
254
+
> "You have Bash, Read, Edit, Write, Grep, and Glob permissions. If you lose Bash permissions at any point, STOP immediately and report — do not retry or work around it."
**Pre-launch check:** Before spawning any agent batch, confirm the main session has Bash approved. Sub-agents inherit from the parent session — if Bash requires approval in the main session, it will also require approval in each sub-agent, blocking all parallel work.
257
+
258
+
**Main session as fallback:** Agents commit locally only — they do NOT push. Main session handles all git push and `gh pr create` operations (SSH credentials always available in main session).
259
+
260
+
**On permission failure:** Do not retry the same agent. Report to user with: which agent failed, at which step, and what was left incomplete. Main session then completes the git operation manually.
While implementing, if you notice **any** bug, inconsistency, dead code, missing test, hardcoded value, or tech debt that is NOT part of the current issue — file a GitHub issue for it immediately. Do not fix it inline, do not add a TODO comment, do not ignore it.
**Before closing any issue**, confirm: did I file a GitHub issue for every gap I noticed during implementation? If not, file them now. This is mandatory — not optional.
350
+
351
+
**Why:** Gaps noticed inline and not filed are permanently lost. Discovery issues filed during implementation are the primary source of the issue backlog and prevent regressions from accumulating silently.
Copy file name to clipboardExpand all lines: README.md
+28-4Lines changed: 28 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,13 +1,37 @@
1
-
# AutoBot: Self-Hosted AI Automation Platform
1
+
<divalign="center">
2
2
3
-
> **Self-Hosted Infrastructure Automation with Conversational AI**
4
-
>
5
-
> AutoBot is a **self-hosted AI platform** that brings conversational AI to distributed Linux administration, fleet management, and infrastructure automation — all from a beautiful, modern interface. Own your data. Control your infrastructure. No vendor lock-in.
3
+
# Your data. Your AI.
4
+
5
+
**AutoBot is the self-hosted AI platform that belongs to you — not to us.**
6
+
7
+
Feed it your docs, your codebase, your business knowledge.
8
+
Plug in any brain you want — Ollama, OpenAI, Claude, Gemini, or any LLM.
9
+
Your data stays on your machine. Your AI stays yours.
0 commit comments