OpenAdapt Bootstrap Concept: Self-Hosting Infrastructure

[abrichr]

OpenAdapt Bootstrap Concept

Vision: OpenAdapt building OpenAdapt - A recursive self-improvement system where development workflows are recorded as demonstrations and replayed autonomously via Claude Code integration.

Problem

Development tasks are manual and time-consuming:

• Generating screenshots for PRs requires 15-20 minutes of clicking and resizing
• Creating demos needs manual recording and editing
• Running tests and creating PRs involves multiple manual steps
• User on mobile cannot execute desktop development tasks

Solution

Record once, replay forever:

1. Record a development task by demonstrating it once
2. Replay the task autonomously when needed (via Claude Code)
3. Iterate by recording improvements to the workflow

This enables:

• Mobile-first development: User directs from mobile, desktop executes
• Reproducible workflows: Exact same steps every time
• Self-documenting: The workflow IS the documentation
• Recursive improvement: Can record the recording process itself

Three-Layer Architecture

┌─────────────────────────────────────────────────┐
│          WORKFLOW LAYER                         │
│  (High-level development tasks)                 │
│  - ScreenshotWorkflow, DemoGenerationWorkflow   │
└─────────────────────┬───────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────┐
│         EXECUTION LAYER                         │
│  (Replay and orchestration)                     │
│  - WorkflowExecutor, ClaudeCodeIntegration      │
└─────────────────────┬───────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────┐
│         RECORDING LAYER                         │
│  (OpenAdapt capture infrastructure)             │
│  - openadapt-capture, Workflow metadata         │
└─────────────────────────────────────────────────┘

Key Components

1. WorkflowRecorder

Captures development tasks with metadata:

with WorkflowRecorder(
    name="generate_pr_screenshots",
    description="Generate screenshots for benchmark viewer PR"
) as recorder:
    # Perform task manually...
    # OpenAdapt records every action
    pass

2. WorkflowExecutor

Replays workflows with parameter substitution:

executor = WorkflowExecutor(
    workflow_name="generate_pr_screenshots",
    parameters={"html_path": "viewer.html"},
    claude_code_enabled=True
)

result = executor.execute()
# Screenshots generated automatically!

3. Claude Code Integration

Enables autonomous decision-making during replay (handles prompts, errors, UI changes)

Use Cases

1. Auto-generate PR screenshots - Record screenshot workflow once, replay for each PR
2. Automated demo generation - Regenerate demos when UI changes
3. Test execution with visual verification - Run tests with screenshot checkpoints
4. End-to-end PR creation - From code change to PR with all artifacts

Mobile-First Development

User on mobile triggers workflows via:

• GitHub Issues: /bootstrap run screenshot_workflow
• GitHub Actions: Manual dispatch
• Tailscale SSH: Direct command execution

Results posted back to GitHub for mobile review.

Recursive Self-Improvement

The ultimate goal:

Level 1: Record development tasks
Level 2: Record workflow creation
Level 3: Record recording process
Level 4: Full bootstrap - system improves itself

Status

✅ Repository created: https://github.com/OpenAdaptAI/openadapt-bootstrap
✅ Base classes implemented (WorkflowRecorder, WorkflowExecutor, Workflow)
✅ Screenshot workflow (stub + Playwright implementation)
✅ Proof-of-concept example script
✅ Architecture documentation

⏳ Not yet implemented:

• Integration with openadapt-capture for actual recording
• Claude Code integration for autonomous decision-making
• GitHub Actions triggers
• Workflow replay from recordings

Next Steps

See issues for detailed roadmap:

• Phase 1: Foundation - OpenAdapt Capture Integration #2 Phase 1: Foundation (openadapt-capture integration)
• Phase 2: Claude Code Integration - Autonomous Workflow Execution #3 Phase 2: Claude Code Integration
• Phase 4: Recursive Self-Improvement - Bootstrap Achievement #4 Phase 3: GitHub Integration
• Proof of Concept: Screenshot Workflow for openadapt-evals #5 Phase 4: Recursive Self-Improvement

Documentation

• README: https://github.com/OpenAdaptAI/openadapt-bootstrap/blob/main/README.md
• Architecture: https://github.com/OpenAdaptAI/openadapt-bootstrap/blob/main/docs/ARCHITECTURE.md
• Examples: https://github.com/OpenAdaptAI/openadapt-bootstrap/tree/main/examples

---

This establishes the foundation for OpenAdapt to build OpenAdapt - enabling truly autonomous development workflows.