Skip to content

Instantly share code, notes, and snippets.

@DannyMac180
Created July 17, 2025 14:39
Show Gist options
  • Save DannyMac180/17b6a14c4ed1b25663d525c7f28de175 to your computer and use it in GitHub Desktop.
Save DannyMac180/17b6a14c4ed1b25663d525c7f28de175 to your computer and use it in GitHub Desktop.

The Anatomy of an Amp Workflow

<style> .workflow{ display:flex; flex-direction:column; gap:2rem; font-family:system-ui,-apple-system,sans-serif; } .row{ display:grid; grid-template-columns: 1fr 220px; align-items:stretch; min-height:120px; } .body{padding-right:2rem;} .label{ display:flex; align-items:center; gap:1rem; font-size:1.3rem; font-weight:500; color:#fff; } .label .bar{ flex:0 0 4px; height:100%; border-radius:2px; } .label.problem .bar{background:#F34E3F;} .label.plan .bar{background:#F34E3F;} .label.debug .bar{background:#F34E3F;} .label.test .bar{background:#F34E3F;} .label.verify .bar{background:#F34E3F;} .label.code .bar{background:#F34E3F;} .label.iterate .bar{background:#F34E3F;} </style>

The Anatomy of an
Workflow

Start by describing a real, tightly-scoped problem or desired integration in an Amp thread.

Examples: "Integrate Groq API into Libre Chat," "Investigate Groq provider conversation flow issue," "Fix OpenRouter model dropdown population issue."

Include any error output, screenshots, and summary of symptoms or gaps.

Problem Definition

Ask for a research-backed plan from the Oracle before requesting code changes, e.g. "Use the Oracle to research… then create an implementation plan."

Amp responds with detailed TODOs and step-by-step plans specific to the stack, based on source code investigation and external API documentation.

Research & Planning

When blocked, paste exact errors or system output from your runtime (build, test, or app logs).

Amp traces back the problem using source search ("search for OpenRouter-related code," "find where provider value is being passed") and iteratively proposes specific code or config adjustments.

Debug & Iterate

After each code change, Amp will automatically pompt itself to test: "Now let me test the fix by running X," and report the resulting output or error.

Amp examines build output, backend logs (e.g. podman, npm errors), and guides any missing dependency installs or required container restarts.

Test & Validate

For frontend changes, Amp will validate the UI/UX changes in the browser. Amp can also use an MCP such as Playwright to automate browser testing.

Amp ties backend config, server environment, and frontend build together for end-to-end fixes.

UI/UX Verification

If the first fix doesn't work, update the thread with current symptoms/logs, and repeat with Amp until resolved.

The workflow is highly interactive and dialogue-driven, treating Amp as your pair-programming partner for both research and incremental implementation.

Continuous Iteration

Core Principles

  • Tightly-scoped problems: Focus on specific, actionable issues rather than broad requirements
  • Research-first approach: For comprehensive changes, always start with investigation and planning before implementation
  • Error-driven debugging: Use actual logs and outputs to guide problem-solving
  • End-to-end validation: Verify fixes work from backend to frontend
  • Incremental iteration: Test after each change and adjust based on results

Example Thread Starters

Good: "Integrate Groq API into Libre Chat - getting 401 errors on authentication"

Good: "OpenRouter model dropdown not populating - see attached screenshot"

Avoid: "Make the app better" or "Add AI features"

Avoid: "Fix all the bugs" or "Optimize performance"

Success Indicators

  • Specific problem described with context
  • Research plan requested and received
  • Errors/logs shared for debugging
  • Each fix tested and validated
  • UI changes verified in browser
  • Iterative improvement cycle maintained
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment