AI-Assisted Workflows
import { Aside } from ‘@astrojs/starlight/components’;
The combination of The Terminal and Gee-Code enables workflows that aren’t possible with traditional tools. Here are the most common patterns.
The Debug Loop
Section titled “The Debug Loop”Scenario: Something is broken in your web app.
Layout:
┌────────────────────┬────────────────────┐│ Terminal │ Browser ││ (dev server) │ (your app) │├────────────────────┴────────────────────┤│ Terminal (Gee-Code) │└──────────────────────────────────────────┘Workflow:
- Describe the problem to Gee-Code: “The signup form submits but nothing happens”
- Gee-Code connects to the browser and reads the console
- Finds:
POST /api/signup → 500 Internal Server Error - Reads the response body for the error message
- Searches your codebase for the signup handler
- Identifies the bug and fixes it
- Your dev server hot-reloads
- Gee-Code verifies the fix by submitting the form again
The entire cycle happens without you switching windows or copying error messages.
Visual Verification
Section titled “Visual Verification”Scenario: You’re making CSS changes and want AI feedback.
Workflow:
- Make a style change in your code
- Ask Gee-Code: “Does the header look right now?”
- Gee-Code takes a screenshot of the browser panel
- Analyzes the layout: “The header is rendering, but the logo is overlapping the nav links. The logo container needs
flex-shrink: 0.” - Makes the fix, takes another screenshot to confirm
API-First Development
Section titled “API-First Development”Scenario: Building a frontend that consumes an API.
Workflow:
- Point the browser at your frontend
- Gee-Code watches network requests in real time
- When an API call fails, it reads the request and response
- Identifies mismatches between what the frontend sends and what the API expects
- Fixes either side as needed
Form Testing
Section titled “Form Testing”Scenario: Verifying form validation and submission.
Workflow:
- Ask Gee-Code: “Test the contact form with various inputs”
- Gee-Code fills the form fields using the DevTools API
- Submits the form and observes the response
- Tests edge cases: empty fields, invalid email, long text
- Reports which validation rules work and which don’t
Accessibility Review
Section titled “Accessibility Review”Scenario: Checking your app for accessibility issues.
Workflow:
- Ask Gee-Code: “Check the current page for accessibility issues”
- Gee-Code inspects the DOM for:
- Missing alt text on images
- Missing ARIA labels on interactive elements
- Color contrast issues
- Keyboard navigation problems
- Heading hierarchy
- Reports findings with specific element references
- Offers fixes for each issue
Multi-Page Testing
Section titled “Multi-Page Testing”Scenario: Verifying a user flow across multiple pages.
Workflow:
- Ask Gee-Code: “Walk through the checkout flow”
- Gee-Code navigates to the cart page
- Clicks “Checkout”, fills in shipping info, proceeds to payment
- At each step, it checks for errors, validates the UI, and reports status
- Confirms the entire flow works end-to-end
Tips for Effective Workflows
Section titled “Tips for Effective Workflows”- Keep the browser panel visible — Gee-Code uses it for screenshots and interaction
- Run your dev server with hot reload — fixes apply instantly
- Use descriptive error messages in your code — Gee-Code reads them
- Point the browser at the right page before asking Gee-Code to debug it
Next Steps
Section titled “Next Steps”- Full-Stack Debugging Guide — detailed debugging techniques
- Recording & Screenshots — capture your workflow