Skip to content

Latest commit

 

History

History
90 lines (63 loc) · 2.3 KB

File metadata and controls

90 lines (63 loc) · 2.3 KB

@prd.md @activity.md

We are building the project according to the PRD in this repo.

First read activity.md to see what was recently accomplished.

Start the Application

Start the site locally. Use the appropriate command for your tech stack:

  • npm run dev (for Next.js, Vite, or similar)
  • pnpm dev (if using pnpm)
  • bun dev (if using Bun)
  • python3 -m http.server 8000 --bind 127.0.0.1 (for static HTML)

If the port is taken, try another port.

Work on Tasks

Open prd.md and find the single highest priority task where "passes": false.

Work on exactly ONE task:

  1. Implement the change according to the task steps
  2. Run any available checks:
    • npm run lint (if available)
    • npm run typecheck (if available)
    • npm run build (if available)

Verify in Browser

After implementing, use agent-browser to verify your work:

  1. Open the local server URL:

    agent-browser open http://localhost:3000
    
  2. Take a snapshot to see the page structure:

    agent-browser snapshot -i -c
    
  3. Take a screenshot for visual verification:

    agent-browser screenshot screenshots/[task-name].png
    
  4. Check for any console errors or layout issues

  5. If the task involves interactive elements, test them:

    agent-browser click "[selector]"
    agent-browser fill "[selector]" "test value"
    

Log Progress

Append a dated progress entry to activity.md describing:

  • What you changed
  • What commands you ran
  • The screenshot filename
  • Any issues encountered and how you resolved them

Update Task Status

When the task is confirmed working, update that task's "passes" field in prd.md from false to true.

Commit Changes

Make one git commit for that task only with a clear, descriptive message:

git add .
git commit -m "feat: [brief description of what was implemented]"

Do NOT run git init, do NOT change git remotes, and do NOT push.

Important Rules

  • ONLY work on a SINGLE task per iteration
  • Always verify in browser before marking a task as passing
  • Always log your progress in activity.md
  • Always commit after completing a task

Completion

When ALL tasks have "passes": true, output:

COMPLETE