Skip to content

Phase 7: Agent Sandboxes (Factory In A Box) - #13

Open
jhillbht wants to merge 1 commit into
mainfrom
phase-7-agent-sandboxes
Open

Phase 7: Agent Sandboxes (Factory In A Box)#13
jhillbht wants to merge 1 commit into
mainfrom
phase-7-agent-sandboxes

Conversation

@jhillbht

Copy link
Copy Markdown
Contributor

Summary

Adds PLANNING/boris-methodology-upgrade/PHASE-7-AGENT-SANDBOXES.md, extending Phase 6 (parallel cloud sessions) with real isolation.

Source: exe.dev / IndyDevDan, "Engineers... Your Software Factory NEEDS Agent Sandboxes to SCALE" — indexed and queried via TwelveLabs Jockey.

What the framework actually is

  • Sandbox = throwaway VM (not a git worktree or container) — SSH + provisioning-key access
  • Structure: host → sandbox → factory → app ("Factory In A Box")
  • Security contract: "keys never enter" the sandbox — host retains all credentials
  • Lifecycle: provision → connect → in-sandbox orchestrator runs SDLC chain (request → plan → build → test → review → document) → teardown

Fit against this repo

The closest existing infrastructure precedent is Clawbox (openclaw-agents:clawbox-deploy) — already VM-based, Tailscale-meshed, SSH-managed. This plan retargets Clawbox's provisioning pattern from persistent-per-client to throwaway-per-task, and formalizes the "keys never enter" boundary Clawbox doesn't currently document.

Git worktrees (what Phase 6 gestures toward) stay the lightweight tier for same-machine parallel sessions; VM sandboxes become the isolated/untrusted-work tier.

Contents

  • Framework summary with source citations
  • Fit table against SUBAGENT-FRAMEWORK/, Phase 6, Clawbox, and .claude/hooks/
  • Proposed directory structure (SUBAGENT-FRAMEWORK/sandboxes/, new hooks, new skill)
  • 6 tasks + verification checklist
  • Claude Code prompt template for implementation

No code changes — planning doc only. Implementation is a follow-up PR once this plan is reviewed.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 827a8d084c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +97 to +98
### Task 6: Update the SUBAGENT-FRAMEWORK Orchestrator
Outer orchestrator provisions one sandbox per subagent/task. In-sandbox orchestrator runs the request → plan → build → test → review → document chain, matching the source framework's pipeline.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Define credential mediation for the in-sandbox orchestrator

When the in-sandbox orchestrator invokes Claude or accesses private source control, it must authenticate, but the plan simultaneously forbids credentials from entering the VM and specifies no host-side credential broker, authenticated proxy, or artifact-transfer protocol. As written, the pipeline cannot perform authenticated work without violating its core security contract; define and verify the credential-mediation and repository/output data flow before implementation.

Useful? React with 👍 / 👎.

Comment on lines +88 to +92
### Task 4: Wire In Session-Lifecycle Hooks
```
.claude/hooks/sandbox-session-start.md # provision + connect before work begins
.claude/hooks/sandbox-session-stop.md # teardown + verify no credentials were copied in
```

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Register executable lifecycle hook handlers

Adding these Markdown files will not wire lifecycle behavior: the inspected .claude/settings.json registers SessionStart and Stop as explicit command hooks, while the existing .claude/hooks/*.md files are only specifications. Because Task 4 includes neither executable handlers nor settings registration, provisioning and teardown will never be invoked as described, leaving created VMs running; include the commands and .claude/settings.json changes required to register them.

Useful? React with 👍 / 👎.

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